HBD Control Extension for VS Code

HBD Control Extension은 VS Code 내에서 Homey Bridge Daemon (HBD) 및 Homey Cloud와의 상호작용을 간편하게 테스트하고 디버깅할 수 있도록 돕는 강력한 도구입니다.

이 확장은 사이드바에 통합된 제어 패널을 통해 HBD 소켓 통신을 모니터링하고, 데몬 및 동글 상태를 제어하며, 클라우드 환경의 설정을 손쉽게 변경할 수 있습니다.

주요 기능 (Features)

1. HBD Control (Homey Bridge Daemon 제어)

로컬에서 실행 중인 Homey Bridge Daemon과 소켓(.socket_ctl)을 통해 통신하여 상태를 제어합니다.

• 실시간 소켓 모니터링: /tmp/socket_ctl 경로의 소켓 연결 상태를 실시간으로 확인합니다. 모니터링을 켜거나 끌 수 있으며, 연결 상태에 따라 시각적인 표시기(초록/빨강)를 제공합니다.
• Daemon Status 제어: Zigbee, Thread, Matter 등 각 프로토콜 데몬의 활성/비활성 상태를 시뮬레이션 명령으로 전송할 수 있습니다.
• Dongle Status 제어: USB 동글의 연결/해제 상태를 시뮬레이션합니다. Device Type, Product/Vendor ID 등 상세 정보를 포함하여 동글 상태 변경 이벤트를 발생시킬 수 있습니다.
• Device Profile 변경: 디바이스 프로필 변경 이벤트를 전송하여 HBD의 동작을 테스트할 수 있습니다.

2. Cloud Control (클라우드 제어)

Homey Cloud 환경(ThinQ Cloud 및 Local Cloud)에 대한 설정을 VS Code에서 직접 수행합니다.

• ThinQ Cloud 제어: QA 환경의 ThinQ Homey Cloud에 접속하여 특정 HomeyID의 forcedDongleStatus 설정을 변경합니다.
  • API 엔드포인트: https://{homeyId}.kic-qa-thinq-homey-cloud.lgthinq.com:4859
• Local Cloud 제어: 로컬 네트워크에 구성된 Homey Cloud 서버(IP/Port 지정)에 대해 forcedDongleStatus 설정을 변경합니다.
• 자동 Device ID 탐색: Device ID를 입력하지 않을 경우, 입력된 HomeyID에 연결된 첫 번째 디바이스를 자동으로 찾아 설정을 적용합니다.

시스템 요구사항 (Requirements)

• Linux Environment: 이 확장은 /tmp/socket_ctl Unix 도메인 소켓을 사용하므로 리눅스 환경에서 실행되는 HBD를 대상으로 합니다.
• Network: Cloud Control 기능을 사용하기 위해서는 curl 명령어가 설치되어 있어야 하며, 타겟 클라우드 서버에 접근 가능해야 합니다.

사용 방법 (Usage)

1. VS Code 사이드바에서 HBD Control 아이콘을 클릭합니다.
2. HBD Control 탭:
   • Socket Monitoring 스위치를 켜서 HBD와의 연결을 확인합니다.
   • Daemon 또는 Dongle 섹션에서 원하는 값을 선택/입력하고 Send 버튼을 누릅니다.
3. Cloud Control 탭:
   • 상단의 ThinQ Cloud 또는 Local Cloud 버튼으로 모드를 전환합니다.
   • ThinQ Cloud: HomeyID를 입력하고 Force Dongle Status를 True/False로 설정한 뒤 버튼을 누릅니다.
   • Local Cloud: 타겟 서버의 IP와 Port, HomeyID를 입력하고 명령을 수행합니다.

Note: 이 확장은 내부 개발 및 테스트 목적으로 제작되었습니다.