## org.freedesktop.NetworkManager.Device.Wireless

org.freedesktop.NetworkManager.Device.Wireless — Wi-Fi Device

## Methods

    GetAccessPoints    (OUT ao    access_points);
    GetAllAccessPoints (OUT ao    access_points);
    RequestScan        (IN  a{sv} options);

## Signals

    PropertiesChanged  (a{sv} properties);
    AccessPointAdded   (o     access_point);
    AccessPointRemoved (o     access_point);

## Properties

    HwAddress             readable   s
    PermHwAddress         readable   s
    Mode                  readable   u
    Bitrate               readable   u
    AccessPoints          readable   ao
    ActiveAccessPoint     readable   o
    WirelessCapabilities  readable   u
    LastScan              readable   x

## Description

## Method Details

### The GetAccessPoints() method

    GetAccessPoints (OUT ao access_points);

DEPRECATED. Get the list of access points visible to this device. Note that this list does not include access points which hide their SSID. To retrieve a list of all access points (including hidden ones) use the GetAllAccessPoints() method.

`OUT ao `access_points``: | List of access point object paths.

### The GetAllAccessPoints() method

    GetAllAccessPoints (OUT ao access_points);

Get the list of all access points visible to this device, including hidden ones for which the SSID is not yet known.

`OUT ao `access_points``: | List of access point object paths.

### The RequestScan() method

    RequestScan (IN  a{sv} options);

Request the device to scan. To know when the scan is finished, use the "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" to listen to changes to the "LastScan" property.

`IN a{sv} `options``: | Options of scan. Currently 'ssids' option with value of "aay" type is supported.

## Signal Details

### The "PropertiesChanged" signal

    PropertiesChanged (a{sv} properties);

DEPRECATED. Use the standard "PropertiesChanged" signal from "org.freedesktop.DBus.Properties" instead which exists since version NetworkManager 1.2.0.

`a{sv} `properties``: | A dictionary containing the changed parameters.

### The "AccessPointAdded" signal

    AccessPointAdded (o access_point);

Emitted when a new access point is found by the device.

`o `access_point``: | The object path of the newly found access point.

### The "AccessPointRemoved" signal

    AccessPointRemoved (o access_point);

Emitted when an access point disappears from view of the device.

`o `access_point``: | The object path of the access point that has disappeared.

## Property Details

### The "HwAddress" property

    HwAddress  readable   s

The active hardware address of the device.

### The "PermHwAddress" property

    PermHwAddress  readable   s

The permanent hardware address of the device.

### The "Mode" property

    Mode  readable   u

The operating mode of the wireless device.

Returns: NM80211Mode

### The "Bitrate" property

    Bitrate  readable   u

The bit rate currently used by the wireless device, in kilobits/second (Kb/s).

### The "AccessPoints" property

    AccessPoints  readable   ao

List of object paths of access point visible to this wireless device.

### The "ActiveAccessPoint" property

    ActiveAccessPoint  readable   o

Object path of the access point currently used by the wireless device.

### The "WirelessCapabilities" property

    WirelessCapabilities  readable   u

The capabilities of the wireless device.

Returns: NMDeviceWifiCapabilities

### The "LastScan" property

    LastScan  readable   x

The timestamp (in CLOCK_BOOTTIME milliseconds) for the last finished network scan. A value of -1 means the device never scanned for access points.

Since: 1.12