Manual:Interface/Wireless: Difference between revisions
mNo edit summary |
all props |
||
| Line 83: | Line 83: | ||
=== Advanced settings === | === Advanced settings === | ||
{{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 130: | Line 124: | ||
}} | }} | ||
{{ARG|max-station-count|1..2007|2007|||Maximum number of associated clients. WDS links also count toward this limit.}} | {{ARG|max-station-count|1..2007|2007|||Maximum number of associated clients. WDS links also count toward this limit.}} | ||
{{ARG| | {{ARG|ack-timeout|'indoors', 'dynamic', or value in microseconds|||| | ||
How long to wait for confirmation of unicast frames before considering transmission unsuccessful. Value 'dynamic' causes AP to detect and use smallest timeout that works with all connected clients. | How long to wait for confirmation of unicast frames before considering transmission unsuccessful. Value 'dynamic' causes AP to detect and use smallest timeout that works with all connected clients. | ||
Acknowledgements are not used in Nstreme protocol. | Acknowledgements are not used in Nstreme protocol. | ||
| Line 141: | Line 135: | ||
* manual-table - | * manual-table - | ||
||||}} | ||||}} | ||
{{ARG|dfs-mode|one of 'none', 'no-radar-detect' and 'radar-detect' | {{ARG|dfs-mode|one of 'none', 'no-radar-detect' and 'radar-detect' | ||
|none||| | |none||| | ||
| Line 165: | Line 151: | ||
Setting this property to '0' disables automatic cost adjustment. | Setting this property to '0' disables automatic cost adjustment. | ||
Automatic adjustment does not work for WDS links that are manually configured as a bridge port. | Automatic adjustment does not work for WDS links that are manually configured as a bridge port. | ||
}} | |||
{{ARG|wmm-support|'disabled', 'enabled' or 'required'||||}} | |||
{{ARG|disconnect-timeout|time interval in the 0..15s range, in units of 10ms|3s||| | |||
This interval is measured from third sending failure on the lowest data rate. At this point 3 * (<var>hw-retries</var> + 1) frame transmits on the lowest data rate had failed. | |||
During <var>disconnect-timeout</var> packet transmission will be retried with <var>on-fail-retry-time</var> interval. If no frame can be transmitted successfully during <var>diconnect-timeout</var>, connection is closed, and this event is logged as "extensive data loss". Successful frame transmission resets this timer. | |||
}} | |||
{{ARG|on-fail-retry-time|time interval in the 10ms..1s range, in 10ms units|100ms||| | |||
After third sending failure on the lowest data rate, wait for this long before retrying. | |||
}} | |||
{{ARG|frame-lifetime|time in hundredths of a second|0||| | |||
Discard frames that have been queued for sending longer than <var>frame-lifetime</var>. By default, when value of this property is 0, frames are discarded only after connection is closed. | |||
}} | |||
{{ARG|preamble-mode|one of 'long', 'short' or 'both'|both||| | |||
Short preamble mode is an option of 802.11b standard that reduces per-frame overhead. | |||
On AP: | |||
* long - Do not use short preamble. | |||
* short - Announce short preamble capability. Do not accept connections from clients that do not have this capability. | |||
* both - Announce short preamble capability. | |||
On station: | |||
* long - do not use short preamble. | |||
* short - do not connect to AP if it does not support short preamble. | |||
* both - Use short preamble if AP supports it. | |||
}} | |||
{{ARG|allow-sharedkey|'yes' or 'no'|no|||Allow WEP Shared Key cilents to connect. Note that no authentication is done for these clients (WEP Shared keys are not compared to anything) - they are just accepted at once (if access list allows that). | |||
}} | |||
{{ARG|station-bridge-clone-mac|MAC address||| | |||
This property has effect only in the 'station-pseudobridge-clone' mode. | |||
Use this MAC address when connection to AP. If this value is 00:00:00:00:00:00, station will initially use MAC address of the wireless interface. | |||
As soon as packet with MAC address of another device needs to be transmitted, station will reconnect to AP using that address. | |||
}} | |||
{{ARG|hw-retries|number 0..15|15||| | |||
Number of times sending frame is retried without considering it a transmission failure. | |||
Data rate is decreased upon failure and frame is sent again. Three sequential failures on lowest supported rate suspend transmission to this destination for the duration of <var>on-fail-retry-time</var>. After that, frame is sent again. The frame is being retransmitted until transmission success, or until client is disconnected after <var>disconnect-timeout</var>. Frame can be discarded during this time if <var>frame-lifetime</var> is exceeded. | |||
}} | |||
==== Proprietary extensions ==== | |||
{{ARG|radio-name|Text||||Descriptive name of the device, that is shown in registration table entries on the remote devices. | |||
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|update-stats-interval|'disabled' or time interval in the 10s..5h range|disabled||| | {{ARG|update-stats-interval|'disabled' or time interval in the 10s..5h range|disabled||| | ||
| Line 176: | Line 204: | ||
* post-2.9.25 - This uses standardized way of including vendor specific information, that is compatible with newer wireless clients. | * post-2.9.25 - This uses standardized way of including vendor specific information, that is compatible with newer wireless clients. | ||
}} | }} | ||
{{ARG| | ==== Atheros specific ==== | ||
{{ARG|noise-floor-threshold|'default' or value in the -128..127 range|||| | |||
This | This property is only effective for cards based on AR5211 chipset. | ||
}} | }} | ||
{{ARG| | {{ARG|adaptive-noise-immunity|'yes' or 'no'|yes||| | ||
This property is only effective for cards based on Atheros chipset. | |||
}} | }} | ||
{{ARG| | {{ARG|periodic-calibration|one of 'default', 'enabled' or 'disabled'|||| | ||
Setting 'default' enables periodic calibration if [[M:/interface/wireless/info|/interface/wireless/info]] <var>default-periodic-calibration</var> property is 'enabled'. Value of that property depends on the type of wireless card. | |||
This property is only effective for cards based on Atheros chipset. | |||
}} | }} | ||
{{ARG| | {{ARG|periodic-calibration-interval|value in range 1..10000|60||| | ||
This property is only effective for cards based on Atheros chipset. | |||
}} | }} | ||
==== Prism specific ==== | |||
{{ARG|prism-cardtype|'30mW', '100mW', '200mW'||||Specify type of the installed wireless card. }} | |||
{{ManFooter|Reference}} | {{ManFooter|Reference}} | ||
Revision as of 17:14, 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
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.
}}ack-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: How long to wait for confirmation of unicast frames before considering transmission unsuccessful. Value 'dynamic' causes AP to detect and use smallest timeout that works with all connected clients. Acknowledgements are not used in Nstreme protocol.
|Description: How long to wait for confirmation of unicast frames before considering transmission unsuccessful. Value 'dynamic' causes AP to detect and use smallest timeout that works with all connected clients. Acknowledgements are not used in Nstreme protocol.
}}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:
}}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: Number
}}{{ #if: 100|Default value: 100
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Initial bridge port cost of the WDS links.
|Description: Initial bridge port cost of the WDS links.
}}wds-cost-range
Syntax: Numeric range
}}{{ #if: 50-150|Default value: 50-150
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Bridge port cost of WDS links are automatically adjusted, depending on measured link throughput. Port cost is recalculated and adjusted every 5 seconds if it has changed by more than 10%, or if more than 20 seconds have passed since the last adjustment. Setting this property to '0' disables automatic cost adjustment. Automatic adjustment does not work for WDS links that are manually configured as a bridge port.
|Description: Bridge port cost of WDS links are automatically adjusted, depending on measured link throughput. Port cost is recalculated and adjusted every 5 seconds if it has changed by more than 10%, or if more than 20 seconds have passed since the last adjustment. Setting this property to '0' disables automatic cost adjustment. Automatic adjustment does not work for WDS links that are manually configured as a bridge port.
}}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: 3s|Default value: 3s
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: This interval is measured from third sending failure on the lowest data rate. At this point 3 * (hw-retries + 1) frame transmits on the lowest data rate had failed. During disconnect-timeout packet transmission will be retried with on-fail-retry-time interval. If no frame can be transmitted successfully during diconnect-timeout, connection is closed, and this event is logged as "extensive data loss". Successful frame transmission resets this timer.
|Description: This interval is measured from third sending failure on the lowest data rate. At this point 3 * (hw-retries + 1) frame transmits on the lowest data rate had failed. During disconnect-timeout packet transmission will be retried with on-fail-retry-time interval. If no frame can be transmitted successfully during diconnect-timeout, connection is closed, and this event is logged as "extensive data loss". Successful frame transmission resets this timer.
}}on-fail-retry-time
Syntax: time interval in the 10ms..1s range, in 10ms units
}}{{ #if: 100ms|Default value: 100ms
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: After third sending failure on the lowest data rate, wait for this long before retrying.
|Description: After third sending failure on the lowest data rate, wait for this long before retrying.
}}frame-lifetime
Syntax: time in hundredths of a second
}}{{ #if: 0|Default value: 0
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Discard frames that have been queued for sending longer than frame-lifetime. By default, when value of this property is 0, frames are discarded only after connection is closed.
|Description: Discard frames that have been queued for sending longer than frame-lifetime. By default, when value of this property is 0, frames are discarded only after connection is closed.
}}preamble-mode
Syntax: one of 'long', 'short' or 'both'
}}{{ #if: both|Default value: both
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Short preamble mode is an option of 802.11b standard that reduces per-frame overhead. On AP:
- long - Do not use short preamble.
- short - Announce short preamble capability. Do not accept connections from clients that do not have this capability.
- both - Announce short preamble capability.
On station:
- long - do not use short preamble.
- short - do not connect to AP if it does not support short preamble.
- both - Use short preamble if AP supports it.
Description: Short preamble mode is an option of 802.11b standard that reduces per-frame overhead. On AP:
- long - Do not use short preamble.
- short - Announce short preamble capability. Do not accept connections from clients that do not have this capability.
- both - Announce short preamble capability.
- long - do not use short preamble.
- short - do not connect to AP if it does not support short preamble.
- both - Use short preamble if AP supports it.
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: Allow WEP Shared Key cilents to connect. Note that no authentication is done for these clients (WEP Shared keys are not compared to anything) - they are just accepted at once (if access list allows that).
|Description: Allow WEP Shared Key cilents to connect. Note that no authentication is done for these clients (WEP Shared keys are not compared to anything) - they are just accepted at once (if access list allows that).
}}station-bridge-clone-mac
Syntax: MAC address
}}{{ #if: |Default value:
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: ns:0|Description: {{{6}}}
}}hw-retries
Syntax: number 0..15
}}{{ #if: 15|Default value: 15
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: Number of times sending frame is retried without considering it a transmission failure. Data rate is decreased upon failure and frame is sent again. Three sequential failures on lowest supported rate suspend transmission to this destination for the duration of on-fail-retry-time. After that, frame is sent again. The frame is being retransmitted until transmission success, or until client is disconnected after disconnect-timeout. Frame can be discarded during this time if frame-lifetime is exceeded.
|Description: Number of times sending frame is retried without considering it a transmission failure. Data rate is decreased upon failure and frame is sent again. Three sequential failures on lowest supported rate suspend transmission to this destination for the duration of on-fail-retry-time. After that, frame is sent again. The frame is being retransmitted until transmission success, or until client is disconnected after disconnect-timeout. Frame can be discarded during this time if frame-lifetime is exceeded.
}}Proprietary extensions
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.
}}update-stats-interval
Syntax: 'disabled' or time interval in the 10s..5h range
}}{{ #if: disabled|Default value: disabled
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: How often to request update of signals strength and ccq values from clients. Access to /interface wireless registration-table also triggers update of these values. This is proprietary extension.
|Description: How often to request update of signals strength and ccq values from clients. Access to /interface wireless registration-table also triggers update of these values. This is proprietary extension.
}}proprietary-extensions
Syntax: 'pre-2.9.25' or 'post-2.9.25'
}}{{ #if: post-2.9.25|Default value: post-2.9.25
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: RouterOS includes proprietary information in an information element of management frames. This parameter controls how this information is included.
- pre-2.9.25 - This is older method. It can interoperate with newer versions of RouterOS. This method is incompatible with some clients, for example, Centrino based ones.
- post-2.9.25 - This uses standardized way of including vendor specific information, that is compatible with newer wireless clients.
Description: RouterOS includes proprietary information in an information element of management frames. This parameter controls how this information is included.
- pre-2.9.25 - This is older method. It can interoperate with newer versions of RouterOS. This method is incompatible with some clients, for example, Centrino based ones.
- post-2.9.25 - This uses standardized way of including vendor specific information, that is compatible with newer wireless clients.
Atheros specific
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: This property is only effective for cards based on AR5211 chipset.
|Description: This property is only effective for cards based on AR5211 chipset.
}}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: This property is only effective for cards based on Atheros chipset.
|Description: This property is only effective for cards based on Atheros chipset.
}}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: Setting 'default' enables periodic calibration if /interface/wireless/info default-periodic-calibration property is 'enabled'. Value of that property depends on the type of wireless card. This property is only effective for cards based on Atheros chipset.
|Description: Setting 'default' enables periodic calibration if /interface/wireless/info default-periodic-calibration property is 'enabled'. Value of that property depends on the type of wireless card. This property is only effective for cards based on Atheros chipset.
}}periodic-calibration-interval
Syntax: value in range 1..10000
}}{{ #if: 60|Default value: 60
}}{{ #ifeq: |rq|Required property
}}{{ #ifeq: |ro|Read-only property
}}{{ #ifeq: |unset|This is optional property.
}}{{ #if: This property is only effective for cards based on Atheros chipset.
|Description: This property is only effective for cards based on Atheros chipset.
}}Prism specific
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. |Description: Specify type of the installed wireless card.
}}{{ #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}}}]]}}