如果你对机器人、人工智能和动手制作充满热情却苦于市面上的机器人套件要么价格昂贵、要么闭源难以定制那么今天介绍的Hei-rebot-lift双臂机器人项目或许就是你一直在寻找的答案。这是一个从机械结构、电路设计到控制软件完全开源的具身智能机器人平台旨在为研究者、开发者和机器人爱好者提供一个低成本、高灵活度的学习和开发载体。本文将为你提供一份从零开始的Hei-rebot-lift 双臂机器人完整组装与基础调试教程。无论你是想深入了解机器人机械设计的学生还是希望为具身智能算法寻找实体验证平台的开发者都能通过本文一步步完成机器人的硬件搭建与基础软件环境部署最终让机器人“动起来”。我们将覆盖从零件清点、机械装配、电路连接到核心控制软件“大小脑”架构的部署与测试全流程并提供详细的代码示例和常见问题排查指南。1. 项目背景与核心概念解析在深入动手之前我们先厘清几个关键概念这有助于理解我们正在构建的是一个什么样的系统。1.1 什么是具身智能具身智能是人工智能的一个重要分支它强调智能体必须拥有一个物理身体并通过与真实物理世界的交互来感知、学习和行动。与纯粹在虚拟环境中运行的AI不同具身智能机器人需要处理传感器噪声、物理约束如摩擦力、重力、动作执行的不确定性等现实问题。Hei-rebot-lift正是为探索这类问题而设计的实体平台它让算法从“纸上谈兵”走向“动手实干”。1.2 Hei-rebot-lift 项目简介Hei-rebot-lift是一个开源的通用型双臂机器人项目。其核心特点如下完全开源所有设计文件包括3D模型STP/STEP、电路原理图PCB、控制软件代码均在开源社区公开。你可以自由地修改、复制甚至用于商业项目需遵守相关开源协议。模块化设计机械结构采用模块化设计双臂、躯干、底座等部分相对独立便于组装、维护和未来升级。“大小脑”软件架构这是本项目的软件核心。“大脑”通常运行在算力更强的上位机如工控机、NVIDIA Jetson上负责高级任务规划、视觉处理、AI推理等“小脑”则运行在实时性要求高的下位机如STM32、ESP32等微控制器上负责精确的电机伺服控制、传感器数据采集和底层安全逻辑。二者通过通信协议如CAN、EtherCAT、串口或Socket协同工作。成本可控通过采用常见的开源硬件如树莓派、STM32和标准件如铝型材、轴承极大降低了制造成本。1.3 核心组件与工作原理一个完整的 Hei-rebot-lift 系统通常包含以下层级机械层包含铝型材框架、关节模组电机减速器、同步带、连杆等构成机器人的物理身体。驱动层由电机驱动器如舵机驱动板、步进电机驱动器和微控制器“小脑”组成直接控制电机产生精确的力和位置。控制层即“大脑”软件运行在Linux系统上通过ROS机器人操作系统或自定义中间件接收指令并解算为各关节的运动轨迹下发给“小脑”。感知层包括摄像头、力传感器、编码器等为“大脑”提供环境信息。应用层实现具体的任务如抓取、装配、移动等。2. 组装前的准备工作“工欲善其事必先利其器”。在开始组装前请确保你已准备好所有必要的物料和工具。2.1 硬件物料清单你需要根据项目开源仓库如GitHub提供的BOM物料清单文件进行采购。以下是一个典型的清单概览类别物品说明预估数量结构件铝型材2020/2040主体框架若干米3D打印零件关节连接件、端效器手爪底座等一套螺丝、螺母、垫片M3, M4, M5 各种长度大量同步带及带轮用于传动2套驱动与执行关节模组集成电机、减速器、编码器12个每臂6自由度电机驱动器如基于STM32的伺服驱动板12个电源24V/48V直流开关电源功率需满足所有电机峰值需求1个控制与感知上位机树莓派4B/Jetson Nano/X86工控机1台下位机小脑STM32F4/F7系列开发板或定制控制器1-2块摄像头USB摄像头或RGB-D相机如Realsense D4351个线材与接插件硅胶线、杜邦线、XT60接头等一套工具内六角扳手一套1套螺丝刀十字、一字各1把剥线钳、压线钳处理电线1套万用表检查电路1个电烙铁与焊锡焊接接头1套重要提示务必从项目官方仓库下载最新版的BOM.csv或README.md以获取精确的零件型号、规格和采购链接。2.2 软件与环境准备在组装硬件的同时我们可以先搭建软件开发环境。操作系统为上位机安装Ubuntu 20.04/22.04 LTS。这是ROS 1/2最兼容的系统版本。ROS安装根据项目要求安装ROS 1 (Noetic) 或 ROS 2 (Humble)。本项目示例以ROS 1 Noetic为例。# 设置软件源 sudo sh -c echo deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654 # 安装ROS Noetic桌面完整版 sudo apt update sudo apt install ros-noetic-desktop-full # 初始化rosdep sudo rosdep init rosdep update # 设置环境变量 echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc项目代码克隆mkdir -p ~/hei_robot_ws/src cd ~/hei_robot_ws/src git clone https://github.com/原作者/hei-rebot-lift.git # 克隆依赖的工作空间如果有 git clone https://github.com/原作者/hei-robot-common.git下位机开发环境安装STM32开发工具链如STM32CubeIDE或PlatformIO用于编译和烧录“小脑”固件。3. 机械结构组装详解组装应遵循从下至上、从固定到活动、从主体到细节的顺序。建议两人协作特别是安装手臂时。3.1 底座与躯干组装搭建底座框架根据图纸使用铝型材和角码拼装出机器人底座的矩形框架。确保对角线长度一致以保证框架方正。安装躯干立柱将两根垂直的铝型材安装在底座后部作为躯干的支撑。使用加强角码确保其稳固。安装“脊柱”与肩部平台将水平承载板通常是3D打印件或铝板固定在立柱顶端作为双臂的安装基座。检查平台是否水平。3.2 单臂机械组装以右臂为例每条手臂通常有6个自由度肩部3个、肘部1个、腕部2个。组装时需特别注意关节的零位对齐和线缆管理。组装肩部关节将第一个关节模组J1绕垂直轴旋转通过法兰盘安装在躯干平台上。安装第二个关节模组J2俯仰在J1的输出端。注意根据图纸调整两个关节的初始角度零位。安装第三个关节模组J3旋转或俯仰完成肩部组装。关键步骤在紧固所有螺丝前手动转动各关节确保运动平滑无干涉。组装肘部与腕部通过连杆连接肩部与肘部关节J4。依次安装腕部关节J5和J6。J6末端安装工具法兰盘用于连接夹爪或其它末端执行器。走线与固定将所有电机的电源线和编码器线沿着手臂的线槽或使用扎带整齐固定。预留足够的长度以保证关节在全范围运动时不拉扯线缆。安装同步带如使用如果关节采用同步带传动需要仔细调整带轮间距和张紧力确保传动平稳无滑齿。左臂组装重复以上步骤组装左臂。注意左右臂通常是镜像对称的安装时需区分左右零件。3.3 总装与初步检查安装双臂将组装好的左右臂整体安装到躯干平台的对应位置紧固所有螺丝。安装头部可选如果设计包含头部用于安装摄像头将其安装在躯干前方。最终机械检查手动缓慢转动每个关节检查是否有零件干涉、异响或卡顿。检查所有螺丝是否紧固特别是承重部位。确保机器人站立平稳。4. 电气系统连接与上电测试机械部分是骨骼电气系统则是神经和肌肉。此步骤需格外谨慎。4.1 电路连接原理典型的连接拓扑如下24V/48V电源 -- 电源分配板 -- 各个电机驱动器供电 上位机大脑-- (USB/以太网) -- 下位机小脑-- (CAN/串口) -- 电机驱动器控制电源大功率开关电源为所有电机驱动器供电。务必计算总功率需求并留有余量。下位机小脑作为控制中枢它通过CAN总线或串口向每个电机驱动器发送位置/扭矩指令并接收编码器反馈。上位机大脑通过USB或以太网与下位机通信发送高层运动指令。4.2 实际接线步骤断电操作确保所有电源开关处于关闭状态电源适配器未接通市电。连接驱动器与电机将每个关节模组的电机动力线A/B/C相和编码器线连接到对应的电机驱动器上。注意相位顺序接错可能导致电机抖动或飞车。连接电源用足够粗的硅胶线将开关电源输出端连接到电源分配板的正负极。再将分配板的输出连接到各个驱动器的VIN和VIN-。连接通信总线将所有电机驱动器的CAN_H和CAN_L端口用双绞线以总线形式串联并最终连接到下位机STM32的CAN接口。在总线两端需安装120欧姆终端电阻。连接上下位机使用USB线或网线连接上位机Ubuntu电脑和下位机STM32。连接传感器将摄像头接入上位机的USB口其他传感器如限位开关接入下位机的GPIO。4.3 首次上电与烟雾测试这是一个紧张而关键的环节。目视检查再次核对所有接线特别是电源正负极不能接反。万用表测试用万用表通断档检查电源输入是否有短路。分步上电先只给下位机STM32供电通常通过USB或5V电源观察其指示灯是否正常点亮电脑是否能识别到串口设备。然后断开所有电机驱动器的电源只给控制电路部分上电。通过上位机软件尝试与下位机通信确保通信链路正常。最后在做好紧急断电准备的情况下接通主电源24V/48V。此时应听到驱动器电容充电的声音但电机不应转动。驱动器配置通过驱动器配套的上位机软件或串口指令为每个驱动器设置正确的CAN ID、电机参数极对数、编码器线数和PID参数。务必先设置较低的电流限和速度限。5. 软件部署与核心代码解析硬件就绪后我们来让机器人获得“灵魂”。5.1 “小脑”固件烧录与配置“小脑”固件负责最底层的实时控制。我们以STM32和CAN通信为例。获取与编译固件在项目仓库的firmware/目录下找到下位机代码。使用STM32CubeIDE打开工程。// 示例关键初始化代码片段 (main.c) // CAN过滤器配置只接收特定ID范围的指令 CAN_FilterTypeDef can_filter; can_filter.FilterBank 0; can_filter.FilterMode CAN_FILTERMODE_IDMASK; can_filter.FilterScale CAN_FILTERSCALE_32BIT; can_filter.FilterIdHigh 0x0000; // 期望接收的ID高16位 can_filter.FilterIdLow 0x0000; // 期望接收的ID低16位 can_filter.FilterMaskIdHigh 0x0000; // 掩码0表示精确匹配 can_filter.FilterMaskIdLow 0x0000; can_filter.FilterFIFOAssignment CAN_RX_FIFO0; can_filter.FilterActivation ENABLE; HAL_CAN_ConfigFilter(hcan1, can_filter);配置实时调度为了确保控制循环的定时精确性需要在FreeRTOS中设置高优先级任务。// 创建高优先级控制任务 osThreadDef(controlTask, StartControlTask, osPriorityRealtime, 0, 512); // osPriorityRealtime 为实时优先级 controlTaskHandle osThreadCreate(osThread(controlTask), NULL); // 在StartControlTask函数中实现精确的1ms控制循环 void StartControlTask(void const * argument) { TickType_t xLastWakeTime xTaskGetTickCount(); const TickType_t xFrequency 1; // 1ms周期对应1000Hz for(;;) { // 1. 读取CAN总线指令 readCANCommands(); // 2. 执行运动学解算或位置插值 calculateJointTargets(); // 3. 执行PID控制计算 for(int i0; iJOINT_NUM; i) { pid_compute(joint_pid[i], current_position[i], target_position[i]); } // 4. 通过CAN发送扭矩指令给驱动器 sendCANTorqueCommands(); // 5. 严格定时延迟 vTaskDelayUntil(xLastWakeTime, xFrequency); } }编译与烧录编译工程通过ST-Link或USB DFU将固件烧录到STM32中。5.2 “大脑”ROS功能包部署“大脑”在ROS中运行负责任务规划和运动控制。安装依赖与编译cd ~/hei_robot_ws rosdep install --from-paths src --ignore-src -r -y catkin_make source devel/setup.bash核心节点解析项目通常包含以下关键ROS节点robot_hardware_interface硬件接口层通过串口或Socket与“小脑”通信将ROS控制消息转换为底层协议。robot_controller加载并管理关节轨迹控制器joint_trajectory_controller。moveit_configMoveIt!配置文件用于运动规划。vision_node处理摄像头数据的节点。桥接层实现示例这是连接ROS非实时和“小脑”实时的关键。以下是一个简化的串口桥接节点示例// 文件src/serial_bridge.cpp #include ros/ros.h #include sensor_msgs/JointState.h #include serial/serial.h serial::Serial ser; // 串口对象 void jointStateCallback(const sensor_msgs::JointState::ConstPtr msg) { // 将ROS的JointState消息编码为自定义的二进制协议 std::vectoruint8_t packet encodeJointCommand(msg-position, msg-velocity); // 通过串口发送给下位机 if(ser.isOpen()) { ser.write(packet); } } int main(int argc, char** argv) { ros::init(argc, argv, serial_bridge); ros::NodeHandle nh; ros::NodeHandle private_nh(~); // 读取串口参数 std::string port; int baudrate; private_nh.paramstd::string(port, port, /dev/ttyUSB0); private_nh.param(baudrate, baudrate, 115200); // 打开串口 try { ser.setPort(port); ser.setBaudrate(baudrate); serial::Timeout to serial::Timeout::simpleTimeout(1000); ser.setTimeout(to); ser.open(); } catch (serial::IOException e) { ROS_ERROR_STREAM(无法打开串口 port 。错误: e.what()); return -1; } // 订阅ROS关节目标话题 ros::Subscriber sub nh.subscribe(/joint_targets, 10, jointStateCallback); // 发布从下位机接收到的实际关节状态 ros::Publisher pub nh.advertisesensor_msgs::JointState(/joint_states, 10); ros::Rate loop_rate(100); // 100Hz while(ros::ok()) { // 读取下位机反馈 if(ser.available()) { std::vectoruint8_t feedback ser.read(ser.available()); sensor_msgs::JointState js_msg decodeFeedbackPacket(feedback); js_msg.header.stamp ros::Time::now(); pub.publish(js_msg); } ros::spinOnce(); loop_rate.sleep(); } ser.close(); return 0; }对应的CMakeLists.txt需要链接serial库。5.3 首次联调与基础运动测试启动ROS核心roscore启动硬件接口和控制器roslaunch hei_rebot_bringup robot.launch这个launch文件会启动串口桥接节点、加载机器人描述文件URDF和控制器。使用RViz可视化启动RViz查看机器人模型是否正确加载。roslaunch hei_rebot_moveit demo.launch发送测试指令通过ROS命令行工具或编写简单的Python脚本向控制器发送一个让所有关节缓慢移动到零位的指令。#!/usr/bin/env python import rospy from trajectory_msgs.msg import JointTrajectory, JointTrajectoryPoint import actionlib from control_msgs.msg import FollowJointTrajectoryAction, FollowJointTrajectoryGoal rospy.init_node(simple_mover) # 假设你的action服务器叫 /arm_controller/follow_joint_trajectory client actionlib.SimpleActionClient(/arm_controller/follow_joint_trajectory, FollowJointTrajectoryAction) client.wait_for_server() goal FollowJointTrajectoryGoal() goal.trajectory.joint_names [joint1, joint2, joint3, joint4, joint5, joint6] # 替换为你的关节名 point JointTrajectoryPoint() point.positions [0.0, 0.0, 0.0, 0.0, 0.0, 0.0] # 目标位置弧度 point.time_from_start rospy.Duration(5.0) # 5秒内移动到目标 goal.trajectory.points.append(point) client.send_goal(goal) client.wait_for_result()观察机器人是否开始缓慢、平稳地运动。首次运动时请确保机器人周围有足够空间并随时准备切断电源6. 常见问题与深度排查指南组装和调试过程中你几乎一定会遇到问题。以下是典型问题及解决思路。问题现象可能原因排查步骤与解决方案上电后驱动器无反应指示灯不亮1. 电源未接通或电压不对。2. 电源线接反或接触不良。3. 驱动器损坏。1. 用万用表测量驱动器电源输入端电压。2. 检查接线端子是否压紧。3. 更换一个驱动器测试。电机剧烈抖动或啸叫但不转动1. 电机相序接错。2. 编码器接线错误或松动。3. PID参数设置不当尤其是P值过大。4. 机械负载卡死。1. 任意交换电机A、B两相线试试。2. 检查编码器连接确保插紧。3. 将驱动器PID参数全部归零先尝试仅用很小的P值。4. 脱开电机与负载的连接空载测试。CAN通信失败上位机读不到电机数据1. CAN总线接线错误H/L接反。2. 终端电阻未接或阻值不对。3. 波特率设置不一致。4. CAN控制器未正确初始化。1. 检查CAN_H和CAN_L是否接对总线两端是否都有120Ω电阻。2. 用逻辑分析仪或CAN分析仪抓取总线波形。3. 确认上下位机CAN波特率如1Mbps设置一致。4. 检查下位机代码中CAN初始化代码。ROS启动时报错找不到串口或USB设备1. 串口设备名不固定如/dev/ttyUSB0变为/dev/ttyUSB1。2. 用户权限不足。1. 使用ls -l /dev/ttyUSB*查看设备在launch文件中使用/dev/serial/by-id/路径唯一。2. 将用户加入dialout组sudo usermod -a -G dialout $USER并重新登录。MoveIt!规划路径失败1. URDF模型与实物尺寸不符。2. 关节限位设置错误。3. 碰撞检测配置过于保守。1. 在RViz中检查URDF模型核对连杆尺寸和关节轴方向。2. 检查joint_limits.yaml文件中的位置、速度、加速度限制。3. 调整collision_matrix或简化碰撞模型。机器人运动到某个位置后卡住或振动1. 机械干涉线缆被拉紧、零件碰撞。2. 到达关节物理限位。3. 该位置处于奇异点附近雅可比矩阵病态。1. 仔细观察运动过程排除物理干涉。2. 检查并设置软件限位留出安全余量。3. 在规划时避免奇异点或使用具有奇异点规避算法的规划器。深度排查工具推荐CAN总线使用candumpLinuxcan-utils包监听总线数据。串口调试使用minicom或screen直接与下位机通信发送原始指令测试。ROS调试使用rostopic echo查看话题数据rqt_graph查看节点连接rqt_console查看日志。系统实时性使用cyclictest测试Linux系统的实时延迟这对于高频率控制循环至关重要。7. 最佳实践与进阶开发建议成功让机器人动起来只是第一步。以下建议能帮助你更稳定、更高效地使用和开发这个平台。7.1 机械与电气安全规范急停开关必须在电源回路中串联一个物理急停开关并放置在易于触及的位置。力矩限制在“小脑”固件和驱动器配置中务必为每个关节设置安全的力矩/电流上限防止伤人损物。软件限位在URDF和控制软件中设置比机械硬限位更保守的软件限位提供双重保护。线缆管理使用波纹管、拖链保护线缆避免长期弯折导致断裂。接地与屏蔽对电机动力线和通信线做好屏蔽和接地减少电磁干扰。7.2 软件工程与代码管理版本控制使用Git管理你的所有代码、配置和URDF文件。为硬件不同版本创建分支。参数配置化将所有硬件参数如CAN ID、关节零点偏移、PID参数写入YAML或JSON配置文件不要硬编码在代码中。完善的日志系统在“大脑”和“小脑”代码中都实现分级日志INFO, WARN, ERROR记录关键状态和错误便于离线分析。仿真先行在Gazebo或MuJoCo中建立机器人仿真模型先验证算法逻辑再部署到真机能极大提高开发效率和安全性。模块化设计将通信驱动、运动学、动力学、控制器拆分为独立模块降低耦合度。7.3 性能优化方向控制频率“小脑”的控制循环频率应尽可能高如1kHz这需要优化的代码和具有实时性的操作系统如FreeRTOS或带RT-Preempt补丁的Linux。通信优化使用高效的二进制协议如Google Protocol Buffers而非JSON进行上下位机通信减少延迟和带宽占用。轨迹规划在“大脑”中使用带时间最优或能耗最优的轨迹规划算法使运动更平滑、快速。传感器融合结合编码器、IMU惯性测量单元甚至视觉信息进行更精确的状态估计。7.4 融入具身智能研究Hei-rebot-lift是绝佳的具身智能研究平台。你可以尝试模仿学习通过示教录制动作轨迹让机器人学习。强化学习在仿真中训练抓取、堆叠等任务的策略再迁移到真机Sim2Real。视觉伺服利用摄像头反馈实现“手眼协调”的精细操作。多机协同如果有两台或多台机器人可以研究协同搬运、装配等任务。从一堆零件到一个能听令而动的智能机器人这个过程充满挑战也极具成就感。Hei-rebot-lift开源项目为你提供了实现这一切的蓝图。本文详细介绍了从硬件组装、电气连接到软件部署的全流程并深入解析了“大小脑”协同的核心代码。希望这份教程能帮助你顺利搭建起自己的机器人平台。记住开源项目的生命力在于社区。当你解决了某个棘手问题、优化了某个模块、或开发了新的应用后不妨将你的代码和经验以Pull Request或技术博客的形式回馈给社区。在机器人技术的探索道路上我们都是在彼此的肩膀上攀登。接下来你可以尝试为机器人安装一个摄像头实现一个简单的颜色识别抓取demo这将是你迈向具身智能世界的第一步。如果在实践中遇到任何问题欢迎在项目社区中讨论交流。
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
