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

3. ROS+OpenCV Foundation

3. ROS+OpenCV Foundation

3. ROS+OpenCV Foundation3.1 Description of program function3.2 Application code reference path3.3 Start the camera3.4 Subscribe to RGB image topics and publish the converted image data3.4.1. Node Startup3.4.2. View the node communication graph3.4.3. Core source code parsing3.5 Subscribe to Depth image topics and publish the transformed image data3.5.1. Node Startup3.5.2. View the node communication graph3.5.3. Core Source Code Resolution

 

3.1 Description of program function

ROS delivers images in its own sensor_msgs/Image message format, which cannot be directly processed, but provides [CvBridge] that can perfectly convert and be converted image data formats. [CvBridge] is a ROS library that acts as a bridge between ROS and OpenCV.

OpenCV and ROS image data conversion is shown in the figure below:

1684988437924

The following takes the Astra pro camera as an example, using two examples to show how to use CvBridge for data conversion, and using ROSboard web side to display topic data.

3.2 Application code reference path

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

xxxxxxxxxx
#RGB图像示例#RGB image example
/userdata/yahboomcar_ws/src/yahboomcar_astra/yahboomcar_imshow/yahboomcar_imshow/astra_rgb_image.py
#深度图像示例# Depth image example
/userdata/yahboomcar_ws/src/yahboomcar_astra/yahboomcar_imshow/yahboomcar_imshow/astra_depth_image.py

3.3 Start the camera

After SSH connects to the car, terminal input,

xxxxxxxxxx
ros2 launch astra_camera astra_pro.launch.xml

To view the topic, run the following command on the VM terminal:

xxxxxxxxxx
ros2 topic list

1684988749342

Mainly look at the image data topic, here only analyze the RGB color image and Depth image topic information, use the following command to view the respective data information, virtual machine terminal input,

xxxxxxxxxx
#查看RGB图像话题数据内容
# View the RGB image topic data content
ros2 topic echo /camera/color/image_raw

Can capture a frame of RGB color image information,

1684988831557

This describes the basic information of the image, an important value, encoding, the value here is rgb8, indicating that the encoding format of this frame image is rgb8, which needs to be referred to when doing data conversion in the following.

Virtual machine terminal input,

xxxxxxxxxx
#查看Depth图像话题数据内容
# View Depth image topic data content
ros2 topic echo /camera/depth/image_raw

Intercept depth image a frame of image data information,

1684994854300

The encoding value here is 16UC1.

3.4 Subscribe to RGB image topics and publish the converted image data

3.4.1. Node Startup

After SSH connects to the car and starts the camera, terminal type,

xxxxxxxxxx
#RGB彩色图像显示节点
#RGB color image display node
ros2 run yahboomcar_imshow astra_rgb_image

Car terminal input,

xxxxxxxxxx
#启动ROSboard
# Start ROSboard
ros2 run rosboard rosboard_node

Open the browser on the PC side (note that the computer and the Rising Sun network must be in the same LAN), enter the URL: car IP:9999, for example, my car IP is 192.168.2.67, enter the URL in the browser on the virtual machine side to open the ROSboard webpage:

xxxxxxxxxx
192.168.2.67:9999

1684997265245

Select /camera/color/image_raw and /cv_image/rgb topics, you can see the following screen,

1684997288576

The two images are the same and keep in sync, only the /cv_image/rgb image has more "cv_rgb" characters.

3.4.2. View the node communication graph

Virtual machine terminal input,

xxxxxxxxxx
ros2 run rqt_graph rqt_graph

1684995058660

3.4.3. Core source code parsing

Code reference path,

xxxxxxxxxx
/userdata/yahboomcar_ws/src/yahboomcar_astra/yahboomcar_imshow/yahboomcar_imshow/astra_rgb_image.py

As can be seen from 3.2.2, /get_astra_rgb_node subscribes to the topic of /camera/color/image_raw, and then converts ROS topic data into opencv image data through CvBridge. After opencv processing, Then the processed image data is converted into ROS topic data through CvBridge and released, that is, ROS topic data ->opencv image data ->ROS topic data. The code is as follows,

