ErdiLRF — Arduino UART driver

Arduino and ESP32 library for 22 ERDI 905 nm laser rangefinder modules over UART (LR1000E-LR2000E, LRF1200A1, LRF3000A1, SPD1200N, LRF50H-LRF1500H, LRF22VB, LRF50VB). It works with any Arduino Stream (HardwareSerial, SoftwareSerial, ESP32 Serial1/Serial2). Model pages and manuals: erdilrf.com/models. Host UART capabilities and the delivered module interface must be checked for the selected configuration; a library entry is not a hardware-compatibility or electrical-level guarantee.

Install · First reading · Examples · Model scope

First reading

1. Confirm the exact model, manual revision, delivered UART interface, supply and signal levels before wiring.
2. Install ErdiLRF, then open BasicMeasure. Select ERDI_TARGET_MODEL and configure the host UART for your board.
3. Read the status and distance output together. Keep unresolved model-specific limits visible; an example sketch does not prove hardware compatibility.

For a streaming module, use ContinuousStream and read the selected model's protocol notes first.

Wiring

 Module  TX ----> RX  Arduino / ESP32 UART
 Module  RX <---- TX  Arduino / ESP32 UART
 Module  GND ---- GND (one common ground)
 Module  VCC <--- its own regulator, per the model's manual

Cross TX and RX and share ground. Check the module's TX logic level against the host before connecting (supply voltage is not the UART voltage; use a level shifter when they differ). Pin order is model-specific: use the model page and manual. ESP32 example: Serial1.begin(erdiDefaultBaud(ERDI_LRF3000A1), SERIAL_8N1, RX_PIN, TX_PIN); then ErdiLRF lrf(Serial1, ERDI_LRF3000A1);. Family-B modules (460800 baud) need a hardware UART; SoftwareSerial cannot reach that rate.

Install

• Arduino IDE / Arduino CLI Library Manager: Sketch -> Include Library -> Manage Libraries -> search ErdiLRF -> Install. The registry submission has been accepted. If your local index is out of date, refresh it or use Git below.
• From Git: arduino-cli lib install --git-url https://github.com/ErdiTech/ErdiLRF or clone/copy this repository into your sketchbook's libraries/ folder.
• PlatformIO: add to platformio.ini:

  lib_deps =
      erdi-tech/ErdiLRF

  See the PlatformIO Registry for published versions. Git installation remains available with https://github.com/ErdiTech/ErdiLRF.git.

Model identifiers and validation scope

The library source contains these model identifiers:

LR1000E2, LR1000E4, LR1200E2, LR1200E4, LR1500E2, LR1500E4, LR2000E2, LR2000E4, LRF1200A1, LRF3000A1, SPD1200N0, SPD1200N2, SPD1200N4, SPD1200D03, LRF50H, LRF100H, LRF200H, LRF300H, LRF600H, LRF1500H, LRF22VB, LRF50VB.

Select the exact model and manual revision before interpreting a reading. A common frame header does not establish a common distance unit, baud rate, supply, signal voltage, checksum interpretation or safety classification. Check the delivered unit's configuration and interface before wiring; a supply-voltage value is not a TX/RX logic-level specification.

SPD1200D03 has conflicting baud-rate statements in its source manual. The library does not choose an automatic baud for it; confirm the delivered setting. Other documented source discrepancies remain unresolved, including the LRF50VB command-table/checksum mismatch and the LRF1500H checksum/sentinel examples. Do not treat this documentation update as resolving those issues or validating every model against hardware.

For model documents and configuration questions, use the model catalogue and product enquiry form.

Usage

#include <ErdiLRF.h>

static const ErdiModel ERDI_TARGET_MODEL = ERDI_LRF3000A1;

See the bundled examples:

• BasicMeasure -- single-shot ranging.
• ContinuousStream -- free-running stream mode.

A step-by-step wiring and first-reading walkthrough is here: Read a laser distance module over Arduino UART.

Also available

• Python driver: install the published GitHub release wheel:

  pip install https://github.com/ErdiTech/erdi-lrf-drivers/releases/download/v0.1.0/erdi_lrf-0.1.0-py3-none-any.whl

  See the Python installation guide.
• ROS 2 node: erdi_lrf_driver (builds and tests on ROS 2 Jazzy and Humble in CI).

This repository is a maintained split of arduino/ErdiLRF from that mono-repo, published standalone so it can be registered with the Arduino Library Manager and the PlatformIO Registry. Arduino Library Manager tracks repository tags; PlatformIO packages are published separately.

Support

If this library saves you time, a tip is appreciated (send the matching coin on the matching network only):

Network	Address
USDT (TRC20)	TNGdTwE6opH6rmUyoG1JUR7FSyEb4k273R
USDT (ERC20 / BEP20 / Polygon), ETH (Ethereum / Arbitrum / Base)	0x59c43144a862b351fa1086ae842d1327c9d91613
BTC	1RS6tWXHregLfEsiPzVUCUBuhgDg5uTSV
USDT (Solana)	HZguEXfTtLChNdJTxAYCbcGscaqikz8JYrEpUhEyeVd9

License

MIT -- see LICENSE.

Contact

ERDI TECH LTD · 905 nm laser rangefinder modules · tommy@erdimail.com · WhatsApp +86 133 0819 5790 · erdilrf.com

• Email ERDI
• WhatsApp
• Product enquiries
• Website