Difference between revisions of "Manual:Interface/Wireless"

From MikroTik Wiki
Jump to navigation Jump to search
(new content added)
m
Line 81: Line 81:
=== Basic information (read only properties) ===
=== Basic information (read only properties) ===
{{ARG|interface-type|'virtual-AP', 'Prism', or 'Atheros <em>model_name'</em>||||This specifies type of wireless interface. Some properties have meaning only for certain types of interfaces.}}
{{ARG|interface-type|'virtual-AP', 'Prism', or 'Atheros <em>model_name'</em>||||This specifies type of wireless interface. Some properties have meaning only for certain types of interfaces.}}


=== Advanced settings ===
=== Advanced settings ===
Line 131: Line 130:
}}
}}
{{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|act-timeout|'indoors', 'dynamic', or value in microseconds||||}}
{{ARG|act-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.
Acknowledgements are not used in Nstreme protocol.
}}
{{ARG|tx-power|value in the -30..30 range||||}}
{{ARG|tx-power|value in the -30..30 range||||}}
{{ARG|tx-power-mode|one of these values:
{{ARG|tx-power-mode|one of these values:
Line 139: Line 141:
* manual-table -
* manual-table -
||||}}
||||}}
{{ARG|noise-floor-threshold|'default' or value in the -128..127 range||||}}
{{ARG|noise-floor-threshold|'default' or value in the -128..127 range||||
{{ARG|periodic-calibration|one of 'default', 'enabled' or 'disabled'||||}}
This property is only effective for cards based on AR5211 chipset.
{{ARG|periodic-calibration-interval|value in range 1..10000||||}}
}}
{{ARG|burst-time|'disabled', or value in microseconds||||}}
{{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.
}}
{{ARG|periodic-calibration-interval|value in range 1..10000|60|||
}}
{{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 152: Line 158:
This property has effect only in AP mode.
This property has effect only in AP mode.
}}
}}
{{ARG|wds-default-cost|||||}}
{{ARG|wds-default-cost|Number|100|||
{{ARG|wds-cost-range|||||}}
Initial bridge port cost of the WDS links.
{{ARG|update-stats-interval|'disabled' or time interval in the 10s..5h range||||}}
}}
{{ARG|proprietary-extensions|'pre-2.9.25' or 'post-2.9.25'||||}}
{{ARG|wds-cost-range|Numeric range|50-150|||
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.
}}
{{ARG|update-stats-interval|'disabled' or time interval in the 10s..5h range|disabled|||
How often to request update of signals strength and ccq values from clients.
Access to [[M:/interface wireless registration-table|/interface wireless registration-table]] also triggers update of these values.
This is proprietary extension.
}}
{{ARG|proprietary-extensions|'pre-2.9.25' or 'post-2.9.25'|post-2.9.25|||
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.
}}
{{ARG|wmm-support|'disabled', 'enabled' or 'required'||||}}
{{ARG|wmm-support|'disabled', 'enabled' or 'required'||||}}
{{ARG|disconnect-timeout|time interval in the 0..15s range, in units of 10ms||||}}
{{ARG|disconnect-timeout|time interval in the 0..15s range, in units of 10ms|3s|||
{{ARG|on-fail-retry-time|time interval in the 10ms..1s range, in 10ms units||||}}
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.
{{ARG|preamble-mode|one of 'long', 'short' or 'both'||||}}
If during <var>disconnect-timeout</var> ____nothing happens, then client will be disconnected. This event is logged as "extensive data loss".
}}
{{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|preamble-mode|one of 'long', 'short' or 'both'|both|||}}
{{ARG|allow-sharedkey|'yes' or 'no'||||}}
{{ARG|allow-sharedkey|'yes' or 'no'||||}}
{{ARG|station-bridge-clone-mac|MAC address of ______||||}}
{{ARG|station-bridge-clone-mac|MAC address of ______||||}}
Line 169: Line 194:
{{ARG|ht-rxchains|1, 5 or 7||||}}
{{ARG|ht-rxchains|1, 5 or 7||||}}
{{ARG|hw-retries|number 0..15||||}}
{{ARG|hw-retries|number 0..15||||}}
{{ARG|frame-lifetime|||||}}
{{ARG|frame-lifetime|time in hundredths of a second|0|||
{{ARG|adaptive-noise-immunity|'yes' or 'no'|yes|||}}
}}
{{ARG|adaptive-noise-immunity|'yes' or 'no'|yes|||
 
}}


{{ManFooter|Reference}}
{{ManFooter|Reference}}

Revision as of 13:18, 19 March 2008

Basic settings

