ROS 2 driver for ERDI UART laser rangefinder modules
(905 nm, hundreds of metres to kilometre-class range). It publishes the
distance sensor reading as sensor_msgs/msg/Range, so the module can feed
nav2, robot_localization, PX4/ArduPilot companion bridges, or your own
altitude/obstacle logic.
Both published ERDI serial protocol families are supported (family A 55 AA
command/response, family B free-running 5C frames). The serial codec is
vendored in the package (erdi_lrf_driver/_erdi_lrf, MIT, mirrored byte-for-byte from the
erdi-lrf 0.1.8 Python driver by tools/sync_codec.py; 24 models), so the
only runtime dependency is pyserial (python3-serial).
cd ~/ros2_ws/src
git clone https://github.com/ErdiTech/erdi_lrf_driver.git
cd ~/ros2_ws
rosdep install --from-paths src --ignore-src -y
colcon build --packages-select erdi_lrf_driver
source install/setup.bashros2 launch erdi_lrf_driver erdi_lrf.launch.py port:=/dev/ttyUSB0 model:=LRF3000A1 rate:=10.0
# or
ros2 run erdi_lrf_driver erdi_lrf_node --ros-args -p port:=/dev/ttyUSB0 -p model:=LRF1500H
ros2 topic echo /rangeAdd yourself to the serial group first: sudo usermod -aG dialout $USER.
| Name | Default | Description |
|---|---|---|
port |
/dev/ttyUSB0 |
Serial device. |
model |
LRF3000A1 |
Module model, e.g. LR1200E2, LRF3000A1, SPD1200N2, LRF100H, LRF1500H, LRF22VB. See the model table at erdilrf.com/models. |
baud |
0 |
0 = the model's documented default. SPD1200D03 has no safe default: set it explicitly. |
frame_id |
erdi_lrf_link |
TF frame of the message header. |
rate |
10.0 |
Polling rate in Hz. |
timeout |
0.5 |
Serial read timeout in seconds. |
min_range / max_range |
0.0 |
Metres. 0.0 takes the value from the model table. |
field_of_view |
0.0 |
Full beam divergence in radians. 0.0 = use the per-model value from the table below (fallback 0.002 for models without a published divergence). |
continuous |
false |
Stream continuously instead of one request per tick. |
acknowledge_protocol_hold |
false |
Needed for continuous on LRF1200A1 / LRF3000A1, whose manuals leave the continuous-reply function byte unresolved. |
topic |
range |
Output topic name. |
Parsed from each model's published specification table at
erdilrf.com/models (checked 2026-11-06); the datasheet
upper bound is used (< 6 mrad becomes 0.006).
| Model | field_of_view (rad) |
|---|---|
| LR1000E2 | 0.009 |
| LR1000E4 | 0.009 |
| LR1200E2 | 0.004 |
| LR1200E4 | 0.004 |
| LR1500E2 | 0.006 |
| LR1500E4 | 0.006 |
| LR2000E2 | 0.006 |
| LR2000E4 | 0.006 |
| LRF3000A1 | 0.01 |
| SPD1200N0 | 0.0045 |
| SPD1200N2 | 0.0045 |
| SPD1200N4 | 0.0045 |
No divergence row is published for LRF1200A1, SPD1200D03, LRF50H, LRF100H, LRF200H, LRF300H, LRF600H, LRF1500H, LRF22VB, LRF50VB, LRF10VB, SPD1200S2G; these keep the 0.002 default, so set field_of_view yourself for them.
range (sensor_msgs/msg/Range, sensor-data QoS): radiation_type is
INFRARED. Out-of-range readings follow REP-117: -inf below the minimum
range, +inf beyond the maximum or when the module reports no target, nan
for an invalid measurement.
colcon test --packages-select erdi_lrf_driver && colcon test-result --verboseIncludes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
- Worked examples and wiring notes: ErdiTech/erdi-lrf-ros2-examples
- Python driver and protocol documentation: ErdiTech/erdi-lrf-drivers
- Check what a module sends before starting the node: UART frame decoder (browser, or
pip install lrf-uart-decoder) - Model table, datasheets and contact: erdilrf.com
This package was released as erdi_lrf_ros2 (0.1.0) and renamed to
erdi_lrf_driver in 0.2.0 to follow REP-144
(no redundant ros2 in the name, driver packages end in driver). The
repository moved to ErdiTech/erdi_lrf_driver; the old URL redirects. Topics,
parameters and executable names (erdi_lrf_node, range_node) are unchanged;
only the package name changes: use ros2 launch erdi_lrf_driver erdi_lrf.launch.py
and colcon build --packages-select erdi_lrf_driver.
It also replaces the earlier ros2/ folder in
ErdiTech/erdi-lrf-drivers; it no
longer needs pip install erdi-lrf.
If this project saved you time, you can buy the author a coffee in crypto. Thank you! 如果这个项目帮到了你,欢迎用加密货币打赏支持,谢谢!
| Network | Asset | Address |
|---|---|---|
| TRON (TRC20) | USDT | TNGdTwE6opH6rmUyoG1JUR7FSyEb4k273R |
| Ethereum / BNB Chain / Polygon | USDT | 0x59c43144a862b351fa1086ae842d1327c9d91613 |
| Ethereum / Arbitrum / Base | ETH | 0x59c43144a862b351fa1086ae842d1327c9d91613 |
| Bitcoin | BTC | 1RS6tWXHregLfEsiPzVUCUBuhgDg5uTSV |
| Solana | USDT | HZguEXfTtLChNdJTxAYCbcGscaqikz8JYrEpUhEyeVd9 |
Please send only the listed asset on the listed network — other tokens or networks may be lost. 请按表中对应的网络转对应的币种,转错币种或网络可能无法找回。
MIT, see LICENSE.