Aplicação em Python para Raspberry Pi que exibe texto na matriz de LEDs do Sense HAT via linha de comando (CLI), aplicando princípios de arquitetura de software, código limpo e testabilidade em um contexto de sistemas embarcados.
O projeto fornece uma interface de linha de comando para exibir mensagens no display de LEDs do Sense HAT, com suporte à customização de cores e uma arquitetura pensada para manutenção, testes e evolução futura.
Todo o código é organizado em camadas bem definidas, com abstração de hardware e decisões arquiteturais documentadas.
-
CLI Responsável pelo parsing de argumentos e validação de entrada do usuário.
-
Display (Serviço) Contém as regras de exibição e orquestra a interação com o dispositivo de LEDs.
-
Domínio Modelos de valor, como cores RGB, com validação explícita.
-
Hardware Camada responsável pela comunicação direta com o Sense HAT.
-
Main Ponto de entrada da aplicação e orquestração do fluxo.
Decisões arquiteturais adicionais estão documentadas em docs/adr/.
- Raspberry Pi OS
- Python 3.9+
- Raspberry Pi 5
- Sense HAT
Criar e ativar o ambiente virtual:
python3 -m venv venv
source venv/bin/activateInstalar dependências:
pip install -r requirements.txtExibir texto com cor padrão (branco):
sense-led "Olá Jonas"Exibir texto com cor nomeada:
sense-led "Olá Jonas" --color redExibir texto com cor RGB personalizada:
sense-led "Olá Jonas" --color 128,64,255O texto informado será exibido na matriz de LEDs do Sense HAT conforme os parâmetros fornecidos.
A arquitetura permite testes automatizados sem dependência de hardware.
- O hardware é abstraído por meio de contratos claros
- Fakes são utilizados para validar comportamento
- As regras de domínio e exibição são testáveis isoladamente
Essa abordagem garante maior confiabilidade e facilita a evolução do projeto.
- Ambiente isolado com
venv - Abstração explícita de hardware
- Código desacoplado e testável
- Validação no domínio
- Arquitetura orientada à manutenção
- Decisões arquiteturais documentadas (ADR)
- Versionamento completo no Git
Jonas Borges 📧 jonasleo92@yahoo.com.br 📅 17/01/2026
Uso educacional e experimental.