Dimmer TRIAC — API
Visão Geral
A Placa Dimmer TRIAC 6 Canais (MS-D006) expõe 6 canais de saída de dimerização e 6 entradas digitais via TCP, MQTT e HTTP (JSON POST) — a mesma página de configuração Integrations/Ports usada em toda a linha MolSmart controla portas, broker MQTT e credenciais deste módulo.
| Transporte | Notas |
|---|---|
| TCP | Porta padrão 502 (alterável). Protocolo MolSmart String(NO) / MolSmart String(NC). |
| HTTP | JSON via HTTP POST para comandar, GET simples para status. |
| MQTT | Tópicos de estado por canal mais um único tópico de controle em JSON — ver 2.4. |
Controle & Feedback
Abra uma conexão TCP simples (porta padrão 502) e envie comandos como texto puro — sem terminador de linha necessário. Cada comando aponta para um canal de dimmer de 1 a 6.
ONLigar / Desligar com brilho salvo
Quando um canal é ligado desse jeito, ele retoma o último brilho salvo — por isso, um comando simples de 'Desligar' é o que efetivamente apaga o canal (não existe um estado intermediário de 'retomar e segurar'), exatamente como observado no documento do fabricante.
PCTLigar com brilho explícito
Um comando OFF (2<canal>) também aceita um sufixo %nível nos exemplos do fabricante (ex.: 21%20), mas o nível é ignorado — o canal simplesmente desliga, igual à forma simples 2<canal>.
DLYLigação temporizada (delay)
FBKString de feedback
020000000000000000:111111:6:000000:000000
D1 D2 D3 D4 D5 D6 : i1-6 : channel_count : d_mask : i_mask
Cada canal de dimmer é codificado em 3 dígitos (000–100 = brilho %); o bloco de entradas usa um dígito por entrada.
HLDEvento de Hold
Um pressionamento longo (Hold) numa entrada é representado com um H no lugar do dígito daquela entrada:
055000000000000000:H11111:6:000000
Tópicos & Payloads
| Tópico | Finalidade |
|---|---|
| /molsmart/dimmer<serial>/in/d1 … /in/d6 | Um tópico de estado por canal |
topic: /molsmart/dimmer1958000/in/d6 values: ON | OFF | %0-%100
Um único tópico de controle em JSON aceita comandos de on/off e delay para qualquer canal:
topic: /molsmart/dimmer1958000/in/control
{"type":"ON/OFF","idx":"6","status":"ON","time":"0","pass":"0"}
{"type":"ON/OFF","idx":"6","status":"OFF","time":"0","pass":"0"}
{"type":"ON/OFF","idx":"6","status":"%20","time":"0","pass":"0"}
{"type":"DELAY","idx":"6","status":"ON","time":"5","pass":"0"}| Campo JSON | Valores |
|---|---|
| type | ON/OFF ou DELAY |
| idx | número do canal, 1–6 |
| status | ON / OFF / %0–%100 |
| time | segundos, usado com DELAY; 0 nos demais casos |
| pass | senha configurada no dispositivo, ou 0 se desativada |
Comandar & Ler Dimmer
/api/v2/dimmer_set.cgi{"idx":1,"duty":50,"init":0,"mode":0,"range_min":6,"range_max":70}| Campo JSON | Significado |
|---|---|
| idx | número do canal, 1–6 |
| duty | brilho alvo, 0–100 |
| init | 0 = último status · 1 = Desligar · 2 = 25% ligado · 3 = 50% ligado · 4 = 75% ligado · 5 = 100% ligado |
| mode | 0 = modo range · 1 = modo ON/OFF |
| range_min / range_max | início/fim do Smooth Range do canal, conforme configurado na página Dimmer do módulo |
/api/v2/dimmer.cgiO documento do fabricante nomeia este endpoint ('Get Status of Dimmer') mas não traz um exemplo prático de resposta — o formato da resposta não foi confirmado de forma independente para esta referência.
Notas & Pendências
| Pendência | Detalhe |
|---|---|
| Schema de resposta de GET /api/v2/dimmer.cgi | Nome do endpoint confirmado, formato do JSON de resposta não documentado na fonte revisada — capture uma resposta real antes de confiar nos campos exatos. |
| Autenticação em /api/v2/* | Nenhum parâmetro de senha/sessão aparece nos endpoints JSON, diferente do parâmetro pwd do CGI da Placa de Relé — se/como o HTTP Auth / Session ID (página Config) restringe essas rotas não foi confirmado. |
| Padrões de range_min / range_max | 6–70 no exemplo do fabricante corresponde ao Smooth Range padrão desta placa (ver Manual do Usuário do produto, página Dimmer) — trate os valores do exemplo como ilustrativos, não fixos. |