智能佳机器人知识社区

GELLO Franka FR3 ROS2 环境搭建与开发指南

Mon, 29 Jun 2026 23:59:59 +0800

参考：https://github.com/wuphilipp/gello_software/blob/main/ros2/README.md

适用：Franka FR3 机械臂 + GELLO 遥操作手臂

1. 项目概述

本项目提供 GELLO 遥操作手臂与 Franka FR3 机械臂之间的完整 ROS2 接口。

核心功能

功能模块	说明
GELLO 状态发布	读取 Dynamixel 舵机角度，发布为 ROS2 话题
关节阻抗控制	订阅 GELLO 状态，转换为 FR3 力矩指令
夹爪管理	支持 Franka Hand 和 Robotiq 2F-85 两种夹爪

硬件组成

GELLO 单臂版：

├─ 7 个 Dynamixel XL330-M288 舵机（7 DOF）

├─ U2D2 或 OpenRB-150 通信板

└─ Franka Hand 或 Robotiq 2F-85 夹爪

GELLO 双臂版（Duo）：

├─ 2 × 7 = 14 个 Dynamixel 舵机

├─ 2 个通信板

└─ 双臂协同控制

硬件连线:单臂版本

2. 环境搭建

方式一：VS Code Dev Container（⭐ 推荐）

最适合：快速上手，环境一致，避免依赖地狱。

步骤

1. 打开项目
用 VS Code 打开 gello_software 仓库中的 ros2/ 子文件夹
（注意：不是整个 gello_software 文件夹）

2. 启动容器
- 如果弹出提示：「Reopen in Container」 → 点击确认
- 如果没有提示：按 Ctrl+Shift+P → 输入 Dev Containers: Reopen in Container

3. 等待构建
- 第一次构建需要几分钟（自动安装所有依赖）

- 构建完成后，终端自动进入容器环境

⚠️ 注意事项

● 版本匹配：Dev Container 中的libfranka、franka_ros2、franka_description版本需要与你的 Franka 机器人系统版本匹配。

● 修改版本：如果需要调整版本，编辑ros2/.devcontainer/Dockerfile中的版本参数。

● 兼容性文档：参考Franka 官方兼容性表

方式二：本地安装

最适合：需要深度定制，或无法使用 Docker 的环境。

前置依赖

依赖项	安装指南
ROS2 Humble Desktop	官方安装教程
libfranka	Franka 官方文档
franka_ros2	同上（注意版本匹配）
ros2_robotiq_gripper	GitHub 仓库
Cyclone DDS	ROS2 RMW 文档

安装示例（参考 Dockerfile）

# 这些命令可以从 ros2/.devcontainer/Dockerfile 中复制

# 根据你的系统环境调整路径和版本

# 示例：安装 libfranka

cd ~

git clone --branch 0.15.0 https://github.com/frankarobotics/libfranka.git

cd libfranka

mkdir build && cd build

cmake .. -DCMAKE_BUILD_TYPE=Release

make -j$(nproc)

sudo make install

# 安装 franka_ros2

mkdir -p ~/franka_ws/src

cd ~/franka_ws/src

git clone --branch humble https://ghfast.top/https://github.com/frankarobotics/franka_ros2.git

cd ..

rosdep install --from-paths src --ignore-src -r -y

colcon build --symlink-install

安装工作区依赖

# 进入 ros2 工作区

cd ~/projects/ros2Gello/gello_software/ros2

# 运行依赖安装脚本

bash install_workspace_dependencies.bash

▎ 提示：如果添加了新依赖，记得更新 requirements.txt、requirements_dev.txt 或 package.xml，然后重新运行脚本。

3. 快速开始

场景 A：预组装 Franka GELLO 单臂版（带 Franka Hand）

配置步骤

1. 修改配置文件
   - franka_gello_single.yaml → 设置 com_port
   - example_fr3_config_franka_hand.yaml → 设置 com_port
   - example_fr3_config.yaml → 设置 robot_ip

2. 启动命令

# 【重要】如果使用 Dev Container，/workspace/ 就是 ros2/ 文件夹

