Skip to the content
2 layers115 × 129 mmMartha circuits, the printed circuit board in 3D

Eléctrica · Firmware · Modelo (URDF) · Materiales · Ver el robot

Size
115 × 129 mm
Copper layers
2
Thickness
1.6 mm
Parts
35
Nets
70
Pads
178
Tracks, vias
304, 1
Pours
119
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
4 Oct 2026
Updated
5 Nov 2026

Overview

Martha circuits is an open-source printed circuit board by AndesRobot-Oficial, from the AndesRobot-Oficial/Structure-Embedded-Systems_MATHA repository on GitHub. It is a 2-layer board of 115 × 129 mm with 35 parts on 70 nets, routed with 304 tracks and 1 via.

It is built around the LM339 and IRF4905. Its parts include 10 resistors, 6 ICs, 6 connectors, 4 diodes and 2 capacitors.

Main components

2

README

README.md

MARTHA — Estructura y sistemas embebidos. Del circuito al movimiento.

Eléctrica · Firmware · Modelo (URDF) · Materiales · Ver el robot

ROS 2 Humble ESP32 Ubuntu 22.04

Equipo de Estructura y Electrónica de AndesRobot · Colombia

Una base móvil, cuatro ruedas, un sistema integrado

MARTHA combina una base mecanum, control de motores con ESP32 y sensores conectados a ROS 2. Aquí está todo lo de Estructura: la electrónica, el firmware del ESP32, el modelo del robot (URDF) y los paquetes ROS de la base. Sigue el mismo orden que milo_ws (el workspace de Milo) y la arquitectura ROS 2 de AndesRobot: Estructura es dueña de los motores, los encoders, la IMU, la odometría (/base/odom), los botones, las luces y robot_state_publisher. La navegación está en el repo Navegation.

Estructura de aluminio y computador a bordo de MARTHAMapa y ruta de navegación de MARTHA en RViz
La plataforma física
Estructura, electrónica y cómputo a bordo.
El sistema en operación
Mapa y seguimiento de ruta en RViz.

La plataforma en cifras

Tracción y controlSensores y alimentación
4 ruedas mecanum · diámetro de 150 mmRPLIDAR A2M8 · medición del entorno (lo configura Navegación)
4 Pololu 4753 · motor nominal de 12 V, reducción 50:1MPU6050 · velocidad angular
4 Pololu 5285 · drivers MPQ6612ABatería documentada como 15 V · capacidad por confirmar
ESP32 DevKit/WROOM · control de la basePC a bordo · USB para ESP32 y LiDAR, ROS 2 Humble

Del comando al movimiento

mermaid
flowchart LR
    PC["PC · ROS 2"] -->|"Comando serial"| ESP["ESP32 · Control PI"]
    ESP -->|"PWM"| DRV["4 drivers · Pololu 5285"]
    DRV --> MOT["4 motores · Ruedas mecanum"]
    MOT -->|"Encoders"| ESP
    IMU["MPU6050"] --> ESP
    ESP -->|"Velocidades + giro Z"| PC
    LIDAR["RPLIDAR A2M8"] -->|"USB"| PC

El ESP32 controla las ruedas y reporta velocidades. El PC fusiona la odometría con la IMU (EKF) y recibe las mediciones del LiDAR. Hoy el PC y el ESP32 hablan por un protocolo serial propio (ver protocolo →); lo planeado es pasar a micro-ROS.


Contenido

  1. Instalar (una vez por computador)
  2. El modelo de Martha
  3. Martha física
  4. Todos los comandos
  5. Qué hay en el repo
  6. El contrato: lo que publica Estructura
  7. Estado y lo que falta

Lo de ROS corre dentro de Docker (Ubuntu 22.04 + ROS 2 Humble), así que funciona igual en cualquier Ubuntu. Tu código vive en tu PC (ros2_ws/) y el contenedor lo ve como /ros2_ws: editas en tu PC y compilas/corres dentro de Docker con ./sim.sh o ./robot.sh.


