本节内容如下:

一、安装开发工具包(本文以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

具体参见微软官网:https://docs.microsoft.com/zh-cn/azure-sphere/install/development-environment-windows#use-vs-code-with-the-azure-sphere-sdk-for-windows

对于CMake的安装,直接下一步下一步就可以了:

 

对于Ninja,需要解压到某目录后,设置环境变量:

 

Azure Sphere 开发板支持两种应用程序:

1.高级应用程序

2.RTApp实时应用程序

实时应用程序主要利用MCU中的两个ARM Cortex-M4 处理器在实时操作系统上RTOS进行开发,本系列文章暂时不做该内容的介绍。

截至到此,我们已经配置完成了开发高级应用程序的环境,对于RTApp的开发环境配置,本文不再介绍,请参见官网:

https://docs.microsoft.com/zh-cn/azure-sphere/install/development-environment-windows#real-time-capable-application-development

 

四、声明 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系统上安装调试服务。

 

 

 

本系列其他内容:

  1. (视频)一起学Azure Sphere(1)- 什么是 Azure Sphere
  2. (视频)一起学Azure Sphere(2)- 准备 Azure Sphere开发环境并声明设备
  3. (视频)一起学Azure Sphere(3)- 本地开发调试高级程序,上传映像后云端部署到设备
  4. (视频)一起学Azure Sphere(4)- 将Azure Sphere 通过DPS注册到Azure IoT Hub并发送遥测消息
  5. (视频)一起学Azure Sphere(5)- 将Azure Sphere 预配到Azure China IoT Hub
  6. (视频)一起学Azure Sphere(6)- 30分钟内将Azure Sphere 连接到Azure IoT Central并展示基本图表