AliOS Things Developer Kit Quick Start Guide
Developer Kit 是一款由上海诺行信息技术有限公司基于 STM32L496VGx 设计的高性能物联网开发板。它的主要软件平台为开源的 AliOS Things，开发者可以基于此快速的开发出各种物联网设备与产品。
AliOS Things 是面向 IoT 领域的轻量级物联网嵌入式操作系统。致力于搭建云端一体化 IoT 基础设备。具备极致性能、极简开发、云端一体、丰富组件、安全防护等关键能力，并支持终端设备连接到阿里云 Link，可广泛应用在智能家居、智慧城市、新出行等领域。
Developer Kit 的软件分成了出厂版本和 SDK。
出厂版本：提供给工厂生产人员使用，用来检验测试出厂硬件各个外设器件 是否能够工作正常。工具包套件中仅包含了编译好的二进制文件，开发者也 可以用来对单板进行测试或者观察外设的功能特性。相关使用方法请参考文档《AliOS Things Developer Kit User Basic Operation Guide》。
SDK：提供给物联网开发者与高校教育培训机构使用，用来快速评估与开发出各种物联网产品。SDK 内容包括编译烧写相关的工具和主要软件平台 AliOS Things。Developer Kit 板级代码已经加入 AliOS Things 源码树中，以后也会不断地进行完善与更新。
开始开发 AliOS Things 之前，需要安装一系列的工具软件。本章节主要介绍 Windows 环境下开发环境的搭建过程。
打开软件包，解压 en.stsw-link009.rar 到当前目录。 将附带的USB 线缆一头插入Developer Kit 的USB ST-Link 口，另外一头连接PC。打开设备管理器，将多出来的未知设备更新驱动程序，选中刚才解压的目录路径，完成安装。
###2.1.2 ST-LINK Utility 打开软件包，解压 en.stsw-link004.zip 到当前目录。打开解压后的安装程序一路完成安装。
打开 Python 官网，选择相应的 2.x 版本（当前最新版本为 Python 2.7.15）下载并安装：
https://www.python.org/downloads/windows/；
安装完成后，在系统属性中为的系统环境变量 PATH 加入相应的路径（根据自己的安装目录）:
打开 pip 官方网站，选择最新的压缩包版本（当前最新版本为 pip-10.0.1.tar.gz）下载：
https://pypi.org/project/pip/#files；完成后解压到任意目录，打开命令提示符，进入到刚才解压到的根目录中，输入命令安装 pip：python setup.py install
Aos是阿里的代码管理编译工具。在安装 aos 之前，需要安装或更新相关依赖软件。在刚才的命令提示符中输入如下命令： $ pip install --upgrade setuptools $ pip install --upgrade wheel
完成后输入如下命令安装 aos： $ pip install --upgrade aos-cube
AliOS Things Studio 是阿里基于 Visual Studio Code 的一套图形化 IDE。进入官网下载并安装： https://code.visualstudio.com/；
完成后打开工具，在最左边的工具条中选择点击扩展，分别安装 C/C++ 插件和alios-studio插件：
为了同步最新的 AliOS Things 代码，需要安装 git。进入官网下载并安装： https://git-scm.com/downloads；
完成后使用 Git GUI 或者 Git Bash 将最新代码克隆到本地： git clone https://github.com/alibaba/AliOS-Things.git git checkout master
AliOS Things 代码的工程名格式为 “应用名字@目标板名字”。应用名字对应为example目录下对应的文件夹名；目标板名字对应为 board 目录下对应的文件夹名。例如 Developer Kit的helloworld 例程工程名为 helloworld@developerkit。
打开AliOS Things Studio，点击左上角菜单栏上的文件->打开文件夹，选择 AliOS Things代码根目录。
打开后点击工具左下角蓝色框条中
Developer Kit提供了三种烧写方式，分别为虚拟 U 盘烧写、ST-LINK Utility 烧写和 AliOS Things Studio 烧写。使用方法如下（推荐使用虚拟 U 盘烧写方式）： 烧写和调试之前需要使用附带的 USB 线缆一头插入 Developer Kit 的 USB ST-Link 口，另外一头连接 PC。此时在 PC 设备管理器中可以看到会自动生成一个虚拟 UART 口。这个 UART 是单板的软件调试口，系统运行后可以观察到调试输出信息。
将单板 USB ST-Link 连接到 PC，此时资源管理器会自动装载一个虚拟的 USB 存储器，直接将编译好的 binary 拷贝到这个 USB 存储器，即可自动烧写。 烧写完成后单板会自动reset，并且可以观察到虚拟的USB 存储器被重新装载。
打开 ST-LINK Utility，点击工具栏中的
AliOS Things Studio 在最后一次编译完成后，直接点击左下角蓝色框条中的
在开始调试之前，需要先对调试器进行板级配置。 使用 AliOS Things Studio 打开单板代码目录，可以观察到左侧资源视图中生成了一个.vscode 目录，打开此目录下的文件 launch.json。
可以看到默认会有几个单板调试配置，开发者可以选择在已经存在配置里面修改，或者创建一组新的配置。 这里以创建新配置为例，将 Debug @ Windows 这一组配置复制下来，添加到最后。修改并适配到目前的工程，主要注意四条配置：name 、program 、setupCommands 和 miDebuggerPath，相关路径使用斜杠或者双反斜杠。我这里以设置 name 为 Developerkit Debug @ Windows 为例，如下：
{
"name": "Developerkit Debug @ Windows",
"type": "cppdbg",
"request": "launch", "program":
"${workspaceRoot}/out/helloworld@developerkit/binary/[email protected]", "args": [],
"stopAtEntry": true,
"cwd": "${workspaceRoot}",
"environment": [], "externalConsole": true,
"miDebuggerServerAddress": "localhost:4242",
"serverLaunchTimeout": 2000,
"targetArchitecture": "ARM",
"setupCommands": [
{
"text": "cd ${workspaceRoot}"
},
{
"text": "source .gdbinit"
},
{
"text": "target remote localhost:4242"
},
{
"text": "file out/helloworld@developerkit/binary/[email protected]"
},
{
"text": "break application_start"
}
],
"customLaunchSetupCommands": [], "launchCompleteCommand": "exec-run", "osx": {
"MIMode": "gdb",
"miDebuggerPath": "arm-none-eabi-gdb"
},
"linux": {
"MIMode": "gdb",
"miDebuggerPath": "arm-none-eabi-gdb"
},
"windows": {
"MIMode": "gdb",
"miDebuggerPath":
"${workspaceRoot}/build/compiler/gcc-arm-none-eabi/Win32/bin/arm-none-eabi-gdb.exe"
}
}
调试器配置完成后，在最左侧的工具栏中点击调试图标，并选择调试器配置：
最后，在最左侧的工具栏中点击资源管理器，选择你想要调试的代码段下断点，按下F5开始进行在线调试。
Link Develop 是阿里云针对物联网领域提供的端到端一站式开发平台，可覆盖各个物联网行业应用场景，主要解决物联网开发领域开发链路长、技术栈复杂、协同成本高、方案移植困难的问题，提供了从硬件设备、模组、数据、服务 API、Web 应用开发到移动 APP 开发全链路的开发流程、框架／引擎和调试工具，并可将成熟的开发产出物对接阿里云云市场进行售卖，为开发者实现商业收益。
Linkkitapp 是一个为开发者展示如何通过 developerkit 接入 Link Develop 平台的例程。该例程会启动相关 sensor 读取环境数据，并将数据自动上传到阿里的智能生活开放平台上。
开始调试 Linkkitapp 之前，需要先进行云端配置，此章节不会对此做详细介绍。云端配置请参考 AliOS-Things 官方 WIKI 相关说明第二章节内容（注意云端配置完成后再转到此文档）：
https://github.com/alibaba/AliOS-Things/wiki/%E4%BC%A0%E6%84%9F%E5%99%A8
%E6%95%B0%E6%8D%AE%E4%B8%80%E9%94%AE%E5%BC%8F%E4%B8%8A%E4%BA%91%E7%9A%84%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E
完成后云端配置后，就要开始进行终端设备的开发了。首先将云端配置中的TLS 信息转换成 C 语音的 JSON 格式，打开页面：
https://www.sojson.com/yasuo.html
将得到的 TLS 信息粘贴进去，并点击“压缩并转义”。
在 AliOS Things Studio 中打开 example\linkkitapp\linkkit_app.c，找到全局字符串数组变量 TSL_STRING，将刚刚得到的 JSON 格式的 TLS 字段粘贴进去；打开framework\protocol\linkkit\iotkit\sdk-encap\imports\iot_import_product.h，找到四元组的定义（linkkitapp 例程一般是最后一个 else），将其替换成云端中得到的字段，如下：
继续打开 framework\uData\uData.mk，翻到最下面找到全局宏定义，将想要数据入云的 sensor 的相关宏定义打开。这里以温度和湿度为例：
完成后在 AliOS Things Studio 中选择编译目标为 linkkitapp@developerki（t 参考 2.3 章节），然后打开根目录下的.vscode\tasks.json，找到 label为 alios-studio: Make 配置项，添加参数 dtc=1，并进行手动保存，如下：
在以上步骤都完成后，进行编译烧写。设备启动后，通过调试串口键入 netmgr 命令连上 wifi 网络：
连接成功后，串口会打印” wifi_service_event”，并且 linkkit 例程会自动启动。打开云端的设备详情页面，稍等片刻可以看到相关数据已经被记录在云端了：
其他问题请参考AliOS-Things WiKi： https://github.com/alibaba/AliOS-Things/wiki
#NOTE: 购买开发板AliOS Things Starter Kit和Developer kit，请扫描天猫旗舰店二维码：
获取在线技术支持，请扫描技术支持群：
