le_atServer_interface.h
Go to the documentation of this file.
18 * server is compliant with 3GPP 27.007, paragraphs 4.0, 4.1 and 4.2, and V25 ter, paragraphs 5.3,39 * Lowercase characters are changed to their uppercase equivalents. Only characters between quotes63 * All characters after the "D" are considered part of The D command parameter up to a semicolon or91 * Extended syntax command can be concatenated after basic syntax commands without a separator:<br>96 * le_atServer_Open() must be called to bind the file descriptor of the device with the AT commands110 * A new AT command can be added into the parser using le_atServer_Create(), and it can be deleted137 * Even if these types are specific to the extended format commands according to the standards, they142 * parameter value using le_atServer_GetParameter() API. If a parmeter is not parsed with quotes,147 * The AT command handling mechanism may rely on an intermediate handler to reroute the AT commands149 * le_atServer_AddCmdRegistrationHandler() installs such a registration handler that will be called159 * @note If le_atServer_SendIntermediateResponse() return LE_FAULT, the final response have to be170 * le_atServer_SendFinalResultCode() takes as arguments the AT command reference, a pattern (which175 * concatenated commands: if one command is failed, next commands are not executed, the final result186 * If an unsolicited response is sent when an AT command is in progress, the unsolicited response192 * le_atServer_EnableExtendedErrorCodes() allows the user to use extended error codes on a selected194 * le_atServer_EnableVerboseErrorCodes() allows the user to enable verbose error codes on a selected196 * le_atServer_DisableExtendedErrorCodes() allows the user to disable the current error mode namely206 * le_atServer_CreateErrorCode() returns a reference which can be used to attach a custom verbose212 * le_atServer_GetTextAsync() allows the user to register a le_atServer_GetTextCallback_t callback238 * all unknown AT commands to an alternative device (such as the modem). For all devices linked to253 * (e.g.; ATD*99***1#). Sending these commands through the bridge may lock the Legato AT commands264 * @warning Some modem AT commands may conflict with Legato APIs; using both may cause problems that268 * The application can send an unsolicited on all opened device, or only one on a dedicated device.292 //--------------------------------------------------------------------------------------------------296 //--------------------------------------------------------------------------------------------------299 //--------------------------------------------------------------------------------------------------302 * Connect the current client thread to the service providing this API. Block until the service is305 * For each thread that wants to use this API, either ConnectService or TryConnectService must be306 * called before any other functions in this API. Normally, ConnectService is automatically called311 //--------------------------------------------------------------------------------------------------317 //--------------------------------------------------------------------------------------------------320 * Try to connect the current client thread to the service providing this API. Return with an error323 * For each thread that wants to use this API, either ConnectService or TryConnectService must be324 * called before any other functions in this API. Normally, ConnectService is automatically called333 * - LE_NOT_PERMITTED if the client interface is not bound to any service (doesn't have a binding).336 //--------------------------------------------------------------------------------------------------342 //--------------------------------------------------------------------------------------------------346 * When a server connection is lost, call this handler then exit with LE_FATAL. If a program wants349 //--------------------------------------------------------------------------------------------------356 //--------------------------------------------------------------------------------------------------362 * longer a connection to the service, and the functions in this API can't be used. For details, see367 //--------------------------------------------------------------------------------------------------374 //--------------------------------------------------------------------------------------------------378 //--------------------------------------------------------------------------------------------------381 //--------------------------------------------------------------------------------------------------385 //--------------------------------------------------------------------------------------------------388 //--------------------------------------------------------------------------------------------------392 //--------------------------------------------------------------------------------------------------395 //--------------------------------------------------------------------------------------------------399 //--------------------------------------------------------------------------------------------------402 //--------------------------------------------------------------------------------------------------407 //--------------------------------------------------------------------------------------------------410 //--------------------------------------------------------------------------------------------------414 //--------------------------------------------------------------------------------------------------417 //--------------------------------------------------------------------------------------------------421 //--------------------------------------------------------------------------------------------------424 //--------------------------------------------------------------------------------------------------429 //--------------------------------------------------------------------------------------------------432 //--------------------------------------------------------------------------------------------------436 //--------------------------------------------------------------------------------------------------439 //--------------------------------------------------------------------------------------------------446 //--------------------------------------------------------------------------------------------------449 //--------------------------------------------------------------------------------------------------453 //--------------------------------------------------------------------------------------------------456 //--------------------------------------------------------------------------------------------------466 //--------------------------------------------------------------------------------------------------469 //--------------------------------------------------------------------------------------------------482 //--------------------------------------------------------------------------------------------------489 //--------------------------------------------------------------------------------------------------502 //--------------------------------------------------------------------------------------------------509 //--------------------------------------------------------------------------------------------------521 //--------------------------------------------------------------------------------------------------528 //--------------------------------------------------------------------------------------------------539 //--------------------------------------------------------------------------------------------------546 //--------------------------------------------------------------------------------------------------554 //--------------------------------------------------------------------------------------------------561 //--------------------------------------------------------------------------------------------------571 //--------------------------------------------------------------------------------------------------578 //--------------------------------------------------------------------------------------------------585 //--------------------------------------------------------------------------------------------------595 //--------------------------------------------------------------------------------------------------599 //--------------------------------------------------------------------------------------------------606 //--------------------------------------------------------------------------------------------------613 //--------------------------------------------------------------------------------------------------624 //--------------------------------------------------------------------------------------------------628 //--------------------------------------------------------------------------------------------------635 //--------------------------------------------------------------------------------------------------648 //--------------------------------------------------------------------------------------------------661 //--------------------------------------------------------------------------------------------------670 //--------------------------------------------------------------------------------------------------681 //--------------------------------------------------------------------------------------------------691 //--------------------------------------------------------------------------------------------------700 //--------------------------------------------------------------------------------------------------709 //--------------------------------------------------------------------------------------------------719 //--------------------------------------------------------------------------------------------------729 //--------------------------------------------------------------------------------------------------736 //--------------------------------------------------------------------------------------------------745 //--------------------------------------------------------------------------------------------------758 //--------------------------------------------------------------------------------------------------767 //--------------------------------------------------------------------------------------------------782 //--------------------------------------------------------------------------------------------------790 //--------------------------------------------------------------------------------------------------797 //--------------------------------------------------------------------------------------------------805 //--------------------------------------------------------------------------------------------------812 //--------------------------------------------------------------------------------------------------815 * All unknown AT commands will be sent on this alternative file descriptor thanks to the AT client822 //--------------------------------------------------------------------------------------------------829 //--------------------------------------------------------------------------------------------------838 //--------------------------------------------------------------------------------------------------845 //--------------------------------------------------------------------------------------------------854 //--------------------------------------------------------------------------------------------------863 //--------------------------------------------------------------------------------------------------873 //--------------------------------------------------------------------------------------------------882 //--------------------------------------------------------------------------------------------------886 //--------------------------------------------------------------------------------------------------892 //--------------------------------------------------------------------------------------------------896 //--------------------------------------------------------------------------------------------------902 //--------------------------------------------------------------------------------------------------906 //--------------------------------------------------------------------------------------------------912 //--------------------------------------------------------------------------------------------------923 //--------------------------------------------------------------------------------------------------932 //--------------------------------------------------------------------------------------------------940 //--------------------------------------------------------------------------------------------------947 //--------------------------------------------------------------------------------------------------955 //--------------------------------------------------------------------------------------------------964 //--------------------------------------------------------------------------------------------------974 //--------------------------------------------------------------------------------------------------le_result_t le_atServer_Close(le_atServer_DeviceRef_t device)void(* le_atServer_DisconnectHandler_t)(void *)Definition: le_atServer_interface.h:297le_result_t le_atServer_TryConnectService(void)le_result_t le_atServer_RemoveDeviceFromBridge(le_atServer_DeviceRef_t deviceRef, le_atServer_BridgeRef_t bridgeRef)void le_atServer_EnableExtendedErrorCodes(void)le_result_t le_atServer_SendStoredUnsolicitedResponses(le_atServer_CmdRef_t commandRef)le_result_t le_atServer_GetParameter(le_atServer_CmdRef_t commandRef, uint32_t index, char *parameter, size_t parameterSize)le_result_t le_atServer_GetCommandName(le_atServer_CmdRef_t commandRef, char *name, size_t nameSize)le_atServer_CmdRegistrationHandlerRef_t le_atServer_AddCmdRegistrationHandler(le_atServer_CmdRegistrationHandlerFunc_t handlerPtr, void *contextPtr)le_result_t le_atServer_GetDevice(le_atServer_CmdRef_t commandRef, le_atServer_DeviceRef_t *deviceRefPtr)le_result_t le_atServer_SetVerboseErrorCode(le_atServer_ErrorCodeRef_t errorCodeRef, const char *LE_NONNULL verboseCode)le_result_t le_atServer_EnableEcho(le_atServer_DeviceRef_t device)le_atServer_CommandHandlerRef_t le_atServer_AddCommandHandler(le_atServer_CmdRef_t commandRef, le_atServer_CommandHandlerFunc_t handlerPtr, void *contextPtr)le_atServer_DeviceRef_t le_atServer_Open(int fd)le_atServer_CmdRef_t le_atServer_Create(const char *LE_NONNULL name)void le_atServer_ConnectService(void)le_result_t le_atServer_AddDeviceToBridge(le_atServer_DeviceRef_t deviceRef, le_atServer_BridgeRef_t bridgeRef)le_result_t le_atServer_Resume(le_atServer_DeviceRef_t device)le_result_t le_atServer_Delete(le_atServer_CmdRef_t commandRef)le_result_t le_atServer_CloseBridge(le_atServer_BridgeRef_t bridgeRef)LE_FULL_API void le_atServer_SetServerDisconnectHandler(le_atServer_DisconnectHandler_t disconnectHandler, void *contextPtr)void le_atServer_EnableVerboseErrorCodes(void)void le_atServer_RemoveCommandHandler(le_atServer_CommandHandlerRef_t handlerRef)le_result_t le_atServer_Suspend(le_atServer_DeviceRef_t device)le_result_t le_atServer_GetTextAsync(le_atServer_CmdRef_t cmdRef, le_atServer_GetTextCallbackFunc_t callbackPtr, void *contextPtr)void le_atServer_RemoveCmdRegistrationHandler(le_atServer_CmdRegistrationHandlerRef_t handlerRef)void le_atServer_DisableExtendedErrorCodes(void)le_result_t le_atServer_SendIntermediateResponse(le_atServer_CmdRef_t commandRef, const char *LE_NONNULL intermediateRsp)le_atServer_ErrorCodeRef_t le_atServer_CreateErrorCode(uint32_t errorCode, const char *LE_NONNULL pattern)void le_atServer_DisconnectService(void)le_result_t le_atServer_SendUnsolicitedResponse(const char *LE_NONNULL unsolRsp, le_atServer_AvailableDevice_t availableDevice, le_atServer_DeviceRef_t device)le_result_t le_atServer_DisableEcho(le_atServer_DeviceRef_t device)le_result_t le_atServer_SendFinalResultCode(le_atServer_CmdRef_t commandRef, le_atServer_FinalRsp_t finalResult, const char *LE_NONNULL pattern, uint32_t errorCode)le_atServer_BridgeRef_t le_atServer_OpenBridge(int fd)le_result_t le_atServer_DeleteErrorCode(le_atServer_ErrorCodeRef_t errorCodeRef)