org.freedesktop.NetworkManager.Device.WifiP2P: NetworkManager Reference Manual

org.freedesktop.NetworkManager.Device.WifiP2P

org.freedesktop.NetworkManager.Device.WifiP2P — Wi-Fi P2P Device.

Methods

StartFind (IN  a{sv} options);
StopFind  ();

Signals

PeerAdded   (o peer);
PeerRemoved (o peer);

Properties

HwAddress  readable   s
Peers      readable   ao
WpsPin     readable   s

Description

Since 1.16

Method Details

The StartFind() method

StartFind (IN  a{sv} options);

Start a find operation for Wi-Fi P2P peers.

The options argument accepts the following keys:

`i timeout`:	Timeout value in the range of 1-600 seconds. The default is 30 seconds.
`ay wfd-ies`:	Wi-Fi Display information elements to advertise in the discovery frames for the duration of the find. Wi-Fi Display sinks may only answer probes that carry WFD information elements, so a Wi-Fi Display client should pass the same elements here that its connection profile carries in wifi-p2p.wfd-ies. The elements are global to the Wi-Fi subsystem: the call fails if different WFD information elements are currently registered by another find operation or an active connection. Since: 1.60
`s discovery-type`:	One of "start_with_full", "social" or "progressive". "social" only scans the social channels (1, 6, 11), where Wi-Fi P2P devices in listen state answer, "progressive" intersperses a full scan, and "start_with_full" begins with one full scan. The default is the Wi-Fi backend's default. This is a best-effort hint; the IWD backend ignores it. Since: 1.60
`aay requested-device-types`:	A list of 8-byte WPS device types to search for: only peers advertising a matching device type are reported. An all-zero OUI and sub-category matches any device of the category. This is a best-effort hint; the IWD backend ignores it. Since: 1.60

IN a{sv} options:

Options of find.

Since 1.16

The StopFind() method

StopFind ();

Stop an ongoing find operation again.

Since 1.16

Signal Details

The "PeerAdded" signal

PeerAdded (o peer);

Emitted when a new Wi-Fi P2P peer is found by the device.

o peer:

The object path of the newly found access point.

Since 1.16

The "PeerRemoved" signal

PeerRemoved (o peer);

Emitted when a Wi-Fi P2P peer disappears from view of the device.

o peer:

The object path of the Wi-Fi P2P peer that has disappeared.

Since 1.16

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.

Since 1.16

The "Peers" property

Peers  readable   ao

List of object paths of peers visible to this Wi-Fi P2P device.

Since 1.16

The "WpsPin" property

WpsPin  readable   s

The WPS PIN that the user has to enter on the peer to complete the connection that is being activated. It is only set while a connection with a "wps-method" of "pin-display" is being activated, and empty otherwise.

Since: 1.60

Since 1.16