Skip to the content
2 layers50 × 34 mmMT Core, the printed circuit board in 3D

Los parámetros principales se pueden ajustar en:

Size
50 × 34 mm
Copper layers
2
Thickness
1.6 mm
Parts
19
Nets
27
Pads
84
Tracks, vias
534, 67
Pours
17
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
26 Oct 2025
Updated
28 Oct 2025

Overview

MT Core is an open-source printed circuit board by MictlanTeam, from the MictlanTeam/Ehecatl repository on GitHub, published under the MIT licence. It is a 2-layer board of 50 × 34 mm with 19 parts on 27 nets, routed with 534 tracks and 67 vias.

Its parts include 4 connectors and 3 diodes. It belongs with the ESP32 boards of this library.

README

README.md

EHECATL - Line Follower Racing Robot

License Platform Language

EHECATL (pronunciado "Ehécatl") es un robot seguidor de línea diseñado para competencias de racing. Su nombre proviene del dios azteca del viento, representando su característica principal: un sistema de succión mediante turbina para generar efecto ground y aumentar la tracción en curvas a alta velocidad.

🏆 Características Principales

Hardware

  • Microcontrolador: ESP32-S3-Zero
  • Sensores: Array de 16 sensores IR con multiplexadores duales
  • Motores: 2 motores DC con drivers RZ7886
  • Turbina: Sistema de succión con ESC brushless (efecto ground)
  • Control: Botón físico, señal externa de start, y comandos serial

Software

  • Control PID: Controlador proporcional-derivativo ajustable
  • Pre-inicio Inteligente: Estabilización y activación de turbina antes del arranque
  • Aceleración Adaptativa: Velocidad mínima de 20% para arranques rápidos
  • Protocolo ESC: Control de turbina a 50Hz (protocolo servo estándar)
  • Lectura Simétrica: Sensores leídos desde el centro hacia extremos
  • Calibración Automática: Auto-calibración con umbral adaptativo

🛠️ Especificaciones Técnicas

Mapa de Pines

ComponentePinTipoDescripción
Motores
Motor Izq A1PWMControl motor izquierdo
Motor Izq B4PWMControl motor izquierdo
Motor Der A9PWMControl motor derecho
Motor Der B2PWMControl motor derecho
Sensores
MUX_A3Digital OutControl multiplexador (LSB)
MUX_B11Digital OutControl multiplexador
MUX_C10Digital OutControl multiplexador (MSB)
Sensores 1-88Analog InLectura multiplexador 1
Sensores 9-167Analog InLectura multiplexador 2
Utilidades
LED5Digital OutLED de estado
Botón13Digital InBotón con pull-up
Start Signal6Digital InSeñal de inicio externa
Turbina12PWM (ESC)Control turbina/succión

Configuraciones PWM

Motores
  • Frecuencia: 5 kHz
  • Resolución: 10 bits (0-1023)
  • Canales: 0-3
Turbina (ESC)
  • Frecuencia: 50 Hz (protocolo servo)
  • Resolución: 11 bits
  • Rango: 102-204 (1000μs-2000μs)
  • Canal: 4

Parámetros PID

cpp
KP = 0.2    // Ganancia proporcional
KD = 0.80   // Ganancia derivativa

Tiempos de Control

  • Loop de control: 1000 μs (1 kHz)
  • Timeout pérdida de línea: 250 ms
  • Calibración sensores: 3000 ms
  • Tiempo máximo de prueba: 30000 ms

⚙️ Configuración

Configuración de Flash (platformio.ini)

ini
[env:esp32-s3-zero]
platform = espressif32
board = esp32-s3-devkitc-1
framework = arduino
board_build.mcu = esp32s3
board_build.f_cpu = 240000000L
board_build.flash_mode = qio
board_upload.flash_size = 4MB
board_build.arduino.memory_type = qio_opi
board_build.psram_type = opi
board_build.partitions = default.csv
monitor_speed = 115200
upload_speed = 921600

Ajuste de Parámetros

Los parámetros principales se pueden ajustar en:

  • control.h: Constantes PID, tiempos de control
  • motors.h: Configuración PWM de motores y turbina
  • sensors.h: Configuración de sensores

📱 Uso Básico

Inicio del Robot

  1. Encendido: Conectar alimentación
  2. Inicialización: Esperar 2 segundos (ESC de turbina)
  3. Calibración: Presionar botón → Mover robot sobre línea 3 segundos
  4. Listo: LED indica que está listo para iniciar

Modos de Inicio

