docs(sensor): restructure Ainstein US-D1 rangefinder page (#29185)

* docs(sensor): restructure Ainstein US-D1 rangefinder page

The page said the driver is not in most firmware and has to be started
from a configuration file. Neither is true: ulanding_radar is in the
common distance sensor set, and is started by SENS_ULAND_CFG.

Add specifications, mounting, pinout and wiring from the current
Ainstein manual, a Firmware Support section giving the board
configuration keys, and testing instructions. Remove the unsupported
NDAA tick from the rangefinder index and give the range as min-max.

Assisted-by: Claude:claude-opus-5-5
Signed-off-by: Hamish Willee <hamishwillee@gmail.com>

* Apply suggestion from @hamishwillee

---------

Signed-off-by: Hamish Willee <hamishwillee@gmail.com>
This commit is contained in:
Hamish Willee authored and GitHub committed 2026-10-28 08:57:49 +11:00
1 parent 787e1d81ee
commit 4aeafd9ec6
2 files changed
+115 -32

No files matched your search

+4 -4
View File
@@ -17,7 +17,7 @@ There may also be other DroneCAN rangefinders than those listed here.
| Rangefinder | Technology | Range (min – max) | Connections | NDAA | Notes |
| ------------------------------------------- | --------------- | ----------------- | ---------------- | ---- | ----------------------------------- |
| [Ainstein US-D1 Standard Radar Altimeter] | Microwave radar | ~50 m | UART | ✔️ | |
| [Ainstein US-D1 Standard Radar Altimeter] | Microwave radar | 0.5 m – 50 m | UART | ✔️ | All-weather, works over water |
| [ARK DIST SR] | ToF (850 nm IR) | 8 cm to ~30 m | DroneCAN, UART | ✔️ | |
| [ARK DIST MR] | ToF (IR) | 8 cm to ~50 m | DroneCAN, UART | ✔️ | |
| [Benewake TFmini] | ToF (IR laser) | ~12 m | UART | ~ | |
@@ -130,9 +130,9 @@ PX4 supports the following models connected via the I2C bus: TeraRanger Evo 60m,
### Ainstein US-D1 Standard Radar Altimeter
The _Ainstein_ [US-D1 Standard Radar Altimeter](../sensor/ulanding_radar.md) is compact microwave rangefinder that has been optimised for use on UAVs.
It has a sensing range of around 50m.
A particular advantages of this product are that it can operate effectively in all weather conditions and over all terrain types (including water).
The [Ainstein US-D1 Standard Radar Altimeter](../sensor/ulanding_radar.md) is a compact microwave radar rangefinder with a range of 0.5 m to 50 m and a 100 Hz update rate.
It can operate effectively in all weather conditions and over all terrain types (including water).
It must be connected to a UART/serial bus.
### LeddarOne
+111 -28
View File
@@ -1,38 +1,121 @@
# Ainstein US-D1 Standard Radar Altimeter
:::tip
This supersedes the _Aerotenna uLanding Radar_ (discontinued) but uses the same driver/setup.
:::
<Badge type="tip" text="PX4 v1.7" />
The _Ainstein_ [US-D1 Standard Radar Altimeter](https://ainstein.ai/us-d1-all-weather-radar-altimeter/) is a compact microwave rangefinder that has been optimised for use on UAVs.
With a sensing range of about 50 metres, it is useful for applications including terrain following, precision hovering (e.g. for photography), anti-collision sensing etc.
Particular advantages of this product are that it can operate effectively in all weather conditions and over all terrain types (including water).
The user manual can be found [here](https://ainstein.ai/wp-content/uploads/US-D1-Technical-User-Manual-D00.02.05.docx.pdf).
The [Ainstein US-D1 Standard Radar Altimeter](https://ainstein.ai/us-d1-all-weather-radar-altimeter/) is a compact microwave radar [rangefinder](../sensor/rangefinders.md) with a range of 0.5–50 m and a 100 Hz update rate.
It connects to the flight controller using a serial port (UART).
It is useful for applications including terrain following and precision hovering (e.g. for photography), and can operate effectively in all weather conditions and over all terrain types (including water).
![Ainstein US-DA](../../assets/hardware/sensors/ainstein/us_d1_hero.jpg)
The rangefinder is not automatically included in most firmware, and hence cannot be used just by setting a parameter through _QGroundControl_ (as is possible with some other rangefinders).
To use it you will need to add the driver to firmware and update a configuration file to start the driver on boot.
The sections below explain how.
## Hardware Setup
The rangefinder is supported by any hardware which runs a NuttX or Posix OS and which can offer a serial port for the interface.
Minimally this will include most, if not all, [Pixhawk Series](../flight_controller/pixhawk_series.md) controllers.
US-D1 can be connected to any unused _serial port_ (UART), e.g.: TELEM2, TELEM3, GPS2 etc.
## Parameter Setup
[Configure the serial port](../peripherals/serial_configuration.md) on which the lidar will run using [SENS_ULAND_CFG](../advanced_config/parameter_reference.md#SENS_ULAND_CFG).
There is no need to set the baud rate for the port, as this is configured by the driver.
![Ainstein US-D1](../../assets/hardware/sensors/ainstein/us_d1_hero.jpg)
::: info
The US-D1 supersedes the _Aerotenna uLanding Radar_ (discontinued), and uses the same driver and setup.
:::
If the configuration parameter is not available in _QGroundControl_ then you may need to [add the driver to the firmware](../peripherals/serial_configuration.md#parameter_not_in_firmware):
## Specifications {#specifications}
```plain
CONFIG_DRIVERS_DISTANCE_SENSOR_ULANDING_RADAR=y
- **Technology:** Microwave radar (24 GHz)
- **Range:** 0.5–50 m (PX4 reports measurements from 0.315 m)
- **Update rate:** 100 Hz
- **Field of view:** 43° x 30°
- **Accuracy:** 6 cm below 1 m, 4 cm above 1 m
- **Interface:** UART, CAN (the PX4 driver uses UART at 115200 baud)
- **Input voltage:** 5–13 V DC (5.5 V recommended)
- **Power consumption:** 2 W at 5 V
- **Dimensions:** 108 x 79 x 20 mm
- **Weight:** 110 g
- **Operating temperature:** -20 °C to 65 °C
- **Ingress protection:** IP67 (with sealant)
## Where to Buy {#store}
- [US-D1: All-Weather Radar Altimeter](https://sensing.ai/collections/ainstein-radar-products/products/us-d1radar-altimeter) (Ainstein store)
## Hardware Setup {#hardware_setup}
### Mounting {#mounting}
Mount the US-D1 rigidly on the underside of the vehicle, with its front face (the radome) parallel to the ground and facing directly down.
Keep it well away from the landing gear and any other structure that could fall within its field of view, and do not cover or coat the radome.
PX4 assumes that the sensor is facing down (the orientation cannot be configured).
### Pinouts {#pinouts}
The US-D1 has a short cable terminated with a 4-pin Molex connector.
| Wire colour | Signal | Description |
| ----------- | ------ | ---------------------- |
| Black | GND | Ground |
| White | RX | UART receive (3.3 V) |
| Green | TX | UART transmit (3.3 V) |
| Red | VCC | Power input, 5–13 V DC |
::: info
The US-D1 is shipped configured for either UART, CAN, or DroneCAN output.
The wiring above, and the setup on this page, are for the UART version.
:::
### Wiring {#wiring}
The US-D1 can be connected to any unused serial port (UART), such as `TELEM2`, `TELEM3` or `GPS2`.
| US-D1 wire | Connect to |
| ----------- | ------------------------------------ |
| Black (GND) | Flight controller GND |
| Green (TX) | Flight controller UART RX |
| White (RX) | Flight controller UART TX (optional) |
| Red (VCC) | 5–13 V DC supply (5.5 V recommended) |
The driver only reads from the sensor, so the sensor RX wire does not need to be connected.
The sensor consumes about 2 W (around 400 mA at 5 V).
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.
## Firmware Support {#firmware_support}
The rangefinder is supported by the [ulanding_radar](../modules/modules_driver_distance_sensor.md#ulanding-radar) 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_ULANDING_RADAR=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/<vendor>/<board>/default.px4board`, or check whether [SENS_ULAND_CFG](../advanced_config/parameter_reference.md#SENS_ULAND_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_ULAND_CFG](../advanced_config/parameter_reference.md#SENS_ULAND_CFG), and then reboot.
There is no need to set the baud rate for the port, as this is configured by the driver.
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
ulanding_radar status
```
:::
You can observe the published measurements with:
```sh
listener distance_sensor
```
The sensor type is reported as radar, with minimum and maximum distances of 0.315 m and 50 m.
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): ulanding_radar](../modules/modules_driver_distance_sensor.md#ulanding-radar)
- [US-D1 Technical User Manual](https://ainstein.ai/wp-content/uploads/US-D1-Technical-User-Manual-3.pdf) (Ainstein)
- [US-D1 Data Sheet](https://ainstein.ai/wp-content/uploads/US-D1-Data-Sheet-2.pdf) (Ainstein)