master-interface
{{ #if: interface name|

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
{{ #if: one of 'station', 'station-wds', 'ap-bridge', 'bridge', 'alignment-only', 'nstreme-dual-slave', 'wds-slave', 'station-pseudobridge' or 'station-pseudobridge-clone' |

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 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.

}}
ssid
{{ #if: text, up to 32 characters long|

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
{{ #if: Frequency value in MHz.|

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
{{ #if: 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'|

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
{{ #if: comma separated list of frequencies and frequency ranges, or 'default'|

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
{{ #if: 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
|

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

}}{{ #if: |

Default value:

}}{{ #ifeq: |rq|

Required property

}}{{ #ifeq: |ro|

Read-only property

}}{{ #ifeq: |unset|

This is optional property.

}}{{ #if: |

Description:

}}
wds-mode
{{ #if: one of 'disabled', 'static', 'dynamic', 'static-mesh' or 'dynamic-mesh'|

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.
'-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.

}}
wds-default-bridge
{{ #if: 'none', or name of bridge interface|

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
{{ #if: 'yes' or 'no'|

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
{{ #if: 'yes' or 'no'|

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
{{ #if: 'yes' or 'no'|

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
{{ #if: |

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
{{ #if: |

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
{{ #if: 'yes' or 'no'|

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.
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.

}}
security-profile
{{ #if: name of profile from /interface/wireless/security-profiles|

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
{{ #if: 'yes' or 'no'|

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
{{ #if: 'virtual-AP', 'Prism', or 'Atheros model_name'|

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
{{ #if: '30mW', '100mW', '200mW'|

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
{{ #if: Text|

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
{{ #if: Text|

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
{{ #if: 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.
|

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.

}}{{ #if: |

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
{{ #if: either 'no_country_set', or name of regulatory domain|

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
{{ #if: |

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.

}}
Default basic and supported rates, depending on selected band
bandbasic ratessupported rates
2.4ghz-b11 .. 11
5ghz66 .. 54
2.4ghz-onlyg61 .. 11 and 6 .. 54
2.4ghz-b/g1 .. 111 .. 11 and 6 .. 54
2.4ghz-g-turbo66 .. 54
rate-set
{{ #if: 'default' or 'configured'|

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
{{ #if: |

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
{{ #if: |

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
{{ #if: |

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
{{ #if: |

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
{{ #if: 1..2007|

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
{{ #if: 'indoors', 'dynamic', or value in microseconds|

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
{{ #if: value in the -30..30 range|

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
{{ #if: one of these values:
  • default -
  • all-rates-fixed -
  • card-rates -
  • manual-table -
|

Syntax: one of these values:

  • default -
  • all-rates-fixed -
  • card-rates -
  • manual-table -

}}{{ #if: |

Default value:

}}{{ #ifeq: |rq|

Required property

}}{{ #ifeq: |ro|

Read-only property

}}{{ #ifeq: |unset|

This is optional property.

}}{{ #if: |

Description:

}}
noise-floor-threshold
{{ #if: 'default' or value in the -128..127 range|

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.

}}
periodic-calibration
{{ #if: one of 'default', 'enabled' or 'disabled'|

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.

|

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.

}}
periodic-calibration-interval
{{ #if: value in range 1..10000|

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:

|

Description:

}}
dfs-mode
{{ #if: one of 'none', 'no-radar-detect' and 'radar-detect' |

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.
This property has effect only in AP mode.

}}
wds-default-cost
{{ #if: Number|

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
{{ #if: Numeric 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.

}}
update-stats-interval
{{ #if: 'disabled' or time interval in the 10s..5h range|

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
{{ #if: 'pre-2.9.25' or 'post-2.9.25'|

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.

}}
wmm-support
{{ #if: 'disabled', 'enabled' or 'required'|

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
{{ #if: time interval in the 0..15s range, in units of 10ms|

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. If during disconnect-timeout ____nothing happens, then client will be disconnected. This event is logged as "extensive data loss".

|

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. If during disconnect-timeout ____nothing happens, then client will be disconnected. This event is logged as "extensive data loss".

}}
on-fail-retry-time
{{ #if: time interval in the 10ms..1s range, in 10ms units|

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.

}}
preamble-mode
{{ #if: one of 'long', 'short' or 'both'|

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: |

Description:

}}
allow-sharedkey
{{ #if: 'yes' or 'no'|

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
{{ #if: MAC address of ______|

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
{{ #if: comma separated list of numbers 1..8|

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
{{ #if: 'long', 'short' or 'both'|

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
{{ #if: '20mhz', '40mhz' or '2040mhz'|

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
{{ #if: 'single', 'double' or 'both'|

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
{{ #if: 1, 5 or 7|

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
{{ #if: 1, 5 or 7|

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
{{ #if: number 0..15|

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
{{ #if: time in hundredths of a second|

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:

|

Description:

}}
adaptive-noise-immunity
{{ #if: 'yes' or 'no'|

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}}}]]}}