NMDeviceWimax

## NMDeviceWimax NMDeviceWimax |

## Synopsis

    enum                NMDeviceWimaxError;
    #define             NM_DEVICE_WIMAX_ERROR
    GQuark              nm_device_wimax_error_quark         (void);
    #define             NM_DEVICE_WIMAX_HW_ADDRESS
    #define             NM_DEVICE_WIMAX_ACTIVE_NSP
    #define             NM_DEVICE_WIMAX_CENTER_FREQUENCY
    #define             NM_DEVICE_WIMAX_RSSI
    #define             NM_DEVICE_WIMAX_CINR
    #define             NM_DEVICE_WIMAX_TX_POWER
    #define             NM_DEVICE_WIMAX_BSID
    #define             NM_DEVICE_WIMAX_NSPS
                        NMDeviceWimax;
                        NMDeviceWimaxClass;
    GObject *           nm_device_wimax_new                 (DBusGConnection *connection,
                                                             const char *path);
    const char *        nm_device_wimax_get_hw_address      (NMDeviceWimax *wimax);
    NMWimaxNsp *        nm_device_wimax_get_active_nsp      (NMDeviceWimax *wimax);
    NMWimaxNsp *        nm_device_wimax_get_nsp_by_path     (NMDeviceWimax *wimax,
                                                             const char *path);
    const GPtrArray *   nm_device_wimax_get_nsps            (NMDeviceWimax *wimax);
    guint               nm_device_wimax_get_center_frequency
                                                            (NMDeviceWimax *self);
    gint                nm_device_wimax_get_rssi            (NMDeviceWimax *self);
    gint                nm_device_wimax_get_cinr            (NMDeviceWimax *self);
    gint                nm_device_wimax_get_tx_power        (NMDeviceWimax *self);
    const char *        nm_device_wimax_get_bsid            (NMDeviceWimax *self);

## Object Hierarchy

      GObject
       +----NMObject
             +----NMDevice
                   +----NMDeviceWimax

## Implemented Interfaces

NMDeviceWimax implements GInitable and GAsyncInitable.

## Properties

      "active-nsp"               NMWimaxNsp*           : Read
      "bsid"                     gchar*                : Read
      "center-frequency"         guint                 : Read
      "cinr"                     gint                  : Read
      "hw-address"               gchar*                : Read
      "nsps"                     NMObjectArray*        : Read
      "rssi"                     gint                  : Read
      "tx-power"                 gint                  : Read

## Signals

      "nsp-added"                                      : Run First
      "nsp-removed"                                    : Run First

## Description

## Details

### enum NMDeviceWimaxError

    typedef enum {
    	NM_DEVICE_WIMAX_ERROR_UNKNOWN = 0,              /*< nick=UnknownError >*/
    	NM_DEVICE_WIMAX_ERROR_NOT_WIMAX_CONNECTION,     /*< nick=NotWimaxConnection >*/
    	NM_DEVICE_WIMAX_ERROR_INVALID_WIMAX_CONNECTION, /*< nick=InvalidWimaxConnection >*/
    	NM_DEVICE_WIMAX_ERROR_INVALID_DEVICE_MAC,       /*< nick=InvalidDeviceMac >*/
    	NM_DEVICE_WIMAX_ERROR_MAC_MISMATCH,             /*< nick=MacMismatch >*/
    } NMDeviceWimaxError;

`NM_DEVICE_WIMAX_ERROR_UNKNOWN` | unknown or unclassified error
`NM_DEVICE_WIMAX_ERROR_NOT_WIMAX_CONNECTION` | the connection was not of WiMax type
`NM_DEVICE_WIMAX_ERROR_INVALID_WIMAX_CONNECTION` | the WiMax connection was invalid
`NM_DEVICE_WIMAX_ERROR_INVALID_DEVICE_MAC` | the device's MAC was invalid
`NM_DEVICE_WIMAX_ERROR_MAC_MISMATCH` | the MACs of the connection and the device mismatched

