Click here for the API Reference documentation.

Data Profiles
Data Sessions
Data Statistics

A data session is useful for applications that need to send or receive data over a network where SMS messages are insufficient. To start a data session, a data profile must be configured as specified by the target network.

The Modem Data Control (mdc) API is used to manage data profiles and data sessions.

Data Profiles

If a pre-defined data profile has been configured then this profile can be loaded using le_mdc_GetProfile. The maximum number of data profiles supported is modem dependent and can be retrieved with le_mdc_NumProfiles.

The following data profile parameters can be retrieved:

Packet Data Protocol using le_mdc_GetPDP.
Access Point Name using le_mdc_GetAPN.
Authentication settings using le_mdc_GetAuthentication.

The following data profile parameters can be set:

Packet Data Protocol using le_mdc_SetPDP.
Access Point Name using le_mdc_SetAPN.
Authentication settings using le_mdc_SetAuthentication.

Data Sessions

A data session can be started using le_mdc_StartSession. To start a data session, a data profile must be created and written to the modem, or an existing data profile can be used. A data session can be stopped using le_mdc_StopSession. The number of simultaneous data sessions supported is dependent on the modem, but cannot be more than the maximum number of supported profiles.

The current state of a data session can be queried using le_mdc_GetSessionState. An application can also a register handler to be notified when the session state changes. The handler can be managed using le_mdc_AddSessionStateHandler and le_mdc_RemoveSessionStateHandler.

Once a data session starts, a Linux network interface is created. It's the application's responsibility to configure the network interface, usually through a DHCP client. Query the interface name using le_mdc_GetInterfaceName. The IP Preference can be checked with le_mdc_IsIPv4 or le_mdc_IsIPv6 when the profile is connected. The IP address for the current data session can be retreived by le_mdc_GetIPv4Address or le_mdc_GetIPv6Address. The Gateway and DNS addresses can be retrieved using le_mdc_GetIPv4GatewayAddress, le_mdc_GetIPv4DNSAddresses or le_mdc_GetIPv6GatewayAddress, le_mdc_GetIPv6DNSAddresses. The Access Point Name can be retrieved by le_mdc_GetAPN. The Data bearer Technology can be retreived by le_mdc_GetDataBearerTechnology.

Data Statistics

Data bytes received/transmitted can be access through le_mdc_GetBytesCounters. These values correspond to the number of bytes received/transmitted since the last software reset or the last le_mdc_ResetBytesCounter called. Making these value persistent after a software reboot is the client responsibility.