Troubleshooting Guide

If you clicked through to here, then we expect you are having some trouble with Gecko OS. 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.


My device fails to associate to the network

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

My device 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 device may be in Safe Mode. Alternatively an OTA update may have been interrupted before completion.

Recovery from Safe Mode

In safe mode, system.safemode.status 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 Update and Recovery, Safe Mode. The essential recovery commands are summarised below.

Gecko OS Commands Description

<- Reset faults counter
<- Reboot the device

Once the device has successfully returned to normal operation, it is advisable to ensure you have the latest Gecko OS firmware version. Upgrading to the latest firmware provides your device with the latest fixes to problems, one of which may have caused the device to enter safemode.

TLS Errors

If when attempting a TLS connection, you receive an error message such as TLS malloc failed, then Gecko OS may be low on memory. See Networking and Security, Increasing Available Memory for TLS.

Using the Gecko OS IDE/SDK, my Application Compiles Slowly on Windows 10+

This may be due to an interaction with Windows Defender. It may help to configure Defender to ignore the make.exe and make_util.exe processes.