🦾
四路舵机联动
底座、肩部、前臂和夹爪分别由 MG90S 驱动，能完成抬升、转向和抓取等基础动作。
// 01_FEATURES
很小一只，但机械臂基础全在里面
RoboticArm 不是工业机械臂的缩小版，而是一套非常适合入门和展示的桌面机构。你能在它身上快速理解多舵机协同、关节限位和夹爪动作的基本逻辑。
🧩
结构紧凑
体积小、桌面占地低，适合 3D 打印后快速组装，也方便拿来做演示和拍摄。
🎓
非常适合入门
从舵机归中到连杆安装，再到动作调试，这个项目覆盖了机械臂入门最关键的几个环节。
🛠️
可继续扩展
后续可以在现有结构上继续加摇杆、网页控制或预设动作库，把它升级成更完整的桌面机械臂平台。
// 02_LOGIC
先理解这三层，再调试就不容易乱
迷你机械臂最容易翻车的地方不是代码，而是“机械零位”和“供电逻辑”没有理顺。把系统拆成下面三层，排查会轻松很多。
MECHANICAL ZERO先把每个舵机归中
装舵盘之前先让舵机进入中位，后面每个关节的动作范围才有统一参考，不容易出现一边顶死一边还没到位。
POWER ROUTING主控和舵机分清供电
XIAO 负责控制信号，4 个 MG90S 的瞬时电流要重点考虑。建议按资料包方案在万用板上做好供电分配，并确保共地。
MOTION SEQUENCE动作要按顺序试
不要上来就整套动作一起跑。先单关节，再做两关节联动，最后再调夹爪抓取，定位问题会快很多。
// 03_ASSEMBLY
按“归中 → 组装 → 接线 → 低速测试”来
这个项目很适合一天内做出来，但不要省略归中和低速测试。舵机一旦装歪，后面会一直和结构干涉较劲。
你给到的核心物料
- 01 XIAO ESP32S3 开发板 ×1
- 02 MG90S 舵机 ×4
- 03 2×8cm 万用电路板 ×1
- 04 PH2.0 母端子头 ×1
- 05 Type-C 2P 带锁外螺牙母座 ×1
- 06 3D 打印结构件与夹爪
- 07 螺丝、铜柱与舵盘件
- 08 电源线与舵机延长线
资料包里通常还会包含结构件、程序、接线说明和补充紧固件信息。购买前建议再对照一次资料内清单，确认螺丝规格和打印件版本一致。
七步完成复刻
打印并清理结构件
先处理底座、立柱、前臂和夹爪件的毛边，确认舵机槽、转轴孔和螺丝孔都能顺利配合。
给 4 个舵机先做归中
在安装舵盘前先让每个 MG90S 回到中位，再按资料规定方向装入底座、肩部、前臂和夹爪位置。
完成机械结构装配
先固定底座与立柱，再装肩部、前臂和夹爪。每装完一级关节都手动检查有没有卡壳或干涉。
焊接供电小板
在 2×8cm 万用板上处理 Type-C 2P 电源输入、PH2.0 端子和舵机供电分配，信号线与电源线尽量分区整理。
连接 XIAO 与舵机信号
把 4 路控制信号接到对应 IO，舵机电源和主控地线务必共地，避免动作发抖或重启。
先做单关节测试
依次测试底座旋转、抬臂、前伸和夹爪开合，确认方向、角度范围和机械零位都正确。
最后调联合动作
把几个单动作串起来，逐步调慢速度和角度，让它能稳定完成桌面夹取演示。
供电提醒：MG90S 在启动和卡住时电流会上来，首次调试不要只靠电脑 USB 直接拖所有舵机。按资料包方案接好独立供电，并在动作测试前确认共地和极性。
// 04_DEBUG
常见问题优先从这四项排查
大多数“动不了、抖得厉害、夹不稳”的问题，都能在下面四项里找到原因。
// 05_TIPS
做得更顺手的三个小建议
这些不一定是硬性要求，但很能减少返工。
SERVO HEALTH不要硬掰舵机
发现角度明显不对时先断电，再拆下重装舵盘。强行掰关节很容易把齿轮掰伤。
CABLE MANAGEMENT线材要避开转动轴
小机械臂空间不大，信号线和供电线最好提早规划走线，不然后面很容易被关节夹到。
SOFT START首次动作尽量保守
程序里先用更小角度和更慢速度测试，等结构和供电稳定后，再逐步把动作调到更好看。
// 07_RESOURCES
资料、视频和物料入口
复刻这个项目最重要的是把资料包、视频和 BOM 对起来看，照着一个版本做，会省掉很多兼容性麻烦。