Configuração de Sensor Analógico
A Configuração de Sensor Analógico é a área da interface do OpenSprinklerPro para definir fontes de sensores e usar seus valores na automação da irrigação. Abra a partir do menu inferior em Analog Sensor Configuration.
Páginas relacionadas: Automação e Monitores de Sensores, Sensores FYTA, Extensões OpenSprinklerPro, Adendo de API e plataforma.
Definições de sensores
A primeira seção define a lista de sensores. Cada linha possui um número de sensor, nome, valor atual e estado de ativação. Add Sensor abre o editor para um novo sensor; os sensores existentes são editados tocando no nome do sensor.
Campos do Editor
| Campo | Significado |
|---|---|
| Número, nome e grupo | Identificam o sensor em listas, gráficos, ajustes de programa e monitores. Os grupos são rótulos para classificar e filtrar sensores relacionados. |
| Tipo | Seleciona o driver ou fonte virtual. O tipo determina quais campos adicionais aparecem. |
| Unidade e formato | Define como os valores são exibidos, registrados e comparados. Escolha uma unidade compatível com o valor físico ou a carga de dados. |
| Intervalo, log e exibição | O intervalo controla a frequência com que o valor é atualizado. O Log ativa o armazenamento de histórico/gráfico; show controla a visibilidade no painel da interface de usuário. |
| Barramento, endereço e canal | Usado por fontes analógicas RS485/Modbus, ASB e OSPi para selecionar o barramento de hardware, endereço do dispositivo ou canal analógico. |
| Calibração definida pelo usuário | Para sensores analógicos definidos pelo usuário, insira a fórmula de conversão de tensão bruta/ADC para o valor físico final. |
| Tópico MQTT e filtro | Os sensores MQTT assinam um tópico e, opcionalmente, extraem um valor de um JSON ou carga de texto. |
| Lista de sensores de origem | Os sensores de grupo calculam um novo valor a partir dos sensores de origem selecionados. Todas as origens devem usar unidades compatíveis. |
RS485 / Modbus
Use estes tipos para sensores com fio em um barramento RS485 ou um dispositivo Modbus RTU genérico. Configure o barramento, endereço escravo, registro/canal e intervalo de leitura de acordo com o dispositivo conectado.
| Tipo de sensor | Explicação |
|---|---|
| Truebner SMT100 RS485 Modbus, modo umidade | Lê o valor da umidade do solo de um Truebner SMT100 via RS485/Modbus. Use para decisões de irrigação baseadas no teor volumétrico de água. |
| Truebner SMT100 RS485 Modbus, modo temperatura | Lê o canal de temperatura do SMT100. Use quando a temperatura do solo deve ser registrada ou usada em regras de monitoramento. |
| Truebner SMT100 RS485 Modbus, modo permissividade | Lê o canal de permissividade dielétrica do SMT100 para diagnósticos ou modelos de solo avançados. |
| Truebner TH100 RS485 Modbus, modo umidade | Lê a umidade relativa de um Truebner TH100. Útil para monitoramento em estufas ou umidade ambiente. |
| Truebner TH100 RS485 Modbus, modo temperatura | Lê o valor de temperatura do TH100 para monitoramento da temperatura ambiente ou da área de instalação. |
| Sensor genérico RS485/MODBUS RTU | Lê um valor Modbus RTU configurável de equipamentos de terceiros. Defina o endereço, registro, formato de dados e calibração para corresponder ao manual do dispositivo. |
Analog Sensor Board (ASB)
Os tipos ASB lêem entradas de tensão da placa de sensor analógio do OpenSprinkler e as convertem em um valor físico. Selecione o canal correto e use apenas modos de sensor compatíveis com a fiação e a tensão de alimentação.
| Tipo de sensor | Explicação |
|---|---|
| ASB - modo tensão 0..5V | Relata a tensão de entrada medida na ASB diretamente na faixa de 0 a 5 V. Use para calibração ou sensores externos com sua própria conversão. |
| ASB - 0..3.3V para 0..100% | Converte uma tensão de entrada de 0 a 3,3 V em uma porcentagem. Útil para sinais analógicos genéricos de nível ou umidade. |
| ASB - SMT50 modo umidade | Converte a saída analógica de um Truebner SMT50 em umidade do solo. |
| ASB - SMT50 modo temperatura | Converte a saída de temperatura do SMT50 em um valor de temperatura física. |
| ASB - SMT100-analog modo umidade | Converte a saída analógica de umidade de um Truebner SMT100. |
| ASB - SMT100-analog modo temperatura | Converte a saída analógica de temperatura de um Truebner SMT100. |
| ASB - Vegetronix VH400 | Converte a saída do Vegetronix VH400 em umidade do solo. |
| ASB - Vegetronix THERM200 | Converte a saída do Vegetronix THERM200 em temperatura. |
| ASB - Vegetronix AquaPlumb | Converte a saída do Vegetronix AquaPlumb para presença de água ou medições estilo nível. |
| ASB - sensor definido pelo usuário | Usa calibração personalizada para sensores não cobertos por uma conversão embutida. Defina a unidade, o formato de exibição e a conversão cuidadosamente. |
Entradas analógicas OSPi
Estes tipos são para entradas analógicas disponíveis em instalações baseadas em OSPi/Raspberry Pi. Eles não são usados em controladores apenas ESP sem o hardware de entrada analógica correspondente.
| Tipo de sensor | Explicação |
|---|---|
| Entrada analógica OSPi - modo tensão 0..3.3V | Relata a tensão de entrada analógica medida diretamente na faixa de 0 a 3,3 V. |
| Entrada analógica OSPi - 0..3.3V para 0..100% | Converte uma entrada de 0 a 3,3 V em uma porcentagem para sensores analógicos genéricos. |
| Entrada analógica OSPi - SMT50 modo umidade | Converte uma saída de umidade SMT50 conectada a uma entrada analógica OSPi. |
| Entrada analógica OSPi - SMT50 modo temperatura | Converte uma saída de temperatura SMT50 conectada a uma entrada analógica OSPi. |
| Temperatura interna do Raspberry Pi | Lê a temperatura da CPU do Raspberry Pi. Use-o como um sensor de diagnóstico para gabinete OSPi ou verificações térmicas. |
| Temperatura interna do ESP32 | Lê o sensor de temperatura interna do ESP32 onde for suportado. Trate-o como diagnóstico do controlador, e não como temperatura ambiente calibrada. |
Fontes sem fio, na nuvem e remotas
Estes tipos recebem valores de integrações de rádio, serviços em nuvem, MQTT ou outro controlador OpenSprinkler. Confirme a disponibilidade da plataforma antes de selecioná-los: Zigbee e BLE requerem builds ESP32 compatíveis; FYTA requer credenciais de nuvem; MQTT requer uma configuração de corretor (broker).
| Tipo de sensor | Explicação |
|---|---|
| Sensor Zigbee | Mapeia um valor relatado por um dispositivo Zigbee emparelhado, como temperatura, umidade ou umidade do solo. Selecione o dispositivo e a medição exposta. |
| Sensor BLE | Lê um sensor Bluetooth Low Energy compatível. Use o intervalo de varredura e a seleção do dispositivo para equilibrar a atualização e a carga de rádio. |
| Sensor de umidade FYTA | Importa a umidade do solo de um sensor de planta FYTA após a configuração do FYTA. |
| Sensor de temperatura FYTA | Importa a temperatura de um sensor de planta FYTA após a configuração do FYTA. |
| Sensor de umidade Gardena | Importa a umidade do solo de um sensor inteligente Gardena via API de nuvem da Gardena. |
| Sensor de temperatura Gardena | Importa a temperatura de um sensor inteligente Gardena via API de nuvem da Gardena. |
| Assinatura MQTT | Subscreve a um tópico MQTT e analisa o valor recebido. Configure o tópico, expressão JSON/filtro opcional, unidade e comportamento de timeout. |
| Sensor JSON remoto | Consulta qualquer endpoint JSON HTTP/HTTPS externo e extrai o valor usando uma busca de caminho. |
| Sensor OpenSprinkler remoto | Lê um sensor de outro controlador OpenSprinkler. Configure a URL/controlador remoto e o número do sensor de origem. |
Dados meteorológicos
Os sensores meteorológicos expõem valores já conhecidos pelo controlador a partir do serviço meteorológico configurado. Use o tipo específico da unidade que corresponda às suas regras de automação e gráficos.
| Tipo de sensor | Explicação |
|---|---|
| Dados climáticos - temperatura (°F) | Temperatura do serviço meteorológico em graus Fahrenheit. |
| Dados climáticos - temperatura (°C) | Temperatura do serviço meteorológico em graus Celsius. |
| Dados climáticos - umidade (%) | Umidade relativa do serviço meteorológico em porcentagem. |
| Dados climáticos - precip (inch) | Precipitação do serviço meteorológico em polegadas. |
| Dados climáticos - precip (mm) | Precipitação do serviço meteorológico em milímetros. |
| Dados climáticos - vento (mph) | Velocidade do vento do serviço meteorológico em milhas por hora. |
| Dados climáticos - vento (kmh) | Velocidade do vento do serviço meteorológico em quilômetros por hora. |
| Dados climáticos - ETO | Valor de evapotranspiração de referência usado para o contexto de irrigação. |
| Dados climáticos - radiação | Valor de radiação solar da fonte meteorológica, quando disponível. |
Grupo de sensores
Os sensores de grupo criam um valor agregado a partir de outros sensores. Escolha sensores de origem com unidades e intervalos de registro comparáveis para que o resultado seja significativo.
| Tipo de sensor | Explicação |
|---|---|
| Grupo de sensores com valor mínimo | Relata o valor atual mais baixo entre os sensores de origem selecionados. |
| Grupo de sensores com valor máximo | Relata o valor atual mais alto entre os sensores de origem selecionados. |
| Grupo de sensores com valor médio | Relata a média aritmética dos sensores de origem selecionados. |
| Grupo de sensores com valor de soma | Relata a soma de sensores de origem selecionados, por exemplo, totais combinados de fluxo ou chuva. |
Ajustes de Programa
Os Ajustes de Programa dimensionam a duração da irrigação de um programa com base no valor de um sensor. Exemplos típicos são menos irrigação com alta umidade do solo ou mais irrigação com alta temperatura.
Modelo de Ajuste
Cada ajuste conecta um sensor a um programa de irrigação e calcula um fator percentual. Ative primeiro o log do sensor e verifique os valores medidos antes que a irrigação real seja afetada.
Tipos de Ajuste
| Tipo | Uso |
|---|---|
LINEAR |
Dimensiona continuamente entre o ponto inferior e superior configurado. |
DIGITAL_MIN |
Dispara uma redução binária ou bloqueio se o sensor estiver abaixo de um limite. |
DIGITAL_MAX |
Dispara uma redução binária ou bloqueio se o sensor estiver acima de um limite. |
DIGITAL_MINMAX |
Aplica comportamento binário dentro ou fora de uma faixa configurada. |
Os modelos de funcionamento e fórmulas podem ser encontrados em Automação e Monitores de Sensores.
Monitores e Alertas Locais
Monitoramento e Controle cria regras de limite e lógica a partir de sensores. Os monitores podem gerar alertas locais, alimentar eventos de notificação e combinar condições como "o solo está seco" e "o período é de manhã".
Estrutura de Regras
As regras do monitor selecionam um sensor, comparam-no com um limite ou estado e definem o que deve acontecer quando a condição for atendida. Nomes claros facilitam a compreensão de alertas futuros.
Lógica e Períodos
Os tipos de monitores incluem limites, regras digitais de sensores de chuva/solo, combinações lógicas, períodos de tempo e estados de monitores remotos. Consulte Automação e Monitores de Sensores para o modelo funcional.
Gráficos de Sensores e Dados
O Gráfico do Sensor exibe os valores registrados dos sensores. Use-o para verificar leituras reais antes de usá-las para ajustes de programa ou monitores. A interface gráfica também permite descarregar logs ou abrir a tabela de dados.
Leitura de Gráficos
Preste atenção a pontos de medição ausentes, picos inesperados e unidades incompatíveis. Compare sensores relacionados no mesmo grupo antes de usá-los para decisões automáticas.
Baixar Dados
Os dados registrados podem ser baixados ou inspecionados em formato de tabela. Isso ajuda na calibração, solução de problemas e compartilhamento de curvas de sensores.
Configuração FYTA
O menu de Configuração FYTA armazena o token da API ou os dados de login da FYTA e mapeia os sensores de plantas FYTA para sensores correspondentes do OpenSprinkler. Detalhes: Sensores FYTA.
Credenciais
Insira o token de API ou as credenciais de login exigidas pela sua versão de firmware. Mantenha as credenciais privadas e atualize-as caso o acesso à FYTA mude.
Mapear Plantas
Após a autenticação, mapeie os valores de umidade e temperatura das plantas FYTA para as entradas de sensores do OpenSprinkler, permitindo que sejam visualizados em gráficos, monitorados e ajustados.
Configuração Gardena
A Configuração Gardena permite a conexão com a API oficial da nuvem Gardena. Isso possibilita importar diretamente os sensores inteligentes de umidade e temperatura do solo da Gardena e integrá-los à sua lógica de rega.
Assistente OAuth Gardena
- Cadastre-se no Portal do Desenvolvedor Gardena se necessário e crie um aplicativo para obter um Client ID e Client Secret.
- No menu do OpenSprinkler, acesse Opções -> Integrações ou abra diretamente o Assistente OAuth Gardena nas opções de sensores analógicos.
- Insira suas credenciais. O assistente o guiará pelo login OAuth 2.0 e solicitará automaticamente o Token de Atualização (Refresh Token).
- Após o login com sucesso, os dispositivos Gardena conectados serão descobertos de forma automática.
Mapear Sensores Gardena
Nas definições de sensores, selecione o tipo Sensor de umidade Gardena ou Sensor de temperatura Gardena. No editor, você poderá então escolher o dispositivo desejado e sua respectiva métrica de dados.
Configuração de Sensor JSON Remoto
O Sensor JSON remoto é um tipo extremamente flexível projetado para consultar APIs REST arbitrarias que retornam dados no formato JSON. Ele analisa as respostas diretamente em tempo real com baixo consumo de memória.
Campos do Editor
- URL: O endereço HTTP ou HTTPS completo da API (ex:
http://api.weather.com/v1/sensor). Máximo de 200 caracteres. Você pode incluir parâmetros de consulta diretamente na URL (ex:http://192.168.1.1/api?pw=123&js=1para passar chaves, senhas ou IDs). - Caminho de Busca JSON (Filtro): O caminho mapeado para o valor numérico desejado no documento JSON. Objetos aninhados são separados por uma barra vertical (
|) (ex:main|tempouroot|sensor_1|humidity).
Especificações Técnicas
- Método de Requisição: É utilizado exclusivamente o protocolo HTTP-GET padrão.
- Frequência de Consulta (Single Data Poll): Apenas um único valor de medição atual é consultado e processado a cada intervalo de tempo (arquivos de log ou listas de dados não são analisados pelo controlador).
- Tempo Limite (Timeout): O tempo para estabelecimento de conexão e fluxo de dados é fixado em exatamente 3000 milissegundos. O endpoint deve responder dentro de 3 segundos, ou a transmissão falhará.
- Sincronização e Arquitetura Recomendada: Para evitar problemas de timeout ou estouro de limites de chamadas em APIs externas (como a do OpenMeteo), a prática recomendada consiste em executar um script (via agendamento cronjob) em um gateway ou computador local (como um roteador com OpenWrt). Esse script processa as previsões de clima, aplica suavizações de filtro (anti-aliasing) e gera um arquivo estático JSON local. O OpenSprinkler lê esse arquivo estático local em rede em poucos milissegundos.
Backup e Restauração
O menu Backup e Restauração exporta ou restaura arquivos de configuração de sensores, ajustes de programas e regras do monitor separadamente do backup geral do controlador. Use antes de grandes mudanças ou testes de firmware.
Dados Incluídos
Os backups incluem definições de sensores, regras de ajuste e regras dos monitores. Não substituem o backup geral do sistema para outros ajustes.
Processo de Restauração Seguro
Exporte sempre um backup antes de realizar alterações, restaure apenas arquivos de origens confiáveis e valide os valores medidos após o restauro antes de permitir decisões automáticas de irrigação.