커뮤니티 솔루션

공식 7번 베이 LED API로 ZimaCube RGB 제어하기

A 2024 user asked how to control ZimaCube RGB without custom firmware; current ZimaOS docs now publish the official ESP32 JSON protocol.

ZimaCube 7번 베이 RGB 조명에는 이제 공식 제어 프로토콜이 제공되므로, 색상이나 효과를 변경하기 위해 CubeFX를 플래시할 필요가 없습니다. 공식 펌웨어는 172.16.1.1에서 ESP32 Wi-Fi 엔드포인트를 제공하며, 브리딩, 고정, LED별 사용자 지정 모드에 대한 JSON 명령을 지원합니다.

다른 인터페이스나 더 세밀한 사용자 지정을 원하는 사용자를 위해 CubeFX는 여전히 선택 가능한 커뮤니티 펌웨어입니다. 기본 펌웨어를 사용하려면 공식 HTTP/JSON 방식을 이용하고 ESP32를 다시 플래시하지 마세요.

7번 베이 조명 작동 방식

현재 7번 베이 LED 프로토콜에 따르면 조명 컨트롤러는 13개 LED WS2812B 스트립에 연결된 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는 시각적 편의를 위한 수단으로 사용하고, 디스크 오류나 백업에 대한 유일한 알림 경로로 의존하지 마세요. 하드웨어 알림은 로그, 이메일, 모니터링 또는 다른 지속적인 채널에도 기록되어야 합니다.

FAQ

LED를 제어하려면 CubeFX가 필요한가요?

아니요. 현재 공식 펌웨어에는 문서화된 JSON/HTTP 프로토콜이 있습니다.

스트립에는 LED가 몇 개 있나요?

공식 하드웨어 문서에는 WS2812B LED 13개가 명시되어 있습니다.

각 LED를 개별적으로 제어할 수 있나요?

예. 공식 사용자 지정 모드에서는 LED별 HSV 값을 지원합니다.

CubeFX를 사용한 후 기본 펌웨어로 복원할 수 있나요?

공식 OTA/펌웨어 리소스를 사용하고, 다시 플래시하기 전에 올바른 하드웨어 버전인지 확인하세요.