Resolve Issues with Radio Setup Validation

Issue

Once you have connected and set up your radio using the Radio Setup wizard, the Validate step runs several tests to verify the correct configuration of the host and radio. If any of these tests fail, the wizard prompts you to take additional actions.

Possible Solutions

Host IP Address Configuration Test

If the host IP address configuration test fails, check that the host IP address that you selected in the Select Link Configuration step in the wizard matches the host network configuration of the host operating system (OS).

Host-Radio Connection Test

If the host-radio connection test fails:

Check that you are using the correct cable and that the physical connection between the radio and host is through the correct ports. For more information, see Resolve Issues with Connecting Radio to Host.
Check that the radio is on or try turning the radio off and on again.
Go back to the Set Up SD Card step in the wizard and set up the SD card again with a compatible image.
On a Windows^® OS, check the status of your NIC by entering ipconfig in the command window. If the media state is Media disconnected, follow these steps.
1. Open Windows Device Manager.
2. On the relevant network adapter, right click and select Properties.
3. In the Advanced tab, select the Speed & Duplex property and set to 1.0 Gbps Full Duplex. Click OK to apply.
4. Return to the menu and reset the Speed & Duplex property to Auto Negotiate. Click OK to apply.
If connection issues persist, try turning on your radio and allowing it to boot before you boot your host computer.

Radio Filesystem Image Version Test

If the version test fails for a USRP™ N3xx radio and your device has a UHD™ version earlier than 4.0, return to the Set Up SD Card step in the wizard and rewrite the SD card.

Otherwise, if the version test fails for a USRP N3xx or X410 radio, follow these steps to update the radio filesystem using the wizard.

Disable any OS firewall for the host network interface that is connected to the radio.
Click Update Image and follow the steps to download, validate, and update the image.

Note

Closing MATLAB^® during a radio filesystem update can leave an incomplete file on the radio filesystem. This can cause the process to fail the next time you try to update the image. The log file will indicate the following error.

There is not enough space on your device. Mounting point: <>; 
space required: <> kB; space available: <> kB. 
Free up space and try again.

To resolve this, reboot the device and try again.

If the version validation of the NI™ USRP N3xx or X410 radio filesystem image fails after you follow the steps to update the filesystem using the wizard, you can update the filesystem manually. If your host computer has a Windows OS, OpenSSH Client is required.

Follow the steps in the wizard to download, extract, and validate the correct filesystem image file.
Update your radio filesystem by using a Windows PowerShell or Linux^® terminal. By default, the radio IP address is 192.168.10.2. If you configured your radio with a different IP address in the network configuration step of the wizard, specify that IP address instead of 192.168.10.2 in these commands.
1. Copy the extracted .mender filesystem image file onto the radio. If necessary, provide the full path to the image file.
```
$ scp -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no \
 <mender_filesystem_image> root@192.168.10.2:/tmp/wt-uhd-image.mender
```
2. Log in to the radio.
```
$ ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no \
root@192.168.10.2
```
3. Install the new filesystem image. Then restart your radio. These steps take several minutes.
```
# mender install /tmp/wt-uhd-image.mender
# reboot
```
4. Log in to the radio.
```
$ ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no \
root@192.168.10.2
```
5. Make the filesystem changes permanent on the radio.
```
# mender commit
```
For more information on updating the radio filesystem, see Installing the Mender Artifact on the hardware vendor website.
Return to the Radio Setup wizard and follow the instructions to revalidate your radio setup.

Host OS Optimization Test

The Radio Setup wizard validates the optimization settings on your OS. Any validation failure that occurs during this teat does not stop you from progressing to the next wizard step. However, if the host OS optimization test fails, you can manually update your OS.

On a Windows OS, follow these steps:
1. Locate the FastSendDatagramThreshold.reg file at UHD_INSTALL/win64 path by running these commands in MATLAB.
```
>> uhd_install_location = getUHDInstallLocation
>> winopen(fullfile(uhd_install_location,'win64'))
```
2. Run the FastSendDatagramThreshold.reg file.
3. Restart your computer.

On a Linux OS, run these commands in a terminal:

`echo "net.core.rmem_max=2500000" | sudo tee -a /etc/sysctl.conf`
`echo "net.core.wmem_max=2500000" | sudo tee -a /etc/sysctl.conf`
`sudo sysctl -p`

Radio Transmit and Receive Test

During the final validation test, the Radio Setup wizard validates the data transfer by transmitting and receiving a test waveform. Any validation failure that occurs during this step does not stop you from progressing. However, you can take the following steps:

Fix any OS optimization test failure that occurs in the previous validation test. For details, see Host OS Optimization Test.
Disable any OS firewall for the host network interface that is connected to the radio.
Check that you have attached an antenna or a loopback cable to the correct port.