Visão geral

Este driver integra ao Nice/ELAN os termostatos Wi-Fi de piso aquecido (e de caldeira) cadastrados nos apps Smart Life ou Tuya Smart, de qualquer marca que use a plataforma Tuya. Cada termostato aparece como um termostato nativo do ELAN, com liga/desliga, temperatura desejada, temperatura ambiente e indicação de aquecimento.

A comunicação é feita pela nuvem da Tuya com a própria conta do app: o instalador digita o Código do Usuário e lê um QR Code com o celular. Não é preciso conta de desenvolvedor na Tuya nem configurar IP ou chave local de cada termostato.

É um driver só, ZoomDH Tuya Floor Heating Thermostat, instalado na guia Climate. Ele cria um termostato no ELAN para cada termostato da conta.

Recursos suportados

• Login por QR Code na conta Smart Life / Tuya Smart do cliente. O acesso fica gravado no controlador e é renovado sozinho.
• Busca automática dos termostatos da conta, com o termostato de cada um criado e nomeado no ELAN.
• Modos Off e Heat (desliga e liga o termostato).
• Temperatura desejada de 5 a 40 °C, dentro da faixa de cada aparelho.
• Temperatura ambiente e indicação de aquecendo (relé ligado), quando o aparelho informa.
• Tempo real: o que é feito no app ou no próprio termostato chega ao ELAN na hora, com uma leitura de segurança a cada 2 minutos.
• Comandos All On e All Off para cenas e Event Mapper.
• Termostato on-line/off-line no status de cada termostato do ELAN.

Programação horária do próprio termostato, bloqueio infantil, calibração e modo antecongelamento continuam sendo ajustados pelo app. Ar-condicionado não faz parte deste driver. Qualquer recurso não indicado como suportado deve ser considerado sem suporte.

Pré-requisitos

• Termostatos já cadastrados e funcionando no app Smart Life ou Tuya Smart.
• O celular com o app logado na conta do cliente, para ler o QR Code na instalação.
• Controlador ELAN com acesso à internet e com data e hora corretas (a integração depende da nuvem da Tuya).

Instalação

1. Verifique a versão mais recente do driver em www.zoomdigitalhome.com.br/drivers.
2. No Nice Configurator, abra a guia Climate, adicione um dispositivo e clique em Import..., apontando para ZoomDH_Tuya_Thermostat.edrvc. Se o driver não aparecer na lista, clique em Show All.
3. Insira a chave de licença em License Key.
4. Vincule a conta do cliente pelo QR Code (próxima seção).
5. Clique em Discover Thermostats. Cada termostato da conta é criado no ELAN com o nome que tem no app. Renomeie e coloque nos ambientes normalmente.
6. Para incluir termostatos novos depois, cadastre-os no app e clique em Discover Thermostats de novo. Os que já existem no ELAN são mantidos.

Vincular a conta (QR Code)

1. No app Smart Life ou Tuya Smart, logado na conta do cliente, toque em Eu e no ícone de Configurações.
2. Entre em Conta e Segurança e copie o Código do Usuário (User Code).
3. No driver, digite o código em Tuya User Code e clique no botão Generate QR Code.
4. O campo Tuya Status mostra Abra no navegador e leia com o app: seguido de um endereço. Copie o endereço e abra num navegador: a página mostra o QR Code. O link também fica no log, na linha [Tuya] QR Code:.
5. No app, use o leitor de QR (ícone no canto superior da tela Eu ou + > Escanear), leia o QR Code e confirme a autorização.
6. Em alguns segundos o Tuya Status passa para Auth: Autenticado.

Campos de configuração

Funcionamento e limites

• O driver usa o mesmo acesso por QR Code que a Tuya oferece para integrações de automação residencial com a conta do app. Não há cota de chamadas nem plano para renovar.
• As mudanças chegam por uma conexão permanente com a nuvem da Tuya. Se ela cair, o driver reconecta sozinho e a leitura a cada 2 minutos mantém o estado em dia enquanto isso.
• Sem internet ou com a nuvem da Tuya fora do ar, os termostatos não respondem pelo ELAN (continuam funcionando no próprio aparelho).
• Ao ajustar a temperatura várias vezes seguidas, o driver espera 1,5 s e manda só o último valor ao termostato.
• A Tuya pode alterar esse acesso sem aviso. Se o login ou a conexão deixarem de funcionar, verifique se há versão nova do driver.

Solução de problemas

• Termostato não aparece: confira se ele está on-line no app e clique em Discover Thermostats.
• Comandos não funcionam: confira o License Status e se o termostato está on-line no app.
• Diagnóstico: ative o Developer Debug para ver cada chamada à nuvem e cada mensagem no log.

Licenciamento

