yahboom
HomeLearn
Solution
Blog
Online Store
About Us
EN/中文
DOFBOT Pro📖
1. Get started quickly
  • 0.Unboxing introduction video
  • 1. First Trial
  • 2. Analysis of common problems
  • 3. Calibration offset
  • 4. Jetpack old system upgraded to SUPER system
  • 5. Precautions for DIY Robotic Arm
  • 6. Jetson Nano Version – Must Read
  • 7.Robotic arm gripping anomaly solutions
2. Assembly course
  • 1. Installation video
  • 2. Calibrate the Robotic Arm
  • 3. Install the map
3. Remote control course
  • 1. Mobile APP control
  • 2. USB handle control
  • 3. PC web page programming
4. Preparation
  • 1. Manage APP control services
  • 2. Manage JupyterLab services
  • 3. Manage OLED services
  • 4. Modifying ROS_DOMAIN_ID for Multi-Machine
5. 2D visual tracking course
  • 1. Color block positioning
  • 2. Color block tracking
  • 3. Face positioning
  • 4. Face tracking
  • 5. Label code positioning
  • 6. Label code tracking
6. 2D visual grabbing course
  • 1. Identify grab color block
  • 2. Catch game
  • 3. Color sorting
  • 4. Color stacking
  • 5. Label code sorting
  • 6. Label code stacking
  • 7. Identify gesture grab color block
  • 8. Gesture stacking
  • 9.1 Single garbage sorting(Jetson-Nano)
  • 9.2 Single garbage sorting(Orin)
  • 10.1 Garbage sorting(Jetson-Nano)
  • 10.2 Garbage sorting(Orin)
  • 11. Tracking game
7. 2D Mediapipe course
  • 1. Hand detection
  • 2. Posture detection
  • 3. Overall detection
  • 4. Facial Detection
  • 5. Face Detection
  • 6. Face effects
  • 7. 3D Object Recognition
  • 8. Paintbrush
  • 9. Finger control
  • 10. Gesture Recognition
  • 11. Gesture control robotic arm action group
  • 12. Arm posture control robotic arm
  • 13. Palm Targeting
  • 14.1 Robotic arm tracks the palm(Jetson-Nano)
  • 14.2 Robotic arm tracks the palm(Orin)
  • 15. Fingertip trajectory recognition
  • 16. Fingertip trajectory control robotic arm
  • 17. Gesture Grasp and Release Objects
  • 18. Finger Control Robot Arm
8. AI Large Model Voice Module (Must Read)new
  • 1. Introduction to AI Large Model Voice Module
  • 2. Flash the firmware (Must read)
  • 3. Modify the wake-up word and command word
9. 2D Voice Control Course
  • 1.Simple Voice Control
  • 2.Smart Voice Control
  • 3.Voice Action Control
  • 4.Memory Learning Mode
  • 5.Color Recognition with Voice Broadcast
  • 6.Color Recognition and Grasping with Voice Broadcast
  • 7.Color Recognition and Sorting with Voice Broadcast
  • 8.Voice Recognition Target Tracking
  • 9.Voice Control Stacking
  • 10.Voice Control Color Sorting
  • 11.1 Garbage Recognition with Voice Broadcast(Jetson Nano)
  • 11.2 Garbage Recognition with Voice Broadcast(Orin)
  • 12.1 Garbage Sorting with Voice Broadcast(Jetson Nano)
  • 12.2 Garbage Sorting with Voice Broadcast(Orin)
10. 3D Depth Camera Course
  • 1. Dabai_DCW2 camera
  • 2. Deep Pseudo-Color Image
  • 3. Depth camera ranging
  • 4. Color block volume measurement
11. 3D Robotic Arm Control and Inverse Kinematics
  • 1. Robotic arm ROS control
  • 2. Inverse solution
12. 3D Sorting and Grasping Course
  • 1. AprilTag ID sorting
  • 2. AprilTag abnormal height sorting
  • 3. MediaPipe Gesture-AprilTag ID sorting
  • 4. MediaPipe Gesture-AprilTag height sorting
  • 5. MediaPipe Gesture-AprilTag distance sorting
  • 6. Block color sorting
  • 7. Block abnormal height sorting
  • 8. Block different shape sorting
  • 9. Block shape abnormal height sorting
  • 10. Yolov11 garbage sorting(Orin)
13. 3D Tracking and Grasping Course
  • 1. AprilTag Tracking and Grasping
  • 2. Color Block Tracking and Grasping
  • 3. KCF Object Tracking and Grasping
14. 3D Voice Control for Grasping Course (Sorting & Tracking)
  • 1. Voice Control AprilTag ID Sorting
  • 2. Voice Control Remove Height Abnormal AprilTag
  • 3. Voice Control Tracking and Grasping AprilTag
  • 4. Voice Control Color Block Sorting
  • 5. Voice Control Remove Height Abnormal Color Block
  • 6. Voice Control Tracking and Grasping Color Block
  • 7. Voice Control Yolov11 Garbage Recognition Sorting
  • 8. Voice Control Object Tracking and Grasping