### NM_DEVICE_WIMAX_ERROR

    #define NM_DEVICE_WIMAX_ERROR nm_device_wimax_error_quark ()

### nm_device_wimax_error_quark ()

    GQuark              nm_device_wimax_error_quark         (void);

Registers an error quark for NMDeviceWimax if necessary.

Returns : | the error quark used for NMDeviceWimax errors.

### NM_DEVICE_WIMAX_HW_ADDRESS

    #define NM_DEVICE_WIMAX_HW_ADDRESS       "hw-address"

### NM_DEVICE_WIMAX_ACTIVE_NSP

    #define NM_DEVICE_WIMAX_ACTIVE_NSP       "active-nsp"

### NM_DEVICE_WIMAX_CENTER_FREQUENCY

    #define NM_DEVICE_WIMAX_CENTER_FREQUENCY "center-frequency"

### NM_DEVICE_WIMAX_RSSI

    #define NM_DEVICE_WIMAX_RSSI             "rssi"

### NM_DEVICE_WIMAX_CINR

    #define NM_DEVICE_WIMAX_CINR             "cinr"

### NM_DEVICE_WIMAX_TX_POWER

    #define NM_DEVICE_WIMAX_TX_POWER         "tx-power"

### NM_DEVICE_WIMAX_BSID

    #define NM_DEVICE_WIMAX_BSID             "bsid"

### NM_DEVICE_WIMAX_NSPS

    #define NM_DEVICE_WIMAX_NSPS             "nsps"

### NMDeviceWimax

    typedef struct _NMDeviceWimax NMDeviceWimax;

### NMDeviceWimaxClass

    typedef struct {
    	NMDeviceClass parent;

    	/* Signals */
    	void (*nsp_added)   (NMDeviceWimax *self, NMWimaxNsp *nsp);
    	void (*nsp_removed) (NMDeviceWimax *self, NMWimaxNsp *nsp);
    } NMDeviceWimaxClass;

### nm_device_wimax_new ()

    GObject *           nm_device_wimax_new                 (DBusGConnection *connection,
                                                             const char *path);

Creates a new NMDeviceWimax.

`connection` : | the DBusGConnection
`path` : | the D-Bus object path of the WiMAX device
Returns : | a new WiMAX device. [transfer full]

### nm_device_wimax_get_hw_address ()

    const char *        nm_device_wimax_get_hw_address      (NMDeviceWimax *wimax);

Gets the hardware (MAC) address of the NMDeviceWimax

`wimax` : | a NMDeviceWimax
Returns : | the hardware address. This is the internal string used by the device, and must not be modified.

### nm_device_wimax_get_active_nsp ()

    NMWimaxNsp *        nm_device_wimax_get_active_nsp      (NMDeviceWimax *wimax);

Gets the active NMWimaxNsp.

`wimax` : | a NMDeviceWimax
Returns : | the access point or `NULL` if none is active. [transfer full]

### nm_device_wimax_get_nsp_by_path ()

    NMWimaxNsp *        nm_device_wimax_get_nsp_by_path     (NMDeviceWimax *wimax,
                                                             const char *path);

Gets a NMWimaxNsp by path.

`wimax` : | a NMDeviceWimax
`path` : | the object path of the NSP
Returns : | the access point or `NULL` if none is found. [transfer none]

### nm_device_wimax_get_nsps ()

    const GPtrArray *   nm_device_wimax_get_nsps            (NMDeviceWimax *wimax);

Gets all the scanned NSPs of the NMDeviceWimax.

`wimax` : | a NMDeviceWimax
Returns : | a GPtrArray containing all the scanned NMWimaxNsps. The returned array is owned by the client and should not be modified. [element-type NMClient.WimaxNsp]

### nm_device_wimax_get_center_frequency ()

    guint               nm_device_wimax_get_center_frequency
                                                            (NMDeviceWimax *self);

Gets the center frequency (in KHz) of the radio channel the device is using to communicate with the network when connected. Has no meaning when the device is not connected.

