# Benewake TFmini 라이다
The Benewake [TFmini-S](https://en.benewake.com/TFminiS/index_proid_325.html) and [TFmini Plus](https://en.benewake.com/TFminiPlus/index_proid_323.html) are small, low-power time-of-flight LiDAR [rangefinders](../sensor/rangefinders.md) with a range of 0.1–12 m and a 100 Hz default update rate.
They connect to the flight controller using a serial port (UART).

## Supported Models {#supported_models}
| 모델 | 범위 | 연결 | `SENS_TFMINI_HW` value |
| ---------------------------------------------------------------------- | ------------------------ | ---- | -------------------------------- |
| [TFmini-S](https://en.benewake.com/TFminiS/index_proid_325.html) | 0.1–12 m | UART | `1` (default) |
| [TFmini Plus](https://en.benewake.com/TFminiPlus/index_proid_323.html) | 0.1–12 m | UART | `4` |
PX4 reports distances from 0.4 m to 12 m for the TFmini-S and from 0.1 m to 12 m for the TFmini Plus.
## Specifications {#specifications}
- **Technology:** Time-of-flight, 850 nm infrared (VCSEL on the TFmini-S, LED on the TFmini Plus)
- **Range:** 0.1–12 m at 90% reflectivity; 0.1–7 m (TFmini-S) or 0.1–4 m (TFmini Plus) at 10% reflectivity
- **Update rate:** 100 Hz by default, adjustable 1–1000 Hz
- **Field of view:** 2° (TFmini-S), 3.6° (TFmini Plus)
- **Accuracy:** ±6 cm below 6 m and ±1% from 6–12 m (TFmini-S); ±5 cm below 5 m and ±1% from 5–12 m (TFmini Plus)
- **Resolution:** 1 cm
- **Interface:** UART at 115200 baud, 8N1, 3.3 V (LVTTL); the sensors also support I2C, which the PX4 driver does not use
- **Input voltage:** 5 V ±0.1 V (TFmini-S), 5 V ±0.5 V (TFmini Plus)
- **Current draw:** ≤140 mA average, 200 mA peak (TFmini-S); ≤110 mA average, 140 mA peak (TFmini Plus)
- **Dimensions:** 42 x 15 x 16 mm (TFmini-S), 35 x 18.5 x 21 mm (TFmini Plus)
- **Weight:** 5 g (TFmini-S), 12 g (TFmini Plus)
- **Operating temperature:** 0–60 °C (TFmini-S), -20 °C to 60 °C (TFmini Plus)
- **Ingress protection:** IP65 (TFmini Plus)
- **Laser class:** Class 1 (TFmini-S)
## Where to Buy {#store}
- TFmini-S: [Benewake](https://en.benewake.com/TFminiS/index_proid_325.html), [Mouser](https://www.mouser.com/en/ProductDetail/Benewake/TFmini-S-Uart?qs=DPoM0jnrROXBvfO6mWli6w%3D%3D)
- TFmini Plus: [Benewake](https://en.benewake.com/TFminiPlus/index_proid_323.html), [Mouser](https://www.mouser.com/en/ProductDetail/Benewake/TFmini-Plus-Uart?qs=DPoM0jnrROWctNsxLIii7A%3D%3D)
## Hardware Setup {#hardware_setup}
### Mounting {#mounting}
Mount the sensor facing down: PX4 assumes a downward-facing sensor, and the orientation cannot be configured.
Readings below the minimum range of the selected model (0.4 m for the TFmini-S, 0.1 m for the TFmini Plus) are reported as out of range.
### Pinouts {#pinouts}
The TFmini-S and TFmini Plus have a cable ending in a JST 1.25 mm 4-pin connector (Molex 51021-0400).
This is not the JST-GH connector used by flight controllers that follow the [Pixhawk Connector Standard](https://github.com/pixhawk/Pixhawk-Standards/blob/master/DS-009%20Pixhawk%20Connector%20Standard.pdf), so you will need an adapter cable to connect to those ports.
The cable can be extended, but Benewake recommends keeping it shorter than 1 m.
The wire colours are the same on both models, but the pin numbering differs.
TFmini-S:
| 핀 | Wire colour | 신호 |
| - | ----------- | ------------------------------------------------------------ |
| 1 | 검정 | GND |
| 2 | 빨강 | +5 V |
| 3 | 흰색 | RX (UART receive, 3.3 V) |
| 4 | 녹색 | TX (UART transmit, 3.3 V) |
TFmini Plus:
| 핀 | Wire colour | 신호 |
| - | ----------- | ------------------------------------------------------------ |
| 1 | 빨강 | +5 V |
| 2 | 흰색 | RX (UART receive, 3.3 V) |
| 3 | 녹색 | TX (UART transmit, 3.3 V) |
| 4 | 검정 | GND |
### Wiring {#wiring}
The TFmini can be connected to any unused serial port (UART), such as `TELEM2`, `TELEM3` or `GPS2`.
| TFmini wire | Connect to |
| ------------------------------ | ------------------------------------------------------- |
| Green (TX) | Flight controller UART RX |
| White (RX) | Flight controller UART TX (optional) |
| Red (+5 V) | 5 V supply |
| Black (GND) | Flight controller GND |
The driver only reads from the sensor, so the sensor's RX wire does not need to be connected.
The TFmini-S needs 5 V ±0.1 V and up to 140 mA (200 mA peak); the TFmini Plus needs 5 V ±0.5 V and up to 110 mA (140 mA peak).
Neither has over-voltage or reverse-polarity protection.
## Firmware Support {#firmware_support}
The rangefinder is supported by the [tfmini](../modules/modules_driver_distance_sensor.md#tfmini) driver, which is built into firmware by either of the following [board configuration](../hardware/porting_guide_config.md) keys:
- `CONFIG_COMMON_DISTANCE_SENSOR=y`: the common set of rangefinder drivers, which includes this one.
- `CONFIG_DRIVERS_DISTANCE_SENSOR_TFMINI=y`: this driver on its own.
Most boards set `CONFIG_COMMON_DISTANCE_SENSOR`, so the driver is present in most firmware.
To check your board, look for either key in its configuration file, `boards///default.px4board`, or check whether [SENS_TFMINI_CFG](../advanced_config/parameter_reference.md#SENS_TFMINI_CFG) is listed in _QGroundControl_ (parameters are only shown for drivers that are in the firmware).
If the driver is missing, add either 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 parameters in [PX4 Configuration](#px4_configuration).
## PX4 Configuration {#px4_configuration}
[Configure the serial port](../peripherals/serial_configuration.md) on which the rangefinder will run using [SENS_TFMINI_CFG](../advanced_config/parameter_reference.md#SENS_TFMINI_CFG), and then reboot.
포트 전송속도는 드라이버에 의해 설정되므로, 추가로 설정하지 않아도 됩니다.
If the port is already used by another function, see [Deconflicting Ports](../peripherals/serial_configuration.md#deconflicting-ports) in _Serial Port Configuration_.
If the parameter is not available in _QGroundControl_ then the driver is not in the firmware: see [Firmware Support](#firmware_support).
The driver does not configure the sensor, so the sensor must be at its factory settings: UART interface, 115200 baud, and the `Standard 9 bytes (cm)` output format (not `Pixhawk` or `Standard 9 bytes (mm)`).
If these have been changed, reset the sensor to its defaults as described in the Benewake user manual.
[SENS_TFMINI_HW](../advanced_config/parameter_reference.md#SENS_TFMINI_HW) selects the model and sets the range limits PX4 reports.
Set it to `1` (`TFMINI / TFMINI-S`) for the TFmini-S or `4` (`TFMINI Plus`) for the TFmini Plus.
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
tfmini status
```
You can observe the published measurements with:
```sh
listener distance_sensor
```
The sensor type is reported as laser, with minimum and maximum distances of 0.4 m and 12 m for the TFmini-S, and 0.1 m and 12 m for the TFmini Plus.
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): tfmini](../modules/modules_driver_distance_sensor.md#tfmini)
- [TFmini-S Datasheet](https://en.benewake.com/uploadfiles/2025/04/20250430175121856.pdf) and [User Manual](https://en.benewake.com/uploadfiles/2025/04/20250430175136263.pdf) (Benewake)
- [TFmini Plus Datasheet](https://en.benewake.com/uploadfiles/2025/04/20250430175207216.pdf) and [User Manual](https://en.benewake.com/uploadfiles/2025/04/20250430175221028.pdf) (Benewake)