
Hexapod
TH4R4V3N1324/Hexapod
This repository contains the complete design, control software and documentation for a six-legged walking robot (hexapod).

This repository contains the complete design, control software and documentation for a six-legged walking robot (hexapod).
HexControllerV3 is an open-source printed circuit board by TH4R4V3N1324, from the TH4R4V3N1324/Hexapod repository on GitHub. It is a 4-layer board of 128.7 × 63.9 mm with 49 parts on 84 nets, routed with 509 tracks and 103 vias.
It is built around the ESP32-S2-MINI-1-N4R2, TPS63020DSJR and BMI330, with the DW01A, COM-16273 and KMR731NGLFS among its other parts. Its parts include 14 capacitors, 10 resistors, 8 connectors, 7 switches and 6 ICs. It belongs with the ESP32 boards of this library.
This repository contains the complete design, control software and documentation for a six-legged walking robot (hexapod). The project combines robotics, kinematics, embedded systems, and motion planning to create a stable and adaptable walking platform.
This project was developed to address the growing complexity in robotic control systems, where tightly coupled codebases often hinder scalability, debugging, and long-term maintainability. It is designed for developers, researchers, or engineers working with robotic platforms or automation systems who require a clean, extensible control framework that’s easy to understand and build upon.
The primary goal of the project was to emphasize modularity, ensuring that each component of the control software is clearly separated by function and responsibility. This modular design allows developers to quickly comprehend the structure of the system, make targeted changes without unintended side effects, and expand the system by adding new features or improving existing ones without rewriting the entire codebase.
To achieve this, the software is structured around a set of well-defined classes, each serving a distinct role:
DataPacket Class: Acts as a container for incoming or outgoing data, ensuring that all communication between system components remains consistent, structured, and easily interpretable.
Calculate Class: Handles all mathematical and logical computations required by the system, such as sensor data interpretation, decision-making algorithms, or movement planning.
Move Class: Directly interfaces with the actuators or motors, translating high-level commands into specific movement instructions. It abstracts the hardware layer, allowing for easier adaptation across different platforms.
Animation Class: Manages co-ordination of legs using the various gaits and modes to create walking and animation.
Describe how to get your project running locally. Include prerequisites, dependencies, and step-by-step instructions.
Clone the repository into the desired location using the git bash terminal.
git clone https://github.com/TH4R4V3N1324/Hexapod.gitBefore getting started, make sure you have the following installed:
Using the Raspberry Pi Pico VSCode extension, import the Hexapod sub-folder by selecting it in the Location tab, enabling CMake-Tools and clicking Import.
A selection box will appear at the top of the screen. From the list, choose the appropriate Pico compiler.
Once imported, you can build the project by selecting Compile Project from the Pico extension commands. This will generate a .uf2 firmware file inside the build directory.
To flash the firmware to the Pimoroni Servo 2040, put the board into BOOTSEL mode (by holding the BOOT button and pressing RESET), then copy the .uf2 file to the mounted USB storage.
Alternatively, you can enter BOOTSEL mode first, then simply use the Run Project command. This will automatically build and flash the firmware to the board, no manual file transfer required.
Using the PlatformIO extension in VS Code, select the Open option under the Quick Access panel to launch the PlatformIO Home page. From there, click Open Project and navigate to the appropriate sub-folder to import your project.
To build or upload the project to your ESP32 board, use the Build or Upload options available under the Project Tasks panel in the PlatformIO extension.
Explain how to use the project. Provide code snippets, screenshots, or examples as helpful.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 4 | SW_DIP_x01 | SamacSys_Parts:DTS62NV | SW2, SW3, SW4, SW5 |
| 3 | 100nF | SamacSys_Parts:CAPC2012X95N | C1, C4, C6 |
| 3 | 100nF | Capacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolder | C7, C15, C16 |
| 3 | 22uF | Capacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolder | C20, C21, C22 |
| 2 | 100R | Resistor_SMD:R_0805_2012Metric | R2, R6 |
| 2 | 10uF | Capacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolder | C17, C18 |
| 2 | 4.7K | Resistor_SMD:R_0805_2012Metric | R9, R10 |
| 2 | 5.1k | Resistor_SMD:R_0805_2012Metric | R3, R4 |
| 2 | Battery | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J2, J7 |
| 2 | COM-16273 | SamacSys_Parts:COM16273 | VR1, VR2 |
| 2 | KMR731NG | Button_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2 | S1, S2 |
| 1 | 1.5uH | SamacSys_Parts:XAL40XX | L2 |
| 1 | 100nF | Capacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolder | C19 |
| 1 | 10k | Resistor_SMD:R_0805_2012Metric | R1 |
| 1 | 180K | Resistor_SMD:R_0603_1608Metric | R12 |
| 1 | 1M | Resistor_SMD:R_0603_1608Metric | R11 |
| 1 | 1k | Resistor_SMD:R_0805_2012Metric | R5 |
| 1 | 1uF | SamacSys_Parts:CAPC2012X135N | C5 |
| 1 | 22uF | SamacSys_Parts:CAPC2012X140N | C3 |
| 1 | BMI330 | SamacSys_Parts:BMI330 | U4 |
| 1 | Conn_01x06 | Connector_PinHeader_2.54mm:PinHeader_2x04_P2.54mm_Vertical | J8 |
| 1 | DMG9926UDM | Package_TO_SOT_SMD:SOT-23-6 | Q1 |
| 1 | DW01A | Package_TO_SOT_SMD:SOT-23-6 | U2 |
| 1 | ESP32-S2-MINI-1-N4R2 | SamacSys_Parts:ESP32S2MINI1N4R2 | IC1 |
| 1 | INA260 | Package_SO:TSSOP-16_4.4x5mm_P0.65mm | U3 |
| 1 | RotaryEncoder_Switch | SamacSys_Parts:PEC11L4120FS0020 | SW1 |
| 1 | Switch1 | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J3 |
| 1 | Switch2 | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J4 |
| 1 | Switch3 | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J5 |
| 1 | Switch4 | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J6 |
| 1 | TPS63020DSJR | SamacSys_Parts:TPS63020DSJR | IC3 |
| 1 | USB_C_Receptacle_USB2.0_16P | Connector_USB:USB_C_Receptacle_GCT_USB4105-xx-A_16P_TopMnt_Horizontal | J1 |
| 1 | ~ | Hexapod:WaveShare_2.42inch_SSD1309_OLED | U1 |

