Documentacao da API do Rover CIRC
Resumo da API do Rover CIRC
Finalidade Geral
Esta API Flask integra o sistema embarcado do Rover CIRC com o banco de dados PostgreSQL, registrando e
consultando informações em tempo real de sensores como MPU6050, DHT11, SW-420, KY-032, Sensor Hall, além de
dados dos motores. O Swagger está integrado para documentar e testar os endpoints de forma interativa.
Resumo dos Endpoints
Método | Rota | Descrição
-------|------------|-----------------------------------------
GET | / | Verifica se a API está online
GET | /sensores | Lista todos os sensores ativos no banco
POST | /leituras | Registra uma nova leitura de sensor
POST | /eventos | Registra um evento de segurança
POST | /clima | Registra temperatura e umidade do ambiente
POST | /motores | Registra o estado dos motores
- GET /sensores
Descrição: Lista todos os sensores cadastrados como ativos.
Uso: Verificação rápida ou preenchimento automático de interfaces.
- POST /leituras
Descrição: Registra uma leitura de valor numérico de sensores.
Sensores: MPU6050, KY-032, Sensor Hall, SW-420
Exemplo:
{
"sensor_id": 3,
"valor": 27.4
}
- POST /eventos
Descrição: Registra um evento de segurança com descrição e nível de risco.
Sensores: SW-420, KY-032, MPU6050
Exemplo:
{
"tipo_evento": "tombamento",
"sensor_id": 5,
"descricao": "Inclinação maior que 45 graus detectada",
"nivel_risco": "alto"
}
Documentacao da API do Rover CIRC
- POST /clima
Descrição: Envia dados de temperatura e umidade do ambiente (DHT11).
Exemplo:
{
"temperatura": 29.5,
"umidade": 62.1
}
- POST /motores
Descrição: Armazena o estado de funcionamento de cada motor.
Relacionamento: PWM, direção, corrente, velocidade (via Sensor Hall)
Exemplo:
{
"lado": "direito",
"pwm": 125,
"direcao": "ré",
"corrente": 2.1,
"velocidade_rpm": 104.5
}
Conclusao para o Relatorio
A API está preparada para ser consumida pelo software embarcado do Rover, oferecendo endpoints bem definidos,
estrutura segura e documentação via Swagger. A integração com sensores permite resposta autônoma a obstáculos,
impactos e mudanças de ambiente, essencial para missões do CIRC.