원하는 방식으로 HelioPulse를 설치하세요.

Raspberry Pi에 HelioPulse OS 설치하기.

HelioPulse OS는 Raspberry Pi용 즉시 사용 가능한 Linux 이미지입니다. 시스템, 패널, 업데이트를 하나로 묶어 로컬 에너지 모니터링에 맞게 설계했습니다.

1. 1

   안정 버전 다운로드

   공개 releases 저장소에서 이미지를 받고 릴리스 노트를 확인하세요.

   최신 이미지 다운로드 · 2.0 GB모든 릴리스 보기
2. 2

   이미지 기록

   Raspberry Pi Imager 같은 도구로 다운로드한 파일과 대상 SSD 또는 microSD를 선택하세요.

3. 3

   연결하고 전원 켜기

   저장 장치, 네트워크, USB–RS485 어댑터와 Raspberry Pi에 맞는 공식 전원 공급 장치를 연결하세요.

브라우저에서 구성하세요.

첫 부팅 시 어플라이언스가 브라우저에서 캡티브 포털을 엽니다: Wi-Fi 연결, 관리자 생성, 완료. SSH도, 컴퓨터로 연결하는 케이블도 필요 없습니다.

1. 1

   카드를 넣고 전원을 켜세요

   구운 microSD를 라즈베리 파이에 넣고 전원을 연결하세요. 첫 부팅에서 시스템이 확장되고 HelioPulse가 시작됩니다. 1분 정도 기다리세요.

2. 2

   HelioPulse 네트워크에 연결

   휴대폰이나 노트북에서 장치가 만든 개방형 Wi-Fi 네트워크 HelioPulse-XXXX(비밀번호 없음)에 연결하세요. 그런 다음 브라우저에서 http://heliopulse.setup:8090 으로 이동하면 설정 포털이 열립니다. 일부 휴대폰에서는 포털이 자동으로 열립니다. 열리지 않으면 해당 주소를 직접 입력하세요.

3. 3

   인터넷에 연결

   집 Wi-Fi를 선택하고 비밀번호를 입력하거나 유선으로 계속하세요. 신호 강도로 올바른 네트워크를 찾을 수 있습니다.

4. 4

   관리자 생성

   패널에 로그인할 사용자 이름과 비밀번호(최소 8자)를 설정하세요. 관리자 계정이므로 안전하게 보관하세요.

5. 5

   선택 사항: 원격 접속 활성화

   장치가 지원하면 인터넷으로 패널을 안전하게 열 이름을 선택하세요. 로컬 접속은 항상 작동하므로 이 단계를 건너뛸 수 있습니다.

6. 6

   사용 준비 완료

   포털이 설정 완료를 확인합니다. 이제 장치가 사용자의 Wi-Fi에 연결되었습니다. 평소 네트워크로 다시 연결한 뒤 http://heliopulse.local:8080 에서 패널을 열고 만든 계정으로 로그인하세요. HelioPulse-XXXX 네트워크는 더 이상 필요 없으므로 사라집니다.

Docker에서 HelioPulse 실행하기.

이미지를 굽는 대신 미니 PC, NAS, 서버에 컨테이너를 받아 실행하세요. 같은 코어이며 Raspberry가 필요 없습니다. ESP32 수집기는 네트워크로 연결되고, USB-RS485 어댑터와 원격 접속도 HelioPulse OS와 똑같이 동작합니다.

1. 1

   컨테이너 시작

   빠르게 써 보려면 docker run, 상시 설치에는 Docker Compose를 사용하세요. 이미지가 아키텍처를 자동으로 선택합니다.

   Docker Composedocker run

   복사

   # compose.yml — 상시 설치(권장)
   services:
     heliopulse:
       image: public.ecr.aws/j7s7r2j5/heliopulse:latest
       container_name: heliopulse
       ports: ["8080:8080"]
       volumes: ["heliopulse-data:/data"]
       environment: { HP_RUNTIME: docker }
       restart: unless-stopped
       read_only: true
       tmpfs: [/tmp]
       cap_drop: [ALL]
       security_opt: ["no-new-privileges:true"]
       logging: { driver: json-file, options: { max-size: 10m, max-file: "3" } }
   volumes: { heliopulse-data: {} }

2. 2

   패널 열기

   네트워크의 아무 기기에서 http://<호스트IP>:8080 에 접속해 설정 마법사에서 관리자 계정을 만드세요.

   로컬 네트워크 밖에서 열면(예: 인터넷에 공개한 포트) 마법사가 일회용 설정 코드를 요청합니다. docker exec heliopulse cat /data/config/bootstrap-token 으로 확인하세요. 그런 다음 시스템 › 일반 › 사이트 위치를 설정하세요. 일일 합계, 보고서, 일정은 해당 위치의 시간대를 사용합니다.

3. 3

   최신 상태 유지

   업데이트는 이미지를 교체하는 방식입니다. 새 버전을 받아 컨테이너를 다시 만드세요. 데이터는 볼륨에 그대로 남습니다.

   최신 상태 유지복사

   # 새 버전으로 업데이트 (이미지 교체):
   docker compose pull && docker compose up -d

Home Assistant 앱 설치하기.

Home Assistant OS에서 HelioPulse를 App으로 실행하세요. 사이드바 접근, 관리자 로그인, MQTT 센서를 지원합니다.

1. 1

   저장소 추가

   설정 → Apps → App 스토어 → ⋮ → 저장소를 열고 아래 공개 저장소를 추가하세요.

   저장소 추가복사

   https://github.com/helios-pulse/heliopulse-releases

   내 Home Assistant에 추가
2. 2

   HelioPulse 설치 후 열기

   HelioPulse를 검색해 설치하고 시작하세요. 사이드바에 표시를 활성화한 뒤 Home Assistant 관리자 세션으로 여세요.

3. 3

   센서 연결(선택)

   센서를 사용하려면 Home Assistant에서 Mosquitto와 MQTT 통합을 설정하세요. mqtt_mode는 auto로 유지하고 HelioPulse에서 장치를 설정하세요. 인스턴스마다 다른 topic_prefix를 사용하세요.

4. 4

   안전하게 업데이트

   먼저 백업을 만든 후 Home Assistant에서 App을 업데이트하세요. App 버전은 HelioPulse OS 및 OTA 업데이트와 별개입니다.

로컬 모듈형 플랫폼.

각 장치에는 독립 collector가 있습니다. 한 인버터의 장애나 재시작이 다른 장치의 텔레메트리를 중단시키지 않습니다.

장비와 HelioPulse 사이의 번역기.

드라이버는 선언형 JSON 파일입니다. Modbus RTU 통신 방식과 제조업체 레지스터를 HelioPulse 공통 지표로 변환하는 방식을 정의합니다.

Modbus 맵으로 시작하세요.

제조업체 프로토콜 설명서와 실제 장치에서 검증한 측정값이 필요합니다. 최소 스키마에는 식별자, modbus_rtu 프로토콜과 하나 이상의 레지스터가 있는 그룹이 필요합니다.

{
  "id": "my-inverter-modbus",
  "name": "My inverter",
  "manufacturer": "Manufacturer",
  "models": ["Model A"],
  "protocol": {
    "type": "modbus_rtu",
    "baud_rate": 9600,
    "slave_id": 1
  },
  "register_groups": [{
    "name": "battery",
    "interval": "5s",
    "registers": [{
      "address": 256,
      "name": "battery_soc",
      "metric": "battery.soc_pct",
      "unit": "%",
      "scale": 1,
      "signed": false
    }]
  }]
}

SSH 없이 활성화하세요.