sen0590_esphome/README.md

ESPHome SEN0590 Laser Ranging Sensor Component

This is a custom component for ESPHome to integrate the DFRobot SEN0590 Laser Ranging Sensor (4m).

Features

• Measures distances from 2cm up to 400cm.
• Uses the I2C communication protocol.
• Provides distance readings in centimeters.
• Includes error handling for communication issues and invalid readings.

Sensor Information

• Product Wiki: DFRobot Laser Ranging Sensor (4m) SKU: SEN0590
• Communication: I2C
• I2C Address: 0x74 (default)
• Measurement Range: 2cm - 400cm
• Operating Voltage: 3.3V - 5V

Wiring

Connect the sensor to your ESP device's I2C pins:

Sensor Wire	ESP Pin	Description
Red (VCC)	3.3V or 5V	Power Supply Positive
Black (GND)	GND	Ground
Yellow (SCL)	I2C SCL Pin	I2C Clock Line
Green (SDA)	I2C SDA Pin	I2C Data Line

ESPHome Configuration Example

esphome:
  name: laser_distance_test
  # ... other config

# Enable I2C
i2c:
  sda: GPIO21 # Adjust GPIO pins as needed
  scl: GPIO22
  scan: true
  id: bus_a

# Add the custom component directory
external_components:
  - source: github://sredfern/sen0590_esphome@main

# Sensor configuration
sensor:
  - platform: sen0590
    name: "Laser Distance"
    update_interval: 100ms # Adjust as needed, min ~50ms due to sensor delay
    # Optional: Specify a different I2C address if changed
    # address: 0x75 


## Usage
The sensor will report the measured distance in centimeters. The `update_interval` should be set considering the sensor's response time (around 19-38ms plus the 50ms delay used in the component). Setting it too low might lead to missed readings or unstable behavior.