From 8c1430763f52b7b297291808452d1bc53d3b5be1 Mon Sep 17 00:00:00 2001
From: Aleksander Morgado Found networks. It's an array of dictionaries (strings for both
- keys and values) with each array element describing a mobile network
- found in the scan. Each dict may include one or more of the following
- keys:
For capability reporting, indicates the device is capable of - providing GPS NMEA-format location information.
+ providing GPS NMEA-format location information.For location reporting, devices supporting this capability return - a string containing one or more NMEA sentences (D-Bus signature 's'). - The manager will cache the most recent NMEA sentence of each type for - a period of time not less than 30 seconds. When reporting multiple - NMEA sentences, sentences shall be separated by an ASCII Carriage - Return and Line Feed (<CR><LF>) sequence. + a string containing one or more NMEA sentences (D-Bus signature 's'). + The manager will cache the most recent NMEA sentence of each type for + a period of time not less than 30 seconds. When reporting multiple + NMEA sentences, sentences shall be separated by an ASCII Carriage + Return and Line Feed (<CR><LF>) sequence.
- For example, if the device sends a $GPRMC sentence immediately - followed by a $GPGGA sentence, the reported location string would be - (where of course the <CR><LF> is replaced with the actual - ASCII CR (0x0D) and LF (0x0A) control characters): -
- $GPRMC,134523.92,V,,,,,,,030136,,,N*73<CR><LF>$GPGGA,,,,,,0,00,0.5,,M,0.0001999,M,0.0000099,0000*45 -- If the device sends a new $GPRMC three seconds later, the new $GPRMC - replaces the previously received $GPRMC sentence, and the updated - string would be: -
- $GPRMC,134526.92,V,,,,,,,030136,,,N*76<CR><LF>$GPGGA,,,,,,0,00,0.5,,M,0.0001999,M,0.0000099,0000*45 -- If the device then sends a $GPGSA sentence about 5 seconds later, the - $GPGSA sentence is added to the string (since no $GPGSA sentence was - previously received in this session), the updated string would be: -
- $GPRMC,134526.92,V,,,,,,,030136,,,N*76<CR><LF>$GPGGA,,,,,,0,00,0.5,,M,0.0001999,M,0.0000099,0000*45<CR><LF>$GPGSA,A,1,,,,,,,,,,,,,1.1,0.5,1.0*34 -- The manager may discard any cached sentences older than 30 seconds. + For example, if the device sends a $GPRMC sentence immediately + followed by a $GPGGA sentence, the reported location string would be + (where of course the <CR><LF> is replaced with the actual + ASCII CR (0x0D) and LF (0x0A) control characters): +
+ $GPRMC,134523.92,V,,,,,,,030136,,,N*73<CR><LF>$GPGGA,,,,,,0,00,0.5,,M,0.0001999,M,0.0000099,0000*45 ++ If the device sends a new $GPRMC three seconds later, the new $GPRMC + replaces the previously received $GPRMC sentence, and the updated + string would be: +
+ $GPRMC,134526.92,V,,,,,,,030136,,,N*76<CR><LF>$GPGGA,,,,,,0,00,0.5,,M,0.0001999,M,0.0000099,0000*45 ++ If the device then sends a $GPGSA sentence about 5 seconds later, the + $GPGSA sentence is added to the string (since no $GPGSA sentence was + previously received in this session), the updated string would be: +
+ $GPRMC,134526.92,V,,,,,,,030136,,,N*76<CR><LF>$GPGGA,,,,,,0,00,0.5,,M,0.0001999,M,0.0000099,0000*45<CR><LF>$GPGSA,A,1,,,,,,,,,,,,,1.1,0.5,1.0*34 ++ The manager may discard any cached sentences older than 30 seconds.
This allows clients to read the latest positioning data as soon as - possible after they start, even if the device is not providing - frequent location data updates. + possible after they start, even if the device is not providing + frequent location data updates.
For capability reporting, indicates the device is capable of - providing GSM Location Area Code/Cell ID location information.
+ providing GSM Location Area Code/Cell ID location information.For location reporting, devices supporting this - capability return a string in the format "MCC,MNC,LAC,CI" (without the - quotes of course) where the following applies:
+ capability return a string in the format "MCC,MNC,LAC,CI" (without the + quotes of course) where the following applies:The entire string may only be composed of the ASCII digits [0-9], - the alphabetical characters [A-F], and the comma (,) character. No - other characters are allowed. For example: "310,260,8BE3,2BAF" or - "250,40,CE00,1CEAD8F0".
+The entire string may only be composed of the ASCII digits [0-9], + the alphabetical characters [A-F], and the comma (,) character. No + other characters are allowed. For example: "310,260,8BE3,2BAF" or + "250,40,CE00,1CEAD8F0".
If any of these four items (MCC,MNC,LAC,CI) is unknown or the - mobile is not registered with a network, then the GSM_LAC_CI location - information item should not be provided as a returned value from the - GetLocation() method or in the Location property.
+ mobile is not registered with a network, then the GSM_LAC_CI location + information item should not be provided as a returned value from the + GetLocation() method or in the Location property.For capability reporting, indicates the device is capable of - providing raw GPS information using a series of defined key/value - pairs.
+ providing raw GPS information using a series of defined key/value + pairs.For location reporting, devices supporting this - capability return a D-Bus dict (signature a{sv}) mapping well-known - keys to values with defined formats. The allowed key/value pairs - and their formats are:
+ capability return a D-Bus dict (signature a{sv}) mapping well-known + keys to values with defined formats. The allowed key/value pairs + and their formats are:| Key | Value Type | Value contents | Example |
|---|---|---|---|
The 'latitude' and 'longitude' keys are required; other keys are - optional.
+ optional.