# 本地安装请把 /workspace/ 替换成你的 gello_software 路径

# Step 1: 进入工作区，构建，加载环境

cd ~/projects/ros2Gello/gello_software/

colcon build

source install/setup.bash

# Step 2: 启动 GELLO 节点（读取手柄状态）

ros2 launch franka_gello_state_publisher main.launch.py config_file:=franka_gello_single.yaml

# Step 3: 启动 Franka Hand 夹爪节点

ros2 launch franka_gripper_manager franka_gripper_client.launch.py config_file:=example_fr3_config_franka_hand.yaml

# Step 4: 启动机器人控制器

# 【注意】先握住 GELLO 手柄，放在舒适位置（距离底座一定距离）

# 启动后机器人会直接同步到 GELLO 的当前位置

# 同步过程中不要突然移动 GELLO，避免机器人剧烈动作

ros2 launch franka_fr3_arm_controllers franka_fr3_arm_controllers.launch.py robot_config_file:=example_fr3_config.yaml

场景 B：预组装 Franka GELLO Duo 双臂版（带 Robotiq 夹爪）

配置步骤

1. 修改配置文件
   - franka_gello_duo.yaml → 设置 com_port（两个手柄需要两个端口）
   - example_fr3_duo_config_robotiq.yaml → 设置 com_port
   - example_fr3_duo_config.yaml → 设置 robot_ip

2. 启动命令

cd ~/projects/ros2Gello/gello_software/ros2/

colcon build

source install/setup.bash

# 启动两个 GELLO 手柄

ros2 launch franka_gello_state_publisher main.launch.py config_file:=franka_gello_duo.yaml

# 启动 Robotiq 夹爪

ros2 launch franka_gripper_manager robotiq_gripper_controller_client.launch.py config_file:=example_fr3_duo_config_robotiq.yaml

# 启动机器人控制器（双臂）

# 【注意】双手握住 GELLO 手柄，放在舒适位置

ros2 launch franka_fr3_arm_controllers franka_fr3_arm_controllers.launch.py robot_config_file:=example_fr3_duo_config.yaml

4. 详细启动流程

4.1 启动 GELLO 发布器

Step 1：确定通信端口 ID

# 插入 U2D2 或 OpenRB-150 后运行

ls /dev/serial/by-id

输出示例：

# U2D2:

usb-FTDI_USB__-__Serial_Converter_FT7WBG6

# OpenRB-150:

usb-ROBOTIS_OpenRB-150_2B375CB3503059384C2E3120FF053624-if00

记录这个 ID，后面要填到配置文件中。

Step 2：校准装配偏移（仅自制 GELLO 需要）

▎ ⚡ 跳过此步骤的条件：
- 使用官方预组装的 "Franka GELLO" 或 "Franka GELLO Duo"
- 严格按照官方组装指南装配

▎ 满足以上条件，可以直接用 franka_gello_state_publisher/config/ 里的默认配置文件。

如果是自己组装的 GELLO，需要确定以下参数：

参数	说明	默认值（官方组装）
joint_signs	每个关节的方向符号（1 或 -1）	1 -1 1 -1 1 1 1
assembly_offsets	装配偏移（由于 Dynamixel 法兰有 4 种安装方向，可能需要 ±90° 偏移）	0 0 0 0 0 0 0
gripper_range_rad	夹爪开合对应的关节角度范围	根据组装确定

使用校准脚本：

# 进入脚本目录

cd ~/projects/ros2Gello/gello_software/ros2/src/franka_gello_state_publisher/scripts/

# 单臂 GELLO 校准

python3 get_offsets.py \
    --start-joints 0 0 0 -1.57 0 1.57 0 \
    --joint-signs 1 -1 1 -1 1 1 1 \
    --port /dev/serial/by-id/<你的端口ID>

# 双臂左臂校准

python3 get_offsets.py \
    --start-joints -1.57 -0.80 1.80 -3.00 1.40 1.50 -2.10 \
    --joint-signs 1 -1 1 -1 1 1 1 \
    --port /dev/serial/by-id/<你的端口ID>

