SDK-Overview
Overview
The Telematics library runs in the user space of the Linux system. It interacts with Telephony services and other sub-systems to provide various services like phone calls, SMS etc. These services are exposed by the SDK through fixed public APIs that are available on all Telematics platforms that support SDK. The Telematics APIs are grouped into the following functional modules:
Telephony
Telephony sub-system consists of APIs for functions related to Phone, Call, SMS and Signal Strength.
SIM Card Services
SIM Card services sub-system consists of APIs to perform SIM card operations such as Send APDU messages to SIM card applications, SIM Access Profile(SAP) operations etc.
Location Services
Location Services sub-system consists of APIs to receive location details such as GNSS Positions, Satellite Vehicle information etc.
Connection Management
Connection Management sub-system consists of APIs for establishing Cellular WAN/ Backhaul connection sessions and for Connection Profile Management etc.
Telematics SDK classes can be broadly divided into the following types:
- Factory - Factory classes are central classes such as PhoneFactory which can be used to create Manager classes corresponding to their sub-systems such as PhoneManager.
- Manager - Manager classes such as PhoneManager to manage multiple Phone instances, CardManager to manage multiple SIM Card instances etc.
- Observer/ Listener - Listener for unsolicited responses.
- Command Callback - Single-shot response callback for asynchronous API requests.
- Logger - APIs to log messages, control the log levels.
Features
Telematics SDK provides APIs for the following features:
Call Management
CallManager, Phone and PhoneManager APIs of Telematics SDK provides call related control operations such as
- Initiate a voice call
- Answer the incoming call
- Hold the call
- Hangup waiting, held or active call
CallManager and PhoneManager also provides additional functionality such as
- Allowing conference, and switch between waiting or holding call and active call
- Emergency Call (dial 112)
- Notifications about call state change
SMS
SMS Manager APIs of Telematics SDK provides SMS related functionality such as
- Sends and receives SMS messages of type GSM7, GSM8 and UCS2
SIM Card Services
The SIM Card operations are performed by CardManager and SapCardManager.
CardManager APIs of Telematics SDK perform operations on UICC card such as
- Open or close logical/basic channel to ICC card
- Transmit Application Protocol Data Unit (APDU) to the ICC Card over logical/basic channel
- Receive response APDU from the ICC Card with the status
- Notify about ICC card information change
SapCardManager APIs provides SIM Access Profile(SAP) related functionality such as
- Open or close SIM Access Profile(SAP) connection
- Transmit Application Protocol Data Unit (APDU) over SAP connection
- Receive response APDU over SAP connection
- Perform SAP operations such as Answer to Reset(ATR), SIM Power off, SIM Power On, SIM Reset and fetch Card Reader status.
Phone Information
Phone APIs of Telematics SDK provides phone related information such as
- Get Service state of phone i.e. EMERGENCY_ONLY, IN_SERVICE and OUT_OF_SERVICE
- Get Radio state of device i.e RADIO_STATE_OFF, RADIO_STATE_ON and RADIO_STATE_UNAVAILABLE
- Retrieve the signal strength corresponding to the technology supported by SIM
- Device Identity
- Subscription Information
Location Services
Location Services APIs of Telematics SDK provide the mechanism to register listener and to receive location updates and satellite vehicle information. Following parameters are configurable through the APIs.
- Minimum time interval between two consecutive location reports.
- Timeout period for location reports.
- Horizontal accuracy level.