No version for distro humble showing rolling. Known supported distros are highlighted in the buttons above.
Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange

No version for distro jazzy showing rolling. Known supported distros are highlighted in the buttons above.
Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange

No version for distro kilted showing rolling. Known supported distros are highlighted in the buttons above.
Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange

No version for distro lyrical showing rolling. Known supported distros are highlighted in the buttons above.
Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange

Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange

No version for distro github showing rolling. Known supported distros are highlighted in the buttons above.
Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange

No version for distro galactic showing rolling. Known supported distros are highlighted in the buttons above.
Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange

No version for distro iron showing rolling. Known supported distros are highlighted in the buttons above.
Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange

No version for distro melodic showing rolling. Known supported distros are highlighted in the buttons above.
Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange

No version for distro noetic showing rolling. Known supported distros are highlighted in the buttons above.
Package symbol

erdi_lrf_driver package from erdi_lrf_driver repo

erdi_lrf_driver

ROS Distro
rolling

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

ROS 2 driver for ERDI UART laser rangefinder modules (905 nm, up to several kilometres of range). Publishes the distance sensor reading as sensor_msgs/msg/Range for both published ERDI serial protocol families.

Additional Links

Maintainers

  • ERDI Technology

Authors

  • ERDI Technology

erdi_lrf_driver

CI

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

File truncated at 100 lines see the full file

CHANGELOG

Changelog for package erdi_lrf_driver

0.3.0 (2026-11-18)

  • Vendored codec refreshed from erdi-lrf 0.1.8: adds LRF10VB and SPD1200S2G (24 models in total). tools/sync_codec.py mirrors the library byte-for-byte and a test fails if the copy drifts from an installed erdi-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_ros2 to erdi_lrf_driver (REP-144: no redundant ros2, driver packages end in driver). Topics, parameters and executable names are unchanged.
  • Contributors: ERDI TECH LTD

0.1.0 (2026-11-06)

  • Initial release: erdi_lrf_node publishing sensor_msgs/msg/Range for ERDI UART laser rangefinder modules (protocol families A and B).
  • Bundled serial codec (from erdi-lrf 0.1.1) so the package depends only on rosdep-resolvable keys (python3-serial).
  • Per-model beam divergence table (field_of_view 0.0 = use table); continuous and acknowledge_protocol_hold parameters; range_node executable alias.
  • Contributors: ERDI Technology

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged erdi_lrf_driver at Robotics Stack Exchange