# 双臂右臂校准

python3 get_offsets.py \
    --start-joints 1.57 -0.80 -1.80 -3.00 -1.40 1.50 2.10 \
    --joint-signs 1 -1 1 -1 1 1 1 \
    --port /dev/serial/by-id/<你的端口ID>

校准姿势参考：

单臂：参见

双臂：参见

脚本输出：会显示 assembly_offsets 和 gripper_range_rad 的建议值。

应用校准结果：
1. 打开你的配置文件（在 franka_gello_state_publisher/config/ 目录）
2. 更新 assembly_offsets 和 gripper_range_rad 字段
3. 重新构建工作区：

cd ~/projects/ros2Gello/gello_software/ros2

colcon build

Step 3：启动 GELLO 发布器节点

创建或编辑配置文件：
- 位置：src/franka_gello_state_publisher/config/your_config.yaml
- 或者直接使用提供的示例文件

配置参数说明：

参数	说明	示例
com_port	通信端口 ID	/dev/serial/by-id/usb-FTDI_USB...
namespace	ROS2 命名空间（需与机器人和夹爪一致）	franka
num_joints	关节数量（Franka FR3 = 7）	7
joint_signs	关节方向符号	[1, -1, 1, -1, 1, 1, 1]
gripper	是否使用 GELLO 夹爪状态	true
assembly_offsets	装配偏移	[0, 0, 0, 0, 0, 0, 0]
gripper_range_rad	夹爪角度范围	[0.0, 1.0]
dynamixel_torque_enable	是否使能力矩	[1, 1, 0, 1, 0, 0, 0]
dynamixel_goal_position	目标位置（脉冲，4095 = 360°）	[2048, ...]
dynamixel_kp_p	比例增益（虚拟弹簧刚度）	[280, ...]
dynamixel_kp_i	积分增益（建议为 0）	[0, ...]
dynamixel_kd_d	微分增益（虚拟阻尼）	[50, ...]

启动命令：

ros2 launch franka_gello_state_publisher main.launch.py config_file:=your_config.yaml

▎ 注意：config_file 参数是可选的。如果不提供，默认使用 example_single.yaml。

虚拟弹簧与阻尼配置（关键）

GELLO 的核心优势之一是手感优化，通过 Dynamixel 内置的 PID 控制器实现"虚拟弹簧"和"虚拟阻尼"效果。

原理

每个 Dynamixel 舵机可以配置为"基于电流的位置控制"模式：

- 虚拟弹簧：目标位置 ≠ 当前位置 → 产生恢复力矩

- 虚拟阻尼：移动速度快 → 产生阻力矩

效果：

- 关节不会"软塌塌"（弹簧支撑）

- 不会"甩太快"（阻尼缓冲）

- 手感接近真实机械臂的惯性

配置参数详解

参数	说明	推荐值
dynamixel_torque_enable	是否使能力矩（1=开启，0=关闭）	需要虚拟弹簧的关节设为 1
dynamixel_goal_position	目标位置（脉冲值，4095 = 360°）	校准姿势对应的脉冲值
dynamixel_kp_p	比例增益（弹簧刚度）	0 ~ 1000，推荐 280
dynamixel_kp_i	积分增益	推荐 0（所有关节）
dynamixel_kd_d	微分增益（阻尼系数）	0 ~ 1000，下盘关节用更强阻尼

推荐起始值（参考官方配置）

dynamixel_torque_enable: [1, 1, 0, 1, 0, 0, 0]

dynamixel_goal_position: [2048, 2048, 2048, 2048, 2048, 2048, 2048]

dynamixel_kp_p: [280, 280, 0, 150, 0, 0, 0] # 关节1、2、4加弹簧

dynamixel_kd_d: [50, 100, 150, 200, 100, 50, 0] # 下盘阻尼更强

物理意义

● kp_p = 280→ 弹簧常数约 0.25 Nm/rad（与 GELLO 机械结构中的物理扭簧相当）

