mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-11-22 14:19:57 +08:00
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:
1 parent
787e1d81ee
commit
4aeafd9ec6
2 files changed
+115
-32
No files matched your search
@@ -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
|
||||
|
||||
|
||||
@@ -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).
|
||||
|
||||

|
||||
|
||||
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.
|
||||

|
||||
|
||||
::: 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)
|
||||
Reference in new issue
Block a user