AliOS Things uCube是AliOS Things基于命令行的开发管理工具(命令简写为aos),主要功能包括:工程配置与编译、Image下载调试、应用开发框架、脚手架、组件安装管理、设备管理、代码审查、OTA工具功能以及与IDE集成功能。

uCube 基于 Python(支持Py 2.7和3)语言开发,需要有Python开发环境。如开发环境中尚未安装aos-cube,请通过pip install -U aos-cube进行安装(需确保先安装了python和pip工具)。

使用

工具改善计划

从0.3.11之后的版本开始,安装aos-cube工具后,首次运行aos-cube命令时会有如下提示:

***Attention***:
==============================================================
    In order to improve the user experience of this tool,
    we want to collect some of your system information
    (e.g. OS version, IP, shell used, aos-cube functionalities
    most frequently used, etc.). All collected information
    will be only be used in the user-experience improve plan,
    and will be carefully and restrictly secured.
==============================================================
Do you want to participate in the activity?
Please type 'Y[es]' or 'N[o]': Y

该提示旨在提示用户参与工具改善计划,用户可自由选择,用户选择Yes后会有部分信息收集用于工具使用的统计和后续改善。建议用户选择Yes参与该计划

查看版本和帮助

使用aos --version查看aos-cube版本。 使用aos -h查看aos-cube支持的命令。 使用aos <cmd> -h查看命令的格式、选项和参数说明。 使用aos <cmd> <subcmd> -h查看子命令(如有)的格式、选项和参数说明。

环境变量设置

用户拿到AliOS Things SDK后,开发前首先需设置“AOS_SDK_PATH”环境变量(指向aos源码根目录)。

创建应用

通过aos create project -b <board_name> -d <project_dir> -t <example_templete> <projectname>创建应用工程,开始应用开发。

配置

切换到应用工程目录,执行aos make menuconfig可进行可视化配置。同时,配置也可以通过修改应用工程中的aos_config.h文件进行。

更新工程元数据

当开发中修改了代码和配置,可以通过aos make update进行工程元数据的更新。

工程构建

完成应用开发后,可以通过构建命令aos make进行编译。关于使用aos make执行构建请参考使用命令行工具开发

烧录与调试

构建完成后,连接开发板到开发主机,首先将编译生成的镜像上传到开发板,然后启动调试器:

aos upload helloworld@developerkit
aos debug helloworld@developerkit

AliOS Things 2.1及其后续版本支持简化的烧录和调试命令行(需要aos-cube 0.3.x):

aos upload
aos debug

注意,命令行烧录和调试功能目前仅支持stm系列、esp32/esp8266等部分硬件平台。

串口监控

通过连接串口,查看应用输出和执行过程:

$ aos monitor <serial port> <baudrate>

SAL/MAL驱动开发

如果是进行SAL/MAL外设驱动开发,可以借助脚手架自动生成驱动框架,然后在对应的框架中完成驱动开发。

  • 生成SAL驱动框架:aos create saldriver -t <gprs|wifi|lte|nbiot|eth|other>
  • 生成MAL驱动框架:aos create maldriver -t <gprs|wifi|lte|nbiot|eth|other>

组件开发与管理

从3.1版本开始,AliOS Things支持组件话开发和管理。官方认证的组件发布在云端服务器,用户可以通过aos-cube命令进行组件的安装和管理。

组件查询

  • 本地组件查询:aos list comp
  • 云端组件查询:aos list comp -r -a

组件安装

  • 从云端安装最新版本组件:aos install comp <name>
  • 从云端安装特定版本组件:aos install comp <name=version>
  • 多个组件安装:aos install comp <name1> <name2> <name3>
  • 从本地文件安装组件:aos install comp -L <zip_or_rpm_file>。本地组件文件,可以是通过aos pack命令生成的ZIP文件,也可以是从AliOS Things组件官网下载的RPM文件。

组件卸载

  • 单个组件卸载:aos remove comp <name>
  • 多组件卸载:aos remove comp <name> [name2] [name3]

组件升级

  • 查询可升级组件:aos upgrade comp -c
  • 组件升级:aos upgrade comp <name1> <name2>

组件开发

  • 使用脚手架生成组件框架:aos create component -t <bus|dm|fs|gui|language|linkkit|network|peripherals|security|service|utility|wireless|generals> <compname>
  • 根据需要增加源码和头文件,并修改对应的aos.mk文件。规范详见《组件规范》。
  • 组件打包与分享:aos pack <comp_dir>
  • 打开组件示例工程:aos open -b <board> <comp_name>

命令速查表