1. Instalar (una vez por computador)

Docker

bash
sudo apt update
sudo apt install -y docker.io docker-compose-v2 docker-buildx git x11-xserver-utils
sudo usermod -aG docker $USER

Después reinicia el computador (o cierra sesión y vuelve a entrar). Para ver si quedó bien:

bash
docker run --rm hello-world

Tiene que decir Hello from Docker!. Si dice permission denied, falta reiniciar.

Solo si tu computador tiene tarjeta NVIDIA (clic para ver)
bash
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt update
sudo apt install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

Sin esto igual funciona, pero RViz dibuja con la CPU.

El repo

Los dos repos de Martha van uno al lado del otro, en la misma carpeta:

bash
mkdir -p ~/AndesRobot && cd ~/AndesRobot
git clone https://github.com/AndesRobot-Oficial/Structure-Embedded-Systems_MATHA.git
git clone https://github.com/AndesRobot-Oficial/Navegation.git

La primera vez que corras ./sim.sh se demora harto (15-30 min): construye la imagen de Docker martha:humble y compila. Es la misma imagen del repo de Navegación: si ya la construiste allá, aquí parte en segundos.

Para el firmware (Arduino)

bash
curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=~/.local/bin sh
bash
arduino-cli core update-index --additional-urls https://espressif.github.io/arduino-esp32/package_esp32_index.json && arduino-cli core install esp32:esp32 --additional-urls https://espressif.github.io/arduino-esp32/package_esp32_index.json

Detalles en firmware.


2. El modelo de Martha

bash
cd ~/AndesRobot/Structure-Embedded-Systems_MATHA
./sim.sh

Abre RViz con el URDF de Martha tal como está construida: chasis, ruedas, LiDAR, IMU y la torre de aluminio. ./sim.sh mecanum muestra las ruedas con sus rodillos. Medidas, frames y argumentos en ROBOT.md.

El URDF vive aquí y Navegación tiene una copia para su simulación en Gazebo. Si lo cambias, copia la carpeta ros2_ws/src/andesrobot_description completa a ../Navegation/ros2_ws/src/ y haz el commit allá diciendo de qué commit de este repo viene.

Las pruebas del URDF (que se pueda expandir y que no tenga "dos puntos + espacio", que rompe ros2_control) corren con ./sim.sh pruebas.


3. Martha física

Puertos fijos para el ESP32 y el LiDAR (una vez, en el laptop de Martha)

El ESP32 y el RPLIDAR usan el mismo chip USB-serie y Linux los numera en cualquier orden. Las reglas de docker/udev les dan nombres fijos: /dev/martha_esp32 y /dev/martha_lidar. Para ver los números de serie: ./robot.sh puertos.

Cargar el firmware

Con el ESP32 conectado al PC (en el laptop de Martha o en el tuyo):

bash
arduino-cli compile --fqbn esp32:esp32:esp32doit-devkit-v1 firmware
bash
arduino-cli upload --fqbn esp32:esp32:esp32doit-devkit-v1 -p /dev/martha_esp32 firmware

Probar la base sin ROS

bash
./robot.sh serial

Es una terminal con el ESP32: al arrancar responde ready; escribe cmd_vel,0.1,0,0 y las ruedas avanzan (si no llega otro comando en 500 ms, se detienen); el ESP32 responde odom,vx,vy,wz,gz 50 veces por segundo. Salir: Ctrl+]. Hazlo con las ruedas en el aire y sigue la puesta en marcha.

Sin protecciones todavía: el divisor de batería y el comparador de sobrecorriente no están soldados, así que el firmware no detiene el robot con batería baja ni con un motor trabado.


4. Todos los comandos

Todos desde la carpeta del repo.

