前言
本用户手册介绍了STM32Cube的STM32 Microsoft® Azure IoT（物联网）云软件扩展包的内容。
' y+ ~$ L9 s5 J0 |4 |5 NMicrosoft® Azure是由Microsoft®创建的云计算服务，通过Microsoft®全球网络管理数据中心来构建、测试、部署和管理应用和服务。它提供软件即服务（SaaS）、平台即服务（PaaS）和基础架构即服务（IaaS），并支持许多不同的编程语言、工具和框架，包括Microsoft®特定的和第三方的软件和系统。
9 E9 i0 v% i; L7 z. q3 oSTM32Cube（X-CUBE-AZURE）的Microsoft® Azure IoT软件扩展包提供了将STMicroelectronics板连接到Azure IoT Hub的应用示例。
" {  A$ @9 E: {X-CUBE-AZURE可运行于B-L475E-IOT01、32F413HDISCOVERY和32F769IDISCOVERY板。
! t/ J4 w) |; Q9 ~& g0 a实现示例包括设备到云遥测报告和云到设备消息，可向所连接的设备发送命令和通知。还实现了具有应答确认的消息传送跟踪。
X-CUBE-AZURE具有以下特性：
• 已准备好运行固件示例，使用WiFi®和以太网连接来支持Azure设备应用的快速评估和开发
4 Z  a; h  P$ L• 具有配置板子连接到Azure IoT Hub的接口
• 连接到Azure IoT Hub和各种回调注册
  ?! P' @5 W9 {. B• Azure IoT Hub，实现了双向通信示例
• B-L475E-IOT01板可测量和报告以下值：
– 湿度
– 温度
– 3D地磁数据
! ?# a: K) O' U5 }% x% S" _; }– 3D加速度
( I3 t1 W* a0 _  A/ l– 3D陀螺仪数据
– 大气压力
– 接近

; Y# A; |2 U! l# ]: d+ X9 @
" w  P3 r8 H) n0 C. f# w0 C9 ]1 缩略语
/ @  J4 J4 s2 a- r  L% q表 1给出了相关的缩略语定义，帮助您更好地理解本文档。
2 ?/ V1 ^- b. {3 U6 x
4 |- w& E9 w* @! w7 \


' L2 W1 u; [+ [# |2 Azure IoT Hub
本节介绍Azure IoT Hub服务。
- v5 y6 i% B" ~9 w2 iX-CUBE-AZURE包实现了使用C语言的Azure IoT设备SDK，可支持该板安全地连接到Azure IoT Hub服务。
( B" T# ]* u+ P( t, [用户可以使用智能手机或个人计算机连接到云端，并可以随时随地访问该板提供的信息。
2 \8 Q0 D$ Q* n图 1显示面向X-CUBE-AZURE包的Azure IoT生态系统。X-CUBE-AZURE包采用MQTT协议实现物与Azure IoT Hub服务的连接。应用/浏览器和其他物协议在图 1中仅显示了其作为现有Azure功能的信息。
' {+ ]% x- e7 y6 P



$ U" x( e. _8 E, t
除了丰富的设备到云（D2C）和云到设备（C2D）通信选项（包括消息、文件传输和请求- 回复方法）之外，Azure IoT Hub还通过以下方式实现设备连接：
: [: [& i1 M( K) U: r• 设备孪生。使用设备孪生，用户可以存储、同步和查询设备元数据和状态信息。设备孪生是存储设备状态信息（元数据、配置和条件）的JSON文档。对于连接到IoT Hub的每个设备，IoT Hub都会保持其设备孪生。
• 每个设备的认证和安全连接。用户可以为每个设备提供自己的安全密钥，使其能够连接到IoT Hub。IoT Hub身份注册表将设备身份和密钥存储在解决方案中。解决方案后端可以将个人设备添加到允许/拒绝列表，以实现对设备访问的完全控制。
• 基于声明规则，将设备到云消息路由到Azure服务。IoT Hub允许用户根据路由规则定义消息路由，以控制中心发送设备到云消息的位置。路由规则不需要用户编写任何代码，并可以取代自定义后置消息调度程序。
• 监控设备连接操作。用户可以收到有关设备身份管理操作和设备连接事件的详细操作日志。这种监控功能使其IoT解决方案能够识别连接问题，例如尝试连接证书错误的设备，太频繁地发送消息或拒绝所有云到设备消息。
• 大量的设备库Azure IoT设备SDK可用于并支持多种语言和平台：C语言可适用于多种Linux®发行版本、Windows®和实时操作系统。Azure IoT设备SDK还支持管理诸如C＃、Java和JavaScript等语言。
• IoT协议和可扩展性。如果某解决方案无法使用设备库，则IoT Hub会公开一种公共协议，使设备本身能够使用MQTTv3.1.1、HTTP 1.1或AMQP 1.0协议。用户还可以通过以下方式扩展IoT Hub以支持自定义协议：
$ r" H7 A/ k' s* B0 Y– 使用AzureIoT Edge创建现场网关，将自定义协议转换为IoT Hub可理解的三种协议之一。
– 自定义Azure IoT协议网关，即在云中运行的开源组件。
" I# q) N- i- r  r& S• 扩展。Azure IoT Hub可扩展到数百万个同时连接的设备和每秒数百万的事件。
$ {3 H0 x$ j) J6 G7 }8 Z1 T有关Microsoft® Azure和Azure IoT Hub的完整说明，请参考Azure IoT Hub服务网页概述中提供的信息。
! l1 a! r. \: d/ u% t$ u

完整版请查看：附件
4 j, h8 F2 q7 y- K- M