Об этом проекте

Этот репозиторий представляет собой руководство по настройке методом копирования и вставки и установщик для стека домашнего энергомониторинга на Raspberry Pi. Он прослушивает устройства Victron Bluetooth (SmartShunt, MPPT) и публикует декодированные значения в локальный брокер Mosquitto MQTT, который Home Assistant затем отображает в виде сенсоров, таких как напряжение, ток, состояние заряда, солнечная мощность и состояние зарядки. Также могут быть выведены собственные показатели Raspberry Pi: загрузка CPU, температура, Wi-Fi и время работы. Опциональный сайдкар Modbus только для чтения поддерживает инвертор Sungold SPH302480A через USB (PV, аккумулятор, сеть, нагрузка), а опциональный сайдкар шунта VE.Direct выступает в роли супервизора аккумулятора. Оба отключены по умолчанию и включаются флагами в приватном файле .env. Второй Raspberry Pi (HOST_ROLE=pi5) может запускать LAN 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.