عن المشروع

هذا المستودع دليل إعداد ونصّاب جاهز للنسخ واللصق لمجموعة مراقبة طاقة منزلية على Raspberry Pi. يستمع إلى أجهزة Victron عبر Bluetooth (SmartShunt وMPPT) وينشر القيم المفكوكة إلى وسيط Mosquitto MQTT محلي، ليعرضها Home Assistant كمستشعرات مثل الجهد والتيار وحالة الشحن والطاقة الشمسية وحالة الشحن. ويمكن أيضاً إظهار بيانات المعالج ودرجة الحرارة وWi-Fi ومدة التشغيل الخاصة بالـ Pi. يدعم برنامج Modbus جانبي اختياري للقراءة فقط عاكس Sungold SPH302480A عبر USB (الطاقة الشمسية والبطارية والشبكة والحمل)، كما يعمل برنامج VE.Direct جانبي اختياري للتحويل كمراقب للبطارية. كلاهما معطّل افتراضياً ويُفعّل عبر أعلام في ملف .env خاص. ويمكن لجهاز Raspberry Pi ثانٍ (HOST_ROLE=pi5) تشغيل DNS محلي عبر AdGuard وإعادة توجيه بيانات Bluetooth Low Energy المنزلية إلى وسيط Pi 4. تُدار عملية التثبيت عبر scripts/deploy.sh، الذي يهيّئ Docker وMosquitto وHome Assistant وقارئ Victron عبر Bluetooth، ويمكن إعادة تشغيله بأمان. توجد الإعدادات في .env (مضيف MQTT والمستخدم وكلمة المرور وأعلام الميزات) وفي victron-secrets.env (مفاتيح إعلان من 32 حرفاً)، مع ضبط عناوين MAC للأجهزة في ملف إعدادات المستخدم. يشير README إلى أن جسر Victron يتحقق من أسراره عند بدء التشغيل ويخرج مع تسمية المتغير المفقود بدلاً من العمل بدونها. الوصول مخصص للشبكة المحلية، مع استخدام Tailscale اختيارياً لعرض لوحة المعلومات خارج المنزل بدلاً من كشفها علناً. تغطي الوثائق إضافة الأجهزة أو إزالتها، ودور Pi 5 الطرفي، وTailscale، وتفاصيل Sungold، وتوازن الطاقة الشمسية وخيارات لوحة المعلومات، إضافة إلى خطوات استكشاف الأخطاء الشائعة مثل تعذّر الوصول إلى Home Assistant، وغياب كيانات Victron، ورفض اتصال MQTT، وحلقات إعادة تشغيل الحاويات. مرخّص بموجب MIT.