本文介绍在Windows 10 系统下,使用Azure IoT Hub C语言SDK的准备工作。

 

发工具准备:


1. Cmake 

官网下载地址:

https://github.com/Kitware/CMake/releases/download/v3.21.4/cmake-3.21.4-windows-x86_64.msi

加速下载地址:

https://yunjingsharestorage.blob.core.chinacloudapi.cn/devtools/0922/azure/cmake-3.21.4-windows-x86_64.msi

 

 2. Git

官网下载地址:

https://github.com/git-for-windows/git/releases/download/v2.33.1.windows.1/Git-2.33.1-64-bit.exe

加速下载地址:

https://yunjingsharestorage.blob.core.chinacloudapi.cn/devtools/0922/azure/Git-2.33.1-64-bit.exe

 

3. Visual Studio 2019 社区版或专业版(注意需要使用2019版本,其余版本不保证兼容性)

官网下载地址:

https://visualstudio.microsoft.com/zh-hans/vs/

 

 

开发工具安装:


1.Cmake安装的重点步骤:

双击如下图下载的安装程序。

同意许可协议

选择 为所有用户添加 PATH 环境变量

 

2. Git 安装请双击,全部保持默认下一步下一步即可。

 

3. Visual Studio 2019 安装:

可以下载社区版本,社区版本免费

 

双击安装包:

 

如下图 【1】处必须选中,选中后,右侧会自动添加C++相关的选项。

为了便于日后的课程,同时可以勾选【2处】。

 

 

C语言SDK常规用法


1.为了保持和视频一致,请使用指定的 Azure IoT C SDK:

其中 release-tag 为 版本号,
git clone -b <release-tag> https://github.com/Azure/azure-iot-sdk-c.git

本小节使用版本号 LTS_01_2021_Ref01:

git clone -b LTS_01_2021_Ref01 https://github.com/Azure/azure-iot-sdk-c.git

cd azure-iot-sdk-c

git submodule update --init

2.在根目录创建cmake子目录

mkdir cmake
cd cmake


3.生成适用于你开发平台的SDK版本并在CMAKE目录中生成模拟设备:

cmake ..


4.配置设备连接字符串:

在如下文件中找到【connectionString】字段,替换Azure Portal中的设备连接字符串
azure-iot-sdk-c\iothub_client\samples\iothub_convenience_sample\iothub_convenience_sample.c


5. 进入模拟设备的目录启动模拟设备,依次执行如下三行代码:

cd azure-iot-sdk-c/cmake/iothub_client/samples/iothub_convenience_sample
cmake --build . --target iothub_convenience_sample --config Debug
Debug\iothub_convenience_sample.exe

 

 

 

C语言SDK遇到各种错误的解决办法:


C语言SDK配置过程中,因为要使用git下载一些内容,鉴于网络状况,github下载过程中某些文件可能下载失败,导致C语言SDK会出现各种错误。

如果出现错误时,可严格按照如下方法使用我们已经为大家准备好的完整压缩包。

 

前置条件仍然是安装好 GIT,Cmake, Visual Studio 2019,请参考本文上半部分。

 

下载C语言完整版压缩包,国内加速下载地址:

https://yunjingsharestorage.blob.core.chinacloudapi.cn/devtools/0922/SDK/C/azure-iot-sdk-c.zip

将下载好的文件解压到D盘根目录,如下图所示:【需注意,本压缩包只能解压到D盘根目录,否则会出现路径引用无效等错误】

 

解压完成后是如下图所示的样子,【注意路径 D:\azure-iot-sdk-c】

 

进入D:\azure-iot-sdk-c\cmake,然后在命令行执行:

cmake ..

执行成功后,如下提示:

 

配置设备连接字符串:

在如下文件中找到【connectionString】字段,替换Azure Portal中的设备连接字符串
D:\azure-iot-sdk-c\iothub_client\samples\iothub_convenience_sample\iothub_convenience_sample.c

如下图:


5. 进入模拟设备的目录启动模拟设备,依次执行如下三行代码:

cd azure-iot-sdk-c/cmake/iothub_client/samples/iothub_convenience_sample
cmake --build . --target iothub_convenience_sample --config Debug
Debug\iothub_convenience_sample.exe

 

如下图表示正常运行了: