Skip to the content
2 layers119.6 × 59.2 mmRWPendulum, the printed circuit board in 3D

Implementation of Extremum Seeking Control (ESC) for a Reaction Wheel Inverted Pendulum

Size
119.6 × 59.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
17
Nets
39
Pads
84
Tracks, vias
68, 0
Pours
9
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
4 Dec 2025
Updated
9 Mar 2026

Overview

RWPendulum is an open-source printed circuit board by gtumang, from the gtumang/ESC-RWPendulum repository on GitHub, published under the MIT licence. It is a 2-layer board of 119.6 × 59.2 mm with 17 parts on 39 nets, routed with 68 tracks and 0 vias.

It is built around the L7805CV. Its parts include 5 capacitors, 4 connectors, 2 ICs, 2 switches and 1 resistor. It belongs with the robots and motor control boards and the ESP32 boards of this library.

Main components

1

README

README.md

ESC-RWPendulum

Este repositório contém o firmware, modelos de simulação e ferramentas de visualização para um sistema de controle de Pêndulo com Roda de Reação (Pêndulo Invertido). O projeto foi projetado para estabilizar o pêndulo usando uma roda de reação acionada por um motor DC, controlado por um microcontrolador ESP32.

Estrutura do Projeto

O repositório está organizado em quatro diretórios principais:

  • Firmware/: Código C++ embarcado para o ESP32, construído usando PlatformIO. Gerencia a leitura de sensores, a execução da malha de controle e a comunicação serial.
  • Matlab/: Scripts MATLAB e modelos Simulink para definição de parâmetros físicos, modelagem matemática e cálculo de ganho de controle (LQR).
  • Visualization/: Scripts Python para telemetria em tempo real, registro de dados e plotagem via Serial.
  • PCB/: Arquivos de projeto da placa de circuito impresso (Hardware), incluindo esquemáticos, layout e arquivos de fabricação.

1. Firmware (ESP32)

O firmware está localizado no diretório Firmware e está configurado como um projeto PlatformIO.

Configuração de Hardware

  • Microcontrolador: ESP32 (Placa: fm-devkit)
  • Atuador: Motor DC com driver PWM (controlado pelos pinos 25/26).
  • Sensores: Dois Encoders de Quadratura (Ângulo do Pêndulo e Velocidade da Roda).

Pinagem (main.cpp):

ComponentePino APino BNotas
Encoder da RodaGPIO 17GPIO 16Mede velocidade/posição da roda de reação
Encoder do PênduloGPIO 19GPIO 18Mede o ângulo de inclinação do pêndulo
Driver do MotorGPIO 25GPIO 26Saída PWM (LEDC)
Botão Iniciar/PararGPIO 4-Alterna a malha de controle (ISR)

Malha de Controle

  • Algoritmo: Controle em Espaço de Estados (LQR).
  • Frequência: 50 Hz (Ts = 0.02s).
  • Estados:
    1. $x_1$: Ângulo do Pêndulo (rad)
    2. $x_2$: Ângulo da Roda (rad)
    3. $x_3$: Velocidade do Pêndulo (rad/s)
    4. $x_4$: Velocidade da Roda (rad/s)
  • Comunicação: Envia dados de estado e esforço de controle via Serial (Formato binário).

2. MATLAB & Simulação

O diretório Matlab contém a fundação matemática do projeto.

  • Scripts/SalvaParams.m: Define as constantes físicas do sistema (massas, comprimentos, inércia, constantes do motor) e as salva em Parametros/parametros_planta.mat.
    • Parâmetros incluem: $M_h$ (Massa da haste), $M_r$ (Massa do rotor), $L$ (Comprimento), $J_h$ (Inércia), etc.
  • PenduloRotativoSim.slx: Modelo Simulink para simular a dinâmica do sistema e a resposta do controlador.
  • Funcoes/: Contém funções geradas automaticamente (function_G_Rot, function_M_Rot, etc.) para a simulação não linear do sistema.
  • Parametros/: Armazena arquivos .mat com a matriz de ganho de controle K calculada.

Como usar:

  1. Edite os parâmetros físicos em SalvaParams.m e execute-o.
  2. Execute o script de análise principal (ex: main.mlx) para calcular a matriz de ganho LQR $K$.
  3. Atualize a struct K em Firmware/src/main.cpp com os valores calculados.

3. Visualização (Python)

O diretório Visualization fornece ferramentas para visualizar dados do sistema em tempo real.

Requisitos

  • Python 3.x
  • Bibliotecas: pyserial, matplotlib

Scripts

  • ler_pendulo.py: Um utilitário simples para ler dados brutos da porta serial e imprimir os valores decodificados em ponto flutuante no console.
  • plot_pendulo.py: Uma ferramenta de plotagem em tempo real.
    • Uso: python plot_pendulo.py --port COM3
    • Recursos:
      • Plota múltiplas variáveis dinamicamente.
      • Suporta um modo de simulação para testar a interface sem hardware: python plot_pendulo.py --sim.
      • Visualiza Ângulo, Velocidade e Esforço de Controle ($u$).

