Skip to content

Commit 9d97064

Browse files
Copilotdorkmo
andcommitted
Add documentation for 4mA-20mA sensor configuration options
Co-authored-by: dorkmo <[email protected]>
1 parent 1d6465b commit 9d97064

File tree

1 file changed

+47
-0
lines changed

1 file changed

+47
-0
lines changed

TankAlarm-112025-Client-BluesOpta/README.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -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)
93140
Float switches can be configured as either normally-open (NO) or normally-closed (NC):
94141

0 commit comments

Comments
 (0)