MolSmart API Reference

Módulo de Entradas — API

Protocolo TCP em string e referência HTTP GET (CGI) para o Módulo de Entradas MolSmart — 12 entradas digitais + 4 entradas analógicas (0-10V / 4-20mA). Este módulo compartilha o firmware base com a família de Placas de Relé; os endpoints de entrada digital abaixo vêm desse documento de API compartilhado.
MS-I012
ProtocolosTCP · HTTP GET (CGI) · UDP · MQTT
Porta TCP padrão502 (alterável)
Entradas digitais / analógicas12 / 4
4.1 / Primeiros Passos

Visão Geral

O Módulo de Entradas (MS-I012) não tem saída de relé ou dimmer — ele expõe 12 entradas digitais e 4 entradas analógicas (cada uma configurável independentemente para 0‑10V ou 4‑20mA) para leitura de sensores e contatos secos. Ele roda a mesma plataforma de firmware base da família de Placas de Relé, então sua página Integrations/Ports oferece os mesmos transportes: TCP, UDP, HTTP e MQTT.

Note

O documento de API do fabricante disponível para esta referência ('Relay board API v1.9.8') cobre em detalhe a superfície TCP/HTTP de entrada digital compartilhada (é o mesmo documento usado na página de Placas de Relé), mas foi escrito do ponto de vista da placa de relé — não inclui uma seção dedicada aos 4 canais analógicos deste módulo. Os endpoints abaixo que vêm diretamente desse documento compartilhado estão marcados como tal; a lacuna dos canais analógicos está detalhada em 4.4.

4.2 / Protocolo TCP em String

String de Status

Abra uma conexão TCP simples (porta padrão 502) e envie o comando de consulta 00 como texto puro, igual à família de Placas de Relé:

Layout compartilhado da string de status (firmware das placas de relé)
[relay1]...[relayN] : [input1]...[input12] : channel_count : … : [relay1]...[relayN] : [input1]...[input12]
To be confirmed

Em um módulo sem nenhuma saída de relé, o comportamento do bloco inicial '[relay1]…[relayN]' do protocolo de string compartilhado (omitido vs. reportado como todos zeros) não é detalhado especificamente para o Módulo de Entradas no documento-fonte — só foi testado com placas que têm relés. O segmento [input1]…[input12] é esperado reportar as 12 entradas digitais do mesmo jeito que faz nas Placas de Relé.

Important

Essa string de status TCP compartilhada reporta apenas as 12 entradas digitais. Ela não carrega as leituras dos 4 canais analógicos — ver 4.4.

4.3 / API HTTP (CGI)

Ler Status das Entradas Digitais

Mesmo endpoint e formato de resposta do CGI de status de entradas da família de Placas de Relé (ver API de Placas de Relé para a tabela completa de campos):

GET/input.cgi
Requisição
http://192.168.1.100/input.cgi
Formato de resposta ilustrativo — ok, 12 entradas digitais, alternando high/low (não é um exemplo capturado de uma unidade real MS-I012)
&0&0&12&1&0&1&0&1&0&1&0&1&0&1&0&
To be confirmed

O par de requisição/resposta acima para um módulo de 12 entradas é ilustrativo, construído a partir do layout de campos documentado (seção Placas de Relé — Ler Status das Entradas) e não capturado de uma MS‑I012 real. Confirme a resposta exata, byte a byte, em uma unidade real antes de depender dela.

4.4 / API HTTP (CGI)

Leitura das Entradas Analógicas (pendência)

To be confirmed

Nenhum endpoint para ler os valores brutos em V/mA dos 4 canais analógicos está documentado no material do fabricante revisado para esta referência. A interface web do módulo tem uma página AI dedicada (Index / Type / Raw Value por canal — ver o Manual do Usuário deste produto) confirmando que o dado existe e é legível localmente, mas nenhum CGI HTTP, campo de string TCP ou tópico MQTT para isso foi incluído nos documentos-fonte usados aqui. Candidatos prováveis para testar em uma unidade real: um CGI específico para analógico (ex.: ai.cgi, nome não confirmado) ou um campo extra anexado à string de status compartilhada, além do bloco de entradas digitais.

4.5 / MQTT

Tópicos & Payloads (pendência)

To be confirmed

Nenhuma lista de tópicos específica do Módulo de Entradas foi incluída no material-fonte. A página Integrations/Ports expõe o bloco MQTT padrão (broker, QoS, Retain, HA Discover) mais um heartbeat Keep Alive Second que envia o status completo das entradas (digitais + analógicas, conforme o Manual do Usuário do produto) em um intervalo configurável — mas os nomes de tópico e o formato do payload desse heartbeat não foram documentados no material de API revisado. Por analogia com o padrão /molsmart/<device><serial>/in/… da família Dimmer, algo parecido é plausível mas não confirmado.

4.6 / Referência

Notas & Pendências

PendênciaDetalhe
API dos canais analógicos (4× 0-10V/4-20mA)Não documentada na fonte revisada — ver 4.4.
Tópicos MQTTNão documentados especificamente para este módulo — ver 4.5.
Formato de frame UDP1/UDP2Mesma pendência da família de Placas de Relé — protocolo binário, layout de bytes não coberto pelo documento-fonte.
Comportamento do bloco de relé em módulo sem relésNão detalhado para este módulo — ver 4.2.

Para a referência completa dos campos da interface web deste módulo (Integrations/Ports, AI, Test Input, Input Link URL etc.), consulte o Manual do Usuário deste produto.