> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/english-pt/recursos/registo-de-alteracoes.md).

# Registo de alterações

## v2.11.0 - 16 de jun. de 2026

Esta versão amplia a compatibilidade com vários dispositivos SONOFF e o suporte às capacidades de câmara do Matter Bridge, com uma melhoria na deteção da temperatura ambiente para o SONOFF TRVZB. Reserve um momento para ler as notas antes de atualizar para esta versão.

### Novidades? <a href="#u95d3" id="u95d3"></a>

1. **Novo suporte de 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.

2. **Suporte para câmaras Matter Bridge**

* Agora é possível sincronizar câmaras elegíveis com as plataformas Matter adicionadas através do Matter Bridge, com transmissão de vídeo e áudio.

3. **Melhorias para o SONOFF TRVZB**

* O SONOFF SNZB-02B pode agora ser usado como sensor externo para o SONOFF TRVZB, proporcionando leituras mais precisas da temperatura ambiente.

### Correções de erros <a href="#mcfpk" id="mcfpk"></a>

1. Corrigido um problema em que o gráfico de consumo de energia não carregava para fichas Zigbee sincronizadas com o CUBE via o complemento eWeLink Smart Home.
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 de mai. de 2026

Esta versão introduz o eWeLink Smart Home integrado para facilitar a sincronização de dispositivos, 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. Reserve um momento para ler as notas antes de atualizar para esta versão.

### Novidades? <a href="#x3hge" id="x3hge"></a>

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

* Agora está 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 complemento eWeLink Smart Home.\
  \&#xNAN;*Nota: os dispositivos add-on existentes continuarão a funcionar de forma independente.*

2. **Suporte para implementação via Docker**

* O CUBE OS pode agora ser executado em ambientes Docker, oferecendo aos utilizadores opções de implementação mais flexíveis.\nPara 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 do gateway > Atualização da versão
  * Definições > Reiniciar e desligar
* Para atualizar uma implementação baseada em Docker, faça pull da imagem Docker mais recente.

3. **Suporte alargado para instalação com um clique**

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

***

## v2.10.2 - 18 de mai. de 2026

Esta versão introduz a gestão de firmware dos dongles SONOFF, opções de implementação expandidas e novo suporte para dispositivos, ao mesmo tempo que melhora ainda mais a compatibilidade do Matter Bridge, o comportamento dos dispositivos Zigbee e a estabilidade geral do sistema. Reserve um momento para ler as notas antes de atualizar para esta versão.

### **Novidades？** <a href="#ta75j" id="ta75j"></a>

1. **Gestão de firmware dos dongles SONOFF**

* Adicionada deteção automática para dongles Zigbee ligados. Os dongles SONOFF não suportados podem agora ser atualizados, com um clique, para as versões estáveis de firmware Zigbee recomendadas:
  * Dongles baseados em Ember com versões de firmware anteriores à v7.4.5 serão atualizados para a v8.0.2.
  * 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 dongles SONOFF ligados serão automaticamente atualizados para as versões estáveis de firmware recomendadas. Os dongles que não sejam SONOFF devem ser atualizados usando as respetivas ferramentas oficiais de flash para garantir a ligação e o controlo corretos dos dispositivos.
* Comportamento de deteção de dispositivos Zigbee offline otimizado:
  * Dispositivos router reportam em 1 minuto
  * Dispositivos finais reportam em 1 hora
  * Os dispositivos que excederem o intervalo de reporte aparecerão offline até serem acionados novamente.

2. **Suporte de implementação alargado**

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

3. **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 o SmartThings e a Alexa via Matter Bridge.

4. **Melhorias para o SONOFF TRVZB**

* Adicionado o Modo Adaptativo para o SONOFF TRVZB, configurável na app eWeLink, para ajudar a manter uma temperatura ambiente mais estável.

5. **Novo suporte de 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.

6. **Melhorias na compatibilidade dos dispositivos Zigbee**

* O comportamento de arranque de dispositivos Zigbee de terceiros foi otimizado.

7. **Funcionalidade de desligar**

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

### **Correções de erros** <a href="#ty9uy" id="ty9uy"></a>

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 apresentado.

***

## v2.9.0 - 13 de fev. de 2026

Esta versão expande a compatibilidade do complemento eWeLink Smart Home e o suporte para dispositivos, com melhorias notáveis na fiabilidade do Zigbee, na estabilidade das automatizações e na flexibilidade do controlo dos dispositivos. Reserve um momento para ler as notas antes de atualizar para esta versão.

### **Novidades?** <a href="#id-91770f03" id="id-91770f03"></a>

