

Mainboard V1
The project focuses on the software for the Dezibot4 robot and its use in the classroom. It includes libraries for use by students as well as guides for teachers. The hardware of the robot is not part of the project.
- Size
- 100 × 81 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 33
- Nets
- 65
- Pads
- 136
- Tracks, vias
- 170, 3
- Pours
- 10
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 2 Jul 2024
- Updated
- 18 Oct 2026
Overview
Mainboard V1 is an open-source printed circuit board by dezibot, from the dezibot/dezibot repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 100 × 81 mm with 33 parts on 65 nets, routed with 170 tracks and 3 vias.
It is built around the ESP32-WROOM-32 and DRV8834PWP. Its parts include 21 resistors, 4 connectors, 3 capacitors and 3 ICs. It belongs with the computers and single-board computers boards and the ESP32 boards of this library.
Main components
2ESP32-WROOM-32
SMD,18x25.5mm-40℃~+85℃ -98dBm 2.4GHz 2.7V~3.6V 20dBm Bluetooth4.2 ESP32-DOWDQ6 UART、SDIO、SPI、I2C、GPIO、PWM、ADC、DAC SMD,25.5x18mm WiFi Modules ROHSEspressif SystemsWiFi ModulesDRV8834PWP
HTSSOP-24-EPOvercurrent Protection、Over temperature protection、Under-voltage lockout、Motor step-out prevention function HTSSOP-24-EP Stepper Motor Driver ROHSTexas InstrumentsStepper Motor Driver
README
README.mdDezibot4 Lib
Links to external documentation
Link to Software
Introduction
The project focuses on the software for the Dezibot4 robot and its use in the classroom.
It includes libraries for use by students as well as guides for teachers. The hardware of the robot is not part of the project.
The libraries and example programs are available under the GPL and are accessible as a repository.
It is ment to serve as an Arduino-Library.
Therefore the rules for arduinolibrary develop apply:
In the following the most important points and custom conventions are introduced.
Code Conventions
Don't pass reference
To allow easy usability for users not familier with C++, prevent passing around references. It is better to use accessmethods
Naming
- methods are named in lowerCamelCase
- classes are named in UpperCamelCase
- folders containing components are named in lowerCamelCase
- methods are named in lowerCamelCase
- constants are named in ALL_CAPS_SNAKE_CASE
Bytestream
Every class that implements Byte-Based Communication needs to implement the Arduino Streaminterface
Components
Every component has a single .h file and one or more .cpp files.
Every component is placed in a seperate folder under src/ that is named equvivalent to the class.
The minimal structure of any .h file is
#ifndef ClassName_h
#define ClassName_h
class ClassName{
};
#endif //ClassName_hDesign Paradigm
During desgin, the Dezibot isn't describe using it's part but instead it's functionality. Under the top-level Dezibotclass, there is a class for every functionality of the robot. Each of that classes consists of two parts.
Part Instances
Each component contains instances of every Robotpart that is used in that component. For example the Motion component contains two motorinstances, one for motorEast and one for motorWest. Using these instances, it is possible to access more specific methods that interacts directly with the component ( configure it, setSpeed,...)
Abstractions
The components constains abstractions that combines multiple partMethods to ease the usability. For example for the motioncomponent provides an abstraction for the forwardmovement, that involves two motors and even another component ( MotionDetection)
Contributing
When contributing to the project please follow the rules below. At first, follow all rules from this readme. Further rules apply to the usage of git
Branching
Whenever working on the project, create a new branch from the current state of Develop.
Branches should be named as prefix/#issueid-shortdescription where prefix is from {feature,fix,refactor}.
When a branch is ready to be used in production, create a mergerequest.
Mergerequests
The target of each Mergerequest must be the Develop-Branch. Before the merge, each request must be approved by at least
one person with Owner role.
The approve process should consider especially the documentation, naming, implementation.
When the merge is approved and no more commits are added, the last commit must increment the versionnumber in the
library.properties file, following the rules of Semantic Versioning
Commitmessages
Commitmessages must follow the gitchangelog pattern.
Language
The language of the project is American English. That includes in particular but not exclusively:
- Sourcecode
- Commit Messages
- Documentation
A german documentation will be provided but does not replace the english documentation.
Documentation
Documentation of the Software and Hardware can be found at https://docs.dezibot.de/
.h Files
/**
* @file Dezibot.h
* @author your name (you@domain.com)
* @brief
* @date 2023-11-19
*
* @copyright Copyright (c) 2023
*
*/In the library, the .h files should be included using a relative path.
For instance, in src/Dezibot.h, to include src/motion/Motion.h, you should write #include "motion/Motion.h".
Methods
/**
* @brief
* @param
* ...
* @return
*
*/Arduino Settings
- Board: "ESP32-S3-USB-OTG"
- Upload Mode: "UART0 / Hardware CDC"
- USB Mode: "Hardware CDC and JTAG"
- Programmer: "Esptool"
Using arduino-cli to compile and upload:
arduino-cli upload /Users/jo/Documents/Arduino/theSketch -p /dev/cu.usbmodem101 -b esp32:esp32:nora_w10
arduino-cli compile /Users/jo/Documents/Arduino/theSketch -p /dev/cu.usbmodem101 -b esp32:esp32:nora_w10
Including Library
Arduino IDE -> Sketch -> Include Library -> add .ZIP Library -> this library
If there is any other error like 'Painless_Mesh' not found, you have to include this library also.
Arduino IDE -> Sketch -> Manage Library -> Search for missing Library
Start from Scratch
It is important, before using any functions of Dezibot, to call dezibot.begin() once in the setup function.
In the examples folder, a sketch start is provided, that handles the initialization.
Third-Party Licenses
This project uses the following third-party libraries:
veml6040(version 0.3.2) by @thewknd et al.- Vishay VEML6040 RGBW color sensor library for Arduino
- Licensed under the MIT license
- For more information, see the library's repository
Parts
33| Qty | Value | Footprint | References |
|---|---|---|---|
| 21 | 1k | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_Horizontal | R101, R102, R103, R104, R105, R106, R107, R108, R116, R117, R118, R201, R202, R203, R204, R205 +5 |
| 3 | 100uF | Capacitor_THT:CP_Radial_D4.0mm_P1.50mm | C101, C201, C202 |
| 2 | DRV8834 | Mainboard:Polulu_DRV8834 | U201, U202 |
| 2 | Stepper_Motor_unipolar_6pin | Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_Vertical | Mr201, Mr202 |
| 2 | ~ | Mainboard:PogoPin | J102, J103 |
| 1 | Conn_01x04_Pin | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Vertical | J104 |
| 1 | Conn_01x08_Pin | Connector_PinHeader_2.54mm:PinHeader_1x08_P2.54mm_Vertical | J107 |
| 1 | ESP32-WROOM-32 | Mainboard:diymore-ESP32-WROOM-32-Devboard | U101 |
Similar boards
- 2 layers100 × 30 mm

