A iluminação RGB do 7.º compartimento do ZimaCube dispõe agora de 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 ponto de acesso Wi-Fi do ESP32 em 172.16.1.1 e aceita comandos JSON para os modos de respiração, cor fixa e personalização de cada LED.
O CubeFX continua a ser um firmware opcional da comunidade, para quem pretende uma interface diferente ou uma personalização mais aprofundada. 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 protocolo LED do 7.º compartimento atual indica que o controlador de iluminação é um ESP32 ligado a uma fita de 13 LEDs WS2812B.
Ligar ao controlador de iluminação
O firmware oficial cria uma rede Wi-Fi com o nome ZimaCube e a palavra-passe documentada homecloud. O controlador está acessível em 172.16.1.1.
ping 172.16.1.1Definir uma cor fixa
{
"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 um dos 13 LEDs. A documentação oficial indica atualmente que os modos 3 e 4 estão em desenvolvimento.
Pode manter o firmware de origem
Esta é a principal diferença em relação ao tópico do fórum de 2024: agora existe documentação oficial de controlo. Pode automatizar o firmware de origem sem instalar uma imagem de terceiros.
O CubeFX continua a ser uma alternativa opcional
O tópico do projeto da comunidade CubeFX disponibiliza um firmware personalizado para utilizadores avançados que o pretendam instalar deliberadamente.
Atualizações de firmware OTA
O ESP32 também disponibiliza uma interface Web OTA. Não carregue ficheiros binários de firmware desconhecidos; guarde uma cópia de recuperação e tenha em conta que o firmware personalizado pode alterar o protocolo esperado pelo ZimaOS.
Utilize RGB para automatizar indicadores de estado
Como o ponto de acesso de controlo aceita JSON, pode associar o estado das cópias de segurança, alertas dos 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.
Converta os valores HSV antes de enviar o JSON
O protocolo oficial espera valores de matiz, saturação e valor numa escala de 0 a 255. Se o seletor de cores usar graus e percentagens, converta esses valores antes de os enviar para o ESP32.
Teste 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 dos discos ou efeitos de música. Assim, os problemas de rede/protocolo ficam separados da lógica de automação.
Mantenha a automação fora das funções críticas
Utilize os LEDs como um indicador visual prático, não como o único meio de alerta para falhas dos discos ou cópias de segurança. As notificações de hardware também devem estar disponíveis nos registos, por e-mail, na 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 separadamente?
O modo personalizado oficial permite definir valores HSV para cada LED.
Posso restaurar o firmware de origem depois de instalar o CubeFX?
Utilize os recursos OTA/firmware oficiais e confirme a revisão de hardware correta antes de voltar a instalar o firmware.