● 最大偏转角：约 48° 时达到电流限制（600mA）

● 舵机规格：XL330-M288 堵转扭矩 0.52 Nm（5V，1.47A），但持续大电流会过热。推荐使用 600mA 电流限制。

在线调整

启动后可以用 rqt 工具实时调整：

# 安装 rqt_reconfigure（如果还没装）

sudo apt install ros-humble-rqt-reconfigure

# 启动 rqt

rqt

# 然后：Plugins → Configuration → Dynamic Reconfigure

# 选择 franka_gello_state_publisher 节点，调整参数

⚠️ 重要警告（OpenRB-150 用户）

如果使用 OpenRB-150 通信板：

【危险操作】：

- 不要在没有外接 5V 电源的情况下使能力矩！

- 仅靠 USB 供电驱动力矩模式会烧坏你的电脑 USB 端口！

【正确操作】：

1. 给 OpenRB-150 的电源端子接上 5V 外接电源

2. 把跳线帽设为 "VIN(DXL)"

3. 确认电源指示灯亮起后，再使能力矩

参考：OpenRB-150 手册

https://emanual.robotis.com/docs/en/parts/controller/openrb-150/#when-running-5v-dynamixel-with-the-usb-power

4.2 启动关节阻抗控制器

功能说明

● 订阅话题：/gello/joint_states（来自 GELLO 发布器）

● 发布指令：发送给 Franka FR3 的力矩控制接口

● 控制算法：关节阻抗控制（Joint Impedance Control）

配置文件

● 位置：src/franka_fr3_arm_controllers/config/your_config.yaml

● 或直接使用示例：example_fr3_config.yaml

启动命令

ros2 launch franka_fr3_arm_controllers franka_fr3_arm_controllers.launch.py robot_config_file:=your_config.yaml

▎ 注意：robot_config_file 参数是可选的。如果不提供，默认使用 example_fr3_config.yaml。

配置参数（详见 franka.launch.py 第 16 行起）

参数	说明
robot_ip	Franka 机器人的 IP 地址
namespace	ROS2 命名空间
阻抗控制参数	刚度、阻尼、前馈力矩等

4.3 启动夹爪管理器

支持两种夹爪

夹爪类型	启动命令
Franka Hand（Franka 原装）	franka_gripper_client.launch.py
Robotiq 2F-85（第三方）	robotiq_gripper_controller_client.launch.py

Franka Hand 启动示例

ros2 launch franka_gripper_manager franka_gripper_client.launch.py config_file:=example_fr3_config_franka_hand.yaml

配置参数：
- namespace：ROS2 命名空间（需与 GELLO 和机器人一致）
- 其他参数详见配置文件

Robotiq 2F-85 启动示例

ros2 launch franka_gripper_manager robotiq_gripper_controller_client.launch.py config_file:=example_fr3_config_robotiq.yaml

配置参数：
- namespace：ROS2 命名空间
- com_port：Robotiq 夹爪的串口 ID（通过 ls /dev/serial/by-id 确定）

5. 软件包说明

5.1 franka_fr3_arm_controllers

功能：为 Franka FR3 提供关节阻抗控制器。

核心特性：
- 实现 JointImpedanceController，直接发送力矩指令
- 订阅 /gello/joint_states 话题获取 GELLO 状态

启动文件：
- franka.launch.py：启动 Franka 机器人的 ROS 接口
- franka_fr3_arm_controllers.launch.py：启动关节阻抗控制器

5.2 franka_gello_state_publisher

功能：读取 GELLO 手柄的 Dynamixel 舵机角度，发布为 sensor_msgs/msg/JointState 消息。

核心特性：
- 发布话题：/gello/joint_states
- 可选：配置 Dynamixel 内部控制参数（虚拟弹簧/阻尼）

启动文件：
- main.launch.py：启动 GELLO 发布器节点

5.3 franka_gripper_manager

功能：管理连接到 Franka 机器人的夹爪。

核心特性：
- 订阅话题：/gripper/gripper_client/target_gripper_width_percent
- 支持夹爪开合控制和回零（homing）操作