1. **Suporte de dispositivos do complemento eWeLink Smart Home ampliado**

* Adicionado suporte para sincronizar monitores de qualidade do ar elegíveis com o CUBE via o complemento eWeLink Smart Home, incluindo:
  * **SONOFF SAWF-07P**
  * **SONOFF SAWF-08P**
* Adicionado suporte para o Sensor de Porta/Janela SONOFF SNZB-04PR2.

2. **Melhorias na 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.

3. **Melhorias para o SONOFF TRVZB**

* O Modo Boost e o Modo de Substituição 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 da temperatura e humidade ambiente.

4. **Melhorias na fiabilidade do Zigbee**

* Lógica de deteção de dispositivos Zigbee offline otimizada para identificar desligamentos de dispositivos mais rapidamente e melhorar a fiabilidade geral do controlo. (Nota: devido às limitações do intervalo de reporte, os **SNZB-01 / SNZB-02 / SNZB-03 / SNZB-04** sensores legados estão excluídos desta otimização)

5. **Melhorias no controlo e calibração dos dispositivos**

* Adicionada uma opção para configurar tempo de deslocamento extra para **SONOFF MINI-ZBRBS** para garantir que as persianas abram e fechem totalmente durante a calibração manual.
* Adicionado suporte de controlo por etapas para **SONOFF MINI-ZB2GS**, permitindo que pressões no interruptor externo percorram estados de relé predefinidos para cenários de controlo multiestado mais flexíveis.
* Adicionada uma opção de calibração manual para **SONOFF MINI-ZBDIM** calibração de regulação de intensidade.

### **Correções de erros** <a href="#osbzz" id="osbzz"></a>

1. Corrigido um erro em que a capacidade de entrada de **Frient IOMZB-110** o módulo estava em falta no eWeLink CUBE.
2. Resolvido um problema de controlo com **Tuya/Moes AM43-0.45/40-ES-EZ** o motor da cortina.
3. Corrigido um problema em que **Paulmann Gen2 RGB Remote** não podia ser usado como gatilho de cena.
4. Corrigido um problema em que o **controlo remoto SONOFF R5** não acionava automatizações como esperado após restaurar a partir 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 ser executadas.
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 de sincronização de sensores de fuga de água via o **Matter Bridge**.

***

## v2.8.1 - 27 de nov. de 2025

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

Esta atualização expande o suporte do Matter Bridge e do complemento eWeLink Smart Home, introduz novas funcionalidades para o SONOFF TRVZB, melhora a organização das cenas e a usabilidade geral. Reserve um momento para ler as notas antes de atualizar para esta versão.

### Novidades? <a href="#ufpq2" id="ufpq2"></a>

1. **Suporte de dispositivos Matter Bridge ampliado**

* Adicionado suporte para sincronizar tipos adicionais de dispositivos 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

2. **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 de Temperatura: mantém temporariamente uma temperatura definida.

3. **Melhorias nas cenas**

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

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

* As câmaras compatíveis com ONVIF passam agora a suportar "Motion Detected" e "Occupancy Detected" como gatilhos de cena.

5. **Complemento eWeLink Smart Home ampliado**

* Adicionado suporte para sincronizar dispositivos elegíveis com o CUBE via o complemento eWeLink Smart Home, incluindo:
  * SONOFF Mini-RBS
  * Dispositivos virtuais (abrangendo interruptores e botões)
  * Subdispositivos do ZBBridge-U: SONOFF S60ZB, SNZB-02LD/SNZB-02WD, Mini-ZBRBS, SWV

6. **Melhorias na lista de dispositivos**

* Agora pode ocultar os dispositivos offline da lista de dispositivos da página inicial para uma vista mais limpa e focada.

7. **Melhorias na visualização de dados**

* Os gráficos de temperatura e humidade passam agora a suportar dados ao nível do minuto para informações mais detalhadas.

### Correções de erros <a href="#fbhve" id="fbhve"></a>

1. Corrigido um problema em que as notificações de cenas 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.

4. Corrigidos problemas do SONOFF TRVZB:

* Corrigido um problema em que o Modo Boost e o Modo de Substituição de Temperatura não eram executados corretamente.
* Corrigido um problema em que as ações de cena permitiam incorretamente selecionar o Modo de Substituição de Temperatura.
* Corrigido um problema em que ajustar o Tempo Boost enquanto estava no Modo Boost causava uma temporização inconsistente ou incorreta.
* Corrigido um erro em que os dados ao nível do minuto dos gráficos de temperatura e humidade não podiam ser apresentados corretamente.
* Corrigido um problema em que a temperatura alvo apresentada no CAST excedia o intervalo permitido.
* Corrigido um problema em que a temperatura alvo do TRV para o Modo Boost/Substituição de Temperatura não podia ser sincronizada ou apresentada corretamente.

