le_avdata_interface.h
Go to the documentation of this file.
36 * Data is setup as @b Assets — a collection of fields that can be managed by the AirVantage44 * - @b setting allowing the AirVantage server to read/write the value, and can be read by an App.71 * @note If a user enters a value 0 for float data type, an error will be returned (LE_NOT_FOUND),72 * as the system infers 0 as an integer value and the data type doesn't match. 0.0 needs to be set82 * Registered handlers are called only when activities from AV server occurs. Client activities do85 * A handler registered with a command field is invoked with an optional argument list sent from the90 * A handler registered with a command field must call the le_avdata_ReplyExecResult() at the end of152 * Calling le_avdata_GetXXX/le_avdata_SetXXX/le_avdata_AddResourceEventHandler/le_avdata_Push with the153 * path "/a/b/c" will search for the "/a/b/c" data under the apps namespace. In order to query any154 * paths created under an application namespace, user must append the app name in front of the request155 * on the server side. If creating asset data under application namespace is not desired, users must156 * call le_avdata_SetNamespace and set the value to global. An application that changes its namespace157 * to global will be creating asset data in the global space. All asset data API will use the last182 * An application starts by creating a path "/test/resourceA" under the default application namespace183 * and sets it to 1. Then it sets the namespace to global and creates another path "/test/resourceA"184 * with a value of 2. A read request from the server on "<appName>/test/resourceA" will return 1;189 * This feature enables user Apps to collect and keep in memory data when the device is off-line and204 * This code sample shows how to collect data and send to the server (assuming session is opened)229 * utcMilliSec = (uint64_t)(tv.tv_sec) * 1000 + (uint64_t)(tv.tv_usec) / 1000; // get current time247 * le_avdata_AddSessionStateHandler() and le_avdata_RemoveSessionStateHandler() can be used to add272 //--------------------------------------------------------------------------------------------------276 //--------------------------------------------------------------------------------------------------279 //--------------------------------------------------------------------------------------------------282 * Connect the current client thread to the service providing this API. Block until the service is285 * For each thread that wants to use this API, either ConnectService or TryConnectService must be286 * called before any other functions in this API. Normally, ConnectService is automatically called291 //--------------------------------------------------------------------------------------------------297 //--------------------------------------------------------------------------------------------------300 * Try to connect the current client thread to the service providing this API. Return with an error303 * For each thread that wants to use this API, either ConnectService or TryConnectService must be304 * called before any other functions in this API. Normally, ConnectService is automatically called313 * - LE_NOT_PERMITTED if the client interface is not bound to any service (doesn't have a binding).316 //--------------------------------------------------------------------------------------------------322 //--------------------------------------------------------------------------------------------------326 * When a server connection is lost, call this handler then exit with LE_FATAL. If a program wants329 //--------------------------------------------------------------------------------------------------336 //--------------------------------------------------------------------------------------------------342 * longer a connection to the service, and the functions in this API can't be used. For details, see347 //--------------------------------------------------------------------------------------------------354 //--------------------------------------------------------------------------------------------------358 //--------------------------------------------------------------------------------------------------361 //--------------------------------------------------------------------------------------------------364 //--------------------------------------------------------------------------------------------------367 //--------------------------------------------------------------------------------------------------371 //--------------------------------------------------------------------------------------------------374 //--------------------------------------------------------------------------------------------------377 //--------------------------------------------------------------------------------------------------380 //--------------------------------------------------------------------------------------------------387 //--------------------------------------------------------------------------------------------------400 //--------------------------------------------------------------------------------------------------404 //--------------------------------------------------------------------------------------------------414 //--------------------------------------------------------------------------------------------------418 //--------------------------------------------------------------------------------------------------429 //--------------------------------------------------------------------------------------------------433 //--------------------------------------------------------------------------------------------------450 //--------------------------------------------------------------------------------------------------455 //--------------------------------------------------------------------------------------------------466 //--------------------------------------------------------------------------------------------------470 //--------------------------------------------------------------------------------------------------474 //--------------------------------------------------------------------------------------------------478 //--------------------------------------------------------------------------------------------------482 //--------------------------------------------------------------------------------------------------486 //--------------------------------------------------------------------------------------------------490 //--------------------------------------------------------------------------------------------------494 //--------------------------------------------------------------------------------------------------498 //--------------------------------------------------------------------------------------------------502 //--------------------------------------------------------------------------------------------------513 //--------------------------------------------------------------------------------------------------517 //--------------------------------------------------------------------------------------------------521 //--------------------------------------------------------------------------------------------------523 * Handler for resource activity. Note that the path returned by this event follows the unix format527 //--------------------------------------------------------------------------------------------------529 (540 //--------------------------------------------------------------------------------------------------544 //--------------------------------------------------------------------------------------------------546 (553 //--------------------------------------------------------------------------------------------------557 //--------------------------------------------------------------------------------------------------559 (566 //--------------------------------------------------------------------------------------------------574 * For "commands", the handler function must call the "ReplyExecResult" function to send the command578 //--------------------------------------------------------------------------------------------------589 //--------------------------------------------------------------------------------------------------593 //--------------------------------------------------------------------------------------------------600 //--------------------------------------------------------------------------------------------------602 * Create an asset data with the provided path. Note that asset data type and value are determined603 * upon the first call to a Set function. When an asset data is created, it contains a null value,612 //--------------------------------------------------------------------------------------------------621 //--------------------------------------------------------------------------------------------------629 //--------------------------------------------------------------------------------------------------636 //--------------------------------------------------------------------------------------------------645 //--------------------------------------------------------------------------------------------------652 //--------------------------------------------------------------------------------------------------663 //--------------------------------------------------------------------------------------------------672 //--------------------------------------------------------------------------------------------------681 //--------------------------------------------------------------------------------------------------690 //--------------------------------------------------------------------------------------------------701 //--------------------------------------------------------------------------------------------------710 //--------------------------------------------------------------------------------------------------719 //--------------------------------------------------------------------------------------------------728 //--------------------------------------------------------------------------------------------------739 //--------------------------------------------------------------------------------------------------748 //--------------------------------------------------------------------------------------------------757 //--------------------------------------------------------------------------------------------------766 //--------------------------------------------------------------------------------------------------777 //--------------------------------------------------------------------------------------------------788 //--------------------------------------------------------------------------------------------------797 //--------------------------------------------------------------------------------------------------806 //--------------------------------------------------------------------------------------------------814 //--------------------------------------------------------------------------------------------------825 //--------------------------------------------------------------------------------------------------833 //--------------------------------------------------------------------------------------------------844 //--------------------------------------------------------------------------------------------------852 //--------------------------------------------------------------------------------------------------863 //--------------------------------------------------------------------------------------------------871 //--------------------------------------------------------------------------------------------------884 //--------------------------------------------------------------------------------------------------886 * Get the length (excluding terminating null byte) of the string argument of the specified name.892 //--------------------------------------------------------------------------------------------------903 //--------------------------------------------------------------------------------------------------905 * Reply command execution result to AVC Daemon, which can then respond to AV server. This function906 * MUST be called at the end of a command execution, in order for AV server to be notified about the909 //--------------------------------------------------------------------------------------------------918 //--------------------------------------------------------------------------------------------------929 //--------------------------------------------------------------------------------------------------940 //--------------------------------------------------------------------------------------------------949 //--------------------------------------------------------------------------------------------------962 //--------------------------------------------------------------------------------------------------968 //--------------------------------------------------------------------------------------------------974 //--------------------------------------------------------------------------------------------------978 //--------------------------------------------------------------------------------------------------985 //--------------------------------------------------------------------------------------------------989 * @note The client will be terminated if the recordRef is not valid, or the resource doesn't exist996 //--------------------------------------------------------------------------------------------------1009 //--------------------------------------------------------------------------------------------------1013 * @note The client will be terminated if the recordRef is not valid, or the resource doesn't exist1020 //--------------------------------------------------------------------------------------------------1033 //--------------------------------------------------------------------------------------------------1037 * @note The client will be terminated if the recordRef is not valid, or the resource doesn't exist1044 //--------------------------------------------------------------------------------------------------1057 //--------------------------------------------------------------------------------------------------1061 * @note The client will be terminated if the recordRef is not valid, or the resource doesn't exist1068 //--------------------------------------------------------------------------------------------------1081 //--------------------------------------------------------------------------------------------------1094 //--------------------------------------------------------------------------------------------------1105 //--------------------------------------------------------------------------------------------------1111 //--------------------------------------------------------------------------------------------------1120 //--------------------------------------------------------------------------------------------------1124 //--------------------------------------------------------------------------------------------------1131 //--------------------------------------------------------------------------------------------------1139 //--------------------------------------------------------------------------------------------------1145 //--------------------------------------------------------------------------------------------------1150 //--------------------------------------------------------------------------------------------------le_result_t le_avdata_PushStream(const char *LE_NONNULL path, int fd, le_avdata_CallbackResultFunc_t handlerPtr, void *contextPtr)le_result_t le_avdata_GetInt(const char *LE_NONNULL path, int32_t *valuePtr)le_result_t le_avdata_GetFloat(const char *LE_NONNULL path, double *valuePtr)le_result_t le_avdata_CreateResource(const char *LE_NONNULL path, le_avdata_AccessMode_t accessMode)le_result_t le_avdata_RecordFloat(le_avdata_RecordRef_t recordRef, const char *LE_NONNULL path, double value, uint64_t timestamp)le_result_t le_avdata_SetNull(const char *LE_NONNULL path)le_avdata_SessionStateHandlerRef_t le_avdata_AddSessionStateHandler(le_avdata_SessionStateHandlerFunc_t handlerPtr, void *contextPtr)void le_avdata_ReleaseSession(le_avdata_RequestSessionObjRef_t requestRef)struct le_avdata_RequestSessionObj * le_avdata_RequestSessionObjRef_tDefinition: le_avdata_interface.h:495void le_avdata_RemoveResourceEventHandler(le_avdata_ResourceEventHandlerRef_t handlerRef)le_result_t le_avdata_RecordString(le_avdata_RecordRef_t recordRef, const char *LE_NONNULL path, const char *LE_NONNULL value, uint64_t timestamp)void le_avdata_DisconnectService(void)le_result_t le_avdata_GetBool(const char *LE_NONNULL path, bool *valuePtr)le_result_t le_avdata_PushRecord(le_avdata_RecordRef_t recordRef, le_avdata_CallbackResultFunc_t handlerPtr, void *contextPtr)void le_avdata_ReplyExecResult(le_avdata_ArgumentListRef_t argumentListRef, le_result_t result)le_result_t le_avdata_Push(const char *LE_NONNULL path, le_avdata_CallbackResultFunc_t handlerPtr, void *contextPtr)le_result_t le_avdata_GetStringArgLength(le_avdata_ArgumentListRef_t argumentListRef, const char *LE_NONNULL argName, int32_t *strArgLenPtr)le_avdata_RequestSessionObjRef_t le_avdata_RequestSession(void)void(* le_avdata_DisconnectHandler_t)(void *)Definition: le_avdata_interface.h:277le_result_t le_avdata_SetString(const char *LE_NONNULL path, const char *LE_NONNULL value)le_result_t le_avdata_GetBoolArg(le_avdata_ArgumentListRef_t argumentListRef, const char *LE_NONNULL argName, bool *boolArgPtr)le_result_t le_avdata_RecordInt(le_avdata_RecordRef_t recordRef, const char *LE_NONNULL path, int32_t value, uint64_t timestamp)le_result_t le_avdata_SetNamespace(le_avdata_Namespace_t namespace)le_result_t le_avdata_RecordBool(le_avdata_RecordRef_t recordRef, const char *LE_NONNULL path, bool value, uint64_t timestamp)void le_avdata_ConnectService(void)le_result_t le_avdata_GetString(const char *LE_NONNULL path, char *value, size_t valueSize)le_result_t le_avdata_GetStringArg(le_avdata_ArgumentListRef_t argumentListRef, const char *LE_NONNULL argName, char *strArg, size_t strArgSize)struct le_avdata_ResourceEventHandler * le_avdata_ResourceEventHandlerRef_tDefinition: le_avdata_interface.h:479le_result_t le_avdata_TryConnectService(void)void le_avdata_SetServerDisconnectHandler(le_avdata_DisconnectHandler_t disconnectHandler, void *contextPtr)le_result_t le_avdata_SetFloat(const char *LE_NONNULL path, double value)le_result_t le_avdata_GetFloatArg(le_avdata_ArgumentListRef_t argumentListRef, const char *LE_NONNULL argName, double *floatArgPtr)struct le_avdata_SessionStateHandler * le_avdata_SessionStateHandlerRef_tDefinition: le_avdata_interface.h:518void(* le_avdata_SessionStateHandlerFunc_t)(le_avdata_SessionState_t sessionState, void *contextPtr)Definition: le_avdata_interface.h:559struct le_avdata_ArgumentList * le_avdata_ArgumentListRef_tDefinition: le_avdata_interface.h:471struct le_avdata_Record * le_avdata_RecordRef_tDefinition: le_avdata_interface.h:487le_avdata_ResourceEventHandlerRef_t le_avdata_AddResourceEventHandler(const char *LE_NONNULL path, le_avdata_ResourceHandlerFunc_t handlerPtr, void *contextPtr)void(* le_avdata_CallbackResultFunc_t)(le_avdata_PushStatus_t status, void *contextPtr)Definition: le_avdata_interface.h:546le_result_t le_avdata_GetIntArg(le_avdata_ArgumentListRef_t argumentListRef, const char *LE_NONNULL argName, int32_t *intArgPtr)le_result_t le_avdata_SetInt(const char *LE_NONNULL path, int32_t value)le_avdata_RecordRef_t le_avdata_CreateRecord(void)void le_avdata_DeleteRecord(le_avdata_RecordRef_t recordRef)le_result_t le_avdata_SetBool(const char *LE_NONNULL path, bool value)void(* le_avdata_ResourceHandlerFunc_t)(const char *LE_NONNULL path, le_avdata_AccessType_t accessType, le_avdata_ArgumentListRef_t argumentListRef, void *contextPtr)Definition: le_avdata_interface.h:529void le_avdata_RemoveSessionStateHandler(le_avdata_SessionStateHandlerRef_t handlerRef)