حلّ المجتمع

تحكّم في إضاءة RGB لجهاز ZimaCube باستخدام واجهة برمجة التطبيقات الرسمية لمصباح الحجرة السابعة

A 2024 user asked how to control ZimaCube RGB without custom firmware; current ZimaOS docs now publish the official ESP32 JSON protocol.

تتمتع إضاءة الحجرة السابعة في ZimaCube الآن ببروتوكول تحكم رسمي، لذا لا تحتاج إلى تثبيت CubeFX فقط لتغيير الألوان أو المؤثرات. تكشف البرامج الثابتة الرسمية عن نقطة اتصال ESP32 عبر Wi‑Fi على العنوان 172.16.1.1، وتقبل أوامر JSON لأوضاع التنفس والإضاءة الثابتة والأوضاع المخصصة لكل LED.

يظل CubeFX برنامجًا ثابتًا اختياريًا من المجتمع للمستخدمين الذين يريدون واجهة مختلفة أو تخصيصًا أعمق. إذا كنت تفضل البرنامج الثابت الأصلي، فاستخدم طريقة HTTP/JSON الرسمية وتجنب إعادة تثبيت البرنامج على ESP32.

كيفية عمل إضاءة الحجرة السابعة

يوضح بروتوكول LED للحجرة السابعة الحالي أن وحدة التحكم في الإضاءة عبارة عن ESP32 متصل بشريط WS2812B يضم 13 مصباح LED.

الاتصال بوحدة التحكم في الإضاءة

ينشئ البرنامج الثابت الرسمي شبكة Wi‑Fi باسم ZimaCube باستخدام كلمة المرور الموثقة homecloud. ويمكن الوصول إلى وحدة التحكم عبر 172.16.1.1.

ping 172.16.1.1

تعيين لون ثابت

{
  "id": 2,
  "data": [
    {"h": 21, "s": 255, "v": 255}
  ]
}

أرسل JSON إلى وحدة التحكم:

curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/post

أوضاع التنفس والأوضاع المخصصة

الوضع 1 هو وضع التنفس مع سرعة قابلة للتعديل. ويوفر الوضع 5 تحكمًا في لون/سطوع كل LED على حدة للمصابيح الـ13 جميعها. وتضع الوثائق الرسمية حاليًا الوضعين 3 و4 قيد التطوير.

يمكنك الاحتفاظ بالبرنامج الثابت الأصلي

هذا هو التغيير الأساسي مقارنة بموضوع المنتدى المنشور عام 2024: أصبحت وثائق التحكم الرسمية متاحة الآن. ويمكنك برمجة البرنامج الثابت الأصلي باستخدام النصوص البرمجية دون تثبيت صورة تابعة لجهة خارجية.

لا يزال CubeFX بديلًا اختياريًا

يوفر موضوع مشروع CubeFX المجتمعي مسارًا لتثبيت برنامج ثابت مخصص للمستخدمين المتقدمين الذين يريدونه عن قصد.

تحديثات البرنامج الثابت عبر الهواء

يوفر ESP32 أيضًا واجهة ويب للتحديث عبر الهواء. لا ترفع ملفات برنامج ثابت غير معروفة؛ احتفظ بنسخة استرداد وافهم أن البرنامج الثابت المخصص قد يغيّر البروتوكول الذي يتوقعه ZimaOS.

استخدم RGB لأتمتة الحالات

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

يوفر الاستعراض العام للتحكم في RGB سياقًا إضافيًا للمشروع.

حوّل قيم HSV قبل إرسال JSON

يتوقع البروتوكول الرسمي قيم الصبغة والتشبع والقيمة على مقياس من 0 إلى 255. إذا كانت أداة اختيار الألوان لديك تستخدم الدرجات المئوية والنسب المئوية، فحوّل هذه القيم قبل إرسالها إلى ESP32.

اختبر وضعًا بسيطًا واحدًا قبل الأتمتة

ابدأ بوضع اللون الثابت وتأكد من استجابة وحدة التحكم. وبعد ذلك فقط أضف نصوصًا برمجية لحالة النسخ الاحتياطي أو تنبيهات الأقراص أو المؤثرات الموسيقية. وبهذه الطريقة تفصل بين مشكلات الشبكة/البروتوكول ومنطق الأتمتة.

اجعل الأتمتة غير حرجة

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

الأسئلة الشائعة

هل أحتاج إلى CubeFX للتحكم في مصابيح LED؟

لا. يتضمن البرنامج الثابت الرسمي الحالي بروتوكول JSON/HTTP موثقًا.

كم عدد مصابيح LED في الشريط؟

تحدد وثائق الأجهزة الرسمية وجود 13 مصباح LED من نوع WS2812B.

هل يمكنني التحكم في كل LED بشكل منفصل؟

نعم، يدعم الوضع المخصص الرسمي قيم HSV لكل LED على حدة.

هل يمكنني استعادة البرنامج الثابت الأصلي بعد استخدام CubeFX؟

استخدم موارد OTA/البرنامج الثابت الرسمية، وتأكد من إصدار الأجهزة الصحيح قبل إعادة التثبيت.