iwd

connectivity v1.0.1

iNet wireless daemon for wifi management

Additional Documentation

Build-time Wireless Profile

IGconf_iwd_profile accepts a path to an iwd network profile file. The file is installed into /var/lib/iwd/ preserving its filename and contents exactly. The filename must be identical to the network SSID. See iwd.network(5).

For example, a profile for a WPA2 network named Pi Towers Guest:

Pi Towers Guest.psk
[Security]
Passphrase=<passphrase>

The profile file can be supplied via different mechanisms.

Config YAML (absolute path)

iwd:
  profile: /path/to/Pi Towers Guest.psk

Config YAML (source-relative path)

Use the ${@SRCROOT} anchor to express the path relative to the source root (the directory passed via rpi-image-gen -S):

iwd:
  profile: ${@SRCROOT}/Pi Towers Guest.psk

Command line

Pass the profile path as a build variable. Quote the value if the filename contains spaces:

$ rpi-image-gen build -S ./examples/ota/ -c ota.yaml -- IGconf_iwd_profile='Pi Towers Guest.psk'
Note
A bare filename is resolved relative to the source directory determined by rpi-image-gen. Use an absolute path or the ${@SRCROOT} anchor to be explicit.

Relationships

Required by:

trixie-minbase

Provides: wifi-supplicant

Requires Provider: wireless-regdb, systemd, network-activator

Configuration Variables

Declares (prefix: iwd):

Variable Description Default Validation Policy
IGconf_iwd_profile Path to an iwd network profile file to bake into the build. The file is installed into /var/lib/iwd/ preserving its filename. See iwd.network(5) <empty> String value (may be empty) immediate

mmdebstrap

Packages

Installs:

Attributes

File: net-wireless/iwd-systemd.yaml

Type: static

Overlay: base