AIO Suite Local

Objetivo

O AIO e uma suite multiplataforma para aquisicao analogica, visualizacao em tempo real e supervisao com foco em hardware de baixo custo, uso didatico e linguagem visual tecnico-industrial.

Hoje o projeto permite:

• ler sinais analogicos de Arduino, ESP32 e ESP8266
• normalizar os dados em um contrato unico
• visualizar os sinais no Android e no Windows
• calibrar o sinal no app, sem regravar o firmware
• manter o comparativo Bruto x Calibrado
• distribuir firmwares prontos junto do pacote desktop

Modulos

• App 1 - AIO Analog: app Android para aquisicao, normalizacao e calibracao local via Wi-Fi HTTP, Bluetooth Classic e USB Serial OTG
• App 2 - AIO Plot Android: app Android de graficos em tempo real usando o runtime compartilhado chart.html
• App 3 - AIO SCADA Desktop: supervisório Windows com aquisicao local via Wi-Fi HTTP, USB Serial / COM e Bluetooth SPP / COM
• App 4 - AIO Protocol: modulo compartilhado com protocolo, formulas e templates de firmware

Estrutura do repositorio

• android/: codigo-fonte do App 1, App 2 e modulo compartilhado
• desktop/aio-scada-desktop/: codigo-fonte do App 3
• packages/aio-protocol/: firmwares, exemplos e contrato JSON
• packages/chart-runtime/: motor grafico compartilhado entre Android e desktop
• docs/: arquitetura, formulas, calibracao, guias de conexao e roadmap
• releases/: artefatos finais locais e notas de release
• scripts/: scripts de build e manutencao

Fluxos atuais

• Android: Hardware -> App 1 -> amostra normalizada -> calibracao opcional -> App 2 -> chart.html
• Desktop: Hardware -> App 3 -> amostra normalizada -> calibracao opcional -> chart.html

Calibracao: o que ela faz hoje

A calibracao atual e aplicada no App 1 e no App 3, depois da leitura do hardware.

• ela corrige offset e ganho sem alterar o firmware C++
• ela preserva o valor Bruto para diagnostico
• ela exibe o valor Calibrado para uso operacional
• ela atende bem potenciometro, nivel, transdutores lineares, 0,5-4,5 V e 4-20 mA linearizado

Guia detalhado:

• docs/calibration-guide.md

Documentacao principal

• arquitetura geral: docs/system-architecture.md
• calculos oficiais: docs/analog-calculations.md
• guia de calibracao: docs/calibration-guide.md
• roteiro da comunidade: docs/community-roadmap.md
• checklist de publicacao: docs/github-publish-checklist.md

Versionamento

• versao atual: 1.1.0
• politica: docs/versioning-policy.md
• historico: CHANGELOG.md

Comunidade

• roteiro e melhorias futuras: docs/community-roadmap.md
• como contribuir: CONTRIBUTING.md
• creditos: CREDITS.md

Releases

• artefatos finais locais: releases/README.md
• pacote desktop com firmwares inclusos: consulte os assets em releases/README.md e no GitHub Releases

Licenca

• licenca: Apache-2.0
• avisos de atribuicao: NOTICE
• orientacao de nome e marca: TRADEMARKS.md