@@ -89,6 +89,53 @@ The client creates a default configuration on first boot. You can update configu
8989- ** Min Inches** : Tank level in inches at minimum sensor value
9090- ** Max Inches** : Tank level in inches at maximum sensor value
9191
92+ ### 4-20mA Current Loop Sensor Configuration
93+
94+ For 4-20mA current loop sensors, two mounting options are supported:
95+
96+ #### Pressure Sensor (Bottom-Mounted)
97+ Used for sensors like the Dwyer 626-06-CB-P1-E5-S1 (0-5 PSI) mounted near the bottom of the tank.
98+
99+ - ** Current Loop Type** : "pressure"
100+ - ** How it works** : Measures the pressure of the liquid column above the sensor
101+ - 4mA = Empty tank (0 PSI / no liquid above sensor)
102+ - 20mA = Full tank (max PSI / max liquid height)
103+ - ** Sensor Mount Height** : Height of sensor above tank bottom (usually 0-2 inches)
104+ - ** Max Value** : Maximum liquid height the sensor can measure (corresponds to 20mA)
105+
106+ ** Example Configuration** (0-5 PSI sensor, 1 PSI per 2.3 ft of water):
107+ - Sensor mounted 2 inches above tank bottom
108+ - Max sensor range = 5 PSI = ~ 138 inches of water
109+ - Tank height = 120 inches
110+ - Configuration:
111+ - ` currentLoopType ` : "pressure"
112+ - ` sensorMountHeight ` : 2.0
113+ - ` maxValue ` : 138.0 (or actual tank height if tank is smaller)
114+
115+ #### Ultrasonic Sensor (Top-Mounted)
116+ Used for sensors like the Siemens Sitrans LU240 mounted on top of the tank looking down.
117+
118+ - ** Current Loop Type** : "ultrasonic"
119+ - ** How it works** : Measures the distance from the sensor to the liquid surface
120+ - 4mA = Full tank (liquid close to sensor)
121+ - 20mA = Empty tank (liquid far from sensor)
122+ - ** Sensor Mount Height** : Distance from sensor to tank bottom when tank is empty
123+ - ** Max Value** : Maximum liquid height (tank capacity)
124+
125+ ** Example Configuration** (ultrasonic sensor on 10-foot tank):
126+ - Sensor mounted 124 inches above tank bottom (tank is 120 inches + 4 inch clearance)
127+ - Maximum tank fill level = 120 inches
128+ - Configuration:
129+ - ` currentLoopType ` : "ultrasonic"
130+ - ` sensorMountHeight ` : 124.0
131+ - ` maxValue ` : 120.0
132+
133+ ** Calibration Tips for 4-20mA Sensors:**
134+ 1 . Record the actual mA output at known liquid levels (empty, half-full, full)
135+ 2 . Verify sensor mount height is accurate
136+ 3 . Check for temperature effects on readings
137+ 4 . Consider the specific gravity of the liquid (for pressure sensors)
138+
92139### Float Switch Configuration (Digital Sensors)
93140Float switches can be configured as either normally-open (NO) or normally-closed (NC):
94141
0 commit comments