ComandoQué hace
./sim.shel modelo de Martha en RViz
./sim.sh mecanumigual, con las ruedas mecanum y sus rodillos
./sim.sh pruebaspruebas (pytest) de los paquetes ROS
./sim.sh shell / build / stopterminal en el contenedor / recompilar / apagar
./sim.sh cpu / software / gpusin NVIDIA / RViz negro / con qué tarjeta dibuja
./robot.sh(laptop de Martha) contenedor con acceso a los USB
./robot.sh puertoslos puertos USB conectados, para las reglas udev
./robot.sh serialterminal serial con el ESP32 (ESP32=/dev/ttyUSB0 sin udev)
./robot.sh shell / build / stopigual que en sim.sh, en modo robot

5. Qué hay en el repo

text
Structure-Embedded-Systems_MATHA/
├── sim.sh                     el modelo y las pruebas, en tu PC
├── robot.sh                   en el laptop de Martha (USB del ESP32 y del LiDAR)
├── docker/                    la imagen martha:humble (copia exacta de la de Navegación, salvo
│   │                          compose.yaml) y el micro-ROS agent
│   └── udev/                  nombres fijos /dev/martha_esp32 y /dev/martha_lidar
├── firmware/                  sketch del ESP32 (control PI, encoders, IMU, protocolo serial) y
│                              sketches de prueba para la puesta en marcha
├── docs/
│   ├── hardware/              todo lo físico
│   │   ├── electrica/         diagramas, pines y conexiones, presupuesto de potencia, revisión
│   │   ├── bom/               materiales y compras
│   │   ├── cad/               geometría y estado del diseño mecánico
│   │   └── pcb/               proyecto KiCad de la placa (esquemático, PCB, Gerbers) y su BOM
│   ├── integracion_ros2/      puente serial, EKF y LiDAR de la tesis (copias de referencia)
│   ├── evidencias/            fotos y videos del robot funcionando
│   ├── fuentes_tesis/         fragmentos LaTeX de la tesis
│   ├── puesta_en_marcha.md    comprobaciones antes de operar
│   └── estado_y_pendientes.md lo que falta y las diferencias entre fuentes
└── ros2_ws/src/
    └── andesrobot_description   URDF de Martha (Navegación tiene una copia)

6. El contrato: lo que publica Estructura

Navegación y Estructura se conectan solo por estos tópicos. Navegación nunca toca un motor.

InterfazTipoQuiénHoy
/cmd_velgeometry_msgs/Twist (linear.x, linear.y, angular.z)Navegación → Estructurael puente serial lo pasa al ESP32
/base/odom + TF odom → base_footprintnav_msgs/OdometryEstructuraEKF de ruedas + IMU (con los nombres de la tesis, falta pasarlos al contrato)
/base/imusensor_msgs/ImuEstructuragiro Z del MPU6050
/base/emergency_stop, /base/start_button, /base/set_led_stateEstructurafalta
/tf_static (URDF)Estructura (robot_state_publisher)andesrobot_description

Si /cmd_vel deja de llegar 0,5 s, la base se detiene (el firmware ya lo hace).


7. Estado y lo que falta

DisponiblePor completar
Firmware que funciona en el robot (c8faa84) y sketches de pruebaSoldar el divisor de batería y el comparador de sobrecorriente
Siete diagramas eléctricos, inventario, pines y conexionesCAD mecánico nativo
Proyecto KiCad de la PCB, Gerbers y BOM de la placaComprobar que los Gerbers (31/07/2026) correspondan al PCB editable
URDF de Martha tal como está construidaConsumos medidos y datos completos de batería
Fotografías e inventario de pruebas físicasPaquete andesrobot_bringup: la base en ROS con los nombres del contrato

Lo que viene en ROS, en este orden aproximado (como andesrobot_bringup y drivers/ de milo_ws):

  1. Firmware con micro-ROS: el ESP32 publica /base/imu y el estado de cada rueda.
  2. ros2_control en el laptop (topic_based_ros2_control + mecanum_drive_controller) → /base/wheel_odom; EKF (robot_localization) → /base/odom.
  3. Botón de emergencia, botón de inicio y luces con sus nodos.

Detalle en estado y pendientes.


Procedencia de los archivos · Cómo subir cambios

Parts