• Este driver funciona por um período de avaliação de 7 dias. Após esse período, é necessário inserir uma chave de licença para continuar operando.
• As licenças são emitidas e vinculadas por controlador ELAN e valem para todos os termostatos do driver.
• Sem licença válida, o driver não envia comandos nem atualiza o estado dos termostatos.
• A conta do app Smart Life / Tuya Smart é do cliente e não faz parte da licença do driver.
• Licenças podem ser obtidas pelo e-mail drivers@zoomdigitalhome.com.br.

Suporte e Atualizações

• Atualizações disponíveis são exibidas em License Status.
• Download de drivers: www.zoomdigitalhome.com.br/drivers
• Suporte: drivers@zoomdigitalhome.com.br

Release Notes

Overview

This driver integrates Wi-Fi underfloor heating thermostats (and boiler thermostats) set up in the Smart Life or Tuya Smart apps, of any brand built on the Tuya platform, with Nice/ELAN. Each thermostat shows up as a native ELAN thermostat, with on/off, target temperature, room temperature and heating indication.

Communication goes through the Tuya cloud with the customer's own app account: the installer types the User Code and scans a QR code with the phone. No Tuya developer account is needed, and no IP address or local key has to be set for each thermostat.

It is a single driver, ZoomDH Tuya Floor Heating Thermostat, installed in the Climate tab. It creates one ELAN thermostat for each thermostat in the account.

Supported features

• QR code login to the customer's Smart Life / Tuya Smart account. Access is stored on the controller and renewed automatically.
• Automatic discovery of the account thermostats, with each one created and named in ELAN.
• Off and Heat modes (turns the thermostat off and on).
• Target temperature from 5 to 40 °C, within each device's range.
• Room temperature and heating indication (relay on), when the device reports them.
• Real time: changes made in the app or on the thermostat itself reach ELAN right away, with a safety refresh every 2 minutes.
• All On and All Off commands for scenes and the Event Mapper.
• Thermostat online/offline in the status of each ELAN thermostat.

The thermostat's own schedule, child lock, calibration and frost protection are still set in the app. Air conditioners are not part of this driver. Any feature not listed as supported should be considered unsupported.

Prerequisites

• Thermostats already set up and working in the Smart Life or Tuya Smart app.
• A phone with the app logged in to the customer's account, to scan the QR code during installation.
• ELAN controller with internet access and the correct date and time (the integration depends on the Tuya cloud).

Installation

1. Check for the latest driver version at www.zoomdigitalhome.com.br/drivers.
2. In the Nice Configurator, open the Climate tab, add a device and click Import..., pointing to ZoomDH_Tuya_Thermostat.edrvc. If the driver is not listed, click Show All.
3. Enter the license key in License Key.
4. Link the customer's account with the QR code (next section).
5. Click Discover Thermostats. Each thermostat in the account is created in ELAN with its app name. Rename them and place them in rooms as usual.
6. To add new thermostats later, set them up in the app and click Discover Thermostats again. Thermostats already in ELAN are kept.

Link the account (QR code)

1. In the Smart Life or Tuya Smart app, logged in to the customer's account, tap Me and the Settings icon.
2. Open Account and Security and copy the User Code.
3. In the driver, type the code in Tuya User Code and click the Generate QR Code button.
4. The Tuya Status field shows Abra no navegador e leia com o app: followed by an address. Copy the address and open it in a browser: the page shows the QR code. The link is also in the log, on the [Tuya] QR Code: line.
5. In the app, use the QR scanner (icon at the top of the Me screen or + > Scan), scan the QR code and confirm the authorization.
6. After a few seconds Tuya Status changes to Auth: Autenticado.

Configuration fields

Operation and limits

• The driver uses the same QR code access that Tuya offers for home automation integrations with the app account. There is no call quota and no plan to renew.
• Changes arrive over a permanent connection to the Tuya cloud. If it drops, the driver reconnects by itself and the refresh every 2 minutes keeps the state up to date meanwhile.
• Without internet, or with the Tuya cloud down, the thermostats do not respond from ELAN (they keep working on the device itself).
• When the temperature is adjusted several times in a row, the driver waits 1.5 s and sends only the last value to the thermostat.
• Tuya may change this access without notice. If login or the connection stops working, check for a new driver version.

Troubleshooting

• Thermostat not listed: check that it is online in the app and click Discover Thermostats.
• Commands do not work: check License Status and that the thermostat is online in the app.
• Diagnostics: enable Developer Debug to see every cloud call and message in the log.

Licensing

• This driver runs for a 7-day trial period. After that, a license key is required for it to keep working.
• Licenses are issued for and bound to each ELAN controller and cover all thermostats of the driver.
• Without a valid license, the driver does not send commands or update the thermostats.
• The Smart Life / Tuya Smart app account belongs to the customer and is not part of the driver license.
• Licenses are available at drivers@zoomdigitalhome.com.br.

Support and Updates

• Available updates are shown in License Status.
• Driver downloads: www.zoomdigitalhome.com.br/drivers
• Support: drivers@zoomdigitalhome.com.br

Release Notes