Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Registo de alterações

v2.12.0 - 07 jul. 2026

O que há de novo?

  1. Suporte para novos dispositivos

  • Adicionado suporte para interruptores inteligentes Zigbee SONOFF MINI-ZB1GP / MINI-ZB1GSP de canal único com monitorização de eletricidade.

  1. Suporte expandido para dispositivos do Matter Hub

  • O Matter Hub agora suporta os seguintes tipos de dispositivos Matter:

    • Sensor de temperatura

    • Sensor de contacto

    • Sensor de ocupação

    • Sensor de luz

    • Sensor de qualidade do ar

    • Alarme de fumo e CO

    • Interruptor genérico

    • Unidade plug-in regulável

  1. Suporte aprimorado para sincronização de dispositivos vinculados ao eWeLink

  • Os subdispositivos Zigbee elegíveis ligados através do SONOFF NSPanel Pro 86-Relay e do Bridge-M podem agora ser sincronizados com o eWeLink CUBE através do eWeLink Smart Home Add-on ou da funcionalidade incorporada "Adicionar dispositivos vinculados ao eWeLink".

  1. Melhorias no SONOFF TRVZB

  • O gráfico de temperatura no CUBE CAST foi otimizado com um eixo ajustado dinamicamente com base nos dados de temperatura.

Correções de erros

  1. Corrigido um problema em que era apresentada uma janela pop-up em branco ao configurar o reporte de temperatura e humidade para sensores de qualidade do ar IKEA.

  2. Corrigido um problema em que o SONOFF SNZB-02M podia mostrar incorretamente o conforto da pressão atmosférica como fora do intervalo quando não estava configurado qualquer intervalo de conforto da pressão atmosférica.

  3. Corrigido um problema em que o add-on Node-RED podia não ser instalado ou atualizado em alguns dispositivos.

v2.11.0 - 16 jun. 2026

Esta versão expande a compatibilidade para vários dispositivos SONOFF e o suporte para as capacidades de câmara do Matter Bridge, com melhorias na deteção da temperatura ambiente do SONOFF TRVZB. Leia atentamente as notas antes de atualizar para esta versão.

O que há de novo?

  1. Suporte para novos dispositivos

  • Adicionado suporte para os seguintes dispositivos SONOFF:

    • Sensor de presença SONOFF SNZB-06P24 de 24 GHz.

    • Sensor de movimento SONOFF SNZB-03PR2 com reporte de iluminância.

    • Válvula de água inteligente de canal duplo SONOFF SWV-ZF2U / SWV-ZF2E.

    • Tomada inteligente SONOFF BASIC-ZB1GSP com monitorização de energia.

  1. Suporte para câmara no Matter Bridge

  • A sincronização de câmaras elegíveis para as plataformas Matter adicionadas através do Matter Bridge está agora disponível, com transmissão de vídeo e áudio.

  1. Melhorias no SONOFF TRVZB

  • O SONOFF SNZB-02B pode agora ser usado como sensor externo para o SONOFF TRVZB, fornecendo leituras de temperatura ambiente mais precisas.

Correções de erros

  1. Corrigido um problema em que o gráfico de consumo de energia não carregava para fichas Zigbee sincronizadas com o CUBE via eWeLink Smart Home Add-on.

  2. Corrigido um problema em que os dongles Zigbee SONOFF não podiam ser detetados ou configurados corretamente pelo CUBE quando ligados ao Raspberry Pi 4.

v2.10.3 - 27 mai. 2026

Esta versão introduz o eWeLink Smart Home incorporado para uma sincronização de dispositivos mais fácil, instalação com um clique no Mac, e adiciona suporte para executar o CUBE OS em ambientes Docker para opções de implementação mais flexíveis. Leia atentamente as notas antes de atualizar para esta versão.

