Skip to the content
4 layers128.7 × 63.9 mmHexControllerV3, the printed circuit board in 3D

HexControllerV3

TH4R4V3N1324/Hexapod

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

Size
128.7 × 63.9 mm
Copper layers
4
Thickness
1.6 mm
Parts
49
Nets
84
Pads
300
Tracks, vias
509, 103
Pours
10
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
10 Jun 2024
Updated
5 May 2026

Overview

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.

Main components

7

README

README.md

Hexapod

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.


Table of Contents


About

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.


Features

  • 3 DOF per leg
  • Inverse Kinematic engine for stable gait control
  • Multiple gait patterns: tripod, ripple, wave
  • Multiple control modes: normal, strafe, tilt
  • Real-time control via Pimironi Servo2040
  • Wireless control using custom controller and EspNOW protocol
  • STL files for 3D-printing mechanical components

Installation

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.

bash
git clone https://github.com/TH4R4V3N1324/Hexapod.git

Hexapod

Before getting started, make sure you have the following installed:

Prerequisites
Dependencies

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.

image

A selection box will appear at the top of the screen. From the list, choose the appropriate Pico compiler.

image

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.

image

Receiver & Controller

Prerequisites
Dependencies

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.

image

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.

image

Usage

Explain how to use the project. Provide code snippets, screenshots, or examples as helpful.

Ideas:

Use ROS2 for control

image image

Package Structure

1. hexapod_description (URDF/Configuration)

  • Robot URDF model with leg geometry
  • Joint limits and physical parameters
  • Launch files for simulation and hardware

2. hexapod_hardware_interface (Hardware Layer)

Servo Controller Node: Interfaces with PCA9685 or direct PWM
  • Subscribes to: /joint_commands (JointState)
  • Publishes: /joint_states (JointState with feedback)
  • Service: /emergency_stop
Sensor Manager Node: Aggregates all sensor data
  • Publishes: /imu/data (sensor_msgs/Imu)
  • Publishes: /power/status (custom PowerStatus msg)
  • Publishes: /leg_contact (custom LegContactArray msg)

3. hexapod_kinematics (Computation Layer)

