🚀
쉬운 시작과 통합
HA Add-on 또는 Docker 환경에서 Homenet2MQTT와 Homenet2Matter를 모두 간편하게 구동할 수 있습니다.
h2mRS485 월패드를 MQTT또는 Matter로 연결하는 스마트 홈 브릿지
Homenet2MQTT(h2m-mqtt) 및 Homenet2Matter(h2m-matter)를 포괄하는 한국형 홈네트워크 연동 솔루션
Homenet2MQTT(h2m-mqtt) 및 Homenet2Matter(h2m-matter)를 포괄하는 한국형 홈네트워크 연동 솔루션
h2m은 RS485 홈네트워크 장치와 스마트홈 플랫폼 간의 양방향 통신을 돕는 강력한 브릿지 솔루션입니다. 사용 환경과 목적에 따라 **MQTT 연동(Homenet2MQTT)**과 Matter 연동(Homenet2Matter) 두 가지 모드를 선택하여 사용할 수 있습니다.
| 연동 방식 | 대상 플랫폼 | 주요 특징 | 권장 사용자 |
|---|---|---|---|
| MQTT (Homenet2MQTT) | Home Assistant (MQTT Discovery) | 세부 설정 커스텀 및 자동화에 유용하며, 오랜 기간 검증된 유연함 제공 | 이미 구축된 MQTT 기반의 HA 설정을 사용하거나 복잡한 커스텀 규칙이 필요한 사용자 |
| Matter (Homenet2Matter) | Apple Home, SmartThings, Google Home, Alexa 등 | 스마트홈 표준 Matter 프로토콜을 사용해 플랫폼 허브에 직접 연동 | 복잡한 설정 없이 스마트 기기 앱에서 직접 QR 코드 스캔으로 장치를 등록하려는 사용자 |
h2m은 AI 에이전트가 설정을 직접 조사하고 수정할 수 있도록 Agent API, MCP 서버, h2m-config 스킬을 제공합니다. YAML을 직접 편집하지 않아도 자연어로 요청하면, 에이전트가 갤러리 프리셋·적용 예제·미매칭 패킷을 근거로 엔티티 초안을 만들고 검증·적용까지 수행합니다.
Agent API / MCP — 포트 조회, 패킷 분석·캡처, 엔티티 초안 검증·적용, 설정 백업·복원, 승인된 패킷 전송을 REST와 MCP 도구로 노출합니다. 기본 포트는 3001이며 UI 설정 > Agent API에서 토큰을 발급합니다.
h2m-config 스킬 — Claude Code, Codex, Cursor, Qoder 등 SKILL.md를 읽는 에이전트에 설치할 수 있습니다. "이 디바이스 붙여줘", "미매칭 패킷 정리해줘" 같은 요청을 실제 설정 작업으로 이어 줍니다.
안전장치 — 설정 변경은 검증 → 사용자 승인 → 적용 순서로 진행합니다. 브릿지 삭제는 현재 YAML과 일치하는 백업이 있어야만 가능하고, 실기기 패킷 전송은 미리보기와 명시적 승인 후에만 수행합니다.