> 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-br/recursos/registro-de-alteracoes.md).

# Registro de alterações

## v2.12.0 - 07 de jul. de 2026

### O que há de novo? <a href="#d9hzl" id="d9hzl"></a>

1. **Novo suporte a dispositivos**

* Adicionado suporte para os interruptores inteligentes Zigbee de canal único SONOFF MINI-ZB1GP / MINI-ZB1GSP com monitoramento de energia elétrica.

2. **Suporte expandido a dispositivos Matter Hub**

* O Matter Hub agora oferece suporte aos seguintes tipos de dispositivos Matter:
  * Sensor de temperatura
  * Sensor de contato
  * Sensor de ocupação
  * Sensor de luz
  * Sensor de qualidade do ar
  * Alarme de fumaça e CO
  * Interruptor genérico
  * Unidade plug-in dimerizável

3. **Suporte aprimorado à sincronização de dispositivos vinculados ao eWeLink**

* Subdispositivos Zigbee elegíveis conectados por meio do SONOFF NSPanel Pro 86-Relay e Bridge-M agora podem ser sincronizados com o eWeLink CUBE por meio do complemento eWeLink Smart Home ou do recurso integrado "Adicionar dispositivos vinculados ao eWeLink".

4. **Melhorias no SONOFF TRVZB**

* Otimizamos o gráfico de temperatura no CUBE CAST com um eixo ajustado dinamicamente com base nos dados de temperatura.

### Correções de bugs <a href="#i1pmv" id="i1pmv"></a>

1. Corrigido um problema em que uma caixa pop-up em branco era exibida ao configurar o relatório de temperatura e umidade para sensores de qualidade do ar da IKEA.
2. Corrigido um problema em que o SONOFF SNZB-02M podia exibir incorretamente o conforto da pressão do ar como fora do intervalo quando nenhum intervalo de conforto da pressão do ar estava configurado.
3. Corrigido um problema em que o complemento Node-RED podia falhar ao instalar ou atualizar em alguns dispositivos.

***

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

Esta versão amplia a compatibilidade para vários dispositivos SONOFF e o suporte aos recursos de câmera do Matter Bridge, com melhor detecção da temperatura ambiente para o SONOFF TRVZB. Reserve um momento para ler as notas antes de atualizar para esta versão.

### O que há de novo? <a href="#u95d3" id="u95d3"></a>

1. **Novo suporte a 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 relatório de iluminância.
  * Válvula de água inteligente de canal duplo SONOFF SWV-ZF2U / SWV-ZF2E.
  * Plugue inteligente SONOFF BASIC-ZB1GSP com monitoramento de energia.

2. **Suporte a câmeras no Matter Bridge**

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

3. **Melhorias no SONOFF TRVZB**

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

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

1. Corrigido um problema em que o gráfico de consumo de energia falhava ao carregar para plugs Zigbee sincronizados com o CUBE via complemento eWeLink Smart Home.
2. Corrigido um problema em que dongles Zigbee SONOFF não podiam ser detectados ou configurados corretamente pelo CUBE quando conectados 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 implantação mais flexíveis. Reserve um momento para ler as notas antes de atualizar para esta versão.

### O que há de novo? <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 maneira mais simples de sincronizar dispositivos vinculados ao eWeLink. Entre com sua conta eWeLink em **Início > Adicionar dispositivo** para sincronizar e gerenciar dispositivos elegíveis diretamente no CUBE, sem instalar o complemento eWeLink Smart Home.\
  \&#xNAN;*Observação: os dispositivos já existentes do complemento continuarão funcionando de forma independente.*

2. **Suporte à implantação com Docker**

* O CUBE OS agora pode ser executado em ambientes Docker, oferecendo aos usuários opções de implantação mais flexíveis.\
  Para implantações baseadas em Docker, os seguintes recursos em nível de sistema não estão disponíveis:
  * Docker (Complementos)
  * Recursos piloto > Alto-falante Bluetooth
  * Configurações > Informações do gateway > Atualização de versão
  * Configurações > Reiniciar e desligar
* Para atualizar uma implantação baseada em Docker, faça pull da imagem Docker mais recente.

3. **Suporte expandido à 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 o gerenciamento de firmware do dongle SONOFF, opções de implantação expandidas e novo suporte a dispositivos, enquanto 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.

### **O que há de novo？** <a href="#ta75j" id="ta75j"></a>

1. **Gerenciamento de firmware do dongle SONOFF**

