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 AirVantage43 * - @b variable allowing the AirVantage server to read the value, and can be read/writtten to by an App.44 * - @b setting allowing the AirVantage server to read/write the value, and can be read/written to 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 of154 * namespace. In order to query any paths created under an application namespace, user must append155 * the app name in front of the request on the server side. If creating asset data under application156 * namespace is not desired, users must call le_avdata_SetNamespace() and set the value to global.158 * space. All asset data API will use the last namespace set until the function is called again and162 * the asset data created under global namespace. No asset data can therefore be persistent after190 * "/test/resourceA" with a value of 2. A read request from the server on "<appName>/test/resourceA"195 * This feature enables user Apps to collect and keep in memory data when the device is off-line and210 * This code sample shows how to collect data and send to the server (assuming session is opened)235 * utcMilliSec = (uint64_t)(tv.tv_sec) * 1000 + (uint64_t)(tv.tv_usec) / 1000; // get current time253 * le_avdata_AddSessionStateHandler() and le_avdata_RemoveSessionStateHandler() can be used to add278 //--------------------------------------------------------------------------------------------------282 //--------------------------------------------------------------------------------------------------285 //--------------------------------------------------------------------------------------------------288 * Connect the current client thread to the service providing this API. Block until the service is291 * For each thread that wants to use this API, either ConnectService or TryConnectService must be292 * called before any other functions in this API. Normally, ConnectService is automatically called297 //--------------------------------------------------------------------------------------------------303 //--------------------------------------------------------------------------------------------------306 * Try to connect the current client thread to the service providing this API. Return with an error309 * For each thread that wants to use this API, either ConnectService or TryConnectService must be310 * called before any other functions in this API. Normally, ConnectService is automatically called319 * - LE_NOT_PERMITTED if the client interface is not bound to any service (doesn't have a binding).322 //--------------------------------------------------------------------------------------------------328 //--------------------------------------------------------------------------------------------------332 * When a server connection is lost, call this handler then exit with LE_FATAL. If a program wants335 //--------------------------------------------------------------------------------------------------342 //--------------------------------------------------------------------------------------------------348 * longer a connection to the service, and the functions in this API can't be used. For details, see353 //--------------------------------------------------------------------------------------------------360 //--------------------------------------------------------------------------------------------------364 //--------------------------------------------------------------------------------------------------367 //--------------------------------------------------------------------------------------------------370 //--------------------------------------------------------------------------------------------------373 //--------------------------------------------------------------------------------------------------377 //--------------------------------------------------------------------------------------------------380 //--------------------------------------------------------------------------------------------------383 //--------------------------------------------------------------------------------------------------386 //--------------------------------------------------------------------------------------------------393 //--------------------------------------------------------------------------------------------------406 //--------------------------------------------------------------------------------------------------410 //--------------------------------------------------------------------------------------------------420 //--------------------------------------------------------------------------------------------------424 //--------------------------------------------------------------------------------------------------435 //--------------------------------------------------------------------------------------------------439 //--------------------------------------------------------------------------------------------------456 //--------------------------------------------------------------------------------------------------461 //--------------------------------------------------------------------------------------------------472 //--------------------------------------------------------------------------------------------------476 //--------------------------------------------------------------------------------------------------480 //--------------------------------------------------------------------------------------------------484 //--------------------------------------------------------------------------------------------------488 //--------------------------------------------------------------------------------------------------492 //--------------------------------------------------------------------------------------------------496 //--------------------------------------------------------------------------------------------------500 //--------------------------------------------------------------------------------------------------504 //--------------------------------------------------------------------------------------------------508 //--------------------------------------------------------------------------------------------------519 //--------------------------------------------------------------------------------------------------523 //--------------------------------------------------------------------------------------------------527 //--------------------------------------------------------------------------------------------------529 * Handler for resource activity. Note that the path returned by this event follows the unix format533 //--------------------------------------------------------------------------------------------------535 (546 //--------------------------------------------------------------------------------------------------550 //--------------------------------------------------------------------------------------------------552 (559 //--------------------------------------------------------------------------------------------------563 //--------------------------------------------------------------------------------------------------565 (572 //--------------------------------------------------------------------------------------------------580 * For "commands", the handler function must call the "ReplyExecResult" function to send the command584 //--------------------------------------------------------------------------------------------------595 //--------------------------------------------------------------------------------------------------599 //--------------------------------------------------------------------------------------------------606 //--------------------------------------------------------------------------------------------------608 * Create an asset data with the provided path. Note that asset data type and value are determined609 * upon the first call to a Set function. When an asset data is created, it contains a null value,618 //--------------------------------------------------------------------------------------------------627 //--------------------------------------------------------------------------------------------------635 //--------------------------------------------------------------------------------------------------642 //--------------------------------------------------------------------------------------------------651 //--------------------------------------------------------------------------------------------------658 //--------------------------------------------------------------------------------------------------669 //--------------------------------------------------------------------------------------------------678 //--------------------------------------------------------------------------------------------------687 //--------------------------------------------------------------------------------------------------696 //--------------------------------------------------------------------------------------------------707 //--------------------------------------------------------------------------------------------------716 //--------------------------------------------------------------------------------------------------725 //--------------------------------------------------------------------------------------------------734 //--------------------------------------------------------------------------------------------------745 //--------------------------------------------------------------------------------------------------754 //--------------------------------------------------------------------------------------------------763 //--------------------------------------------------------------------------------------------------772 //--------------------------------------------------------------------------------------------------784 //--------------------------------------------------------------------------------------------------795 //--------------------------------------------------------------------------------------------------804 //--------------------------------------------------------------------------------------------------813 //--------------------------------------------------------------------------------------------------821 //--------------------------------------------------------------------------------------------------832 //--------------------------------------------------------------------------------------------------840 //--------------------------------------------------------------------------------------------------851 //--------------------------------------------------------------------------------------------------859 //--------------------------------------------------------------------------------------------------870 //--------------------------------------------------------------------------------------------------879 //--------------------------------------------------------------------------------------------------892 //--------------------------------------------------------------------------------------------------894 * Get the length (excluding terminating null byte) of the string argument of the specified name.900 //--------------------------------------------------------------------------------------------------911 //--------------------------------------------------------------------------------------------------913 * Reply command execution result to AVC Daemon, which can then respond to AV server. This function914 * MUST be called at the end of a command execution, in order for AV server to be notified about the917 //--------------------------------------------------------------------------------------------------926 //--------------------------------------------------------------------------------------------------937 //--------------------------------------------------------------------------------------------------948 //--------------------------------------------------------------------------------------------------957 //--------------------------------------------------------------------------------------------------970 //--------------------------------------------------------------------------------------------------976 //--------------------------------------------------------------------------------------------------982 //--------------------------------------------------------------------------------------------------986 //--------------------------------------------------------------------------------------------------993 //--------------------------------------------------------------------------------------------------997 * @note The client will be terminated if the recordRef is not valid, or the resource doesn't exist1004 //--------------------------------------------------------------------------------------------------1017 //--------------------------------------------------------------------------------------------------1021 * @note The client will be terminated if the recordRef is not valid, or the resource doesn't exist1028 //--------------------------------------------------------------------------------------------------1041 //--------------------------------------------------------------------------------------------------1045 * @note The client will be terminated if the recordRef is not valid, or the resource doesn't exist1052 //--------------------------------------------------------------------------------------------------1065 //--------------------------------------------------------------------------------------------------1069 * @note The client will be terminated if the recordRef is not valid, or the resource doesn't exist1076 //--------------------------------------------------------------------------------------------------1089 //--------------------------------------------------------------------------------------------------1102 //--------------------------------------------------------------------------------------------------1113 //--------------------------------------------------------------------------------------------------1119 //--------------------------------------------------------------------------------------------------1128 //--------------------------------------------------------------------------------------------------1132 //--------------------------------------------------------------------------------------------------1139 //--------------------------------------------------------------------------------------------------1147 //--------------------------------------------------------------------------------------------------1153 //--------------------------------------------------------------------------------------------------1158 //--------------------------------------------------------------------------------------------------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:501void 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:283le_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:485le_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:524void(* le_avdata_SessionStateHandlerFunc_t)(le_avdata_SessionState_t sessionState, void *contextPtr)Definition: le_avdata_interface.h:565struct le_avdata_ArgumentList * le_avdata_ArgumentListRef_tDefinition: le_avdata_interface.h:477struct le_avdata_Record * le_avdata_RecordRef_tDefinition: le_avdata_interface.h:493le_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:552le_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:535read/write (server) or read/write (client)Definition: le_avdata_interface.h:398void le_avdata_RemoveSessionStateHandler(le_avdata_SessionStateHandlerRef_t handlerRef)