NeuralNexus Arm：从 CAD 到数字孪生的自研 6 自由度机械臂

📌 本分册目标

这一台和前几册的路线都不同：不是复刻现成开源臂，而是从零手工做一台——机械结构、嵌入式固件、运动学求解、数字孪生、视觉抓取全部自研，没买套件、也没拼现成方案。它的核心命题只有一句话：一条指令，让真实机械臂与 3D 数字孪生体同步运动。

作者团队（Lasan Perera 等 5 人）把整条链路打通得很完整，所以它特别适合当作「一台机械臂到底由哪些层组成」的活教材：SolidWorks 建模 → Simscape Multibody 数字孪生 → MATLAB 逆运动学求解 → USB CDC 115200 → STM32H743 实时伺服 → 6 路步进 + 舵机夹爪 → AS5047P 绝对编码器反馈。

本分册按 系统链路 → 硬件栈 → 关节传动 → 控制与协议 → 数字孪生 → 视觉 → 资料下载 → 踩坑要点 八段走。它的价值不在于「照着装一台」，而在于学习每一层之间怎么接口、怎么验收。

🧭 第一段：系统链路（先理解数据怎么流）

抓住这条链路，后面每一节都能对号入座：上位机算运动学 → 串口下发关节角 → 下位机做实时伺服。中间用一条极简的文本协议解耦，两侧可以独立开发、独立调试。

SolidWorks CAD  →  Simscape Multibody 数字孪生  →  MATLAB 逆运动学求解器
                                     │
                         USB CDC @ 115200 baud（关节角文本协议）
                                     ▼
        STM32H743 @ 420 MHz  →  6 路步进电机 + 夹爪舵机（2 kHz 控制环）
                                     │
                    AS5047P 绝对编码器（SPI 反馈，14 bit）
                                     │
        浏览器 Web Serial 控制面板（Chrome / Edge，无需 MATLAB 授权）

• 几何层：SolidWorks 出实体，导入 Simscape Multibody 得到可仿真的刚体树（importrobot('Assem1')），连杆尺寸与关节限位在这一层定义。
• 规划层：MATLAB 用 Robotics System Toolbox 的 inverseKinematics 解逆运动学，得到 6 个关节角。
• 传输层：6 个逗号分隔的角度值 + 换行，走 USB CDC 虚拟串口，115200 8N1。
• 执行层：STM32H743 在 TIM6 中断里以 2 kHz 统一推进 6 轴脉冲，夹爪走 50 Hz PWM。
• 反馈层：6 片 AS5047P 通过 SPI1 读绝对角度（mode 1，14 bit），用于校验与后续闭环。
• 替代入口：不想装 MATLAB？官方提供纯浏览器控制面板，用 Web Serial API 直接连串口下发角度。

🔧 第二段：硬件栈（选型逻辑比参数更重要）

⚙️ 第三段：关节传动与脉冲当量（写控制器前先抄下来）

🖥️ 第四段：通信协议与控制方式

上位机侧有两种用法：MATLAB 会话（算 IK + 驱动仿真 + 串口下发）或浏览器控制面板（Chrome / Edge 打开 HTML，点 Connect 选串口即可操控，不需要 MATLAB 授权）。MATLAB 会话的标准开场如下，第一步必须先建 jointData——Simscape 的 From Workspace 模块依赖它：

% 每次开新会话都先跑这一段
jointData = zeros(2,7);            % 必须最先执行
load_system('Assem1');
robot = importrobot('Assem1');
robot.DataFormat = 'row';
limitsDeg = [-180 180; -70 70; 120 240; -180 180; 60 300; -180 180];
for i = 1:6
    robot.Bodies{i}.Joint.PositionLimits = deg2rad(limitsDeg(i,:));
end
ik = inverseKinematics('RigidBodyTree', robot);
weights = [1 1 1 1 1 1];
q0 = homeConfiguration(robot);
s  = serialport("COM9", 115200);   % 实际端口以设备管理器为准

% 常用动作
armIK(robot, ik, weights, q0)                         % 交互式 IK 滑块工具
goToXYZ(robot, ik, weights, q0, [-0.15 0.30 0.10], s) % XYZ → 真机 + 同步孪生
moveBoth(s, [0 10 0 0 0 0])                           % 真机与仿真同时相对移动
armWave(s)                                            % 挥手动作
writeline(s, "HOME")                                  % 编码器归零

🧪 第五段：数字孪生与演示（这台机器的招牌）

Simscape Multibody 的 Mechanics Explorer 里放着一台与真机同尺寸的实体臂，MATLAB 每次解完 IK 就把关节角写进 jointData，From Workspace 模块读这个两列时间表驱动 6 个转动副——点 Run，屏幕上的仿真臂与桌面上的真机会走同一个动作。

• 位置锁定（Position Lock）：末端点固定在空间一点，工具姿态扫过一圈——看连杆如何在保持端点不动的前提下流动。
• 姿态锁定 + XYZ 扫掠（Orientation Lock + XYZ Sweep）：工具角度锁定，末端沿 X / Y / Z 各扫一遍。
• 动作库：垂直方形、挥手、抓取放置等序列已录好（drawSquare.m / armWave.m / objectPicking.m 等）。
• 零空间演示：nullspaceDemo.m——同一末端位姿下改变关节配置，理解 6 轴臂的冗余自由度。
• 手动驱动：set_param('Assem1','SimulationCommand','start') 可在脚本里直接启动仿真，方便批量验证。

