Utilitário RasPY
Bem-vindo à Documentação do Utilitário RasPY
Utilitário RasPY é um aplicativo abrangente para controlar e monitorar pinos GPIO do Raspberry Pi através de uma interface gráfica intuitiva ou API REST.
Índice
Introdução
Desenvolvimento
Recursos Adicionais
Comunidade
Principais Recursos
✅ Interface Gráfica Moderna
- Tema claro/escuro
- Suporte multilíngue
- Visualização em tempo real do status dos pinos
- Integração com bandeja do sistema
🔌 Suporte Completo a GPIO
- Controle de pinos digitais de entrada/saída
- Simulador integrado para desenvolvimento
- Detecção automática de hardware
- Suporte a GPIO remoto
🌐 Interface Web
- Servidor web integrado
- Design responsivo para mobile/desktop
- Atualizações em tempo real
- Documentação de API integrada
Guia Rápido
- Instalação - Como instalar e configurar o Utilitário RasPY
- Guia - Guia de uso do aplicativo
- API - Documentação da API para desenvolvedores
- Desenvolvimento - Guia de desenvolvimento e contribuição
Guia do Usuário
Interface Gráfica
A interface gráfica do Utilitário RasPY 4 foi projetada para ser intuitiva e fácil de usar.
- Arquivo: Controles gerais do aplicativo
- GPIO: Gerenciamento de pinos GPIO e simulador
- Visualizar: Personalização da interface
- Ajuda: Documentação e informações
Controle de GPIO
- Abra a janela de controle de GPIO no menu
- Selecione o pino para controlar
- Use os botões para alternar o estado dos pinos
- Monitore o status em tempo real
Simulador de GPIO
O simulador permite testar códigos sem hardware físico:
- Inicie o simulador no menu GPIO
- Use a interface para simular entradas/saídas
- As alterações são refletidas em tempo real
Registro e Depuração
O aplicativo registra eventos importantes no arquivo logs/app.log. Use o Visualizador de Logs integrado para:
- Filtrar mensagens por nível (INFO, AVISO, ERRO)
- Buscar mensagens específicas
- Exportar logs para análise
Atalhos de Teclado
- Ctrl+Q: Sair do aplicativo
- F1: Mostrar ajuda
- Ctrl+L: Abrir visualizador de logs
- F5: Atualizar interface
Referência da API
Visão Geral
A API REST do Utilitário RasPY 4 permite controlar pinos GPIO por meio de requisições HTTP.
Todas as respostas estão no formato JSON.
Endpoints Disponíveis
GET /api/gpio
Retorna o status de todos os pinos GPIO configurados.
Exemplo de resposta:
{
"17": {"state": 0, "mode": "out", "description": "LED Vermelho"},
"18": {"state": 1, "mode": "in", "description": "Botão"}
}
GET /api/gpio/<int:pin>
Retorna o status de um pino específico.
Parâmetros:
Códigos de status:
- 200: Operação bem-sucedida
- 404: Pino não encontrado
Exemplo de resposta:
{
"state": 0,
"mode": "out",
"description": "LED Vermelho"
}
POST /api/gpio/<int:pin>/on
Liga o pino especificado.
Parâmetros:
Códigos de status:
- 200: Operação bem-sucedida
- 400: Pino inválido ou não gravável
POST /api/gpio/<int:pin>/off
Desliga o pino especificado.
Parâmetros:
Códigos de status:
- 200: Operação bem-sucedida
- 400: Pino inválido ou não gravável
Exemplos de Uso
import requests
BASE_URL = "http://localhost:5000/api/gpio"
# Obter status de todos os pinos
response = requests.get(f"{BASE_URL}")
print("Status atual:", response.json())
# Ligar o pino 17
response = requests.post(f"{BASE_URL}/17/on")
print("Resposta de ativação:", response.status_code)
Recursos Úteis
