Troubleshooting Guide

If you clicked through to here, then we expect you are having some trouble with WiConnect. Please accept our apologies; perhaps our documentation is not clear enough or you have found an operational corner case.

The notes in the following sections should get you up and running again quickly. If you are still having trouble after reading through these notes, please log a support ticket.

Basics

Check the power LED is on
When you type into the terminal application (see Getting Started), the UART LED(s) on the evaluation board should blink.

My module fails to associate to the network

Please check each of the following points carefully to help resolve this issue.

Double-triple check the spelling of the network name assigned to wlan.ssid. It is VERY easy to incorrectly enter the name of a network, and especially so if the network name is long and unwieldy.

Check the network password or security key assigned to wlan.passkey. If your network uses WEP (and we sincerely hope it does not since WEP is NOT secure), follow the setup procedure for WEP keys documented in the wlan variable documentation.

Check the value of wlan.security is correctly set. For most networks, this variable should be set to Auto. If you plan to use WEP, wlan.security must be set to WEP.

My module has missing commands or variables. What do I do?

If you enter a valid command or variable and see an Unknown command or Unknown variable or option error, your module may be in Safe Mode. Alternatively an OTA upgrade may have been interrupted before completion.

Recovery from Safe Mode

In safe mode, system.safemode is set to 1, and there is a reduced set of commands and variables (see help all).

To recover from Safe Mode, follow the instructions in Upgrade & Recover, Safe Mode. The essential recovery commands are summarised below.

WiConnect Commands	Description
`faults_reset reboot`	`<- Reset faults counter <- Reboot the module`

Once the module has successfully returned to normal operation, it is advisable to ensure you have the latest WiConnect firmware version. Upgrading to the latest firmware provides your module with the latest fixes to problems, one of which may have caused the module to enter safemode. To upgrade, simply enter the ota command.

Recovery from Interrupted OTA Upgrade

If an OTA upgrade is interrupted, you can resume it and complete the upgrade. You may have to set the wlan.ssid and wlan.passkey variables to rejoin your WLAN. Then run the ota command. When the OTA upgrade completes, your module returns to normal operation.