​x
# 导入opecv库以及cv_bridge库
# Import opecv library and cv_bridge library
import cv2 as cv
from cv_bridge import CvBridge
​
# 创建CvBridge对象
# Create CvBridge objects
self.bridge = CvBridge()
# 定义一个订阅者订阅深度相机节点发布的RGB彩色图像话题数据
# Define a subscriber to subscribe to the RGB color image topic data published by the Depth camera node
self.sub_img = self.create_subscription(Image,'/camera/color/image_raw',self.handleTopic,1)
# 定义一个发布者发布经处理后的图像话题数据
# Define a publisher to publish processed image topic data
self.pub_img = self.create_publisher(Image,'/cv_image/rgb',10)
​
# msg转换成cv图像数据,这里的bgr8是图像编码格式
# msg converts to cv image data, where bgr8 is the image encoding format
frame = self.bridge.imgmsg_to_cv2(msg, "bgr8")
# 规范输入图像大小
# Standardize the input image size
frame = cv.resize(frame, (640, 480))
# 为图像添加字符
# Adds characters to the image
cv.putText(frame, "cv_rgb", (280, 30), cv.FONT_HERSHEY_SIMPLEX, 1, (0, 0, 255), 2)
# 将处理后的cv图像数据转换成msg数据
# Convert the processed cv image data into msg data
msg = self.bridge.cv2_to_imgmsg(frame, "bgr8")
# 发布转换后的图像
# Post the converted image
self.pub_img.publish(msg)

3.5 Subscribe to Depth image topics and publish the transformed image data

3.5.1. Node Startup

After SSH connects to the car and starts the camera, terminal type,

xxxxxxxxxx
#深度图像显示节点
# Depth image display node
ros2 run yahboomcar_imshow astra_depth_image

Car terminal input,

xxxxxxxxxx
#启动ROSboard
# Start ROSboard
ros2 run rosboard rosboard_node

Open the browser on the PC side (note that the computer and the Rising Sun network must be in the same LAN), enter the URL: car IP:9999, for example, my car IP is 192.168.2.67, enter the URL in the browser on the virtual machine side to open the ROSboard webpage:

xxxxxxxxxx
192.168.2.67:9999

1684995549910

Select the /camera/depth/image_raw and /cv_image/depth topics to see the following screen,

1684995608368

The two images are the same and synchronized, except that the /cv_image/depth image has the "cv_depth" character.

3.5.2. View the node communication graph

Virtual machine terminal input,

xxxxxxxxxx
ros2 run rqt_graph rqt_graph

1684996115177

3.5.3. Core Source Code Resolution

Code reference path,

xxxxxxxxxx
/userdata/yahboomcar_ws/src/yahboomcar_astra/yahboomcar_imshow/yahboomcar_imshow/astra_depth_image.py

The basic implementation process is the same as the RGB color image display, subscribe to the topic data of /camera/depth/image_raw published by the depth camera node, and then complete the conversion of ROS topic data ->opencv image data ->ROS topic data through CvBridge. The code is as follows,

xxxxxxxxxx
# 导入opecv库以及cv_bridge库
# Import opecv library and cv_bridge library
import cv2 as cv
from cv_bridge import CvBridge
​
# 创建CvBridge对象
# Create CvBridge objects
self.bridge = CvBridge()
# 定义一个订阅者订阅深度相机节点发布的深度图像话题数据
# Define a subscriber to subscribe to the depth image topic data published by the Depth Camera node
self.sub_img = self.create_subscription(Image,'/camera/depth/image_raw',self.handleTopic,1)
# 定义一个发布者发布经处理后的图像话题数据
# Define a publisher to publish processed image topic data
self.pub_img = self.create_publisher(Image,'/cv_image/depth',10)
​
# msg转换成cv图像数据,这里的16UC1是图像编码格式
# msg converts to cv image data, where 16UC1 is the image encoding format
frame = self.bridge.imgmsg_to_cv2(msg, "16UC1")
# 规范输入图像大小
# Standardize the input image size
frame = cv.resize(frame, (640, 480))
# 为图像添加字符
# Adds characters to the image
cv.putText(frame, "cv_depth", (280, 30), cv.FONT_HERSHEY_SIMPLEX, 1, (65536, 65536, 65536), 2)
# 将处理后的cv图像数据转换成msg数据
# Convert the processed cv image data into msg data
msg = self.bridge.cv2_to_imgmsg(frame, "16UC1")
# 发布转换后的图像
# Post the converted image
self.pub_img.publish(msg)

 

Calibration of camera internal reference
AR vision

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