flyoverhead.openwrt.wireless
OpenWRT wireless configuration
- configure wireless devices
- create/delete/configure wireless interfaces
Role Variables
| Variable | Descritpion | Status | Type | Example |
|---|---|---|---|---|
wireless_devices |
List of wireless devices | list of dictionaries |
||
id |
Radio device ID | mandatory |
string |
radio0 |
type |
Radio device type | optional |
string |
mac80211 |
disabled |
Disable radio adapter | required |
boolean |
0 |
channel |
Wireless channel (integer of auto) |
optional |
string |
auto |
band |
Wireless band (2g or 5g) |
optional |
string |
2g |
htmode |
Wireless channel width | optional |
string |
HT20 |
country |
Country code for adaptive channels and transmission powers | optional |
string |
US |
wireless_interfaces |
List of wireless interfaces | list of dictionaries |
||
id |
Unique interface ID | mandatory |
string |
iot0 |
name |
Unique interface name | mandatory |
string |
iot0 |
state |
Interface status (present or absent) |
required |
string |
present |
device |
Radio device associated with the interface | mandatory |
string |
radio0 |
network |
List of networks associated with the interface | required |
list |
iot |
mode |
Wireless interface operation mode | required |
string |
ap |
disabled |
Disable wireless network | required |
boolean |
0 |
ssid |
Wireless network SSID | required |
string |
OpenWrt |
mesh_id |
ID of the mesh network (as defined in IEEE 802.11s) to join wireless interface to | optional |
string |
example_mesh_id |
hidden |
Disable broadcasting of beacon frames to hide ESSID | optional |
boolean |
0 |
isolate |
Isolate wireless clients from each other | optional |
boolean |
0 |
encryption |
Wireless encryption method | required |
string |
psk2 |
key |
Passphrase for pre-shared key | required |
string |
password |
macfilter |
MAC filter policy (disable, allow or deny) |
optional |
string |
disable |
maclist |
List of MAC addresses used fot MAC filter policy | optional |
list |
["00:11:22:33:44:55", "55:44:33:22:11:00"] |
ieee80211r |
Enable fast BSS transition (802.11r) support | optional |
boolean |
0 |
mobility_domain |
Enable Mobility Domain identifier used to indicate a group of APs between which a STA can use fast BSS transition (will be generated automatically) | optional |
boolean |
1 |
ft_over_ds |
Enable FT-over-DS | optional |
boolean |
1 |
ft_psk_generate_local |
Enable local generation of FT response for PSK networks | optional |
boolean |
1 |
Dependencies
| Name | Description |
|---|---|
Ansible Role: openwrt |
Ansible role by gekmihesg for managing OpenWRT and derivatives |
Example Playbook
- hosts: openwrt
roles:
- role: flyoverhead.openwrt.wireless
Example Vars
wireless_devices:
- id: "radio0"
type: "mac80211"
channel: "auto"
wireless_interfaces:
- id: "lan0"
name: "lan0"
state: "present"
device: "radio0"
network: ["lan"]
mode: "ap"
ssid: "openwrt"
encryption: "psk2"
key: "password"
License
GNU General Public License v3.0
Author Information
fly0v3rH34D