|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange
|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange
|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange
|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange
|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange
|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange
|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange
|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange
|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange
|
erdi_lrf_driver package from erdi_lrf_driver repoerdi_lrf_driver |
ROS Distro
|
Package Summary
| Version | 0.3.0 |
| License | MIT |
| Build type | AMENT_PYTHON |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/ErdiTech/erdi_lrf_driver.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-11-17 |
| Dev Status | DEVELOPED |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- ERDI Technology
Authors
- ERDI Technology
erdi_lrf_driver
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).
Install
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.bash
Run
ros2 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 /range
Add yourself to the serial group first: sudo usermod -aG dialout $USER.
Parameters
| 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. |
Beam divergence (field_of_view)
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.
Topics
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.
Tests
colcon test --packages-select erdi_lrf_driver && colcon test-result --verbose
Includes ament_copyright, ament_flake8, ament_pep257 and a node test
that runs against a fake serial port, so no hardware is needed.
See also
- 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
File truncated at 100 lines see the full file
Changelog for package erdi_lrf_driver
0.3.0 (2026-11-18)
- Vendored codec refreshed from
erdi-lrf0.1.8: addsLRF10VBandSPD1200S2G(24 models in total).tools/sync_codec.pymirrors the library byte-for-byte and a test fails if the copy drifts from an installederdi-lrf. - Beam-divergence table moved out of the vendored codec into
erdi_lrf_driver.fov. - Contributors: ERDI TECH LTD
0.2.0 (2026-11-11)
- Rename package
erdi_lrf_ros2toerdi_lrf_driver(REP-144: no redundantros2, driver packages end indriver). Topics, parameters and executable names are unchanged. - Contributors: ERDI TECH LTD
0.1.0 (2026-11-06)
- Initial release:
erdi_lrf_nodepublishingsensor_msgs/msg/Rangefor ERDI UART laser rangefinder modules (protocol families A and B). - Bundled serial codec (from
erdi-lrf0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial). - Per-model beam divergence table (
field_of_view0.0 = use table);continuousandacknowledge_protocol_holdparameters;range_nodeexecutable alias. - Contributors: ERDI Technology
Package Dependencies
| Deps | Name |
|---|---|
| rclpy | |
| sensor_msgs | |
| rcl_interfaces | |
| launch | |
| launch_ros | |
| ament_copyright | |
| ament_flake8 | |
| ament_pep257 |