👁️ 第六段：视觉子系统（像素 → 世界坐标 → IK）

📥 资料下载（官方全量镜像 · 免翻墙）

下列文件均为官方仓库原文件的本站镜像，按用途分目录存放，可直接右键另存。全部资源共 248 个文件 / 约 27.7 MB。

docs · 报告与演示（EDR Documentation）

schematics · 电气原理图

gerber · PCB 制造文件

eda · 嘉立创 EDA 工程（本站补充 · 可编辑源文件）

ik-matlab · MATLAB / Simscape 工程与模型

vision · 视觉脚本与标定数据

firmware · STM32H743 固件工程（170 文件 / 11.8 MB）

🚀 第七段：快速开始（三步跑通）

1. 固件：STM32CubeIDE 导入 firmware/ 工程（含 .launch 配置）→ 编译 → ST-Link 烧录 → 确认板子枚举出 USB 虚拟串口。若从 CubeMX 重新生成代码，必须重新注释掉 MX_SDMMC1_SD_Init()——没插 SD 卡时它会直接陷进 Error_Handler() 导致开机死机。
2. 上位机：MATLAB 打开 ik-matlab/，按 GUIDE.txt 第 0 节初始化（jointData → importrobot → 关节限位 → IK 求解器 → 串口），再跑 goToXYZ 或 armIK。
3. 免 MATLAB 路径：用 Chrome / Edge 打开官方控制面板 HTML → Connect arm → 选串口 → 直接下发角度。接管前先 clear s 释放 MATLAB 占用的串口，否则打不开。

🐛 第八段：踩坑要点（这一节最省时间）

• 编码器「幽灵漂移」的根因是 -1 哨兵值：读函数失败时返回 -1，这些值被混进 30 次采样均值，导致静止关节读数摆动 60~70°——传感器一直是好的。求均值前过滤掉 -1，重复精度立刻回到 ±0.01°。关键线索是「降速反而更糟」：真实的信号完整性问题永远随降频而改善。
• ISR 重定时会缩放错一倍多：从 50 kHz 改到 2 kHz 时，dt = 0.00002 与 stepInterval = 50000/speed 错了 25 倍，表现为所有电机爬行。正确值是 dt = 0.0005、stepInterval = 2000/speed。
• 归零必须用原始电机索引：Stepper_MoveAll()（不加 jointDir）才是对的，用关节索引会出现「双向符号翻转」bug。
• 10° 分块发送：长距离移动拆成小块，既不丢动作也不用改固件。
• 遥测与命令二选一：周期性打印会把握手包冲掉，别让两者同时占用串口。
• Simscape 每个关节只留一对配合：多一个平行 / 垂直配合就把转动副锁死。
• 挪动相机必须重标外参：单应矩阵只在标定时的相机位姿下成立，内参可以继续用。
• 脉冲当量必须逐轴实测：J6 实测 3200 而非设计 1600，说明细分设置与实际驱动不总是一致。
• 别把它当成品设备：官方 README 标注 Status: Active Development，可能存在 bug，使用风险自担。

📊 项目当前状态（官方自评）

⚖️ 许可与使用提示

• 许可证：仓库以 Apache-2.0 许可发布（见仓库根目录 LICENSE）。允许商用与修改，但需保留版权与许可声明、并说明修改内容。
• 第三方组件：固件工程中的 Drivers/（ST HAL / CMSIS，含 LICENSE.txt）、Middlewares/、USB_DEVICE/ 版权归 STMicroelectronics，另有第三方许可（部分为 BSD-3-Clause），再分发时不要删除其许可文件。
• 本站角色：本站为资料镜像与中文讲解，不是项目作者、也不对文件内容做修改；如与官方仓库不一致，请以 官方仓库为准。
• 安全提示：这是一台自重与扭矩都不小的机器，调试时务必限制关节速度与工作空间，先小角度点动再整段运动，旁边不要站人、不要放易损物。

🔗 官方资料直达

• GitHub · 6-dof-arm-neuralnexus主仓库：README 全文、报告、原理图、Gerber、固件、MATLAB 与视觉脚本
• GitHub · NeuralNexusArm_CodeBase（固件仓库）STM32H743 固件的独立代码库，README 徽章指向同一套固件
• 本站镜像 · README.md37 KB 官方说明全文（电机选型、传动、仿真、硬件、软件架构、快速开始）
• 本站镜像 · 固件构建与协议说明引脚映射、脉冲当量、USB CDC 三个必要条件、串口协议
• 本站镜像 · MATLAB 命令速查卡从会话初始化到两个锁定演示的完整命令序列

❓ 常见问题

✅ 下一步

建议顺序：先读 docs/Neural_Nexus_Final_Report.pdf 建立整体印象 → 用 ik-matlab/GUIDE.txt 在 MATLAB 里跑通仿真与 IK → 再刷固件连串口试相对移动 → 最后才碰视觉标定。每一步只动一层，出了问题容易定位。