Dimmer 0-10V — API
Visão Geral
A Placa Dimmer 0‑10V 8 Canais (MS-A008) tem 8 saídas analógicas (0‑10V) e 8 entradas digitais. Ela compartilha a interface web e o firmware de Integrations/Ports com a placa Dimmer TRIAC (MS-D006) — mesma família de protocolo TCP, mesma porta 502 padrão — mas o documento de API do fabricante disponível para este modelo específico é bem mais curto que o da placa TRIAC, e só confirma a string de feedback (leitura) via TCP.
Tudo nesta página marcado como “A confirmar” é uma inferência por analogia com a API documentada do Dimmer TRIAC (§2), não um fato verificado de forma independente para a MS‑A008. Confirme em uma unidade real — ou peça à MolSmart o documento de API equivalente para 0‑10V — antes de usar em produção.
String de Feedback (confirmado)
Abra uma conexão TCP simples (porta padrão 502). O módulo reporta seus 8 níveis de saída e 8 estados de entrada como uma string separada por dois‑pontos, no mesmo formato das outras placas MolSmart:
000000000000000000000000:11111111:8:00000000:00000000
035000000000000000000000:11111111:8:10000000:00000000
| Bloco | Significado |
|---|---|
| Primeiro bloco | Status de cada um dos 8 canais de saída (AO) — 3 dígitos por canal, 000–100 (%). |
| Segundo bloco | As 8 entradas pulsadores/digitais do módulo, um dígito cada. |
O documento-fonte só descreve essas duas strings de exemplo e o layout de canal/dígito — não detalha individualmente os campos finais :8:…:…. Por analogia direta com o formato confirmado do Dimmer TRIAC (2.2 — d_mask/i_mask após a contagem de canais), o mesmo layout é esperado aqui, escalado para 8 canais.
Comandos de Controle (não confirmado)
Não coberto pelo documento do fabricante revisado para este modelo. Como esta placa compartilha o mesmo protocolo TCP MolSmart String(NO)/(NC) e a mesma porta 502 padrão do Dimmer TRIAC (conforme Integrations/Ports na interface web de ambos os produtos), a mesma sintaxe de comando é esperada aqui, 1:1, só endereçando 8 canais em vez de 6:
Ver Dimmer TRIAC — Controle & Feedback TCP para a versão confirmada dessa sintaxe no produto irmão. Verifique cada uma dessas formas em uma unidade real MS‑A008 antes de colocar uma integração baseada nelas em produção.
Endpoints Esperados
Não coberto pelo documento do fabricante revisado para este modelo. Por analogia com o Dimmer TRIAC (2.3–2.4), o seguinte é plausível mas não confirmado para a MS‑A008:
| Canal | Formato esperado (por analogia — não confirmado) |
|---|---|
| Tópicos de estado MQTT | /molsmart/<device><serial>/in/ao1 … /in/ao8, valores ON/OFF/%0-%100 |
| Tópico de controle MQTT | /molsmart/<device><serial>/in/control, mesmo formato JSON do tópico de controle do Dimmer TRIAC |
| Comando via HTTP | POST /api/v2/dimmer_set.cgi, mesmo formato de corpo JSON (idx até 8) |
| Status via HTTP | GET /api/v2/dimmer.cgi |
Notas & Pendências
| Pendência | Detalhe |
|---|---|
| Sintaxe de comandos de controle | Não documentada para este modelo; inferida do Dimmer TRIAC (3.3). Confirmar em unidade real. |
| API HTTP JSON | Não documentada para este modelo; inferida do Dimmer TRIAC (3.4). |
| Tópicos MQTT | Não documentados para este modelo; inferidos do Dimmer TRIAC (3.4). |
| Campos d_mask / i_mask | Presentes na string de feedback por analogia com o formato confirmado da placa TRIAC, não explicados individualmente na fonte deste modelo. |
O Manual do Usuário deste produto documenta por completo a página compartilhada de Integrations/Ports (portas, broker MQTT, seletor de protocolo TCP) — consulte-o para tudo que não está coberto aqui.