O que há de novo?

  1. eWeLink Smart Home incorporado para uma sincronização de dispositivos mais fácil

  • Está agora disponível no CUBE uma forma mais simples de sincronizar dispositivos ligados ao eWeLink. Inicie sessão com a sua conta eWeLink a partir de Início > Adicionar dispositivo para sincronizar e gerir dispositivos elegíveis diretamente no CUBE, sem instalar o eWeLink Smart Home Add-on. Nota: Os dispositivos do add-on existentes continuarão a funcionar independentemente.

  1. Suporte para implementação em Docker

  • O CUBE OS pode agora ser executado em ambientes Docker, oferecendo aos utilizadores opções de implementação mais flexíveis. Para implementações baseadas em Docker, as seguintes funcionalidades ao nível do sistema não estão disponíveis:

    • Docker (Add-ons)

    • Funcionalidades piloto > Altifalante Bluetooth

    • Definições > Informações da gateway > Atualização de versão

    • Definições > Reiniciar e desligar

  • Para atualizar uma implementação baseada em Docker, faça pull da imagem Docker mais recente.

  1. Suporte expandido para instalação com um clique

  • Adicionado suporte para instalação do CUBE com um clique no Mac.

v2.10.2 - 18 mai. 2026

Esta versão introduz gestão de firmware dos SONOFF Dongles, opções de implementação expandidas e novo suporte para dispositivos, melhorando ainda mais a compatibilidade do Matter Bridge, o comportamento dos dispositivos Zigbee e a estabilidade geral do sistema. Leia atentamente as notas antes de atualizar para esta versão.

O que há de novo?

  1. Gestão de firmware dos SONOFF Dongles

  • Adicionada deteção automática para dongles Zigbee ligados. Os SONOFF Dongles não suportados agora podem ser atualizados com um clique para as versões estáveis recomendadas de firmware Zigbee:

    • Os dongles baseados em Ember com versões de firmware anteriores à v7.4.5 serão atualizados para a v8.0.2.

    • Os dongles baseados em ZStack com versões de firmware anteriores à v20250321 serão atualizados para a v20250321.

  • Depois de atualizar o CUBE para a v2.10.2, os SONOFF Dongles ligados serão atualizados automaticamente para as versões estáveis de firmware recomendadas. Os dongles que não sejam SONOFF devem ser atualizados usando as suas ferramentas oficiais de flashing para garantir uma ligação e controlo dos dispositivos adequados.

  • Comportamento otimizado de deteção offline Zigbee:

    • Os dispositivos router reportam no prazo de 1 minuto

    • Os dispositivos finais reportam no prazo de 1 hora

    • Os dispositivos que excederem o intervalo de reporte aparecerão offline até serem acionados novamente.

  1. Suporte expandido para implementação

  • Adicionado suporte para instalação do CUBE com um clique no Windows.

  1. Melhorias no Matter Bridge

  • Atualizado o SDK do CUBE Matter Bridge para a v1.5.0.

  • O nome predefinido dos dispositivos foi otimizado ao sincronizar dispositivos com SmartThings e Alexa via Matter Bridge.

  1. Melhorias no SONOFF TRVZB

  • Adicionado o Modo Adaptativo para o SONOFF TRVZB, configurável na aplicação eWeLink, para ajudar a manter uma temperatura ambiente mais estável.

  1. Suporte para novos dispositivos

  • Adicionado suporte para as válvulas de água inteligentes Zigbee SONOFF Hydro ONE (SWV-ZFU / SWV-ZFE) e as válvulas de água inteligentes Zigbee SONOFF Hydro ONE Lite (SWV-ZNU / SWV-ZNE).

  • Adicionado suporte para o Módulo de Contacto Seco Inteligente SONOFF MINI-ZBD.

  1. Melhorias de compatibilidade dos dispositivos Zigbee

  • O comportamento de arranque foi otimizado para dispositivos Zigbee de terceiros.

  1. Funcionalidade de desligar

  • Adicionada uma opção de desligar na página de definições web do CUBE.

Correções de erros

  1. Corrigido um problema em que as placas Raspberry Pi 5 Rev1.1 podiam não arrancar corretamente.

  2. Corrigido um problema em que os dispositivos podiam não sincronizar com a Alexa via Matter Bridge.

  3. Corrigidos problemas de timeout ao adicionar câmaras ONVIF / RTSP.

  4. Corrigido o problema em que o estado do sensor de vibração HOBEIAN ZG-102ZM não era atualizado.

  5. Corrigido o problema em que o gráfico de dados históricos das fichas Zigbee não era exibido.

v2.9.0 - 13 fev. 2026

Esta versão expande a compatibilidade do eWeLink Smart Home Add-on e o suporte para dispositivos, com melhorias notáveis na fiabilidade do Zigbee, na estabilidade da automação e na flexibilidade do controlo de dispositivos. Leia atentamente as notas antes de atualizar para esta versão.

