Troubleshooting

If you encounter unexpected performance or other problems with the IoE Module, start here to find a solution.

Configuration problems

Configuration issues are related to communication between the IoE Module and attached sensors.

  • SDI-12 devices not registered on the IoE module?
  • Go through the steps in Adding sensors to configure the sensors.
  • Unsupported device?
  • Currently, the IoE module supports the LI-710 and Stevens HydraProbe. Contact LI-COR to request support for more sensors.
  • Device cable disconnected?
  • If a sensor has been configured but the cable is disconnected as you go through the configuration steps, the IoE Module will issue an error (Network check FAILED. Try again?). Be sure the cables for all sensors are connected and select YES to try again.

Cellular or network problems

  • Adequate cellular signal strength?

  • Be sure there is a strong cellular signal. If you are near the IoE Module, check the signal status on the IoE module. From the home screen, press right () and down () to view the status. You should see signal strength and the name of the cellular provider. Expect a signal strength between -50 dBm (strong signal) and -120 dBm (weak signal). Press Select to send a test data message to LI-COR Cloud. If you see any message besides PASS, or if the signal strength is outside the expected range, contact LI-COR.
    Modem status information presents information and test options.

Power on problems

Power supply problems can be resolved by checking the cable connections and voltage of the source. A multimeter may be useful for measuring voltages.

  • Power cables connected properly?
  • See Attaching the solar power supply or Using an external power supply.
  • External power supply problems?
  • If using an external power supply, be sure it provides 10 to 33 VDC with 2.2 amp capacity.
  • Battery depleted?
  • Measure the battery voltage with a multi-meter. If it is less than 11 volts, the device will power off until the battery voltage is above 12. Allow the battery to charge from the solar panel or charge it with a compatible external charger. If the solar panel is not delivering enough power to charge the battery, clean it and adjust the angle and orientation so it faces the sun.

Conditions and classes

The device interface presents classes and conditions that indicate a problem. It also gives the most likely solution. Press left () once view Conditions.

With the exception of conditions that are triggered during the startup cycle, conditions will remain visible on the display until cleared, even if the issue is resolved. This is intentional so that operators can observe conditions that have been triggered previously. Press Select to clear past conditions and show only current conditions.

