> This page is for Firmware, version 3.2.
> For other versions, use one of these documentation indexes:
> - 4.0 (default): https://docs.ouster.com/sensor-docs/firmware/4.0/llms.txt
> - 3.2: https://docs.ouster.com/sensor-docs/firmware/3.2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ouster.com/sensor-docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ouster.com/sensor-docs/_mcp/server.

# Changelog

## Firmware v3.2.0

Firmware versions 3.0 and later are only compatible on OS0, OS1, and OSDome hardware versions Rev7 and later. Refer to firmware 2.x or earlier if you have Rev7 OS2, Rev 06 OS0/OS1/OS2, or earlier generation sensors.

## Firmware v3.2.0

**Date:** February 2026

**Added**

* Zone Monitor: Added support for the new Zone Monitor feature.
* Window Signal: Added 8-bit Window Signal value for dirty or blocked window interpretation.
* Multicast: Added multicast routing support by allowing TTL configuration `> 1`.
* Default Gateway: Added the ability to set a static IP to specify a default route.
* Input-only MIO: Added the ability to query input levels of MIO pins.
* Frame Start Control: Added configurable start of frame functionality.
* OpenAPI: Included OpenAPI v3.1.1 specification on the sensor.
* IMU Profile: Added new `ACCEL32_GYRO32_NMEA` IMU UDP packet format.

**Improved**

* Reflectivity: Improved accuracy and uniformity of Calibrated Reflectivity.
* IMU: Synchronous IMU improvements and bug fixes for the HTTP endpoint.
* Bloom: Blooming reduction to result in fewer False Positives (FP) and False Negatives (FN) near retro-reflectors. The feature is user-configurable with two modes available: Balanced (Default) and Minimize False Positives.
* Thermal Management: General thermal improvements compared to Firmware v3.1.
* Web UI: Comprehensive update to the web interface including support for Static IP Gateway, User Editable Data, OpenAPI spec, and Zone Monitor.
* Web UI API: Updated Web UI to use PUT with exact URIs to update individual configuration keys.
* API Validation: Improved validation of static IPv4 addresses.
* mDNS: Improved protocol compliance for mDNS.
* Firmware Update (FWUP): Improved status reporting via `update_status` under `api/v1/system/firmware`.

**Fixed**

* Thermal/TEC: Fixed issue causing unnecessary thermal cycling of the TEC; implemented full recovery from thermal shutdown with proper reinitialization.
* System Stability: Fixed TX-board initialization parameters and implemented uplink auto-reinitialization to recover from communication failures.
* Alerts: Updated `PHASE_LOCK_LOST` alert to include error amount in message for better diagnostics; added `WLP_STARTUP_FAILURE` alert if `CALIBRATE_SENSORS` state fails.
* Lidar Data: Suppressed missed lidar data alerts during diagnostic dump generation.
* Synchronization: Fixed issue where NMEA lock toggled constantly even when MPIO was disconnected.
* MIO: Fixed bug in `ENCODER_ANGLE_OUT` mode for Multipurpose IO.

**Changed**

* Packet Header: FuSa configurable packet header now available.
* API Formatting: The config endpoint and `set_config_param` no longer accept dotted parameters; forward slash `/` must be used as a delimiter for beta parameters.

**Removed/Deprecated**

* TCP Command Server: Removed. TCP command support has been dropped; users must use the HTTP API.
* Undocumented API: Deprecated undocumented API commands.
* Legacy Parameters: Deprecated `/api/v1/config` legacy parameters.
* Lidar Profile: Deprecated LEGACY lidar profile; will be removed in Firmware v4.0.
* IMU Profile: Deprecated LEGACY IMU profile; will be removed in Firmware v4.0.

## Firmware v3.1.0

Firmware versions 3.0 and later are only compatible on OS0, OS1, and OSDome hardware versions Rev7 and later. Refer to firmware 2.x or earlier if you have Rev7 OS2, Rev 06 OS0/OS1/OS2, or earlier generation sensors.

## Firmware v3.1.0

**Date:** May 2024

**Added**

