# Terabee TeraRanger Rangefinders (Discontinued)
:::warning
TeraRanger Evo sensors were discontinued by Terabee in May 2024.
Limited stock may still be available from third-party resellers (see [Where to Buy](#store)).
:::
Terabee TeraRanger sensors are small, lightweight [rangefinders](../sensor/rangefinders.md) based on infrared Time-of-Flight (ToF) technology, with maximum ranges from 3 m to 60 m (depending on the model).
They connect to the flight controller using I2C.
:::info
The driver for these rangefinders is not included in PX4 firmware by default.
See [Firmware Support](#firmware_support) for how to add it.
:::
## Supported Models {#supported_models}
PX4 supports the following models.
| 모델 | 범위 | Current draw | [SENS\_EN\_TRANGER][SENS_EN_TRANGER] | 참고 |
| -------------------- | ------------------------ | ------------ | ------------------------------------ | ---------------------------------------------------- |
| TeraRanger Evo 60m | 0.5–60 m | 90–330 mA | `3` | Requires the Evo I2C/UART backboard. |
| TeraRanger Evo 600Hz | 0.75–8 m | 95–190 mA | `4` | Requires the Evo I2C/UART backboard. |
| TeraRanger Evo 3m | 0.1–3 m | 70–250 mA | `5` | Requires the Evo I2C/UART backboard. |
| TeraRanger One | 0.2–14 m | | `2` | |
[SENS_EN_TRANGER]: ../advanced_config/parameter_reference.md#SENS_EN_TRANGER
## Specifications {#specifications}
The following specifications apply to TeraRanger Evo sensors fitted with the Evo I2C/UART backboard.
- **Technology:** Infrared Time-of-Flight (LED)
- **Field of view:** Approx. 2° (Evo 60m)
- **Interface:** I2C (3.3 V logic, address `0x31`)
- **Input voltage:** 5 V DC ±5%
- **Dimensions:** Approx. 29 x 29 x 22 mm (sensor and backboard)
- **Weight:** 9 g (sensor) + 3 g (backboard)
## Where to Buy {#store}
TeraRanger sensors are no longer sold by Terabee.
At the time of writing the following are still listed by the reseller Tribotix:
- [TeraRanger Evo 60m](https://tribotix.com/product/teraranger-evo-60m/)
- [TeraRanger Evo 600Hz](https://tribotix.com/product/teraranger-evo-600hz/)
- [TeraRanger Evo 3m](https://tribotix.com/product/teraranger-evo-3m/)
Select the **I2C/UART** interface option when ordering (PX4 cannot use the USB backboard).
## Hardware Setup {#hardware_setup}
### Mounting {#mounting}
PX4 assumes that the sensor is facing down (the orientation cannot be configured).
For TeraRanger Evo sensors:
- Do not mount anything directly in front of the sensor, or within a cone of approximately ±15° around its optical axis.
- Within the first metre, avoid highly reflective objects within a cone of approximately ±45° around the optical axis.
- Do not add a cover in front of the sensor.
- Rotor blades in the field of view can affect the readings.
### Pinouts {#pinouts}
TeraRanger Evo sensors must be fitted with the Evo I2C/UART backboard, which has a single 9-pin Hirose DF13 connector.
| 핀 | 신호 | 설명 |
| - | --- | -------------------------------------------------------------- |
| 1 | Tx | UART transmit (3.3 V logic) |
| 2 | Rx | UART receive (3.3 V logic) |
| 3 | GND | 접지 |
| 4 | SDA | I2C data (3.3 V logic) |
| 5 | SCL | I2C clock (3.3 V logic) |
| 6 | - | Reserved |
| 7 | 5V | +5 V supply input |
| 8 | GND | 접지 |
| 9 | - | Reserved |
### Wiring {#wiring}
All TeraRanger sensors must be connected via the I2C bus, using an external `I2C` port on the flight controller.
| Backboard pin | Connect to |
| ------------------------------- | ------------------------- |
| 4 (SDA) | Flight controller I2C SDA |
| 5 (SCL) | Flight controller I2C SCL |
| 7 (5V) | 5 V DC supply |
| 3 or 8 (GND) | Flight controller GND |
The UART pins are not used by PX4.
The sensor requires a 5 V DC (±5%) supply, and can draw up to 330 mA depending on the [supported model](#supported_models).
Check that the flight controller port can supply this, or power the sensor from a separate supply that shares a ground with the flight controller.
The backboard has built-in 10 kΩ pull-up resistors on SDA and SCL, so do not add further pull-ups on the same bus.
The sensor must be left at its default I2C address (`0x31`).
## Firmware Support {#firmware_support}
The rangefinder is supported by the [teraranger](../modules/modules_driver_distance_sensor.md#teraranger) driver, which is built into firmware by the [board configuration](../hardware/porting_guide_config.md) key `CONFIG_DRIVERS_DISTANCE_SENSOR_TERARANGER=y`.
The driver is not part of the common set of rangefinder drivers (`CONFIG_COMMON_DISTANCE_SENSOR`), so it is only present in the firmware for boards that set that key.
To check your board, look for the key in its configuration file, `boards///default.px4board`, or check whether [SENS\_EN\_TRANGER][SENS_EN_TRANGER] is listed in _QGroundControl_ (parameters are only shown for drivers that are in the firmware).
To add the driver, add the key to the board's `default.px4board` file, or enable it in [boardconfig](../hardware/porting_guide_config.md#px4-menuconfig-setup) under **Drivers > Distance sensors**, and then [build and upload the firmware](../dev_setup/building_px4.md).
The driver does not start until it is enabled using the parameter in [PX4 Configuration](#px4_configuration).
## PX4 Configuration {#px4_configuration}
Set [SENS\_EN\_TRANGER][SENS_EN_TRANGER] to the value for your sensor in the [Supported Models](#supported_models) table, and then reboot.
You can instead set the parameter to `1` to have PX4 detect the sensor.
:::info
If using auto-detect for Evo sensors the minimum and maximum values for the range are set to the lowest and highest possible readings across the Evo family (currently 0.1–60 m).
올바른 최대/최소 값을 사용하려면 Evo 센서의 적절한 모델을 매개변수에 설정합니다 (자동 감지를 사용하는 대신).
:::
If the parameter is not available in _QGroundControl_ then the driver is not in the firmware: see [Firmware Support](#firmware_support).
The configuration that is common to all rangefinders, such as the sensor position offsets used by the estimator, is covered in [Rangefinders > Configuration/Setup](../sensor/rangefinders.md#configuration).
## Testing {#testing}
You can check that the driver is running, and see its error counters, using the _QGroundControl MAVLink Console_:
```sh
teraranger status
```
You can observe the published measurements with:
```sh
listener distance_sensor
```
The measurements can also be viewed in the `DISTANCE_SENSOR` message in the _QGroundControl MAVLink Inspector_.
For more information see [Rangefinders > Testing](../sensor/rangefinders.md#testing).
## Further Information {#further_information}
- [Modules Reference: Distance Sensor (Driver): teraranger](../modules/modules_driver_distance_sensor.md#teraranger)
- [User Manual for TeraRanger Evo single point distance sensors and backboards](https://web.archive.org/web/20240611084754/http://www.terabee.com/wp-content/uploads/2021/02/User-Manual-for-TeraRanger-Evo-single-point-distance-sensors-and-backboards.pdf) (Terabee, archived copy)
- [TeraRanger Evo Specification Sheet](https://acroname.com/sites/default/files/assets/teraranger-evo-specification-sheet.pdf) (Terabee, hosted by Acroname)