## HarmonyHub / Harmony_AWS_IoT .gitee-modal { width: 500px !important; }

Explore and code with more than 6 million developers，Free private repositories ！：）
/*
*
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
*  http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/

#ifdef __cplusplus
extern "C" {
#endif

/**
* @brief This file is the interface for all the Shadow related JSON functions.
*/

#include <stddef.h>

/**
* @brief This is a static JSON object that could be used in code
*
*/
typedef struct jsonStruct jsonStruct_t;

/**
* @brief Every JSON name value can have a callback. The callback should follow this signature
*/
typedef void (*jsonStructCallback_t)(const char *pJsonValueBuffer, uint32_t valueLength, jsonStruct_t *pJsonStruct_t);

/**
* @brief All the JSON object types enum
*
* JSON number types need to be split into proper integer / floating point data types and sizes on embedded platforms.
*/
typedef enum {
} JsonPrimitiveType;

/**
* @brief This is the struct form of a JSON Key value pair
*/
struct jsonStruct {
const char *pKey; ///< JSON key
void *pData; ///< pointer to the data (JSON value)
size_t dataLength; ///< Length (in bytes) of pData
JsonPrimitiveType type; ///< type of JSON
jsonStructCallback_t cb; ///< callback to be executed on receiving the Key value pair
};

/**
* @brief Initialize the JSON document with Shadow expected name/value
*
* This Function will fill the JSON Buffer with a null terminated string. Internally it uses snprintf
* Always finish the call sequence with iot_finalize_json_document
*
* @note Ensure the size of the Buffer is enough to hold the entire JSON Document.
*
*
* @param pJsonDocument The JSON Document filled in this char buffer
* @param maxSizeOfJsonDocument maximum size of the pJsonDocument that can be used to fill the JSON document
* @return An IoT Error Type defining if the buffer was null or the entire string was not filled up
*/

/**
* @brief Add the reported section of the JSON document of jsonStruct_t
*
* This is a variadic function and please be careful with the usage. count is the number of jsonStruct_t types that you would like to add in the reported section
* This function will add "reported":{<all the values that needs to be added>}
*
* @note Ensure the size of the Buffer is enough to hold the reported section + the init section. Always use the same JSON document buffer used in the iot_shadow_init_json_document function. This function will accommodate the size of previous null terminated string, so pass teh max size of the buffer
*
*
* @param pJsonDocument The JSON Document filled in this char buffer
* @param maxSizeOfJsonDocument maximum size of the pJsonDocument that can be used to fill the JSON document
* @param count total number of arguments(jsonStruct_t object) passed in the arguments
* @return An IoT Error Type defining if the buffer was null or the entire string was not filled up
*/

/**
* @brief Add the desired section of the JSON document of jsonStruct_t
*
* This is a variadic function and please be careful with the usage. count is the number of jsonStruct_t types that you would like to add in the reported section
* This function will add "desired":{<all the values that needs to be added>}
*
* @note Ensure the size of the Buffer is enough to hold the reported section + the init section. Always use the same JSON document buffer used in the iot_shadow_init_json_document function. This function will accommodate the size of previous null terminated string, so pass the max size of the buffer
*
*
* @param pJsonDocument The JSON Document filled in this char buffer
* @param maxSizeOfJsonDocument maximum size of the pJsonDocument that can be used to fill the JSON document
* @param count total number of arguments(jsonStruct_t object) passed in the arguments
* @return An IoT Error Type defining if the buffer was null or the entire string was not filled up
*/

/**
* @brief Finalize the JSON document with Shadow expected client Token.
*
* This function will automatically increment the client token every time this function is called.
*
* @note Ensure the size of the Buffer is enough to hold the entire JSON Document. If the finalized section is not invoked then the JSON doucment will not be valid
*
*
* @param pJsonDocument The JSON Document filled in this char buffer
* @param maxSizeOfJsonDocument maximum size of the pJsonDocument that can be used to fill the JSON document
* @return An IoT Error Type defining if the buffer was null or the entire string was not filled up
*/
IoT_Error_t aws_iot_finalize_json_document(char *pJsonDocument, size_t maxSizeOfJsonDocument);

/**
* @brief Fill the given buffer with client token for tracking the Repsonse.
*
* This function will add the AWS_IOT_MQTT_CLIENT_ID with a sequence number. Every time this function is used the sequence number gets incremented
*
*
* @param pBufferToBeUpdatedWithClientToken buffer to be updated with the client token string
* @param maxSizeOfJsonDocument maximum size of the pBufferToBeUpdatedWithClientToken that can be used
* @return An IoT Error Type defining if the buffer was null or the entire string was not filled up
*/

IoT_Error_t aws_iot_fill_with_client_token(char *pBufferToBeUpdatedWithClientToken, size_t maxSizeOfJsonDocument);

#ifdef __cplusplus
}
#endif