Manual:Interface/Wireless: Difference between revisions
m fixed tempate argument |
new content added |
||
| Line 6: | Line 6: | ||
This property is only for virtual AP interfaces. | This property is only for virtual AP interfaces. | ||
}} | }} | ||
{{ARG|mode|one of 'station', 'station-wds', 'ap-bridge', 'bridge', ' | {{ARG|mode|one of 'station', 'station-wds', 'ap-bridge', 'bridge', 'alignment-only', 'nstreme-dual-slave', 'wds-slave', 'station-pseudobridge' or 'station-pseudobridge-clone' | ||
|station||| | |station||| | ||
Station modes: | Station modes: | ||
| Line 17: | Line 17: | ||
* ap-bridge - Basic access point mode. | * ap-bridge - Basic access point mode. | ||
* bridge - Same as 'ap-bridge', but limited to one associated client. | * bridge - Same as 'ap-bridge', but limited to one associated client. | ||
* wds-slave - Same as 'ap-bridge', but | * wds-slave - Same as 'ap-bridge', but scan for AP with the same <var>ssid</var> and establishes WDS link. If this link is lost or cannot be established, then continue scanning. If <var>dfs-mode</var> is 'radar-detect', then APs with enabled <var>hide-ssid</var> will not be found during scanning. | ||
Special modes: | Special modes: | ||
* alignment-only - Put interface in a | * alignment-only - Put interface in a continuous transmit mode that is used for aiming remote antenna. | ||
* nstreme-dual-slave - allow this interface to be used in nstreme-dual setup. | * nstreme-dual-slave - allow this interface to be used in nstreme-dual setup. | ||
| Line 30: | Line 30: | ||
}} | }} | ||
{{ARG|frequency|Frequency value in MHz.||||Channel frequency on which AP will operate. | {{ARG|frequency|Frequency value in MHz.||||Channel frequency on which AP will operate. | ||
Allowed values depend on selected band, and are | Allowed values depend on selected band, and are restricted by <var>country</var> setting and wireless card capabilities. | ||
This setting has no effect if interface is in station mode.}} | This setting has no effect if interface is in any of station modes, or in 'wds-slave' mode, or if DFS is active. | ||
}} | |||
{{ARG|band|one of '2.4ghz-b', '5ghz', '5ghz-turbo', '2.4ghz-b/g', '2.4ghz-g-turbo', '5ghz-10mhz', '5ghz-5mhz', '2ghz-10mhz', '2ghz-5mhz', '5ghz-11n', '2ghz-11n', '2.4ghz-onlyg'||||}} | {{ARG|band|one of '2.4ghz-b', '5ghz', '5ghz-turbo', '2.4ghz-b/g', '2.4ghz-g-turbo', '5ghz-10mhz', '5ghz-5mhz', '2ghz-10mhz', '2ghz-5mhz', '5ghz-11n', '2ghz-11n', '2.4ghz-onlyg'||||}} | ||
{{ARG|scan-list|comma separated list of frequencies and frequency ranges, or 'default'||||The 'default' value is all channels from selected band that are supported by card and allowed by the <var>country</var> and <var>frequency-mode</var> settings (this list can be seen in [[M:/interface/wireless/info|/interface/wireless/info]]). For default | {{ARG|scan-list|comma separated list of frequencies and frequency ranges, or 'default'||||The 'default' value is all channels from selected band that are supported by card and allowed by the <var>country</var> and <var>frequency-mode</var> settings (this list can be seen in [[M:/interface/wireless/info|/interface/wireless/info]]). For default scan list in '5ghz' band channels are taken with 20MHz step, in '5ghz-turbo' band - with 40MHz step, for all other bands - with 5MHz step. If <var>scan-list</var> is specified manually, then all matching channels are taken. | ||
Example: <nowiki>scan-list='default',5200-5245,2412-2427</nowiki> | Example: <nowiki>scan-list='default',5200-5245,2412-2427</nowiki> | ||
| Line 48: | Line 49: | ||
* 'dynamic' also allows WDS links with devices that are not configured in [[M:/interface/wireless/wds|/interface/wireless/wds]], by creating required entries dynamically. Such dynamic WDS entries are removed automatically after the connection with the other AP is lost. | * 'dynamic' also allows WDS links with devices that are not configured in [[M:/interface/wireless/wds|/interface/wireless/wds]], by creating required entries dynamically. Such dynamic WDS entries are removed automatically after the connection with the other AP is lost. | ||
'-mesh' modes use different (better) method for establishing link between AP, that is not compatible with APs in non-mesh mode. | '-mesh' modes use different (better) method for establishing link between AP, that is not compatible with APs in non-mesh mode. This method avoids one-sided WDS links that are created only by one of the two APs. Such links cannot pass any data. | ||
When AP or station is establishing WDS connection with another AP, it uses [[M:/interface/wireless/connect-list|/interface/wireless/connect-list]] to check whether this connection is allowed. If station in 'station-wds' mode is establishing connection with AP, AP uses [[M:/interface/wireless/access-list|/interface/wireless/access-list]] to check whether this connection is allowed. | |||
If <var>mode</var> is 'station-wds', then this property has no effect. | If <var>mode</var> is 'station-wds', then this property has no effect. | ||
| Line 81: | Line 84: | ||
=== Advanced settings === | === Advanced settings === | ||
{{ARG|prism-cardtype|'30mW', '100mW', '200mW'|||| | {{ARG|prism-cardtype|'30mW', '100mW', '200mW'||||Specify type of the installed wireless card. Only for Prism based cards. }} | ||
{{ARG|radio-name|||||}} | {{ARG|radio-name|Text||||Descriptive name of the device, that is shown in registration table entries on the remote devices. | ||
{{ARG|area|||||}} | This is a proprietary extension.}} | ||
{{ARG|area|Text|empty||| | |||
Identifies group of wireless networks. This value is announced by AP, and can be matched in [[M:/interface/wireless/connect-list|/interface/wireless/connect-list]] by <var>area-prefix</var>. | |||
This is a proprietary extension.}} | |||
{{ARG|frequency-mode|one of these values: | {{ARG|frequency-mode|one of these values: | ||
* regulatory-domain - Limit available channels and maximum transmit power for each channel according to the value of <var>country</var> | * regulatory-domain - Limit available channels and maximum transmit power for each channel according to the value of <var>country</var> | ||
| Line 91: | Line 97: | ||
}} | }} | ||
{{ARG|country|either 'no_country_set', or name of regulatory domain||||Limits available bands, frequencies and maximum transmit power for each frequency. Also specifies default value of <var>scan-list</var>. Value 'no_country_set' is FCC compliant set of channels.}} | {{ARG|country|either 'no_country_set', or name of regulatory domain||||Limits available bands, frequencies and maximum transmit power for each frequency. Also specifies default value of <var>scan-list</var>. Value 'no_country_set' is FCC compliant set of channels.}} | ||
{{ARG|antenna-gain|||||}} | {{ARG|antenna-gain||0||| | ||
{{ARG|rate- | Antenna gain in dBi, used to calculate maximum transmit power according to <var>country</var> limitations. | ||
{{ARG|supported-rates-b|||||}} | }} | ||
{{ARG|supported-rates-a/g|||||}} | <table class=infobox><caption>Default basic and supported rates, depending on selected band</caption> | ||
{{ARG|basic-rates-b|||||}} | <td><tr><th>band<th>basic rates<th>supported rates | ||
{{ARG|basic-rates-a/g|||||}} | <tr><td>2.4ghz-b<td>1<td>1 .. 11 | ||
{{ARG|max-station-count|||||}} | <tr><td>5ghz<td>6<td>6 .. 54 | ||
<tr><td>2.4ghz-onlyg<td>6<td>1 .. 11 and 6 .. 54 | |||
<tr><td>2.4ghz-b/g<td>1 .. 11<td>1 .. 11 and 6 .. 54 | |||
<tr><td>2.4ghz-g-turbo<td>6<td>6 .. 54 | |||
</table> | |||
{{ARG|rate-set|'default' or 'configured'|||| | |||
* default - default basic and supported rate sets are used. Values from basic-rates and supported-rates parameters have no effect. | |||
* configured - use values from basic-rates and supported-rates parameters. Note that g mode bands use rates from both rates-b and rates-a/g properties. | |||
}} | |||
{{ARG|supported-rates-b||||| | |||
List of supported rates, used for 2.4ghz-b, 2.4ghz-b/g and 2.4ghz-onlyg bands. | |||
Two devices will communicate only using rates that are supported by both devices. | |||
This property has effect only when value of <var>rate-set</var> is 'configured'. | |||
}} | |||
{{ARG|supported-rates-a/g||||| | |||
Similar to the above property, but used for 5ghz, 5ghz-10mhz, 5ghz-5mhz, 5ghz-turbo, 2.4ghz-b/g, 2.4ghz-onlyg, 2ghz-10mhz, 2ghz-5mhz and 2.4ghz-g-turbo bands. | |||
}} | |||
{{ARG|basic-rates-b||||| | |||
List of basic rates, used for 2.4ghz-b, 2.4ghz-b/g and 2.4ghz-onlyg bands. | |||
Client will connect to AP only if it supports all basic rates announced by the AP. | |||
AP will establish WDS link only if it supports all basic rates of the other AP. | |||
This property has effect only in AP modes, and when value of <var>rate-set</var> is 'configured'. | |||
}} | |||
{{ARG|basic-rates-a/g||||| | |||
Similar to the above property, but used for 5ghz, 5ghz-10mhz, 5ghz-5mhz, 5ghz-turbo, 2.4ghz-b/g, 2.4ghz-onlyg, 2ghz-10mhz, 2ghz-5mhz and 2.4ghz-g-turbo bands. | |||
}} | |||
{{ARG|max-station-count|1..2007|2007|||Maximum number of associated clients. WDS links also count toward this limit.}} | |||
{{ARG|act-timeout|'indoors', 'dynamic', or value in microseconds||||}} | {{ARG|act-timeout|'indoors', 'dynamic', or value in microseconds||||}} | ||
{{ARG|tx-power|value in the -30..30 range||||}} | {{ARG|tx-power|value in the -30..30 range||||}} | ||
| Line 110: | Line 143: | ||
{{ARG|periodic-calibration-interval|value in range 1..10000||||}} | {{ARG|periodic-calibration-interval|value in range 1..10000||||}} | ||
{{ARG|burst-time|'disabled', or value in microseconds||||}} | {{ARG|burst-time|'disabled', or value in microseconds||||}} | ||
{{ARG|dfs-mode|one of | {{ARG|dfs-mode|one of 'none', 'no-radar-detect' and 'radar-detect' | ||
* none - | |none||| | ||
* no-radar-detect - | Controls DFS (Dynamic Frequency Selection). | ||
* radar-detect - | * none - disables DFS. | ||
* no-radar-detect - Select channel from <var>scan-list</var> with the lowest number of detected networks. In 'wds-slave' mode this setting has no effect. | |||
* radar-detect - Select channel with the lowest number of detected networks and use it if no radar is detected on it for 60 seconds. Otherwise, select different channel. This setting may be required by the country regulations. | |||
This property has effect only in AP mode. | |||
}} | |||
{{ARG|wds-default-cost|||||}} | {{ARG|wds-default-cost|||||}} | ||
{{ARG|wds-cost-range|||||}} | {{ARG|wds-cost-range|||||}} | ||
| Line 133: | Line 170: | ||
{{ARG|hw-retries|number 0..15||||}} | {{ARG|hw-retries|number 0..15||||}} | ||
{{ARG|frame-lifetime|||||}} | {{ARG|frame-lifetime|||||}} | ||
{{ARG|adaptive-noise-immunity|'yes' or 'no'||||}} | {{ARG|adaptive-noise-immunity|'yes' or 'no'|yes|||}} | ||
{{ManFooter|Reference}} | {{ManFooter|Reference}} | ||
Revision as of 14:30, 19 March 2008
Basic settings
master-interface
Syntax: interface name
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Name of wireless interface that has 'virtual-ap' capability. Virtual AP interface will only work if master interface is in 'ap-bridge', 'bridge' or 'wds-slave' mode. This property is only for virtual AP interfaces.
|Description: Name of wireless interface that has 'virtual-ap' capability. Virtual AP interface will only work if master interface is in 'ap-bridge', 'bridge' or 'wds-slave' mode. This property is only for virtual AP interfaces.
}}mode
Syntax: one of 'station', 'station-wds', 'ap-bridge', 'bridge', 'alignment-only', 'nstreme-dual-slave', 'wds-slave', 'station-pseudobridge' or 'station-pseudobridge-clone'
}}{{ #if: station|Default value: station
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Station modes:
- station - Basic station mode. Find and connect to acceptable AP.
- station-wds - Same as 'station', but create WDS link with AP, using proprietary extension. AP configuration has to allow WDS links with this device. Note that this mode does not use entries in /interface/wireless/wds.
- station-pseudobridge - Same as 'station', but additionally perform MAC address translation of all traffic. Allows interface to be bridged.
- station-pseudobridge-clone - Same as 'station-pseudobridge', but use station-bridge-clone-mac address to connect to AP.
AP modes:
- ap-bridge - Basic access point mode.
- bridge - Same as 'ap-bridge', but limited to one associated client.
- wds-slave - Same as 'ap-bridge', but scan for AP with the same ssid and establishes WDS link. If this link is lost or cannot be established, then continue scanning. If dfs-mode is 'radar-detect', then APs with enabled hide-ssid will not be found during scanning.
Special modes:
- alignment-only - Put interface in a continuous transmit mode that is used for aiming remote antenna.
- nstreme-dual-slave - allow this interface to be used in nstreme-dual setup.
MAC address translation in pseudobridge modes works by inspecting packets and building table of corresponding IP and MAC addresses. All packets are sent to AP with the MAC address used by pseudobridge, and MAC addresses of received packets are restored from the address translation table. There is single entry in address translation table for all non-IP packets, hence more than one host in the bridged network cannot reliably use non-IP protocols.
Virtual AP interfaces do not have this property, they follow the mode of their master interface.
|Description: Station modes:
- station - Basic station mode. Find and connect to acceptable AP.
- station-wds - Same as 'station', but create WDS link with AP, using proprietary extension. AP configuration has to allow WDS links with this device. Note that this mode does not use entries in /interface/wireless/wds.
- station-pseudobridge - Same as 'station', but additionally perform MAC address translation of all traffic. Allows interface to be bridged.
- station-pseudobridge-clone - Same as 'station-pseudobridge', but use station-bridge-clone-mac address to connect to AP.
- ap-bridge - Basic access point mode.
- bridge - Same as 'ap-bridge', but limited to one associated client.
- wds-slave - Same as 'ap-bridge', but scan for AP with the same ssid and establishes WDS link. If this link is lost or cannot be established, then continue scanning. If dfs-mode is 'radar-detect', then APs with enabled hide-ssid will not be found during scanning.
- alignment-only - Put interface in a continuous transmit mode that is used for aiming remote antenna.
- nstreme-dual-slave - allow this interface to be used in nstreme-dual setup.
ssid
Syntax: text, up to 32 characters long
}}{{ #if: value of /system/identity|Default value: value of /system/identity
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: SSID (service set identifier) is a name that identifies wireless network.
|Description: SSID (service set identifier) is a name that identifies wireless network.
}}frequency
Syntax: Frequency value in MHz.
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Channel frequency on which AP will operate. Allowed values depend on selected band, and are restricted by country setting and wireless card capabilities. This setting has no effect if interface is in any of station modes, or in 'wds-slave' mode, or if DFS is active.
|Description: Channel frequency on which AP will operate. Allowed values depend on selected band, and are restricted by country setting and wireless card capabilities. This setting has no effect if interface is in any of station modes, or in 'wds-slave' mode, or if DFS is active.
}}band
Syntax: one of '2.4ghz-b', '5ghz', '5ghz-turbo', '2.4ghz-b/g', '2.4ghz-g-turbo', '5ghz-10mhz', '5ghz-5mhz', '2ghz-10mhz', '2ghz-5mhz', '5ghz-11n', '2ghz-11n', '2.4ghz-onlyg'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}scan-list
Syntax: comma separated list of frequencies and frequency ranges, or 'default'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: The 'default' value is all channels from selected band that are supported by card and allowed by the country and frequency-mode settings (this list can be seen in /interface/wireless/info). For default scan list in '5ghz' band channels are taken with 20MHz step, in '5ghz-turbo' band - with 40MHz step, for all other bands - with 5MHz step. If scan-list is specified manually, then all matching channels are taken.
Example: scan-list='default',5200-5245,2412-2427
This will use the default value of scan list for current band, and add to it supported frequencies from 5200-5245 or 2412-2427 range.|Description: The 'default' value is all channels from selected band that are supported by card and allowed by the country and frequency-mode settings (this list can be seen in /interface/wireless/info). For default scan list in '5ghz' band channels are taken with 20MHz step, in '5ghz-turbo' band - with 40MHz step, for all other bands - with 5MHz step. If scan-list is specified manually, then all matching channels are taken. Example: scan-list='default',5200-5245,2412-2427 This will use the default value of scan list for current band, and add to it supported frequencies from 5200-5245 or 2412-2427 range.
}}antenna-mode
- ant-a - use only 'a' antenna
- ant-b - use only 'b' antenna
- txa-rxb - use antenna 'a' for transmitting, antenna 'b' for receiving
- rxa-txb - use antenna 'b' for transmitting, antenna 'a' for receiving
Syntax: one of these values:
- ant-a - use only 'a' antenna
- ant-b - use only 'b' antenna
- txa-rxb - use antenna 'a' for transmitting, antenna 'b' for receiving
- rxa-txb - use antenna 'b' for transmitting, antenna 'a' for receiving
Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}wds-mode
Syntax: one of 'disabled', 'static', 'dynamic', 'static-mesh' or 'dynamic-mesh'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Controls how WDS links with other devices (APs and clients in 'station-wds' mode) are established.
- 'disabled' does not allow WDS links.
- 'static' only allows WDS links that are manually configured in /interface/wireless/wds
- 'dynamic' also allows WDS links with devices that are not configured in /interface/wireless/wds, by creating required entries dynamically. Such dynamic WDS entries are removed automatically after the connection with the other AP is lost.
'-mesh' modes use different (better) method for establishing link between AP, that is not compatible with APs in non-mesh mode. This method avoids one-sided WDS links that are created only by one of the two APs. Such links cannot pass any data.
When AP or station is establishing WDS connection with another AP, it uses /interface/wireless/connect-list to check whether this connection is allowed. If station in 'station-wds' mode is establishing connection with AP, AP uses /interface/wireless/access-list to check whether this connection is allowed.
If mode is 'station-wds', then this property has no effect.
|Description: Controls how WDS links with other devices (APs and clients in 'station-wds' mode) are established.
- 'disabled' does not allow WDS links.
- 'static' only allows WDS links that are manually configured in /interface/wireless/wds
- 'dynamic' also allows WDS links with devices that are not configured in /interface/wireless/wds, by creating required entries dynamically. Such dynamic WDS entries are removed automatically after the connection with the other AP is lost.
wds-default-bridge
Syntax: 'none', or name of bridge interface
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: When WDS link is established and status of the wds interface becomes 'running', it will be added as a bridge port to the bridge interface specified by this property. When WDS link is lost, wds interface is removed from the bridge.
If wds interface is already included in a bridge setup when WDS link becomes active, it will not be added to bridge specified by , and will
|Description: When WDS link is established and status of the wds interface becomes 'running', it will be added as a bridge port to the bridge interface specified by this property. When WDS link is lost, wds interface is removed from the bridge. If wds interface is already included in a bridge setup when WDS link becomes active, it will not be added to bridge specified by , and will
}}wds-ignore-ssid
Syntax: 'yes' or 'no'
}}{{ #if: no|Default value: no
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: By default, WDS link between two APs can be created only when they work on the same frequency and have the same SSID value. If this property is set to 'yes', then SSID of the remote AP will not be checked. This property has no effect on connections from clients in 'station-wds' mode. It also does not work if wds-mode is 'static-mesh' or 'dynamic-mesh'.
|Description: By default, WDS link between two APs can be created only when they work on the same frequency and have the same SSID value. If this property is set to 'yes', then SSID of the remote AP will not be checked. This property has no effect on connections from clients in 'station-wds' mode. It also does not work if wds-mode is 'static-mesh' or 'dynamic-mesh'.
}}default-authentication
Syntax: 'yes' or 'no'
}}{{ #if: yes|Default value: yes
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: For AP mode, this is the value of authentication for clients that do not match any entry in the /interface/wireless/access-list. For station mode, this is the value of connect for APs that do not match any entry in the /interface/wireless/connect-list.
|Description: For AP mode, this is the value of authentication for clients that do not match any entry in the /interface/wireless/access-list. For station mode, this is the value of connect for APs that do not match any entry in the /interface/wireless/connect-list.
}}default-forwarding
Syntax: 'yes' or 'no'
}}{{ #if: yes|Default value: yes
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: This is the value of forwarding for clients that do not match any entry in the /interface/wireless/access-list.
|Description: This is the value of forwarding for clients that do not match any entry in the /interface/wireless/access-list.
}}default-ap-tx-limit
Syntax:
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: This is the value of ap-tx-limit for clients that do not match any entry in the /interface/wireless/access-list.
|Description: This is the value of ap-tx-limit for clients that do not match any entry in the /interface/wireless/access-list.
}}default-client-tx-limit
Syntax:
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: This is the value of client-tx-limit for clients that do not match any entry in the /interface/wireless/access-list.
|Description: This is the value of client-tx-limit for clients that do not match any entry in the /interface/wireless/access-list.
}}hide-ssid
Syntax: 'yes' or 'no'
}}{{ #if: no|Default value: no
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if:
- yes - AP does not include SSID the beacon frames, and does not reply to probe requests that have broadcast SSID.
- no - AP includes SSID in the beacon frames, and replies to probe requests that have broadcast SSID.
This property has effect only in AP mode. Setting it to 'yes' can remove this network from the list of wireless networks that are shown by some client software. Changing this setting does not improve security of the wireless network, because SSID is included in other frames sent by the AP.
|Description:
- yes - AP does not include SSID the beacon frames, and does not reply to probe requests that have broadcast SSID.
- no - AP includes SSID in the beacon frames, and replies to probe requests that have broadcast SSID.
security-profile
Syntax: name of profile from /interface/wireless/security-profiles
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}compression
Syntax: 'yes' or 'no'
}}{{ #if: no|Default value: no
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Setting this property to 'yes' will allow use of the hardware compression. Wireless interface must have support for hardware compression. Connections with devices that do not use compression will still work.
|Description: Setting this property to 'yes' will allow use of the hardware compression. Wireless interface must have support for hardware compression. Connections with devices that do not use compression will still work.
}}Basic information (read only properties)
interface-type
Syntax: 'virtual-AP', 'Prism', or 'Atheros model_name'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: This specifies type of wireless interface. Some properties have meaning only for certain types of interfaces.|Description: This specifies type of wireless interface. Some properties have meaning only for certain types of interfaces.
}}
Advanced settings
prism-cardtype
Syntax: '30mW', '100mW', '200mW'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Specify type of the installed wireless card. Only for Prism based cards. |Description: Specify type of the installed wireless card. Only for Prism based cards.
}}radio-name
Syntax: Text
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Descriptive name of the device, that is shown in registration table entries on the remote devices.
This is a proprietary extension.|Description: Descriptive name of the device, that is shown in registration table entries on the remote devices. This is a proprietary extension.
}}area
Syntax: Text
}}{{ #if: empty|Default value: empty
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Identifies group of wireless networks. This value is announced by AP, and can be matched in /interface/wireless/connect-list by area-prefix.
This is a proprietary extension.|Description: Identifies group of wireless networks. This value is announced by AP, and can be matched in /interface/wireless/connect-list by area-prefix. This is a proprietary extension.
}}frequency-mode
- regulatory-domain - Limit available channels and maximum transmit power for each channel according to the value of country
- manual-txpower - Same as above, but do not limit maximum transmit power.
- superchannel - Allow all channels supported by the card.
Syntax: one of these values:
- regulatory-domain - Limit available channels and maximum transmit power for each channel according to the value of country
- manual-txpower - Same as above, but do not limit maximum transmit power.
- superchannel - Allow all channels supported by the card.
Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: List of available channels for each band can be seen in /interface/wireless/info
|Description: List of available channels for each band can be seen in /interface/wireless/info
}}country
Syntax: either 'no_country_set', or name of regulatory domain
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Limits available bands, frequencies and maximum transmit power for each frequency. Also specifies default value of scan-list. Value 'no_country_set' is FCC compliant set of channels.|Description: Limits available bands, frequencies and maximum transmit power for each frequency. Also specifies default value of scan-list. Value 'no_country_set' is FCC compliant set of channels.
}}antenna-gain
Syntax:
}}{{ #if: 0|Default value: 0
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Antenna gain in dBi, used to calculate maximum transmit power according to country limitations.
|Description: Antenna gain in dBi, used to calculate maximum transmit power according to country limitations.
}}| band | basic rates | supported rates |
|---|---|---|
| 2.4ghz-b | 1 | 1 .. 11 |
| 5ghz | 6 | 6 .. 54 |
| 2.4ghz-onlyg | 6 | 1 .. 11 and 6 .. 54 |
| 2.4ghz-b/g | 1 .. 11 | 1 .. 11 and 6 .. 54 |
| 2.4ghz-g-turbo | 6 | 6 .. 54 |
rate-set
Syntax: 'default' or 'configured'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if:
- default - default basic and supported rate sets are used. Values from basic-rates and supported-rates parameters have no effect.
- configured - use values from basic-rates and supported-rates parameters. Note that g mode bands use rates from both rates-b and rates-a/g properties.
Description:
- default - default basic and supported rate sets are used. Values from basic-rates and supported-rates parameters have no effect.
- configured - use values from basic-rates and supported-rates parameters. Note that g mode bands use rates from both rates-b and rates-a/g properties.
supported-rates-b
Syntax:
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: List of supported rates, used for 2.4ghz-b, 2.4ghz-b/g and 2.4ghz-onlyg bands. Two devices will communicate only using rates that are supported by both devices. This property has effect only when value of rate-set is 'configured'.
|Description: List of supported rates, used for 2.4ghz-b, 2.4ghz-b/g and 2.4ghz-onlyg bands. Two devices will communicate only using rates that are supported by both devices. This property has effect only when value of rate-set is 'configured'.
}}supported-rates-a/g
Syntax:
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Similar to the above property, but used for 5ghz, 5ghz-10mhz, 5ghz-5mhz, 5ghz-turbo, 2.4ghz-b/g, 2.4ghz-onlyg, 2ghz-10mhz, 2ghz-5mhz and 2.4ghz-g-turbo bands.
|Description: Similar to the above property, but used for 5ghz, 5ghz-10mhz, 5ghz-5mhz, 5ghz-turbo, 2.4ghz-b/g, 2.4ghz-onlyg, 2ghz-10mhz, 2ghz-5mhz and 2.4ghz-g-turbo bands.
}}basic-rates-b
Syntax:
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: List of basic rates, used for 2.4ghz-b, 2.4ghz-b/g and 2.4ghz-onlyg bands.
Client will connect to AP only if it supports all basic rates announced by the AP. AP will establish WDS link only if it supports all basic rates of the other AP. This property has effect only in AP modes, and when value of rate-set is 'configured'.
|Description: List of basic rates, used for 2.4ghz-b, 2.4ghz-b/g and 2.4ghz-onlyg bands. Client will connect to AP only if it supports all basic rates announced by the AP. AP will establish WDS link only if it supports all basic rates of the other AP. This property has effect only in AP modes, and when value of rate-set is 'configured'.
}}basic-rates-a/g
Syntax:
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Similar to the above property, but used for 5ghz, 5ghz-10mhz, 5ghz-5mhz, 5ghz-turbo, 2.4ghz-b/g, 2.4ghz-onlyg, 2ghz-10mhz, 2ghz-5mhz and 2.4ghz-g-turbo bands.
|Description: Similar to the above property, but used for 5ghz, 5ghz-10mhz, 5ghz-5mhz, 5ghz-turbo, 2.4ghz-b/g, 2.4ghz-onlyg, 2ghz-10mhz, 2ghz-5mhz and 2.4ghz-g-turbo bands.
}}max-station-count
Syntax: 1..2007
}}{{ #if: 2007|Default value: 2007
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Maximum number of associated clients. WDS links also count toward this limit.|Description: Maximum number of associated clients. WDS links also count toward this limit.
}}act-timeout
Syntax: 'indoors', 'dynamic', or value in microseconds
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}tx-power
Syntax: value in the -30..30 range
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}tx-power-mode
- default -
- all-rates-fixed -
- card-rates -
- manual-table -
Syntax: one of these values:
- default -
- all-rates-fixed -
- card-rates -
- manual-table -
Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}noise-floor-threshold
Syntax: 'default' or value in the -128..127 range
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}periodic-calibration
Syntax: one of 'default', 'enabled' or 'disabled'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}periodic-calibration-interval
Syntax: value in range 1..10000
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}burst-time
Syntax: 'disabled', or value in microseconds
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}dfs-mode
Syntax: one of 'none', 'no-radar-detect' and 'radar-detect'
}}{{ #if: none|Default value: none
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Controls DFS (Dynamic Frequency Selection).
- none - disables DFS.
- no-radar-detect - Select channel from scan-list with the lowest number of detected networks. In 'wds-slave' mode this setting has no effect.
- radar-detect - Select channel with the lowest number of detected networks and use it if no radar is detected on it for 60 seconds. Otherwise, select different channel. This setting may be required by the country regulations.
This property has effect only in AP mode.
|Description: Controls DFS (Dynamic Frequency Selection).
- none - disables DFS.
- no-radar-detect - Select channel from scan-list with the lowest number of detected networks. In 'wds-slave' mode this setting has no effect.
- radar-detect - Select channel with the lowest number of detected networks and use it if no radar is detected on it for 60 seconds. Otherwise, select different channel. This setting may be required by the country regulations.
wds-default-cost
Syntax:
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}wds-cost-range
Syntax:
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}update-stats-interval
Syntax: 'disabled' or time interval in the 10s..5h range
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}proprietary-extensions
Syntax: 'pre-2.9.25' or 'post-2.9.25'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}wmm-support
Syntax: 'disabled', 'enabled' or 'required'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}disconnect-timeout
Syntax: time interval in the 0..15s range, in units of 10ms
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}on-fail-retry-time
Syntax: time interval in the 10ms..1s range, in 10ms units
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}preamble-mode
Syntax: one of 'long', 'short' or 'both'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}Syntax: 'yes' or 'no'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}station-bridge-clone-mac
Syntax: MAC address of ______
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}ht-rates
Syntax: comma separated list of numbers 1..8
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}ht-guard-interval
Syntax: 'long', 'short' or 'both'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}ht-channel-width
Syntax: '20mhz', '40mhz' or '2040mhz'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}ht-streams
Syntax: 'single', 'double' or 'both'
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}ht-txchains
Syntax: 1, 5 or 7
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}ht-rxchains
Syntax: 1, 5 or 7
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}hw-retries
Syntax: number 0..15
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}frame-lifetime
Syntax:
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}adaptive-noise-immunity
Syntax: 'yes' or 'no'
}}{{ #if: yes|Default value: yes
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: |Description:
}}{{ #if: Reference|}}{{ #if: |[[Category:{{{2}}}]]}}{{ #if: |[[Category:{{{3}}}]]}}{{ #if: |[[Category:{{{4}}}]]}}{{ #if: |[[Category:{{{5}}}]]}}{{ #if: |[[Category:{{{6}}}]]}}{{ #if: |[[Category:{{{7}}}]]}}{{ #if: |[[Category:{{{8}}}]]}}{{ #if: |[[Category:{{{9}}}]]}}