O que há de novo?

  1. Suporte expandido para dispositivos do eWeLink Smart Home Add-on

  • Adicionado suporte para sincronizar monitores de qualidade do ar elegíveis com o CUBE via eWeLink Smart Home Add-on, incluindo:

    • SONOFF SAWF-07P

    • SONOFF SAWF-08P

  • Adicionado suporte para o sensor de porta/janela SONOFF SNZB-04PR2.

  1. Melhorias de precisão e calibração dos sensores

  • Adicionada uma opção para ajustar os desvios de temperatura e humidade para SONOFF SNZB-02P para melhorar a precisão das leituras.

  1. Melhorias no SONOFF TRVZB

  • O Modo Boost e o Modo de substituição temporária de temperatura podem agora ser ativados ou desativados diretamente a partir de CUBE CAST.

  • SONOFF SNZB-02LD pode agora ser usado como sensor externo para medições mais precisas de temperatura e humidade ambiente.

  1. Melhorias na fiabilidade do Zigbee

  • A lógica de deteção offline Zigbee foi otimizada para identificar mais rapidamente as desconexões de dispositivos e melhorar a fiabilidade geral do controlo. (Nota: Devido a limitações do intervalo de reporte, os sensores legados SNZB-01 / SNZB-02 / SNZB-03 / SNZB-04 estão excluídos desta otimização)

  1. Melhorias no controlo e calibração dos dispositivos

  • Adicionada uma opção para configurar tempo de deslocação extra para SONOFF MINI-ZBRBS para garantir que as persianas abrem e fecham totalmente durante a calibração manual.

  • Adicionado suporte de controlo por passos para SONOFF MINI-ZB2GS, permitindo que pressões em interruptores externos alternem entre estados predefinidos do relé para cenários de controlo multiestado mais flexíveis.

  • Adicionada uma opção de calibração manual à SONOFF MINI-ZBDIM calibração de regulação de intensidade.

Correções de erros

  1. Corrigido um bug em que a capacidade de entrada do Frient IOMZB-110 módulo estava ausente no eWeLink CUBE.

  2. Resolvido um problema de controlo com o Tuya/Moes AM43-0.45/40-ES-EZ motor de cortina.

  3. Corrigido um problema em que o Paulmann Gen2 RGB Remote não podia ser usado como acionador de cena.

  4. Corrigido um problema em que o comando SONOFF R5 não acionava as automatizações como esperado após a restauração de uma cópia de segurança.

  5. Corrigido um problema em que as cenas tinham de ser reativadas após um reinício do eWeLink CUBE para voltarem a executar.

  6. Corrigido um problema intermitente em que o Matter Bridge podia deixar de responder em plataformas de terceiros ao sincronizar um grande número de dispositivos.

  7. Otimizada a lógica para sincronizar sensores de fuga de água via o Matter Bridge.

v2.8.1 - 27 nov. 2025

Temos o prazer de anunciar que o CUBE OS passou agora de beta para a sua versão oficial de lançamento. A partir desta versão, os números de versão do CUBE OS manter-se-ão alinhados com os lançamentos do iHost para atualizações e melhorias de funcionalidades consistentes.

Esta atualização expande o suporte do Matter Bridge e do eWeLink Smart Home Add-on, introduz novas funcionalidades para o SONOFF TRVZB, melhora a organização das cenas e melhora a usabilidade geral. Leia atentamente as notas antes de atualizar para esta versão.

