Skip to main content

Day02 · AtomCode 安装与 HXC/AM32 底盘开发环境配置

本教程介绍如何安装 AtomCode AI 终端,并通过两条核心命令启动它;随后拉取 Darrenpig/new_energy_coder_club 的 Skill 分支,并在 AtomCode CLI 中配置 HXC 开发 AM32 底盘环境。

1. 安装 AtomCode

AtomCode 是一款开源终端级 AI 编码助手,支持 Windows、macOS、Linux 与 HarmonyOS PC。

1.1 Windows(PowerShell)

以管理员身份打开 PowerShell,执行安装脚本:
脚本会自动将 atomcode 加入 PATH(通常为 ~/.atomcode/binC:\Users\<用户名>\.atomcode\bin)。

1.2 macOS / Linux / HarmonyOS PC

打开终端,执行:
安装完成后,重新加载 shell 配置或重启终端:

1.3 验证安装

正常应输出版本号,例如 atomcode 4.25.7

2. 两条核心命令

启动后,你会看到 AtomCode 的交互界面,可以直接用自然语言描述任务。

3. 拉取 Skill 分支

在 AtomCode 终端中,执行以下命令克隆 NEC 仓库的 Skill 分支到本地:
如果网络较慢,也可以先配置 Git 使用 AtomGit 镜像或 SSH 密钥。
进入仓库目录:
确认当前分支为 skill

4. 配置 HXC 开发 AM32 底盘环境

进入 new_energy_coder_club 目录后,直接启动 AtomCode 并输入配置需求:
在 AtomCode CLI 中输入类似以下提示词:
AtomCode 会根据仓库内的 Skill 配置和项目结构,自动完成以下常见步骤:
  1. 检查系统是否安装 Python、pip、pyserial 等依赖。
  2. 检查 ST-Link / USB 转串口驱动是否正确识别。
  3. 下载或定位 AM32 配置工具(AM32 Config Tool)。
  4. 根据 HXC 底盘硬件清单,生成或校验电机参数文件。
  5. 输出下一步烧录/调试命令。
如果你的硬件版本或电调型号有特殊要求,可以在提示词中补充,例如:「使用 HXC v2.1 底盘、AM32 F051 电调」。

5. 常用后续命令

在 AtomCode 会话中,可以继续使用以下命令推进工作:
如需手动烧录 AM32 固件,常见命令示例:
Windows 下串口号通常为 COM3COM4 等;Linux/macOS 下通常为 /dev/ttyUSB0/dev/ttyACM0

6. 常见问题

Q1:PowerShell 执行策略阻止安装脚本?

临时允许执行:

Q2:安装后 atomcode 命令找不到?

检查 PATH 是否包含 ~/.atomcode/bin,或手动添加:

Q3:拉取 Skill 分支失败?

确认 Gitee 账号有访问权限,或改用 HTTPS/SSH:

Q4:AM32 配置工具无法识别电调?

  • 确认电调已上电并与电脑通过 USB 连接。
  • 确认驱动已安装(Windows 可设备管理器查看)。
  • 确认选择了正确的串口与波特率。

7. 相关资源