4. Hardware e PCB (KiCad)

O diretório PCB contém todo o projeto eletrônico necessário para fabricar a placa de controle customizada do pêndulo, desenvolvido no software KiCad.

Estrutura dos Arquivos

  • RWPendulum/: Contém os arquivos fonte do projeto KiCad, incluindo o esquemático (.kicad_sch) e o layout da PCB (.kicad_pcb). O design integra o módulo ESP32 DevKit V1 e o driver de motor.
  • OutputFiles/: Arquivos gerados para fabricação da placa:
    • Gerber/: Arquivos Gerber para as camadas de cobre, máscara de solda e corte.
    • Drill/: Arquivos de furação (PTH e NPTH).
  • 3D/: Modelos 3D (.step) da placa completa e componentes específicos (ex: Driver MD36A) para visualização mecânica e validação de encaixe.

Licença

Nenhuma licença especificada nos arquivos do repositório.

Autor

Gabriel Brunoro Motta Tumang

Parts

17
QtyValueFootprintReferences
4100nFCapacitor_THT:C_Disc_D5.0mm_W2.5mm_P5.00mmC1, C2, C3, C4
2Screw_Terminal_01x02TerminalBlock:TerminalBlock_MaiXu_MX126-5.0-02P_1x02_P5.00mmJ1, J4
1470uFCapacitor_THT:CP_Radial_D8.0mm_P3.50mmC5
1600Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR2
1Conn_01x04_PinConnector_Molex:Molex_KK-396_A-41792-0004_1x04_P3.96mm_HorizontalJ3
1Conn_01x06_PinConnector_Molex:Molex_KK-396_A-41792-0006_1x06_P3.96mm_HorizontalJ2
1ESP32-DEVKIT-V1RF_Module:ESP32-C3-DevKitM-1U2
1FuseFuse:Fuseholder_Cylinder-5x20mm_Schurter_0031_8201_Horizontal_OpenF1
1L7805CVLibraryLoader:TO255P460X1020X2008-3PIC1
1LEDLED_THT:LED_D3.0mmD1
1SW_PushButton_Switch_THT:SW_PUSH_6mm_H4.3mmSW2
1SW_SPSTTerminalBlock:TerminalBlock_MaiXu_MX126-5.0-02P_1x02_P5.00mmSW1
1~BibliotecaGT:MD36A Motor Driver HeaderA1

Similar boards

  • 2 layers52.1 × 116.8 mmDIY Uncertainty, the printed circuit board in 3D

    DIY Uncertainty

    oamodular/uncertainty

    This readme needs to be updated to reflect this and to talk about the many other languages that people have used to create new firmware for Uncertainty.

    67 parts43
  • 2 layers55 × 90.8 mmSlider, the printed circuit board in 3D

    Slider

    DusterTheFirst/rocketry

    🚀 Thrust Vector Controlled Model Rockets

    33 parts22GPL-3.0
  • 2 layers100 × 80 mmRti, the printed circuit board in 3D

    Rti

    cceh/rti

    Reflectance Transformation Imaging

    58 parts15
  • 2 layers377.2 × 318 mmThree phase bridge, the printed circuit board in 3D

    Three phase bridge

    arcoslab/open-coroco-legacy

    COmpliant RObot COntroller is a free software project aiming to create an impedance controller based on a stm32 microcontroller using bldc motors and strain gauges.

    105 parts6
  • 2 layers127 × 91.5 mmAccumulator Board, the printed circuit board in 3D

    Accumulator Board

    formulaslug/fs-3-schematics

    Electrical Design Repository for fs-3 schematics and PCBs

    110 parts5
  • 2 layers100 × 60 mmLopielle, the printed circuit board in 3D

    Lopielle

    andreasimonetto/lopielle

    MIDI synth based on Yamaha OPLL FM synthesis sound chip (YM2413)

    49 parts2
  • 2 layers162.6 × 123.2 mmTo print, the printed circuit board in 3D

    To print

    anorimaki/selfbalancing-robot

    A buck converter to generate the 5V power rail would have been a better choice because it would be more efficient (extending battery life) and eliminate the need of a second battery (the circuit could be plugged with…

    124 parts2
  • 2 layers100 × 200 mmH Bridge BLDC, the printed circuit board in 3D

    H Bridge BLDC

    l4m4re/H_Bridge_BLDC

    Simple experimental H bridge BLDC controller

    131 parts2CC-BY-4.0

Questions

How big is the RWPendulum PCB?

It measures 119.6 × 59.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the RWPendulum use?

17 parts, built around the L7805CV. 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 RWPendulum KiCad files?

From the gtumang/ESC-RWPendulum repository on GitHub, at the commit this page was made from: the board is PCB/RWPendulum/RWPendulum.kicad_pcb and its schematic PCB/RWPendulum/RWPendulum.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the RWPendulum 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).