The Network interface is used to give information about the GSM service providers and this device's status with regards to to network registration and connectivity. Taxonomy note: We think in terms of (service) providers rather than (network) operators, since multiple (service) providers can use the networks from operators, however what actually matters most is the provider name, not the actual network operator the provider is using.
org.freesmartphone.GSM.Network
Description: Register with any available service provider.
This maps to the GSM 07.07 command +COPS=0, see 3GPP TS 07.07 Chapter 7.3.
Description: Unregister from service provider.
This maps to the GSM 07.07 command +COPS=2, see 3GPP TS 07.07 Chapter 7.3.
Description: Get Network Status.
This can map to the following GSM 07.07 commands:
Network status information. Mandatory tuples are:
Description: Query the current signal strength, if registered with a service provider.
This maps to the GSM 07.07 command +CSQ, see 3GPP TS 07.07 Chapter 8.5.
The signal strength in percent (0-100).
Description: List available service providers.
This maps to the GSM 07.07 command +COPS=?, see 3GPP TS 07.07 Chapter 7.3.
An array of four-tuples with the following structure:
Description: Register to a dedicated service provider.
This maps to the GSM 07.07 command +COPS=1..., see 3GPP TS 07.07 Chapter 7.3.
The operator code.
Description: Compute the country information of the current service provider. Will raise NotFound if not registered to any service provider.
This maps to the GSM 07.07 command +COPS?, see 3GPP TS 07.07 Chapter 5.6. Get the dial code by cross-referencing ITU E.212 (Land Mobile Numbering Plan).
The country dial code (including the +).
s: country_nameThe name of the country.
Description: Get the network call forwarding status.
This maps to the GSM 07.07 command +CCFC=(reason),2, see 3GPP TS 07.07 Chapter 7.10.
Reason for which you want to enable network call forwarding. Valid reasons are:
A dictionary containing entries for call classes. Expected classes are:
Description: Enable network call forwarding.
This maps to the GSM 07.07 command +CCFC=(...),3, see 3GPP TS 07.07 Chapter 7.10.
The reason for which you want to enable network call forwarding. See GetCallForwarding for valid reasons.
s: classThe call class for which you want to enable network call forwarding. See GetCallForwarding for valid classes.
s: numberThe phone number to which the network call will be forwarded.
i: timeoutThe number of seconds, after which network call forwarding launches (only valid for reason "no reply").
Description: Disable network call forwarding.
This maps to the GSM 07.07 command +CCFC=(...),4, see 3GPP TS 07.07 Chapter 7.10.
The reason for which you want to enable network call forwarding. See GetCallForwarding for valid reasons.
s: classCall class for which the network call gets forwarded. See GetCallForwarding for valid classes.
Description: Set whether your subscriber number is visible during a call.
This maps to the GSM 07.07 command +CLIR=(value), see 3GPP TS 07.07 Chapter 7.7.
One of the following values:
Description: Get whether your subscriber number is visible during a call.
This maps to the GSM 07.07 command +CLIR?, see 3GPP TS 07.07 Chapter 7.7.
One of the following values:
Description: Send an Unstructured Supplementary Service Data (USSD) request to the network. Responses will be delivered via the signal IncomingUssd
This can map to the GSM 07.07 command +CUSD=1,"(request)",(code), see 3GPP TS 07.07 Chapter 7.14.
The request to be sent to the network.
Description: Sent, when the network registration status changes.
The registration status. See GetStatus for expected values.
Description: (OPTIONAL) Sent, when registered with a service provider and the network signal strength changes.
The signal strength in percent (0-100).
Description: Sent, when an USSD result or a network initiated request arrives. This signal is usually sent in response to the method SendUssdRequest
The message mode. Valid values are:
The message. Only set if mode is "completed" or "useraction". "", otherwise.
Description: Sent, when the network reports a change in GSM or GPRS cipher indication. Only few modems support forwarding this to the AT command layer, hence implementation of this signal is optional.
The GSM cipher: "enabled", "disabled", or "unknown"
s: gprsThe GPRS cipher: "enabled", "disabled", or "unknown"
Description: Raised, if no network service is available.
Description: Raised, if registering with the specified network is not possible.
Description: Raised, if the requested network operation is not supported.
Description: Raised, if a requested network provider is not present.