`self` : | a NMDeviceWimax
Returns : | the center frequency in KHz, or 0

### nm_device_wimax_get_rssi ()

    gint                nm_device_wimax_get_rssi            (NMDeviceWimax *self);

Gets the RSSI of the current radio link in dBm. This value indicates how strong the raw received RF signal from the base station is, but does not indicate the overall quality of the radio link. Has no meaning when the device is not connected.

`self` : | a NMDeviceWimax
Returns : | the RSSI in dBm, or 0

### nm_device_wimax_get_cinr ()

    gint                nm_device_wimax_get_cinr            (NMDeviceWimax *self);

Gets the CINR (Carrier to Interference + Noise Ratio) of the current radio link in dB. CINR is a more accurate measure of radio link quality. Has no meaning when the device is not connected.

`self` : | a NMDeviceWimax
Returns : | the CINR in dB, or 0

### nm_device_wimax_get_tx_power ()

    gint                nm_device_wimax_get_tx_power        (NMDeviceWimax *self);

Average power of the last burst transmitted by the device, in units of 0.5 dBm. i.e. a TxPower of -11 represents an actual device TX power of -5.5 dBm. Has no meaning when the device is not connected.

`self` : | a NMDeviceWimax
Returns : | the TX power in dBm, or 0

### nm_device_wimax_get_bsid ()

    const char *        nm_device_wimax_get_bsid            (NMDeviceWimax *self);

Gets the ID of the serving Base Station when the device is connected.

`self` : | a NMDeviceWimax
Returns : | the ID of the serving Base Station, or `NULL`

## Property Details

### The `"active-nsp"` property

      "active-nsp"               NMWimaxNsp*           : Read

The active NMWimaxNsp of the device.

### The `"bsid"` property

      "bsid"                     gchar*                : Read

The ID of the serving base station as received from the network. Has no meaning when the device is not connected.

Default value: NULL

### The `"center-frequency"` property

      "center-frequency"         guint                 : Read

The center frequency (in KHz) of the radio channel the device is using to communicate with the network when connected. Has no meaning when the device is not connected.

Default value: 0

### The `"cinr"` property

      "cinr"                     gint                  : Read

CINR (Carrier to Interference + Noise Ratio) of the current radio link in dB. CINR is a more accurate measure of radio link quality. Has no meaning when the device is not connected.

Default value: 0

### The `"hw-address"` property

      "hw-address"               gchar*                : Read

The hardware (MAC) address of the device.

Default value: NULL

### The `"nsps"` property

      "nsps"                     NMObjectArray*        : Read

List of all WiMAX Network Service Providers the device can see.

Since 0.9.10

### The `"rssi"` property

      "rssi"                     gint                  : Read

RSSI of the current radio link in dBm. This value indicates how strong the raw received RF signal from the base station is, but does not indicate the overall quality of the radio link. Has no meaning when the device is not connected.

Default value: 0

### The `"tx-power"` property

      "tx-power"                 gint                  : Read

Average power of the last burst transmitted by the device, in units of 0.5 dBm. i.e. a TxPower of -11 represents an actual device TX power of -5.5 dBm. Has no meaning when the device is not connected.

Default value: 0

## Signal Details

### The `"nsp-added"` signal

    void                user_function                      (NMDeviceWimax *self,
                                                            GObject       *nsp,
                                                            gpointer       user_data)      : Run First

Notifies that a NMWimaxNsp is added to the wimax device.

`self` : | the wimax device that received the signal
`nsp` : | the new NSP
`user_data` : | user data set when the signal handler was connected.

### The `"nsp-removed"` signal

    void                user_function                      (NMDeviceWimax *self,
                                                            GObject       *nsp,
                                                            gpointer       user_data)      : Run First

Notifies that a NMWimaxNsp is removed from the wimax device.

`self` : | the wimax device that received the signal
`nsp` : | the removed NSP
`user_data` : | user data set when the signal handler was connected.