yahboom
HomeLearn
Solution
Blog
Online Store
About Us
EN/中文
RDK X3 Robot📖
01. About RDK-X3-Robot
1. Instructions
  • 1. Introduction
  • 2. FAQ
  • 3. Battery and charger use precautions
  • 4.TF card expand capacity
2. Common problem analysis
02. Assembly video
  • Part1-Install Motor
  • Part2-Install Battert Fixing Column
  • Part3-Install Motor Coupling
  • Part4-Install Mecanum wheel
  • Part5-Install Expansion Board
  • Part6-Wiring Show
  • Part7-Install Main Control Board
  • Part8-Install Car Top Plate and Antenna
  • Part9-Install OLED Screen
  • Part10-Install Depth Camera(Optional)
  • Part11-Install OLED Screen
  • Part12-Install HD Camera
  • Part13-Install Top Plate
  • Part14-Install Right Side Plate
  • Part15-Motor Wiring Show
  • Part16-lnstall Car Body
  • Part17-Install Battery
  • Part18-Install Lidar
03. Remote control tutorial
  • 1. The phone APP remote tutorial
  • 2. USB wireless controller remote tutorial
04. ROS functional tutorial
  • 1. Introduction of extension board
  • 2. Set up STM32 development environment
  • 3. Key control buzzer sound
  • 4. FreeRTOS application
  • 5. Serial communication
  • 6. SBUS model remote control
  • 7. CAN bus communication
  • 8. RGB color light strip
  • 9. Timer interrupt control PWM servo
  • 10. Control serial steering gear
  • 11. Nine-axis attitude sensor to obtain data
  • 12. Control motor forward and reverse
  • 13. The timer captures encoder data
  • 14. Theory of robot kinematics analysis
  • 15. PID control robot motion
05. Basic control tutorial
  • 1. Update the firmware of the expansion module
  • 2. Install the Python driver library
  • 3. Set the type of bottom car
  • 4. Open and close the APP program control
  • 5. Turn hotspot mode on and off
  • 6. The buzzer blows
  • 7. Control the motor forward and reverse
  • 8. Control robot movement
  • 9. OLED display
  • 10. Control fan and lamp effect
06. Development environment setup
  • 1. Virtual Machine
  • 2. Linux Basics
  • 3. Remote connection
  • 4. Multi-computer communication configuration
  • 5. Bind the device ID
  • 6. Image installation and backup
07. 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
08. Robot chassis control
  • 1. PID algorithm theory
  • 2. Robot information release
  • 3. Robot control
  • 4. Robot state estimation
  • 5. Robot calibration
  • 6. Robot trajectory tracking
  • 7. URDF model
09. Lidar courses
  • 1. Introduction and use of lidar
  • 2. Lidar obstacle avoidance
  • 3. Lidar following
  • 4. Lidar guard
  • 5. Patrol
  • 6. gmapping algorithm
  • 7. cartographer algorithm
  • 8. Navigation and obstacle avoidance
  • 9. App mapping and navigation
10. OpenCV courses
  • 1. Introduction to OpenCV
  • 2. OpenCV geometric transformation
  • 3. OpenCV image processing
  • 4. OpenCV image beautification
  • 5. Qr code creation and identification
11. MIPI camera course
  • 1. Camera driver
  • 2. Adjust the color HSV value
  • 3. Color recognition
  • 4. Color tracking
  • 5. Color follow
  • 6. Qr code command
  • 7. Face detection
  • 8. Object detection
  • 9. Visual Inspection -OpenCV
  • 10. Visual inspection - Deep learning
  • 11. Human tracking
  • 12. Gesture control
12. Depth Camera courses
  • 1. Use depth camera
  • 2. Calibration of camera internal reference
  • 3. ROS+OpenCV Foundation
  • 4. AR vision
  • 5. Color tracking
  • 6. Object tracking
13. Multi vehicle control
  • 1. Multi-vehicle synchronous control
  • 2. Multi-vehicle navigation
Remote login control
  • 1. VNC and SSH remote login
  • 2. Jupyter lab login and case code running
Download
  • RemoteCtrl_APP(iOS/Android))
  • Mapping_APP(iOS_Android)
  • Code
  • System File
  • VM_File
  • Manual
  • Software_File
  • Hardware_File
  • ROS2_Basic_VM
Download ZIP

Welcome to RDK X3 Robot repository

