Skip to content

README.pt.md

Latest commit

 

History

History
105 lines (69 loc) · 3.75 KB

README.pt.md

File metadata and controls

105 lines (69 loc) · 3.75 KB

HighBoy Banner

Firmware High Boy (Beta)

License GitHub Stars GitHub Forks Pull Requests

Idiomas: 🇺🇸 English | 🇧🇷 Português

Este repositório contém um firmware em desenvolvimento para a plataforma High Boy.
Atenção: este firmware está em fase beta e ainda está incompleto.

Alvos Oficialmente Suportados

Estamos expandindo o suporte para os chips mais recentes da Espressif:

Alvo Status
ESP32-S3 Desenvolvimento Principal
ESP32-P4 Experimental (firmware_p4)
ESP32-C5 Experimental (firmware_c5)

Estrutura do Firmware

Diferente de exemplos básicos com um único main.c, este projeto utiliza uma estrutura modular organizada em components, que se dividem da seguinte forma:

  • Drivers – Lida com drivers e interfaces de hardware.
  • Services – Implementa funcionalidades de suporte e lógica auxiliar.
  • Core – Contém a lógica central do sistema e gerenciadores principais.
  • Applications – Aplicações específicas que utilizam os módulos anteriores.

Essa divisão facilita a escalabilidade, reutilização de código e organização do firmware.

Veja a arquitetura geral do projeto:

Arquitetura do Firmware

Como utilizar este projeto

Recomendamos que este projeto sirva como base para projetos personalizados com ESP32-S3.
Para começar um novo projeto com ESP-IDF, siga o guia oficial:
Documentação ESP-IDF - Criar novo projeto

Estrutura inicial do projeto

Apesar da estrutura modular, o projeto ainda mantém uma organização compatível com o sistema de build do ESP-IDF (CMake).

Exemplo de layout:

├── CMakeLists.txt
├── components
│   ├── Drivers
│   ├── Services
│   ├── Core
│   └── Applications
├── main
│   ├── CMakeLists.txt
│   └── main.c
└── README.md

Como Contribuir

Contribuições são o que fazem a comunidade open-source um lugar incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer é muito apreciada.

  1. Faça um Fork do projeto
  2. Crie sua Feature Branch (git checkout -b feat/AmazingFeature)
  3. Faça o Commit de suas alterações usando Conventional Commits (git commit -m 'feat(scope): add some AmazingFeature')
  4. Faça o Push para a Branch (git push origin feat/AmazingFeature)
  5. Abra um Pull Request

Por favor, leia nosso CONTRIBUTING.md para mais detalhes sobre o estilo de codificação e processo de build.

Código de Conduta

Estamos comprometidos em oferecer um ambiente amigável, seguro e acolhedor para todos. Por favor, leia nosso Código de Conduta para entender as expectativas ao participar deste projeto.

Nossos Apoiadores

Agradecemos especialmente aos parceiros que apoiam este projeto:

PCBWay

Licença

Este projeto está licenciado sob a Apache License, Version 2.0. Veja o arquivo LICENSE para mais detalhes.