mirror of git://git.sysmocom.de/ofono
Add some initial API documents
This commit is contained in:
parent
19858da361
commit
c5bee783fa
|
@ -1,5 +1,6 @@
|
|||
man_MANS = ofonod.8
|
||||
|
||||
EXTRA_DIST = overview.txt $(man_MANS)
|
||||
EXTRA_DIST = $(man_MANS) overview.txt \
|
||||
manager-api.txt modem-api.txt network-api.txt
|
||||
|
||||
MAINTAINERCLEANFILES = Makefile.in
|
||||
|
|
|
@ -0,0 +1,22 @@
|
|||
Manager hierarchy
|
||||
=================
|
||||
|
||||
Service org.ofono
|
||||
Interface org.ofono.Manager
|
||||
Object path /
|
||||
|
||||
Methods dict GetProperties()
|
||||
|
||||
Returns all global system properties. See the
|
||||
properties section for available properties.
|
||||
|
||||
Possible Errors: [service].Error.InvalidArguments
|
||||
|
||||
Signals PropertyChanged(string property, variant value)
|
||||
|
||||
This signal indicates a changed value of the given
|
||||
property.
|
||||
|
||||
Properties array{object} Modems [readonly]
|
||||
|
||||
List of all modem objects in the system.
|
|
@ -0,0 +1,54 @@
|
|||
Modem hierarchy
|
||||
===============
|
||||
|
||||
Service org.ofono
|
||||
Interface org.ofono.Modem
|
||||
Object path [variable prefix]/{modem0,modem1,...}
|
||||
|
||||
Methods dict GetProperties()
|
||||
|
||||
Returns properties for the modem object. See
|
||||
the properties section for available properties.
|
||||
|
||||
Possible Errors: [service].Error.InvalidArguments
|
||||
|
||||
Signals PropertyChanged(string name, variant value)
|
||||
|
||||
This signal indicates a changed value of the given
|
||||
property.
|
||||
|
||||
Properties string Manufacturer [readonly, optional]
|
||||
|
||||
String representing the manufacturer of the modem
|
||||
device.
|
||||
|
||||
This is usually obtained by the +CGMI AT command.
|
||||
|
||||
string Model [readonly, optional]
|
||||
|
||||
String representing the model of the modem device.
|
||||
|
||||
This is usually obtained by the +CGMM AT command.
|
||||
|
||||
string Revision [readonly, optional]
|
||||
|
||||
String representing the revision of the modem device.
|
||||
|
||||
This is usually obtained by using the +CGMR AT command.
|
||||
|
||||
string Serial [readonly, optional]
|
||||
|
||||
String represeting the serial number of the modem
|
||||
device.
|
||||
|
||||
This is usually obtained by using the +CGSN AT command.
|
||||
|
||||
array{string} Interfaces [readonly]
|
||||
|
||||
Set of interfaces currently supported by the mode
|
||||
device. The set depends on the state of the device
|
||||
(registration status, SIM inserted status,
|
||||
network capabilities, device capabilities, etc.)
|
||||
|
||||
TODO: Better to split this into Status and
|
||||
Capabilites properties?
|
|
@ -0,0 +1,179 @@
|
|||
Network registration hierarchy
|
||||
==============================
|
||||
|
||||
Service org.ofono
|
||||
Interface org.ofono.NetworkRegistration
|
||||
Object path [variable prefix]/{modem0,modem1,...}
|
||||
|
||||
Methods dict GetProperties()
|
||||
|
||||
Returns all network registration properties. See the
|
||||
properties section for available properties.
|
||||
|
||||
Possible Errors: [service].Error.InvalidArguments
|
||||
|
||||
void SetProperty(string name, variant value)
|
||||
|
||||
Changes the value of the specified property. Only
|
||||
properties that are listed as read-write are
|
||||
changeable. On success a PropertyChanged signal
|
||||
will be emitted.
|
||||
|
||||
Possible Errors: [service].Error.InvalidArguments
|
||||
[service].Error.DoesNotExist
|
||||
|
||||
void Register()
|
||||
|
||||
Attempts to register to the default network. The
|
||||
default network is normally selected by the settings
|
||||
from the SIM card.
|
||||
|
||||
Possible Errors: [service].Error.InvalidArguments
|
||||
|
||||
void Deregister()
|
||||
|
||||
Completely unregisters from the network
|
||||
|
||||
Possible Errors: [service].Error.InvalidArguments
|
||||
|
||||
Signals PropertyChanged(string property, variant value)
|
||||
|
||||
This signal indicates a changed value of the given
|
||||
property.
|
||||
|
||||
Properties string Mode [readwrite]
|
||||
|
||||
The current registration mode. The deault of this
|
||||
is "auto", but can be changed during operation. This
|
||||
property will change to "manual" if the Register()
|
||||
method of an operator is called.
|
||||
|
||||
The possible values are:
|
||||
"auto" Network registration is performed
|
||||
automatically.
|
||||
"manual" Network operator is selected
|
||||
manually. If the operator is
|
||||
currently not selected, registration
|
||||
is notattempted
|
||||
"off" Unregisters from currently selected
|
||||
network, if any, and does not
|
||||
attempt to register again.
|
||||
|
||||
string Status [readonly]
|
||||
|
||||
The current registration status of a modem.
|
||||
|
||||
The possible values are:
|
||||
"unregistered" Not registered to any network
|
||||
"registered" Registered to home network
|
||||
"searching" Not registered, but searching
|
||||
"denied" Registration has been denied
|
||||
"unknown" Status is unknown
|
||||
"roaming" Registered, but roaming
|
||||
|
||||
uint16 LocationAreaCode [readonly, optional]
|
||||
|
||||
Contains the current location area code.
|
||||
|
||||
TODO: Agent based location signalling would be better.
|
||||
|
||||
uint32 CellId [readonly, optional]
|
||||
|
||||
Contains the current network cell id.
|
||||
|
||||
TODO: Agent based location signalling would be better.
|
||||
|
||||
string Technology [readonly, optional]
|
||||
|
||||
Contains the technology of the current network.
|
||||
|
||||
The possible values are: "GSM", "GSMCompact", "UTRAN",
|
||||
"GSM+EGPS", "UTRAN+HSDPA",
|
||||
"UTRAN+HSUPA",
|
||||
"UTRAN+HSDPA+HSUPA"
|
||||
|
||||
TODO: Values for CDMA and EVDO based networks.
|
||||
|
||||
string Name [readonly]
|
||||
|
||||
Contains the current operator name, suitable for
|
||||
display on the idle screen or an empty string if
|
||||
not registered to a network.
|
||||
|
||||
This value is idential to the Name property from
|
||||
the network operator object. It is provided here
|
||||
for simplicity of application that don't allow
|
||||
manual registration.
|
||||
|
||||
byte Strength [readonly, optional]
|
||||
|
||||
Contains the current signal strength as a percentage
|
||||
between 0-100 percent.
|
||||
|
||||
array{object} Operators [readonly]
|
||||
|
||||
List of all operator object paths known to the
|
||||
telephony stack. The scanning for new operators is
|
||||
done in the background.
|
||||
|
||||
The list of operators is only useful when attempting
|
||||
manual registration. The automatic registration is
|
||||
the preferred method.
|
||||
|
||||
|
||||
Network operator hierarchy
|
||||
==========================
|
||||
|
||||
Service org.ofono
|
||||
Interface org.ofono.NetworkOperator
|
||||
Object path [variable prefix]/{modem0,modem1,...}/{operator0,operator1,...}
|
||||
|
||||
Methods dict GetProperties()
|
||||
|
||||
Returns all network operator properties. See the
|
||||
properties section for available properties.
|
||||
|
||||
Possible Errors: [service].Error.InvalidArguments
|
||||
|
||||
void Register()
|
||||
|
||||
Attempts to register to this network operator.
|
||||
|
||||
The method will return immediately, the result should
|
||||
be observed by tracking the NetworkRegistration Status
|
||||
property.
|
||||
|
||||
Possible Errors: [service].Error.InvalidArguments
|
||||
|
||||
Signals PropertyChanged(string property, variant value)
|
||||
|
||||
This signal indicates a changed value of the given
|
||||
property.
|
||||
|
||||
Properties string Name [readonly]
|
||||
|
||||
Contains the name of the operator
|
||||
|
||||
string Status [readonly]
|
||||
|
||||
Contains the status of the operator.
|
||||
|
||||
The possible values are: "unknown", "available",
|
||||
"current" and "forbidden"
|
||||
|
||||
uint16 MobileCountryCode [readonly, optional]
|
||||
|
||||
Contains the Mobile Country Code (MCC).
|
||||
|
||||
uint16 MobileNetworkCode [readonly, optional]
|
||||
|
||||
Contains the Mobile Network Code (MNC)
|
||||
|
||||
string Technology [readonly, optional]
|
||||
|
||||
Contains the technology of the network provider.
|
||||
|
||||
The possible values are: "GSM", "GSMCompact", "UTRAN",
|
||||
"GSM+EGPS", "UTRAN+HSDPA",
|
||||
"UTRAN+HSUPA",
|
||||
"UTRAN+HSDPA+HSUPA"
|
Loading…
Reference in New Issue