IK/FK Solver Node: Your Calculate class logic
  • Service: /ik_solve (Vector3 → JointAngles)
  • Service: /fk_solve (JointAngles → Vector3)
  • Subscribes to: /joint_states (JointState)
  • Publishes: /leg_poses (geometry_msgs/PoseArray

4. hexapod_gait_controller (Motion Planning)

Gait Generator Node: Your Animation/Move logic
  • Subscribes to: /cmd_vel (Twist for velocity commands)
  • Subscribes to: /gait_mode (String: tripod/ripple/wave)
  • Publishes: /leg_trajectories (trajectory_msgs/JointTrajectory)
  • Action Server: /execute_gait for complex movements

5. hexapod_control (High-Level Control)

Behavior Manager Node: State machine (Normal/Strafe/Tilt/Config)
  • Subscribes to: /mode_command (custom ModeCommand)
  • Subscribes to: /joystick (sensor_msgs/Joy)
  • Publishes: /cmd_vel (Twist)
  • Service: /set_height, /home_stance
Config Manager Node: Servo offset calibration
  • Reads/writes to parameter server
  • Service: /save_config, /load_config

6. hexapod_teleop (User Interface)

Joystick Node: Replaces your ESP-NOW controller
  • Uses joy_node from ROS2
  • Publishes: /joystick (sensor_msgs/Joy)
Web Interface Node: Optional dashboard
  • rqt plugins or custom web interface
  • Monitor battery, IMU, leg contact

Use Isaac sim for simulation

Parts

49
QtyValueFootprintReferences
4SW_DIP_x01SamacSys_Parts:DTS62NVSW2, SW3, SW4, SW5
3100nFSamacSys_Parts:CAPC2012X95NC1, C4, C6
3100nFCapacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolderC7, C15, C16
322uFCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC20, C21, C22
2100RResistor_SMD:R_0805_2012MetricR2, R6
210uFCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC17, C18
24.7KResistor_SMD:R_0805_2012MetricR9, R10
25.1kResistor_SMD:R_0805_2012MetricR3, R4
2BatteryConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ2, J7
2COM-16273SamacSys_Parts:COM16273VR1, VR2
2KMR731NGButton_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2S1, S2
11.5uHSamacSys_Parts:XAL40XXL2
1100nFCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC19
110kResistor_SMD:R_0805_2012MetricR1
1180KResistor_SMD:R_0603_1608MetricR12
11MResistor_SMD:R_0603_1608MetricR11
11kResistor_SMD:R_0805_2012MetricR5
11uFSamacSys_Parts:CAPC2012X135NC5
122uFSamacSys_Parts:CAPC2012X140NC3
1BMI330SamacSys_Parts:BMI330U4
1Conn_01x06Connector_PinHeader_2.54mm:PinHeader_2x04_P2.54mm_VerticalJ8
1DMG9926UDMPackage_TO_SOT_SMD:SOT-23-6Q1
1DW01APackage_TO_SOT_SMD:SOT-23-6U2
1ESP32-S2-MINI-1-N4R2SamacSys_Parts:ESP32S2MINI1N4R2IC1
1INA260Package_SO:TSSOP-16_4.4x5mm_P0.65mmU3
1RotaryEncoder_SwitchSamacSys_Parts:PEC11L4120FS0020SW1
1Switch1Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ3
1Switch2Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ4
1Switch3Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ5
1Switch4Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ6
1TPS63020DSJRSamacSys_Parts:TPS63020DSJRIC3
1USB_C_Receptacle_USB2.0_16PConnector_USB:USB_C_Receptacle_GCT_USB4105-xx-A_16P_TopMnt_HorizontalJ1
1~Hexapod:WaveShare_2.42inch_SSD1309_OLEDU1

More from TH4R4V3N1324/Hexapod

1
  • 2 layersHexapod, the printed circuit board in 3D

    Hexapod

    TH4R4V3N1324/Hexapod

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

    15 parts

Similar boards

  • 4 layers140.7 × 77.4 mmHexControllerV3 larger, the printed circuit board in 3D

    HexControllerV3 larger

    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…

    48 parts
  • 4 layers83 × 120 mmJd2oscope, the printed circuit board in 3D

    Jd2oscope

    Niftion/jd2oscope

    2CH 1MS/s, 12-Bit, 50kHz Oscope (5V) w/320x240 TFT & ESP32

    61 parts
  • 4 layers74 × 44 mmMotorkit display, the printed circuit board in 3D

    Motorkit display

    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…

    37 parts
  • 2 layers49.4 × 95.7 mmPhysiowand, the printed circuit board in 3D

    Physiowand

    1tsMS/Physiowand

    91 parts
  • 2 layers80 × 129.1 mmSmart Plant, the printed circuit board in 3D

    Smart Plant

    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…

    75 parts303
  • 2 layers50.8 × 22.9 mmMinimain esp32-s2, the printed circuit board in 3D

    Minimain esp32-s2

    DepartmentOfAlchemy/minimain-esp32-s2

    PCB files for the MiniMain ESP32-S2 in an Adafruit Feather compatible format.

    39 parts4
  • 2 layers35.1 × 28.9 mmBms buck boost, the printed circuit board in 3D

    Bms buck boost

    tor1kk/bms-buck-boost

    Battery Management System (BMS) with Buck-Boost Converter

    38 parts10GPL-3.0
  • 4 layers89 × 81 mmDKWS PCB, the printed circuit board in 3D

    DKWS PCB

    danielkluka/Diploma-Thesis

    Design of a Secure Data Transmission System in NB-IoT Environment

    121 partsMIT

Questions

How big is the HexControllerV3 PCB?

It measures 128.7 × 63.9 mm and has 4 copper layers, 1.6 mm thick.

What parts does the HexControllerV3 use?

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.

Where can I download the HexControllerV3 KiCad files?

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.

Can I use the HexControllerV3 design in my own project?

Its repository states no licence, so its author keeps all rights: ask TH4R4V3N1324 before reusing the design.