15. AI Model Basicsnew
  • 1.AI large model types and principles
  • 2.RAG retrieval enhancement and model training samples
  • 3.Embodied intelligent robot system architecture
  • 4.Embodied intelligent functions core source code
16. AI Model Developmentnew
  • 1.Register a model service provider account
  • 2. Configure API-KEY
  • 3. Introduction to Dify
  • 4. Basic Dify Features
  • 5. Deploy the RAG knowledge base
  • 6. AI Large Model Development - chatbot
  • 7. RAG knowledge base + chatbot
  • 8. AI agent workflow
17. AI Model – Text Versionnew
  • 1. Semantic understand instruction following
  • 2. Multimodal visual understand
  • 3. Text Large Model + robotic arm control
  • 4. Multimodal Large Model+video understanding
  • 5. Multimodal Large Model+robotic arm gripping
  • 6. Multimodal Large Model+robotic arm tracking
  • 7. Multimodal Large Model+robotic arm sorting
  • 8. Multimodal Large Model+robotic arm handling
  • 9. Multimodal Large Model+Color Blocks Back In Place
  • 10. Multimodal Large Model + Intent Prediction + Robotic Arm Gripping
  • 11. Text Large Model + YOLOv11 + Intelligent Garbage Classification
18. AI Model – Voice Versionnew
  • 1. Semantic understand instruction following
  • 2. Multimodal visual understand
  • 3. Text Large Model + robotic arm control
  • 4. Multimodal Large Model+video understanding
  • 5. Multimodal Large Model+robotic arm gripping
  • 6. Multimodal Large Model+robotic arm tracking
  • 7. Multimodal Large Model+robotic arm sorting
  • 8. Multimodal Large Model+robotic arm handling
  • 9. Multimodal Large Model+Color Blocks Back In Place
  • 10. Multimodal Large Model + Intent Prediction + Robotic Arm Gripping
  • 11. Text Large Model + YOLOv11 + Intelligent Garbage Classification
19. AI Model – Fun Applicationsnew
  • 1.AI Butler-Intent Inference
  • 2.AI Encyclopedia-Arithmetic Master
  • 3.AI Encyclopedia-You asked I Pointed
  • 4.AI Encyclopedia-Nutritional Analysis
  • 5.AI Encyclopedia-Problem Solving Expert
  • 6.AI Encyclopedia-English Spelling
  • 7.AI Butler-Garbage Sorting
  • 8.AI Top Chef
20. MoveIt Course
  • 1. MoveIt Configuration
  • 2. MoveIt Usage
  • 3. MoveIt Drive Real Robot
  • 4. MoveIt Random Movement
  • 5. MoveIt Forward Kinematics Design
  • 6. MoveIt Inverse Kinematics Design
  • 7. MoveIt Cartesian Path
  • 8. MoveIt Scene Design
  • 9. MoveIt Trajectory Planning
  • 10. MoveIt Collision Detection
21. YOLOv11 Development Course (ORIN)
  • 1. YOLO Environment Setup
  • 2. CLI Usage
  • 3. Object Detection
  • 4. Instance Segmentation
  • 5. Pose Estimation
  • 6. Image Classification
  • 7. Oriented Bounding Boxes Object Detection
  • 8. Model Conversion
  • 9. Dataset Annotation
  • 10. Model Training_Conversion
  • 11. Model Prediction
22. YOLOv11 Development Course (Jetson Nano)
  • 1. YOLO Environment Setup
  • 2. CLI Usage
  • 3. Object Detection
  • 4. Instance Segmentation
  • 5. Pose Estimation
  • 6. Image Classification
  • 7. Oriented Bounding Boxes Object Detection
  • 8. Model Conversion
  • 9. Model Prediction
23. Linux Operating System
  • 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
24. Basic Control Course
  • 1. Control RGB Light
  • 2. Control Buzzer
  • 3. Control Single Servo
  • 4. Read Servo Angle
  • 5. Control All Servos
  • 6. DOFBOT Up Down Left Right Movement
  • 7.DOFBOT dancing
  • 8. DOFBOT Memory Actions
  • 9. DOFBOT Grab Blocks
  • 10. Porter
  • 11. Stack Blocks
  • 12. Two DOFBOT Synchronized Actions
25. Jetson Board Basic Course
  • 1. Jetson board Introduction
  • 2. Write system image
  • 3. Re-write system image
  • 4. System startup
  • 5. System and desktop introduction
  • 6. System expansion
  • 7. Network Configuration
  • 8. SSH remote login and file transfer
  • 9. VNC Remote Login
  • 10. System backup
  • 11. Increased swap space
  • 12. Use of Jtop
26. GPIO Hardware Control Course
Jetson Nano
  • 1.GPIO library API usage
  • 2. Hardware library configuration
  • 3. Pin reading function
  • 4. Pin level output control
  • 5. Control LED
  • 6. External device serial communication
  • 7.I2C communication
Jetson Orin Nano_NX
  • 1.GPIO description
  • 2.GPIO library installation
  • 3.GPIO reading
  • 4.GPIO output
  • 5.Serial communication
  • 6.I2C communication