* Adicionada detecção automática para dongles Zigbee conectados. Dongles SONOFF sem suporte agora podem 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.
* Após atualizar o CUBE para a v2.10.2, os dongles SONOFF conectados serão atualizados automaticamente para as versões estáveis de firmware recomendadas. Dongles que não sejam SONOFF devem ser atualizados usando suas ferramentas oficiais de gravação para garantir conexão e controle adequados dos dispositivos.
* Comportamento otimizado de detecção offline do Zigbee:
  * Dispositivos roteadores relatam em até 1 minuto
  * Dispositivos finais relatam em até 1 hora
  * Dispositivos que excederem o intervalo de relatório aparecerão offline até serem acionados novamente.

2. **Suporte expandido à implantação**

* 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 padrão dos dispositivos foi otimizado ao sincronizar dispositivos com SmartThings e Alexa via Matter Bridge.

4. **Melhorias no SONOFF TRVZB**

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

5. **Novo suporte a 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 Contato Seco Inteligente SONOFF MINI-ZBD.

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

* Otimizada a configuração do comportamento na inicialização para dispositivos Zigbee de terceiros.

7. **Recurso de desligamento**

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

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

1. Corrigido um problema em que placas Raspberry Pi 5 Rev1.1 podiam não iniciar corretamente.
2. Corrigido um problema em que dispositivos podiam não sincronizar com a Alexa via Matter Bridge.
3. Corrigidos problemas de timeout ao adicionar câmeras ONVIF / RTSP.
4. Corrigido o problema em que o status 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 dos plugs Zigbee não era exibido.

***

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

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

### **O que há de novo?** <a href="#id-91770f03" id="id-91770f03"></a>

1. **Suporte expandido a dispositivos do complemento eWeLink Smart Home**

* Adicionado suporte para sincronizar monitores de qualidade do ar elegíveis com o CUBE via 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 do sensor**

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

3. **Melhorias no SONOFF TRVZB**

* O Modo Boost e o Modo de Sobrescrita de Temp. agora podem ser ativados ou desativados diretamente em **CUBE CAST.**
* **SONOFF SNZB-02LD** agora pode ser usado como sensor externo para medições mais precisas de temperatura e umidade ambiente.

4. **Melhorias na confiabilidade do Zigbee**

* Otimizada a lógica de detecção offline do Zigbee para identificar desconexões de dispositivos mais rapidamente e melhorar a confiabilidade geral do controle. (Observação: devido às limitações do intervalo de relatórios, os sensores legados **SNZB-01 / SNZB-02 / SNZB-03 / SNZB-04** estão excluídos desta otimização)

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

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

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

1. Corrigido um bug em que a capacidade de entrada de **Frient IOMZB-110** do módulo estava ausente no eWeLink CUBE.
2. Resolvido um problema de controle com **Tuya/Moes AM43-0.45/40-ES-EZ** motor de cortina.
3. Corrigido um problema em que **Paulmann Gen2 RGB Remote** não podia ser usado como acionador de cena.
4. Corrigido um problema em que o **controle remoto SONOFF R5** não acionava automações como esperado após a restauração de um backup.
5. Corrigido um problema em que as cenas precisavam ser reativadas após uma reinicialização do eWeLink CUBE para executarem novamente.
6. Corrigido um problema intermitente em que o **Matter Bridge** podia ficar sem resposta em plataformas de terceiros ao sincronizar um grande número de dispositivos.
7. Otimizada a lógica para sincronizar sensores de vazamento de água por meio do **Matter Bridge**.

***

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

Estamos animados em anunciar que **o CUBE OS agora passou da fase 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 os lançamentos do iHost** para atualizações e melhorias de recursos consistentes.

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

### O que há de novo? <a href="#ufpq2" id="ufpq2"></a>

1. **Suporte expandido a dispositivos Matter Bridge**

* Adicionado suporte para sincronizar tipos adicionais de dispositivos definidos pelo Matter via Matter Bridge, incluindo:
  * Sensor de luz
  * Alarme de fumaça e CO (abrangendo sensores de fumaça e monóxido de carbono)
  * Sensor de qualidade do ar
  * Ar-condicionado de ambiente
  * Ventilador

2. **Novos recursos para o SONOFF TRVZB**

* Adicionados dois novos modos temporários para o SONOFF TRVZB:
  * Modo Boost: aquece o ambiente rapidamente por um curto período.
  * Modo de Sobrescrita de Temp.: mantém temporariamente uma temperatura definida.

3. **Melhorias nas cenas**

* Crie facilmente rótulos personalizados e atribua cenas a rótulos existentes.

4. **Novos recursos para câmeras compatíveis com ONVIF**

* Câmeras compatíveis com ONVIF agora oferecem suporte ao uso de "Movimento detectado" e "Ocupação detectada" como acionadores de cena.

5. **Complemento eWeLink Smart Home expandido**

