RAE SDK
最后更新
要求
- 将机器人的固件升级到最新版本 (Luxonis OS 1.14)。
固件更新后,您可能仍然会看到升级到最新版本的选项。这是一个已知问题,您可以安全地忽略它。只要您安装了 Luxonis OS 1.14 和 Agent 版本 23.223.1855,您就可以正常使用了。
- 在 robotapp.toml 文件中指定正确的镜像。截至撰写本指南时,最新镜像为
ghcr.io/luxonis/rae-ros:v0.2.2-humble。
机器人
Robot 类是 SDK 的主要入口点。它提供对所有机器人组件的访问,并允许您 控制它们。 它包含以下属性(更多内容将在后续章节中介绍):- ROS 接口
- LED
- 显示屏
- 音频
- 运动
- 感知系统
Python
1from rae_sdk.robot import Robot
2
3robot = Robot()机器人选项
Python
1from rae_sdk.robot import Robot, RobotOptions
2
3options = RobotOptions(name='rae_sdk', namespace='', launch_controllers=True, start_hardware=True, launch_mock=False)
4
5robot = Robot(options)name- Robot 类将创建的 ROS 节点的名称。默认值:rae_sdknamespace- Robot 类将创建的 ROS 节点的命名空间。默认值:''launch_controllers- 是否初始化 SDK 组件,例如 LED、显示屏、音频、导航、状态。默认值:Truelaunch_mock- 是否启动模拟硬件驱动程序而不是真实的驱动程序,主要用于测试。默认值:Falsestart_hardware- 是否启动外设和车轮的硬件驱动程序。默认值:True
robot.stop()。SDK 组件
LED
Python
1from rae_sdk.robot import Robot
2
3robot = Robot()
4
5robot.led.set_leds('#FF0000', 100, 'solid', 1) # 将颜色设置为红色Python
1from rae_sdk.robot import Robot
2from rae_msgs.msg import LEDControl, ColorPeriod
3
4robot = Robot()
5
6led_control = LEDControl()
7
8color_msg = ColorPeriod()
9color_msg.frequency = 1.0
10color_msg.color.a = 1.0
11color_msg.color.r = 1.0
12color_msg.color.g = 0.0
13color_msg.color.b = 0.0
14led_msg.data = [color_msg]
15
16led_msg.control_type = LEDControl.CTRL_TYPE_ALL
17
18robot.set_leds_from_msg(led_msg)显示屏
Python
1import cv2
2from rae_sdk.robot import Robot
3
4robot = Robot()
5
6img = cv2.imread('image.jpg')
7robot.display.display_image(img)音频
Python
1from rae_sdk.robot import Robot
2
3robot = Robot()
4
5robot.audio.play_audio_file('file.mp3')导航
Python
1from rae_sdk.robot import Robot
2
3robot = Robot()
4
5robot.navigation.move(0.5, 0.5) # 以 0.5 米/秒的速度和 0.5 弧度/秒的角速度向前移动
6
7position = robot.navigation.get_odom_position()状态
Python
1from rae_sdk.robot import Robot
2
3robot = Robot()
4
5battery_level = robot.state.battery_state.capacityROS 接口
rclpy 库来启动自己的执行器和节点,用于与 ROS2 通信。它还使用 ROS2 启动 系统来启动机器人节点。 它对用户是抽象的,但可以通过 robot.ros_interface 属性访问。例如, 让我们创建一个发布者,以 1 Hz 的频率向 /test_topic 主题发布消息:Python
1from rae_sdk.robot import Robot
2from std_msgs.msg import String
3
4robot = Robot()
5
6def timer_callback():
7 msg = String()
8 msg.data = 'Hello world!'
9 robot.ros_interface.publish('/test_topic', msg)
10
11robot.ros_interface.create_publisher('/test_topic', String)
12robot.ros_interface.create_timer(1.0, timer_callback)/test_topic 主题:Python
1from rae_sdk.robot import Robot
2from std_msgs.msg import String
3
4def callback(msg):
5 print(msg.data)
6
7robot = Robot()
8
9robot.ros_interface.create_subscription('/test_topic', String, callback)Python
1from rae_sdk.robot import Robot
2from std_srvs.srv import Trigger
3
4robot = Robot()
5
6robot.ros_interface.create_service_client('/test_service', Trigger)
7robot.ros_interface.call_async_srv('/test_service', Trigger.Request())Python
1from rae_sdk.robot import Robot
2from example_interfaces.action import Fibonacci
3
4def feedback_callback(feedback_msg):
5 print('收到反馈:', feedback_msg.feedback.sequence)
6
7def result_callback(future):
8 result = future.result().result
9 print('收到结果:', result.sequence)
10
11robot = Robot()
12
13robot.ros_interface.create_action_client('/test_action', Fibonacci)
14robot.ros_interface.call_async_action("/fibonacci", Fibonacci.Goal(order=10), None, self.result_cb, self.feedback_cb)
15
16# 取消目标 robot.ros_interface.cancel_action("/fibonacci")资源
assets 文件夹中找到它们。 目前,这些资源包括一组用于机器人的面部图像和一些可用于基本交互的示例音频文件。