QX-IDE for Visual Studio Code

QX-IDE 是面向 QX C2000 系列芯片开发的 Visual Studio Code 插件，覆盖工程创建、工具链管理、编译烧录、源码调试、实时数据观察和 AI 自动化等完整开发流程。

安装步骤和完整操作说明请参阅 QX-IDE 插件使用说明。

主要特性

使用环境

• Windows 操作系统。
• Visual Studio Code 1.80.0 或更新版本。
• QXTOOLS 1.0.0.202607100910 或更新版本。
• 使用硬件烧录、调试和实时数据功能时，需要 QX-IDE JTAG 调试器及相应驱动。

QX-IDE 已内置工程构建和源码调试能力，不依赖 Microsoft C/C++ 扩展或 CMake Tools 扩展。代码分析由 clangd 提供；即使尚未安装 clangd，编译、烧录和调试功能仍可使用。

快速开始

1. 安装 QX-IDE，并按首次启动提示选择或安装 QXTOOLS。
2. 在 QX-IDE 活动栏中创建新工程，或打开现有 QX 工程。
3. 在“编译参数配置”中核对当前工程参数。
4. 点击项目管理标题栏中的“编译项目”。
5. 连接 JTAG；多设备环境可在“项目工具箱”中选择当前工程使用的调试器。
6. 点击“烧录固件到 Flash”，或通过状态栏启动单核/双核源码调试。
7. 调试运行后，使用“实时调试”“寄存器”和“QX-IDE 波形图”观察运行数据。

功能说明

工程创建与迁移

QX-IDE 从当前工具链读取芯片和模板，按向导创建单核或双核工程，并自动完成工程名称、构建配置、调试入口和代码分析配置。

打开已有 Eclipse QX-IDE 工程时，插件会迁移常用的头文件路径、预处理宏、编译与汇编选项、CLA 配置、库搜索路径和链接脚本。迁移完成后可以直接在 VS Code 中继续维护、编译和调试。

插件会维护必要的工程配置。常用参数建议通过 QX-IDE 图形界面修改；检测到受管理内容被手工改动时，插件会在写回前给出提示。

工具链与代码智能

首次启动时，QX-IDE 会自动发现可用工具链；未找到时可手动选择或安装。插件会检查工具链版本和完整性，不满足要求时给出明确的升级或重新选择提示。

“插件配置”提供工具链路径编辑、重新选择、自动发现、手动更新和可选的定期更新。当前有效工具链由插件统一维护，不需要每个工程重复配置。

插件会检查并按需安装 clangd，并为 QX 工程准备适合代码分析的配置，用于：

• 代码补全和参数提示。
• 定义跳转和引用查找。
• 符号重命名。
• 源码错误和警告诊断。

图形化工程配置

“编译参数配置”根据工程结构显示单核配置，或分别显示 Core0、Core1 和 Bootloader 配置。主要覆盖：

• 头文件路径和预处理宏。
• DSP core、目标架构、C 标准、调试信息和优化设置。
• 汇编器和 CLA 参数。
• VLIW 打包与附加编译选项。
• 库搜索路径、链接脚本和其他链接选项。
• Bootloader 编译与链接参数。

双核工程的两个核心独立配置，便于维护不同的源码、链接布局和编译参数。

编译、清理与 Flash

QX-IDE 直接使用当前工具链完成构建，不要求额外安装构建扩展。

• 单核工程构建当前目标。
• 双核工程默认同时构建 Core0、Core1 以及工程定义的相关目标。
• 清理项目会移除失效缓存和中间产物，为下一次完整构建重新准备环境。
• 编译、清理、下载和擦除期间会阻止重复启动同类操作。
• 耗时操作提供进度提示和取消入口。

Flash 功能支持固件下载、结果校验、BootRAM 更新、烧录后复位，以及独立执行全片擦除。下载选项可通过 QX-IDE 命令进行配置。

多 JTAG 管理

