Troubleshooting

Sensor Homepage and HTTP Server

The sensor HTTP server page http://os-991900123456.local/ has information about the sensor system information, sensor status, firmware and configuration. To learn more about Web UI and it’s use to troubleshoot the sensor, Please see the Web Interface portion of this user manual

Note

Please contact our Field Application Team and we can answer your questions and provide guidance for achieving proper operations.

Networking

Many initial problems with the sensor are associated with it not properly being assigned an IP address by a network switch or DHCP server on a client computer. Check your networking settings, the steps in Connecting to Sensor, and that all wires are firmly connected if you suspect this problem. Note that if the sensor is not connected via gigabit Ethernet, it will stop sending data and will output an error code if it fails to achieve a 1000 Mb/s+ full duplex link. Please see the Networking Guide for detailed guidance on network setup.

Get Alerts

To check for hardware errors, use the get_alerts TCP command.

If the watchdog is triggered, an alert code will be appended to the end of the response of the TCP command get_alerts. The sensor has a limited-size buffer that will record the first few alerts detected by the sensor.

The full list of possible alerts and error messages can be found in Alerts and Errors in the Appendix.

The alerts reported have the following format:

{
   "category": "Category of the alert: e.g. OVERTEMP, UDP_TRANSMISSION",
   "level": "Level of alert: e.g. NOTICE, WARNING, ERROR",
   "realtime": "The timestamp of the alert in nanoseconds",
   "active": "Whether the alert is active or not: <true/false>",
   "msg": "A description of the alert",
   "cursor": "The sequential number of the alert, starting from 0 counting up",
   "id": "The hexadecimal identification code of the alert: e.g. 0x01000017",
   "msg_verbose": "Any additional verbose description that the alert may present"
}

Example showing active and logged forced temperature sensor failures occurring at timestamps 1569712873477772800, 1569712879991844096, 1569712884968876544 (nanoseconds). The first logged error then resolves itself at 1569713260229536000. The example has been JSON formatted:

{
   "active": [
      {
         "category": "OVERTEMP",
         "level": "ERROR",
         "realtime": "1569712879991844096",
         "active": true,
         "msg": "Unit internal temperature out of bounds; please ensure proper heat sinking.",
         "cursor": 1,
         "id": "0x01000001",
         "msg_verbose": ""
      },
      {
         "category": "OVERTEMP",
         "level": "ERROR",
         "realtime": "1569712884968876544",
         "active": true,
         "msg": "Unit internal temperature out of bounds; please ensure proper heat sinking.",
         "cursor": 2,
         "id": "0x01000002",
         "msg_verbose": ""
      }
   ],
   "next_cursor": 4,
   "log": [
      {
         "category": "OVERTEMP",
         "level": "ERROR",
         "realtime": "1569712873477772800",
         "active": true,
         "msg": "Unit internal temperature out of bounds; please ensure proper heat sinking.",
         "cursor": 0,
         "id": "0x01000000",
         "msg_verbose": ""
      },
      {
         "category": "OVERTEMP",
         "level": "ERROR",
         "realtime": "1569712879991844096",
         "active": true,
         "msg": "Unit internal temperature out of bounds; please ensure proper heat sinking.",
         "cursor": 1,
         "id": "0x01000001",
         "msg_verbose": ""
      },
      {
         "category": "OVERTEMP",
         "level": "ERROR",
         "realtime": "1569712884968876544",
         "active": true,
         "msg": "Unit internal temperature out of bounds; please ensure proper heat sinking.",
         "cursor":2 ,
         "id": "0x01000002",
         "msg_verbose": ""
      },
      {
         "category": "OVERTEMP",
         "level": "ERROR",
         "realtime": "1569713260229536000",
         "active": false,
         "msg": "Unit internal temperature out of bounds; please ensure proper heat sinking.",
         "cursor": 3,
         "id": "0x01000000",
         "msg_verbose": ""
      }
   ]
}

Note

Please contact our Field Application Team and we can answer your questions and provide guidance for achieving proper operations.

Using Latest Firmware

Upgrading to the latest firmware can often resolve issues found in earlier firmware. The latest firmware is always found at Ouster Downloads. Our Support team is best suited to be able to help you if you are running the latest firmware. Please refer to the Updating Firmware section to learn more on how to update firmware.

Alerts and Errors

The sensor provides alerts and error messages that are accessible through the Diagnostics tab on the sensor homepage or via the get_alerts TCP command.

get_alerts returns a list of the active alerts and full log of the past alerts. The max log size is 32 so you can get a log of up to 32 alerts.

Table of All Alerts and Errors

All possible alerts and errors that the sensor can provide are listed below. Where appropriate, the message from the sensor aims to help the user diagnose and fix the issue themselves.

Alerts and Errors

ID

Category

Level

Alert Message

0

UNKNOWN

ERROR

An unknown error has occurred; please contact Ouster at https://ouster.com/tech-support.

