南京中科微电子有限公司

CSM Studio IDE

V21.11
 南京中科微电子有限公司

1、CSM Studio IDE 简介与安装

1.1 简介

CSM Studio IDE 是南京中科微电子有限公司开发一款跨平台的支持 RISCV 系列 MCU

的C/C++集成开发环境。

1.2 安装

运行 CSMStudio_xx.xx_Setup_x64.exe 进行引导安装即可。

1.3 启动 CSM Studio IDE

在桌面，双击” CSM Studio.exe ”快捷方式即可 启动 CSM Studio IDE ，如图 1-1

所示 。

图 1-1 双击“CSM Studio.exe” 启动 CSM Studio IDE

第一次启动 CSM Studio IDE 后，将会弹出对话框，要求设置默认编译器。如图
1-2 所示：
 南京中科微电子有限公司

图 1-2 设置默认编译器
首次启动 CSM Studio IDE 的界面如图 1-3 所示：

图 1-3 启动界面
 南京中科微电子有限公司

1.4 语言设置

CSM Studio IDE 支持英文和中文双语言，IDE 默认使用英文语言集。

设置步骤如下：
第一步：在菜单栏中 “Setting->Envrionment”，如图 1-4 所示。
第二步：在弹出的窗口中 选择“View”，然后勾选“Internationalization”， 如图 1-5
所示。
第三步：重启 CSM Studio IDE 使设置生效。

图 1-4 设置语言

图 1-5 设置软件语言集
 南京中科微电子有限公司

2、创建 Hello World 项目

本节将介绍如何使用 CSM Studio IDE 创建一个简单的 Hello World 项目，主要步骤如下：
第一步：在菜单栏中 “File->New->Project”。如图 2-1 所示。
第二步：在弹出的窗口中选中“RISCV Project”，点击“Go”按钮，或者直接双击“RISCV
Project”图标，如图 2-2 所示。
第三步：在弹出的窗口中，单击“Next”按钮 ，如图 2-3 所示。
第四步：如图 2-4 所示，在弹出的窗口中设定以下参数。
①Project title: 项目名称
②Folder to create project in:项目本地存放目录
③Project filename：项目工程文件名称
④Resulting filename:工程文件在本地的全部路径(包含文件名)
第五步：如图 2-5 所示：在弹出的窗口选择编译器该工程使用的编译器。RISCV Project
默认使用的是编译器是 riscv64-unknown-elf-gcc,单击“Next”按钮进入下一步。
第六步：在弹出的窗口中选择 MCU 型号，默认选择 CSM32RV20， 选择之后，单“Next”
按钮。，如图 2-6 所示。
第七步：如图 2-7 所示：在弹出的窗口中单击 “Finish”按钮， “Hello World” 项目
已经创建完成。 创建完成的“Hello World”项目界面如图 2-8。

图 2-1 创建 Project
 南京中科微电子有限公司

图 2-2 创建 RISCV Project

图 2-3 RISCV Project 工程简介

 南京中科微电子有限公司

图 2-4 设置 HelloWorld 项目的基本信息

 南京中科微电子有限公司

图 2-5 设置 HelloWorld 项目的编译器

图 2-6 设置 MCU 型号
 南京中科微电子有限公司

图2-7 与 MCU 型号对应的配置

图 2-8 HelloWorld 项目创建完成的界面

 南京中科微电子有限公司

3、配置CSM Studio IDE

3.1 设置全局编译选项

在 CSM Studio IDE 中，编译选项分为全局设置和局部设置，IDE 默认已经设置了

编译选项，如果采用默认配置可以跳过本章节，直接编译生成代码。如果需要不
同的编译选项，可以单独设置全局编译选项或局部编译选项。
全局编译选项查看步骤为：单击菜单栏中的 Settings->compile”
在弹出的窗口中，选择 Compiler settings 标签页，然后就可以看到默认的
Compiler 层次选项。默认选项有 march=rv32imac 、mabi=ilp32、mtune=rocket 、
mcmodel=medlow、ffunction-sections、fdata-sections, -O2 等编译选项。
相关配置如图 3-2 和图 3-3 所示.。
 南京中科微电子有限公司

图 3-2 全局编译器选项

图 3-3 全局编译选项

3.2 设置局部编译选项

IDE 在同样支持针对项目工程设置局部编译选项，设置步骤为：右击项目工
程名，在右击菜单中选择“Build options…”，如图 3-4。然后再弹出的”Project
build options…”窗口中就可以设置该项目特有的局部编译选项，如图 3-5。
但是在设置局部编译选项时，需要特别注意与全局编译选项的逻辑关系，必
须保证全局编译选中的选项 不得出现在局部编译选项中，否则会导致编译选项
冲突。
 南京中科微电子有限公司

图 3-4 单击 Build options

图 3-5 局部编译选项
 南京中科微电子有限公司

4、 编译 Hello World 项目
在 CSM Studio IDE 中编译项目有三种操作方法
第一种：点击菜单栏中的 “Build”选项，按照需求选择执行 “Build”编译工
程，“Rebuild”重新编译工程以及“Clean”清除编译生成的输出文件。见图
4-1。
第二种：Workspace 工作区，选中 HelloWorld 项目，单击鼠标右键，按照需求
选择执行 “Build”编译工程，“Rebuild”重新编译工程以及“Clean”清除编
译生成的输出文件。详见图 4-2
第三种：在工具栏中的工程编译区，按照需求选择执行 “Build”编译工程，
“Rebuild”重新编译工程以及“Abort”中断编译过程。详见图 4-3

