HC-SR04 Liquid Level (Ultrasonic)

Ultrasonic sensor repurposed for non-contact liquid level measurement in tanks. GPIO echo timing.

Sensor HC-SR04-LEVEL fluid gpio Draft

This entry is draft and has not been confirmed against physical hardware. A conforming tool will refuse to provision it. The datasheet is the authority, not this page.

Specifications

Protocol gpio
Sensor type fluid
Model number HC-SR04-LEVEL
Read interval seconds 30

Readings

SlugDevice classUnitRange
level-percent - % 0 to 100

Wiring

PinRequiredNotes
trig Yes
echo Yes Outputs 5V. Must be divided or level shifted to 3.3V before reaching a GPIO input.

Supply: 5V

Failure modes

  • The echo pin idles at 5V. Connecting it directly to a Raspberry Pi GPIO will damage the pin. A divider or level shifter is mandatory.
  • Level percent is derived from distance and requires the empty and full distances to be configured per installation. Without them the reading is meaningless.
  • Condensation on the transducer face in a tank headspace causes sustained misreads.
  • Foam and turbulent surfaces scatter the pulse and produce no echo.

Entry

Keyhc-sr04-level
StatusDraft
Revision1
Registry0.3.0
Entry on GitHub JSON for agents

Join the Private Beta

Pre-registering for the IntelliConnect Beta provides early access to infrastructure features, the development roadmap, and early-adopter pricing tiers.

Early Access

Access to the broker, MCPs, rule engine, and developer console during launch phase.

Direct Support

Direct communication channel with the engineering team for integration assistance.

Discounts

Beta testers secure specialized pricing tiers for both Enterprise and Maker accounts.

Pre-register Now