这是最新(主)开发分支的文档。如果您正在查找以前版本的文档,使用左侧的下拉菜单选择所需的版本。

IDE 编译环境

目前提供两种 IDE 可供用户选择使用:

1、Eclipse

环境要求

  • Eclipse 版本必须使用 Eclipse IDE for C/C++ Developers 2021-12 (4.22.0)

  • CDT 版本建议使用 C/C++ Development Tools 10.5.0.202112012329

  • 不支持在 Windows 7 及以下的 Windows 系统中使用。

后续会适配至最新版本 Eclipse。

安装 IDE

打开你的 Eclipse,点击 Help,找到 Install New Software 选项。

Name 输入框可输入 WM-IDE,

Location 输入框可输入地址:

http://zone.winnermicro.net:60800/wmios/eclipse

https://zone.winnermicro.net:60443/wmios/eclipse

即可点击 Add,按照下图标注进行安装,步骤二默认为选择改为不选择(若勾选可能比较耗时)

../_images/InstallationSteps.png

安装之后需要先信任此插件,然后需要重启

../_images/TrustInstallation.png

Eclipse 重启之后若出现这个按键,说明安装成功

../_images/FoundSDK.png

配置IDE

点击功能栏中的 WinnerMicro,找到 settings

需先配置 WM IOT SDK Path 路径(即源码位置),再配置 WM IOT SDK Tools 路径(即工具位置)。

配置 IDE 环境

../_images/IDE-Tools.png

下述为所需工具的文件路径:

CMake Binary Path:

自定义磁盘\winnermicro\wmclics\cmake\bin

Ninja Binary Path:

自定义磁盘\winnermicro\wmclics\ninja

CCache Binary Path:

自定义磁盘\winnermicro\wmclics\ccache

Python Binary Path:

自定义磁盘\winnermicro\wmclics\python

Toolchains Path:

自定义磁盘\winnermicro\wmclics\toolchain\csky-elfabiv2-tools\bin

DebugServer Path:

自定义磁盘\winnermicro\wmclics\c-sky\T-HeadDebugServer\bin

创建工程

首先创建文件,根据下图步骤操作

../_images/createProject.png

设置文件名称,点击 Finish

../_images/projectName.png

生成好之后界面如下

../_images/projectGround.png

首先要选择芯片版本,找到界面上面功能栏中的 menuConfig

../_images/menuConfig.png

跟着下图步骤操作芯片版本的更换

默认soc 类型为: W800S2

../_images/Setupchip.png

进行上述操作步骤后,就完成了基本配置。

编译固件

在配置完成之后,就可以进行编译。

有两种方式启动编译,左边是快捷编译,右边是重新编译。第一次编译的话要选择右边。

../_images/buildCompilation.png

也可以在工程上右键,选择 build 工程。

点击之后,后台显示如下图,就说明编译成功。

../_images/buildConsole.png

将固件烧录到芯片中

点击界面中烧录按键

../_images/Burnbutton.png

然后会出现弹窗 弹框内容:

port: 表示端口,首先需要确认端口号

baudrate: 表示波特率,无需改动

../_images/Falsh.png

选择正确的串口之后点击 start 按键,之后按界面提示操作,直至烧录完毕。

查看运行结果

点击界面中终端按键,提供显示结果界面

../_images/terminalButton.png

弹出此界面选择端口以及波特率

../_images/terminalLaunch.png

如无错误,则在控制台界面中出现了此内容

../_images/Runresults.png

提示

在 Windows 系统下,我们提供了包含 Eclipse IDE 的一键安装编译环境集成包,点击下载 Eclipse IDE 集成包

2、VS Code

打开VS Code之后点击最左侧的扩展,然后搜索 WM-IDE 进行安装

../_images/Plug-ins.png

为了更好的使用 VS Code 进行 WM IoT SDK 开发,建议再安装如下扩展:

  • Microsoft C/C++ extensions

  • Microsoft Serial Monitor Extension

下好之后会发现,左侧功能面板出现一个 WinnerMicro 图标, 点击此图标就可以进行配置环境、创建工程等操作。

../_images/SDK-project.png

在创建工程的时候需要先配置 IDE 环境

IDE 所需工具路径跟上述 Eclipse 中配置工具的操作一样

../_images/IDE-Configuration.png

创建工程界面输入工程保存位置以及工程名之后,就会生成工程,

对工程文件进行编译、烧录、运行操作,需选择任一工程文件, 如 main.c 文件,点击 main.c 然后右键:

../_images/SDKfunction.png

根据上述图片步骤:

1、选择 menuconfig 打开设置菜单进行项目配置

2、编译工程

3、烧录固件

也可以在底部的状态栏中的 WM IoT SDK 菜单中选择对应命令进行操作。

成功烧录固件后,可点击 串口监行器->更改端口号(与芯片端口号一致)->更改波特率->运行 查看运行结果

../_images/start.png