yahboom
HomeLearn
Solution
Blog
Online Store
About Us
EN/中文
MicroROS Self-balancing Robot Car📖
01.Introduction
  • 0.Unboxing and Reviewing
  • 1. Must read before use - learning route
  • 2. Introduction to LiDAR
  • 3. Balance car interface description
  • 4. Analysis of common problems
  • 5. Robot charging and battery precautions
02.Assembly tutorial
  • Robot assembly steps
03.Preparation
  • 0.Quick Start (Must Read)
  • 1.Write firmware
  • 2.How to install and use VM
  • 3.ESP32 communication board configuration parameters
  • 4.Connect to microROS agent
04.ROS-WiFi module configuration
  • 0.Serial port configuration WiFi instructions
  • 1.Use ROS-WiFi cam module(must read)
  • 2.Connect to ROS-WiFi cam module agent
  • 3.Camera image correction (optional)
05.Quick start control
  • 1.Keyboard remote control
  • 2.Handle remote control
06.ROS+OpenCV course
  • 1.OpenCV Getting started
  • 2.Geometric transformation
  • 3.Image processing and drawing text line segments
  • 4.Image beautification
07.Mediapipe course
  • 1. Hand detection
  • 2. Posture detection
  • 3. Overall inspection
  • 4. Face detection
  • 5. Face recognition
  • 6. Facial effects
  • 7. 3D object recognition
  • 8. Brush
  • 9. Finger control
  • 10. Gesture recognition
08.Robot basic course
  • 1.Robot information release
  • 2.Robot keyboard control
  • 3.Robot handle control
  • 4.Robot state estimation
  • 5.Line speed calibration
  • 6.Angular velocity calibration
  • 7.Robot URDF model
09.Lidar course
  • 1.Lidar avoid
  • 2.Lidar following
  • 3.Lidar guard
  • 5.Gmapping mapping
  • 6.Cartographer mapping
  • 7.Navigation2 navigation avoid
  • 8.Navigation2 fast relocation navigation
  • 9.ROS Robot APP mapping
  • 10.ROS Robot APP navigation
10.Robot visual interaction
  • 1.Color tracking
  • 2.Object recognition and tracking
  • 3.Face recognition tracking
  • 4.Autonomous driving line patrol
  • 5.QR code motion control
  • 6.Gesture control car movement
  • 7.Palm control car movement
  • 8.Gesture control car action group
  • 9.Palm recognition and tracking
  • 10.Human body posture recognition and tracking
11.Multi-machine course
  • 1.Multi-machine handle control
  • 2.Multi-machine keyboard control
  • 3.Multi-machine navigation
  • 4.Multi-machine rapid relocation navigation
12.STM32 balancing case
01.Environment construction and development
  • 13.Window Watchdog (WWDG)
  • 01.MDK-ARM installation
  • 02.STM32CubeIDE installation
  • 03.Common driver installation
  • 04.Download the program
  • 05.MDK-ARM project usage
  • 06.Program simulation
02.STM32 getting started course
  • 01.Project creation
  • 02.LED Control(GPIO)
  • 03.Buzzer control(GPIO)
  • 04.Button control(EXTI)
  • 05.Serial communication(USART)
  • 06.Voltage detection(ADC)
  • 07.Basic timer(TIM)
  • 08.Universal timer(TIM)
  • 09.Advanced Timer(TIM)
  • 10.I2C Communication(I2C)-OLED
  • 11.SPI communication(SPI)-2.4G handle
  • 12.Independent Watchdog (IWDG)
  • 14.DMA-USART
  • 15.DMA-I2C
03.STM32 expansion course
  • 01.Battery voltage detection (ADC)
  • 02.Ultrasonic module-measuring distance (TIM)
  • 03.Motor drive+encoder (TIM)
  • 04.OLED Data-Display(I2C)
  • 05.MPU6050-Data Read (I2C)
04.Robot car PID control course
  • 01.PID basic concept
  • 02.PID example analysis
  • 03.P, PI, PD controller theory
  • 04.Position PID
  • 05.Incremental PID
  • 06.Cascade PID
  • 07.Balance principle of car
  • 08.Car upright control (PD)
  • 09.Car speed ​​control (PI)
  • 10.Car steering control (PD)
  • 11.Got angle and angular velocity (DMP algorithm)
  • 12.Got angle and angular velocity (Kalman filter algorithm)
  • 13.Got angle and angular velocity(Complementary filter algorithm)
05.Robot car basic course
  • 01.Car parameter adjustment
  • 02.Ultrasonic obstacle avoidance
  • 03.Ultrasonic follow
  • 04.Bluetooth remote control
  • 05.Load balance
  • 06.Radar obstacle avoidance
  • 07.Radar guard
  • 08.Radar follow
  • 09.Radar patrol
  • 10.Radar wall following go in a straight line
  • 11.Radar tracking wall multiple walls
06.Robot car LQR control
  • Balance car LQR high-level control
