사이트로 돌아가기시작 및 문서 센터

빈 Raspberry에서 첫 에너지 데이터까지.

HelioPulse 설치, 아키텍처 이해, 장비 연결, 드라이버를 통한 플랫폼 확장을 단계별로 안내합니다.

HelioPulse OS 1.7.0 기준 저장소에 맞춘 안내
실제 제품 둘러보기

설치 전에 단계를 확인하세요.

이 가이드는 실제 HelioPulse 설치 화면으로 설명합니다.

설정과 로그인설정과 로그인

설정과 로그인

SSH 없이 브라우저에서 시작하세요.

실시간 에너지 개요실시간 에너지 개요

실시간 에너지 개요

시스템이 발전과 소비를 보고하는지 확인하세요.

드라이버 편집기드라이버 편집기

드라이버 편집기

JSON 정의에서 Modbus 드라이버를 만드세요.

HelioPulse가 현재 제공하는 기능

지금 사용할 수 있는 로컬 에너지 플랫폼

현재 제품은 실시간 모니터링, 로컬 기록, 장치 관리와 Raspberry Pi의 안전한 운영을 하나로 묶습니다.

현재 제공

로컬 우선 모니터링

텔레메트리와 기록을 appliance에 보관하고 인터넷 없이도 로컬 네트워크에서 계속 운영하세요.

품질 정보가 있는 실시간 텔레메트리

WebSocket 실시간 업데이트로 태양광, 소비, 배터리, 계통과 장치 연결 상태를 확인하세요.

기록 분석

오늘부터 사용자 지정 기간 또는 1년까지 발전, 소비, SOC, 온도와 상을 살펴보세요.

검증된 JSON 드라이버

선언형 Modbus 드라이버를 불러오고 만들고 재사용할 수 있습니다.

다중 장치 운영

독립 collector, 안정적인 직렬 포트, 장치 상태와 start/stop/restart 작업을 관리합니다.

알람과 이벤트 타임라인

알람 변화를 추적하고, 인시던트를 확인하며, 연결·구성·collector 이벤트를 감사하세요.

일간·주간 보고서

에너지, 이상, 알람과 이벤트를 포함한 결정적 보고서를 생성합니다. 로컬 AI는 선택 사항입니다.

상태, 백업과 복구

Raspberry 리소스, 연결과 진단을 확인하고 로컬 백업을 만들고 복구하세요.

반응형 다국어 UI

데스크톱이나 모바일에서 9개 언어와 라이트/다크 테마로 패널을 사용하세요.

선택 및 고급 기능

태양광 예측

PV 배열을 구성한 뒤 예상 태양광 에너지와 실제 생산량을 비교하세요.

Modbus RTU BMS

호환 BMS를 독립 장치로 등록하고 셀, 밸런싱, SOC, SOH, 온도와 사이클을 확인하세요.

모의 모드

드라이버에서 합성 텔레메트리를 생성해 하드웨어 없이 UI를 검증하세요.

보고서용 로컬 AI

필요하면 로컬 모델을 다운로드하고 활성화하세요. 모델 없이도 결정적 보고서를 사용할 수 있습니다.

MQTT 및 Home Assistant

TLS로 선택한 broker에 게시하고 Home Assistant Discovery를 사용하세요.

로컬 자동화

임계값, 일정, 알람 또는 이벤트로 MQTT 게시, webhook 호출과 이벤트 기록을 실행하세요. dry-run도 지원합니다.

원격 접속과 앱 OTA

아웃바운드 터널 접속과 서명된 앱 업데이트는 구성과 연결 상태에 따라 달라집니다.

로드맵

클라우드 동기화

현재 로컬 흐름에는 포함되지 않습니다.

드라이버 마켓플레이스

현재는 드라이버를 수동으로 불러올 수 있으며 공개 마켓플레이스는 향후 작업입니다.

독점 BMS 프로토콜

CAN, BLE와 Modbus가 아닌 JK 프로토콜은 현재 지원 경로에 포함되지 않습니다.

인버터 자동 쓰기

이 버전의 자동화는 인버터 파라미터를 쓰지 않습니다.

전체 OS A/B 롤백

앱 OTA는 별도로 제공되며 전체 운영체제 A/B 롤백은 향후 작업입니다.

01설치

appliance를 준비하세요.

HelioPulse OS는 로컬 에너지 모니터링을 위해 설계된 Raspberry Pi용 Linux 이미지입니다.

Raspberry Pi 4 또는 5

Pi 4 4 GB 또는 Pi 5 4/8 GB.

저장 장치

128 GB USB 3.0 SSD 또는 High Endurance microSD를 권장합니다.

통신

갈바닉 절연 USB–RS485 어댑터.

  1. 1

    안정 버전 다운로드

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

    모든 릴리스 보기
  2. 2

    이미지 기록

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

  3. 3

    연결하고 전원 켜기

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

전원을 끈 상태에서 작업하세요

제조업체 설명서에 따라 RS485를 배선하세요. 전원이 켜진 인버터 연결부를 만지지 마세요.

02첫 부팅

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

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