27. OpenCV Course
  • 1. Introduction to Open Source CV
  • 2. Image reading and display
  • 3. Image writing
  • 4. Image quality
  • 5. Pixel Operation
  • 6. Image zoom
  • 7. Picture cut
  • 8. Picture pan
  • 9. Picture mirroring
  • 10. Affine transformation
  • 11. Picture rotation
  • 12. Perspective transformation
  • 13. Grayscale processing
  • 14. Binary image
  • 15. Edge green detection
  • 16. Line segment drawing
  • 17. Rectangular circle drawing
  • 18. Text and picture drawing
28. Visual Basics Course
  • 1. Camera display
  • 2. Color Calibration
  • 3. Color recognition
  • 4. Face Detection
  • 5.1 Garbage Identification(Jetson-Nano)
  • 5.2 Garbage Identification(Orin)
  • 6.1 Object Recognition(Jetson-Nano)
  • 6.2 Object Recognition(Orin)
  • 7. Label code recognition
  • 8.PID algorithm basics
29. 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
30. Visual Advanced Course
  • 1.QR code
  • 2.Human pose estimation
  • 3.Target Detection
  • 4.AR vision
  • 5.ROS+Opencv basics
  • 6.AR QR code
  • 7.Face recognition
  • 8.harris corner detection
  • 9.Target tracking algorithm
  • 10.Contour moment
  • 11.Polygon outline
  • 12.Discrete fourier transform algorithm
  • 13.Edge detection algorithm
  • 14.Face detection algorithm
  • 15.Optical flow detection algorithm
  • 16.Contour detection
  • 17.General contour detection
  • 18.Feature point tracking
  • 19.HLS color filtering
  • 20.Hough circle detection
  • 21.Hough linear detection
  • 22.HSV color filtering
  • 23.LK optical flow algorithm
  • 24.detection algorithm
  • 25.Phase dependent displacement detection
  • 26.Image pyramid sampling algorithm
  • 27.RGB color filtering
  • 28.Clear background detection algorithm
  • 29.Simplified optical flow algorithm
  • 30.Simple filter
  • 31.Threshold image processing
  • 32.Watershed segmentation algorithm
31. Jupyter Lab Usage Course
  • 1. Read the document before operation
  • 2. Jupyter lab environment construction tutorial
  • 3. Basic tutorial of Jupyter lab
  • 4. Jupyter widgets configuration tutorial
  • 5. Getting Started Tutorial for JupyterWidgets Controls
Download
  • APP(Android/iOS)
  • SystemFile_OrinNANOSUPER
  • SystemFile_OrinNXSUPER
  • SystemFile_NANO4GB_SUB
  • VM_File
  • Code
  • Instruction_Manual
  • Hardware_Info
  • 3D_Model_File
  • ROS2_Basic_VM
  • Tools
Download ZIP

Welcome to DOFBOT Pro repository

5. Multimodal Large Model+robotic arm gripping

Multimodal Large Model + Robotic Arm Gripping(Text Version)

Before running the function, you need to close the App and large programs. For the closing method, refer to [4. Preparation] - [1. Manage APP control services].

1. Function Description

After the program runs, input robotic arm gripping action commands through the terminal. Based on the type of object to be gripped, the large model will start external programs to control the robotic arm to grip the target object.

2. Startup

Users with Jetson-Nano mainboard version need to enter the docker container first and then input the following command. Users with Orin motherboard can directly open the terminal and input the following command:

ros2 launch largemodel largemodel_control.launch.py text_chat_mode:=True

Then open a second terminal and input the following command:

xxxxxxxxxx
ros2 run text_chat text_chat

The robotic arm gripping has the following action commands:

  • Pick by Machine Code ID: Sort Machine Codes 1, 2, 3, and 4. Blocks used: 30x30x30mm blocks.
  • Pick by Machine Code Height: Remove Machine Codes with a height greater than x cm (where x represents the height). Example: Remove Machine Codes taller than 5 cm. Blocks used: 30x30x30mm and 30x30x60mm blocks.
  • Pick by Color Block Height: Remove color blocks of color y with a height greater than x cm (where x represents the height, and y represents the color—Red, Green, Yellow, or Blue). Example: Remove red blocks taller than 5 cm. Blocks used: 30x30x30mm and 30x30x60mm blocks.
  • Pick Other Objects: Pick up the small yellow duck from the tabletop; pick up the blue rectangular block from the tabletop. Blocks used: 30x30x60mm blocks.

2.1. Grip by Machine Code ID

2.1.1. Startup

Input in the terminal that started text_chat:

xxxxxxxxxx
Sort machine code 2

image-20251128101518436

Then two terminals will open, starting the machine code recognition program and gripping program respectively. After recognizing machine code 2, the gripping program will control the robotic arm to descend and grip machine code 2, then place it at the set position, and finally return to the machine code recognition posture to prepare for the next gripping. This continues until no more machine code 2 is recognized, then it reports back to the large model and the task ends.

2.1.2. Task Planning

Plan the action function apriltag_sort(2), where the parameter 2 represents the ID of the machine code to be gripped.

2.1.3. Core Code Analysis

apriltag_sort function, source code located at: LargeModel_ws/src/largemodel/largemodel/action_service.py

