Skip to content

About

A Python CLI for the Raspberry Pi Sense HAT that prints text on the LED matrix in custom colors — layered design with a hardware abstraction that keeps the logic testable off-device, and documented ADRs.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sense LED CLI

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.


Visão Geral

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.


Arquitetura

Separação de responsabilidades

  • 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/.


Requisitos

  • Raspberry Pi OS
  • Python 3.9+
  • Raspberry Pi 5
  • Sense HAT

Instalação

Criar e ativar o ambiente virtual:

python3 -m venv venv
source venv/bin/activate

Instalar dependências:

pip install -r requirements.txt

Uso

Exibir texto com cor padrão (branco):

sense-led "Olá Jonas"

Exibir texto com cor nomeada:

sense-led "Olá Jonas" --color red

Exibir texto com cor RGB personalizada:

sense-led "Olá Jonas" --color 128,64,255

O texto informado será exibido na matriz de LEDs do Sense HAT conforme os parâmetros fornecidos.


Testes

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.


Padrões adotados

  • 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

Autor

Jonas Borges 📧 jonasleo92@yahoo.com.br 📅 17/01/2026


Licença

Uso educacional e experimental.

About

A Python CLI for the Raspberry Pi Sense HAT that prints text on the LED matrix in custom colors — layered design with a hardware abstraction that keeps the logic testable off-device, and documented ADRs.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages