ZimaCube 7th Bay RGB 조명에 이제 공식 제어 프로토콜이 제공되므로 색상이나 효과를 변경하기 위해 CubeFX를 플래싱할 필요가 없습니다. 공식 펌웨어는 172.16.1.1에서 ESP32 Wi-Fi 엔드포인트를 제공하며, 브리딩, 고정 색상, LED별 사용자 지정 모드를 위한 JSON 명령을 지원합니다.
CubeFX는 다른 인터페이스나 더 세밀한 사용자 지정을 원하는 사용자를 위한 선택형 커뮤니티 펌웨어입니다. 기본 펌웨어를 사용하려면 공식 HTTP/JSON 방식을 사용하고 ESP32를 다시 플래싱하지 마세요.
7th Bay 조명 작동 방식
현재 7th Bay LED 프로토콜에 따르면 조명 컨트롤러는 13개의 WS2812B LED 스트립에 연결된 ESP32입니다.
조명 컨트롤러에 연결하기
공식 펌웨어는 문서에 명시된 비밀번호 homecloud로 ZimaCube라는 Wi-Fi 네트워크를 생성합니다. 컨트롤러는 172.16.1.1에서 연결할 수 있습니다.
ping 172.16.1.1고정 색상 설정
{
"id": 2,
"data": [
{"h": 21, "s": 255, "v": 255}
]
}JSON을 컨트롤러로 전송합니다:
curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/post브리딩 및 사용자 지정 모드
모드 1은 속도 조절이 가능한 브리딩 모드입니다. 모드 5에서는 13개 LED 모두의 색상과 밝기를 LED별로 제어할 수 있습니다. 공식 문서에 따르면 모드 3과 4는 현재 개발 중입니다.
기본 펌웨어를 그대로 사용할 수 있습니다
이것이 2024년 포럼 스레드에서 달라진 핵심입니다. 이제 공식 제어 문서가 제공됩니다. 서드파티 이미지를 플래싱하지 않고도 기본 펌웨어를 스크립트로 제어할 수 있습니다.
CubeFX는 여전히 선택 가능한 대안입니다
커뮤니티의 CubeFX 프로젝트 스레드에서는 고급 사용자가 원하는 경우 사용할 수 있는 맞춤형 펌웨어 설치 방법을 안내합니다.
OTA 펌웨어 업데이트
ESP32에는 OTA 웹 인터페이스도 있습니다. 출처를 알 수 없는 펌웨어 바이너리는 업로드하지 마세요. 복구용 사본을 보관하고, 커스텀 펌웨어가 ZimaOS에서 기대하는 프로토콜을 변경할 수 있다는 점을 알아두세요.
RGB를 상태 자동화에 활용하기
제어 엔드포인트가 JSON을 수신하므로, 저장소 서브시스템을 건드리지 않고 스크립트에서 백업 상태, 디스크 알림, 다운로드 또는 로컬 AI 활동을 색상에 연결할 수 있습니다.
RGB 제어 개요에서 프로젝트에 관한 추가 정보를 확인할 수 있습니다.
JSON 전송 전에 HSV 값 변환하기
공식 프로토콜에서는 색조, 채도, 명도를 0–255 범위로 지정해야 합니다. 색상 선택기에서 도와 백분율을 사용한다면 ESP32로 전송하기 전에 해당 값을 변환하세요.
자동화 전에 간단한 모드 하나를 테스트하세요
단색 모드로 시작해 컨트롤러가 응답하는지 확인하세요. 그 후에 백업 상태, 디스크 알림 또는 음악 효과를 위한 스크립트를 추가하세요. 이렇게 하면 네트워크/프로토콜 문제와 자동화 로직 문제를 구분할 수 있습니다.
중요하지 않은 자동화로 유지하세요
LED는 시각적으로 편리한 알림 수단으로 사용하고, 디스크 장애나 백업 알림을 위한 유일한 경로로 삼지 마세요. 하드웨어 알림은 로그, 이메일, 모니터링 또는 다른 지속적인 채널로도 제공되어야 합니다.
자주 묻는 질문
LED를 제어하려면 CubeFX가 필요한가요?
아니요. 현재 공식 펌웨어에는 문서화된 JSON/HTTP 프로토콜이 있습니다.
LED 스트립에는 LED가 몇 개 있나요?
공식 하드웨어 문서에는 WS2812B LED 13개가 명시되어 있습니다.
LED를 각각 따로 제어할 수 있나요?
네, 공식 커스텀 모드에서는 LED별 HSV 값을 설정할 수 있습니다.
CubeFX 설치 후 순정 펌웨어로 복원할 수 있나요?
다시 플래시하기 전에 공식 OTA/펌웨어 리소스를 사용하고 올바른 하드웨어 리비전인지 확인하세요.