07.Circuit design
  • 01.Overall circuit design
  • 02.STM32 minimum system
  • 03.Serial port circuit design
  • 04.Power circuit design
  • 05.MPU6050 Circuit Design
  • 06.Motor drive circuit design
08.Mathematical model
  • Balance car mathematical model
13.Linux basic course
  • 1.Introduction to Linux system
  • 2.Ubuntu file system
  • 3.Ubuntu common commands
  • 4.Ubuntu common editors
  • 5.Ubuntu software operation commands
  • 6.Virtual machine installation
  • 7.SSH remote control
  • 8.VNC remote control
  • 9.Transfer files remotely
  • 10.Driver library and communication
  • 11.Static IP and hotspot mode
  • 12.Bind device ID
  • 13.Capacity expansion and resource allocation
  • 14.Update system software sources
  • 15.Set root user password
  • 16.sudo free password
  • 17.Connect to WiFi network
  • 18.View system version
  • 19.Customized service management
  • 20.Back up system image
14.Docker course
  • 1. Overview and installation
  • 2. Common commands
  • 3. Docker images deeply understand and publish images
  • 4. Docker hardware interaction and data processing
  • 5. Enter the bot's docker container
15.ROS2 basic course
  • 1.Introduction to ROS2
  • 2.ROS2 install Humble
  • 3.ROS2 development environment
  • 4.ROS2 workspace
  • 5.ROS2 function package
  • 6.ROS2 node
  • 7.ROS2 topic communication
  • 8.ROS2 service communication
  • 9.ROS2 action communication
  • 10.ROS2 custom interface message
  • 11.ROS2 parameter service case
  • 12.ROS2 meta-function package
  • 13.ROS2 distributed communication
  • 14.ROS2 DDS
  • 15.ROS2 time related API
  • 16.ROS2 common command tools
  • 17.ROS2 rviz2 use
  • 18.ROS2 rqt toolbox
  • 19.ROS2 Launch startup file configuration
  • 20.ROS2 recording and playback tool
  • 21.ROS2 URDF model
  • 22.ROS2 Gazebo simulation platform
  • 23.ROS2 TF2 coordinate transformation
Download
  • RemoteCtrl_APP(Android)
  • Mapping_APP(iOS_Android)
  • Code
  • Hardware Information
  • software tools
  • 3D model file
  • Instruction manual
  • VM image file
  • ROS2_Basic_VM
Download ZIP

Welcome to MicroROS Self-balancing Robot Car repository

02.Ultrasonic module-measuring distance (TIM)

Ultrasonic module-measuring distance (TIM)

Ultrasonic module-measuring distance (TIM)Hardware connectionControl principlePin definitionSoftware codeControl functionExperimental phenomenon

The tutorial mainly demonstrates the implementation of the ultrasonic module distance measurement function.

GPIO general push-pull output function triggers the ultrasonic module distance measurement; timer input capture obtains the ultrasonic high level time, thereby calculating the obstacle distance.
The tutorial only introduces the standard library project code

Hardware connection

image-20240825211022559

Just install it to the corresponding interface:

Ultrasonic moduleSTM32F103RCT6
VCC5V
TRIGPA0
ECHOPA1
GNDGND

Control principle

image-20240903172307044

Trigger ranging signal

The TRIG pin sends a high level signal for more than 10us.

xxxxxxxxxx
The ultrasonic module will automatically send 8 40KHz square waves and automatically detect whether there is a signal return

Receive echo signal

If there is a signal return, the ECHO pin will output a high level. The duration of the high level is the time from the ultrasonic wave transmission to the return.

Distance conversion

Distance=Thigh∗Vspeed2
xxxxxxxxxx
T: Echo signal high level time
V: Sound speed (approximately equal to 340m/s)

Pin definition

Main control chipPinMain function (after reset)Default multiplexing functionRedefine function
STM32F103RCT6PA0PA0WKUP/USART2_CTS/ADC123_IN0/TIM2_CH1_ETR/TIM5_CH1/TIM8_ETR 
STM32F103RCT6PA1PA1USART2_RTS/ADC123_IN1/TIM5_CH2/TIM2_CH2 

Software code

Since the default function of all pins is the ordinary IO pin function, we need to use the multiplexing function.

xxxxxxxxxx
Product supporting materials source code path: Attachment → Source code summary → 2.Extended_Course → 2.Ultrasonic

Control function

The tutorial only briefly introduces the code, you can open the project source code to read it in detail.

ultrasonic_init

​x
static void ultrasonic_init(void)
{
    GPIO_InitTypeDef GPIO_InitStructure;
    RCC_APB2PeriphClockCmd(ULTRASONIC_RCC, ENABLE);   // Enable the GPIOA clock

    GPIO_InitStructure.GPIO_Pin  = ECHO_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPD;  //PA1 Input
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;      //50M
    GPIO_Init(ECHO_PORT, &GPIO_InitStructure);

    GPIO_InitStructure.GPIO_Pin  = TRIG_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;      //PA3 output
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;      //50M
    GPIO_Init(TRIG_PORT, &GPIO_InitStructure);
}

TIM2_Cap_Init

