Visão geral

Este driver integra ao Nice/ELAN os relés, dimmers, módulos de cortina e medidores de energia Shelly das linhas Plus, Pro, Mini, Gen3 e Gen4. A comunicação é direta com cada aparelho na rede local, sem nuvem: o driver encontra os Shelly com um clique e recebe na hora tudo o que muda, inclusive o que é feito pelo app ou pelo interruptor da parede.

São quatro drivers, instalados juntos:

• ZoomDH Shelly Bridge (guia Communication Devices): licença, busca dos aparelhos na rede, conexão com cada um e comandos.
• ZoomDH Shelly Light (instalado pelo driver principal, guia Lighting): relés, dimmers, cortinas e as entradas dos Shelly como botões.
• ZoomDH Shelly Sensors (instalado pelo driver principal, guia Input/Output): estado das entradas, temperatura, umidade e entrada analógica.
• ZoomDH Shelly Energy (instalado pelo botão Refresh Status, guia Utilities): potência e energia de cada canal com medição, com medidor e gráfico de histórico.

Recursos suportados

• Busca dos Shelly na rede do controlador com um clique. Aparelhos em outra rede podem ser incluídos pelo IP.
• Relés como On/Off, um dispositivo por canal.
• Dimmers e controladores de LED (Dimmer, 0-10V, RGBW em modo branco, CCT) com liga/desliga e nível de 1 a 100%.
• Cortinas e persianas (Plus/Pro 2PM em modo cortina, Pro Dual Cover) com abrir, fechar, parar e posição em %, quando a cortina está calibrada no Shelly.
• Entradas dos Shelly como botões virtuais (apertar e soltar) para o Event Mapper, tanto em modo interruptor quanto em modo pulsador.
• Medição de energia na guia Utilities: potência (W) e energia acumulada (kWh) de cada canal com medição e dos medidores PM Mini, Pro EM e Pro 3EM, com medidor e gráfico de histórico.
• Sensores do Add-on: temperatura e umidade como entradas numéricas.
• Tempo real: o que muda no Shelly (app, interruptor, cena) chega ao ELAN na hora.
• Senha dos Shelly protegidos (autenticação digest).
• Status da conexão no ELAN e eventos Device Online / Device Offline.

Cor de lâmpadas RGB, aparelhos a bateria (H&T, Door/Window, BLU) e os Shelly da primeira geração (Gen1) não são suportados nesta versão. Qualquer recurso não indicado como suportado deve ser considerado sem suporte.

Modelos

Pré-requisitos

• Shelly Gen2, Gen3 ou Gen4 configurados e funcionando no Wi-Fi (ou cabo, nos Pro), com firmware atualizado.
• IP fixo ou reserva de DHCP para cada Shelly (recomendado). Se o IP mudar, clique em Discover Devices para o driver achar o aparelho de novo.
• Shelly na mesma rede do controlador ELAN. Para outra rede (VLAN), o controlador precisa alcançar o IP do Shelly pela porta 80.
• Se os Shelly tiverem senha (Settings > Authentication), use a mesma senha em todos.

Instalação

1. Verifique a versão mais recente do driver em www.zoomdigitalhome.com.br/drivers.
2. No Nice Configurator, abra a guia Communication Devices, adicione um dispositivo e clique em Import..., apontando para ZoomDH_Shelly.edrvc. Se o driver não aparecer na lista, clique em Show All.
3. Instale o ZoomDH Shelly Bridge. Ele instala sozinho os drivers Shelly Light (Lighting) e Shelly Sensors (Input/Output). Se eles não aparecerem, clique em Refresh Status.
4. Para ter a medição de energia, clique em Refresh Status: ele instala o Shelly Energy na guia Utilities.
5. Insira a chave de licença em License Key.
6. Se os Shelly tiverem senha, digite a senha no campo Password (o usuário é sempre admin no Shelly; o campo User Name não é usado).
7. Clique em Discover Devices para o driver procurar os Shelly na rede. Repita para incluir aparelhos novos depois. Para Shelly em outra rede, digite os IPs em Shelly IPs.
8. Na guia Lighting, os relés, dimmers, cortinas e botões aparecem no driver Shelly Light, com o nome dado no app Shelly. Renomeie e ligue-os aos controles e cenários do ELAN normalmente.
9. Na guia Input/Output, abra o Shelly Sensors: as páginas Sensors (Sensor 01 a 32), Valores 1 (Valor 01 a 32) e Valores 2 (Valor 33 a 64) mostram o que ficou em cada entrada.
10. Na guia Utilities, o Shelly Energy mostra a potência e a energia de cada canal com medição. As medições aparecem cerca de um minuto depois da busca.

