昇腾310B实战 · 全书导览

全书结构：理论教程、实践案例与附录

Ascend310/
├─ README.md                 运行、构建与板端部署入口
├─ src/book/                 理论与教程正文
├─ src/experiment/           案例叙事、流程图、网络结构图
├─ src/appendix/             硬件、环境、工具与操作补充
├─ samples/                  可运行代码、模型脚本、测试
├─ scripts/                  构建、部署与静态校验
└─ src/presentation/         Marp 演示源文件（本目录）

演示只引用已经存在的源文件；生成的 HTML 和复制后的图片放在 src/.vuepress/public/presentation/，不回写源目录。

内容链：从概念到板端证据

每个案例都把“源码位置、图示来源、能否在本机运行”分开记录，避免把板端结果误当成本地结果。

附录 5：ROS2 基础与 310B 集成边界

ROS2 节点 ──话题/服务/动作──> 机器人功能包
      │
      ├─ 传感器：摄像头、雷达、IMU
      ├─ 底盘：串口/CAN 控制接口
      └─ 远程：SSH、VNC、多机通信
               │
               └─ 建议集成路径：ROS2 话题 -> 310B 推理服务

ROS2 附录以 Humble 为主要示例版本，覆盖 DDS、工作空间、功能包、通信、launch、TF2、URDF、SSH/VNC 和自启动。ROS2 + NPU 的端到端链路在当前仓库中尚未验证。

samples/ 的代码结构：入口和职责一眼可见

samples/case1/              samples/case2/
├─ app.py                   ├─ scripts/detection_app.py
├─ face_attendance/         ├─ scripts/tracking_app.py
│  ├─ inference.py          ├─ tracking/deepsort.py
│  └─ runtime.py            └─ utils/postprocessing.py

samples/case3/              samples/case9/
├─ scripts/                 ├─ app.py (网关)
├─ piano_ddsp/              ├─ acl_om_service.py
└─ web/                     ├─ mindspore_chat_service.py
                            └─ contract-v2.json

先从入口脚本和 README.md 读起，再看模型合同、测试和板端命令。

如何核对一张图和一条结论

1. 在对应的 src/book/、src/experiment/ 或 src/appendix/ 找到原图和正文。
2. 在对应 samples/*/ 找到入口、模型合同和测试；路径以源文件为准。
3. 只把板端执行得到的 ATC、ACL、性能和识别结果写成硬件证据。
4. 用 pnpm run docs:slides 重建，构建脚本会检查图片是否存在并复制到输出目录。

专题教学演示入口

从本页的来源路径出发，可以回到原始 Markdown、真实图片和可运行代码。