本文介绍在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
加速下载地址:
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
如下图表示正常运行了: