> This page is for Integration Guides, version Rev 7 (default).
> For other versions, use one of these documentation indexes:
> - Rev 7 (default): https://docs.ouster.com/sensor-docs/guides/rev7/llms.txt
> - Rev 8: https://docs.ouster.com/sensor-docs/guides/rev8/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.

# Thermal Alerts & Appendix

> Shot limiting stages, thermal shutdown behavior, thermal model specifications, and supplemental load cases for Ouster sensors.

## Shot Limiting - Sensors Running on Firmware v2.5.x and Prior

The sensor alert system and thermal management are designed to ensure safe and robust operation in demanding environments. As the environment temperature gets higher the sensor will selectively reduce the amount of power consumed to ensure continued operation in temperatures approaching the maximum listed in [Max Operating Temperatures](/sensor-docs/guides/thermal-max-operating-temp).

The sensor has four stages of operation related to high-temperature environments as shown in the High Temperature Operating Modes figure.

1. Normal Operation - This stage is the default when the temperatures are between the minimum and maximum specified in the datasheet.

   * In this stage, the sensor operates at full performance.

2. Shot Limiting Zone Entered - This stage is entered when the chassis temperature is within \~2ºC of the maximum specified temperature.

   * In this stage, the sensor continues to operate at full performance and produces an alert to notify you that the sensor may soon enter a reduced performance mode.

3. Shot Limiting Active - This stage is entered when the chassis temperature is at the maximum operating temperature listed in [Max Operating Temperatures](/sensor-docs/guides/thermal-max-operating-temp).

   * In this stage, the sensor continues to operate but at reduced performance. The number of shots will gradually decrease from 100% down to 50% until reaching the saturation temperature.

4. Shot Limiting Saturated - This stage is entered when the shots have been limited by 50%.

   * In this stage, the sensor will continue to limit the number of shots at 50% until the temperature rises approximately 5ºC.

5. Sensor Shutdown - This stage is entered when the chassis temperature reaches the sensor shutoff temperature listed in [Max Operating Temperatures](/sensor-docs/guides/thermal-max-operating-temp).

   * In this stage, the sensor will shut itself down to prevent damage.

![High Temperature Operating Modes](/sensor-docs/_fern-files/_img/d5dcc2c735408217926d2f135754e033c3e24053bcc3dfa46604bf35b9ba4ee2.webp)

High Temperature Operating Modes

> **Note**
>
> 50% shot limiting means 50% of the signal not 50% of the range.

## Shot Limiting - Sensors Running on Firmware v3.x and later

Shot limiting is a process by which the Ouster sensor will automatically enter into state to safely prolong the operational performance of the sensor in high operating temperature conditions. There are several different levels of shot limiting that are described in the Shot Limiting Status Flags table.

The sensor has three operating states in order to manage high temperatures:

* `NORMAL (Status 0x00)`
* `SHOT_LIMITING_IMMINENT (Status 0x01)`
* `SHOT_LIMITING (Status 0x02 and greater)`

In the `NORMAL` state the sensor will perform to the range and precision specifications of the datasheet. When the sensor reaches a certain temperature, the sensor enters the `SHOT_LIMITING_IMMINENT` state and issues alert `0x0100000E` which indicates shot-limiting will commence in 30 seconds. After 30 seconds have elapsed and the temperature remains elevated, the sensor issues alert `0x0100000F` and enters a `SHOT_LIMITING` state.

In shot limiting state, the sensor reduces power to the lasers in order to reduce the thermal load. While in this state, sensor range and precision may degrade by up to 30%. The sensor will progressively increase shot limiting if the temperature remains elevated. If the sensor reaches its maximum degree of shot-limiting, it will throw alert `0x0100003A`.

If the sensor cools down while it is in either `SHOT_LIMITING_IMMINENT` or `SHOT_LIMITING` state, the sensor will return to the `NORMAL` state.

An independent state machine runs for thermal shutdown. When the sensor reaches the maximum operating temperature specified in the table Maximum Thermal Performance, the sensor will enter a `SHUTDOWN_IMMINENT` state and issue an alert in category `OVERTEMP`. If the sensor temperature remains elevated after 30 seconds, the sensor will shut down and issue alert `0x0100006B`.

> **Note**
>
> Please refer to the Hardware User Manual to learn more about the maximum thermal performance.

Information regarding the shot limiting status is presented as part of the lidar data packet in the *Configurable Data Packet Format*. Shot limiting status will be a part of the packet header when config parameter `udp_profile_lidar` is set to one of the following values shown below.

* [*Single Data Return Format*](/sensor-docs/firmware/lidar-data#rng19_rfl8_sig16_nir16)
* [*Low Data Return Format*](/sensor-docs/firmware/lidar-data#rng15_rfl8_nir8)
* [*Dual Data Return Format*](/sensor-docs/firmware/lidar-data#rng19_rfl8_sig16_nir16_dual)
* [*FUSA_RNG15_RFL8_NIR8_DUAL Return Format*](/sensor-docs/firmware/lidar-data#fusa)

The following flags are present in configurable data packet header:

**Shot limiting status** \[4 bit unsigned int] - Indicates the shot limiting status of the sensor. Different codes indicates whether the sensor is in *Normal Operation* or in *Shot limiting*.

**Shutdown Status** \[4 bit unsigned int] - Indicates whether thermal shutdown is imminent. This can be due to *shot limiting* being saturated, or due to any other over temperature conditions and depending upon the situation the appropriate alert is generated. When thermal shutdown is imminent, this flag will be set to 1 and the Thermal Shutdown Countdown field will be set to 30 seconds.

**Shot limiting Countdown** \[8 bit unsigned int] - Countdown from 30 seconds to indicate when shot limiting is imminent. When the condition for entering shot limiting is met, the shot limiting status bit is set to 0x01 and the alert 0x0100000E takes effect. At this point the shot limiting counter will be set to 30 seconds and a countdown to initiate shot limiting will start.

**Shutdown Countdown** \[8 bit unsigned int] - Countdown from 30 seconds to indicate that thermal shutdown is imminent. When a thermal shutdown is completed, the alert 0x0100006B will take effect and the sensor will automatically go to the ERROR state and stop outputting data.

The following table describes the codes in the shot limiting status flags, and what mode it corresponds to:

**Shot Limiting Status Flags**

| Shot Limiting status flags | Description                                                                                                                                                                                                                                                                                                                                         |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `0x00`                     | Normal Operation. When the sensor is not in shot limiting, the shot limiting status flag will be set to 0x00, and shot limiting countdown will be set to 0x00.                                                                                                                                                                                      |
| `0x01`                     | When the condition for entering Shot limiting is met, we set the Shot Limiting Status bit 0x01 and the alert 0x0100000E is in effect, informing that shot limiting is imminent.                                                                                                                                                                     |
| `0x02`                     | In this mode, we reduce the % of nominal laser duty cycle by 0-10% from NORMAL OPERATION. There will be an approximate reduction in the sensor max range by 3%.                                                                                                                                                                                     |
| `0x03`                     | In this mode, we reduce the % of nominal laser duty cycle by 10-20% from NORMAL OPERATION. There will be an approximate reduction in the sensor max range by 6%.                                                                                                                                                                                    |
| `0x04`                     | In this mode, we reduce the % of nominal laser duty cycle by 20-30% from NORMAL OPERATION. There will be an approximate reduction in the sensor max range by 9%.                                                                                                                                                                                    |
| `0x05`                     | In this mode, we reduce the % of nominal laser duty cycle by 30-40% from NORMAL OPERATION. There will be an approximate reduction in the sensor max range by 12%.                                                                                                                                                                                   |
| `0x06`                     | In this mode, we reduce the % of nominal laser duty cycle by 40-50% from NORMAL OPERATION. There will be an approximate reduction in the sensor max range by 16%. For OS2 and OSDome sensors this mode is when shot limiting is saturated and alert 0x0100003A is in effect. There will be an approximate reduction in the sensor max range by 21%. |
| `0x07`                     | In this mode, we reduce the % of nominal laser duty cycle by 50-60% from NORMAL OPERATION. There will be an approximate reduction in the sensor max range by 21%.                                                                                                                                                                                   |
| `0x08`                     | In this mode, we reduce the % of nominal laser duty cycle by 60-70% from NORMAL OPERATION. There will be an approximate reduction in the sensor max range by 25%.                                                                                                                                                                                   |
| `0x09`                     | In this mode, we reduce the % of nominal laser duty cycle by 70-75% from NORMAL OPERATION. There will be an approximate reduction in the sensor max range by 27%. For OS0 and OS1 sensors this mode is when shot limiting is saturated and alert 0x0100003A is in effect. There will be an approximate reduction in the sensor max range by 27%.    |

## Appendix

### Simple Thermal Model

* Use the sensor CAD from the [Downloads](https://ouster.com/downloads/) page to define the control volume
* Simulate the sensor as a conductive material, such as aluminum, with a single power source.
* Using the sensor product line data sheet to determine the power dissipated inside the control volume.

> **Note**
>
> The power dissipation varies during startup, nominal operation, and in cold ambient temperatures.

#### OS0/1 Detailed Thermal Model

![OS0/1 Thermal Model Cross Section](/sensor-docs/_fern-files/_img/f00fbef3d50c24ca901a488bbcdd12d90e6667a73ba63cbe4d42c3a19f803982.webp)

OS0/1 Thermal Model Cross Section

The Thermal Model Specifications table and the cross section above detail the specifications of the Thermal Model. Assumptions for Thermal Model are as follows:

* Use case is to add the Thermal Model to CAD/simulation software to conduct CFD simulation.
* Simulation is not transient, so thermal capacitance of materials and soak times do not need to be accurately estimated.
* Simulation needs to estimate the power dissipation at the sensor's three external components: **HEATSINK-RADIAL**, **WINDOW**, and **SENSOR BASE** enclosure given various external constraints.
* Internal temperatures of the sensor do not need to be simulated.
* Temperatures and heat fluxes need to be simulated at the control volume surface.
* There is no contact resistance between components of the Thermal Model.
* The Thermal Model assumes 18W power dissipation. This is a conservative assumption for a sensor at steady state conditions at higher temperatures. Sensor power draw is higher during startup and colder ambient conditions. Reference the relevant sensor datasheet for the power draw at startup and cold ambient temperatures.

**Thermal Model Specifications**

|                            | Shape            | Material/ Conductivity              | Heat Dissipation               |
| -------------------------- | ---------------- | ----------------------------------- | ------------------------------ |
| Simplified **SENSOR BASE** | Cylindrical Bowl | Aluminum 6061-T6 with clear anodize | -                              |
| Simplified **TOP CAP**     | Cylindrical Bowl | Aluminum 6061-T6 with clear anodize | -                              |
| **WINDOW**                 | Tube             | Polycarbonate                       | -                              |
| Component A                | Cylinder         | 2.68 W\* m-1\* K-1                  | 6 W (at SENSOR BASE interface) |
| Component B                | Cylinder         | Perfect conductor                   | 12 W                           |
| Component C                | Tube / Donut     | 0.401 W\* m-1\* K-1                 | -                              |
| Component D                | Tube / Donut     | 0.209 W\* m-1\* K-1                 | -                              |

> **Note**
>
> There is no contact resistance between components of the thermal model within the sensor control volume.

![Thermal Model: Component Details](/sensor-docs/_fern-files/_img/1bb59b992c9c3a3badc97219975bdc4c4c841eba784ad32cf0a8771d77c99c35.webp)

Thermal Model: Component Details

**Heat Flux Interfaces**

|                   | Component                 | Surface or Volume | Heat Dissipation |
| ----------------- | ------------------------- | ----------------- | ---------------- |
| Heat Generator #1 | Simplified Base Enclosure | Top Surface       | 6 W              |
| Heat Generator #2 | Component B               | Whole Volume      | 12 W             |

### Supplemental Thermal Load Cases

Tables below provides load cases for Rev7 OS0/1 at limited FOV, signal multiplier modes, and higher temperatures. The OS0/1 draws lower power at higher temperatures.

> **Note**
>
> The Ouster thermal team recommends using a simple 18 W total load as a conservative assumption even at higher temperatures when designing a sensor mounting hardware to simplify analysis and add margin to mounting hardware designs.

![Thermal Load](/sensor-docs/_fern-files/_img/ff8af6088854bfb5a17608fc8f708ce771ca20a5971937865d9dddac08907bb1.webp)

Thermal Load

**Normal Operation at Room Temperature**

| FOV Signal | Multiplier | Total Power | Heat Gen #2 | Heat Gen #1 |
| ---------- | ---------- | ----------- | ----------- | ----------- |
| 360º       | 1x         | 18 W        | 12 W        | 6 W         |
| 360º       | 0.5x       | 17 W        | 11 W        | 6 W         |
| 360º       | 0.25x      | 16.5 W      | 10.5 W      | 6 W         |
| 180º       | 2x         | 18 W        | 12 W        | 6 W         |
| 180º       | 1x         | 17 W        | 11 W        | 6 W         |
| 180º       | 0.5x       | 16.5 W      | 10.5 W      | 6 W         |
| 180º       | 0.25x      | 16.25 W     | 10.25 W     | 6 W         |

**Normal Operation Near Shot Limiting Temperatures (53ºC)**

| FOV Signal | Multiplier | Total Power | Heat Gen #2 | Heat Gen #1 |
| ---------- | ---------- | ----------- | ----------- | ----------- |
| 360º       | 1x         | 16 W        | 10.7 W      | 5.3 W       |
| 360º       | 0.5x       | 15 W        | 9.7 W       | 5.3 W       |
| 360º       | 0.25x      | 14.5 W      | 9.2 W       | 5.3 W       |
| 180º       | 2x         | 16 W        | 10.7        | 5.3 W       |
| 180º       | 1x         | 15 W        | 9.7 W       | 5.3 W       |
| 180º       | 0.5x       | 14.5 W      | 9.2 W       | 5.3 W       |
| 180º       | 0.25x      | 14.25 W     | 8.95 W      | 5.3 W       |

**Full Shot Limiting Operation Near Shutdown**

| FOV Signal | Multiplier | Total Power | Heat Gen #2 | Heat Gen #1 |
| ---------- | ---------- | ----------- | ----------- | ----------- |
| 360º       | 1x         | 14.5 W      | 9.2 W       | 5.3 W       |
| 360º       | 0.5x       | 14.5 W      | 9.2 W       | 5.3 W       |
| 360º       | 0.25x      | 14.5 W      | 9.2 W       | 5.3 W       |
| 180º       | 2x         | 14.25 W     | 8.95 W      | 5.3 W       |
| 180º       | 1x         | 14.25 W     | 8.95 W      | 5.3 W       |
| 180º       | 0.5x       | 14.25 W     | 8.95 W      | 5.3 W       |
| 180º       | 0.25x      | 14.25 W     | 8.95 W      | 5.3 W       |

### Shot Limiting and Shutdown Plots (Rev7)

The following graphical representation shows expected shot limiting and shutdown limits based on the base enclosure bottom surface temperature and top cap (top) surface temperature. This data is only available for Rev7 sensors.

The measurement was taken with thermocouples placed at *Top Cap Chassis* and *Base Heatsink Chassis* as shown in the image below.

![Thermocouple placement for measurement](/sensor-docs/_fern-files/_img/164fc4f3020abd9924131371ba10e224fca5d66528faaae249a2758fd95d31e4.webp)

Thermocouple placement for measurement

#### Graphical representation: FOV= 360º and Signal Multiplier = 1

![Field of View 360º, Signal Multiplier 1](/sensor-docs/_fern-files/_img/3c530252edad70ea71b8d75431962ed0cb54cace631dbeda8828dd4b47aec9db.webp)

Field of View 360º, Signal Multiplier 1

#### Graphical representation: FOV= 360º and Signal Multiplier = 0.5

![Field of View 360º, Signal Multiplier 0.5](/sensor-docs/_fern-files/_img/94dca1292774e4f93df14e995527c845246139809430e549caea9cd5c2967a47.webp)

Field of View 360º, Signal Multiplier 0.5

#### Graphical representation: FOV= 360º and Signal Multiplier = 0.25

![Field of View 360º, Signal Multiplier 0.25](/sensor-docs/_fern-files/_img/022ed78aef66f8f24009d01f9da96e01825987651173dfd61a6cec83006fff4c.webp)

Field of View 360º, Signal Multiplier 0.25

#### Graphical representation: FOV= 180º and Signal Multiplier = 1

![Field of View 180º, Signal Multiplier 1](/sensor-docs/_fern-files/_img/6131ef1bae47b233cf8a0f58a9bb5aba7e2b1bac875dd177988d17905c79d0d9.webp)

Field of View 180º, Signal Multiplier 1

#### Graphical representation: FOV= 180º and Signal Multiplier = 0.5

![Field of View 180º, Signal Multiplier 0.5](/sensor-docs/_fern-files/_img/2bee11898bb7669b8b57d5564ce4c367ed2e41fff007e97e75a22dce683ef45b.webp)

Field of View 180º, Signal Multiplier 0.5

#### Graphical representation: FOV= 180º and Signal Multiplier = 0.25

![Field of View 180º, Signal Multiplier 0.25](/sensor-docs/_fern-files/_img/55db9db3beabd1230a6d8f3dd5bdb13e0c4176a7fc7aa3a5055519ed80b56399.webp)

Field of View 180º, Signal Multiplier 0.25

### Sunshade Concept Design

We have created a simple Sunshade Concept Design that may help mitigate the solar load. It attaches on top of the modular cap using the existing mounting holes in the modular cap.

![Sunshade Concept Design](/sensor-docs/_fern-files/_img/dcd9a90e303e7afdf3e45036c5ff465886e5f5950ed82ab31ac7525a226bb439.webp)

Sunshade Concept Design

> **Note**
>
> * The modular cap (**HEATSINK-RADIAL** or **-HALO**) must remain attached to the **TOP CAP** of the sensor. The original M3-0.5x5 mm modular cap screws would need to be replaced with longer M3-0.5x30 mm standoffs.
>
> * This concept design is only for sensors with the modular cap that has the four mounting holes to interface with the **TOP CAP**.
>
>   * 840-101855-03 - Gen1 OS1 with Locking Bayonet Connector
>   * 840-102144-A/B/C/D/5/6/7 - Gen2 OS0 with Locking Bayonet Connector
>   * 840-102145-A/B/C/D/5/6/7 - Gen2 OS1 with Locking Bayonet Connector
>
> * This version is designed not to occlude any beams on a Gen2 OS1-128 with 45º VFOV. Design should be modified to accommodate wider VFOVs (90º) or more shade.

> **Warning**
>
> This design is meant to be an inspiration for your design and has not been validated.

The CAD model is available on [Ouster Downloads page](https://cad.onshape.com/documents/3ac1c97521afd88cbfcbe92c/v/ee901ca566322a411a6edb8d/e/80d6fda6473ea91459fa55e0?renderMode=0\&uiState=61e9adc1fdec0b10d6da56c9) for you to iterate and fabricate.

### Supported Products

The current firmware is supported on the following Ouster products:

* Firmware 2.5.x

  * OS0, OS1, OS2:

    * GEN1: P/N 840-101-XXX-XX
    * Rev C: P/N 840-102-XXX-C
    * Rev D: P/N 840-102-XXX-D
    * Rev 05: P/N 840-102xxx-05
    * Rev 06: P/N 840-102xxx-06
    * Rev 7: P/N 860-10xxxx-07 (OS2 Only)

* Firmware 3.1.x

  * OS0, OS1, OSDome:

    * Rev 7: P/N 860-10xxxx-07