​x
def apriltag_sort(self, target_id):  # Grip machine code
    #self.check_apriltag_sort()
    target_idf = float(target_id)
    #Start gripping program
    cmd1 = "ros2 run largemodel_arm grasp
    #Start machine code recognition program, passing parameter target_id
    cmd2 = f"ros2 run largemodel_arm apriltag_sort --ros-args -p target_id:={target_idf:.1f}"
    subprocess.Popen(
        [
            "gnome-terminal",
            "--title=grasp_desktop_apritag",
            "--",
            "bash",
            "-c",
            f"{cmd1}; exec bash",
        ]
    )
    subprocess.Popen(
        [
            "gnome-terminal",
            "--title=apriltag_sort",
            "--",
            "bash",
            "-c",
            f"{cmd2}; exec bash",
        ]
    )
​

Gripping program grasp, source code path at: LargeModel_ws/src/largemodel_arm/largemodel_arm/grasp.py

xxxxxxxxxx
#Create subscriber, subscribe to position information topic
self.sub = self.create_subscription(AprilTagInfo,'PosInfo',self.pos_callback,1)
#Position information topic callback function
def pos_callback(self,msg):
    pos_x = msg.x
    pos_y = msg.y
    pos_z = msg.z
    self.cur_tagId = msg.id
    if pos_z!=0.0:
        print("xyz id : ",pos_x,pos_y,pos_z,self.cur_tagId)
        #Start coordinate system transformation
        camera_location = self.pixel_to_camera_depth((pos_x,pos_y),pos_z)
        PoseEndMat = np.matmul(self.EndToCamMat, self.xyz_euler_to_mat(camera_location, (0, 0, 0)))
        EndPointMat = self.get_end_point_mat()
        WorldPose = np.matmul(EndPointMat, PoseEndMat) 
        #Convert rotation transformation matrix to xyz and Euler angles to get target pose
        pose_T, pose_R = self.mat_to_xyz_euler(WorldPose)
        pose_T[0] = pose_T[0] + self.x_offset
        pose_T[1] = pose_T[1] + self.y_offset
        pose_T[2] = pose_T[2] + self.z_offset
        print("pose_T: ",pose_T)
        if self.grasp_flag == True :
            print("Take it now.")
            self.grasp_flag = False
            #Pass target position information to grasp function for inverse kinematics to get each robotic arm angle value
            threading.Thread(target=self.grasp, args=(pose_T,)).start()
#Call inverse kinematics service, pass target position, get values for servos 1-5
def grasp(self,pose_T):
    print("------------------------------------------------")
    print("pose_T: ",pose_T)
​
    request = Kinemarics.Request()
    request.tar_x = pose_T[0] 
    request.tar_y = pose_T[1] + 0.01
    request.tar_z = pose_T[2] + 0.01
    request.kin_name = "ik"
    request.roll = -1.0 #((2.5*request.tar_y*100)-207.5)*(math.pi / 180)
​
    # print("calcutelate_request: ",request)
    
    try:
        future = self.client.call_async(request)
        rclpy.spin_until_future_complete(self, future, timeout_sec=5.0) 
        response = future.result()
        print("calcutelate_response: ",response)
        joints = [0.0, 0.0, 0.0, 0.0, 0.0,0.0]
        joints[0] = response.joint1 #response.joint1
        joints[1] = response.joint2 
        joints[2] = response.joint3 

Machine code recognition program apriltag_sort, source code path at: LargeModel_ws/src/largemodel_arm/largemodel_arm/apriltag_sort.py,

xxxxxxxxxx
#Get target sorting id through command line arguments
self.declare_parameter('target_id', 0.0)
self.TargetID = int(self.get_parameter('target_id').get_parameter_value().double_value)
​
#Create publisher, publish position information topic
self.pos_info_pub = self.create_publisher(AprilTagInfo, "PosInfo", qos_profile=10)
​
#Image callback function
def TagDetect(self,color_frame,depth_frame):
    #rgb_image
    rgb_image = self.rgb_bridge.imgmsg_to_cv2(color_frame,'rgb8')
    result_image = np.copy(rgb_image)
    #depth_image
    depth_image = self.depth_bridge.imgmsg_to_cv2(depth_frame, encoding[1])
    depth_to_color_image = cv.applyColorMap(cv.convertScaleAbs(depth_image, alpha=1.0), cv.COLORMAP_JET)
    frame = cv.resize(depth_image, (640, 480))
    depth_image_info = frame.astype(np.float32)
    #Machine code recognition
    tags = self.at_detector.detect(cv2.cvtColor(rgb_image, cv2.COLOR_RGB2GRAY), False, None, 0.025)
    tags = sorted(tags, key=lambda tag: tag.tag_id) 
    draw_tags(result_image, tags, corners_color=(0, 0, 255), center_color=(0, 255, 0))
    key = cv2.waitKey(10)
    if self.count==True:
        if (time.time() - self.start_time)>10:
            self.pubPos_flag = True
            self.count = False
    if key == 32:
        self.pubPos_flag = True
    if len(tags) > 0 :
        for i in range(len(tags)):
            center_x, center_y = tags[i].center
            cur_id = tags[i].tag_id
            cv.circle(depth_to_color_image,(int(center_x),int(center_y)),1,(255,255,255),10)
            #If current id is target sorting id, it means found, so self.detect_flag value is True, and record current array index for subsequent value retrieval
            if self.pubPos_flag == True and cur_id == self.TargetID:
                self.detect_flag = True
                print("Found the target.")
                self.index = i
                center_x, center_y = tags[self.index].center
                cv.circle(result_image, (int(center_x),int(center_y)), 10, (0,210,255), thickness=-1)
                
                pos = AprilTagInfo()
                #Get xy coordinates of target machine code, center point depth value and id
                pos.id = tags[self.index].tag_id
                pos.x = center_x
                pos.y = center_y
                pos.z = depth_image_info[int(center_y),int(center_x)]/1000
                vx = int(tags[self.index].corners[0][0]) - int(tags[self.index].corners[1][0])
                vy = int(tags[self.index].corners[0][1]) - int(tags[self.index].corners[1][1])
                target_joint5 = compute_joint5(vx,vy)
                if pos.z>0:
                    self.joint5.data = int(target_joint5)
                    self.TargetJoint5_pub.publish(self.joint5)   
                    #Publish position information topic data message
                    self.pos_info_pub.publish(pos)
                    self.pubPos_flag = False
                else:
                    print("Invalid distance.")
         #Machine code not found           
        if  self.detect_flag == False and self.TargetID!=0 and self.pubPos_flag==True:
            self.pubPos_flag = False
            print("Did not find the target.")
            self.largemodel_arm_done_pub.publish( String(data='apriltag_sort_done'))
            self.TargetID = 0