启动文件：
- franka_gripper_client.launch.py：启动 Franka Hand 夹爪管理节点
- robotiq_gripper_controller_client.launch.py：启动 Robotiq 2F-85 夹爪管理节点

6. 构建与测试

6.1 构建项目

# 【重要】所有命令必须在 ros2/ 目录下执行

cd ~/projects/ros2Gello/gello_software/ros2

# 构建（带 clang-tidy 检查）

colcon build --cmake-args -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DCHECK_TIDY=ON

6.2 运行测试

# 运行所有测试用例

colcon test

# 查看测试结果

colcon test-result --all

7. 故障排查

错误 1：串口无法打开

错误信息：

SerialException(msg.errno, "could not open port {}: {}".format(self._port, msg))

可能原因：
1. 端口路径错误：必须使用完整路径（如 /dev/serial/by-id/usb-FTDI_***）
2. 容器启动后插入设备：重新打开 VS Code Dev Container
3. 权限不足：检查用户是否在 dialout 组

解决方法：

# 检查端口是否存在

ls -la /dev/serial/by-id/

# 如果是容器问题，重新打开容器

# VS Code → 左下角 → 重新打开容器

# 如果是权限问题

sudo usermod -a -G dialout $USER

# 注销后重新登录

错误 2：libfranka 版本不兼容

错误信息：

libfranka: Incompatible library version (server version: X, library version: Y)

原因：libfranka 版本与 Franka 机器人系统版本不匹配。

解决方法：
1. 查看 Franka 兼容性表
2. 修改 ros2/.devcontainer/Dockerfile 中的版本参数：
LIBFRANKA_VERSION=0.15.0
FRANKA_ROS2_VERSION=0.15.0
FRANKA_DESCRIPTION_VERSION=0.15.0
3. 重新构建 Dev Container

错误 3：机器人运动卡顿

现象：从臂运动不流畅，或者频繁报"力阈值超限"错误。

原因：USB 延迟过高（默认 16ms）。

解决方法（临时）：

# 1. 确定你的 U2D2/OpenRB-150 对应的 tty 设备

ls -la /dev/serial/by-id/

# 假设输出显示它映射到 ttyUSB0

# 2. 降低 USB 延迟（16ms → 1ms）

echo 1 | sudo tee /sys/bus/usb-serial/devices/ttyUSB0/latency_timer

解决方法（永久）：

# 创建 udev 规则文件

sudo nano /etc/udev/rules.d/99-gello.rules

# 写入以下内容（针对 U2D2 和 OpenRB-150）

# 降低延迟定时器（1ms 代替默认的 16ms）并修复权限

ACTION=="add", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", MODE="0666", RUN+="/bin/sh -c 'echo 1 > /sys/bus/usb-serial/devices/$kernel/latency_timer'"

ACTION=="add", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6014", MODE="0666", RUN+="/bin/sh -c 'echo 1 > /sys/bus/usb-serial/devices/$kernel/latency_timer'"

# 重新加载 udev 规则

sudo udevadm control --reload-rules

sudo udevadm trigger

附录：话题与接口

GELLO 发布的话题

话题名称	消息类型	说明
/gello/joint_states	sensor_msgs/msg/JointState	GELLO 手柄的关节角度

控制器订阅的话题

话题名称	消息类型	说明
/gello/joint_states	sensor_msgs/msg/JointState	GELLO 状态输入

夹爪控制话题

话题名称	消息类型	说明
/gripper/gripper_client/target_gripper_width_percent	std_msgs/msg/Float32	夹爪开合指令（0~100%）

附录：参考资源

资源	链接
GELLO 论文	arXiv:2310.13018
Franka 官方文档	https://frankarobotics.github.io/docs/index.html
ROS2 Humble 文档	https://docs.ros.org/en/humble/
Dynamixel XL330 规格	https://emanual.robotis.com/docs/en/dxl/x/xl330-m288/
VS Code Dev Containers	https://code.visualstudio.com/docs/devcontainers/containers

RB-88控制板快速上手-1.简介

