As discussed in the Getting Started guide, your initial configuration should use the Simple Configuration menu. This guide discusses how to tweak settings after applying your initial configuration. By default, the Simple Configuration
only presents a small subset of all the possible configuration options of the Mesh Rider Radio. For further configuration in the GUI, click the Advanced Settings
button at the bottom left hand corner of the page.
The radio's Mesh Rider wireless settings can be found by navigating to Network -> Wireless
in the GUI. This is where you can configure the Mesh Rider wireless interface. The Wearable (and OEM) variants have an additional WiFi radio which is also configured here, and the Helix variant's band switching is also configured here. These are discussed in the next section.
To modify the wireless settings of the Mesh Rider radio, click Edit
next to the relevant radio interface. You should see a page similar to the one below. We recommend the following updates.
Network interface settings can be modified in the Network -> Interfaces
tab. Below are some common changes you may want to make.
Edit
next to the WAN
interface. You should see a page similar to the picture below. Change the Protocol
from DHCP
to Static Address
. Add an IPv4 address and netmask of your choosing, then scroll to the bottom of the page, and un-check Disable DHCP for this Interface
. Click Save & Apply
.ETH0
. To do this, edit the WAN2
interface, and change the static IP address to your liking.
The default radio network configuration is a mesh, and the configuration settings can be accessed at Network -> Mesh Configuration
. However, this menu is only accessible in the Advanced Settings which is opened by clocking the Advanced Settings
button in the bottom of the left hand side menu bar. Fig. 3 shows the Mesh Configuration Page.
We can tell a particular node not to send packets directly to another node. This could be used for force a mesh hop. This can be done in the GUI under Network Configuration → Mesh Configuration → Peer Filter Configuration
. Input the MAC address of the node that you want to directly block.
This can also be done over the CLI. For a temporary change use:
root@smartradio:~# batctl pr <MAC address>
Different types of traffic can be prioritized in the Traffic Prioritization menu. This is useful when operating in a crowded wireless medium. There are four different queues - Voice, Video, Best Effort, and Background. The Voice queue optimizes latency and may also be used for command and control, the Video queue optimizes throughput, the Best Effort Queue is essentially unoptimized, and the Background queue is for low-priority data.
To use these QoS features, open up the web GUI and navigate to Network -> Traffic
Prioritization
. The Mesh Rider Radio includes software to map different network protocols or ports to the various QoS queues. To do so, click Enable Differentiated Services
, and add a classification rule to suit the application's needs. For example, you can send all UDP traffic to the Video queue which is beneficial for video transmission.
The Mesh Rider Radio includes protocol optimizations for URLLC applications as well as video optimizations. URLLC applications typically include command and control (C&C) data but can be extended to any application requiring a reliable low latency. Let's assume that we have a C&C application which uses network port 7000 over UDP. In the screenshot below, first click the setting Optimize Command & Control for URLLC
. Next click Add
, and then change the new classification rule to use Port 7000
and set the DSCP
value to CS6
. The comment section can be filled in if desired. Finally click Save & Apply and wait for the page to refresh.
Note that if the application uses a large number of telemetry streams, or if the data-rate going over the URLLC channel is too large, then enabling URLLC may actually be detrimental to the performance.
If Optimize Video Streaming
is enabled, the radio will
Video bad link threshold
, then the radio will drop Video bad link (percentage)
packets. This is an optional feature, and you should adjust the RSSI to a reasonable value for your application.The RSSI bad-link threshold is an additional protection against network overload when the link quality is bad, but even without setting the RSSI bad-link threshold, the C&C queue is prioritized over the VI queue.
The Sept 2023 Sense release firmware includes two new checkboxes. The Optimize for Robustness
checkbox replaces the Diversity Rates Only
checkbox in older firmware. This forces the radio to send the same data over both antennas redundantly which leads to smoother performance in highly dynamically changing conditions (e.g. UAVs, UGVs). Note that it also reduces the maximum achievable throughput by 50%.
The Optimize for Latency over Throughput
does what the name implies. It results in improved latency, but the maximum achievable throughput is reduced by approximately half for high MCS rates.
Both of these settings are recommended for mobile robotics applications where low latency, smooth realtime video and C&C are required.
Further Link Optimization is discussed in our RF Link Optimization document.
The Firewall configuration is located under Network -> Firewall
and can be modified over the GUI and CLI at /etc/config/firewall
.
We shall use the iperf3
application as an example to demonstrate setting a firewall rule to allow access to port 5201
of the router. Navigate to the Firewall page, and click the Traffic Rules tab. In the Open ports on router
section, enter the name, protocol, and port number as Allow iperf
, TCP
, and 5201
respectively so that clients are able to connect to port 5201
.
Before port 5201
is opened, run iperf in server mode inside the Mesh Rider Radio.
root@smartradio:~# iperf3 -s
If you try and connect to the iperf server from your local machine, you will get an error Connect
Failed: Connection Refused
. After opening the firewall at port 5201
, you should be able to connect to the iperf3 server.
Extensive information regarding Firewall configuration is available at the http://openwrt.org website.