2. Radio parameters

2.1. magic - Unique link name

Hint. Enter the same string on both peers

Description. Link name is used to identify the traffic belonging to given radio. The same name should be set on the remote link peer. Otherwise, both incoming and outgoing data would be discarded, disrupting any means of radio communication through this link. This also includes signal level indication, so it is important also for antenna alignment. Additionally, link name is used to generate cryptographic key for traffic confidentiality and authentication. Security provided relies on uniqueness of this parameter. Therefore, it is important not only to make it unique across devices used at certain area, but also to put an effort to make it globally unique and hard to guess by third party. Think of it as a "password" or a "pre-shared key". NOTE: Examples are provided only to show how a good link name would look like, but exactly them, being published here, are no longer secure. Do not use any one of them as that would effectively compromise any security provided by this device.

Value type. text

Default value. duo

Examples.

  • link-1-XYZZY31337

  • f7858e6d95d8dbad

2.2. side - Link side

Hint. Choose different values on both peers

Description. This setting is needed to properly setup antenna polarity. It does not set any of the devices in "master", "client" or similar modes.

Value type. select

Allowed values.

  • A

  • B

Default value. A

2.3. mode - Operating mode

Hint. Chooses the way that radio devices are used

Description. The Full-Duplex mode uses one radio only for receiving, and one only for transmitting the data. Thanks to such approach the link latency is minimized and the bandwidth is maximized in case the traffic being transmitted is symmetric. The Half-Duplex mode can dynamically use both radios for transmitting and receiving, thus maximizing the bandwidth in case the traffic is asymmetric, ie. the traffic being transmitted is much greater than the one being received, or opposite.

Value type. select

Allowed values.

  • fdx (Full-Duplex (1 TX, 1 RX))

  • hdx (Half-Duplex (2 TX/RX))

Default value. fdx

2.4. strict - Strict Ethernet frames order

Description. Turn this option on in order to strictly preserve the order in which Ethernet frames are received from other network devices, thus conforming to IEEE 802.3 standards. Generally it is not required as many protocols can cope with Ethernet frames received in different order. Turning this option off should increase the overall performance and decrease link latency.

Value type. bool

Default value. 0

2.5. freq - Main frequency (MHz)

Description. This option configures the frequency that the first radio operates on. Be sure to select only these frequencies that you are allowed to transmit on.

Value type. select

2.6. freq2 - Secondary frequency (MHz)

Description. This option configures the frequency that the second radio operates on. In automatic mode the second frequency will be chosen basing on the main frequency so seperation between them is maximal. Be sure to select only these frequencies that you are allowed to transmit on.

Value type. select

2.7. width - Channel width (MHz)

Description. This option configures the width of the channel that radio operates on. Be sure to select only the channel width that you are allowed to transmit with.

Value type. select

Allowed values.

  • 5

  • 10

  • 20

  • 40 (*)

Default value. 20

2.8. power - Transmit power

Value type. select

Allowed values.

  • auto (automatic)

  • 100% (18dBm)

  • 90% (16dBm)

  • 80% (14dBm)

  • 70% (13dBm)

  • 60% (11dBm)

  • 50% (9dBm)

  • 40% (7dBm)

  • 30% (5dBm)

  • 20% (4dBm)

  • 10% (2dBm)

  • 0% (0dBm)

2.9. maxpower - Maximum transmit power

Value type. select

Allowed values.

  • 100% (18dBm)

  • 90% (16dBm)

  • 80% (14dBm)

  • 70% (13dBm)

  • 60% (11dBm)

  • 50% (9dBm)

  • 40% (7dBm)

  • 30% (5dBm)

  • 20% (4dBm)

  • 10% (2dBm)

  • 0% (0dBm)

2.10. modulation - Modulation

Value type. select

Allowed values.

  • auto (automatic)

  • 0 (BPSK, r=1/2)

  • 1 (BPSK, r=3/4)

  • 2 (QPSK, r=1/2)

  • 3 (QPSK, r=3/4)

  • 4 (16-QAM, r=1/2)

  • 5 (16-QAM, r=3/4)

  • 6 (64-QAM, r=2/3)

  • 7 (64-QAM, r=3/4)

2.11. framesize - Radio frame size

Value type. select

Allowed values.

  • auto (automatic)

  • 500

  • 900

  • 1400

  • 1800

  • 2300

  • 2700

  • 3100

  • 3600

  • 4000

2.12. txcont - Continuous transmission

Hint. Radio transmits regardless of the actual payload. Useful for medium reservation.

Description. Continuous transmission forces the radio to transmit frames as fast as possible, what leads to full utilization of the medium regardless of the actual payload. It delivers a functionality of reporting link capabilities without a need to generate any traffic externally. Also, it contributes to faster adaptation of transmission parameters. This feature is available only in Full-Duplex mode.

Value type. bool

Default value. 0

2.13. shortifs - Short inter-frame spaces

Description. Enabling short inter-frame spaces increases the maximum achievable throughput and link stability at the expense of disabling cooperation with other devices operating on the same frequency. This feature is available only in Full-Duplex mode.

Value type. bool

Default value. 0

2.14. sampling - Sampling intensity

Description. Algorithm performing optimization of transmission parameters requires continuous sampling in order to follow changing conditions. Sampling is realized by sending frames with suboptimal parameters, which causes decrease of resultant throughput. This parameter specifies maximum fraction of the radio throughput that can be sacrificed for the purpose of sampling. Higher value can result in faster and more precise reaction to changes of transmission conditions.

Value type. select

Allowed values.

  • 1%

  • 2%

  • 5%

  • 10%

  • 20%

  • 30%

  • 40%

  • 50%