1000000

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

1000001

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

1000002

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

1000003

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

1000004

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

1000005

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

1000006

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

1000007

UNDERTEMP

ERROR

Unit internal temperature too low; please see user guide for heat sinking requirements.

1000008

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

1000009

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

100000A

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

100000B

OVERTEMP

ERROR

Unit internal temperature too high; please see user guide for heat sinking requirements.

100000C

INTERNAL_COMM

WARNING

Unit has experienced an internal COMM warning.

100000D

INTERNAL_COMM

WARNING

Unit has experienced an internal COMM warning.

100000E

SHOT_LIMITING

NOTICE

Temperature is high enough where shot limiting may be engaged; please see user guide for heat sinking requirements.

100000F

SHOT_LIMITING

WARNING

Shot limiting mode is active. Laser power is partially attenuated; please see user guide for heat sinking requirements.

1000010

INTERNAL_FW

ERROR

Unit has experienced an internal error; please contact Ouster at https://ouster.com/tech-support.

1000011

ETHERNET_LINK_BAD

WARNING

Ethernet link bad, please check network switch and harnessing can support 1 Gbps Ethernet.

1000012

INTERNAL_COMM

WARNING

Unit has experienced an internal COMM warning: some measurements may have been skipped.

1000013

INTERNAL_COMM

WARNING

Unit has experienced an internal COMM warning: some measurements may have been skipped.

1000014

INTERNAL_COMM

WARNING

Unit has experienced an internal COMM warning: some measurements may have been skipped.

1000015

UDP_TRANSMISSION

WARNING

Client machine announced it is not reachable on the provided lidar data port; check that udp_dest and udp_port_lidar configured on the sensor matches client IP and port.

1000016

UDP_TRANSMISSION

WARNING

Could not send lidar data UDP packet to host; check that network is up.

1000017

UDP_TRANSMISSION

WARNING

Received an unknown error when trying to send lidar data UDP packet; closing socket.

1000018

UDP_TRANSMISSION

WARNING

Client machine announced it is not reachable on the provided not reachable on IMU data port; check that udp_dest and udp_port_imu configured on the sensor matches client IP and port.

1000019

UDP_TRANSMISSION

WARNING

Could not send IMU UDP packet to host; check that network is up.

100001A

UDP_TRANSMISSION

WARNING

Received an unknown error when trying to send IMU UDP packet; closing socket.

100001B

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

100001C

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

100001D

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

100001E

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

100001F

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000020

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000021

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000022

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000023

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000024

STARTUP

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000025

INTERNAL_COMM

ERROR

Unit has experienced an internal COMM error; please contact Ouster at https://ouster.com/tech-support.

1000026

INTERNAL_COMM

ERROR

Unit has experienced an internal COMM error; please contact Ouster at https://ouster.com/tech-support.

1000027

INTERNAL_COMM

ERROR

Unit has experienced an internal COMM error; please contact Ouster at https://ouster.com/tech-support.

1000028

STARTUP

WARNING

Unit has experienced an internal warning during startup and is restarting.

1000029

STARTUP

WARNING

Unit has experienced an internal warning during startup and is restarting.

100002A

STARTUP

WARNING

Unit has experienced an internal warning during startup and is restarting.

100002B

STARTUP

WARNING

Unit has experienced an internal warning during startup and is restarting.

100002C

STARTUP

WARNING

Unit has experienced an internal warning during startup and is restarting.

100002D

STARTUP

WARNING

Unit has experienced an internal warning during startup and is restarting.

100002E

INPUT_VOLTAGE

WARNING

Input voltage is close to being too low. Raise voltage immediately.

100002F

INPUT_VOLTAGE

ERROR

Input voltage is too low. Unit shutting down.

1000030

INPUT_VOLTAGE

WARNING

Input voltage is close to being too high. Lower voltage immediately.

1000031

INPUT_VOLTAGE

ERROR

Input voltage is too high. Unit shutting down.

1000032

UDP_CONNECT

WARNING

Couldn’t open lidar UDP socket; please contact Ouster at https://ouster.com/tech-support.

1000033

UDP_CONNECT

WARNING

Couldn’t resolve IP address; check network and udp_dest.

1000034

UDP_CONNECT

WARNING

Invalid UDP port number; check network and udp_port_lidar.

1000035

UDP_CONNECT

WARNING

Couldn’t reach destination client; verify cabling and network address configuration.

1000036

UDP_CONNECT

WARNING

Couldn’t open imu UDP socket; please contact Ouster at https://ouster.com/tech-support.

1000037

UDP_CONNECT

WARNING

Couldn’t resolve IP address; check network and udp_dest.

1000038

UDP_CONNECT

WARNING

Invalid UDP port number; check network and udp_port_imu.

1000039

UDP_CONNECT

WARNING

Couldn’t reach destination client; verify cabling and network address configuration.

100003A

SHOT_LIMITING

WARNING