로컬 네트워크Raspberry Pi 찾기
초기 계정안전한 자격 증명 만들기
첫 장치드라이버, 포트와 slave ID
  1. 1

    카드를 넣고 전원을 켜세요

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

  2. 2

    HelioPulse 네트워크에 연결

    휴대폰이나 노트북에서 장치가 만든 임시 Wi-Fi 네트워크에 연결하세요. 설정 포털이 브라우저에서 자동으로 열립니다. 열리지 않으면 화면에 표시된 주소를 여세요.

  3. 3

    1. 인터넷에 연결

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

  4. 4

    2. 관리자 생성

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

  5. 5

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

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

  6. 6

    3. 사용 준비 완료

    포털이 설정 완료를 확인하고 패널 주소를 표시합니다. 평소 네트워크로 다시 연결한 뒤 열어 만든 계정으로 로그인하세요.

1. 인터넷에 연결1. 인터넷에 연결

1. 인터넷에 연결

Wi-Fi 네트워크를 선택하세요 (유선으로 계속 가능).

2. 관리자 생성2. 관리자 생성

2. 관리자 생성

패널에 로그인할 자격 증명을 설정하세요.

3. 사용 준비 완료3. 사용 준비 완료

3. 사용 준비 완료

평소 네트워크로 다시 연결하고 표시된 패널 주소를 여세요.

휴대폰과 노트북을 위한 설계

포털은 진행 표시줄과 라이트/다크 테마를 갖춘 반응형 안내 흐름입니다. 앱도, SSH도, 컴퓨터로 연결하는 케이블도 필요 없습니다.

03작동 방식

로컬 모듈형 플랫폼.

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

01

장치

인버터 또는 BMS가 프로토콜을 통해 데이터를 제공합니다.

02

드라이버

프로토콜, 레지스터, 스케일과 지표를 설명합니다.

03

수집기

각 장치를 격리되고 제어 가능한 프로세스에서 읽습니다.

04

패널

텔레메트리, 기록, 알람과 예측을 통합합니다.

04드라이버

장비와 HelioPulse 사이의 번역기.

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

실행 코드 없음

패키지는 데이터를 설명할 뿐 시스템에 임의의 바이너리를 설치하지 않습니다.

저장 전 검증

백엔드는 파일을 승인하기 전에 구조, 프로토콜과 레지스터를 확인합니다.

재사용 가능

같은 드라이버를 여러 호환 장치에서 사용할 수 있습니다.

05드라이버 만들기

Modbus 맵으로 시작하세요.

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

my-inverter-modbus.json 최소 예시
{
  "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
    }]
  }]
}

게시 전 확인

  • 파일 이름에 안정적이고 안전한 ID를 사용하세요.
  • baud rate, 패리티, stop bits와 slave ID를 확인하세요.
  • 모든 레지스터의 주소, 부호, 스케일과 단위를 확인하세요.
  • 전력과 에너지를 장치의 실제 패널과 비교하세요.
  • 연결 끊김과 범위를 벗어난 값을 테스트하세요.
06불러오기와 연결

SSH 없이 활성화하세요.

단계 1

JSON 업로드

장비 → 드라이버에서 파일을 선택하세요. HelioPulse가 저장 전에 스키마를 검증합니다.

단계 2

장치 등록

device ID, 드라이버, 영구 by-id 포트와 1~247 사이의 slave ID를 설정하세요.

단계 3

collector 시작

해당 장치만 시작하거나 재시작하고 텔레메트리가 활성화되었는지 확인하세요.

제어된 교체

같은 ID의 다른 파일을 업로드하면 드라이버가 업데이트됩니다. 연결된 장치를 재시작해 새 정의를 적용하세요.

07릴리스 전망

다음 단계.

이 페이지는 프로젝트의 현재 방향을 보여줍니다. 기술 검증과 현장 테스트에 따라 범위와 순서는 달라질 수 있습니다.

v1.7제공됨

지능형 로컬 기반

  • 다중 인버터와 패널 드라이버
  • 로컬 AI 모델을 활용한 보고서
  • 기록, 진단과 예측
v1.8예정

드라이버 생태계

  • 마켓플레이스와 검증 가능한 카탈로그
  • 호환성과 드라이버 버전
  • 테스트와 게시 흐름
  • 더 많은 인버터 및 BMS 드라이버
v1.9검토 중

신뢰할 수 있는 고급 운영

  • 관측성과 안내형 유지보수 확대
  • 더 폭넓은 다국어 지원과 일관성
  • 인버터, BMS 및 션트 간 배터리 읽기 고급 검증
  • 제조업체별 알람 디코딩과 다중 작업 자동화 강화
미래방향

다중 사이트와 에이전트

  • 주 Raspberry Pi가 설치를 조정
  • Raspberry Pi 또는 ESP32의 수집 에이전트
  • 클라우드 백업
  • 여러 설치 관리
  • Grafana 통합으로 사용자 지정 대시보드 구성
  • 사용자가 설정할 수 있는 여러 채널의 실시간 알림

설치할 준비가 되었나요?

안정 버전을 다운로드하거나 소스 코드와 프로젝트의 발전을 확인하세요.

릴리스
시작하기: 라즈베리 파이에 HelioPulse 설치 | HelioPulse