Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
serializer/src/iotdevice.c@0:f7f1f0d76dd6, 2018-08-23 (annotated)
- Committer:
- XinZhangMS
- Date:
- Thu Aug 23 06:52:14 2018 +0000
- Revision:
- 0:f7f1f0d76dd6
azure-c-sdk for mbed os supporting NUCLEO_F767ZI
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| XinZhangMS | 0:f7f1f0d76dd6 | 1 | // Copyright (c) Microsoft. All rights reserved. |
| XinZhangMS | 0:f7f1f0d76dd6 | 2 | // Licensed under the MIT license. See LICENSE file in the project root for full license information. |
| XinZhangMS | 0:f7f1f0d76dd6 | 3 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 4 | #include <stdlib.h> |
| XinZhangMS | 0:f7f1f0d76dd6 | 5 | #include "azure_c_shared_utility/gballoc.h" |
| XinZhangMS | 0:f7f1f0d76dd6 | 6 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 7 | #include <stdbool.h> |
| XinZhangMS | 0:f7f1f0d76dd6 | 8 | #include "iotdevice.h" |
| XinZhangMS | 0:f7f1f0d76dd6 | 9 | #include "datapublisher.h" |
| XinZhangMS | 0:f7f1f0d76dd6 | 10 | #include "commanddecoder.h" |
| XinZhangMS | 0:f7f1f0d76dd6 | 11 | #include "azure_c_shared_utility/crt_abstractions.h" |
| XinZhangMS | 0:f7f1f0d76dd6 | 12 | #include "azure_c_shared_utility/xlogging.h" |
| XinZhangMS | 0:f7f1f0d76dd6 | 13 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 14 | #define LOG_DEVICE_ERROR \ |
| XinZhangMS | 0:f7f1f0d76dd6 | 15 | LogError("(result = %s)", ENUM_TO_STRING(DEVICE_RESULT, result)) |
| XinZhangMS | 0:f7f1f0d76dd6 | 16 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 17 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 18 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 19 | typedef struct DEVICE_HANDLE_DATA_TAG |
| XinZhangMS | 0:f7f1f0d76dd6 | 20 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 21 | SCHEMA_MODEL_TYPE_HANDLE model; |
| XinZhangMS | 0:f7f1f0d76dd6 | 22 | DATA_PUBLISHER_HANDLE dataPublisherHandle; |
| XinZhangMS | 0:f7f1f0d76dd6 | 23 | pfDeviceActionCallback deviceActionCallback; |
| XinZhangMS | 0:f7f1f0d76dd6 | 24 | void* callbackUserContext; |
| XinZhangMS | 0:f7f1f0d76dd6 | 25 | pfDeviceMethodCallback deviceMethodCallback; |
| XinZhangMS | 0:f7f1f0d76dd6 | 26 | void* methodCallbackUserContext; |
| XinZhangMS | 0:f7f1f0d76dd6 | 27 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 28 | COMMAND_DECODER_HANDLE commandDecoderHandle; |
| XinZhangMS | 0:f7f1f0d76dd6 | 29 | } DEVICE_HANDLE_DATA; |
| XinZhangMS | 0:f7f1f0d76dd6 | 30 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 31 | DEFINE_ENUM_STRINGS(DEVICE_RESULT, DEVICE_RESULT_VALUES); |
| XinZhangMS | 0:f7f1f0d76dd6 | 32 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 33 | static EXECUTE_COMMAND_RESULT DeviceInvokeAction(void* actionCallbackContext, const char* relativeActionPath, const char* actionName, size_t argCount, const AGENT_DATA_TYPE* args) |
| XinZhangMS | 0:f7f1f0d76dd6 | 34 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 35 | EXECUTE_COMMAND_RESULT result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 36 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 37 | /*Codes_SRS_DEVICE_02_011: [If the parameter actionCallbackContent passed the callback is NULL then the callback shall return EXECUTE_COMMAND_ERROR.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 38 | if (actionCallbackContext == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 39 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 40 | result = EXECUTE_COMMAND_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 41 | LogError("(Error code = %s)", ENUM_TO_STRING(DEVICE_RESULT, DEVICE_INVALID_ARG)); |
| XinZhangMS | 0:f7f1f0d76dd6 | 42 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 43 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 44 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 45 | DEVICE_HANDLE_DATA* device = (DEVICE_HANDLE_DATA*)actionCallbackContext; |
| XinZhangMS | 0:f7f1f0d76dd6 | 46 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 47 | /* Codes_SRS_DEVICE_01_052: [When the action callback passed to CommandDecoder is called, Device shall call the appropriate user callback associated with the device handle.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 48 | /* Codes_SRS_DEVICE_01_055: [The value passed in callbackUserContext when creating the device shall be passed to the callback as the value for the callbackUserContext argument.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 49 | result = device->deviceActionCallback((DEVICE_HANDLE)device, device->callbackUserContext, relativeActionPath, actionName, argCount, args); |
| XinZhangMS | 0:f7f1f0d76dd6 | 50 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 51 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 52 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 53 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 54 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 55 | static METHODRETURN_HANDLE DeviceInvokeMethod(void* methodCallbackContext, const char* relativeMethodPath, const char* methodName, size_t argCount, const AGENT_DATA_TYPE* args) |
| XinZhangMS | 0:f7f1f0d76dd6 | 56 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 57 | METHODRETURN_HANDLE result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 58 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 59 | if (methodCallbackContext == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 60 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 61 | result = NULL; |
| XinZhangMS | 0:f7f1f0d76dd6 | 62 | LogError("(Error code = %s)", ENUM_TO_STRING(DEVICE_RESULT, DEVICE_INVALID_ARG)); |
| XinZhangMS | 0:f7f1f0d76dd6 | 63 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 64 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 65 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 66 | DEVICE_HANDLE_DATA* device = (DEVICE_HANDLE_DATA*)methodCallbackContext; |
| XinZhangMS | 0:f7f1f0d76dd6 | 67 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 68 | result = device->deviceMethodCallback((DEVICE_HANDLE)device, device->methodCallbackUserContext, relativeMethodPath, methodName, argCount, args); |
| XinZhangMS | 0:f7f1f0d76dd6 | 69 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 70 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 71 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 72 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 73 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 74 | DEVICE_RESULT Device_Create(SCHEMA_MODEL_TYPE_HANDLE modelHandle, pfDeviceActionCallback deviceActionCallback, void* callbackUserContext, pfDeviceMethodCallback methodCallback, void* methodCallbackContext, bool includePropertyPath, DEVICE_HANDLE* deviceHandle) |
| XinZhangMS | 0:f7f1f0d76dd6 | 75 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 76 | DEVICE_RESULT result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 77 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 78 | /* Codes_SRS_DEVICE_05_014: [If any of the modelHandle, deviceHandle or deviceActionCallback arguments are NULL, Device_Create shall return DEVICE_INVALID_ARG.]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 79 | if (modelHandle == NULL || deviceHandle == NULL || deviceActionCallback == NULL || methodCallback == NULL || methodCallbackContext == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 80 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 81 | result = DEVICE_INVALID_ARG; |
| XinZhangMS | 0:f7f1f0d76dd6 | 82 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 83 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 84 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 85 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 86 | DEVICE_HANDLE_DATA* device = (DEVICE_HANDLE_DATA*)malloc(sizeof(DEVICE_HANDLE_DATA)); |
| XinZhangMS | 0:f7f1f0d76dd6 | 87 | if (device == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 88 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 89 | /* Codes_SRS_DEVICE_05_015: [If an error occurs while trying to create the device, Device_Create shall return DEVICE_ERROR.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 90 | result = DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 91 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 92 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 93 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 94 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 95 | /* Codes_SRS_DEVICE_01_018: [Device_Create shall create a DataPublisher instance by calling DataPublisher_Create.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 96 | /* Codes_SRS_DEVICE_01_020: [Device_Create shall pass to DataPublisher_Create the FrontDoor instance obtained earlier.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 97 | /* Codes_SRS_DEVICE_01_004: [DeviceCreate shall pass to DataPublisher_create the includePropertyPath argument.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 98 | if ((device->dataPublisherHandle = DataPublisher_Create(modelHandle, includePropertyPath)) == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 99 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 100 | free(device); |
| XinZhangMS | 0:f7f1f0d76dd6 | 101 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 102 | /* Codes_SRS_DEVICE_01_019: [If creating the DataPublisher instance fails, Device_Create shall return DEVICE_DATA_PUBLISHER_FAILED.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 103 | result = DEVICE_DATA_PUBLISHER_FAILED; |
| XinZhangMS | 0:f7f1f0d76dd6 | 104 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 105 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 106 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 107 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 108 | device->model = modelHandle; |
| XinZhangMS | 0:f7f1f0d76dd6 | 109 | device->deviceActionCallback = deviceActionCallback; |
| XinZhangMS | 0:f7f1f0d76dd6 | 110 | device->callbackUserContext = callbackUserContext; |
| XinZhangMS | 0:f7f1f0d76dd6 | 111 | device->deviceMethodCallback = methodCallback; |
| XinZhangMS | 0:f7f1f0d76dd6 | 112 | device->methodCallbackUserContext = methodCallbackContext; |
| XinZhangMS | 0:f7f1f0d76dd6 | 113 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 114 | /* Codes_SRS_DEVICE_01_001: [Device_Create shall create a CommandDecoder instance by calling CommandDecoder_Create and passing to it the model handle.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 115 | /* Codes_SRS_DEVICE_01_002: [Device_Create shall also pass to CommandDecoder_Create a callback to be invoked when a command is received and a context that shall be the device handle.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 116 | if ((device->commandDecoderHandle = CommandDecoder_Create(modelHandle, DeviceInvokeAction, device, DeviceInvokeMethod, device)) == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 117 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 118 | DataPublisher_Destroy(device->dataPublisherHandle); |
| XinZhangMS | 0:f7f1f0d76dd6 | 119 | free(device); |
| XinZhangMS | 0:f7f1f0d76dd6 | 120 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 121 | /* Codes_SRS_DEVICE_01_003: [If CommandDecoder_Create fails, Device_Create shall return DEVICE_COMMAND_DECODER_FAILED.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 122 | result = DEVICE_COMMAND_DECODER_FAILED; |
| XinZhangMS | 0:f7f1f0d76dd6 | 123 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 124 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 125 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 126 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 127 | /* Codes_SRS_DEVICE_03_003: [The DEVICE_HANDLE shall be provided via the deviceHandle out argument.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 128 | *deviceHandle = (DEVICE_HANDLE)device; |
| XinZhangMS | 0:f7f1f0d76dd6 | 129 | /* Codes_SRS_DEVICE_03_004: [Device_Create shall return DEVICE_OK upon success.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 130 | result = DEVICE_OK; |
| XinZhangMS | 0:f7f1f0d76dd6 | 131 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 132 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 133 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 134 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 135 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 136 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 137 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 138 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 139 | /* Codes_SRS_DEVICE_03_006: [Device_Destroy shall free all resources associated with a device.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 140 | void Device_Destroy(DEVICE_HANDLE deviceHandle) |
| XinZhangMS | 0:f7f1f0d76dd6 | 141 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 142 | /* Codes_SRS_DEVICE_03_007: [Device_Destroy will not do anything if deviceHandle is NULL.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 143 | if (deviceHandle != NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 144 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 145 | DEVICE_HANDLE_DATA* device = (DEVICE_HANDLE_DATA*)deviceHandle; |
| XinZhangMS | 0:f7f1f0d76dd6 | 146 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 147 | DataPublisher_Destroy(device->dataPublisherHandle); |
| XinZhangMS | 0:f7f1f0d76dd6 | 148 | CommandDecoder_Destroy(device->commandDecoderHandle); |
| XinZhangMS | 0:f7f1f0d76dd6 | 149 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 150 | free(device); |
| XinZhangMS | 0:f7f1f0d76dd6 | 151 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 152 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 153 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 154 | TRANSACTION_HANDLE Device_StartTransaction(DEVICE_HANDLE deviceHandle) |
| XinZhangMS | 0:f7f1f0d76dd6 | 155 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 156 | TRANSACTION_HANDLE result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 157 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 158 | /* Codes_SRS_DEVICE_01_035: [If any argument is NULL, Device_StartTransaction shall return NULL.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 159 | if (deviceHandle == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 160 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 161 | result = NULL; |
| XinZhangMS | 0:f7f1f0d76dd6 | 162 | LogError("(Error code = %s)", ENUM_TO_STRING(DEVICE_RESULT, DEVICE_INVALID_ARG)); |
| XinZhangMS | 0:f7f1f0d76dd6 | 163 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 164 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 165 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 166 | DEVICE_HANDLE_DATA* deviceInstance = (DEVICE_HANDLE_DATA*)deviceHandle; |
| XinZhangMS | 0:f7f1f0d76dd6 | 167 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 168 | /* Codes_SRS_DEVICE_01_034: [Device_StartTransaction shall invoke DataPublisher_StartTransaction for the DataPublisher handle associated with the deviceHandle argument.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 169 | /* Codes_SRS_DEVICE_01_043: [On success, Device_StartTransaction shall return a non NULL handle.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 170 | /* Codes_SRS_DEVICE_01_048: [When DataPublisher_StartTransaction fails, Device_StartTransaction shall return NULL.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 171 | result = DataPublisher_StartTransaction(deviceInstance->dataPublisherHandle); |
| XinZhangMS | 0:f7f1f0d76dd6 | 172 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 173 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 174 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 175 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 176 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 177 | DEVICE_RESULT Device_PublishTransacted(TRANSACTION_HANDLE transactionHandle, const char* propertyPath, const AGENT_DATA_TYPE* data) |
| XinZhangMS | 0:f7f1f0d76dd6 | 178 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 179 | DEVICE_RESULT result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 180 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 181 | /* Codes_SRS_DEVICE_01_037: [If any argument is NULL, Device_PublishTransacted shall return DEVICE_INVALID_ARG.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 182 | if ( |
| XinZhangMS | 0:f7f1f0d76dd6 | 183 | (transactionHandle == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 184 | (propertyPath == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 185 | (data == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 186 | ) |
| XinZhangMS | 0:f7f1f0d76dd6 | 187 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 188 | result = DEVICE_INVALID_ARG; |
| XinZhangMS | 0:f7f1f0d76dd6 | 189 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 190 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 191 | /* Codes_SRS_DEVICE_01_036: [Device_PublishTransacted shall invoke DataPublisher_PublishTransacted.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 192 | else if (DataPublisher_PublishTransacted(transactionHandle, propertyPath, data) != DATA_PUBLISHER_OK) |
| XinZhangMS | 0:f7f1f0d76dd6 | 193 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 194 | /* Codes_SRS_DEVICE_01_049: [When DataPublisher_PublishTransacted fails, Device_PublishTransacted shall return DEVICE_DATA_PUBLISHER_FAILED.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 195 | result = DEVICE_DATA_PUBLISHER_FAILED; |
| XinZhangMS | 0:f7f1f0d76dd6 | 196 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 197 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 198 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 199 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 200 | /* Codes_SRS_DEVICE_01_044: [On success, Device_PublishTransacted shall return DEVICE_OK.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 201 | result = DEVICE_OK; |
| XinZhangMS | 0:f7f1f0d76dd6 | 202 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 203 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 204 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 205 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 206 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 207 | DEVICE_RESULT Device_EndTransaction(TRANSACTION_HANDLE transactionHandle, unsigned char** destination, size_t* destinationSize) |
| XinZhangMS | 0:f7f1f0d76dd6 | 208 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 209 | DEVICE_RESULT result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 210 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 211 | /* Codes_SRS_DEVICE_01_039: [If any parameter is NULL, Device_EndTransaction shall return DEVICE_INVALID_ARG.]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 212 | if ( |
| XinZhangMS | 0:f7f1f0d76dd6 | 213 | (transactionHandle == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 214 | (destination == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 215 | (destinationSize == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 216 | ) |
| XinZhangMS | 0:f7f1f0d76dd6 | 217 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 218 | result = DEVICE_INVALID_ARG; |
| XinZhangMS | 0:f7f1f0d76dd6 | 219 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 220 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 221 | /* Codes_SRS_DEVICE_01_038: [Device_EndTransaction shall invoke DataPublisher_EndTransaction.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 222 | else if (DataPublisher_EndTransaction(transactionHandle, destination, destinationSize) != DATA_PUBLISHER_OK) |
| XinZhangMS | 0:f7f1f0d76dd6 | 223 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 224 | /* Codes_SRS_DEVICE_01_050: [When DataPublisher_EndTransaction fails, Device_EndTransaction shall return DEVICE_DATA_PUBLISHER_FAILED.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 225 | result = DEVICE_DATA_PUBLISHER_FAILED; |
| XinZhangMS | 0:f7f1f0d76dd6 | 226 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 227 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 228 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 229 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 230 | /* Codes_SRS_DEVICE_01_045: [On success, Device_EndTransaction shall return DEVICE_OK.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 231 | result = DEVICE_OK; |
| XinZhangMS | 0:f7f1f0d76dd6 | 232 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 233 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 234 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 235 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 236 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 237 | DEVICE_RESULT Device_CancelTransaction(TRANSACTION_HANDLE transactionHandle) |
| XinZhangMS | 0:f7f1f0d76dd6 | 238 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 239 | DEVICE_RESULT result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 240 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 241 | /* Codes_SRS_DEVICE_01_041: [If any argument is NULL, Device_CancelTransaction shall return DEVICE_INVALID_ARG.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 242 | if (transactionHandle == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 243 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 244 | result = DEVICE_INVALID_ARG; |
| XinZhangMS | 0:f7f1f0d76dd6 | 245 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 246 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 247 | /* Codes_SRS_DEVICE_01_040: [Device_CancelTransaction shall invoke DataPublisher_CancelTransaction.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 248 | else if (DataPublisher_CancelTransaction(transactionHandle) != DATA_PUBLISHER_OK) |
| XinZhangMS | 0:f7f1f0d76dd6 | 249 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 250 | /* Codes_SRS_DEVICE_01_051: [When DataPublisher_CancelTransaction fails, Device_CancelTransaction shall return DEVICE_DATA_PUBLISHER_FAILED.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 251 | result = DEVICE_DATA_PUBLISHER_FAILED; |
| XinZhangMS | 0:f7f1f0d76dd6 | 252 | LOG_DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 253 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 254 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 255 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 256 | /* Codes_SRS_DEVICE_01_046: [On success, Device_PublishTransacted shall return DEVICE_OK.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 257 | result = DEVICE_OK; |
| XinZhangMS | 0:f7f1f0d76dd6 | 258 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 259 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 260 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 261 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 262 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 263 | EXECUTE_COMMAND_RESULT Device_ExecuteCommand(DEVICE_HANDLE deviceHandle, const char* command) |
| XinZhangMS | 0:f7f1f0d76dd6 | 264 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 265 | EXECUTE_COMMAND_RESULT result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 266 | /*Codes_SRS_DEVICE_02_012: [If any parameters are NULL, then Device_ExecuteCommand shall return EXECUTE_COMMAND_ERROR.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 267 | if ( |
| XinZhangMS | 0:f7f1f0d76dd6 | 268 | (deviceHandle == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 269 | (command == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 270 | ) |
| XinZhangMS | 0:f7f1f0d76dd6 | 271 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 272 | result = EXECUTE_COMMAND_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 273 | LogError("invalid parameter (NULL passed to Device_ExecuteCommand DEVICE_HANDLE deviceHandle=%p, const char* command=%p", deviceHandle, command); |
| XinZhangMS | 0:f7f1f0d76dd6 | 274 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 275 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 276 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 277 | /*Codes_SRS_DEVICE_02_013: [Otherwise, Device_ExecuteCommand shall call CommandDecoder_ExecuteCommand and return what CommandDecoder_ExecuteCommand is returning.] */ |
| XinZhangMS | 0:f7f1f0d76dd6 | 278 | DEVICE_HANDLE_DATA* device = (DEVICE_HANDLE_DATA*)deviceHandle; |
| XinZhangMS | 0:f7f1f0d76dd6 | 279 | result = CommandDecoder_ExecuteCommand(device->commandDecoderHandle, command); |
| XinZhangMS | 0:f7f1f0d76dd6 | 280 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 281 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 282 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 283 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 284 | METHODRETURN_HANDLE Device_ExecuteMethod(DEVICE_HANDLE deviceHandle, const char* methodName, const char* methodPayload) |
| XinZhangMS | 0:f7f1f0d76dd6 | 285 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 286 | METHODRETURN_HANDLE result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 287 | if ( |
| XinZhangMS | 0:f7f1f0d76dd6 | 288 | (deviceHandle == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 289 | (methodName == NULL) /*methodPayload can be NULL*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 290 | ) |
| XinZhangMS | 0:f7f1f0d76dd6 | 291 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 292 | result = NULL; |
| XinZhangMS | 0:f7f1f0d76dd6 | 293 | LogError("invalid parameter (NULL passed to Device_ExecuteMethod DEVICE_HANDLE deviceHandle=%p, const char* methodPayload=%p", deviceHandle, methodPayload); |
| XinZhangMS | 0:f7f1f0d76dd6 | 294 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 295 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 296 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 297 | DEVICE_HANDLE_DATA* device = (DEVICE_HANDLE_DATA*)deviceHandle; |
| XinZhangMS | 0:f7f1f0d76dd6 | 298 | result = CommandDecoder_ExecuteMethod(device->commandDecoderHandle, methodName, methodPayload); |
| XinZhangMS | 0:f7f1f0d76dd6 | 299 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 300 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 301 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 302 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 303 | REPORTED_PROPERTIES_TRANSACTION_HANDLE Device_CreateTransaction_ReportedProperties(DEVICE_HANDLE deviceHandle) |
| XinZhangMS | 0:f7f1f0d76dd6 | 304 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 305 | REPORTED_PROPERTIES_TRANSACTION_HANDLE result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 306 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 307 | /*Codes_SRS_DEVICE_02_014: [ If argument deviceHandle is NULL then Device_CreateTransaction_ReportedProperties shall fail and return NULL. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 308 | if (deviceHandle == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 309 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 310 | LogError("invalid argument DEVICE_HANDLE deviceHandle=%p", deviceHandle); |
| XinZhangMS | 0:f7f1f0d76dd6 | 311 | result = NULL; |
| XinZhangMS | 0:f7f1f0d76dd6 | 312 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 313 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 314 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 315 | DEVICE_HANDLE_DATA* deviceInstance = (DEVICE_HANDLE_DATA*)deviceHandle; |
| XinZhangMS | 0:f7f1f0d76dd6 | 316 | /*Codes_SRS_DEVICE_02_015: [ Otherwise, Device_CreateTransaction_ReportedProperties shall call DataPublisher_CreateTransaction_ReportedProperties. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 317 | /*Codes_SRS_DEVICE_02_016: [ If DataPublisher_CreateTransaction_ReportedProperties fails then Device_CreateTransaction_ReportedProperties shall fail and return NULL. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 318 | /*Codes_SRS_DEVICE_02_017: [ Otherwise Device_CreateTransaction_ReportedProperties shall succeed and return a non-NULL value. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 319 | result = DataPublisher_CreateTransaction_ReportedProperties(deviceInstance->dataPublisherHandle); |
| XinZhangMS | 0:f7f1f0d76dd6 | 320 | if (result == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 321 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 322 | LogError("unable to DataPublisher_CreateTransaction_ReportedProperties"); |
| XinZhangMS | 0:f7f1f0d76dd6 | 323 | /*return as is*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 324 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 325 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 326 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 327 | /*return as is*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 328 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 329 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 330 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 331 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 332 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 333 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 334 | DEVICE_RESULT Device_PublishTransacted_ReportedProperty(REPORTED_PROPERTIES_TRANSACTION_HANDLE transactionHandle, const char* reportedPropertyPath, const AGENT_DATA_TYPE* data) |
| XinZhangMS | 0:f7f1f0d76dd6 | 335 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 336 | DEVICE_RESULT result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 337 | /*Codes_SRS_DEVICE_02_018: [ If argument transactionHandle is NULL then Device_PublishTransacted_ReportedProperty shall fail and return DEVICE_INVALID_ARG. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 338 | /*Codes_SRS_DEVICE_02_019: [ If argument reportedPropertyPath is NULL then Device_PublishTransacted_ReportedProperty shall fail and return DEVICE_INVALID_ARG. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 339 | /*Codes_SRS_DEVICE_02_020: [ If argument data is NULL then Device_PublishTransacted_ReportedProperty shall fail and return DEVICE_INVALID_ARG. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 340 | if ( |
| XinZhangMS | 0:f7f1f0d76dd6 | 341 | (transactionHandle == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 342 | (reportedPropertyPath == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 343 | (data == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 344 | ) |
| XinZhangMS | 0:f7f1f0d76dd6 | 345 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 346 | LogError("invalid argument REPORTED_PROPERTIES_TRANSACTION_HANDLE transactionHandle=%p, const char* reportedPropertyPath=%s, const AGENT_DATA_TYPE* data=%p", transactionHandle, reportedPropertyPath, data); |
| XinZhangMS | 0:f7f1f0d76dd6 | 347 | result = DEVICE_INVALID_ARG; |
| XinZhangMS | 0:f7f1f0d76dd6 | 348 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 349 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 350 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 351 | /*Codes_SRS_DEVICE_02_021: [ Device_PublishTransacted_ReportedProperty shall call DataPublisher_PublishTransacted_ReportedProperty. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 352 | DATA_PUBLISHER_RESULT r = DataPublisher_PublishTransacted_ReportedProperty(transactionHandle, reportedPropertyPath, data); |
| XinZhangMS | 0:f7f1f0d76dd6 | 353 | if (r != DATA_PUBLISHER_OK) |
| XinZhangMS | 0:f7f1f0d76dd6 | 354 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 355 | LogError("unable to DataPublisher_PublishTransacted_ReportedProperty"); |
| XinZhangMS | 0:f7f1f0d76dd6 | 356 | /*Codes_SRS_DEVICE_02_022: [ If DataPublisher_PublishTransacted_ReportedProperty fails then Device_PublishTransacted_ReportedProperty shall fail and return DEVICE_DATA_PUBLISHER_FAILED. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 357 | result = DEVICE_DATA_PUBLISHER_FAILED; |
| XinZhangMS | 0:f7f1f0d76dd6 | 358 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 359 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 360 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 361 | /*Codes_SRS_DEVICE_02_023: [ Otherwise, Device_PublishTransacted_ReportedProperty shall succeed and return DEVICE_OK. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 362 | result = DEVICE_OK; |
| XinZhangMS | 0:f7f1f0d76dd6 | 363 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 364 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 365 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 366 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 367 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 368 | DEVICE_RESULT Device_CommitTransaction_ReportedProperties(REPORTED_PROPERTIES_TRANSACTION_HANDLE transactionHandle, unsigned char** destination, size_t* destinationSize) |
| XinZhangMS | 0:f7f1f0d76dd6 | 369 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 370 | DEVICE_RESULT result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 371 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 372 | /*Codes_SRS_DEVICE_02_024: [ If argument transactionHandle is NULL then Device_CommitTransaction_ReportedProperties shall fail and return DEVICE_INVALID_ARG. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 373 | /*Codes_SRS_DEVICE_02_025: [ If argument destination is NULL then Device_CommitTransaction_ReportedProperties shall fail and return DEVICE_INVALID_ARG. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 374 | /*Codes_SRS_DEVICE_02_026: [ If argument destinationSize is NULL then Device_CommitTransaction_ReportedProperties shall fail and return DEVICE_INVALID_ARG. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 375 | if ( |
| XinZhangMS | 0:f7f1f0d76dd6 | 376 | (transactionHandle == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 377 | (destination == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 378 | (destinationSize == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 379 | ) |
| XinZhangMS | 0:f7f1f0d76dd6 | 380 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 381 | LogError("invalid argument REPORTED_PROPERTIES_TRANSACTION_HANDLE transactionHandle=%p, unsigned char** destination=%p, size_t* destinationSize=%p", transactionHandle, destination, destinationSize); |
| XinZhangMS | 0:f7f1f0d76dd6 | 382 | result = DEVICE_INVALID_ARG; |
| XinZhangMS | 0:f7f1f0d76dd6 | 383 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 384 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 385 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 386 | /*Codes_SRS_DEVICE_02_027: [ Device_CommitTransaction_ReportedProperties shall call DataPublisher_CommitTransaction_ReportedProperties. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 387 | DATA_PUBLISHER_RESULT r = DataPublisher_CommitTransaction_ReportedProperties(transactionHandle, destination, destinationSize); |
| XinZhangMS | 0:f7f1f0d76dd6 | 388 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 389 | /*Codes_SRS_DEVICE_02_028: [ If DataPublisher_CommitTransaction_ReportedProperties fails then Device_CommitTransaction_ReportedProperties shall fail and return DEVICE_DATA_PUBLISHER_FAILED. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 390 | if (r != DATA_PUBLISHER_OK) |
| XinZhangMS | 0:f7f1f0d76dd6 | 391 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 392 | LogError("unable to DataPublisher_CommitTransaction_ReportedProperties"); |
| XinZhangMS | 0:f7f1f0d76dd6 | 393 | result = DEVICE_DATA_PUBLISHER_FAILED; |
| XinZhangMS | 0:f7f1f0d76dd6 | 394 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 395 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 396 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 397 | /*Codes_SRS_DEVICE_02_029: [ Otherwise Device_CommitTransaction_ReportedProperties shall succeed and return DEVICE_OK. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 398 | result = DEVICE_OK; |
| XinZhangMS | 0:f7f1f0d76dd6 | 399 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 400 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 401 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 402 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 403 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 404 | void Device_DestroyTransaction_ReportedProperties(REPORTED_PROPERTIES_TRANSACTION_HANDLE transactionHandle) |
| XinZhangMS | 0:f7f1f0d76dd6 | 405 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 406 | /*Codes_SRS_DEVICE_02_030: [ If argument transactionHandle is NULL then Device_DestroyTransaction_ReportedProperties shall return. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 407 | if (transactionHandle == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 408 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 409 | LogError("invalid argument REPORTED_PROPERTIES_TRANSACTION_HANDLE transactionHandle=%p", transactionHandle); |
| XinZhangMS | 0:f7f1f0d76dd6 | 410 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 411 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 412 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 413 | /*Codes_SRS_DEVICE_02_031: [ Otherwise Device_DestroyTransaction_ReportedProperties shall free all used resources. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 414 | DataPublisher_DestroyTransaction_ReportedProperties(transactionHandle); |
| XinZhangMS | 0:f7f1f0d76dd6 | 415 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 416 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 417 | |
| XinZhangMS | 0:f7f1f0d76dd6 | 418 | DEVICE_RESULT Device_IngestDesiredProperties(void* startAddress, DEVICE_HANDLE deviceHandle, const char* jsonPayload, bool parseDesiredNode) |
| XinZhangMS | 0:f7f1f0d76dd6 | 419 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 420 | DEVICE_RESULT result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 421 | /*Codes_SRS_DEVICE_02_032: [ If deviceHandle is NULL then Device_IngestDesiredProperties shall fail and return DEVICE_INVALID_ARG. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 422 | /*Codes_SRS_DEVICE_02_033: [ If jsonPayload is NULL then Device_IngestDesiredProperties shall fail and return DEVICE_INVALID_ARG. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 423 | /*Codes_SRS_DEVICE_02_037: [ If startAddress is NULL then Device_IngestDesiredProperties shall fail and return DEVICE_INVALID_ARG. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 424 | if ( |
| XinZhangMS | 0:f7f1f0d76dd6 | 425 | (deviceHandle == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 426 | (jsonPayload == NULL) || |
| XinZhangMS | 0:f7f1f0d76dd6 | 427 | (startAddress == NULL) |
| XinZhangMS | 0:f7f1f0d76dd6 | 428 | ) |
| XinZhangMS | 0:f7f1f0d76dd6 | 429 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 430 | LogError("invalid argument void* startAddress=%p, DEVICE_HANDLE deviceHandle=%p, const char* jsonPayload=%p\n", startAddress, deviceHandle, jsonPayload); |
| XinZhangMS | 0:f7f1f0d76dd6 | 431 | result = DEVICE_INVALID_ARG; |
| XinZhangMS | 0:f7f1f0d76dd6 | 432 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 433 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 434 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 435 | /*Codes_SRS_DEVICE_02_034: [ Device_IngestDesiredProperties shall call CommandDecoder_IngestDesiredProperties. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 436 | DEVICE_HANDLE_DATA* device = (DEVICE_HANDLE_DATA*)deviceHandle; |
| XinZhangMS | 0:f7f1f0d76dd6 | 437 | if (CommandDecoder_IngestDesiredProperties(startAddress, device->commandDecoderHandle, jsonPayload, parseDesiredNode) != EXECUTE_COMMAND_SUCCESS) |
| XinZhangMS | 0:f7f1f0d76dd6 | 438 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 439 | /*Codes_SRS_DEVICE_02_035: [ If any failure happens then Device_IngestDesiredProperties shall fail and return DEVICE_ERROR. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 440 | LogError("failure in CommandDecoder_IngestDesiredProperties"); |
| XinZhangMS | 0:f7f1f0d76dd6 | 441 | result = DEVICE_ERROR; |
| XinZhangMS | 0:f7f1f0d76dd6 | 442 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 443 | else |
| XinZhangMS | 0:f7f1f0d76dd6 | 444 | { |
| XinZhangMS | 0:f7f1f0d76dd6 | 445 | /*Codes_SRS_DEVICE_02_036: [ Otherwise, Device_IngestDesiredProperties shall succeed and return DEVICE_OK. ]*/ |
| XinZhangMS | 0:f7f1f0d76dd6 | 446 | result = DEVICE_OK; |
| XinZhangMS | 0:f7f1f0d76dd6 | 447 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 448 | } |
| XinZhangMS | 0:f7f1f0d76dd6 | 449 | return result; |
| XinZhangMS | 0:f7f1f0d76dd6 | 450 | } |