Campos de configuração

ZoomDH Shelly Bridge

Endereço dos dispositivos (Light)

Cada dispositivo de iluminação usa dois campos de endereço, preenchidos pela busca: Shelly ID (ex.: shellyplus1pm-a8032ab12345) e Component (o canal: switch:0, light:0, cover:0, input:0...).

Entradas e medições

Botões (Shelly Light)

Cada entrada do Shelly vira um botão virtual no Shelly Light, para usar no Event Mapper:

• Entrada em modo interruptor: ligar o interruptor aperta o botão e desligar solta.
• Entrada em modo pulsador (button): apertar e soltar o pulsador apertam e soltam o botão.

Shelly Sensors

As entradas são distribuídas na busca e não mudam depois. As páginas Sensors, Valores 1 e Valores 2 mostram o nome do aparelho e a grandeza de cada entrada; use esses nomes para renomear as entradas no Configurator e no Event Mapper.

Shelly Energy

Cada canal com medição vira duas entradas na guia Utilities, com o nome do canal: Potência (W) e Energia (mostrada em kWh). Elas têm medidor e gráfico de histórico no Configurator e no app ELAN.

Funcionamento e limites

• O driver mantém uma conexão permanente com cada Shelly e confere o estado de todos a cada minuto. Se um aparelho cair, ele reconecta sozinho.
• Funciona sem internet: a comunicação é toda na rede local. A nuvem Shelly e o app continuam funcionando em paralelo.
• A busca percorre os 254 endereços da rede do controlador e leva cerca de 30 segundos.
• Posição de cortina só funciona com a cortina calibrada no app Shelly. Sem calibração, níveis acima de 50% abrem e os demais fecham.
• O driver Shelly Sensors tem 32 entradas de estado e 64 numéricas. Medições que passarem disso não aparecem.

Solução de problemas

• Dispositivo não aparece: confira no app Shelly se o aparelho está online e clique em Discover Devices.
• Comandos não funcionam: confira o License Status e o resumo em Devices.
• Diagnóstico: ative o Developer Debug para ver no log cada mensagem trocada com os Shelly.

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.
• A chave é inserida no campo License Key do ZoomDH Shelly Bridge e vale para os três drivers. As licenças são emitidas e vinculadas por controlador ELAN.
• Sem licença válida, o driver não envia comandos nem atualiza o estado dos dispositivos.
• 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 Shelly relays, dimmers, cover modules and energy meters from the Plus, Pro, Mini, Gen3 and Gen4 lines with Nice/ELAN. It talks directly to each device on the local network, with no cloud: the driver finds the Shellys with one click and receives every change right away, including changes made in the app or at the wall switch.

There are four drivers, installed together:

• ZoomDH Shelly Bridge (Communication Devices tab): license, network discovery, connection to each device and commands.
• ZoomDH Shelly Light (installed by the main driver, Lighting tab): relays, dimmers, covers and the Shelly inputs as buttons.
• ZoomDH Shelly Sensors (installed by the main driver, Input/Output tab): input states, temperature, humidity and analog input.
• ZoomDH Shelly Energy (installed by the Refresh Status button, Utilities tab): power and energy of each metered channel, with gauge and history chart.

Supported features

• One-click discovery of the Shellys on the controller network. Devices on another network can be added by IP.
• Relays as On/Off devices, one per channel.
• Dimmers and LED controllers (Dimmer, 0-10V, RGBW in white mode, CCT) with on/off and level from 1 to 100%.
• Curtains and blinds (Plus/Pro 2PM in cover mode, Pro Dual Cover) with open, close, stop and position in %, when the cover is calibrated in the Shelly.
• Inputs as virtual buttons (press and release) for the Event Mapper, in both switch and button mode.
• Energy metering in the Utilities tab: power (W) and accumulated energy (kWh) of each metered channel and of the PM Mini, Pro EM and Pro 3EM meters, with gauge and history chart.
• Add-on sensors: temperature and humidity as numeric inputs.
• Real time: changes on the Shelly (app, wall switch, scene) reach ELAN right away.
• Password protected Shellys (digest authentication).
• Connection status in ELAN and Device Online / Device Offline events.

