APIs do WPC3700
Abreviação de substantivo WPC: Controlador de energia Wi-Fi
API do controlador de potência da série WPC
Este artigo apresenta principalmente as APIs fornecidas peloControladores de energia da série WPC. Por meio dessas APIs, os usuários podem executar as seguintes operações:
- Configurar parâmetros WPC
- Controle de potência de saída WPC
Quem deve ler este artigo
Esta seção está colocada no início porque, embora tenhamos escrito este artigo, ele não é relevante para a maioria dos usuários do WPC.
Se você adquiriu um controlador de potência da série WPC, há alguns modos de operação possíveis:
- Você já instalou os medidores IAMMETER no lado da rede e está usando diretamente oWPC3700em conjunto comMedidores IAMMETER(O WPC3700 opera em modo automático), permitindo que o WPC3700 trabalhe continuamente sob o impulso do excedente solar, que é a solução IAMMETERSistema de controle de aquecedor fotovoltaico.
- Você não tem um medidor IAMMETER, mas está familiarizado com o Home Assistant ou Node-RED e integrou o WPC3700 ao sistema de automação HA ou Node-RED (Habilite a descoberta MQTT no Home Assistant com o firmware IAMMETER mais recente (i.76.058.8)).
- Você precisa chamar a API para integrar o WPC3700 ao seu próprio sistema.
Somente usuários que necessitam do terceiro modo de operação devem ler este artigo.
/api/setpower
/api/setpower?x=100
Introdução
Esta API controla a potência de saída do WPC.
Nota: Este parâmetro também pode ser modificado através dosetadvAPI (chamada HTTP POST,definir potênciaparâmetro).
Desde odefinir potênciao parâmetro pode precisar ser modificado com frequência com base nas leituras de energia da rede em tempo real; esta interface HTTP GET API adicional é fornecida.
URL e Método
URL:http://{{IP}}/api/setpower
Método: HTTP GET
| Nome do parâmetro | Valor de exemplo | Unidade | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|---|
| x | 100 | C | Sim | Inteiro | Representa a potência de saída do WPC. Este é o mesmo parâmetro quedefinir potênciaemsetadv. |
/api/setadv
Introdução
Esta API é usada para definir os parâmetros do WPC.
Nota: Todos os parâmetros podem ser definidos diretamente através doInterface do usuário. Apenas um pequeno número de clientes que precisam integrar produtos da série WPC em seus próprios sistemas usarão esta API.
URL e Método
- URL:
http://{{IP local do WPC}}/api/setadv - Método: HTTP POST
Parâmetros de solicitação
Abaixo está um exemplo desetadvparâmetros.
Nota: Ao executarsetadv, nem todos os parâmetros precisam ser enviados. Somente os parâmetros que precisam ser modificados devem ser enviados. Parâmetros que não precisam de modificação não precisam ser enviados. Você pode usar primeiroobter advpara ler a configuração atual e enviar apenas os parâmetros que precisam ser modificados.
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"meterAddress": "10.10.30.35",
"threshold": 30,
"histerese": 50,
"startHour": 8,
"stopHour": 18,
"tzOffset": 8,
"meterType": 0,
"meterConfig": "3,2,1",
"ntpServer": "ntp.aliyun.com",
"haDiscovery": 1,
"mqttEnabled": 1,
"mqttAddress": "10.10.30.89:1883",
"mqttUsername": "test",
"mqttPassword": "123456",
"uploadInterval": 6
}
Resposta
{
"bem-sucedido": 1,
"mensagem": "ok"
}
Descrição do parâmetro
| Nome do parâmetro | Tipo | Unidade | Descrição |
|---|---|---|---|
| potência máxima | Inteiro | C | A potência máxima da carga controlada deve ser inferior a 3700 |
| definir potência | Inteiro | C | A potência de saída do WPC |
| restaurarPoder | Inteiro | C | Potência após sair do controle do modo automático |
| definirPowerMode | Inteiro | Seleção do modo de operação: 0: Manual, 1: Automático | |
| limite | Inteiro | C | No modo automático, este é o limite para ajuste com base na energia da rede |
| histerese | Inteiro | C | No modo automático, esta é a histerese para ajuste com base na energia da rede |
| hora de início | Inteiro | hora | Hora de início do modo automático |
| hora de parada | Inteiro | hora | Hora de término do modo automático |
| tzDeslocamento | Inteiro | Deslocamento de fuso horário | |
| Tipo de medidor | Inteiro | Escolha da marca do medidor para medição de grade no modo automático: 0:iMeter, 1:virtualTCP | |
| Configuração do medidor | corda | Escolha do modelo do medidor para medição de grade no modo automático: 3: trifásico, 2: usar fase B, 1: proporção | |
| Servidor NTP | corda | Endereço do servidor NTP | |
| haDescoberta | Inteiro | Habilitar descoberta automática do Home Assistant MQTT: 0: desabilitar, 1: habilitar | |
| mqttHabilitado | Inteiro | Habilitar MQTT: 0: desabilitar, 1: habilitar | |
| endereço do medidor | corda | Endereço do broker MQTT, necessário ao integrar com o Home Assistant: 192.168.1.22:1833 | |
| mqttNome de usuário | corda | Nome de usuário MQTT | |
| mqttSenha | corda | Senha MQTT | |
| Intervalo de upload | Inteiro | e | Tempo de intervalo de upload |
/api/getadv
Introdução
Esta API lê todos os parâmetros do WPC (todos os parâmetros dosetadvA API pode ser lida aqui).
URL e Método
- URL:
http://{{IP local do WPC}}/api/getadv - Método: HTTP GET
Resposta
{
"maxPower": 3500,
"setPower": 0,
"restorePower": 0,
"setPowerMode": 0,
"setPowerModeList": "Manual,Auto",
"meterAddress": "10.10.30.35",
"threshold": 20,
"histerese": 30,
"startHour": 8,
"stopHour": 18,
"tzOffset": 8,
"meterType": 0,
"meterConfig": "3,2,1",
"meterList": "iMeter,virtualTCP",
"ntpServer": "ntp.aliyun.com",
"haDiscovery": 0,
"mqttEnabled": 0,
"mqttAddress": "192.168.1.22:1833",
"mqttUsername": "test",
"mqttPassword": "123456",
"uploadInterval": 60
}
Consulte a descrição dos parâmetros emsetadv.
/api/setwifiadv
Introdução
Esta API configura os parâmetros de Wi-Fi para dispositivos WPC/WEM.
URL e Método
- URL:
http://{{IP local do WPC}}/api/setwifiadv - Método: HTTP POST
Parâmetros de solicitação
{
"ssid":"xxxx",
"pwd":"xxxx",
"ip":"xxxx",
"netmask":"xxxxx",
"gw":"xxxx",
"dns":"192.168.1.1",
"dhcp":true,
"runMode":"cloud", // cloud, tcp, http
"uploadAddress":"http://myserver.com/upload" // Útil somente se runMode não for cloud
}
Resposta
{
"sucesso": verdadeiro,
"mensagem": "ok"
}
Descrição do parâmetro
| Nome do parâmetro | Tipo | Unidade | Descrição |
|---|---|---|---|
| SSID | corda | Nome do ponto de acesso Wi-Fi para a conexão WLAN | |
| Pcd | corda | Senha Wi-Fi para conexão WLAN | |
| IP | corda | IP estático; não é necessário se estiver usando o modo DHCP | |
| máscara de rede | corda | Máscara de rede; não é necessário se estiver usando o modo DHCP | |
| gw | corda | Gateway; não é necessário se estiver usando o modo DHCP | |
| DNS-e | corda | Servidor DNS; não é necessário se estiver usando o modo DHCP | |
| dhcp | bool | falso: desabilitar DHCP, verdadeiro: habilitar DHCP |
Documentação de referência
O ?oculto? recursos no firmware do medidor de energia Wi-Fi
Bem-vindo a nos contar sua opinião em nosso fórum.https://imeter.club
Sobre IAMMETER
A IAMMETER é uma empresa focada em produtos e serviços de gerenciamento de energia, oferecendo medidores de energia inteligentes, aplicativos de gerenciamento e plataformas em nuvem.
Nosso objetivo é ajudar os clientes a gerenciar, utilizar e economizar energia de forma eficaz, reduzindo as contas de luz por meio de monitoramento e análise inteligentes.
Soluções
Produtos
- Visão geral dos medidores de energia IAMMETER
- WEM3080T – Medidor de energia Wi-Fi trifásico/bifásico
- WEM3080 – Medidor de energia Wi-Fi monofásico
- WEM3050T – Medidor de energia trifásico
- WEM3046T – Medidor de energia Wi-Fi trifásico com entrada CT padrão de 5 A