

설정과 로그인
SSH 없이 브라우저에서 시작하세요.
HelioPulse 설치, 아키텍처 이해, 장비 연결, 드라이버를 통한 플랫폼 확장을 단계별로 안내합니다.
이 가이드는 실제 HelioPulse 설치 화면으로 설명합니다.


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


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


JSON 정의에서 Modbus 드라이버를 만드세요.
현재 제품은 실시간 모니터링, 로컬 기록, 장치 관리와 Raspberry Pi의 안전한 운영을 하나로 묶습니다.
텔레메트리와 기록을 appliance에 보관하고 인터넷 없이도 로컬 네트워크에서 계속 운영하세요.
WebSocket 실시간 업데이트로 태양광, 소비, 배터리, 계통과 장치 연결 상태를 확인하세요.
오늘부터 사용자 지정 기간 또는 1년까지 발전, 소비, SOC, 온도와 상을 살펴보세요.
선언형 Modbus 드라이버를 불러오고 만들고 재사용할 수 있습니다.
독립 collector, 안정적인 직렬 포트, 장치 상태와 start/stop/restart 작업을 관리합니다.
알람 변화를 추적하고, 인시던트를 확인하며, 연결·구성·collector 이벤트를 감사하세요.
에너지, 이상, 알람과 이벤트를 포함한 결정적 보고서를 생성합니다. 로컬 AI는 선택 사항입니다.
Raspberry 리소스, 연결과 진단을 확인하고 로컬 백업을 만들고 복구하세요.
데스크톱이나 모바일에서 9개 언어와 라이트/다크 테마로 패널을 사용하세요.
PV 배열을 구성한 뒤 예상 태양광 에너지와 실제 생산량을 비교하세요.
호환 BMS를 독립 장치로 등록하고 셀, 밸런싱, SOC, SOH, 온도와 사이클을 확인하세요.
드라이버에서 합성 텔레메트리를 생성해 하드웨어 없이 UI를 검증하세요.
필요하면 로컬 모델을 다운로드하고 활성화하세요. 모델 없이도 결정적 보고서를 사용할 수 있습니다.
TLS로 선택한 broker에 게시하고 Home Assistant Discovery를 사용하세요.
임계값, 일정, 알람 또는 이벤트로 MQTT 게시, webhook 호출과 이벤트 기록을 실행하세요. dry-run도 지원합니다.
아웃바운드 터널 접속과 서명된 앱 업데이트는 구성과 연결 상태에 따라 달라집니다.
현재 로컬 흐름에는 포함되지 않습니다.
현재는 드라이버를 수동으로 불러올 수 있으며 공개 마켓플레이스는 향후 작업입니다.
CAN, BLE와 Modbus가 아닌 JK 프로토콜은 현재 지원 경로에 포함되지 않습니다.
이 버전의 자동화는 인버터 파라미터를 쓰지 않습니다.
앱 OTA는 별도로 제공되며 전체 운영체제 A/B 롤백은 향후 작업입니다.
HelioPulse OS는 로컬 에너지 모니터링을 위해 설계된 Raspberry Pi용 Linux 이미지입니다.
Pi 4 4 GB 또는 Pi 5 4/8 GB.
128 GB USB 3.0 SSD 또는 High Endurance microSD를 권장합니다.
갈바닉 절연 USB–RS485 어댑터.
Raspberry Pi Imager 같은 도구로 다운로드한 파일과 대상 SSD 또는 microSD를 선택하세요.
저장 장치, 네트워크, USB–RS485 어댑터와 Raspberry Pi에 맞는 공식 전원 공급 장치를 연결하세요.
제조업체 설명서에 따라 RS485를 배선하세요. 전원이 켜진 인버터 연결부를 만지지 마세요.
첫 부팅 시 어플라이언스가 브라우저에서 캡티브 포털을 엽니다: Wi-Fi 연결, 관리자 생성, 완료. SSH도, 컴퓨터로 연결하는 케이블도 필요 없습니다.
구운 microSD를 라즈베리 파이에 넣고 전원을 연결하세요. 첫 부팅에서 시스템이 확장되고 HelioPulse가 시작됩니다. 1분 정도 기다리세요.
휴대폰이나 노트북에서 장치가 만든 임시 Wi-Fi 네트워크에 연결하세요. 설정 포털이 브라우저에서 자동으로 열립니다. 열리지 않으면 화면에 표시된 주소를 여세요.
집 Wi-Fi를 선택하고 비밀번호를 입력하거나 유선으로 계속하세요. 신호 강도로 올바른 네트워크를 찾을 수 있습니다.
패널에 로그인할 사용자 이름과 비밀번호(최소 8자)를 설정하세요. 관리자 계정이므로 안전하게 보관하세요.
장치가 지원하면 인터넷으로 패널을 안전하게 열 이름을 선택하세요. 로컬 접속은 항상 작동하므로 이 단계를 건너뛸 수 있습니다.
포털이 설정 완료를 확인하고 패널 주소를 표시합니다. 평소 네트워크로 다시 연결한 뒤 열어 만든 계정으로 로그인하세요.


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


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


평소 네트워크로 다시 연결하고 표시된 패널 주소를 여세요.
포털은 진행 표시줄과 라이트/다크 테마를 갖춘 반응형 안내 흐름입니다. 앱도, SSH도, 컴퓨터로 연결하는 케이블도 필요 없습니다.
각 장치에는 독립 collector가 있습니다. 한 인버터의 장애나 재시작이 다른 장치의 텔레메트리를 중단시키지 않습니다.
인버터 또는 BMS가 프로토콜을 통해 데이터를 제공합니다.
프로토콜, 레지스터, 스케일과 지표를 설명합니다.
각 장치를 격리되고 제어 가능한 프로세스에서 읽습니다.
텔레메트리, 기록, 알람과 예측을 통합합니다.
드라이버는 선언형 JSON 파일입니다. Modbus RTU 통신 방식과 제조업체 레지스터를 HelioPulse 공통 지표로 변환하는 방식을 정의합니다.
패키지는 데이터를 설명할 뿐 시스템에 임의의 바이너리를 설치하지 않습니다.
백엔드는 파일을 승인하기 전에 구조, 프로토콜과 레지스터를 확인합니다.
같은 드라이버를 여러 호환 장치에서 사용할 수 있습니다.
제조업체 프로토콜 설명서와 실제 장치에서 검증한 측정값이 필요합니다. 최소 스키마에는 식별자, 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
}]
}]
}장비 → 드라이버에서 파일을 선택하세요. HelioPulse가 저장 전에 스키마를 검증합니다.
device ID, 드라이버, 영구 by-id 포트와 1~247 사이의 slave ID를 설정하세요.
해당 장치만 시작하거나 재시작하고 텔레메트리가 활성화되었는지 확인하세요.
같은 ID의 다른 파일을 업로드하면 드라이버가 업데이트됩니다. 연결된 장치를 재시작해 새 정의를 적용하세요.
이 페이지는 프로젝트의 현재 방향을 보여줍니다. 기술 검증과 현장 테스트에 따라 범위와 순서는 달라질 수 있습니다.
안정 버전을 다운로드하거나 소스 코드와 프로젝트의 발전을 확인하세요.