RGB color, battery devices (H&T, Door/Window, BLU) and first generation Shellys (Gen1) are not supported in this version. Any feature not listed as supported should be considered unsupported.

Models

Prerequisites

• Shelly Gen2, Gen3 or Gen4 devices set up and working on Wi-Fi (or Ethernet, on Pro models), with up to date firmware.
• Static IP or DHCP reservation for each Shelly (recommended). If the IP changes, click Discover Devices so the driver finds the device again.
• Shellys on the same network as the ELAN controller. For another network (VLAN), the controller must reach the Shelly IP on port 80.
• If the Shellys are password protected (Settings > Authentication), use the same password on all of them.

Installation

1. Check for the latest driver version at www.zoomdigitalhome.com.br/drivers.
2. In the Nice Configurator, open the Communication Devices tab, add a device and click Import..., pointing to ZoomDH_Shelly.edrvc. If the driver is not listed, click Show All.
3. Install ZoomDH Shelly Bridge. It installs the Shelly Light (Lighting) and Shelly Sensors (Input/Output) drivers by itself. If they do not show up, click Refresh Status.
4. For energy metering, click Refresh Status: it installs Shelly Energy in the Utilities tab.
5. Enter the license key in License Key.
6. If the Shellys have a password, type it in the Password field (the Shelly user is always admin; the User Name field is not used).
7. Click Discover Devices so the driver searches the network for Shellys. Repeat it to add new devices later. For Shellys on another network, type their IPs in Shelly IPs.
8. In the Lighting tab, relays, dimmers, covers and buttons show up under Shelly Light, with the names given in the Shelly app. Rename them and link them to ELAN controls and scenes as usual.
9. In the Input/Output tab, open Shelly Sensors: the Sensors (Sensor 01 to 32), Valores 1 (Valor 01 to 32) and Valores 2 (Valor 33 to 64) pages show what was assigned to each input.
10. In the Utilities tab, Shelly Energy shows the power and energy of each metered channel. Readings show up about one minute after discovery.

Configuration fields

ZoomDH Shelly Bridge

Device address (Light)

Each lighting device uses two address fields, filled in by discovery: Shelly ID (e.g. shellyplus1pm-a8032ab12345) and Component (the channel: switch:0, light:0, cover:0, input:0...).

Inputs and metering

Buttons (Shelly Light)

Each Shelly input becomes a virtual button in Shelly Light, for use in the Event Mapper:

• Input in switch mode: turning the switch on presses the button and turning it off releases it.
• Input in button mode: pressing and releasing the push button press and release the virtual button.

Shelly Sensors

Inputs are assigned during discovery and do not change afterwards. The Sensors, Valores 1 and Valores 2 pages show the device name and the quantity of each input; use these names to rename the inputs in the Configurator and the Event Mapper.

Shelly Energy

Each metered channel becomes two inputs in the Utilities tab, named after the channel: Potencia (W) and Energia (shown in kWh). They have a gauge and a history chart in the Configurator and the ELAN app.

Operation and limits

• The driver keeps a permanent connection to each Shelly and checks the state of all of them every minute. If a device drops, it reconnects by itself.
• Works without internet: all communication is on the local network. The Shelly cloud and app keep working alongside.
• Discovery goes through the 254 addresses of the controller network and takes about 30 seconds.
• Cover position only works with the cover calibrated in the Shelly app. Without calibration, levels above 50% open and the others close.
• The Shelly Sensors driver has 32 state inputs and 64 numeric inputs. Readings beyond that are not shown.

Troubleshooting

• Device not listed: check in the Shelly app that the device is online and click Discover Devices.
• Commands do not work: check License Status and the Devices summary.
• Diagnostics: enable Developer Debug to log every message exchanged with the Shellys.

Licensing

• This driver runs for a 7-day trial period. After that, a license key is required to keep it running.
• The key goes in the License Key field of ZoomDH Shelly Bridge and covers all three drivers. Licenses are issued and bound per ELAN controller.
• Without a valid license, the driver does not send commands or update device states.
• Licenses can be requested 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