Thu, 18 Jun 2026 23:30:00 +0800

RB-88 是用于 OLLO Spark 和 OLLO Excel Kit 的控制器，具有蓝牙功能及内置设备，如电机输出轴和各种输入/输出设备（红外传感器、麦克风、LED、蜂鸣器）。

RB-88 控制器兼容 ROBOTIS 的 12mm 标准产品。

固件更新和恢复可通过 STEAMCUP 应用完成。

您可以使用 R-Block 对 RB-88 进行编程，并将程序下载到控制器上运行。

Jetson 处理器上使用Flatpak 安装 Chromium浏览器

Wed, 17 Jun 2026 23:59:59 +0800

完全避开 Snap 的沙箱坑，Flatpak 版的 Chromium 在 Jetson 上口碑最好：

sudo apt update

sudo apt install flatpak -y

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

重启一次，

sudo reboot

然后安装：

flatpak install flathub org.chromium.Chromium

启动（或在应用菜单里找 Chromium）：

flatpak run org.chromium.Chromium

AI 大语言模型本地环境部署-Ollama及gemma3:1b模型测试

Tue, 16 Jun 2026 13:47:08 +0800

介绍

什么是Ollama

Ollama是一个开源的本地大语言模型(LLM)运行框架，允许用户在本地计算机上运行各种开源大模型，无需依赖云服务。它提供了简单易用的命令行界面和API，使得开发者可以轻松地在本地部署和使用大模型。

Ollama的主要特点

本地运行：所有模型在本地运行，保护数据隐私

简单易用：提供简单的命令行界面和API

模型丰富：支持多种开源大模型，如Llama、Mistral、CodeLlama等

跨平台支持：支持Windows、macOS和Linux

资源优化：针对不同硬件配置进行优化

自定义模型：支持创建和分享自定义模型

安装部署

注意：ollama拉取失败属于正常情况，可多次尝试

curl -fsSL https://ollama.com/install.sh | sh

ollama

使用Gemma3

运行Gemma3

使用run命令，开始运行模型，如果没有下载过此模型，会自动拉取Ollama模型库的模型：

ollama run gemma3:1b

进行对话（参考问题）

How to learn a programming language?

回复问题时间和硬件配置有关，耐心等待！

视觉功能：（参考问题）

What do you see in this picture? :/home/robot/Pictures/test_pic.jpg

#在对话中使用 ": + 图片的路径"，就可以让模型使用它的视觉功能，让它解析图片中的信息

结束对话（用命令执行）

使用Ctrl+d快捷键或者/bye可以结束对话！

中文对话

没有中文输入法的，可以查看中文输入法切换教程

中文对话：

一个小时是多少分钟，请用中文告诉我

参考资料

Ollama

官网：https://ollama.com/

GitHub：https://github.com/ollama/ollama

Gemma3

Ollama对应模型：https://ollama.com/library/gemma3

LEAP Hand灵巧手使用说明

Mon, 15 Jun 2026 23:30:00 +0800

LEAP Hand官方网站：https://www.leaphand.com/

1. 硬件部分组装

详情见组装手册或组装视频

视频链接：

https://www.bilibili.com/video/BV195q1YDEDt/?spm_id_from=333.999.0.0&vd_source=9456951d706e2acc026e424d8a228909

2. 手部关节舵机参数设置

舵机参数设置，上位机调试，固件升级参考链接：

链接: https://emanual.robotis.com/docs/en/software/dynamixel/dynamixel_wizard2/

左手舵机ID设定：

右手舵机ID设定：

舵机波特率：4M

3. 软件操作指南

参考链接：https://github.com/leap-hand/LEAP_Hand_API

可以在ros、ros2或python命令直接对leap_hand进行驱动，具体操作查看github资料。

支持Isaac:

支持Mujoco:

4. 技术支持

如需技术支持，请通过以下QQ或者销售微信联系方式获取帮助:

智能佳舵机技术交流群号QQ:1032078480

注意：