Shot limiting mode at maximum and no longer has thermal control authority.

100003B

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

100003C

INTERNAL_FAULT

ERROR

Internal fault detected; unit will restart to attempt recovery.

100003D

INTERNAL_FAULT

ERROR

Internal fault detected; unit will restart to attempt recovery.

100003E

INTERNAL_FAULT

ERROR

Internal fault detected; unit will restart to attempt recovery.

100003F

INTERNAL_COMM

ERROR

Unit has experienced an internal COMM error; please contact Ouster at https://ouster.com/tech-support.

1000040

INTERNAL_FAULT

ERROR

After restart attempts, unit did not recover. Going to error state.

1000041

INTERNAL_COMM

WARNING

Unit has experienced an internal COMM warning: some measurements may have been skipped.

1000042

INTERNAL_COMM

ERROR

Unit has experienced an internal COMM error; please contact Ouster at https://ouster.com/tech-support.

1000043

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000044

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000045

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000046

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000047

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000048

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000049

INTERNAL_FW

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

100004A

STARTUP

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

100004B

STARTUP

ERROR

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

100004C

INTERNAL_FAULT

ERROR

Internal fault detected; unit going to error stop state.

100004D

INTERNAL_FAULT

ERROR

Internal fault detected; unit going to error stop state.

100004E

WARMUP_ISSUE

WARNING

Sensor warmup process is taking longer than expected; please ensure sensor is thermally constrained per requirements.

100004F

WARMUP_ISSUE

WARNING

Sensor warmup process is taking longer than expected; please ensure sensor is thermally constrained per requirements.

1000050

MOTOR_CONTROL

WARNING

The phase lock offset error has exceeded the threshold.

1000051

MOTOR_CONTROL

ERROR

The phase lock control failed to achieve a lock multiple times; please contact Ouster at https://ouster.com/tech-support.

1000052

CONFIG_INVALID

ERROR

Configuration value is invalid or out of bounds.

1000053

WARMUP_ISSUE

ERROR

Sensor warmup process has failed.

1000054

INTERNAL_FAULT

NOTICE

Unexpected hardware configuration detected.

1000055

UDP_TRANSMISSION

WARNING

Unit has experienced a packet drop rate above normal threshold. Please check that the network has at least 1000 Mbps connection. Common causes of this notice may be 100 or 10 Mbps network connections.

1000056

INTERNAL_FAULT

ERROR

Internal fault detected; unit will restart to attempt recovery.

1000057

OVERTEMP

WARNING

Warning: sensor temperature is too high; sensor could have degraded range performance.

1000058

OVERTEMP

ERROR

Warning: sensor temperature is too high; unit going to error stop state.

1000059

INTERNAL_FAULT

WARNING

Internal fault detected; unit will restart to attempt recovery.

100005A

INTERNAL_FAULT

WARNING

Unit has experienced an internal COMM warning: some measurements may have been skipped.

100005B

INTERNAL_FAULT

WARNING

Unit has experienced an internal COMM warning: some measurements may have been skipped.

100005C

INTERNAL_FAULT

WARNING

Unit has experienced an internal COMM warning: some measurements may have been skipped.

100005D

INTERNAL_FAULT

WARNING

Internal fault detected; unit going to error stop state.

100005E

INTERNAL_FAULT

WARNING

Unit has experienced an overcurrent event; unit will restart to attempt recovery.

100005F

IO_CONNECTION

WARNING

Unit has stopped receiving SYNC_PULSE_IN signals and is configured to expect them. Check electrical inputs to sensor.

1000060

IO_CONNECTION

WARNING

Unit has stopped receiving NMEA messages at the MULTIPURPOSE_IO port and is configured to expect them. Check electrical inputs to sensor.

1000061

INTERNAL_COMM

ERROR

Unit has experienced an internal COMM error; please contact Ouster at https://ouster.com/tech-support.

1000062

UNEXPECTED_RUNNING_STATE_EXIT

WARNING

Unit has experienced an internal error; please contact Ouster at https://ouster.com/tech-support.

1000063

MOTOR_SPEED_BAD_WARNING

WARNING

Unit is spinning outside of tolerant range; please contact Ouster at https://ouster.com/tech-support.

1000064

MOTOR_SPEED_BAD

WARNING

Unit failed to maintain target spin rate; please contact Ouster at https://ouster.com/tech-support.

1000065

UNEXPECTED_MOTOR_STATE_EXIT

WARNING

Unit has experienced an internal error; please contact Ouster at https://ouster.com/tech-support.

1000066

MOTOR_COIL_CHECK_FAILED

WARNING

Unit has experienced a startup error; please contact Ouster at https://ouster.com/tech-support.

1000067

INTERNAL_FW

ERROR

Unit has experienced a startup error; Please contact Ouster at https://ouster.com/tech-support.

1000068

INTERNAL_FW

ERROR

Unit has experienced a startup error: Please contact Ouster at https://ouster.com/tech-support.