Package: android.hardware.gnss@1.0

IAGnssRil

interface IAGnssRil

Extended interface for AGNSS RIL support.An Assisted GNSS Radio Interface Layer interface allows the GNSS chipset to request radio interface layer information from Android platform.Examples of such information are reference location, unique subscriber ID, phone number string and network availability changes.

Properties

SetIDType

enum SetIDType: uint8_t
Details
Members
NONE = 0
IMSI = 1
MSISDM = 2
Annotations
export
name="" , value_prefix="AGPS_SETID_TYPE_"

NetworkType

enum NetworkType: uint8_t
Details
Members
MOBILE = 0
WIFI = 1
MMS = 2
SUPL = 3
DUN = 4
HIPRI = 5
WIMAX = 6
Annotations
export
name="" , value_prefix="AGPS_RIL_NETWORK_TYPE_"

AGnssRefLocationType

enum AGnssRefLocationType: uint8_t
Details
Members
GSM_CELLID = 1
UMTS_CELLID = 2
LTE_CELLID = 4
Annotations
export
name="" , value_prefix="AGPS_REF_LOCATION_TYPE_"

AGnssRefLocationCellID

struct AGnssRefLocationCellID {AGnssRefLocationType type; uint16_t mcc; uint16_t mnc; uint16_t lac; uint32_t cid; uint16_t tac; uint16_t pcid}

CellID for 2G, 3G and LTE, used in AGNSS.

Details
Members
type
mcc
Mobile Country Code.
mnc
Mobile Network Code.
lac
Location Area Code in 2G, 3G and LTE.In 3G lac is discarded.In LTE, lac is populated with tac, to ensure that we don't break old clients that might rely in the old(wrong)behavior.
cid
Cell id in 2G.Utran Cell id in 3G.Cell Global Id EUTRA in LTE.
tac
Tracking Area Code in LTE.
pcid
Physical Cell id in LTE(not used in 2G and 3G )

AGnssRefLocation

struct AGnssRefLocation {AGnssRefLocationType type; AGnssRefLocationCellID cellID}

Represents ref locations

Details
Members
type
cellID

Methods

setCallback

setCallback (IAGnssRilCallback callback)

Opens the AGNSS interface and provides the callback routines to the implementation of this interface.

Details
Parameters
callback
Interface for AGnssRil callbacks.

setRefLocation

setRefLocation (AGnssRefLocation agnssReflocation)

Sets the reference location.

Details
Parameters
agnssReflocation
AGNSS reference location CellID.

setSetId

setSetId (SetIDType type, string setid)
generates (bool success)

Sets the SET ID.

Details
Parameters
type
Must be populated with either IMSI or MSISDN or NONE.
setid
If type is IMSI then setid is populated with a string representing the unique Subscriber ID, for example, the IMSI for a GMS phone.If type is MSISDN, then setid must contain the phone number string for line 1.For example, the MSISDN for a GSM phone.If the type is NONE, then the string must be empty.
Generates
success
True if all parameters were valid and operation was successful.

updateNetworkState

updateNetworkState (bool connected, NetworkType type, bool roaming)
generates (bool success)

Notify GNSS of network status changes.

Details
Parameters
connected
Indicates whether network connectivity exists and it is possible to establish connections and pass data.
type
Indicates the kind of network, for eg.mobile, wifi etc.
roaming
Indicates whether the device is currently roaming on this network.
Generates
success
True is all parameters were valid and operation was successful.

updateNetworkAvailability

updateNetworkAvailability (bool available, string apn)
generates (bool success)

Notify GNSS of network status changes and current APN.

Details
Parameters
available
Indicates whether network connectivity is available.
apn
String containing the telephony preferred Access Point Name.
Generates
success
True if all parameters were valid and the operation was successful.