1.LEAP_Hand灵巧手需使用5v电源适配器，不要连接其他电源型号的电源适配器，错误的适配器使用可能会导致舵机损坏。因电源适配器不匹配所导致的舵机损坏将不在免费保修范围内。

2.如需拔插舵机接线，请务必在断电状态下操作。带电拔插舵机接线可能会导致舵机损坏，属于人为损坏，不在免费保修范围内。

3.舵机插线的时候一定看准方向连接，上电之前需要再次重新检查连接线是否插对插牢。舵机的供电板与信号转换板没有外壳，在使用过程中一定不要让电路板接触到金属物体，否则可能会造成短路烧坏电路板或舵机，严重会把电脑烧坏。

OpenRB-150控制板快速上手-1.概述

Tue, 09 Jun 2026 23:30:00 +0800

OpenRB-150是一款新的开源、兼容Arduino的嵌入式控制器。

该控制器具有与Arduino MKR相同的引脚排列和外形尺寸，以确保与物理配件的兼容性，并支持使用Arduino IDE进行编程。

OpenRB-150 还具有4个专用DYNAMIXEL端口，并支持DYNAMIXEL Wizard 2.0测试和校准软件。

注意：使用带有支持DYNAMIXEL Wizard功能的OpenRB-150需要专用固件。该固件包含在 OpenRB板管理器包中。

OpenRB-150控制板快速上手-2.规格

Tue, 09 Jun 2026 23:00:00 +0800

单片机	SAMD21 Cortex-M0+ 32 位低功耗 ARM®MCU
工作电压	5.0V (USB 3.0) 3.7V ~ 12.6V (VIN 或终端)
支持的电源	Li-Po锂电池 1-3 cell(3.7-11.1V) 支持XT60接口类型
工作温度	-40℃ ~ 85℃
连接器类型	USB C型，接线端子
舵机端口(TTL)	JST B3B-EH-A(2), JST S3B-EH-A(2) [最大 1Mbps]
重量	13克
3.3V引脚的直流电流	最大电流 300 毫安
5V引脚的直流电流	最大电流 300 mA（更换前）最大电流 150 mA（更换后）
动态混合端口的直流电流	3000毫安
电路工作电压	3.3伏
数字 I/O 引脚	24
PWM引脚	12（0、1、2、3、4、5、6、7、8、10、A3 或 18、A4 或 19）
UART	2
SPI	1
I2C	1
模拟输入引脚	7（ADC 8/10/12 位）
模拟输出引脚	1（DAC 10 位）
外部中断	10（0、1、4、5、6、7、8、A1 或 16、A2 或 17）
每个 I/O 引脚的直流电流	7毫安
闪存	256 KB
用于引导加载程序的闪存	8 KB
SRAM	32 KB
EEPROM	不
时钟速度	32.768 kHz（实时时钟），48 MHz
内置LED	3
动态混合器 TTL 端口1	4（最高 1 Mbps）
板材尺寸	25 x 66 毫米
支持的软件	Arduino IDE，DYNAMIXEL Wizard 2.0
支持的 DYNAMIXEL2	X系列、MX系列、AX系列、P系列

1.RS-485 型号需要DYNAMIXEL 通信桥接器将 TTL 转换为 RS-485。

2.24V 型号需要单独的电源连接。

笔记

注意：5V 稳压器已于 2024 年更新，导致直流电流 (5V) 值从 300mA 修改为 150mA。

危险

由于内置保险丝，USB 端口的电流限制为 500mA，但过大的电流可能会损坏用于为 OpenRB-150 供电的 USB 端口。

对于需要快速运动或高扭矩的应用，建议使用接线端子供电。

在将 DYNAMIXEL 模块连接到 OpenRB-150 之前，务必确认其工作电压。

I/O引脚可承受的最大电压为3.3V。对任何I/O引脚施加高于3.3V的电压都可能损坏电路板。

通电时请勿连接或断开 DYNAMIXEL 执行器电缆。

危险

（忽视这些警告可能会导致严重伤害或死亡）

切勿将含有水、易燃物/明火或溶剂的物品放置在产品附近。