2.2. Grip by Machine Code Height

2.2.1. Startup

Input in the terminal that started text_chat:

xxxxxxxxxx
Remove machine codes with height higher than 3 cm

image-20251128112316617

Then two terminals will open, starting the machine code recognition height calculation program and gripping program respectively. After recognizing machine codes with height higher than 3 cm, the gripping program will control the robotic arm to descend and grip the abnormal height machine codes, then place them at the set position, and finally return to the machine code recognition posture to prepare for the next gripping. This continues until no more abnormal height machine codes are recognized, then it reports back to the large model and the task ends.

2.2.2. Task Planning

Plan the action function apriltag_remove_higher(30.0), where the parameter 30 represents the height threshold. Machine codes with height higher than this value will be removed, unit is millimeters mm.

2.2.3. Core Code Analysis

apriltag_remove_higher function, source code located at: LargeModel_ws/src/largemodel/largemodel/action_service.py

xxxxxxxxxx
def apriltag_remove_higher(self, target_high):  # Remove machine codes of specified height
    target_highf = float(target_high) / 100
    #Robotic arm gripping program
    cmd1 = "ros2 run largemodel_arm grasp"
    #Machine code height calculation program, passing parameter target_high, which is the height threshold
    cmd2 = f"ros2 run largemodel_arm apriltag_remove_higher --ros-args -p target_high:={target_highf:.2f}"
    subprocess.Popen(
        [
            "gnome-terminal",
            "--title=grasp_desktop_remove",
            "--",
            "bash",
            "-c",
            f"{cmd1}; exec bash",
        ]
    )
    subprocess.Popen(
        [
            "gnome-terminal",
            "--title=apriltag_remove_higher",
            "--",
            "bash",
            "-c",
            f"{cmd2}; exec bash",
        ]
    )

The grasp program was analyzed in the previous section and will not be repeated here. Now let's analyze the apriltag_remove_higher program, whose source code is located at: LargeModel_ws/src/largemodel_arm/largemodel_arm/apriltag_remove_higher.py

xxxxxxxxxx
#Get height threshold through command line arguments
self.declare_parameter('target_high', 0.0)
self.Target_height = self.get_parameter('target_high').get_parameter_value().double_value * 100
#Height calculation function, with three parameters xyz, xy represents the center point coordinates of the machine code, z is the depth information of the center point
def compute_heigh(self,x,y,z):
    #Start coordinate system transformation
    camera_location = self.pixel_to_camera_depth((x,y),z)
    PoseEndMat = np.matmul(self.EndToCamMat, self.xyz_euler_to_mat(camera_location, (0, 0, 0)))
    EndPointMat = self.get_end_point_mat()
    WorldPose = np.matmul(EndPointMat, PoseEndMat) 
    #Convert rotation transformation matrix to xyz and Euler angles to get target pose, where pose_T[2] represents the height value
    pose_T, pose_R = self.mat_to_xyz_euler(WorldPose)
    pose_T[0] = pose_T[0] + self.x_offset
    pose_T[1] = pose_T[1] + self.y_offset
    pose_T[2] = pose_T[2] + self.z_offset        
    return pose_T
#Get current machine code height
compute_height = round(pose[2],4)*1000 
heigh = 'heigh: ' + str(compute_height) + 'mm'
cv.putText(result_image, heigh, (int(cx)+5, int(cy)-15), cv.FONT_HERSHEY_SIMPLEX, 0.5, (255, 0, 0), 2)
#If current height value is greater than height threshold, change self.detect_flag value to true, and set self.compute_height to false, this is to avoid recalculating height when gripping action is completed
if compute_height > self.Target_height and self.pubPos_flag == True and self.compute_height == True:
    print("Found the target.")
    self.found_cnt = self.found_cnt + 1
    self.compute_height = False
    self.index = i
    self.detect_flag = True