O que há de novo?

  1. Suporte expandido para dispositivos do Matter Bridge

  • Adicionado suporte para sincronizar tipos de dispositivos adicionais definidos pelo Matter via Matter Bridge, incluindo:

    • Sensor de luz

    • Alarme de fumo e CO (abrangendo sensores de fumo e monóxido de carbono)

    • Sensor de qualidade do ar

    • Ar condicionado de divisão

    • Ventoinha

  1. Novas funcionalidades para o SONOFF TRVZB

  • Adicionados dois novos modos temporários para o SONOFF TRVZB:

    • Modo Boost: aquece rapidamente a divisão durante um curto período.

    • Modo de substituição temporária de temperatura: mantém temporariamente uma temperatura definida.

  1. Melhorias nas cenas

  • Crie facilmente etiquetas personalizadas e atribua cenas a etiquetas existentes.

  1. Novas funcionalidades para câmaras compatíveis com ONVIF

  • As câmaras compatíveis com ONVIF agora suportam o uso de "Movimento detetado" e "Ocupação detetada" como acionadores de cena.

  1. eWeLink Smart Home Add-on expandido

  • Adicionado suporte para sincronizar dispositivos elegíveis com o CUBE via eWeLink Smart Home Add-on, incluindo:

    • SONOFF Mini-RBS

    • Dispositivos virtuais (abrangendo interruptores e botões)

    • Subdispositivos do ZBBridge-U: SONOFF S60ZB, SNZB-02LD/SNZB-02WD, Mini-ZBRBS, SWV

  1. Melhorias na lista de dispositivos

  • Pode agora ocultar dispositivos offline da lista de dispositivos da página Início para uma vista mais limpa e focada.

  1. Melhorias na visualização de dados

  • Os gráficos de temperatura e humidade agora suportam dados ao nível de minuto para insights mais detalhados.

Correções de erros

  1. Corrigido um problema em que as notificações de cena não eram recebidas via CUBE CAST durante o acesso remoto.

  2. Corrigidos problemas de compatibilidade com o Tuya TS0001 Fingerbot.

  3. Corrigidos problemas do Matter Bridge:

  • Corrigido um problema em que o Matter Bridge ficava offline repetidamente.

  • Corrigido um problema em que adicionar mais de 10 dispositivos impedia que os dispositivos recém-adicionados fossem sincronizados através do Matter Bridge.

  • Corrigido um problema em que a Matter Fabric era apresentada como vazia.

  • Corrigido um problema em que eliminar um dispositivo do CUBE não removia corretamente o dispositivo correspondente da plataforma Matter de terceiros.

  1. Corrigidos problemas do SONOFF TRVZB:

  • Corrigido um problema em que o Modo Boost e o Modo de substituição temporária de temperatura falhavam ao ser executados corretamente.

  • Corrigido um problema em que as ações de cena permitiam incorretamente selecionar o Modo de substituição temporária de temperatura.

  • Corrigido um problema em que ajustar o Tempo Boost enquanto estava no Modo Boost causava temporização inconsistente ou incorreta.

  • Corrigido um bug em que os dados ao nível de minuto dos gráficos de temperatura e humidade não podiam ser apresentados corretamente.

  • Corrigido um problema em que a temperatura-alvo exibida no CAST excedia o intervalo permitido.

  • Corrigido um problema em que a temperatura-alvo do TRV para o Modo Boost/Modo de substituição temporária de temperatura não podia ser sincronizada ou apresentada corretamente.

v0.5 - 27 ago. 2025

Esta atualização traz compatibilidade alargada com dongles Zigbee, melhorias para câmaras ONVIF e melhorias notáveis para o CUBE CAST. Leia atentamente as notas antes de atualizar para esta versão.

O que há de novo?

  1. Compatibilidade alargada com dongles Zigbee

  • Adicionado suporte para o SONOFF ZBDongle-P e o Coordenador Zigbee SMLIGHT SLZB-06.

  • Dongles compatíveis atualmente testados e verificados:

    • SONOFF ZBDongle-E / P

    • SMLIGHT SLZB-06 / 06M

    • SkyConnect Zigbee (EZSP)

  1. Suporte para câmara ONVIF

  • Adicionada deteção automática de câmaras compatíveis com ONVIF.

  • Suporte para controlo PTZ (Pan-Tilt-Zoom).

  • Dispositivos compatíveis testados e verificados (com as versões de firmware necessárias):

    • SONOFF CAM-PT2: FW ≥ 1.0.6

    • SONOFF CAM-B1P: FW ≥ 1.0.2

  1. Melhorias no CAST

  • Layouts alargados dos painéis CAST para uma experiência de dashboard mais flexível.

Correções de erros

  1. Corrigido um problema em que o CUBE OS falhava ao arrancar no Raspberry Pi 5 e não conseguia realizar atualizações OTA.

  2. Corrigida a apresentação imprecisa de dados nos gráficos de tendência das válvulas termostáticas dos radiadores.

  3. Corrigido um bug em que cenas acionadas por limites de potência falhavam ao ser executadas corretamente.

  4. Corrigido um problema em que as atualizações de estado dos dispositivos no CAST exigiam uma atualização manual do navegador.

