Sandstar Web Socket

اتصال فوري من المتصفح إلى الجهاز

v1.0.0 Published عرض المصدر Documentation

قم بتوصيل متصفحك مباشرة بأجهزة التحكم في المباني -- بدون ملحقات، بدون تطبيقات Java، بدون مشاكل البرمجيات الوسيطة.

يوفر Sandstar Web Socket اتصالاً فورياً ثنائي الاتجاه بين تطبيقات الويب وأجهزة التحكم في أتمتة المباني المستندة إلى Sedona. افتح علامة متصفح، قم بالاتصال بجهاز، وابدأ في قراءة قيم المستشعرات وكتابة نقاط الضبط ومراقبة التغييرات -- كل ذلك في الوقت الفعلي.

تم بناؤه كملحق SkySpark أصلي، حيث ينسجم تماماً مع البنية التحتية الموجودة لديك. بدون خوادم إضافية للصيانة، بدون عمليات منفصلة للإشراف عليها. فقط قم بتثبيت الوحدة البرمجية وستتمكن تطبيقات الويب من التحدث إلى أجهزة Sedona على الفور.

لماذا موجود

تقليدياً، كان توصيل متصفح الويب بجهاز تحكم Sedona يتطلب خدمة صغيرة Kotlin/Java منفصلة تعمل كمترجم. كان هذا يعني إدارة عملية أخرى، والتعامل مع تعقيدات Java FFI، وتصحيح الأخطاء عبر بيئتي وقت التشغيل. يلغي Sandstar Web Socket كل ذلك بتطبيق Fantom أصلي واحد يعمل داخل SkySpark نفسه.

من الذي يستخدمه

  • متخصصو أتمتة المباني الذين يحتاجون إلى أدوات قائمة على الويب لأجهزة Sedona
  • مطورو SkySpark الذين يقومون بإنشاء واجهات ويب مخصصة لتفاعل الأجهزة
  • مسؤولو النظام الذين يريدون عدد أقل من المكونات المتحركة في مكدس الأتمتة الخاص بهم

لوحة معلومات الاتصال

كل جهاز، نظرة واحدة

شاهد كل جهاز تحكم متصل، وكل جلسة متصفح نشطة، وكل رسالة تتدفق عبر النظام -- حياً. توفر نقطة الحالة تشخيصات فورية بدون لمس ملف السجل.

عدد الاتصالات وحالات الجلسات لكل جهاز وصحة مأخذ DASP وإحصائيات مدير المراقبة متاحة جميعها على /live/soxstatus. دمجها في مكدس المراقبة الخاص بك أو تحقق منها من متصفح.

خادم SOX WebSocket
ws://localhost:7070
3
أجهزة نشطة
5
عملاء المتصفح
142
الرسائل/ثانية
192.168.1.100:1876
تمام جلسة واحدة
192.168.1.101:1876
تمام جلسة واحدة
10.0.0.50:1876
معطل إعادة اتصال
مأخذ DASP: نشط وقت التشغيل: 4 أيام 12 ساعة 37 دقيقة
علامة متصفح 1
محرر Vue
علامة متصفح 2
لوحة المعلومات
WebSocket :7070
SoxWebSocketMod
موجه
رسائل JSON
مجمع
واحدة لكل جهاز
مراقبات
مهلة 30 ثانية
DASP / UDP
جهاز تحكم Sedona
.100:1876
جهاز تحكم Sedona
.101:1876
TCP/WebSocket
UDP/DASP

تدفق البيانات الفوري

من المتصفح إلى الجهاز في قفزة واحدة

يفتح المتصفح الخاص بك اتصال WebSocket للمنفذ 7070. يترجم الخادم رسائل JSON إلى أوامر بروتوكول SOX ويرسلها عبر DASP/UDP إلى جهاز التحكم Sedona. تعود الردود نفس الطريق -- بدون استقصاء، بدون تأخير.

تشارك علامات المتصفح المتعددة تلقائياً جلسة الجهاز نفسها. يتعامل موجه الرسائل مع 17 نوع أمر SOX -- قراءات وكتابات واشتراكات وتحويلات ملفات وإدارة مكونات وغير ذلك -- كل ذلك من خلال اتصال WebSocket واحد.

r: قراءة w: كتابة sub: اشتراك v: إصدار a: إضافة d: حذف fileGet filePut

إدارة الجلسات

تجميع ذكي، بدون أخطاء في الاتصال

تدعم أجهزة التحكم Sedona حداً أقصى من اتصالين متزامنين. بدلاً من محاربة هذا الحد، تجمع مجمع الجلسات اتصالاً واحداً لكل جهاز عبر جميع عملاء المتصفح. افتح خمس علامات لجهاز التحكم نفسه -- ستشترك جميعها في جلسة واحدة.