* Adicionado suporte para sincronizar dispositivos elegíveis com o CUBE via 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 você pode ocultar dispositivos offline da lista de dispositivos da página inicial para uma visualização mais limpa e focada.

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

* Os gráficos de temperatura e umidade agora oferecem suporte a dados em nível de minuto para insights mais detalhados.

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

1. Corrigido um problema em que 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 repetidamente offline.
* Corrigido um problema em que adicionar mais de 10 dispositivos impedia que os novos dispositivos adicionados fossem sincronizados pelo Matter Bridge.
* Corrigido um problema em que o Matter Fabric era exibido como vazio.
* Corrigido um problema em que excluir 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 Sobrescrita de Temp. não eram executados corretamente.
* Corrigido um problema em que ações de cena permitiam incorretamente selecionar o Modo de Sobrescrita de Temp.
* 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 em nível de minuto dos gráficos de temperatura e umidade não podiam ser exibidos 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 os modos Boost/Sobrescrita de Temp. não podia ser sincronizada ou exibida corretamente.

***

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

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

### O que há de novo?

1. **Compatibilidade expandida com dongles Zigbee**

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

2. **Suporte a câmeras ONVIF**

* Adicionada descoberta automática de câmeras compatíveis com ONVIF.
* Suporte a controle 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

3. **Melhorias no CAST**

* Layouts de painéis CAST expandidos para uma experiência de dashboard mais flexível.

### Correções de bugs

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

***

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

### O que há de novo?

1. Suporte para instalação independente em:

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

2. Suporte a dispositivos Zigbee por meio de dongles USB (por exemplo, SONOFF ZBDongle-E)
3. Matter Hub e Matter Bridge
4. Acesso remoto/notificações push via PWA
5. Suporte a Docker e complementos
6. 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 testar

1. Baixe a imagem que se encaixa no 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. Entre em nosso [servidor do Discord](https://discord.gg/67Ybdn23rS) para obter suporte e compartilhar feedback

***

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

### O que há de novo?

* O Acesso Remoto é lançado para os Recursos Piloto. Quando ativado, ele permite acesso remoto ao console web do CubeOS e ao CAST por meio de links seguros.
* O CAST pode ser instalado como um aplicativo web com links remotos. O app habilita notificações para execuções de cenas, eventos de Segurança Inteligente, alternância de interruptores e plugs, e gatilhos de sensores, incluindo:&#x20;
  * Detecção de movimento
  * Detecção de presença
  * Detecção de janela aberta
  * Detecção de gás
  * Detecção de vazamento de água
  * Detecção de fumaça
  * Ações de pressão
* Os usuários agora podem alterar a senha do console web.
* Uma nova página de configurações do Broker MQTT está disponível, com suporte para adicionar contas e senhas. Ela permite a conexão ao broker usando essas credenciais para assinar mensagens MQTT.
* As câmeras agora oferecem visualização simultânea de vários fluxos.

**Nova plataforma:**

* Raspberry Pi 5 (não verificado).

**Otimizações:**

* O complemento Tasmota foi otimizado usando o broker Mosquitto integrado, eliminando a necessidade de instalar um broker adicional.
* Melhorado o formato de exibição dos códigos de configuração Matter para maior legibilidade.

**Correções de bugs:**

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

**Problemas conhecidos:**

Os seguintes problemas conhecidos existem na versão 0.2 e ainda serão corrigidos em atualizações futuras:

* Ao acessar a web pela primeira vez, máquinas virtuais e Raspberry Pi podem ocasionalmente exibir um aviso de desconexão.
* A instalação no Raspberry Pi não oferece suporte para adicionar dispositivos Matter novos ou redefinidos para as configurações de fábrica. Use plataformas Matter alternativas e compartilhe-as com o CubeOS.
* O Matter Hub às vezes trava e reinicia continuamente.
* As notificações remotas são instáveis; os usuários podem não receber pushs do sistema, possivelmente relacionado ao ambiente de rede, problemas de navegador ou encerramentos de processos de backend.
* A transmissão de câmera pode falhar na instalação do Raspberry Pi por meio de links remotos.
* Os Matter Bridges não mostrarão subdispositivos na página de controle dos dispositivos. E, para os subdispositivos conectados a um Matter Bridge na página de configurações, as informações da Ponte Conectada estão ausentes.
* A malha Matter com Vendor ID "1286" não pode ser removida no CubeOS. Se o sistema promover um dispositivo cuja malha esteja cheia, remova uma das outras plataformas Matter às quais ele está conectado.
* OTA não é suportado para a instalação no 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, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/english-pt-br/recursos/registro-de-alteracoes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