2.3. Grip by Color Block Height

2.3.1. Startup

Input in the terminal that started text_chat:

xxxxxxxxxx
Remove green blocks with height higher than 3 cm

Then two terminals will open, starting the color block recognition height calculation program and gripping program respectively. After recognizing green blocks with height higher than 3 cm, the gripping program will control the robotic arm to descend and grip these blocks, then place them at the set position, and finally return to the recognition posture to prepare for the next gripping. This continues until no more abnormal height green blocks are recognized, then it reports back to the large model and the task ends.

2.3.2. Task Planning

Plan the action function color_remove_higher('green',30.0), 'green' indicates the color block to be sorted is green blocks, the parameter 30 represents the height threshold. Machine codes with height higher than this value will be removed, unit is millimeters mm.

2.3.3. Core Code Analysis

color_remove_higher function, source code located at: LargeModel_ws/src/largemodel/largemodel/action_service.py

xxxxxxxxxx
def color_remove_higher(self, color, target_high):
    arm_joints = [90, 110, 0, 0, 90, 0]
    self.pubSix_Arm(arm_joints)
    color = color.strip("'\"")  # Remove single and double quotes
    target_highf = float(target_high) / 10
    #Modify target_color value based on passed value for easy passing to color_remove_higher
    if color == "red":
        target_color = float(1)
    elif color == "green":
        target_color = float(2)
    elif color == "blue":
        target_color = float(3)
    elif color == "yellow":
        target_color = float(4)
    else:
        self.get_logger().info(
            "Fatal ERROR:Incorrect color input,Does the AI output not meet expectations?"
        )
        self.action_status_pub(
            "color_remove_higher_failed", color=color, target_high=target_high
        )
        return
    #Robotic arm gripping program
    cmd1 = "ros2 run largemodel_arm grasp"
    #Color block recognition and height calculation node, passing two parameters, first is target_high height threshold, second is target_color color block color
    cmd2 = f"ros2 run largemodel_arm color_remove_higher --ros-args -p target_high:={target_highf:.2f} -p target_color:={target_color:.1f}"
    subprocess.Popen(
        [
            "gnome-terminal",
            "--title=grasp_desktop_remove_color",
            "--", 
            "bash",
            "-c",
            f"{cmd1}; exec bash",
        ]
    )
    subprocess.Popen(
        [
            "gnome-terminal",
            "--title=color_remove_higher",
            "--",
            "bash",
            "-c",
            f"{cmd2}; exec bash",
        ]
    )

The grasp program was analyzed before and will not be repeated here. Now let's analyze the color_remove_higher program, whose source code is located at: LargeModel_ws/src/largemodel_arm/largemodel_arm/color_remove_higher.py

xxxxxxxxxx
#Get target color block color through command line arguments
self.declare_parameter('target_color', 0.0)
self.target_color = int(self.get_parameter('target_color').get_parameter_value().double_value)
print("Get self.target_color is ",self.target_color)
#Get height threshold through command line arguments
self.declare_parameter('target_high', 0.0)
self.target_high = self.get_parameter('target_high').get_parameter_value().double_value * 1.0
print("Get self.target_high is ",self.target_high)
​
#In the process function, we determine self.hsv_range value based on self.target_color value, by reading read_HSV to read color hsv file
elif self.Track_state == "identify":
    if self.target_color == 1:
        self.hsv_range = read_HSV(self.red_hsv_text)
        self.cur_color = "red"
        self.text_color = (0, 0, 255)
​
        
    elif self.target_color == 2:
        self.hsv_range = read_HSV(self.green_hsv_text)
        self.cur_color = "green"
        self.text_color = (0, 255, 0)
​
        
    elif self.target_color == 3:
        self.hsv_range = read_HSV(self.blue_hsv_text)
        self.cur_color = "blue"
        self.text_color = (255, 0, 0)
        
    elif self.target_color == 4:
        self.hsv_range = read_HSV(self.yellow_hsv_text)
        self.cur_color = "yellow"
        self.text_color = (255, 255, 0)
        
    else: 
        self.Track_state = 'init'
​
if self.Track_state != 'init':
    if len(self.hsv_range) != 0:
        #Call external library function object_follow_list for color recognition, get center point information of command color block
        rgb_img, binary, self.CX_list,self.CY_list,self.R_list_,self.corners= self.color.object_follow_list(rgb_img, self.hsv_range)