操作过程中，切勿将手指、手臂、脚趾和其他身体部位靠近产品。

如果产品开始散发异味、发出异响或冒烟，请停止操作并切断产品电源。

请将本品放在儿童不能接触的地方。

安装或通电前，请检查输入极性。

注意

（忽视这些警告可能会导致轻微人身伤害或产品损坏）

产品运行过程中请勿插入刀片或其他尖锐物品。

注意

（忽视这些警告可能会造成轻微人身伤害或产品损坏）

请勿拆卸或改装产品。

请勿摔落产品或施加强烈冲击。

通电时请勿连接或断开 DYNAMIXEL 电缆。

OpenRB-150控制板快速上手-3.硬件布局

Tue, 09 Jun 2026 22:30:00 +0800

引脚排列

复位按钮

按下Reset Button硬重启微控制器，双击Reset Button重启微控制器进入引导加载程序模式。

OpenRB-150在引导加载程序模式下不会加载它的Arduino草图（或固件）。

警告

重置微控制器也会重置任何连接的 DYNAMIXEL（电源开关）的电源。

重要的是仅在执行器处于安全位置时重置微控制器，以避免在执行器重置时可能造成的损坏或伤害。

DYNAMIXEL 电源开关

DYNAMIXEL 端口的电源由微控制器底部的FET控制。

FET可以启用和禁用连接端口的电源，默认情况下，只要打开OpenRB-150电源，FET就会关闭。

当 FET开启时，DXL红色LED也将开启以确认电源状态。

终端VIN

随附的接线端子可与各种输入电源兼容。

ROBOTIS建议尽可能使用接线端子供电。

要通过端子VIN为OpenRB-150控制器供电，请将跳线设置为VIN(DXL)侧边，如下所示。

注意

请勿在连接到控制器时为电池充电。

XT60连接器

XT60连接器广泛用于RC产品，可组装在OpenRB-150控制器的背面。

在焊接 XT60 直角连接器之前，请取下接线端子。

XT60 连接器就绪

电源跳线

OpenRB-150 可以由三个电源供电。

为了给控制器和DYNAMIXEL正确供电，需要正确设置电源跳线。

DYNAMIXEL 端口

4 个DYNAMIXEL端口可用于任何支持TTL的DYNAMIXEL。

RS-485 支持的DYNAMIXEL也可以在与DYNAMIXEL通信桥连接时使用。

DYNAMIXEL通讯桥

串行端口

分配给的串口Serial2可用于连接各种设备，用于调试代码或控制控制器。

发光二极管

三个 LED 指示 OpenRB-150 控制器的状态。

PWR（绿色）：只要 OpenRB-150 通电，此LED就会亮起。

USER（橙色）：此LED可由用户通过Pin32或LED_BUILTIN在Arduino草图代码中控制。

DXL（红色）：当DYNAMIXEL端口通电时，此LED将亮起。

OpenRB-150控制板快速上手-4.引脚名称定义

Tue, 09 Jun 2026 22:00:00 +0800

// Battery
#define ADC_BATTERY (33u)
 
// LEDs
#define PIN_LED     (32u)
#define LED_BUILTIN PIN_LED
 
// DYNAMIXEL POWER FET
#define DXL_PWR_SW  (31u)

OpenRB-150控制板快速上手-5.连接电源

Tue, 09 Jun 2026 21:30:00 +0800

OpenRB-150 控制器可以由三种电源供电方式。

VIN

终端 VIN

警告

在将它们连接到 OpenRB-150 之前，请务必检查任何电源的极性。

不正确的极性会永久损坏微控制器。

确保根据电源正确设置跳线。

连接示例

使用USB电源运行5V DYNAMIXEL时

警告

对于需要高速或扭矩的应用，请通过端子 VIN 供电。

USB 端口不是动态电机操作的合适电源。

从 USB 端口汲取过多电力可能会导致 PC 重新启动或损坏。

建议使用外部电源，如下所示。

运行 12V TTL DYNAMIXEL时

运行12VRS-485DYNAMIXEL时