***

## v0.5 - 27 de ago. de 2025

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

### Novidades?

1. **Compatibilidade alargada com dongles Zigbee**

* Adicionado suporte para o SONOFF ZBDongle-P e o SMLIGHT SLZB-06 Zigbee Coordinator.
* Dongles compatíveis atualmente testados e verificados:
  * SONOFF ZBDongle-E / P
  * SMLIGHT SLZB-06 / 06M
  * SkyConnect Zigbee (EZSP)

2. **Suporte para câmaras ONVIF**

* Adicionada deteção automática de câmaras compatíveis com ONVIF.
* Suporte para controlo PTZ (panorâmica-inclinação-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

3. **Melhorias no CAST**

* Layouts do pad CAST expandidos para uma experiência de painel mais flexível.

### Correções de erros

1. Corrigido um problema em que o CUBE OS não arrancava no Raspberry Pi 5 e não conseguia realizar atualizações OTA.
2. Corrigida a apresentação incorreta de dados nos gráficos de tendência das válvulas termostáticas de radiador.
3. Corrigido um erro em que as cenas acionadas por limites de potência não eram executadas corretamente.
4. Corrigido um problema em que as atualizações do estado dos dispositivos no CAST exigiam uma atualização manual do navegador.

***

## v0.4 - 19 de jun. de 2025

### Novidades?

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

* Raspberry Pi 4B / 5
* Máquinas virtuais x86\_64 (ex.: VirtualBox, VMware)
* Dispositivos NAS (modelos compatíveis)

2. Suporte para dispositivos Zigbee via dongles USB (ex.: SONOFF ZBDongle-E)
3. Matter Hub e Matter Bridge
4. Acesso remoto/notificações push via PWA
5. Suporte para Docker e add-ons
6. Cenas, grupos, OTA, painéis CAST e muito mais\nPara 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. Descarregue a imagem que se adequa 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](https://discord.gg/67Ybdn23rS) para obter apoio e partilhar feedback

***

## v0.2 - 31 de dez. de 2024

### Novidades?

* O Acesso Remoto é disponibilizado para Funcionalidades Piloto. Quando ativado, permite acesso remoto à consola web do CubeOS e ao CAST através de ligações seguras.
* O CAST pode ser instalado como uma aplicação web com ligações remotas. A app permite notificações para execuções de cenas, eventos de Smart Security, alternâncias de interruptores e fichas, e gatilhos de sensores, incluindo:&#x20;
  * 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á disponível uma nova página de definições do broker MQTT, com suporte para adicionar contas e palavras-passe. Permite ligar ao broker usando essas credenciais para subscrever mensagens MQTT.
* As câmaras passam agora a suportar a visualização simultânea de vários streams.

**Nova plataforma:**

* Raspberry Pi 5 (não verificado).

**Otimizações:**

* O complemento Tasmota foi otimizado ao usar o broker Mosquitto integrado, eliminando a necessidade de instalar um broker extra.
* Melhorado o formato de apresentação dos códigos de configuração do Matter para maior legibilidade.

**Correções de erros:**

* Resolvido um problema em que a versão 0.1 não conseguia processar atualizações via OTA.

**Problemas conhecidos:**

Existem os seguintes problemas conhecidos na versão 0.2 e que permanecem por corrigir em atualizações futuras:

* Ao aceder à web pela primeira vez, as máquinas virtuais e o Raspberry Pi podem ocasionalmente mostrar um pedido de desconexão.
* A instalação em Raspberry Pi não suporta a adição de dispositivos Matter novos ou repostos de fábrica. Utilize plataformas Matter alternativas e partilhe-as com o CubeOS.
* O Matter Hub por vezes bloqueia e reinicia continuamente.
* As notificações remotas são instáveis; os utilizadores podem não receber as 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 em Raspberry Pi através de ligações remotas.
* Os Matter Bridges não mostrarão subdispositivos na página de controlo dos dispositivos. E, para os subdispositivos ligados a um Matter Bridge na página de definições, a informação da Bridge ligada está em falta.
* A Matter fabric com Vendor ID "1286" não pode ser removida no CubeOS. Se o sistema promover um dispositivo que esteja cheio de fabric, remova um nas outras plataformas Matter a que está ligado.
* O OTA não é suportado para instalações em Raspberry Pi 5.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cube.ewelink.cc/english-pt/recursos/registo-de-alteracoes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