2. Robot information release

2. Robot information release

2. Robot information release2.1 Description of program function2.2. Program Code reference path2.3. Program Startup2.3.1. Launch command2.3.2 View node topics2.3.3. Reading topic data2.3.4. Publish topic data2.4. Core Source Code Analysis

Note: In subsequent ROS2 related courses, SSH remote connection car will be used for operation, refer to the "Remote connection" section of the tutorial "Development Environment Construction".

2.1 Description of program function

After the program is run, combined with the ROS expansion board, the sensor information on the ROS expansion board can be obtained, control car movement, control light belt, buzzer and other functions.

2.2. Program Code reference path

After SSH connection car, the location of the function source code is located at,

xxxxxxxxxx
/userdata/yahboomcar_ws/src/yahboomcar_bringup/yahboomcar_bringup

Where Mcnamu_driver.py indicates the chassis driver code.

2.3. Program Startup

2.3.1. Launch command

After SSH connects to the car, type,

xxxxxxxxxx
ros2 run yahboomcar_bringup Mcnamu_driver

1684463364272

2.3.2 View node topics

Open terminal input,

xxxxxxxxxx
ros2 topic list

1684465673429

The topic nameThe topic content
/BuzzerThe buzzer
/RGBLightLighting Effects Control
/cmd_velSpeed control
/editionVersion information
/imu/data_rawThe IMU sensor data
/imu/magIMU magnetometer data
/vel_rawCar speed information
/voltageBattery voltage information

2.3.3. Reading topic data

Take reading the voltage size as an example, open the terminal input,

xxxxxxxxxx
ros2 topic echo /voltage

1684461698432

2.3.4. Publish topic data

Take publishing /cmd_vel data to control car movement as an example, open the terminal input,

xxxxxxxxxx
ros2 topic pub /cmd_vel geometry_msgs/msg/Twist "{linear: {x: 0.5, y: 0.0, z: 0.0}, angular: {x: 0.0, y: 0.0, z: 0.2}}"

1684462174995

[Note] The system has configured the communication between the PC side (virtual machine side) and the car side, so after the car program runs, the virtual machine side can also participate in the receiving or sending of ros topic data. So as long as the communication is normal, there is no need to remotely connect the car after opening the terminal. ros2 node/topic/... Such commands can be run directly on the virtual machine terminal.

2.4. Core Source Code Analysis

Take Mcnamu_driver.py as an example.

xxxxxxxxxx
from SunriseRobotLib import SunriseRobot    #导入驱动库# Import driver library
​
self.car = SunriseRobot()   #实例化SunriseRobot对象
# Instantiate the SunriseRobot object
#create subcriber 创建订阅者
self.sub_cmd_vel = self.create_subscription(Twist,"cmd_vel",self.cmd_vel_callback,1)
self.sub_RGBLight = self.create_subscription(Int32,"RGBLight",self.RGBLightcallback,100)
self.sub_BUzzer = self.create_subscription(Bool,"Buzzer",self.Buzzercallback,100)
​
#create publisher 创建发布者
self.EdiPublisher = self.create_publisher(Float32,"edition",100)
self.volPublisher = self.create_publisher(Float32,"voltage",100)
self.velPublisher = self.create_publisher(Twist,"vel_raw",50)
self.imuPublisher = self.create_publisher(Imu,"/imu/data_raw",100)
self.magPublisher = self.create_publisher(MagneticField,"/imu/mag",100)
​
#调用库,读取ros拓展板的信息# Call the library to read the ros extension board information
edition.data = self.car.get_version()
battery.data = self.car.get_battery_voltage()
ax, ay, az = self.car.get_accelerometer_data()
gx, gy, gz = self.car.get_gyroscope_data()
mx, my, mz = self.car.get_magnetometer_data()
vx, vy, angular = self.car.get_motion_data()
​
#publish 发布话题数据#publish Publish the topic data
self.EdiPublisher.publish(edition)
self.volPublisher.publish(battery)
self.imuPublisher.publish(imu)
self.magPublisher.publish(mag)
self.velPublisher.publish(twist)
​
#callback 订阅者回调函数#callback subscriber callback function
def cmd_vel_callback(self,msg):
def RGBLightcallback(self,msg):
def Buzzercallback(self,msg):

For details, refer to Mcnamu_driver.py.

PID algorithm theory
Robot control

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/中文