Telematics SDK - API Reference
v1.51.0
|
Data Structures | |
class | telux::config::ConfigFactory |
ConfigFactory allows creation of config related classes. More... | |
struct | telux::config::ConfigInfo |
class | telux::config::IModemConfigListener |
Listener class for getting notifications related to configuration change detection. The client needs to implement these methods as briefly as possible and avoid blocking calls in it. The methods in this class can be invoked from multiple different threads. Client needs to make sure that the implementation is thread-safe. More... | |
class | telux::config::IModemConfigManager |
IModemConfigManager provides interface to list config files present in modem's storage. load a new config file in modem, activate a config file, get active config file information, deactivate a config file, delete config file from the modem's storage, get and set mode of config auto selection, register and deregister listener for config update in modem. The config files are also referred to as MBNs. More... | |
Typedefs | |
using | telux::config::ConfigId = std::string |
using | telux::config::ConfigListCallback = std::function< void(std::vector< ConfigInfo > configList, telux::common::ErrorCode error)> |
using | telux::config::GetAutoSelectionModeCallback = std::function< void(AutoSelectionMode mode, telux::common::ErrorCode error)> |
using | telux::config::GetActiveConfigCallback = std::function< void(ConfigInfo configInfo, telux::common::ErrorCode error)> |
This section contains APIs related to Modem Config operations.
class telux::config::ConfigFactory |
ConfigFactory allows creation of config related classes.
Public Member Functions | |
virtual std::shared_ptr< IModemConfigManager > | getModemConfigManager (telux::common::InitResponseCb callback=nullptr)=0 |
Static Public Member Functions | |
static ConfigFactory & | getInstance () |
|
static |
Get instance of Config Factory
|
pure virtual |
Get instance of ModemConfig manager
On platforms with Access control enabled, Caller needs to have TELUX_CONFIG_MODEM_CONFIG permission to invoke this API successfully.
[in] | callback | Optional callback to get the response of Modem Config Manager initialization. |
struct telux::config::ConfigInfo |
Data Fields | ||
---|---|---|
ConfigId | id |
id - stores the id of the configuration type - stores config type size - stores the size of the configuration desc - stores the configuration description version - stores version of the config file |
ConfigType | type | |
uint32_t | size | |
string | desc | |
uint32_t | version |
class telux::config::IModemConfigListener |
Listener class for getting notifications related to configuration change detection. The client needs to implement these methods as briefly as possible and avoid blocking calls in it. The methods in this class can be invoked from multiple different threads. Client needs to make sure that the implementation is thread-safe.
Public Member Functions | |
virtual void | onConfigUpdateStatus (ConfigUpdateStatus status, int slotId) |
virtual | ~IModemConfigListener () |
Public Member Functions inherited from telux::common::IServiceStatusListener | |
virtual void | onServiceStatusChange (ServiceStatus status) |
virtual | ~IServiceStatusListener () |
|
virtual |
Destructor of IModemConfigListener
|
virtual |
This function is called when a configuration update is detected. It is applicable only to SOFTWARE config.
[in] | status | update status of config. |
[in] | slotId | slotId where update is detected. |
class telux::config::IModemConfigManager |
IModemConfigManager provides interface to list config files present in modem's storage. load a new config file in modem, activate a config file, get active config file information, deactivate a config file, delete config file from the modem's storage, get and set mode of config auto selection, register and deregister listener for config update in modem. The config files are also referred to as MBNs.
|
virtual |
Destructor of IModemConfigManager
|
pure virtual |
Checks the status of modem config subsystem and returns the result.
|
pure virtual |
This status indicates whether the manager object is in a usable state or not.
|
pure virtual |
Wait for modem config subsystem to be ready.
|
pure virtual |
Fetching the list of config files present in modem's storage.
[in] | cb | - callback to the Response function. |
returns SUCCESS if the request to get config list is sent successfully.
|
pure virtual |
Loads a new config file into the modem's storage. This is a persistent operation. Only the config files loaded into the modem's storage can be activated.
[in] | filePath | - it defines the path to the config file. |
[in] | configType | - type of the config file. |
[in] | cb | - callback to the response function. |
returns SUCCESS if the request to load config file is sent successfully.
|
pure virtual |
Activates the config file on specified slot id. A file for activation must be loaded or should already be present in modem's storage.
[in] | configType | - type of the config file. |
[in] | configId | - id of the config file. |
[in] | slotId | - it defines the slot id to be selected. |
[in] | cb | - callback to the response function. |
|
pure virtual |
Get the currently active config file information for the specified slot id. In case default config files are activated, would return error.
[in] | configType | - type of the config file. |
[in] | cb | - callback to the response function. |
[in] | slotId | - it defines the slot id to be selected. |
|
pure virtual |
Deactivates the config file for the specified slot id.
[in] | configType | - type of the config file. |
[in] | slotId | - slot id to be selected for deactivation of config. |
[in] | cb | - callback to the response function. |
|
pure virtual |
Deletes the config file from the modem's storage.
[in] | configType | - type of the config file. |
[in] | configId | - id of the config file. This parameter is optional if not provided all the config files of the given config type are deleted from modem's storage. |
[in] | cb | - callback to the Response function. |
|
pure virtual |
Fetching the mode of config auto selection for specified slot id.
[in] | cb | - callback to the response function. |
[in] | slotId | - slot id of config. |
|
pure virtual |
Setting the mode of config auto selection for specified slot id.
[in] | mode | - auto selection mode status. |
[in] | slotId | - slot id of the config. |
[in] | cb | - callback to the response function. |
|
pure virtual |
Registeres the listener for indications.
[in] | listener | - pointer to implemented listener. |
|
pure virtual |
Deregisteres the listener from indications.
[in] | listener | - pointer to registered listener. |
using telux::config::ConfigId = typedef std::string |
using telux::config::ConfigListCallback = typedef std::function<void (std::vector<ConfigInfo> configList, telux::common::ErrorCode error)> |
This function is called as a response to requestConfigList().
[in] | configList | - Contains the list of config files in modem's storage. |
[in] | error | - Return code which indicates whether the operation succeeded or not. ErrorCode |
using telux::config::GetAutoSelectionModeCallback = typedef std::function<void (AutoSelectionMode mode, telux::common::ErrorCode error)> |
This function is called as a response to getAutoSelectionMode().
[in] | mode | - contains status of auto selection for configs. |
[in] | error | - Return code which indicates whether the operation succeeded or not. ErrorCode |
using telux::config::GetActiveConfigCallback = typedef std::function<void (ConfigInfo configInfo, telux::common::ErrorCode error)> |
This function is called as a response to getActiveConfig().
[in] | configInfo | - Information of active config file for specified slot id. |
[in] | error | - Return code which indicates whether the operation succeeded or not. ErrorCode |
|
strong |
|
strong |
|
strong |