النقاط الرئيسية
- ثلاثة بروتوكولات محلية تغطي تقريباً جميع العلامات التجارية: Modbus TCP وجسر MQTT وAPI REST المحلي. الاختيار الصحيح يعتمد على موديل الجهاز المحدد.
- Modbus TCP هو المسار الأكثر موثوقية دون اتصال — يعمل بدون إنترنت أو وسيط سحابي، عبر قراءة السجلات مباشرة عبر الشبكة المحلية.
- EcoFlow PowerStream هو الاستثناء الرئيسي: لا يوجد مسار Modbus TCP أو MQTT محلي حتى تاريخ التحقق (2026-07-03). كل شيء يمر عبر سحابة EcoFlow.
- Victron Cerbo GX يوفر أفضل تحكم محلي: تكامل HA رسمي (من HA 2026.5)، Modbus TCP موثق، وMQTT محلي يعمل دون اتصال بالكامل.
- قد يتغير دعم الواجهة المحلية مع تحديثات البرنامج الثابت — تحقق من مستودع التكامل الحالي قبل الشراء.
ثلاثة مسارات بروتوكول للتكامل المحلي
يقرأ Modbus TCP سجلات الجهاز مباشرة عبر الشبكة المحلية — دون حساب سحابي أو وسيط أو برنامج محوّل. يستمع الجهاز (أو بوابته المحلية) على منفذ TCP (عادة 502 أو 8899) ويستجيب لأوامر قراءة السجلات. يستمر العمل حتى لو انقطع الاتصال بالإنترنت.
تقع تكاملات جسر MQTT بين الجهاز وHome Assistant. ينشر الجهاز البيانات في موضوع — على وسيط السحابة الخاص بالمصنّع أو على نسخة Mosquitto محلية. عند توجيهه لوسيط محلي، يعمل دون اتصال بالكامل.
تستخدم مسارات API REST المحلي طلبات HTTP GET/POST للجهاز أو بوابته على الشبكة المحلية. يعرض Zendure SolarFlow 800 Pro ذلك بشكل أصلي. يقدمه Marstek عبر Marstek Local API (HACS). يستخدم Kostal Plenticore نفس API REST الخاصة بواجهة الويب المدمجة.
📍 في جملة واحدة
يقرأ Modbus TCP السجلات مباشرة عبر الشبكة المحلية، ويستخدم جسر MQTT وسيطاً pub/sub، وتستجيب API REST المحلي لطلبات HTTP مباشرة على الجهاز.
💬 بعبارات بسيطة
Modbus TCP = اتصال مباشر على الشبكة المنزلية؛ MQTT = نظام مراسلة مع وسيط وسيط؛ REST API = الجهاز يستجيب كموقع ويب.
مصفوفة التوافق حسب العلامة التجارية
تم التحقق من جميع الخلايا في 2026-07-03 مقابل مستودعات تكامل GitHub النشطة ووثائق المصنّع. قد يتغير دعم الواجهة المحلية مع إصدارات البرنامج الثابت — استخدم هذا الجدول كنقطة بداية وتحقق من الحالة الراهنة قبل الشراء.
| العلامة التجارية / المنتج | Modbus TCP | MQTT محلي | API REST محلي | يعمل دون اتصال؟ | تكامل HA |
|---|---|---|---|---|---|
| Anker SOLIX (تخزين) | ✅ منفذ 502، رسمي | ⚠️ جسر سحابي فقط | — | ✅ عبر Modbus | ha-anker-solix-official (HACS) |
| Zendure SolarFlow 800 Pro | — | ✅ HTTP+MQTT محلي | ✅ HTTP محلي | ✅ | Zendure/Zendure-HA (رسمي) |
| Zendure Hub 1200/2000, Hyper 2000 | — | ⚠️ MQTT سحابي فقط | — | ❌ | z-master42/solarflow (مجتمع) |
| Hoymiles HMS/HMT (عبر DTU-Pro) | ✅ عبر DTU-Pro | ✅ OpenDTU / hoymiles-mqtt | — | ✅ | hoymiles-mqtt-integration (HACS) |
| Marstek B2500 / Jupiter / Venus | ⚠️ RS485 على Venus فقط | ✅ hame-relay+hm2mqtt | ✅ Marstek Local API | ✅ | Marstek Local API v1.0.0 (HACS) |
| Growatt NOAH 2000 / عواكس | ✅ Modbus TCP محلي | ✅ noah-mqtt / growatt2mqtt | — | ✅ | Homeassistant-Growatt-Local-Modbus (HACS) |
| Deye SUN600G3 (عاكس دقيق) | ✅ منفذ 8899 (غير موثق) | ✅ SolarmanV5 / deye-inverter-mqtt | — | ✅ | تكامل Solarman HACS |
| Victron Cerbo GX | ✅ رسمي، موثق | ✅ رسمي (HA 2026.5+) | — | ✅ | تكامل HA الرسمي |
| Sungrow سلسلة SH-RT | ✅ مجتمع | ✅ ModbusTCP2MQTT | — | ✅ | Sungrow-SHx-Inverter-Modbus (HACS) |
| Kostal Plenticore (G3+) | ✅ HACS | — | ✅ API REST رسمي | ✅ | تكامل HA الرسمي (REST) |
| EcoFlow PowerStream | ❌ | ❌ MQTT سحابي فقط | ❌ | ❌ | tolwi/hassio-ecoflow-cloud (سحابة فقط) |
تم التحقق في 2026-07-03. قد تضيف تحديثات البرنامج الثابت وصولاً محلياً أو تزيله — تحقق قبل الشراء.
المسار أ: إعداد Modbus TCP
يتطلب Modbus TCP ثلاثة شروط: الجهاز على نفس الشبكة المحلية مع Home Assistant، وتفعيل واجهة Modbus، وخريطة سجلات الموديل. تتضمن معظم تكاملات HACS المجتمعية خريطة السجلات — يكفي توفير عنوان IP.
- 1تفعيل Modbus TCP على الجهاز: Anker SOLIX ← تطبيق Anker ← إعدادات الجهاز ← تفعيل Modbus. Hoymiles ← واجهة ويب DTU-Pro. Growatt ← مفعّل افتراضياً. Deye ← لا إعداد مطلوب، المنفذ 8899 مفتوح دائماً.
- 2تعيين عنوان IP ثابت للجهاز في الراوتر (أو حجز DHCP) لضمان ثبات عنوان تكامل HA.
- 3تثبيت تكامل HACS المناسب: ha-anker-solix-official لـ Anker، وhoymiles-mqtt-integration لـ Hoymiles، وHomeassistant-Growatt-Local-Modbus لـ Growatt، وSolarman لـ Deye، والتكامل الرسمي Victron GX لـ Victron.
- 4إدخال IP الجهاز والمنفذ في إعدادات التكامل. المنفذ القياسي لـ Modbus: 502؛ يستخدم Deye المنفذ 8899.
- 5التحقق من كيانات أجهزة الاستشعار في HA — يجب أن تتحدث طاقة الإخراج الحالية خلال 5-10 ثوانٍ. إذا أظهرت الكيانات "غير متاح"، تحقق من IP وتفعيل Modbus وقواعد جدار الحماية.
المسار ب: إعداد جسر MQTT
تعمل تكاملات جسر MQTT عبر تشغيل سكريبت محوّل صغير (أو إضافة HA) يستطلع الجهاز أو يتلقى بيانات الدفع ويعيد نشرها على وسيط Mosquitto المحلي. يشترك Home Assistant في تلك المواضيع عبر تكامل MQTT. يعمل دون اتصال بمجرد تهيئة المحوّل على وسيط محلي.
- 1تثبيت وسيط Mosquitto كإضافة HA (الإعدادات ← الإضافات ← Mosquitto Broker) وتهيئة اسم المستخدم وكلمة المرور.
- 2إعداد تكامل MQTT في HA (الإعدادات ← الأجهزة والخدمات ← إضافة تكامل ← MQTT) وتوصيله بالوسيط المحلي.
- 3تثبيت المحوّل الخاص بالجهاز: noah-mqtt لـ Growatt NOAH 2000، وhame-relay+hm2mqtt لـ Marstek، وhoymiles-mqtt لـ Hoymiles، وdeye-inverter-mqtt لـ Deye، أو Zendure-HA لـ Zendure.
- 4توجيه المحوّل نحو IP الجهاز وإن أمكن نحو وسيط Mosquitto المحلي بدلاً من وسيط سحابة المصنّع.
- 5تأكيد تدفق البيانات: يجب أن تظهر الكيانات تلقائياً عبر MQTT discovery.
المسار ج: API REST المحلي
تعني API REST المحلي أن الجهاز يشغّل خادم HTTP على الشبكة المحلية — دون محوّل منفصل. يستخدم Zendure SolarFlow 800 Pro وMarstek وKostal Plenticore هذا المسار.
- 1تأكيد توفر API المحلي للموديل: README تكامل HACS أو بوابة المطورين لدى المصنّع.
- 2تثبيت التكامل من HACS: البحث عن "Marstek Local API" أو "Kostal Plenticore". يتعامل Zendure-HA (الرسمي) مع API المحلي وMQTT السحابي كليهما.
- 3إدخال IP الجهاز وكلمة مرور المسؤول إذا لزم (يستخدم Kostal كلمة مرور واجهة الويب).
- 4التحقق من كيانات أجهزة الاستشعار والتحكم — يشمل ذلك للكوستال والمارستيك التحكم في حد شحن البطارية.
تكامل EVCC
يمكن لـ EVCC (متحكم شحن السيارات الكهربائية مفتوح المصدر) استخدام بيانات إنتاج الطاقة الشمسية للشرفة المحلية لمزامنة شحن السيارة الكهربائية مع أوقات ذروة الإنتاج الشمسي. يدعم EVCC Modbus TCP وMQTT بشكل أصلي. في evcc.yaml، قم بتهيئة الجهاز كعداد مع type: modbus أو type: mqtt.
الأسئلة الشائعة
هل تفعيل Modbus TCP على Anker SOLIX يعطّل تطبيق Anker؟
لا. يعمل تكامل Modbus الرسمي لـ Anker SOLIX بالتوازي مع تطبيق Anker والسحابة. تفعيل Modbus TCP في إعدادات التطبيق يضيف وصولاً محلياً للسجلات دون إزالة وظائف السحابة.
لماذا تُظهر المصفوفة صفين مختلفين لـ Zendure؟
يمتلك Zendure SolarFlow 800 Pro واجهة HTTP/MQTT محلية تعمل دون اتصال بالإنترنت. النماذج القديمة (Hub 1200 وHub 2000 وHyper 2000 وAce 1500) تتواصل فقط مع وسيط MQTT السحابي لـ Zendure. يتعامل تكامل Zendure-HA الرسمي مع كلا المسارين.
هل سيحصل EcoFlow PowerStream على تحكم محلي؟
أعلنت EcoFlow في منتصف 2025 أن الحلول المحلية قيد التطوير دون تحديد تاريخ إصدار. لم يكن هناك أي مسار API محلي أو Modbus TCP موثق لـ PowerStream حتى تاريخ التحقق (2026-07-03). راجع مجتمع مطوري EcoFlow لمعرفة الوضع الراهن.
أي علامة تجارية لديها أفضل تحكم محلي بشكل عام؟
Victron Cerbo GX لديه أفضل دعم محلي: تكامل رسمي في صميم Home Assistant (من HA 2026.5)، Modbus TCP موثق مع خريطة سجلات منشورة، وMQTT محلي يعمل دون اتصال بالكامل. يليه Anker SOLIX مع تكامل HACS مجتمعي رسمي وModbus TCP على المنفذ 502 يعمل بالتوازي مع تطبيق السحابة.