本节内容如下:
一、安装开发工具包(本文以windows 版为例)
二、新的Azure Sphere 开发板手动更新Azure Sphere操作系统
三、配置VS Code及Azure Sphere扩展
四、声明 Azure Sphere 设备(本文中均以一个新设备来进行演示)
使用Microsoft 账户创建用户并登录到Azure Sphere 服务;
使用用户(Microsoft 账户)创建租户;
声明:将Azure Sphere 设备ID绑定到租户,该过程也称为认领;
五、配置设备通过WIFI联网
六、启用设备上的应用开发
视频讲解:
您可以在B站观看视频讲解:https://www.bilibili.com/video/av98009311/
或在本站观看:
图文讲解:
一、安装开发工具(本文以windows 版为例)
参考文档:https://docs.microsoft.com/zh-cn/azure-sphere/install/install-sdk
Azure Sphere 开发板通过USB接口插入电脑后,会在设备管理器中提示三个com口,如下图:
如果发生其他错误,或者看到的 COM 端口少于三个,请参阅排查 Windows 安装问题以获取帮助。
Windows 平台下的Azure Sphere SDK 有两类,只安装一类即可,不能同时安装两个:
1. 用于Visual Studio 的Azure Sphere SDK:
使用Visual studio 开发,需要: Visual Studio Enterprise、Professional 或 Community 2019 版本 16.4 或更高版本。
使用Visual Studio Code 开发。
2. 用于Windows 的Azure Sphere SDK:
使用Windows 命令提示符开发;
使用Visual Studio Code 开发。
本文中,采用 “用于Windows的Azure Sphere SDK” + VS Code 开发。
SDK 下载地址:https://docs.microsoft.com/zh-cn/azure-sphere/install/install-sdk#azure-sphere-sdk-for-windows
SDK安装:
安装完成后,会在开始菜单中,出现如下图所示程序:
二、新的Azure Sphere 开发板手动更新Azure Sphere操作系统
在开发板背部安装纽扣电池
通过附带的USB连接线连接至Windows 电脑
对于未使用过的Azure Sphere开发板,首次使用,需要参照如下文档进行Azure Sphere OS升级:
https://docs.microsoft.com/zh-cn/azure-sphere/resources/update-old-seeed-os
升级过程很简单:
1. 打开Azure Sphere Develop Command Prompt
2. 输入命令并等待执行成功:azsphere device recover
三、配置VS Code及Azure Sphere扩展
VS Code 安装Azure Sphere 扩展:
对于本文中的“用于Windows的Azure Sphere SDK” 和VS Code 开发应用程序,还需要安装如下两个程序:
1. CMake https://cmake.org/download/
2. Ninja https://github.com/ninja-build/ninja/releases
对于CMake的安装,直接下一步下一步就可以了:
对于Ninja,需要解压到某目录后,设置环境变量:
Azure Sphere 开发板支持两种应用程序:
1.高级应用程序
2.RTApp实时应用程序
实时应用程序主要利用MCU中的两个ARM Cortex-M4 处理器在实时操作系统上RTOS进行开发,本系列文章暂时不做该内容的介绍。
截至到此,我们已经配置完成了开发高级应用程序的环境,对于RTApp的开发环境配置,本文不再介绍,请参见官网:
四、声明 Azure Sphere 设备(本文中均以一个新设备来进行演示)
使用Microsoft 账户创建用户并登录到Azure Sphere 服务;
使用用户(Microsoft 账户)创建租户;
声明:将Azure Sphere 设备ID绑定到租户,该过程也称为认领;
三个步骤的最终目的就是声明设备,声明设备是将设备ID和Azure Sphere 租户绑定,也称之为“认领”的过程,一旦绑定,即使你将Azure Sphere 设备进行二次销售,该绑定也不能修改。
关于声明的详细步骤,请参见官网:https://docs.microsoft.com/zh-cn/azure-sphere/install/claim-device
本文中,简化了官网文档,仅假设我们操作的设备是一台全新的Azure Sphere,故而很多步骤是不需要操作的。
1. 通过命令登录Azure Shpere,对于刚装好SDK并第一次使用SDK,使用 --newuser
参数以及 Microsoft 帐户电子邮件地址可以创建一个账户并登录:
azsphere login --newuser <email-address>
按照提示输入Microsoft 账户的密码:
同意授权:
登录成功之后:
- 如果你有权访问单个租户,则默认选中该租户,此时可继续执行下一步。
- 如果你无权访问任何租户,则需要创建租户。
- 如果以前已将 Azure Sphere 与 19.09 SDK(或早期版本)配合使用,则可能需要迁移租户。
- 如果你有权访问多个租户,则需要选择一个。 有关详细信息,请参阅 azsphere tenant select。 选择租户后,请继续执行下一步。
在本例中,这是我们第一次使用Azure Sphere,故而没有权限访问任何Azure Sphere 租户,需要先进行创建:
执行如下命令:
azsphere tenant create --name <my-tenant>
将 <my-tenant> 替换为其他用户可识别的名称,例如“Contoso Ltd”或“Contoso Dishwasher Division”。 如果名称包含空格,请将其用引号括起来。 名称必须全部是无符号的字母数字字符。
租户创建完成后,执行如下命令,认领设备,认领成功后,无法再次将设备迁移至其他租户。
azsphere device claim
五、配置设备通过WIFI联网
使用如下命令进行wifi配置:
azsphere device wifi add --ssid <yourSSID> --psk <yourNetworkKey>
配置完成显示state unknown 是正常现象,使用如下命令再次查询网络状态:
azsphere device wifi show-status
使用如下命令,查看Azure Sphere 开发板的OS版本:
azsphere device show-deployment-status
本例中的20.01 是截至到2020.03月的最新版本,也是我们本文开始手动升级到的最新版本。
正常情况下,Azure Sphere 设备每次开机后,都会自动检查更新,如果长时间为关机,设备也会24小时检查一次,如果有更新则会自动下载并安装,此过程可能15-20分钟,安装完成后,设备可能会重启。
六、启用设备上的应用开发
执行如下命令,启动设备上的应用开发
azsphere device enable-development
该过程会下载一些配置文件对开发板进行配置,然后在本机Windows系统上安装调试服务。
本系列其他内容:
- (视频)一起学Azure Sphere(1)- 什么是 Azure Sphere
- (视频)一起学Azure Sphere(2)- 准备 Azure Sphere开发环境并声明设备
- (视频)一起学Azure Sphere(3)- 本地开发调试高级程序,上传映像后云端部署到设备
- (视频)一起学Azure Sphere(4)- 将Azure Sphere 通过DPS注册到Azure IoT Hub并发送遥测消息
- (视频)一起学Azure Sphere(5)- 将Azure Sphere 预配到Azure China IoT Hub
- (视频)一起学Azure Sphere(6)- 30分钟内将Azure Sphere 连接到Azure IoT Central并展示基本图表