إذا تعطل الاتصال، تبدأ آلية الاسترجاع التلقائي مع تراجع أسي. يتم تنظيف الجلسات غير المستخدمة بعد 5 دقائق، ومهلة تأخر 30 ثانية تمنع استنزاف الاتصال من دورات الاتصال/قطع الاتصال السريعة. لن يرى المستخدمون أبداً أخطاء في الاتصال.

1
جلسة لكل جهاز
5 دقائق
مهلة عدم الاستخدام
30 ثانية
نافذة التأخير
مجمع الجلسات SoxSessionPool
192.168.1.100:1876
متصل
الحالة تمام
يشاركها
علامة أ علامة ب علامة ج
آخر نشاط قبل ثانيتين
نافذة DASP receiveMax: 8
192.168.1.101:1876
متصل
الحالة تمام
يشاركها
علامة د
آخر نشاط قبل 14 ثانية
10.0.0.50:1876
إعادة اتصال
الحالة معطل
إعادة محاولة المحاولة 3، تراجع 10 ثوان
شوهد آخراً قبل 47 ثانية
الاشتراكات المباشرة 192.168.1.100
البث
مراقبة tab-8f3a TTL: 28 ثانية / 30 ثانية
ZoneTemp
مرجع #12 · فتحة 3 · وقت التشغيل
72.4°F
+0.2 من الأخير
ZoneSetpoint
مرجع #12 · فتحة 5 · تكوين
72.0°F
بدون تغيير
DamperPos
مرجع #18 · فتحة 2 · وقت التشغيل
67%
-3 من الأخير
FanEnable
مرجع #20 · فتحة 0 · وقت التشغيل
صحيح
قيمة منطقية
OccSchedule
مرجع #25 · فتحة 1 · وقت التشغيل
1مأهول
رقم صحيح
5 مكونات مشترك فيها أحداث مجمعة · تنظيف 10 ثوان

مراقبة القيم الفورية

شاهد تغيير القيم في الوقت الفعلي

اشترك في أي مكون على جهاز تحكم Sedona وشاهد قيمه تتحدث مباشرة. يجمع نظام المراقبة الاشتراكات حسب علامة المتصفح، لذا تحصل كل صفحة على البيانات التي تحتاجها بالضبط -- وينظفها تلقائياً عند إغلاق العلامة.

يتم تجميع الأحداث للكفاءة وتسليمها من خلال اتصال WebSocket نفسه. يعمل التنظيف الخلفي كل 10 ثوان لاكتشاف المراقبات القديمة من العملاء المقطوعة. إذا توقفت علامة عن الإرسال لمدة 30 ثانية، يتم إلغاء اشتراكاتها من الجهاز تلقائياً.

يمكن لعدة مراقبات أن تتداخل على نفس المكون -- يتتبع النظام عدد المراجع ويلغي الاشتراك من الجهاز فقط عندما تغادر آخر مراقبة. بدون اشتراكات مكررة، بدون مراقبات يتيمة.

نقل الملفات

رفع البرامج الثابتة وتنزيل الإعدادات

انقل ملفات التطبيق (SAX، SAB) من وإلى أجهزة تحكم Sedona مع عمليات النقل المقسمة والقابلة للاستئناف. توفر البروتوكول ثلاثي المراحل -- فتح وجزء وإغلاق -- تتبع التقدم واسترجاع الأخطاء المدمجة.

تمنع الأقفال الموجودة لكل جهاز عمليات النقل المتزامنة من تلف البيانات. يحصل كل نقل على معرف فريد، وتتم إزالة عمليات النقل المهجورة تلقائياً بعد 5 دقائق من عدم النشاط. قم برفع تطبيق جديد أو تنزيل نسخة احتياطية أو إعادة تسمية الملفات على الجهاز -- كل ذلك من خلال الواجهة نفسها.

كتل 512 بايت
قفل لكل جهاز
تنظيف 5 دقائق
رفع + تنزيل
نقل الملفات 192.168.1.100
app.sab
مكتمل
24,576 بايت · 48 كتل × 512B رفع · 100%
kits.scode
يجري النقل
131,072 بايت · كتل 164 / 256 تنزيل · 64%
manifest.xml
مفتوح
في انتظار الكتل الأولى... رفع · 0%
قفل ملف الجهاز: نشط
3 نقل · المعرف: #7

هل أنت مهتم بهذا المشروع؟

استكشف الكود المصدري، ساهم، أو تواصل معنا.

عرض على GitHub تواصل معنا