ESPHome component for reading the Garnet SeeLeveL tank sensor
Refer to the seelevel-inteface for a schematic diagram of the circuit needed to communicate with the sensors.
Connect RX to an input pin on the microcontroller with an internal or external pull-up resistor
to the microcontroller's positive rail (typically +3.3 VDC). 100 kOhm works well.
Connect TX to an output pin on the microcontroller.
Connect SENSOR_DATA to the SeeLevelL sensor's blue wire.
Connect SENSOR_GND to the SeeLevelL sensor's black wire.
Connect +12V to the power supply positive. The sensor and circuit should be able to tolerate
voltages roughly between +9 VDC and +15 VDC.
Connect GND to the power supply ground (can be a chassis ground) and to the microcontroller's ground.
# Declare the transceiver interface
seelevel:
# Transceiver component ID, optional unless there are multiple transceivers
id: seelevel_transceiver
# Receive pin
rx_pin: 32
# Transmit pin
tx_pin: 33
# Declare the tank sensors
sensor:
- platform: seelevel
# Transceiver component ID, optional unless there are multiple transceivers
seelevel_id: seelevel_transceiver
# Tank number for which the sensor has been configured (by cutting jumpers)
# - Fresh water: 1
# - Gray water: 2
# - Black water: 3
tank: 1
# The number of active segments the sensor has, it may have fewer if some were cut off
segments: 9
# Optionally declares a water level sensor whose value ranges from 0 to a little
# more than the number of segments. Accepts all Sensor parameters, including filters.
level:
name: "Water Level"
filters:
- sliding_window_moving_average:
window_size: 6
send_first_at: 3
send_every: 3
- delta: 0.1
# Optionally declares a water volume sensor by linearly interpolating a mapping from
# level to volume. Accepts all Sensor parameters, including filters.
volume:
name: "Water Volume"
# Maps from level to volume
# Requires at least one entry, can have more for tanks of non-uniform volume
# Entries must be arranged in non-decreasing order in both level and in volume
# Valid units of volume are: 'gal' (gallon) and 'L' (liter)
map:
- { level: 5.0, volume: 25 L }
- { level: 9.0, volume: 40 L }
filters:
- sliding_window_moving_average:
window_size: 6
send_first_at: 3
send_every: 3
- delta: 0.25
# Polling interal, default to 60s, use 'never' to disable automatic polling
update_interval: 10s