Easyduino

# Easyduino: Repository of Open Source PCB Devboards for KiCad

The Easyduino project is an effort to easily dive into different PCB designs of the most popular microcontroller devboards like **Arduino, ESP32, Raspberry Pico and STM32 Bluepill** (more to come!). Using the free and Open Source Software [KiCad](https://www.kicad.org/) and adhering the best practices across the PCB and KiCad ecosystem. Also adding the much needed USB-C support!

All the boards have been sent to production, tested, and verified to ensure everything works correctly.

<p align="center">
    <img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Isometric%20Photos/Collage_easyduino.jpg" width="60%">
</p>

The project was born out of the necessity to unify the wide variety of software, languages and conventions used in the most popular devboards. For example Arduino Uno was developed in 2010, Italy, using Eagle. The ESP32 devboard was developed in 2016, China, using Altium. The Raspberry Pi Pico 2040 was developed around 2021 in the U.K. using KiCad and Altium...

## Available Development Boards 

[Easyduino UNO](https://github.com/Hanqaqa/Easyduino/tree/master/Atmega328p%20Arduino%20Uno) | [Easyduino Nano](https://github.com/Hanqaqa/Easyduino/tree/master/Atmega328p%20Arduino%20Nano) | [Easyduino ESP32](https://github.com/Hanqaqa/Easyduino/tree/master/ESP32) |
---|---|---|
[<img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Miniatures/UNO.jpg">](https://github.com/Hanqaqa/Easyduino/tree/master/Atmega328p%20Arduino%20Uno) | [<img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Miniatures/Nano.jpg">](https://github.com/Hanqaqa/Easyduino/tree/master/Atmega328p%20Arduino%20Nano) | [<img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Miniatures/ESP32.jpg">](https://github.com/Hanqaqa/Easyduino/tree/master/ESP32) | 

[Easyduino ESP32 S3](https://github.com/Hanqaqa/Easyduino/tree/master/ESP32S3) | [Easyduino Pi Pico](https://github.com/Hanqaqa/Easyduino/tree/master/Raspberry%20Pi%20Pico%202040) | [Easyduino Bluepill STM32F103](https://github.com/Hanqaqa/Easyduino/tree/master/STM32F103%20Bluepill)
---|---|---|
[<img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Miniatures/ESP32S3.jpg">](https://github.com/Hanqaqa/Easyduino/tree/master/ESP32S3) | [<img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Miniatures/Raspberry.jpg">](https://github.com/Hanqaqa/Easyduino/tree/master/Raspberry%20Pi%20Pico%202040) | [<img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Miniatures/STM32F103.jpg">](https://github.com/Hanqaqa/Easyduino/tree/master/STM32F103%20Bluepill)

[Easyduino Pi Pico 2](https://github.com/Hanqaqa/Easyduino/tree/master/PiPico2) | [Easyduino Pi Pico 2 2354B](https://github.com/Hanqaqa/Easyduino/tree/master/PiPico22354B) | [Easyduino nrf52840 dongle](https://github.com/Hanqaqa/Easyduino/tree/master/nrf52840dongle)
---|---|---|
[<img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Miniatures/InProgress.jpg">](https://github.com/Hanqaqa/Easyduino/tree/master/PiPico2) | [<img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Miniatures/InProgress.jpg">](https://github.com/Hanqaqa/Easyduino/tree/master/PiPico22354B) | [<img src="https://github.com/Hanqaqa/Easyduino/blob/master/Assets/Miniatures/InProgress.jpg">](https://github.com/Hanqaqa/Easyduino/tree/master/nrf52840dongle)

The outline, pinout, layout and components have been tried to be replicated with respect to the originals, in all of the boards. With various levels of success. 

Some boards, like the Raspberry Pi Pico use 01005 components which are too expensive for the manufacturer to integrate in the PCB Aseembly line. Some other components like the original Arduino UNO USB to Serial converter, an Atmega16u2, were hard to come by during the development of this project ~January 2023, so more readily available options were chosen. All the differences with the original boards are explained inside the folder of each project in a readme file. 

4 layers of copper have been used in all projects to simplify the wiring and improve overall signal integrity. The additional layers provide better reference planes, lower return-path impedance, reduced crosstalk, and improved high-frequency performance. Specifically the [JLC04161H-7628](https://jlcpcb.com/impedance) stackup. 

The PCB constraints of the manufacturer JLCPCB are explained [here](https://github.com/Hanqaqa/Easyduino/tree/master/Assets/JLCPCB%20Constraints)

## Structure of each project

Each project consists of: 
- Main KiCad files (.kicad_pro, .kicad_sch...)
- A readme explaining the specifics of that project
- xxx.pretty or xxxlibraries folder which contains the non standard footprints or schematic parts used in the project (Some projects such as the Arduino UNO only use standard libraries, therefore these folders don't exist)
- The **Outputs** folder: Contains all the data produced by the KiCad Jobset like Gerbers, STEPs, PDFs, ERC, BOM, CPLs... Most of these are then copied, organized, and placed into their respective `ProductionFiles` folders.
- The ***ProductionFiles*** folder which includes files such as:
    - BOM: This folder contains both the list of components and the Centroid File in JLCPCB readable format. The CPL .csv file needs a small tweak at the beginning of the file in order to be readable. I mention it [here](https://github.com/Hanqaqa/Easyduino/tree/master/Assets/JLCPCB%20Constraints#cpl-component-placement-list).
    - ***Datasheets***: all the datasheets of the main components used in the project. Datasheets of easily replaceable components such as Resistors, Capacitors and LEDs are not given
    - Gerbers: A zip file with all of the manufacturing gerber files such as Copper/Mask/Silkscreen layers
    - PDFs: PDF and PNG files of the Schematic and PCB
    - Photos: Some photos of the manufactured PCB as well as some renders

## Using the project

1. Install the latest version of [KiCad](https://www.kicad.org/)
2. If you already have KiCad installed, click the upper right button in this github page `<>Code`, click `Download ZIP`, extract the files in your desired folder. If you know how to use git, clone the repository
3. Double click on the xxx.kicad_pro file inside any project and KiCad will start

This project was developed using KiCad v8.0.0, but has been updated and tested with KiCad v10. Including the creation of Jobsets which massively simplfies creating gerbers and BOMs. 

Since this is a collection of projects, the new KiCad v10 Git utilities don't work properly with each project, forcing you to git add the whole project if you want to make a change.

If you'd rather just consult the schematics or the gerbers. They are located inside the **ProductionFiles** folder of each project. Inside the **PDFs** and **Gerber** folders.

## Contributing

If you spot any mistakes inside any of the projects. Either open an issue and I will try to correct it or fork and merge the correction. 

If you plan on developing any other development boards and wish to merge into the project. Please try to use the same style and conventions as the original ones in the schematic. Positive voltages facing up, text being clearly readable, a references page, similar folder structure.

To do list:

- [ ] ~~Order and test the v1.1 RP2040 board. (In v1.0 I mixed some pins in the Flash and couldn't boot up). Ordered. Awaiting arrival. v1.1 is working correctly. Need to update photos and repo. Order v1.2 with Silkscreen text for BOOTSEL and RESET. Once received test and make photos.~~ RP2040 working correctly!
- [ ] ~~Order and test the v1.1 ESP32S3 board. (In v1.0 I forgot to add PullUp and PullDown in RST and SUSPEND CP2102). Ordered. Awaiting arrival. TX and RX signals going into CP2102 were mixed. Fix it and order v1.2. Once received test and make photos.~~ ESP32S3 working correctly!
- [ ] Developing: nRF52840 Dongle, RP2350A (Pi Pico 2), and Pi Pico 2 2354B with extra functionalities. Estimated time of production August 2026.
- [ ] Investigate other possible microcontrollers/SOCs/FPGAs to implement.

## Acknowledgments

Thanks to [winsrrow](https://github.com/winsrrow) for providing lots of KiCad tips and designing from the ground up the v1.1 RP2040 board.

## Licensing

This project is distributed under the [**CERN Open Hardware Licence Version 2 - Permissive**](https://github.com/Hanqaqa/Easyduino/blob/master/License.txt) which means **you are free to use any or all parts of this project with or without disclosing the source**, even for comercial projects. As long as you include a copy of the CERN OHLv2 Permissive Licence.