图 4-1 通过菜单栏进行编译
 南京中科微电子有限公司

图 4-2 通过右击 HelloWorld 进行编译

 南京中科微电子有限公司

图 4-3 通过工具栏进行编译

5、调试 Hello World 项目

程序编译成功后之后，便可以将程序下载到 MCU 开发板进行调试运行。CSM
Studio IDE 支 持 CJlink( 南京 中科 微电 子 有限公 司开 发的 在线 调试器 )和
Jlink(Segger 公司通用调试器)两种调试器。 Debugger 配置页可以进行选择，
IDE 默认使用的 Jlink。在切换调试器的同时，必须要选择相应的可执行路径，
具体设置请阅读后续章节。如图 5-1 所示。如果采用 CJlink 参考 5.1 小节，采
用 Jlink 则参考 5.2 小节。

图 5-1 选择调试器

5.1 选择 CJlink 调试器

如果需要使用 CJlink 调试器，请联系销售。

 南京中科微电子有限公司

5.2 选择 Jlink 调试器

第一步：设置可执行文件路径
路径为“安装目录/share/jlink/JlinkGDBServerCL.exe 。Adapter Type 选择
Jlink。如图 5-8 所示。

图 5-8 选择 Jlink 为调试器

第二步：安装 Jlink 驱动
首先通过 Jlink 调试器将 MCU 开发板与主机 PC 进行连接，具体步骤如下。

① 将 Jlink 调试器的一端通过 USB 接口与 PC 主机进行连接，另一端与 MCU

开发板进行连接。如图 5-9 所示，在 PC 主机的设备管理器中会出现

J-link_Hello 设备 ，其中黄色叹号表示该设备没有安装正确的驱动。
注：如果是第一次在当前主机使用 Jlink 调试器，为了使主机能够识别 Jlink
调试器，需要安装驱动。
① 如图 5-10 所示，在 CSM Studio IDE 的安装目录下的 share/drivers/Jlink
目录中， 双击 JLink_Windows_V694a.exe 开始进入驱动安装流程。
② 如图 5-11 所示，驱动安装成功后之后，在 PC 主机的设备管理器中 J-Link
Driver 设备。

图 5-9 未安装驱动的 Jlink 调试器

 南京中科微电子有限公司

图 5-10 Jlink 驱动安装程序

图 5-11 已安装驱动的 Jlink 调试器

第三步：更新 Jlink 调试器固件

目前 CSM Studio IDE 支持 V10 版本以上的 Jlink 调试器，如果使用的是全
新的 Jlink 调试器，需要升级固件版本；否则跳过此步骤。
注意：如果调试时，芯片采用 Jlink 供电，确保 Jlink 输出电压为 3.3v。

① 在安装目录下的 share/jlink 目录中，双击启动 JLinkGDBServer.exe,如图

5-12。

图 5-12 启动 JLinkGDBServer.exe
 南京中科微电子有限公司

② 设置 Jlink 连接参数，如图 5-13。

图 5-13 Jlink 连接参数

③ 提示更新固件，然后点击 Yes 进行固件更新。如图 5-14。

图 5-14 提示固件更新
 南京中科微电子有限公司

④ 选项 Yes 之后，固件开始更新，如图 5-15。

图 5-15 Jlink 固件更新

⑤ 固件更新之后，Jlink 调试器会进行连接 MCU，如图 5-16，表示 Jlink 调试

器与 MCU 连接成功。
 南京中科微电子有限公司

图 5-16 Jlink 调试器与 MCU 连接成功

 南京中科微电子有限公司

5.3 通过 CSM Studio IDE 调试 MCU

通过 CSM Studo IDE 在 MCU 开发板下载调试程序的步骤如下。

① 如图 5-17 所示，在工具栏的调试区有关于各种调试功能的按钮，单击
“Debug/Continue”按钮，开始调试流程。

图 5-17 调试工具栏
② 如图 5-18 所示，正确运行调试功能，命中断点。

图 5-18 调试 MCU 命中断点。

 南京中科微电子有限公司

③ 如图 5-19 ，5-20 所示，通过工具栏打开反汇编窗口。

图 5-19 打开反汇编窗口

图 5-20 反汇编代码窗口
 南京中科微电子有限公司

④ 如图 5-21 所示，查看寄存器和变量。

图 5-21 寄存器和变量窗口
 南京中科微电子有限公司

6、常见问题
1、调试器无法连接
解决办法：（1）检查控制面板，调试器驱动程序是否正常。
（2）如果使用的是全新的芯片或下载异常中断导致的无法连接，需使用串
口下载工具 CSMISP 下载任意正常程序后使用调试器连接。
（3）如果芯片采用调试器供电，请确认调试器输出电压为 3.3v 左右。
（4）确认 Jlink 版本为 V10 及以上。
如果还无法连接，对于 Jlink 可以参看 5.2 小节第三步查看调试器的工作状态。