diff --git a/Makefile.am b/Makefile.am index cde998dc..5916f68c 100644 --- a/Makefile.am +++ b/Makefile.am @@ -635,7 +635,8 @@ doc_files = doc/overview.txt doc/ofono-paper.txt doc/release-faq.txt \ doc/calypso-modem.txt doc/message-api.txt \ doc/location-reporting-api.txt \ doc/certification.txt doc/siri-api.txt \ - doc/telit-modem.txt + doc/telit-modem.txt \ + doc/networkmonitor-api.txt test_scripts = test/backtrace \ diff --git a/doc/networkmonitor-api.txt b/doc/networkmonitor-api.txt new file mode 100644 index 00000000..703f19bf --- /dev/null +++ b/doc/networkmonitor-api.txt @@ -0,0 +1,83 @@ +Network Monitor hierarchy +========================= + +Service org.ofono +Interface org.ofono.NetworkMonitor +Object path [variable prefix]/{modem0,modem1,...} + +Methods a{sv} GetServingCellInformation() + + Requests the latest serving cell information and basic + measurements from oFono. The returned value is a + dictionary with the possible key / values documented + below. The type of cell is given by the 'Technology' + property. + + Based on the type of cell, the dictionary will contain + additional key/value pairs. If a given key/value pair + is not present, then it is not known or unsupported + by the underlying driver. + + Refer to the sections below for which property types + are available, their valid value ranges and + applicability to different cell types. + + +Network Monitor Property Types +============================== + +string Technology + + Contains the cell type. Possible values are: + "gsm", "umts", "lte" + +uint16 LocationAreaCode [optional, gsm, umts] + + Contains the current location area code. Valid range of values is + 0-65535. + +uint32 CellId [optional, gsm, umts] + + Contains the current network cell id. Valid range of values is + 0-65535 for gsm and 0-268435455 in umts. + +string MobileNetworkCode [optional, gsm, umts] + + Contains the MNC of the cell. + +string MobileCountryCode [optional, gsm, umts] + + Contains the MCC of the cell. + +uint16 ARFCN [optional, gsm] + + Contains the Absolute Radio Frequency Channel Number. Valid range of + values is 0-1023. + +byte ReceivedSignalStrength [optional, gsm] + + Contains the received signal strength level in dBm. Refer to + in 27.007, Section 8.69 for more details. Valid range of values is + 0-63. + +byte BSIC [optional, gsm] + + Contains the Base Station Identity Code. Valid range of values is 0-63. + +byte BitErrorRate [optional, gsm] + + Contains the bit error rate. Refer to in 27.007, Section 8.69 + for more details. Valid range of values is 0-7. + +uint16 PrimaryScramblingCode [optional, umts] + + Contains the scrambling code. Valid range of values is 0-512. + +byte TimingAdvance [optional, gsm] + + Contains the Timing Advance. Valid range of values is 0-219. + +byte Strength [optional, gsm, umts] + + Contains the signal strength. Valid values are 0-31. Refer to + in 27.007, Section 8.5.