Table 5‑1. Classes, conditions, and the meaning.
Class Condition Meaning
Battery Battery not connected No voltage measured from a battery. Check battery connections.
Battery Voltage low Critically low battery voltage. Apply external power or use solar charger.
Battery Voltage high Charger malfunction.
Battery Load current high System board malfunction – drawing too much power.
Battery Charge current high Charger malfunction; possible short circuit in battery system.
Battery Rntc out of range Internal temperature sensor malfunctioning.
Cloud Can't connect to MQTT broker Cellular data is fine but connection to cloud back-end was refused. Most likely a security problem.
Cloud Last cloud session failed There was a problem during the previous cloud session. This should resolve at the next cloud session. If this persists, there's something else wrong.
Config Bad or missing SDI-12 network info SDI-12 Network is not configured. Run the configuration tool.
Config Bad or missing modem info CRITICAL PROVISIONING FAILURE – important configuration data for cellular connectivity is missing1,2.
Config Bad or missing cloud info CRITICAL PROVISIONING FAILURE – device credentials for accessing the cloud service are missing1,2.
Config No security certs CRITICAL PROVISIONING FAILURE – device has no security certificates1,2.
Config Bad or missing sensor info Sensor configuration information missing (this is downloaded from the LI-COR Cloud). This code should resolve itself at the next successful cloud session. Measurements cannot be obtained from a sensor with this problem.
Config <sensor name> not supported The named sensor is not supported by IoE.
Config Bad or missing schedule There is no schedule for measurements (run the configuration tool) or a schedule refers to a sensor for which configuration data is not available (should resolve at next successful cloud session).
GPS Not locked GPS location is unknown (also cannot synchronize to GPS time).
Logger Card not mounted SD card is either not present or was not mounted using the mount button3.
Logger SD card FULL SD card is <5% free4.
Logger SD card nearly full SD card is <25% free.
Logger Sensor data cache nearly full The IoE is nearly out of room to hold data in RAM.
Logger Sensor data cache FULL The IoE is out of room to hold data in RAM. If an SD card is mounted and not full, data is also backlogged there, so nothing will be lost in this case.
Modem Can't connect to network Modem cannot connect to cellular network. SIM card issue, perhaps. Maybe no coverage or signal strength issue.
Modem Low or no signal Cellular signal is critically low or no connection at all.
Modem Modem unresponsive or missing CRITICAL HARDWARE PROBLEM – cellular modem is malfunctioning.
SDI-12 <sensor name> Read failure Malfunction while reading this sensor.
SDI-12 <sensor name> Sensor doc bad or missing Sensor configuration data went missing. This is unexpected but should self-correct at the next successful cloud session.
SDI-12 Bus voltage low SDI-12 power supply malfunction or excessive load attached.
SDI-12 Bus voltage high SDI-12 power supply malfunction or possibly there is an external power source applied (don't do that).
SDI-12 Bus current high Excessive draw from attached SDI-12 sensors or wiring fault.
System DEVICE MISSING SERIAL CRITICAL PROVISIONING FAILURE – device has no serial number. This is indicative of acute system failure. Contact LI-COR.
System No cloud connection since restart This is a transient notice that simply lets you know the system has restarted and not yet successfully talked to the cloud service.
System Scheduler halted CRITICAL SYSTEM FAILURE – no measurements will be taken. Probably due to not being configured properly.
System Uploader halted CRITICAL SYSTEM FAILURE – no data will be sent to the cloud. If there is an SD card, CSV files will still be written and backlog data will be kept for when the uploader restarts. The uploader is halted by the configuration tool but should be running at all other times.

Interface is unresponsive

If the IoE Module interface becomes unresponsive (no longer responding to button presses), and stays that way for more than a few minutes, you can force the device to restart.

  • Force power off: Press and hold the power button for 5 seconds. The IoE module will shut down inelegantly and open data files may be lost.

  • Disconnect the power supply: As a last resort, if the none of the buttons are responsive, disconnect the power supply for 30 seconds to a minute. Reconnect the power and restart the system. Allow a few minutes for the device to start. If the unresponsive behavior persists, contact LI-COR.

Persistent power cycling or unstable behavior

If you observe continuous restarts or unpredictable behavior in the interface that is not resolved by restarting the device, you can take more drastic measures and restore the IoE Module to the factory configuration.

Before doing this, however, check the power supply to make sure the IoE module is getting enough power to operate. If the battery voltage is close to 11 volts, it may be too low and the battery should be charged before attempting a factory reset. Check the cellular signal strength. Although poor signal strength will not cause power cycling, it could cause delays in the interface, which are easily confused with unstable behavior.

After verifying that the problem is unrelated to power or signal strength, factory reset may be the best option. Factory reset will clear everything from the IoE Module except the factory provisioning data (cellular network, LI-COR Cloud services, security credentials, device serial number).

To perform the factory reset:

  1. Power-off the device.

  2. Press and hold UP and MOUNT/DISMOUNT simultaneously.

  3. While UP and MOUNT/DISMOUNT are pressed, short press the POWER button.

  4. Continue to hold UP and MOUNT/DISMOUNT until the screen with the version info below the product name is displayed.

  5. Release all buttons and allow the IoE module to finish starting up.

  6. After resetting, you must re-configure SDI-12 sensors and schedules.

LI-COR Cloud issues

If you configured everything but do not see data on LI-COR Cloud, you may just need to wait at least 10 but possibly 30 or more minutes for results to be published. As you wait, you can check things on the IoE Module.

Check status of the IoE Module display. It is normal for several messages to be in the queue, but if there are many and the number is increasing over time, there may be an issue.

Check the SDI-12 configuration. From the home screen, press right once and down three times to select SDI-12. Press Select and the IoE Module will scan all SDI-12 ports and report the status. It will give Last Seen and the time of that communication. The time indicated should be recent, and if so, everything is working, and you should just wait for the data to be presented on LI-COR Cloud. See SDI-12 status for more details.

Finally, be sure that the IoE Module has been registered with LI-COR Cloud and that you have an account that allows you to view data from this IoE Module.