#In callback function
if len(self.CX_list)>0 and self.done_flag==True and self.compute_height==True:
    for i in range(len(self.CX_list)):
        #Here inscribed circle radius judgment greater than 30 is to filter out some small points
        if self.R_list_[i]>30:
            cx = int(self.CX_list[i])
            cy = int(self.CY_list[i])
            dist = depth_image_info[int(cy),int(cx)]/1000
            pose = self.compute_heigh(cx,cy,dist)
            compute_heigh = round(pose[2],2)*100
            heigh = 'heigh: ' + str(compute_heigh) + ' cm'
            cv.putText(result_frame, heigh, (int(cx)+10, int(cy)-25), cv.FONT_HERSHEY_SIMPLEX, 0.5, (255, 0, 0), 2)
            #If current color block height is greater than height threshold, change self.detect_flag value to true, indicating found
            if  compute_heigh > self.target_high and self.pub_pos_flag == True :
                self.index = i
                self.detect_flag = True
                self.compute_height = False
                self.found_cnt = self.found_cnt + 1
                
            #If abnormal height color block is found and array index is not None, then read the center point coordinates and center depth value of this color block
            if self.detect_flag == True and self.index != None:
                cx = int(self.CX_list[self.index])
                cy = int(self.CY_list[self.index])
                vx = self.corners[0][0][0] - self.corners[1][0][0]
                vy = self.corners[0][0][1] - self.corners[1][0][1] 
                target_joint5 = compute_joint5(vx,vy)
                dist = depth_image_info[int(cy),int(cx)]/1000 
                cv.putText(result_frame, heigh, (int(cx)+10, int(cy)-25), cv.FONT_HERSHEY_SIMPLEX, 0.5, (255, 0, 0), 2)
                if dist!=0 and self.pub_pos_flag == True:
                    pos = AprilTagInfo()
                    pos.id = self.target_color
                    pos.x = float(cx)
                    pos.y = float(cy)
                    pos.z = float(dist)
                    if self.pub_pos_flag == True:
                        self.joint5.data = int(target_joint5)
                        self.TargetJoint5_pub.publish(self.joint5) 
                        self.index = None
                        self.pub_pos_flag = False
                        self.done_flag = False
                        #Publish position information topic data of abnormal height color block
                        self.pos_info_pub.publish(pos)  
                        print("Publish the position.")

2.4. Grip Other Objects

2.4.1. Startup

Input in the terminal that started text_chat:

xxxxxxxxxx
Grip the small yellow duck on the desktop

image-20251128142013254

The program will first take a photo to determine the position of the small yellow duck, then open two terminals, starting the KCF tracking positioning program and object gripping program respectively. After calculation, the robotic arm will descend to grip the small yellow duck and finally return to the initial posture.

2.4.2. Task Planning
  1. Call seehat() to check the position of the small yellow duck;
  2. Call grasp_obj(x1,y1,x2,y2) gripping function, where x1,y1,x2,y2 represent the top-left and bottom-right corner coordinates of the small yellow duck's outer bounding box.
2.4.3. Core Code Analysis

The seehat() function was analyzed in the previous tutorial [2. Multimodal Visual Understanding] and will not be repeated here. Let's mainly look at the grasp_obj function, source code located at: LargeModel_ws/src/largemodel/largemodel/action_service.py

xxxxxxxxxx
def grasp_obj(self, x1, y1, x2, y2):
    """
    Grip object
    x1,y1,x2,y2: Object outer bounding box coordinates
    """
    #Arm.Arm_serial_servo_write6(90,120,12,20,90,30,1000)
    #self.check_close_grasp_obj()
    #Object gripping program
    cmd1 = "ros2 run largemodel_arm KCF_Grap_Move"
    #KCF tracking positioning program
    cmd2 = "ros2 run largemodel_arm ALM_KCF_Tracker"
    # cmd3 = "ros2 run --prefix 'gdb -ex run --args' M3Pro_KCF ALM_KCF_Tracker_Node"
    subprocess.Popen(
        [
            "gnome-terminal",
            "--title=ALM_KCF_Tracker",
            "--",
            "bash",
            "-c",
            f"{cmd2}; exec bash",
        ]
    )
    time.sleep(5.0) #Wait for ALM_KCF_Tracker to start up
    subprocess.Popen(
        [
            "gnome-terminal",
            "--title=grasp_desktop",
            "--",
            "bash",
            "-c",
            f"{cmd1}; exec bash",
        ]
    )
    time.sleep(2.0)
    if self.stack_flag == True:
        self.get_logger().info('Publish the stack_step topic...') 
        step_ = Int16()
        step_.data = self.step
        self.step_pub.publish(step_)
        self.step = self.step + 1
    #Publish outer bounding box coordinate information topic data, ALM_KCF_Tracker node will subscribe to this topic
    x1 = int(x1)
    y1 = int(y1)
    x2 = int(x2)
    y2 = int(y2)
    self.object_position_pub.publish(Int16MultiArray(data=[x1, y1, x2, y2]))

KCF_Grap_Move program, source code location at: LargeModel_ws/src/largemodel_arm/largemodel_arm/KCF_Grap_Move.py

xxxxxxxxxx
#Import library, this library's path is LargeModel_ws/src/largemodel_arm/largemodel_arm/Dofbot_Track.py
from largemodel_arm.Dofbot_Track import *
​
#Create robotic arm tracking gripping object
self.dofbot_tracker = DofbotTrack()
​
#Create subscriber, subscribe to /pos_xyz topic
self.pos_sub = Subscriber(self,Position,'/pos_xyz')
​
#Callback function
def TrackAndGrap(self,position):  
    center_x, center_y = position.x,position.y
    self.cur_distance = position.z
    if self.done == True:
        self.get_current_end_pos() 
        self.get_logger().info('-*-*-*-*-*-*-*-*-*-*')
        print("self.CurEndPos: ",self.CurEndPos)
        #Call external library function Clamping
        self.dofbot_tracker.Clamping(center_x,center_y,self.cur_distance,self.CurEndPos)
        self.done = False
        
