c语言 sdk,适用于 C 语言的 Azure IoT 设备 SDK
您現在訪問的是微軟AZURE全球版技術文檔網站，若需要訪問由世紀互聯運營的MICROSOFT AZURE中國區技術文檔網站，請訪問 https://docs.azure.cn.
適用于 C 的 Azure IoT 設備 SDK
05/17/2019
本文內容
Azure IoT 設備 SDK 是一個庫集，旨在簡化從 Azure IoT 中心 服務發送和接收消息的過程。 有各種不同的 SDK，每個 SDK 都以特定的平臺為目標，而本文說明的是 適用于 C 語言的 Azure IoT 設備 SDK。
備注
嵌入式 C SDK 是支持自帶網絡 (BYON) 方法的受限制設備的替代項。 IoT 開發人員可以自由選擇使用 MQTT 客戶端、TLS 和套接字來創建設備解決方案。 詳細了解嵌入式 C SDK。
備注
本文中提到的某些功能(例如云到設備消息傳遞、設備孿生、設備管理)僅在 IoT 中心的標準層中提供。 有關基本和標準 IoT 中心層的詳細信息，請參閱如何選擇合適的 IoT 中心層。
適用于 C 語言的 Azure IoT 設備 SDK 以 ANSI C (C99) 編寫，以獲得最大可移植性。 此功能使得這些庫很適合在多個平臺和設備上運行，尤其是在以將磁盤和內存占用量降到最低作為優先考慮的情況下。
SDK 已在許多平臺上進行了測試(有關詳細信息，請參閱 Azure IoT 認證設備目錄)。 盡管本文包含的是在 Windows 平臺上運行的示例代碼演示，但本文所述的代碼在各種支持的平臺上都完全相同。
下面的視頻概述了適用于 C 語言的 Azure IoT SDK：
本文介紹適用于 C 語言的 Azure IoT 設備 SDK 的體系結構，將演示如何初始化設備庫，將數據發送到 IoT 中心，以及從 IoT 中心接收消息。 本文中的信息應足以讓你開始使用 SDK，但同時也提供了有關庫的其他信息的鏈接。
SDK 體系結構
可在 GitHub 存儲庫中找到 適用于 C 語言的 Azure IoT 設備 SDK，還可在 C API 參考中查看 API 的詳細信息。
在此存儲庫的主分支中可找到最新版本的庫：
此 SDK 的核心實現可在 iothub_client 文件夾中找到，此文件夾包含 SDK 的最低 API 層的實現：IoTHubClient 庫。 此 IoTHubClient 庫包含實現原始消息傳送的 API，即將消息發送到 IoT 中心以及從 IoT 中心接收消息。 使用此庫時，需要負責實現消息序列化，但與 IoT 中心通信的其他細節則由系統處理。
serializer 文件夾包含幫助器函數和示例代碼，演示了使用客戶端庫向 Azure IoT 中心發送消息之前如何序列化數據。 使用序列化程序不是必需的，僅為了提供便利。 如果使用 序列化程序 庫，需要定義一個模型，用于指定要發送到 IoT 中心的數據以及預期要從 IoT 中心接收的消息。 定義模型后，SDK 將提供一個 API 圖面，讓你輕松處理設備到云和云到設備的消息，而無需擔心序列化細節。 此庫依賴于使用 MQTT 和 AMQP 等協議實現傳輸的其他開放源代碼庫。
IoTHubClient 庫依賴于其他開放源代碼庫：
Azure C 共享實用程序庫，其常用功能用于很多 Azure 相關的 C SDK 中所需的基本任務(如字符串、列表操作和 IO 等)。
Azure uAMQP 庫，此庫是針對資源約束設備的 AMQP 客戶端實現的優化。
Azure uMQTT 庫，它是實現 MQTT 協議并針對資源約束設備進行了優化的通用型庫。
查看示例代碼可以更方便地了解這些庫的用法。 以下部分演練 SDK 中包含的幾個示例應用程序。 此演練應可讓你輕松了解 SDK 體系結構層的各種功能以及 API 工作原理的簡介。
運行示例之前
在面向 C 的 Azure IoT 設備 SDK 中運行示例之前，必須在 Azure 訂閱中創建 IoT 中心服務的實例。 然后完成以下任務：
準備開發環境
獲取設備憑據。
準備開發環境
為常用平臺提供了包(例如適用于 Windows 的 NuGet 包或者適用于 Debian 和 Ubuntu 的 apt_get)，示例將使用這些包(如果適用)。 在某些情況下，需要為設備編譯 SDK，或者在設備上編譯 SDK。 如果需要編譯 SDK，請參閱 GitHub 存儲庫中的準備開發環境。
若要獲取示例應用程序代碼，請從 GitHub 下載 SDK 的副本。 從 GitHub 存儲庫的主分支獲取源的副本。
獲取設備憑據
獲取示例源代碼后，下一步是獲取一組設備憑據。 要使設備能夠訪問 IoT 中心，必須先將該設備添加到 IoT 中心標識注冊表。 添加設備時，需要獲取一組所需的設備憑據，以便設備能夠連接到 IoT 中心。 下一部分所述示例應用程序的預期憑據格式為 設備連接字符串。
有幾個開源工具可幫助你管理 IoT 中心。
一個是稱為 Azure IoT 資源管理器的 Windows 應用程序。
一個稱為 Azure IoT 工具的跨平臺 Visual Studio Code 擴展。
本教程使用圖形 設備資源管理器 工具。 如果在 VS Code 中進行開發，可以使用適用于 VS Code 的 Azure IoT 工具 。 如果喜歡使用 CLI 工具，也可以使用適用于 Azure CLI 2.0 的 IoT 擴展 工具。
設備資源管理器工具使用 Azure IoT 服務庫在 IoT 中心執行各種功能(包括添加設備)。 若使用設備資源管理器工具添加設備，會獲得設備的連接字符串。 需要此連接字符串才能運行示例應用程序。
如果不熟悉設備資源管理器工具，請參閱以下過程，了解如何使用該工具來添加設備和獲取設備連接字符串。
運行該程序時，可以看到以下界面：
在第一個字段中輸入用戶的 IoT 中心連接字符串，并單擊“更新”。 此步驟配置該工具，以便與 IoT 中心通信。
可以在“IoT 中心服務” > “設置” > “共享訪問策略” > “iothubowner”下找到 連接字符串。
配置 IoT 中心連接字符串后，請單擊“管理”選項卡：
可在此選項卡中管理已注冊到 IoT 中心的設備。
單擊“創建”按鈕創建設備。 會顯示一個已預先填充一組密鑰(主密鑰和輔助密鑰)的對話框。 輸入“設備 ID”，并單擊“創建”。
創建設備后，“設備”列表會更新，其中包含所有已注冊的設備(包括剛剛創建的設備)。 如果在新設備上單擊右鍵，會看到此菜單：
如果選擇“復制所選設備的連接字符串”，會將設備連接字符串復制到剪貼板。 請保留設備連接字符串的副本。 在運行后續部分中所述的示例應用程序時，將要用到它。
完成上述步驟后，可以開始運行一些代碼。 大多數示例的主源文件頂部都有一個常量，可讓你輸入連接字符串。 例如，iothub_client_samples_iothub_convenience_sample 應用程序中的相應行如下所示。
static const char* connectionString = "[device connection string]";
使用 IoTHubClient 庫
azure-iot-sdk-c 存儲庫的 iothub_client 文件夾中有一個 samples 文件夾，其中包含名為 iothub_client_sample_mqtt 的應用程序。
Windows 版本的 iothub_client_samples_iothub_convenience_sample 應用程序包含以下 Visual Studio 解決方案：
備注
如果 Visual Studio 要求你將項目重新定位到最新版本，請接受提示。
此解決方案只包含一個項目。 此解決方案中安裝了四個 NuGet 包：
Microsoft.Azure.C.SharedUtility
Microsoft.Azure.IoTHub.MqttTransport
Microsoft.Azure.IoTHub.IoTHubClient
Microsoft.Azure.umqtt
在使用 SDK 時始終需要 Microsoft.Azure.C.SharedUtility 包。 本示例使用 MQTT 協議，因此，必須包括 Microsoft.Azure.umqtt 和 Microsoft.Azure.IoTHub.MqttTransport 包(AMQP 和 HTTPS 有對應的包)。 由于此示例使用 IoTHubClient 庫，因此還必須在解決方案中包含 Microsoft.Azure.IoTHub.IoTHubClient 包。
可以在 iothub_client_samples_iothub_convenience_sample 源文件中找到示例應用程序的實現。
以下步驟使用此示例應用程序來演示使用 IoTHubClient 庫時所需的項目。
初始化庫
備注
在開始使用庫之前，可能需要執行一些特定于平臺的初始化。 例如，如果打算在 Linux 上使用 AMQP，則必須初始化 OpenSSL 庫。 GitHub 存儲庫中的示例在客戶端啟動時調用實用工具函數 platform_init，并在退出之前調用 platform_deinit 函數。 這些函數在 platform.h 標頭文件中聲明。 應該在存儲庫中為目標平臺檢查這些函數定義，以確定是否需要在客戶端中包含任何特定于平臺的初始化代碼。
只有在分配 IoT 中心客戶端句柄之后，才可以開始使用庫：
if ((iotHubClientHandle =
IoTHubClient_LL_CreateFromConnectionString(connectionString, MQTT_Protocol)) == NULL)
{
(void)printf("ERROR: iotHubClientHandle is NULL!\r\n");
}
else
{
...
將設備資源管理器工具獲取的設備連接字符串傳遞給此函數。 還需指定要使用的通信協議。 本示例使用 MQTT，但也可以選擇 AMQP 和 HTTPS。
獲取有效的 IOTHUB_CLIENT_HANDLE 后，可以開始調用 API 來與 IoT 中心相互發送和接收消息。
發送消息
示例應用程序將設置一個循環用于向 IoT 中心發送消息。 以下代碼片段：
創建消息。
將屬性添加到消息。
發送消息。
首先創建一條消息：
size_t iterator = 0;
do
{
if (iterator < MESSAGE_COUNT)
{
sprintf_s(msgText, sizeof(msgText), "{\"deviceId\":\"myFirstDevice\",\"windSpeed\":%.2f}", avgWindSpeed + (rand() % 4 + 2));
if ((messages[iterator].messageHandle = IoTHubMessage_CreateFromByteArray((const unsigned char*)msgText, strlen(msgText))) == NULL)
{
(void)printf("ERROR: iotHubMessageHandle is NULL!\r\n");
}
else
{
messages[iterator].messageTrackingId = iterator;
MAP_HANDLE propMap = IoTHubMessage_Properties(messages[iterator].messageHandle);
(void)sprintf_s(propText, sizeof(propText), "PropMsg_%zu", iterator);
if (Map_AddOrUpdate(propMap, "PropName", propText) != MAP_OK)
{
(void)printf("ERROR: Map_AddOrUpdate Failed!\r\n");
}
if (IoTHubClient_LL_SendEventAsync(iotHubClientHandle, messages[iterator].messageHandle, SendConfirmationCallback, &messages[iterator]) != IOTHUB_CLIENT_OK)
{
(void)printf("ERROR: IoTHubClient_LL_SendEventAsync..........FAILED!\r\n");
}
else
{
(void)printf("IoTHubClient_LL_SendEventAsync accepted message [%d] for transmission to IoT Hub.\r\n", (int)iterator);
}
}
}
IoTHubClient_LL_DoWork(iotHubClientHandle);
ThreadAPI_Sleep(1);
iterator++;
} while (g_continueRunning);
每次發送消息時，指定發送數據時所調用的回調函數的引用。 在此示例中，回調函數名為 SendConfirmationCallback。 以下代碼片段演示此回調函數：
static void SendConfirmationCallback(IOTHUB_CLIENT_CONFIRMATION_RESULT result, void* userContextCallback)
{
EVENT_INSTANCE* eventInstance = (EVENT_INSTANCE*)userContextCallback;
(void)printf("Confirmation[%d] received for message tracking id = %zu with result = %s\r\n", callbackCounter, eventInstance->messageTrackingId, MU_ENUM_TO_STRING(IOTHUB_CLIENT_CONFIRMATION_RESULT, result));
/* Some device specific action code goes here... */
callbackCounter++;
IoTHubMessage_Destroy(eventInstance->messageHandle);
}
處理完消息后，請注意對 IoTHubMessage_Destroy 函數的調用。 此函數釋放創建消息時分配的資源。
接收消息
接收消息是一個異步操作。 首先，請注冊當設備接收消息時所要調用的回調：
if (IoTHubClient_LL_SetMessageCallback(iotHubClientHandle, ReceiveMessageCallback, &receiveContext) != IOTHUB_CLIENT_OK)
{
(void)printf("ERROR: IoTHubClient_LL_SetMessageCallback..........FAILED!\r\n");
}
else
{
(void)printf("IoTHubClient_LL_SetMessageCallback...successful.\r\n");
...
最后一個參數是指向所需對象的 void 指針。 在本示例中，這是一個指向整數的指針，但也可以是指向更復雜數據結構的指針。 此參數使回調函數可與此函數的調用方以共享狀態運行。
當設備接收消息時，將調用注冊的回調函數。 此回調函數：
從消息中檢索消息 ID 和相關 ID。
檢索消息內容。
從消息中檢索任何自定義屬性。
static IOTHUBMESSAGE_DISPOSITION_RESULT ReceiveMessageCallback(IOTHUB_MESSAGE_HANDLE message, void* userContextCallback)
{
int* counter = (int*)userContextCallback;
const char* buffer;
size_t size;
MAP_HANDLE mapProperties;
const char* messageId;
const char* correlationId;
// Message properties
if ((messageId = IoTHubMessage_GetMessageId(message)) == NULL)
{
messageId = "";
}
if ((correlationId = IoTHubMessage_GetCorrelationId(message)) == NULL)
{
correlationId = "";
}
// Message content
if (IoTHubMessage_GetByteArray(message, (const unsigned char**)&buffer, &size) != IOTHUB_MESSAGE_OK)
{
(void)printf("unable to retrieve the message data\r\n");
}
else
{
(void)printf("Received Message [%d]\r\n Message ID: %s\r\n Correlation ID: %s\r\n Data: <<>> & Size=%d\r\n", *counter, messageId, correlationId, (int)size, buffer, (int)size);
// If we receive the work 'quit' then we stop running
if (size == (strlen("quit") * sizeof(char)) && memcmp(buffer, "quit", size) == 0)
{
g_continueRunning = false;
}
}
// Retrieve properties from the message
mapProperties = IoTHubMessage_Properties(message);
if (mapProperties != NULL)
{
const char*const* keys;
const char*const* values;
size_t propertyCount = 0;
if (Map_GetInternals(mapProperties, &keys, &values, &propertyCount) == MAP_OK)
{
if (propertyCount > 0)
{
size_t index;
printf(" Message Properties:\r\n");
for (index = 0; index < propertyCount; index++)
{
(void)printf("\tKey: %s Value: %s\r\n", keys[index], values[index]);
}
(void)printf("\r\n");
}
}
}
/* Some device specific action code goes here... */
(*counter)++;
return IOTHUBMESSAGE_ACCEPTED;
}
使用 IoTHubMessage_GetByteArray 函數來檢索消息(在本示例中是一個字符串)。
取消初始化庫
完成發送事件和接收消息后，可以取消初始化 IoT 庫。 為此，請發出以下函數調用：
IoTHubClient_LL_Destroy(iotHubClientHandle);
此調用釋放 IoTHubClient_CreateFromConnectionString 函數以前分配的資源。
可以看到，使用 IoTHubClient 庫可以輕松發送和接收消息。 該庫處理與 IoT 中心通信的詳細信息，包括要使用哪個協議(從開發人員的視角來看，這是一個簡單的配置選項)。
在如何對設備發送到 IoT 中心的數據進行序列化方面，IoTHubClient 庫也可提供精確的控制。 在某些情況下，這種控制級別是一項優點，但在其他情況下，這可能不是你想要看到的實現細節。 如果是這樣，可以考慮使用下一部分中介紹的 序列化程序 庫。
使用序列化程序庫
從概念上講，序列化程序 庫位于 SDK 中的 IoTHubClient 庫之上。 它使用 IoTHubClient 庫來與 IoT 中心進行底層通信，但它添加了建模功能，消除了開發人員處理消息序列化的負擔。 我們通過一個示例充分演示此庫的工作原理。
azure-iot-sdk-c 存儲庫的 serializer 文件夾中有一個 samples 文件夾，其中包含名為 simplesample_mqtt 的應用程序。 此示例的 Windows 版本包含以下 Visual Studio 解決方案：
備注
如果 Visual Studio 要求你將項目重新定位到最新版本，請接受提示。
如同前面的示例，此示例也包含多個 NuGet 包：
Microsoft.Azure.C.SharedUtility
Microsoft.Azure.IoTHub.MqttTransport
Microsoft.Azure.IoTHub.IoTHubClient
Microsoft.Azure.IoTHub.Serializer
Microsoft.Azure.umqtt
其中的大多數包已在前面的示例中出現過，但 Microsoft.Azure.IoTHub.Serializer 是新的。 使用 序列化程序 庫時需要此包。
可以在 iothub_client_samples_iothub_convenience_sample 文件中找到示例應用程序的實現。
以下部分演練本示例的重要組成部分。
初始化庫
若要開始使用 序列化程序 庫，請調用初始化 API：
if (serializer_init(NULL) != SERIALIZER_OK)
{
(void)printf("Failed on serializer_init\r\n");
}
else
{
IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle = IoTHubClient_LL_CreateFromConnectionString(connectionString, MQTT_Protocol);
srand((unsigned int)time(NULL));
int avgWindSpeed = 10;
if (iotHubClientHandle == NULL)
{
(void)printf("Failed on IoTHubClient_LL_Create\r\n");
}
else
{
ContosoAnemometer* myWeather = CREATE_MODEL_INSTANCE(WeatherStation, ContosoAnemometer);
if (myWeather == NULL)
{
(void)printf("Failed on CREATE_MODEL_INSTANCE\r\n");
}
else
{
...
對 serializer_init 函數進行的調用是一次性調用，用于初始化底層庫。 然后，需調用 IoTHubClient_LL_CreateFromConnectionString 函數，這是 IoTHubClient 示例中的同一 API。 此調用將設置設備連接字符串(也可用于選擇要使用的協議)。 本示例使用 MQTT 作為傳輸方式，但也可以使用 AMQP 或 HTTPS。
最后，調用 CREATE_MODEL_INSTANCE 函數。 WeatherStation 是模型的命名空間，ContosoAnemometer 是模型的名稱。 創建模型實例后，可以使用它來開始發送和接收消息。 但是，必須了解模型是什么。
定義模型
序列化程序 庫中的模型定義了設備可發送到 IoT 中心的消息以及可接收的消息(在建模語言中稱為 操作)。 如 iothub_client_samples_iothub_convenience_sample 示例應用程序中所示，你使用一組 C 宏定義了一個模塊：
BEGIN_NAMESPACE(WeatherStation);
DECLARE_MODEL(ContosoAnemometer,
WITH_DATA(ascii_char_ptr, DeviceId),
WITH_DATA(int, WindSpeed),
WITH_ACTION(TurnFanOn),
WITH_ACTION(TurnFanOff),
WITH_ACTION(SetAirResistance, int, Position)
);
END_NAMESPACE(WeatherStation);
BEGIN_NAMESPACE 和 END_NAMESPACE 這兩個宏都以模型的命名空間作為參數。 介于這兩個宏之間的內容應該就是模型的定義和模型使用的數據結構。
在本示例中，有一個名為 ContosoAnemometer 的模型。 此模型定義了設備可以發送到 IoT 中心的兩個數據片段：DeviceId 和 WindSpeed。 它還定義了設備可以接收的三個操作(消息)：TurnFanOn、TurnFanOff 和 SetAirResistance。 每個數據元素都有一個類型，而每個操作都有一個名稱(以及一組可選參數)。
模型中定義的數據和操作可定義 API 接口，此接口可用于將消息發送到 IoT 中心，以及響應發送到設備的消息。 最好通過示例了解此模型的用法。
發送消息
模型定義了可以發送到 IoT 中心的數據。 在本示例中，這是指使用 WITH_DATA 宏來定義的兩個數據項之一。 要將 DeviceId 和 WindSpeed 值發送到 IoT 中心，需要執行幾個步驟。 第一個步驟是設置要發送的數據：
myWeather->DeviceId = "myFirstDevice";
myWeather->WindSpeed = avgWindSpeed + (rand() % 4 + 2);
使用前面定義的模型可以通過設置 struct 的成員來設置值。 接下來，序列化想要發送的消息：
unsigned char* destination;
size_t destinationSize;
if (SERIALIZE(&destination, &destinationSize, myWeather->DeviceId, myWeather->WindSpeed) != CODEFIRST_OK)
{
(void)printf("Failed to serialize\r\n");
}
else
{
sendMessage(iotHubClientHandle, destination, destinationSize);
free(destination);
}
此代碼將設備到云的消息序列化到緩沖區(由 destination 引用)。 然后，代碼調用 sendMessage 函數將消息發送到 IoT 中心：
static void sendMessage(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, const unsigned char* buffer, size_t size)
{
static unsigned int messageTrackingId;
IOTHUB_MESSAGE_HANDLE messageHandle = IoTHubMessage_CreateFromByteArray(buffer, size);
if (messageHandle == NULL)
{
printf("unable to create a new IoTHubMessage\r\n");
}
else
{
if (IoTHubClient_LL_SendEventAsync(iotHubClientHandle, messageHandle, sendCallback, (void*)(uintptr_t)messageTrackingId) != IOTHUB_CLIENT_OK)
{
printf("failed to hand over the message to IoTHubClient");
}
else
{
printf("IoTHubClient accepted the message for delivery\r\n");
}
IoTHubMessage_Destroy(messageHandle);
}
messageTrackingId++;
}
IoTHubClient_LL_SendEventAsync 的倒數第二個參數是對成功發送數據后所調用的回調函數的引用。 下面是本示例中的回調函數：
void sendCallback(IOTHUB_CLIENT_CONFIRMATION_RESULT result, void* userContextCallback)
{
unsigned int messageTrackingId = (unsigned int)(uintptr_t)userContextCallback;
(void)printf("Message Id: %u Received.\r\n", messageTrackingId);
(void)printf("Result Call Back Called! Result is: %s \r\n", MU_ENUM_TO_STRING(IOTHUB_CLIENT_CONFIRMATION_RESULT, result));
}
第二個參數是指向用戶上下文的指針，即傳遞給 IoTHubClient_LL_SendEventAsync 的同一個指針。 在本例中，該上下文是一個簡易計數器，但也可以是所需的任何組件。
這就是發送設備到云的消息所要執行的所有操作。 最后要介紹的內容是如何接收消息。
接收消息
接收消息的方式類似于在 IoTHubClient 庫中處理消息。 首先，需要注冊消息回調函數：
if (IoTHubClient_LL_SetMessageCallback(iotHubClientHandle,
IoTHubMessage, myWeather) != IOTHUB_CLIENT_OK)
{
printf("unable to IoTHubClient_SetMessageCallback\r\n");
}
else
{
...
然后編寫在接收消息時要調用的回調函數：
static IOTHUBMESSAGE_DISPOSITION_RESULT IoTHubMessage(IOTHUB_MESSAGE_HANDLE message, void* userContextCallback)
{
IOTHUBMESSAGE_DISPOSITION_RESULT result;
const unsigned char* buffer;
size_t size;
if (IoTHubMessage_GetByteArray(message, &buffer, &size) != IOTHUB_MESSAGE_OK)
{
printf("unable to IoTHubMessage_GetByteArray\r\n");
result = IOTHUBMESSAGE_ABANDONED;
}
else
{
/*buffer is not zero terminated*/
char* temp = malloc(size + 1);
if (temp == NULL)
{
printf("failed to malloc\r\n");
result = IOTHUBMESSAGE_ABANDONED;
}
else
{
(void)memcpy(temp, buffer, size);
temp[size] = '\0';
EXECUTE_COMMAND_RESULT executeCommandResult = EXECUTE_COMMAND(userContextCallback, temp);
result =
(executeCommandResult == EXECUTE_COMMAND_ERROR) ? IOTHUBMESSAGE_ABANDONED :
(executeCommandResult == EXECUTE_COMMAND_SUCCESS) ? IOTHUBMESSAGE_ACCEPTED :
IOTHUBMESSAGE_REJECTED;
free(temp);
}
}
return result;
}
此代碼是一個樣板 - 對任何解決方案都是相同的。 此函數將接收消息并通過調用 EXECUTE_COMMAND 將它路由到相應的函數。 此時調用的函數取決于模型中的操作定義。
在模型中定義操作時，需要實現當設備接收相應的消息時調用的函數。 例如，如果模型定義了此操作：
WITH_ACTION(SetAirResistance, int, Position)
使用此簽名定義函數：
EXECUTE_COMMAND_RESULT SetAirResistance(ContosoAnemometer* device, int Position)
{
(void)device;
(void)printf("Setting Air Resistance Position to %d.\r\n", Position);
return EXECUTE_COMMAND_SUCCESS;
}
請注意，函數的名稱與模型中的操作名稱匹配，而函數的參數與為該操作指定的參數匹配。 第一個參數始終是必需的，包含指向模型實例的指針。
當設備收到與此簽名匹配的消息時，會調用相應的函數。 因此，除了必須包含 IoTHubMessage 中的樣板代碼以外，接收消息所涉及的操作只是為模型中定義的每個操作定義一個簡單的函數。
取消初始化庫
完成發送數據和接收消息后，可以取消初始化 IoT 庫。
...
DESTROY_MODEL_INSTANCE(myWeather);
}
IoTHubClient_LL_Destroy(iotHubClientHandle);
}
serializer_deinit();
上述 3 個函數均符合以前所述的 3 個初始化函數。 調用這些 API 可確保釋放以前分配的資源。
后續步驟
本文介紹了有關使用 適用于 C 語言的 Azure IoT 設備 SDK 中的庫的基本知識。其中針對 SDK 中包含的組件及其體系結構，以及如何開始使用 Windows 示例等進行了詳細說明。 下一篇文章通過講解有關 IoTHubClient 庫的詳細信息來繼續介紹該 SDK。
若要詳細了解如何針對 IoT 中心進行開發，請參閱 Azure IoT SDK。
若要進一步探索 IoT 中心的功能，請參閱：
總結
以上是生活随笔為你收集整理的c语言 sdk,适用于 C 语言的 Azure IoT 设备 SDK的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： linux whois rpm,Cent
- 下一篇： C语言指令启动mcs51计时器是,嵌入式