Команда служит для настройки радиоинтерфейса устройства.
Синтаксис:
Master#1> rfconfig
usage: rf interface parameters...
Interface rf5.0 parameters:
band XXX: bandwidth (MHz)
grid B G: frequency grid - <bw> freq1[-freq2[/step]],... | clear
freq XXX: central frequency (MHz)
bitr XXX: bitrate (Kbps)
txpwr XXX: tx power (dBm)
sid XXX: system identifier - up to 8 hex digits [10101010]
cap [full]: RF capabilities
txrt XXX: max transmit retries [7]
txvrt XXX: max transmit retries in voice mode [5]
[-]burst : burst mode (Super Packeting)
[-]shortgi: short guard interval mode
[-]pwrctl : automatic TPC mode
mimo|miso
[-]misoctl
[-]greenfield
ПРЕДОСТЕРЕЖЕНИЕ
Не все радио интерфейсы имеют одинаковый набор параметров и опций, поскольку они зависят от типа и стандарта используемого радио модуля. Полный список опций поддерживаемых конкретным интерфейсом можно посмотреть непосредственно на устройстве командой "rf rfNAME ?". Тип радио модуля и перечень его свойств можно посмотреть командой "rf rfNAME cap".
- "band XXX" - данная опция устанавливает ширину полосы излучения: double – 40 МГц, full – 20 МГц, half – 10 МГц, quarter – 5 МГц. Возможность переключения между различными ширинами полос определяется лицензией. В пределах одной беспроводной сети устройства должны иметь одинаковые настройки данного параметра
- "grid B G" – данная опция позволяет изменять частотную сетку и шаг распределения частот в пределах лицензионных ограничений, т.е конструировать собственный рабочий список частот.
Сетка частот формируется для каждой полосы в виде списка поддиапазонов (начальная_частота–конечная_частота/шаг), либо отдельных частот, перечисленных через запятую.
Синтаксис:
IFNAME grid BAND FREQUENCY_RANGE_LIST
Например,
rf rf5.0 grid 40 4920-5940/5 rf rf5.0 grid 20 5310-5390/10,5450,5500-5580/20 rf rf5.0 grid 10 5480, 5500, 5520, 5540, 5560, 5580
Получившийся список будет отображаться в свойствах радиоинтерфейса (команда «rf cap») и использоваться во всех случаях, когда частота задаётся автоматически ("roaming", "dfs" и т.д.).
Для удаления сформированной частотной сетки используется следующая команда:
rf IFNAME grid BAND clear
При этом будет восстановлен исходный рабочий список частот, определённый в лицензии устройства.
- "freq XXX" – центральная рабочая частота, задается в мегагерцах. В пределах одной беспроводной сети устройства должны иметь одинаковые настройки данного параметра. Список доступных частот можно посмотреть командой "rf rfNAME cap".
- "bitr XXX" - скорость радиоканала (в килобитах в секунду). Возможные значения:
- Для устройств на 2 ГГц: 11000, 5500, 2000, 1000 килобит в секунду.
- Для устройств на 5-6 ГГц: 6000, 9000, 12000, 24000, 36000, 48000, 54000 Кбит/с.
- Для устройств Xm:
- 5 МГц: 3250, 6500, 9750, 13000, 19500, 26000, 29250, 32500 Кбит/с
- 10 МГц: 6500, 13000, 19500, 26000, 39000, 52000, 58500, 65000 Кбит/с
- 20 МГц: 13000, 26000, 39000, 52000, 78000, 104000, 117000, 130000 Кбит/с
- 40 МГц: 30000, 60000, 90000, 120000, 180000, 240000, 270000, 300000 Кбит/с.
- "txpwr XXX" - задаёт мощность излучения передатчика в dBm. Конкретные значения допустимых уровней мощности могут меняться в зависимости от типа установленного радио модуля. Полный список уровней мощности поддерживаемых данным радио модулем можно посмотреть командой "rf <IFNAME> capabilities".
- "sid XXX" - идентификатор сети, число от 1H до FFFFFFH. Всем устройствам, которые должны видеть друг друга в радиоканале, необходимо иметь одинаковый идентификатор
- "cap (capabilities)" - отображает внутреннюю информацию об используемом радио модуле, в том числе допустимые значения мощности передатчика, перечень поддерживаемых частот и т.д.
- "dist XXX (distance)" - устанавливает расстояние между устройствами (в километрах). Этот параметр изменяет значения задержек и таймаутов, оптимизируя работу радио соединения.
Параметр «dist» работает только при отправке пакетов, поэтому он должен быть установлен на каждом устройстве сети.
Существует несколько способов управления этим параметром:
- Установить точное значение расстояния вручную
- Включить автоматическое определение расстояния (включено по умолчанию): "rf rf5.0 dist auto". При просмотре конфигурации, после параметра «auto» показывается текущее установленное значение: "auto (XX)".
При установке значения 0 параметр "dist" используются настройки радио модуля по умолчанию.
- "txrt XXX (transmit retries)" - задаёт максимальное количество переповторов при отправке "unicast" пакетов. По умолчанию 15
- "txvrt XXX (transmit voice retries)" - максимальное количество переповторов для пакетов данных (не голосовых) в голосовом режиме, по умолчанию 5. Голосовой режим (Voice Mode) включается автоматически при появлении трафика VoIP. Максимально допустимое значение - 64 переповтора
- "burst" - включает поддержку протокола BURST. Этот режим позволяет существенно сократить количество коротких пакетов в эфире и уменьшить время отклика при интенсивных потоках коротких пакетов. Включение опции "burst" относится ко всему радио-интерфейсу и означает только то, что вы хотите использовать этот режим в данном устройстве. Включение этой опции не влияет на работу остальных устройств функционирующих в сети. Некоторую статистику использования протокола можно посмотреть по команде "muf stat". “-burst” отключает поддержку протокола. По умолчанию включено
- "shortgi" - включает режим укороченного охранного интервала (short guard interval). Использование укороченного охранного интервала позволяет увеличить пропускную способность радиоканала за счёт уменьшения временной паузы между передаваемыми символами. Однако, если длительность охранного интервала превысит максимальное время задержки распространения сигнала в канале, то это приведет к межсимвольной интерференции и, как следствие, росту числа ошибок при передаче. “-shortgi” отключает данный режим. По умолчанию включено
- "pwrctl" - включает режим автоматического управления мощностью передатчика (ATPC). В этом случае устройство будет стремиться поддерживать оптимальную мощность передатчика, обеспечивающую уверенный приём своих пакетов на противоположной стороне радио соединения. “-pwrctl” отключает данный режим. По умолчанию включено
- "mimo|miso" - выбор режима: MIMO либо MISO.
- "misoctl" -
- "-misoctl" -
- "greenfield" - включает режим "Greenfield" на устройстве (более подробно о режиме Greenfield можно узнать на данной странице)
- "-greenfield" - отключает режим "Greenfield" на устройстве.
- "rf IFNAME stat" - выводит на экран текущую статистику радиомодуля
Нижеприведенные таблицы описывают выводимые данной командой параметры.
Вывод команды "rf stat" для устройств 2.4 ГГц | |
---|---|
Beacons Received |
|
Beacons Transmitted |
|
Ack Packets Transmitted |
|
RTS Packets Transmitted |
|
CTS Packets Transmitted |
|
PLCP CRC Errors |
|
Single Collisions |
|
PLCP Format Errors |
|
Polling cache aged |
|
PLCP Length Errors |
|
No Deferral |
|
MAC CRC Errors |
|
Deferred Protocol |
|
Partial Received |
|
Deferred Energy Detect |
|
SSID Mismatches |
|
Retry Long |
|
AP Mismatches |
|
Retry Short |
|
Data Rate Mismatches |
|
Authentication Rejects |
|
Ack Received |
|
Authentication T/O |
|
No Ack Received |
|
Association Rejects |
|
CTS Received |
|
Association T/O |
|
No CTS Received |
|
Packets Aged |
|
Noise Floor |
|
Noise Floor Threshold |
|
Вывод команды "rf stat" для устройств 5 ГГц | |||
Broadcast Rate 130000 | Voice Mode OFF | RF rf5.0 status UP (band 20, freq 4900) :ACTIVE DFS status OFF TDMA status Master (5 ms DL/UL:Auto) (DL2500/UL2500) (PTP mode) | Статус интерфейса (ширина канала, частота), состояние Статус DFS (отключен) Статус TDMA (Размер фрейма 5мс, соотношение DL/UL:автоматически) | ||
Параметр | Значение | Параметр | Значение |
---|---|---|---|
Receive statistics | Статистика полученных данных | Transmit statistics | Статистика переданных данных |
Broadcast Rate |
| Voice Mode |
|
Bytes Received |
| Bytes Transmitted |
|
Frames Received OK |
| Frames Transmitted OK |
|
Multicast Frames |
| Multicast Frames |
|
Load (kbps) |
| Load (kbps) |
|
Load (pps) |
| Load (pps) |
|
Frame size (bytes) |
| Frame size (bytes) |
|
Medium Load | Frame Time Used | ||
Medium Busy | Too Short Frame | ||
Duplicate Received |
| Too Long Frame | |
Lost frames |
| Aggr Subframe Retries |
|
Rx Collision | Aggr Full Retries |
| |
FIFO Overrun |
| FIFO Underrun |
|
CRC Errors |
| Excessive Retries |
|
Noise Floor |
| Max aggr frames |
|
Rx Subslots |
| Max aggr bytes |
|
Scrambled frames | Scrambled frames | ||
Scramble errors | Tx queue overflow | ||
Rx Time Limit (us) |
| Tx Time Limit (us) |
|
Rx Cap (Mbps) |
| Tx Cap (Mbps) |
|