Register the device to network. The network ID to register. An empty string can be used to register to the home network. Scan for available networks.

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:

  • "status": a number representing network availability status as defined in 3GPP TS 27.007 section 7.3. e.g. "0" (unknown), "1" (available), "2" (current), or "3" (forbidden). This key will always be present.
  • "operator-long": long-format name of operator. If the name is unknown, this field should not be present.
  • "operator-short": short-format name of operator. If the name is unknown, this field should not be present.
  • "operator-num": mobile code of the operator. Returned in the format "MCCMNC", where MCC is the three-digit ITU E.212 Mobile Country Code and MNC is the two- or three-digit GSM Mobile Network Code. e.g. "31026" or "310260".
  • "access-tech": a number representing the access technology used by this mobile network as described in 3GPP TS 27.007 section 7.3. e.g. "0" (GSM), "1" (GSM Compact), "2" (UTRAN/UMTS), "3" (EDGE), etc.
Set the APN. The APN. Get the current signal quality. Signal quality (percent). Sets the band the device is allowed to use when connecting to a mobile network. The desired band. Only one band may be specified, and may not be UNKNOWN. Returns the current band the device is using. (Note for plugin writers: returned value must not be ANY) The current band. Set the desired mode the device may use when connecting to a mobile network (DEPRECATED; see SetAllowedMode instead). The desired network mode. Only one mode may be specified, and may not be UNKNOWN. Returns the current network mode of the device (DEPRECATED; does not allow returning both the saved mode preference *and* the current access technology of the device at the same time. See the AllowedMode property instead). Returns the general network mode (ex. 2G/3G preference) of the device. Get the registration status and the current operator (if registered). The returned information is composed of the following items in the following order:
  • Mobile registration status as defined in 3GPP TS 27.007 section 10.1.19. See the MM_MODEM_GSM_NETWORK_REG_STATUS enumeration for possible values.
  • Current operator code of the operator to which the mobile is currently registered. Returned in the format "MCCMNC", where MCC is the three-digit ITU E.212 Mobile Country Code and MNC is the two- or three-digit GSM Mobile Network Code. If the MCC and MNC are not known or the mobile is not registered to a mobile network, this value should be a zero-length (blank) string. e.g. "31026" or "310260".
  • Current operator name of the operator to which the mobile is currently registered. If the operator name is not knowon or the mobile is not registered to a mobile network, this value should be a zero-length (blank) string.
Set the access technologies a device is allowed to use when connecting to a mobile network. The allowed mode. The device may not support all modes; see the org.freedesktop.ModemManager.Gsm.Card.SupportedModes property for allowed modes for each device. All devices support the "ANY" flag. The allowed access technologies (eg 2G/3G preference) the device is allowed to use when connecting to a mobile network. The current network access technology used by the device to communicate with the base station. (Note to plugin writers: if the device's access technology cannot be determined, use UNKNOWN) The signal quality changed. The new quality in percent, 0..100. The registration status changed. Mobile registration status as defined in 3GPP TS 27.007 section 10.1.19. Current operator code of the operator to which the mobile is currently registered. Returned in the format "MCCMNC", where MCC is the three-digit ITU E.212 Mobile Country Code and MNC is the two- or three-digit GSM Mobile Network Code. If the MCC and MNC are not known or the mobile is not registered to a mobile network, this value should be a zero-length (blank) string. e.g. "31026" or "310260". Current operator name of the operator to which the mobile is currently registered. If the operator name is not knowon or the mobile is not registered to a mobile network, this value should be a zero-length (blank) string. The network mode preference changed. (DEPRECATED; see documentation for GetNetworkMode/SetNetworkMode) The new network mode. GSM registration code as defined in 3GPP TS 27.007 section 10.1.19. Not registered, not searching for new operator to register. Registered on home network. Not registered, searching for new operator to register with. Registration denied. Unknown registration status. Registered on a roaming network. DEPRECATED; should not be used in new applications. Use AccessTechnology, AllowedMode, and SetAllowedMode() instead. Any network mode can be used GPRS EDGE UMTS (3G) HSDPA Prefer 2G (GPRS or EDGE) Prefer 3G (UMTS/HSDPA/HSUPA/HSPA) Use only 2G (GPRS or EDGE) Use only 3G (UMTS/HSDPA/HSUPA/HSPA) HSUPA HSPA (HSDPA + HSUPA)