El robot puede iniciarse de 3 formas:

  1. Botón Largo (>1s):

    • Presionar y mantener botón
    • Cuenta regresiva de 3 segundos
    • Último segundo: pre-inicio con turbina al 85%
    • ¡GO!
  2. Señal Externa (Pin 6):

    • Compatible con sistemas de competencia
    • Inicio inmediato al detectar HIGH en pin 6
  3. Comando Serial (s):

    • Enviar comando s por monitor serial
    • Cuenta regresiva de 3 segundos
    • Inicio automático

Comandos Serial

ComandoFunciónEjemplo
sIniciar carrera-
xDetener carrera-
rMostrar sensores RAW-
cMostrar sensores calibrados-
v[num]Cambiar velocidad base (0-100%)v40
a[num]Cambiar aceleración (0-100%)a70
f[num]Cambiar velocidad turbina (0-100%)f90
calRe-calibrar sensores-

📊 Rendimiento

📝 Licencia

Este proyecto está bajo la Licencia MIT. Ver archivo LICENSE para más detalles.

🔗 Enlaces Útiles


EHECATL - El viento que domina la pista 💨🏎️

Parts

19
QtyValueFootprintReferences
3Conn_01x03_SocketConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ1, START, SUCC
3~custom_footprints:LED_D5.0mm-4_RGB_Staggered_PinsLED1, LED2, LED3
2Conn_01x02_Socketcustom_footprints:motor_padsM1, M2
2~Package_DIP:DIP-8_W7.62mmPH1, PH2
1Conn_01x02_SocketConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalBAT
1Conn_01x07_SocketConnector_PinHeader_2.54mm:PinHeader_1x07_P2.54mm_VerticalJ4
1ESP32-S3-ZEROMictlanTeam-Library:ESP32-S3-ZEROESP32
1LOGOMictlanTeam-Library:QR MT 15mmG***
1LOGOMictlanTeam-Library:MT_Silkscreen 15mmG***
1~Button_Switch_THT:SW_PUSH_6mm_H4.3mmBTN1
1~custom_footprints:DC-DC_3.3 CN3903DC-DC_3.3

The 17 most common of 19 parts.

More from MictlanTeam/Ehecatl

1
  • 2 layers105.3 × 105.3 mmMT Blade, the printed circuit board in 3D

    MT Blade

    MictlanTeam/Ehecatl

    Los parámetros principales se pueden ajustar en:

    57 partsMIT

Similar boards

  • 2 layers43.9 × 27.7 mmTcd1304-4v, the printed circuit board in 3D

    Tcd1304-4v

    OpnTec/open-spectrometer-hardware

    Open source VIS spectrometer

    19 parts1.5k
  • 2 layers50 × 60 mmDebate Device, the printed circuit board in 3D

    Debate Device

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    19 parts915
  • 2 layers102.9 × 96.7 mmISA adapter, the printed circuit board in 3D

    ISA adapter

    polpo/picogus

    Emulation of ISA sound cards and CD-ROM on Raspberry Pi Pico (GUS, SB/Adlib, MPU-401, Tandy, CMS, Panasonic CD-ROM) with USB mouse/joystick support

    19 parts805
  • 2 layers60 × 39 mmPs2usb, the printed circuit board in 3D

    Ps2usb

    rasteri/HIDman

    Adapting USB devices to work on old computers

    19 parts432
  • 2 layers70.1 × 43.2 mmIaq device, the printed circuit board in 3D

    Iaq device

    nkitanov/iaq_board

    IAQ Board is a DIY (Do-It-Yourself) device for measuring internal air quality

    19 parts396
  • 2 layers80 × 80 mmGB BRK CPU G1, the printed circuit board in 3D

    GB BRK CPU G1

    Gekkio/gb-hardware

    Game Boy -related custom hardware by gekkio

    19 parts379CC-BY-4.0
  • 2 layers25.4 × 25.4 mmIna169, the printed circuit board in 3D

    Ina169

    Ardumower/ardumower

    Develop an open source robotic lawn mower (HW+SW reference platform)

    19 parts282
  • 2 layers58.4 × 28.6 mmNew rele, the printed circuit board in 3D

    New rele

    zmaker/arduino_cookbook

    gli sketch del nuovo progetto Arduino Cookbook e dei video di YouTube

    19 parts269

Questions

How big is the MT Core PCB?

It measures 50 × 34 mm and has 2 copper layers, 1.6 mm thick.

What parts does the MT Core use?

19 parts. 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 MT Core KiCad files?

From the MictlanTeam/Ehecatl repository on GitHub, at the commit this page was made from: the board is pcb/MT Core/MT Core.kicad_pcb and its schematic pcb/MT Blade/MT Blade.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the MT Core design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).