* Add Low Data Rate Dual Return profile, `FUSA_RNG15_RFL8_NIR8_DUAL`.
* Add config parameter for `min_range_threshold_cm`.
* Add config parameter for `return_order`.
* Add config parameter for Delete Config.
* Add PTP L2 E2E support via a new PTP profile, `default-l2-relaxed`.
* Add new alerts. See the Alerts and Errors page for more information.
* Add config parameter for user-editable data in the API user guide. This field can be used for storing sensor-specific information, qualifying a sensor, calibration data, or other information.
* Add config parameter to restart or reinitialize a sensor.
* Add End-to-End Cyclic Redundancy Check (CRC) in configurable data packet format.
* Add config parameter for IMU data packet. Users can get `imu_data_format` and `POST` config to change `gyro_fsr` and `accel_fsr` from `NORMAL` to `EXTENDED`.
* Add `Alert Flags` in lidar data packet. All `udp_lidar_profile` values have been updated to include alert flags at the packet level.

**Improved**

* Improved robustness for cold start.
* Reduced the occurrence of false alerts for `VCSEL_CURRENT_LOW`.
* Improved motor stability when decelerating to lower RPM during lidar mode switches.
* Minor PTP software update and reduced fault recovery time.
* Improved existing alerts to notify users when the network is not reachable. This enhancement enables users to promptly address connectivity issues, improving overall system reliability.
* Improved startup time and reinit time by approximately 10-15 seconds.
* Improved sensor web UI to display client and UDP destination address.
* Allow IMU port to be set to `0` to disable IMU packet transmission.
* Improved recovery after Ethernet link loss that previously caused UDP stream to stall.

**Fixed**

* Apply PPS setting in `STANDBY` so `api/v1/time/sensor` reflects provisioned configuration in `STANDBY`.
* Fixed handling of `NMEA` messages with fractional seconds. Previously, if an NMEA sentence contained a fractional second time, the sensor rounded the fraction up, resulting in a future timestamp.
* Fixed PPS/NMEA lock and time synchronization. Previously, the sensor did not lock when GPS was connected and Sync Pulse In was selected.
* Correct `IMU` polling rate to `100hz`.
* Fixed `get-alerts-http` input cursor correctly limits alert log.
* Fixed timestamp loop in PPS mode when PPS signal is lost. Timestamp will free-run instead of looping.
* Fixed sensor error that occurred when using continuously for 1-4 months depending on mode.
* Support for local `udp_dest` address via sensor web UI.
* Fixed a bug where lidar starts to send data when powering on before establishing connection with the client machine.
* Fixed a bug where the sensor would be stuck in `UNKNOWN` state during multiple API requests while streaming point clouds.
* Fixed Alert section categories changed from `WARNING` to `ERROR`. No functional changes to alert behavior.
* Fixed a bug in point cloud behavior that caused highly reflective objects below minimum range to make other objects disappear.
* Fixed a bug that prevents sensor from going into `ERROR` stopped state or restarting while doing cold start. This improves reliability and robustness of the cold start path.

**Changed**

* Replaced mDNS name from `_roger._tcp` to `_ouster-lidar._tcp`. `_roger._tcp` is in planned deprecation.
* Replaced alert category for `CONFIG_INVALID` to `CONFIG`. See the Alerts and Errors page for more information.

**Removed**

* TCP API has been deprecated in firmware 3.1. Use the HTTP API instead.
* LEGACY data packet profile has been deprecated. See the Sensor Data page for more information.

## Firmware v3.0.1

## Firmware v3.0.1

**Date:** February 2023

**Updated**

* `beam_to_lidar_transform` for Rev7 OS0 and OS1 sensors.
* `lidar_to_sensor_transform` for Rev7 OSDOME sensors.

**Added**

* New HTTP command to configure speed override.

## Firmware v3.0.0

## Firmware v3.0.0

**Date:** January 2023

**Fixed**

* Bug fix in High Input Voltage Alert behavior.
* Bug in keep-alive behavior for HTTP 1.1.
* Bug fix in `get_lidar_data_format`.

**Improvements**

* Improved point cloud behavior due to enhanced retro-reflector range accuracy improvement.

**Changed**

* Default value of `udp_profile_lidar` is set to single return profile.

**Added**

* `1024x20` and `2048x10` lidar modes with dual returns.
* Shot limiting status flags and thermal shutdown.
* Azimuth laser masking.
* Two new Signal multiplier modes: 0.25 and 0.5 Mode.
* New alerts. See the Alerts and Errors page for more information.