Bluetooth Low Energy (BLE)
Bom candidato para comunicação direta entre placa e celular próximo. O Android precisa tratar permissões, pareamento, reconexão e perda de sinal.
PESCARADAR · CONECTIVIDADE
Integração IoT, Arduino e Android.
Visão técnica de como sensores ambientais e equipamentos embarcados podem se conectar ao aplicativo PescaRadar, ao celular e aos serviços de dados — com atenção à segurança, ao funcionamento offline e ao custo.
Estado atual: firmware 2.4.0 compilado · validação de bancada pendenteO ESP32 oferece Wi-Fi/HTTPS opt-in, sensores locais e GATT de diagnóstico com característica Notify, CCCD 0x2902 e retomada automática do advertising. A compilação foi validada no Arduino-ESP32 3.3.12. A estabilidade em hardware ainda precisa de teste físico. Provisionamento BLE Security 2 e gateway Android durável permanecem pendentes; MQTT não está implementado.
APLICATIVO ANDROID
PescaRadar para Android
O pacote de teste é publicado automaticamente após a aprovação dos testes unitários, do lint e do build Android na API 36.
Verificando se há um APK de teste validado disponível…
Baixar firmware ESP32 2.4.0 · SHA-256
Integridade: consultar SHA-256.
Esta é uma versão de teste assinada com a chave debug do Android, não uma versão de produção. O provisionamento BLE Security 2 e a integração física dos sensores ainda não estão certificados. O Android pode pedir autorização para instalar aplicativos obtidos fora da loja.
PAINEL OPERACIONAL
Dispositivos, alertas e webhooks
Gerencie dispositivos IoT, limites de sensores e destinos HTTPS para receber eventos ambientais. As operações exigem sessão autenticada e usam a API do PescaRadar.
Carregando dados da conta…
Entrar na área pessoal1. Dispositivos e sensores
Entre nesta área com sua conta pessoal PescaRadar. O cadastro lógico continua disponível, mas não representa vínculo físico. O fluxo definitivo será iniciado no painel local do ESP32, com autenticação pelo navegador e validação individual do equipamento. QR Code não será obrigatório.
O cadastro abaixo cria somente um registro lógico e não grava credenciais no ESP32. Para equipamentos físicos, aguarde o fluxo de vinculação pelo portal local. Configure o limite de silêncio.
Vínculos aguardando comprovação física
2. Regras de limites
Gere um evento quando uma leitura cruzar o limite configurado. Use nomes e unidades consistentes com a telemetria.
3. Webhooks de saída
Envie eventos para um endpoint HTTPS público. Destinos genéricos recebem JSON assinado por HMAC. URLs oficiais de webhook de entrada do Discord são reconhecidas automaticamente e recebem mensagens no formato nativo do Discord. O segredo de assinatura é exibido uma única vez após a criação.
4. Receber alertas no Discord
Configure sua própria aplicação Discord. As credenciais ficam associadas à sua conta PescaRadar.
Informe os dados da sua aplicação Discord para habilitar instalação, comandos e alertas.
- Adicionar o PescaRadarInstale o bot oficial no servidor onde deseja receber os avisos.Preparando instalação do bot…
- Conectar sua conta DiscordUse a conexão automática. Se o OAuth2 não estiver disponível neste ambiente, o PescaRadar gera um código alternativo para concluir a vinculação pelo comando do bot.Conectar com Discord
No servidor Discord, execute /vincular e informe este código:
O código expira em 10 minutos e só pode ser usado uma vez.
- Selecionar o servidorEscolha um servidor em que você tenha permissão de gestão e onde o bot PescaRadar esteja instalado.
- Escolher o canalDepois de confirmar o servidor, selecione o canal de texto em que deseja receber os alertas.
Verificando conexão com Discord…
Conecte sua conta Discord. Se o OAuth2 não estiver disponível, use o código alternativo de vinculação.
Salve o canal e os eventos para habilitar o teste.
5. Histórico de webhooks HTTP
Consulte até 50 entregas recentes. Uma entrega encerrada com falha pode ser recolocada na fila.
6. Histórico de alertas Discord
Consulte entregas do bot e tente novamente mensagens encerradas por falha transitória ou corrigível.
Segurança e limites: use apenas URLs HTTPS de destinos públicos; não coloque senhas ou tokens na URL. Guarde tokens e segredos fora do código e do firmware. A entrega depende do agendador e do KV existente; não é uma garantia transacional de entrega única.
01 · VISÃO GERAL
Como os componentes podem conversar
A topologia final depende da placa escolhida, dos sensores, do alcance necessário e da disponibilidade de internet no ponto de pesca.
1. Sensores
Medem parâmetros físicos; cada leitura precisa de unidade, horário e estado de qualidade.
2. Placa IoT
O ESP32 lê sensores, mantém a API local, publica diagnóstico GATT e envia telemetria HTTPS somente após opt-in.
3. Android
O Android descobre o serviço PescaRadar, lê identificador/estado e recebe Notify quando MTU 247 e CCCD estão disponíveis. Provisionamento Security 2 e gateway em segundo plano ainda não estão concluídos.
4. API PescaRadar
Recebe telemetria pelo endpoint autenticado POST /api/iot/telemetry. O firmware já possui envio HTTPS opt-in; fila offline durável, retry idempotente e gateway Android ainda estão pendentes.
02 · CONECTIVIDADE
Opções de comunicação
Selecionar uma tecnologia exige considerar distância, consumo de energia, custo de hardware e cobertura de rede.
Wi-Fi
Útil quando a placa e o celular ou ponto de acesso compartilham uma rede. Não garante acesso à internet nem cobertura em áreas remotas.
HTTP ou MQTT
HTTP/HTTPS é adequado para envio de lotes à API. MQTT pode ser considerado para telemetria contínua, mas exige broker, autenticação e avaliação de custo.
03 · CONTRATO DE DADOS
O que uma leitura deve carregar
O aplicativo não deve tratar ausência de leitura como zero nem misturar sensores com unidades diferentes.
| Campo | Finalidade | Regra recomendada |
|---|---|---|
device_id | Identificar a placa ou equipamento. | Identificador estável; não usar como segredo. |
sensor_type | Tipo de medição, por exemplo temperatura da água. | Lista de valores documentada e versionada. |
value + unit | Valor numérico e unidade. | Validar faixa e unidade antes de salvar. |
measured_at | Instante em que o sensor mediu. | Timestamp ISO 8601; distinguir horário do aparelho e horário de recebimento. |
quality | Qualidade da amostra. | Estados explícitos para válido, ausente, erro ou fora da faixa. |
sequence | Ordenar e deduplicar mensagens. | Contador monotônico por dispositivo para reenvio idempotente. |
04 · SEGURANÇA E CONFIABILIDADE
Regras antes de integrar
- Autenticar dispositivos e usuários.
Não embutir chaves administrativas, tokens privados ou segredos da API no firmware ou no aplicativo. Usar credenciais limitadas e rotacionáveis.
- Separar leitura local de sincronização remota.
O Android pode manter uma fila local; reenvios devem ser idempotentes, com política explícita de conflito e sem apagar dados em falha de rede.
- Registrar origem e qualidade.
Armazenar modelo do sensor, unidade, calibração quando conhecida, horário e erros. Estimativas devem ser rotuladas como estimativas.
- Proteger localização e privacidade.
Coletar apenas dados necessários, explicar a finalidade e obter consentimento antes de compartilhar localização ou telemetria vinculada a uma pessoa.
- Validar fora da produção.
Testar com dados sintéticos e ambiente isolado antes de habilitar gravações remotas. Não alterar bindings, banco ou serviços ativos apenas para experimentar.
05 · ETAPAS DE IMPLEMENTAÇÃO
Sequência sugerida
Avançar etapa por etapa evita investir em uma conexão antes de definir o que o equipamento precisa medir e enviar.
Definir hardware
Escolher placa, sensores, alimentação, invólucro, ambiente de uso e interfaces disponíveis.
Provar a leitura local
Validar calibração, faixa, unidade, estabilidade e detecção de sensor desconectado.
Conectar ao Android
Prototipar BLE ou Wi-Fi, permissões, estados de conexão e armazenamento local offline.
Integrar firmware à API
O envio HTTPS opt-in do ESP32 está implementado. Validar comportamento em hardware, relógio, perda de rede e respostas do Worker; concluir fila offline e reenvio idempotente.
Executar testes isolados
Simular perda de conexão, dados inválidos, repetição, relógio incorreto, bateria baixa e reconexão.
Publicar com gates
Documentar resultados, aprovar testes e verificar a versão publicada; manter a operação dentro do orçamento R$ 0.
06 · REFERÊNCIAS DO PROJETO
Próximos pontos de consulta
O repositório contém uma auditoria inicial da integração Firebase/Android. Ela identifica pontos que precisam de confirmação e alerta que a existência de Room ou configurações Firebase não prova sincronização remota funcionando.
Antes de declarar uma integração ativa, confirme a placa e os sensores reais, execute build/testes Android e valide o contrato de comunicação no ambiente de desenvolvimento.