xxxxxxxxxx
void TIM2_Cap_Init(u16 arr,u16 psc) 
{
    TIM_ICInitTypeDef TIM2_ICInitStructure;
    TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure;
    NVIC_InitTypeDef NVIC_InitStructure;

    ultrasonic_init();
    RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); //Enable TIM2 clock

    //Initialize timer 2 TIM2
    TIM_TimeBaseStructure.TIM_Period = arr; //Set counter auto-reload value
    TIM_TimeBaseStructure.TIM_Prescaler = psc; //Prescaler
    TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; //Set clock division: TDTS = Tck_tim
    TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; //TIM up counting mode
    TIM_TimeBaseInit(TIM2, &TIM_TimeBaseStructure); //Initialize the time base unit of TIMx according to the parameters specified in TIM_TimeBaseInitStruct

    //Initialize TIM2 input capture parameters
    TIM2_ICInitStructure.TIM_Channel = TIM_Channel_2; //CC1S=02 Select input IC2 to map to TI1
    TIM2_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Rising; //Rising edge capture
    TIM2_ICInitStructure.TIM_ICSelection = TIM_ICSelection_DirectTI;
    TIM2_ICInitStructure.TIM_ICPrescaler = TIM_ICPSC_DIV1; //Configure input frequency division, no frequency division
    TIM2_ICInitStructure.TIM_ICFilter = 0x00; //Configure input filter No filtering
    TIM_ICInit(TIM2, &TIM2_ICInitStructure);

    //Interrupt group initialization
    NVIC_InitStructure.NVIC_IRQChannel = TIM2_IRQn; //TIM2 interrupt
    NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; //Preempt priority level 1
    NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1; //From priority level 1
    NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; //IRQ channel is enabled
    NVIC_Init(&NVIC_InitStructure); //Initialize peripheral NVIC registers according to the parameters specified in NVIC_InitStruct
    TIM_ITConfig(TIM2,TIM_IT_Update|TIM_IT_CC2,ENABLE);//Allow update interrupts, allow CC2IE to capture interrupts
    TIM_Cmd(TIM2,ENABLE); //Enable timer 2
}

TIM2_IRQHandler

xxxxxxxxxx
void TIM2_IRQHandler(void)
{
    u16 tsr;
    tsr=TIM2->SR;
    if((TIM2CH2_CAPTURE_STA&0X80)==0)// Capture has not succeeded
    {
        if(tsr&0X01)// The timer overflows
        {
            if(TIM2CH2_CAPTURE_STA&0X40)// The high level has been captured
            {
                if((TIM2CH2_CAPTURE_STA&0X3F)==0X3F)// The high level is too long
                {
                    TIM2CH2_CAPTURE_STA|=0X80;       // Indicates a successful capture
                    TIM2CH2_CAPTURE_VAL=0XFFFF;
                }else TIM2CH2_CAPTURE_STA++;
            }
        }
        if(tsr&0x04)// Capture 2 A capture event occurred
        {
            if(TIM2CH2_CAPTURE_STA&0X40) // Captures a falling edge
            {
                TIM2CH2_CAPTURE_STA|=0X80;         // Mark that a high level pulse width was successfully captured
                TIM2CH2_CAPTURE_VAL=TIM2->CCR2;  // Gets the current capture value.
                TIM2->CCER&=~(1<<5);                   //CC2P=0 Set to rising edge capture
            }
        else // Not yet started, first capture rising edge
        {
            TIM2CH2_CAPTURE_STA=0;    // Empty
            TIM2CH2_CAPTURE_VAL=0;
            TIM2CH2_CAPTURE_STA|=0X40;       // The flag captures the rising edge
            TIM2->CNT=0;                                     // The counter is cleared
            TIM2->CCER|=1<<5;                        //CC2P=1 Set to falling edge capture
        }
        }
    }
    TIM2->SR=0; // Clears the interrupt flag bit
}

Experimental phenomenon

The Ultrasonic.hex file generated by the project compilation is located in the OBJ folder of Ultrasonic project. The corresponding Ultrasonic.hex file is found and the program is downloaded into the development board by using FlyMcu software.

After successful download: Serial port will print Ultrasonic Class! After hardware initialization Then control LED status switch and print obstacle distance every 500ms.

xxxxxxxxxx
When using the serial port debugging Assistant, pay attention to the serial port Settings. Incorrect Settings may cause inconsistency

image-20240808192926663

Battery voltage detection (ADC)
Motor drive+encoder (TIM)

COMPANY

  • About us
  • Team Style
  • Blog

LEARNING & EXPLORATION

  • Tutorials
  • Edge AI hardware
  • Educational robots
  • Embedded intelligent hardware

WHERE TO BUY

  • Yahboom Online Store
  • Amazon
  • Alibaba
  • AliExpress
  • Mercado

TECHNOLOGY SUPPORT

  • Email: support@yahboom.com

BE A DISTRIBUTOR

  • Email: sales@yahboom.com
QR Code

Copyright © 2017-2026 Yahboom. All Rights Reserved.

EN/中文