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.

DEPRECATED. Use the "HwAddress" property in "org.freedesktop.NetworkManager.Device" instead which exists since version NetworkManager 1.24.0.


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