A iluminação RGB do 7.º compartimento do ZimaCube tem agora um protocolo de controlo oficial, pelo que não precisa de instalar o CubeFX apenas para mudar as cores ou os efeitos. O firmware oficial disponibiliza um endpoint Wi-Fi ESP32 em 172.16.1.1 e aceita comandos JSON para modos de respiração, constante e personalizados por LED.
O CubeFX continua a ser um firmware comunitário opcional para utilizadores que pretendam uma interface diferente ou uma personalização mais avançada. Se preferir o firmware de origem, utilize o método oficial HTTP/JSON e evite reinstalar o firmware do ESP32.
Como funciona a iluminação do 7.º compartimento
O atual protocolo LED do 7.º compartimento indica que o controlador de iluminação é um ESP32 ligado a uma fita WS2812B com 13 LEDs.
Ligar ao controlador de iluminação
O firmware oficial cria uma rede Wi-Fi denominada ZimaCube com a palavra-passe documentada homecloud. O controlador está acessível em 172.16.1.1.
ping 172.16.1.1Definir uma cor constante
{
"id": 2,
"data": [
{"h": 21, "s": 255, "v": 255}
]
}Envie o JSON para o controlador:
curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/postModos de respiração e personalizados
O modo 1 é o modo de respiração, com velocidade ajustável. O modo 5 permite controlar a cor e o brilho de cada LED dos 13 LEDs. A documentação oficial assinala atualmente os modos 3 e 4 como estando em desenvolvimento.
Pode manter o firmware de origem
Esta é a principal alteração em relação ao tópico do fórum de 2024: existe agora documentação oficial de controlo. Pode criar scripts para o firmware de origem sem instalar uma imagem de terceiros.
O CubeFX continua a ser uma alternativa opcional
O tópico do projeto CubeFX comunitário disponibiliza um caminho de firmware personalizado para utilizadores avançados que o pretendam especificamente.
Atualizações de firmware OTA
O ESP32 também disponibiliza uma interface web OTA. Não carregue binários de firmware desconhecidos; mantenha uma cópia de recuperação e tenha em conta que o firmware personalizado pode alterar o protocolo esperado pelo ZimaOS.
Utilizar RGB para automatização de estados
Como o endpoint de controlo aceita JSON, pode associar o estado das cópias de segurança, alertas de discos, transferências ou atividade de IA local a cores através de scripts, sem tocar no subsistema de armazenamento.
A visão geral do controlo RGB fornece contexto adicional para o projeto.
Converter valores HSV antes de enviar o JSON
O protocolo oficial espera que a tonalidade, a saturação e o valor estejam numa escala de 0–255. Se o seletor de cores utilizar graus e percentagens, converta esses valores antes de os enviar para o ESP32.
Testar um modo simples antes de automatizar
Comece pelo modo de cor constante e confirme que o controlador responde. Só depois adicione scripts para o estado das cópias de segurança, alertas de discos ou efeitos musicais. Desta forma, separa os problemas de rede ou do protocolo da lógica de automatização.
Manter a automatização fora de funções críticas
Utilize os LEDs como uma comodidade visual, não como o único canal de alerta para falhas de discos ou cópias de segurança. As notificações de hardware também devem existir em registos, e-mail, monitorização ou noutro canal persistente.
Perguntas frequentes
Preciso do CubeFX para controlar os LEDs?
Não. O firmware oficial atual tem um protocolo JSON/HTTP documentado.
Quantos LEDs tem a fita?
A documentação oficial do hardware especifica 13 LEDs WS2812B.
Posso controlar cada LED individualmente?
Sim, o modo personalizado oficial permite definir valores HSV para cada LED.
Posso restaurar o firmware de origem depois de utilizar o CubeFX?
Utilize os recursos oficiais de OTA/firmware e confirme a revisão correta do hardware antes de reinstalar o firmware.
