一、所需工具和环境:
WIoTa二次开发使用交叉编译环境,对编辑器没有强制要求,此文档介绍如果使用VS Code进行WIoTa二次开发。其中所需要的工具包括:VS Code、python、scons、git、env(可选)、编译工具链和WIoTa SDK开发包。
二、环境搭建
VS Code下载
VS Code下载地址:https://code.visualstudio.com/。
按照流默认进行安装:
扩展支持选择python和c/c++等,也可以在打开工程文件夹后,根据提示进行扩展安装。
Python环境
Python3的下载地址:https://www.python.org/
安装:
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构建工具