插件会识别当前连接的 QX-IDE JTAG 调试器，并在 USB 设备变化后更新显示。多设备环境下，可以根据设备名称和 COM 口确认目标硬件。

QX-IDE 提供两种选择方式：

• 自动选择：适合只连接一只调试器的常见场景。
• 项目锁定：适合多个工程分别控制不同硬件的场景。

项目锁定只保存在本机，不修改工程文件。锁定设备未连接时，插件会阻止本次烧录或调试并提示重新选择，不会自动切换到其他硬件。

源码调试

打开 QX 工程后，状态栏会根据工程类型显示单核或双核调试入口。调试启动后，同一位置切换为停止操作。

源码调试支持：

• 源码断点和函数断点。
• 继续、暂停、单步进入、单步跳过和单步跳出。
• 调用栈、局部变量和表达式求值。
• 调试控制台。
• 可选的 main 入口断点。
• 单核和双核调试会话切换。

双核调试时，VS Code 会同时显示 Core0 和 Core1 会话。实时变量和寄存器优先跟随“调用堆栈”中当前选中的核心。

实时调试

“实时调试”位于 VS Code 的“运行和调试”侧栏，用于持续观察变量和表达式。

• 通过输入框添加变量或表达式。
• 从源码编辑器选中表达式或将光标放在变量上，一键添加到实时调试。
• 支持粘贴、拖放、删除和根监视项排序。
• 支持结构体、成员和数组展开，大型数组按区间分段加载。
• 支持单次刷新、自动刷新、暂停/恢复和刷新周期设置。
• 支持全局或单节点数字格式。
• 支持复制表达式和添加到波形。

监视表达式会在调试会话断开后保留，重新启动调试后可继续观察。

寄存器查看

“寄存器”视图按当前工程和调试会话展示可用外设寄存器，支持逐层查看寄存器、结构体成员和位域。

• 支持单次刷新和自动刷新。
• 支持暂停/恢复及刷新周期设置。
• 支持十进制、十六进制和二进制显示。
• 支持复制表达式和添加到波形。
• 折叠节点后停止刷新对应子树，减少不必要的硬件访问。

双核工程中，寄存器读取跟随当前选中的调试核心。

实时波形

“QX-IDE 波形图”位于底部面板，可以同时显示来自实时调试和寄存器的数据。

主要能力包括：

• 多曲线显示、隐藏、移除和颜色配置。
• 时间轴与纵轴缩放、时间轴平移和 LIVE 跟随。
• 自动缩放和可配置的时间窗口。
• 左右双 Y 轴及手动范围设置。
• A/B 时间游标和时间差观察。
• 上升沿、下降沿和双边沿触发。
• 暂停、恢复、清空采样和复制 CSV。

新增曲线后，页面会自动调整到适合观察的显示范围。

MCP 自动化

通过“项目工具箱 → 配置 MCP 服务”，可以让 Codex/Agent 调用 QX-IDE 的工程能力，包括：

• 查询工程、芯片和构建目标。
• 编译、清理、Flash 下载和全片擦除。
• 查询当前 JTAG 状态。
• 启动或停止单核、双核源码调试。
• 设置断点和执行运行控制。
• 读取调用栈、变量、表达式和内存。

MCP 适合明确的自动化操作；持续观察变量、寄存器和波形时，应使用 VS Code 图形界面。为避免硬件连接冲突，不要同时通过多个入口占用同一只 JTAG。

界面入口

常用设置

使用注意事项

• 不要同时由多个程序占用同一只 JTAG 调试器。
• 不要在下载、全片擦除或调试初始化期间拔插 USB。
• 执行全片擦除前务必确认目标硬件和当前选择的调试器。
• 高频刷新时只展开和监视真正需要的数据。
• 修改插件管理的工程配置前，建议先提交或备份当前工程。

更多文档

• QX-IDE 插件使用说明：完整的安装、工程创建、编译烧录、源码调试、实时数据和故障排查流程。