Gateway GW8 (RF/IR) — API
Visão Geral
O GW8 é controlado inteiramente via HTTP — todo comando (RF de cortina/motor, IR em qualquer um dos seus quatro formatos, controle de AC) é enviado como uma única requisição montada a partir do endereço IP do Gateway mais um conjunto de variáveis na query string.
| Requisito | Detalhe |
|---|---|
| Gateway já na rede | Configure o GW8 na rede local (WiFi ou Ethernet) primeiro, usando a interface de setup própria dele. |
| IP fixo / reservado | Atribua ao GW8 um IP fixo na rede local (estático ou reserva DHCP) antes de montar uma integração, para que as URLs de comando continuem válidas. |
A documentação-fonte desta API descreve o transporte como 'HTTP, usando POST', mas todo exemplo prático fornecido é uma requisição GET simples com todos os parâmetros na query string (como reproduzido ao longo desta página). Confirme qual verbo o seu firmware específico espera — GET é o que os exemplos de fato mostram.
Descoberta & Info do Dispositivo
FINDEncontrar um GW8 na rede
- De um computador na mesma rede local do Gateway, acesse
http://molsmart.local— ele procura por qualquer unidade GW8 presente na LAN. - Acesse diretamente
http://<ip-do-gw8>para a interface de setup, usada para criar e gerenciar controles (RF/IR).
/info?type=1Retorna a versão do firmware e a configuração básica do Gateway.
http://192.168.1.77/info?type=1
Controle de Cortina / Motor
Usado para qualquer controle de cortina, persiana ou motor de porta, independente da marca — o formato da requisição é sempre o mesmo, com rcId fixo em 51.
/control| Parâmetro | Significado |
|---|---|
| cId | o ID do controle na interface web do GW8 — ver abaixo como encontrar |
| rcId | 51 — sempre 51 para controles de cortina/porta, independente da marca |
| state | número do botão no controle, 1–4 |
| user | usuário da interface web do GW8, padrão admin |
| pwd | senha da interface web do GW8, padrão 12345678 |
http://192.168.1.77/control?cId=1&rcId=51&state=1&user=admin&pwd=12345678
CIDComo encontrar o cId de um controle
Cada controle configurado na interface web do GW8 mostra seu próprio CID, que pode ser editado para qualquer valor desejado — só não pode repetir entre controles.
Tipos de Comando IR
O Gateway suporta quatro formas diferentes de enviar um comando IR, selecionadas pelo parâmetro rcId (exceto Sendir, que não tem cId/ rcId nenhum):
| Tipo | rcId | Notas |
|---|---|---|
| Sendir (GlobalCache) | n/a | timings IR brutos no formato Sendir do GlobalCache — 5.5 |
| Pronto HEX | n/a | um código Pronto HEX pronto — 5.6 |
| Learning (Universal) | 61 | um código aprendido e armazenado no próprio GW8 — 5.7 |
| AC | 52 | controle estruturado de ar-condicionado (temperatura, modo, ventilação, potência) — 5.8 |
| TV | 53 | reservado para controles de TV; sem exemplos práticos no documento-fonte |
Sendir (GlobalCache)
/control| Parâmetro | Significado |
|---|---|
| user | usuário da interface web do GW8 |
| pwd | senha da interface web do GW8 |
| c | canal/porta IR onde transmitir |
| gc | o código Sendir, começando no campo de frequência — não incluir o prefixo sendir,1:1,1 |
http://192.168.1.161/control?user=admin&pwd=12345678&gc=38000,1,1,347,173,22,22,22,65,22,65,22,65,22,22,22,65,22,65,22,65,22,65,22,65,22,65,22,22,22,22,22,22,22,22,22,65,22,65,22,65,22,22,22,22,22,22,22,22,22,22,22,22,22,22,22,22,22,65,22,22,22,65,22,22,22,65,22,22,22,1570,347,87,22,3692&c=1
Pronto HEX
/control| Parâmetro | Significado |
|---|---|
| user | usuário da interface web do GW8 |
| pwd | senha da interface web do GW8 |
| pronto | o código Pronto HEX pronto |
| c | canal/porta IR onde transmitir |
| r | número de repetições |
http://192.168.1.161/control?user=admin&pwd=26744769&pronto=0000 006d 0022 0002 0157 00ac 0015 0015 0015 0015 0015 0040 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0015 0040 0015 0040 0015 0015 0015 0040 0015 0040 0015 0040 0015 0040 0015 0040 0015 0015 0015 0015 0015 0040 0015 0015 0015 0015 0015 0015 0015 0040 0015 0040 0015 0040 0015 0040 0015 0015 0015 0040 0015 0040 0015 0040 0015 0015 0015 0015 0015 0689 0157 0056 0015 0e94&c=1&r=2
Learning (Universal)
Envia um código previamente ensinado ao GW8 e armazenado contra um par cId/state (botão) de um controle, independente da marca ou protocolo do controle original.
/control| Parâmetro | Significado |
|---|---|
| user | usuário da interface web do GW8 |
| pwd | senha da interface web do GW8 |
| cId | o ID do controle na interface web do GW8 |
| rcId | 61 — fixo para Learning/Universal |
| state | número do botão no controle, conforme configurado na interface web |
http://192.168.1.120/control?cId=1234&rcId=61&state=1&user=admin&pwd=12345678
Ensinar um novo código ao GW8 (o processo de aprendizado em si) é feito pela própria interface web do Gateway — o documento-fonte não descreve um endpoint HTTP separado para disparar ou concluir uma sessão de aprendizado via API.
Controle de AC
/control| Parâmetro | Significado |
|---|---|
| user | usuário da interface web do GW8 |
| pwd | senha da interface web do GW8 |
| cId | o ID do controle na interface web do GW8 |
| rcId | 52 — fixo para controle de AC |
| state | slot de comando/estado sendo enviado, ex.: 1, 2 nos exemplos práticos |
| t | temperatura alvo, ex.: 16, 17… |
| pw | potência — 1 = ON, 0 = OFF |
| md | modo de operação — ver tabela de enum abaixo |
| v | ventilação — 0 = fechado/desligado, 1 = ligado |
| s | velocidade do ventilador — ver tabela de enum abaixo |
| md — modo | Valor |
|---|---|
| OpMode_kOff | -1 |
| OpMode_kAuto | 0 — Automático |
| OpMode_kCool | 1 — Resfriamento |
| OpMode_kHeat | 2 — Aquecimento |
| OpMode_kDry | 3 — Desumidificação |
| OpMode_kFan | 4 — Somente ventilador |
| s — velocidade do ventilador | Valor |
|---|---|
| Fan_Speed_kAuto | 0 |
| Fan_Speed_kMin | 1 |
| Fan_Speed_kLow | 2 — baixo |
| Fan_Speed_kMedium | 3 — médio |
| Fan_Speed_kHigh | 4 — alto |
| Fan_Speed_kMax | 5 — máximo |
http://192.168.1.120/control?cId=552&rcId=52&state=2&t=25&pw=1&md=1&s=0&v=0&tp=0&type=1&p=0&m=0&c=2&user=admin&pwd=12345678
O exemplo prático acima também inclui os parâmetros tp, type, p, m e c, que não são definidos individualmente em nenhum lugar do documento-fonte. Reproduzidos aqui exatamente como fornecidos — não presuma o significado; confirme com a MolSmart ou testando em uma unidade real antes de depender deles.
Testando a API
Para testar requisições POST/GET contra o Gateway sem escrever código, a documentação-fonte sugere uma extensão gratuita para Chrome:
| Ferramenta | Notas |
|---|---|
| Talend API Tester — Free Edition | página na Chrome Web Store — instale, cole a URL, troque o verbo se necessário, e ajuste as variáveis para ver os resultados em tempo real. |
Notas & Pendências
| Pendência | Detalhe |
|---|---|
| Verbo HTTP (GET vs POST) | O texto-fonte diz POST; todo exemplo prático é uma query string estilo GET. Ver 5.1. |
| Botões AMC / SEED CODE | Aparecem ao lado de RAW/COPY na tela de edição RF (Door/Curtain) da interface web do GW8, mas nenhuma fonte revisada explica o que fazem ou se mapeiam para algum parâmetro de API. Ainda uma pendência conforme o acompanhamento interno de status do manual deste produto. |
| Leitura dos controles configurados via API | Nenhum endpoint documentado lista os controles/CIDs configurados em um GW8 — só a interface web mostra isso (ver screenshot em 5.3). |
| Disparo de sessão de Learning | Nenhum endpoint documentado inicia/confirma uma captura de Learning — ver nota em 5.7. |
| Parâmetros de AC não definidos | tp, type, p, m em 5.8 — ver nota daquela seção. |
| Respostas de erro / falha de autenticação | Não documentadas para nenhum endpoint desta página — ex.: o formato da resposta para user/pwd incorretos não foi coberto no material-fonte. |