#View Clamping function in Dofbot_Track.py
def Clamping(self,cx,cy,cz,CurEndPos): 
    self.CurEndPos = CurEndPos
    #Start coordinate system transformation
    camera_location = self.pixel_to_camera_depth((cx,cy),cz)
    print("cz: ",cz)
    PoseEndMat = np.matmul(self.EndToCamMat, self.xyz_euler_to_mat(camera_location, (0, 0, 0)))
    EndPointMat = self.get_end_point_mat()
    WorldPose = np.matmul(EndPointMat, PoseEndMat)
    #Convert rotation transformation matrix to xyz and Euler angles
    pose_T, pose_R = self.mat_to_xyz_euler(WorldPose)
    pose_T[0] = pose_T[0] + self.x_offset
    pose_T[1] = pose_T[1] + self.y_offset
    pose_T[2] = pose_T[2] + self.z_offset
    print("pose_T: ",pose_T)
    #Create inverse kinematics service object and assign the calculated pose_T representing target position to it
    request = Kinemarics.Request()
    if pose_T[0]>0:
        request.tar_x = pose_T[0] +0.01
    else:
        request.tar_x = pose_T[0] - 0.01
    request.tar_z = pose_T[2] 
    request.tar_y = pose_T[1] + request.tar_z*0.2
    request.kin_name = "ik"
    request.roll =  -1.0    
    print("calcutelate_request: ",request)
    
    try:
        #Call inverse kinematics service, calculate to get servo values 1-4
        future = self.client.call_async(request)
        rclpy.spin_until_future_complete(self, future, timeout_sec=10.0) 
        response = future.result()
        joints = [0.0, 0.0, 0.0, 0.0, 0.0,0.0]
        joints[0] = response.joint1 #response.joint1  
        joints[1] = response.joint2
        joints[2] = response.joint3
        if response.joint4>90:
            joints[3] = 90.0
        else:
            joints[3] = response.joint4
        joints[4] = 90.0
        joints[5] = 20.0
        print("compute_joints: ",joints)

ALM_KCF_Tracker program, source code location at: LargeModel_ws/src/largemodel_arm/largemodel_arm/ALM_KCF_Tracker.py

xxxxxxxxxx
#Create publisher, publish object position information
self.pub_pos = self.create_publisher(Position, "/pos_xyz", 10)
#Create subscriber, subscribe to object outer bounding box information
self.xy_subscription = self.create_subscription(Int16MultiArray,'corner_xy',self.GetXYCallback,qos_profile=1)
​
#Callback function
def GetXYCallback(self,msg):
    print("msg: ",msg.data)
    print(msg.data[0])
    print(msg.data[1])        
    print(msg.data[2])
    print(msg.data[3])
    #Assign self.Roi_init value to topic data message data
    self.Roi_init = (msg.data[0],msg.data[1],msg.data[2],msg.data[3])
    self.Track_state = 'identify'
    self.get_xy = True
    self.rect = [msg.data[0],msg.data[1],msg.data[2],msg.data[3]]
    
#In process function, initialize KCF based on self.Roi_init value
if self.gTracker_state == True:
    Roi = (self.Roi_init[0], self.Roi_init[1], self.Roi_init[2] - self.Roi_init[0], self.Roi_init[3] - self.Roi_init[1])
    self.compute_roi = True
    print("Roi: ",Roi)
    self.gTracker = Tracker(tracker_type=self.tracker_type)
    self.gTracker.initWorking(rgb_img, Roi)
    self.gTracker_state = False
#KCF tracking, get object center point information
rgb_img, (targBegin_x, targBegin_y), (targEnd_x, targEnd_y) =   self.gTracker.track(rgb_img)
center_x = targEnd_x / 2 + targBegin_x / 2
center_y = targEnd_y / 2 + targBegin_y / 2
self.cx = center_x
self.cy = center_y
#In kcfTrack image callback function
#Assign calculated center point coordinates to center_x, center_y
center_x, center_y = self.cx,self.cy
cv2.circle(depth_to_color_image,(int(center_x),int(center_y)),1,(255,255,255),10)
#Calculate center point depth distance information
self.cur_distance = depth_image_info[int(center_y),int(center_x)]/1000.0
dist = round(self.cur_distance,3)
dist = 'dist: ' + str(dist) + 'm'
cv.putText(result_frame, dist,  (30, 30), cv.FONT_HERSHEY_SIMPLEX, 1.0, (255, 0, 0), 2)
pos = Position()
pos.x = center_x
pos.y = center_y
pos.z = self.cur_dis  tance
Track_pos = Position()
Track_pos.x = center_x
Track_pos.y = center_y
#Publish position information topic data
self.pub_track_pos.publish(Track_pos)
​

 

Multimodal Large Model+video understanding
Multimodal Large Model+robotic arm tracking

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