etc.¶

Plugin details¶

Type: Distance

Name: HC-SR04/RCW-0001

Status: NORMAL CLIMATE

GitHub: P013_HCSR04.ino

Maintainer: .

Used libraries: NewPing

Supported hardware¶

HC-SR04¶

RCW-0001¶

US-100¶

Introduction¶

The HC-SR04/RCW-0001/US-100 is an ultrasonic distance sensor. It’s able to indicate distances between 2 cm up to about 300 cm at a resolution of about 0.3 cm.

Specifications:

Ultrasonic distance sensor
Measure angle: 30°
Ranging distance: 2cm - 300cm (some have reporting it work good up to 400 cm)

Wiring¶

The HC-SR04/RCW-0001/US-100 must be run on 5V. Running it with 3.3V will show very weak results or nothing at all.

ESP               HC-SR04/RCW-0001/US-100
GPIO (X)   <-->   Trigger
GPIO (X)   <-->   Echo (voltage divider!)

Power
5.0V       <-->   VCC
GND        <-->   GND

Warning

Do not connect 5V directly to the ESP! Read more about Level converter.

Setup¶

Task settings¶

Device: Name of plugin
Name: Name of the task (example name HCSR04), should not be empty.
Enable: Should the task be enabled or not

Sensor¶

GPIO –> Trigger: Set the GPIO to trigger the signal.
GPIO –> Echo, 5V: Set the GPIO to receive the echo signal, a voltage divider is needed.

Mode: Value is the most used setting, it will output the distance in centimeters. If you want the plugin to report a 1 or a 0 you use the State setting. State or Combined will open up a new field called “Threshold” which will allow you to enter a value. If the unit detects a value below the given threshold the task will be set to 1, if the detected value is above the given threshold the task will be 0. You should set the Interval to zero in case of using the state setting, just to make sure the action is triggered as soon as possible.

A third option is to combine both the Value and State modes, to have both the distance and state values available. This mode is called Combined.

Threshold: Set the distance that will trigger the event for the State or Combined mode.
Max distance: Set the max value the task will show. If the actual value is above the max distance the max distance will be displayed. Set to 0 will disable the max distance setting. Max according to the specifications is 300 cm.
Unit: You can show the output value as imperial without the need to do it using the formula function.
Filter: The signal might be a bit shaky for some applications, try to use the Median filtering setting in that case.
Trigger width: For hardware that doesn’t exactly follow the timing guidelines, it may be needed to extend the pulse delay somewhat to receive a usable echo. The default is 10 microsoconds, and can be increased in small steps to max. 20 microseconds.

Data acquisition¶

Single event with all values: This setting combines all values for the plugin in a single <taskname>#All,<value>[,<value>] event.
Send to controller 1..3: Check which controller (if any) you want to publish to. All or no controller can be used.
Interval: How often should the task publish its value (1..5 seconds is normal for the Value or Combined settings, 0 for the State setting).

Indicators (recommended settings)¶

Indicator	Value Name	Interval	Decimals	Extra information
Distance	Distance	1	1	Used to get the actual distance that the sensor is measuring.
State	State	0	0	Used to set the value high or low, just like a normal switch input device.

Rules examples¶

on HCSR04#distance do
  if %eventvalue1%<50 and %eventvalue1%>45
    GPIO,14,1 //light up LED to show that you're at the correct position
  else
    GPIO,14,0
  endif
endon

Where to buy¶

Store	Link
AliExpress	Link 1 ($)
Banggood	Link 2 ($)
eBay	Link 3 ($)

$ = affiliate links which will give us some money to keep this project running, thank you for using those.

Change log¶

Changed in version 2.0: …

added Major overhaul for 2.0 release.

Added in version 1.0: …

added Initial release version.