WIoTa二次开发环境之VS Code

一、所需工具和环境:

WIoTa二次开发使用交叉编译环境,对编辑器没有强制要求,此文档介绍如果使用VS Code进行WIoTa二次开发。其中所需要的工具包括:VS Code、python、scons、git、env(可选)、编译工具链和WIoTa SDK开发包。

二、环境搭建

VS Code下载

VS Code下载地址:https://code.visualstudio.com/。

image

image

按照流默认进行安装:

image

扩展支持选择python和c/c++等,也可以在打开工程文件夹后,根据提示进行扩展安装。

Python环境

Python3的下载地址:https://www.python.org/

安装:

image

scons工具

使用pip工具,安装scons。打开cmd,运行pip install scons==4.4.0

scons工具安装完成后重启VS Code可在terminal终端中调用。

注意:scons的版本建议使用4.4,已知4.5在编译AP固件时会有python数字类型的错误

env工具(可选)

RT-Thread env工具为绿色工具,可下载后直接使用。下载地址:

https://www.rt-thread.org/page/download.html

env的配置方法参考WIoTa二次开发概述:

https://mkdocs.ucthings.com/wiota/wiota_customer_guide/wiota_customer_guide/

SDK开发包

从使用git工具从github clone二次开发的SDK包,仓库地址参考二次开发概述:

终端侧代码:GitHub - ucchip/wiota_dev_customer

基站侧代码:GitHub - ucchip/wiota_ap_customer

异步节点代码:GitHub - ucchip/wiota_async_customer: WIoTa async code

也可以使用VS Code进行代码clone

编译工具链

编译工具在UCCHIP IDE目录下,相的获取和安装方式参考UCCHIP IDE安装文档:

https://mkdocs.ucthings.com/ucchip_env/ucchip_ide_install/

环境配置

参考“WIoTa二次开发概述”:

https://mkdocs.ucthings.com/wiota/wiota_customer_guide/wiota_customer_guide/

指定正确的编译工具链路路径。

编译

使用scons工具进行代码编译:

在VS Code中打开一个bash终端,使用scons指令进行编译。常用指令:

scons -j8 //编译,使用8个线程

scons -c -j8 //清除,使用8个线程

编译完成的bin文件在工程文件根目录下

下载

参考“UC烧写工具使用”教程,进行烧录工具下载:

https://mkdocs.ucthings.com/wiota/wiota_tools/ucprogrammer/ucprogrammer/

调试:

WIoTa支持GBD调试,由于芯片上还有无线射频部分在运行,对程序进行中断会造成通信功能异常。

一般调试可以使用串口打印的方式进行。

基于Codelite的gbd调试方法参考:

https://mkdocs.ucthings.com/ucchip_env/debug/

其他

不同版本python环境

代码在编译时会生成部分构建临时文件,若代码在不同版本的python环境下进行编译,python2和python3会有不兼容的情况,导致编译失败。删除这部分临时文件后重新编译可正常执行。

Linux系统下环境搭建及差异

参考文档:WIoTa Linux环境编译工具链和环境搭建方法

Scons构建工具

参考主页:https://scons.org/获取详细介绍