v0.4 - 19 jun. 2025

O que há de novo?

  1. Suporte para instalação autónoma em:

  • Raspberry Pi 4B / 5

  • - Máquinas virtuais x86_64 (por ex., VirtualBox, VMware)

  • Dispositivos NAS (modelos compatíveis)

  1. Suporte para dispositivos Zigbee através de dongles USB (por ex., SONOFF ZBDongle-E)

  2. Matter Hub e Matter Bridge

  3. Acesso remoto/notificações push via PWA

  4. Suporte para Docker e add-ons

  5. Cenas, grupos, OTA, dashboards CAST e mais Para mais detalhes: https://forum.ewelink.cc/t/ewelink-cube-os-v0-4-beta-self-hosted-ewelink-server-public-testing-now-open/198406

Como experimentar

  1. Transfira a imagem que se adapta ao seu ambiente (Raspberry Pi / VM / NAS) raspberrypi4_64_prod.img.xz para Raspberry Pi sdcard.vdi.xz/sdcard.vmdk.xz para VMs, dispositivos NAS

  2. Grave e instale seguindo estes guias: https://github.com/eWeLinkCUBE/CUBE-OS/tree/master/Installation%20%26%20User%20Guide

  3. Junte-se ao nosso servidor Discord para obter apoio e partilhar comentários

v0.2 - 31 dez. 2024

O que há de novo?

  • O Acesso Remoto é lançado para Funcionalidades Piloto. Quando ativado, permite o acesso remoto à consola web e ao CAST do CubeOS através de links seguros.

  • O CAST pode ser instalado como uma aplicação web com ligações remotas. A aplicação permite notificações para execuções de cenas, eventos de Smart Security, alternância de interruptores e fichas, e acionadores de sensores, incluindo:

    • Deteção de movimento

    • Deteção de presença

    • Deteção de janela aberta

    • Deteção de gás

    • Deteção de fuga de água

    • Deteção de fumo

    • Ações de pressão

  • Os utilizadores podem agora alterar a palavra-passe da consola web.

  • Está agora disponível uma nova página de definições do MQTT Broker, com suporte para adicionar contas e palavras-passe. Permite ligar ao broker usando essas credenciais para subscrever mensagens MQTT.

  • As câmaras agora suportam a visualização simultânea de vários streams.

Nova plataforma:

  • Raspberry Pi 5 (não verificado).

Otimizações:

  • O add-on Tasmota foi otimizado através do uso do broker Mosquitto incorporado, deixando de ser necessária a instalação de um broker adicional.

  • Melhorado o formato de apresentação dos códigos de configuração Matter para maior legibilidade.

Correções de erros:

  • Resolvido um problema em que a versão 0.1 não conseguia lidar com atualizações via OTA.

Problemas conhecidos:

Existem os seguintes problemas conhecidos na versão 0.2, que continuam por resolver em futuras atualizações:

  • Ao aceder à web pela primeira vez, as máquinas virtuais e o Raspberry Pi podem ocasionalmente mostrar um aviso de desconexão.

  • A instalação no Raspberry Pi não suporta adicionar dispositivos Matter recém-adicionados ou repostos de fábrica. Utilize plataformas Matter alternativas e partilhe-as com o CubeOS.

  • O Matter Hub por vezes falha e reinicia continuamente.

  • As notificações remotas são instáveis; os utilizadores podem não receber notificações do sistema, potencialmente relacionado com o ambiente de rede, problemas do navegador ou encerramentos de processos de backend.

  • A transmissão de câmara pode falhar na instalação no Raspberry Pi através de links remotos.

  • Os Matter Bridges não mostrarão subdispositivos na página de controlo dos dispositivos. E, para subdispositivos ligados a um Matter Bridge na página de definições, falta a informação da Ponte Ligada.

  • A Matter Fabric com o Vendor ID "1286" não pode ser removida no CubeOS. Se o sistema sinalizar um dispositivo com a fabric cheia, remova-o de uma das outras plataformas Matter a que está ligado.

  • O OTA não é suportado para a instalação no Raspberry Pi 5.

AnteriorZigbeeSeguinteGuia do programador e da API

Última atualização