35
QtyValueFootprintReferences
6RResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR2, R3, R7, R8, R9, R10
4Conn_01x06My_Components:PinHeader_1x06_P2.54mm_Horizontal_MirroredJ1, J2, J3, J4
4LEDLED_THT:LED_D5.0mmD1, D2, D3, D4
4MountingHole_4.3mm_M4MountingHole:MountingHole_4.3mm_M4HEX M4, HEX M4, HEX M4, HEX M4
4~Pololu_Driver:MPQ6612AU1, U2, U3, U4
210nfCapacitor_THT:C_Disc_D5.0mm_W2.5mm_P2.50mmC1, C2
1100kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR4
110kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR6
139kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR5
147kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1
1BatteryMy_Components:DEANSJ5
1IMUConnector_PinHeader_2.54mm:PinHeader_1x08_P2.54mm_VerticalJ6
1IRF4905Package_TO_SOT_THT:TO-220-3_VerticalQ1
1LM339Package_DIP:DIP-14_W7.62mmU5
1SW_SPSTConnector_Wire:SolderWire-0.75sqmm_1x02_P4.8mm_D1.25mm_OD2.3mmSW1
1ViSEN ReferencePotentiometer_THT:Potentiometer_Bourns_3296W_VerticalRV1
1~ESP32_dev_module:ESP32_DevKit_30PinU0

Similar boards

  • 4 layers99.1 × 99.1 mmBldc controller, the printed circuit board in 3D

    Bldc controller

    aditelik/bldc_controller

    Brushless DC Motor Controller PCB Design for EE 91a Fall 2019

    184 parts
  • 2 layers316 × 119 mmTeensy Grovebox, the printed circuit board in 3D

    Teensy Grovebox

    jerry20091103/Teensy_Grovebox

    A portable synth and music multi-tool made with Teensy 4.1

    142 parts150MIT
  • 2 layers50.5 × 52 mmWellerRT Station projekt, the printed circuit board in 3D

    WellerRT Station projekt

    MarcelMG/DIY-Soldering-Station-Controller

    A soldering station controller compatible with Weller RT tips

    45 parts44MIT
  • 2 layers213.6 × 127.5 mmZuendbox v3 32, the printed circuit board in 3D

    Zuendbox v3 32

    fixxl/el-fueradoro

    Open source ignition-system for audio-fireworks

    205 parts10
  • 2 layers108 × 55 mmPower control pcb, the printed circuit board in 3D

    Power control pcb

    HacklabJKL/sergei_cnc2

    Second version of Hacklab's custom built CNC machine

    89 parts6
  • 2 layers120 × 100 mmMowercarrier, the printed circuit board in 3D

    Mowercarrier

    zohebzma2-cmyk/autonomous-mower

    Self-driving zero-turn mower retrofit — RTK GPS, LiDAR, cameras, on-device AI. Hardware + firmware + control software + parametric CAD.

    50 parts5
  • 2 layers77.2 × 50.3 mmDischarger, the printed circuit board in 3D

    Discharger

    Alan-JH/Batt-Discharger

    High current battery storage discharger for TJ UAV

    30 parts2
  • 2 layers80 × 53.6 mmPCB Pump, the printed circuit board in 3D

    PCB Pump

    im-alexis/Capstone-Project

    Team Members: Javier Padilla, Alexis Torres, Ian Skillman, Kiet Le, Evan LeBel, Jesus Hernandez, Jaime Sanchez, Rodrigo Romero

    35 parts2

Questions

How big is the Martha circuits PCB?

It measures 115 × 129 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Martha circuits use?

35 parts, built around the LM339 and IRF4905. 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 Martha circuits KiCad files?

From the AndesRobot-Oficial/Structure-Embedded-Systems_MATHA repository on GitHub, at the commit this page was made from: the board is docs/hardware/pcb/diseno/martha_circuits/martha_circuits.kicad_pcb and its schematic docs/hardware/pcb/diseno/martha_circuits/martha_circuits.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Martha circuits design in my own project?

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