- 4 layers80 × 40 mm

Tuner time
SG295/ece477_guitartuner
Automatic Guitar Tuner Project for ECE477 (Senior Design) @ Purdue University
112 parts2 - 2 layers88.4 × 46.1 mm

- 2 layers90.6 × 46.1 mm

- 4 layers185 × 58.6 mm

- 4 layers222.3 × 73.7 mm
/KiCAD/Bpod%20Controller%20v5.kicad_pcb.jpg?size=s&soon)
- 2 layers24.1 × 36.2 mm

Esp32miniBT
asterics/esp32_mouse_keyboard
ESP32 implementation for HID over GATT Keyboard and Mouse (Bluetooth Low Energy). Including serial API for external modules (similar to Adafruit EZKey HID)
28 parts911GPL-3.0 - 4 layers99.6 × 76.2 mm

Questions
How big is the Mainboard V1 PCB?
It measures 100 × 81 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Mainboard V1 use?
33 parts, built around the ESP32-WROOM-32 and DRV8834PWP. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Mainboard V1 KiCad files?
From the dezibot/dezibot repository on GitHub, at the commit this page was made from: the board is example/charging_station/Mainboard_V1/Mainboard_V1.kicad_pcb and its schematic example/charging_station/Mainboard_V1/Mainboard_V1.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Mainboard V1 design in my own project?
Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).