프로젝트 소개

이 저장소는 라즈베리 파이 가정용 에너지 모니터링 스택을 위한 복사·붙여넣기 설치 가이드이자 설치 프로그램입니다. Victron 블루투스 장치(SmartShunt, MPPT)를 수신하고 디코딩된 값을 로컬 Mosquitto MQTT 브로커에 게시하면, Home Assistant가 이를 전압, 전류, 충전 상태, 태양광 전력, 충전 상태 등의 센서로 표시합니다. 파이 자체의 CPU, 온도, Wi-Fi, 가동 시간도 표시할 수 있습니다. 선택적 읽기 전용 Modbus 사이드카는 USB를 통한 Sungold SPH302480A 인버터(PV, 배터리, 그리드, 부하)를 지원하며, 선택적 VE.Direct 션트 사이드카는 배터리 감독자 역할을 합니다. 둘 다 기본적으로 비활성화되어 있으며 비공개 .env 파일의 플래그로 활성화됩니다. 두 번째 라즈베리 파이(HOST_ROLE=pi5)는 AdGuard를 통한 LAN DNS를 실행하고 집의 Bluetooth Low Energy 데이터를 Pi 4 브로커로 전달할 수 있습니다. 설치는 scripts/deploy.sh에 의해 구동되며, 이 스크립트는 Docker, Mosquitto, Home Assistant, Victron 블루투스 리더를 설정하고 재실행해도 안전합니다. 구성은 .env(MQTT 호스트, 사용자, 비밀번호, 기능 플래그)와 victron-secrets.env(32자 광고 키)에 있으며, 장치 MAC 주소는 사용자 설정 파일에 지정됩니다. README는 Victron 브리지가 시작 시 비밀 값을 검증하고, 없이 실행되는 대신 누락된 변수 이름을 명시하며 종료된다고 설명합니다. 접속은 로컬 네트워크를 위한 것이며, 선택적 Tailscale은 대시보드를 공개적으로 노출하는 대신 집 밖에서 볼 때 사용됩니다. 문서는 장치 추가·제거, Pi 5 엣지 역할, Tailscale, Sungold 관련 세부 사항, 태양광 전력 균형, 대시보드 옵션, 그리고 Home Assistant 접속 불가, Victron 엔터티 누락, MQTT 연결 거부, 컨테이너 재시작 루프와 같은 일반적인 문제에 대한 문제 해결 단계를 다룹니다. MIT 라이선스입니다.