TH4R4V3N1324/Hexapod
This repository contains the complete design, control software and documentation for a six-legged walking robot (hexapod).

TH4R4V3N1324/hexapod-controller
Embedded firmware and hardware-support code for a hexapod robot controller. The repository contains firmware for the handheld/controller interface, an ESP32 wireless receiver, ATtiny1616 left and right boards, and a…


S0L1DDEV/motormod-pcb-display
CFMoto lightkit mod, driving a lightkit based on engine information read through CAN. This PCB is part of the system responsible for driving a very basic user interface that allows for top level control of the light…


JGAguado/Smart_Plant
The Smart Plant is a board that can be plugged directly on the soil, close to the plant, that allows the measurement of the environment (soil moisture, environment temperature & illuminance), and presents the…

DepartmentOfAlchemy/minimain-esp32-s2
PCB files for the MiniMain ESP32-S2 in an Adafruit Feather compatible format.

tor1kk/bms-buck-boost
Battery Management System (BMS) with Buck-Boost Converter

danielkluka/Diploma-Thesis
Design of a Secure Data Transmission System in NB-IoT Environment
It measures 128.7 × 63.9 mm and has 4 copper layers, 1.6 mm thick.
49 parts, built around the ESP32-S2-MINI-1-N4R2, TPS63020DSJR, BMI330 and DW01A. 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.
From the TH4R4V3N1324/Hexapod repository on GitHub, at the commit this page was made from: the board is controller/controller/schematic/hexControllerV3/hexControllerV3.kicad_pcb and its schematic controller/controller/schematic/hexControllerV3/hexControllerV3.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask TH4R4V3N1324 before reusing the design.