Bem-vindo(a) à documentação do projeto Franzininho
Esta documentação reúne guias, referências e exemplos para quem quer aprender, montar, programar e criar projetos com as placas e kits Franzininho.
Se você está chegando agora, comece por esta página. Ela ajuda a entender o projeto, escolher uma placa ou kit e encontrar o próximo tutorial sem precisar conhecer toda a documentação de antemão.
Este material está em desenvolvimento contínuo. Se algo estiver faltando, confuso ou desatualizado, avise a comunidade ou contribua com uma melhoria.
Sobre o projeto Franzininho
O projeto Franzininho nasceu para incentivar e capacitar pessoas no Brasil a criarem seus próprios projetos eletrônicos com sistemas embarcados, IoT e tecnologias abertas.
Buscamos tornar o estudo dessas tecnologias mais acessível por meio de placas de desenvolvimento, kits educacionais, materiais didáticos, ferramentas, exemplos práticos e uma comunidade colaborativa.
O projeto se apoia em cinco pilares:
- Software e hardware open source;
- Materiais didáticos abertos;
- Comunidade;
- Compartilhamento de conhecimento;
- Colaboração.
Por onde começar?
Hoje, os principais materiais em desenvolvimento e as placas em destaque no ecossistema Franzininho são:
| Placa | Melhor para | Comece por aqui |
|---|---|---|
| Franzininho WiFi | Aprender IoT, conectividade, ESP32-S2 e diferentes ambientes de programação | Conhecer a Franzininho WiFi |
| Franzininho WiFi LAB01 | Oficinas, laboratórios, experimentação rápida com sensores, atuadores e interfaces integradas | Conhecer a Franzininho WiFi LAB01 |
| Franzininho C0 | Estudar microcontroladores STM32, programação embarcada e prototipagem com ARM Cortex-M0+ | Conhecer a Franzininho C0 |
Se você ainda está escolhendo por onde entrar, a Franzininho WiFi é um ótimo ponto de partida geral. A LAB01 é indicada quando você quer explorar vários recursos de hardware sem montar muitos circuitos externos. A Franzininho C0 é uma boa escolha para quem quer aprender o ecossistema STM32.
Outros caminhos disponíveis na documentação:
| Se você quer... | Comece por aqui |
|---|---|
| Simular projetos antes de usar a placa física | Franzininho WiFi no Wokwi |
| Montar sua própria placa e aprender soldagem | Franzininho DIY |
| Criar atividades criativas com Scratch e objetos do dia a dia | FranzMakey |
| Explorar kits, badges e materiais educacionais | Veja as categorias na barra lateral da documentação |
Primeiros passos recomendados
- Escolha a placa ou kit que você tem em mãos.
- Abra a página principal dessa placa para conhecer recursos, pinagem, alimentação e formas de programação.
- Siga o primeiro tutorial da tecnologia que você quer usar, como Arduino, MicroPython, CircuitPython, ESP-IDF ou STM32CubeIDE.
- Faça um exemplo simples, como piscar um LED, ler um botão ou testar uma entrada e saída digital.
- Quando travar, consulte a comunidade. Muitas dúvidas comuns aparecem durante instalação, configuração de ambiente e upload do primeiro código.
Você também pode começar por simuladores, como o Wokwi, quando disponíveis. Eles ajudam a testar ideias e entender a lógica dos projetos antes de montar o circuito físico.
O que você encontra nesta documentação?
- Apresentação das placas e kits do ecossistema Franzininho;
- Pinouts, esquemáticos, recursos de hardware e informações de alimentação;
- Guias de instalação e configuração de ferramentas;
- Exemplos de programação com Arduino, MicroPython, CircuitPython, ESP-IDF, AVR Libc e STM32CubeIDE;
- Materiais para oficinas, atividades educacionais e projetos práticos;
- Links para repositórios, arquivos de hardware e recursos complementares.
Precisa de ajuda?
Se você não encontrou o que procurava ou ficou com dúvida em algum passo, participe da comunidade:
Participe da Comunidade
Ao pedir ajuda, tente enviar:
- Qual placa ou kit você está usando;
- Qual tutorial está seguindo;
- Qual sistema operacional usa;
- Qual erro apareceu, se houver;
- Uma foto da montagem ou uma captura de tela da mensagem de erro.
Essas informações ajudam outras pessoas a entenderem o problema mais rápido.
Como contribuir?
Você pode contribuir de várias formas:
- Solicitar novos tutoriais e exemplos pela área de Issues do GitHub;
- Sugerir correções, melhorias de texto ou atualização de links;
- Compartilhar exemplos, projetos e materiais de oficina;
- Conversar na comunidade no Discord, especialmente nos canais relacionados à documentação.
Caso você não tenha familiaridade com GitHub, também pode enviar seu material por este formulário. Ele possui um modelo para ajudar na criação do conteúdo.
Contato
Esta obra está licenciada com uma Licença Creative Commons Atribuição-CompartilhaIgual 4.0 Internacional.