5.2
2026-10-07T00:00:00Z
Templates/MiRCA
MiRCA Port 1 JK BMS parallel bus
MiRCA Port 1 JK BMS parallel bus
MiRCA serial port 1 running the 'JK BMS parallel bus' protocol (protocol id 8). SNMP v2c over the Ethernet interface, tree .1.3.6.1.4.1.2021.13.16.4.2.1 (doc/ports.md). Link 'MiRCA Device' too. Listens on the RS485 parallel bus of JK-PB batteries (never transmits). Port values are the group summary; every battery on the bus is discovered (.50.<address+1>). Battery N+1 = bus address N, Battery 1 = master.
Templates/MiRCA
Port 1
Battery
Batteries
Cells
Temperature
-
Port 1: protocol
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.1
mirca.p1.protocol
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Protocol configured on the port
Port 1
MiRCA protocol
-
Port 1: online
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.2
mirca.p1.online
{$MIRCA.INTERVAL}
14d
365d
UNSIGNED
1 while the device answers. All values read 0 while it is offline.
Port 1
MiRCA online
-
Port 1: seconds since last reply
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.3
mirca.p1.age
{$MIRCA.INTERVAL}
14d
365d
FLOAT
s
-1: no reply since boot
Port 1
-
Port 1: voltage
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.10
mirca.p1.voltage
{$MIRCA.INTERVAL}
14d
365d
FLOAT
V
Battery
MULTIPLIER
0.01
-
Port 1: current
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.11
mirca.p1.current
{$MIRCA.INTERVAL}
14d
365d
FLOAT
A
+ charging, - discharging
Battery
MULTIPLIER
0.01
-
Port 1: power
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.12
mirca.p1.power
{$MIRCA.INTERVAL}
14d
365d
FLOAT
W
+ charging, - discharging
Battery
-
Port 1: SOC
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.13
mirca.p1.soc
{$MIRCA.INTERVAL}
14d
365d
FLOAT
%
Battery
MULTIPLIER
0.1
-
Port 1: remaining capacity
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.15
mirca.p1.cap_remain
{$MIRCA.INTERVAL}
14d
365d
FLOAT
Ah
Battery
MULTIPLIER
0.01
-
Port 1: full capacity
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.16
mirca.p1.cap_full
{$MIRCA.INTERVAL.SLOW}
14d
365d
FLOAT
Ah
Battery
MULTIPLIER
0.01
-
Port 1: MOSFET temperature
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.18
mirca.p1.mos_temp
{$MIRCA.INTERVAL}
14d
365d
FLOAT
°C
Battery
MULTIPLIER
0.1
-
Port 1: alarm bits
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.19
mirca.p1.alarms
{$MIRCA.INTERVAL}
14d
365d
UNSIGNED
JK alarm bit mask (register 0xA0), see doc/ports.md
Battery
JAVASCRIPT
return (parseInt(value, 10) >>> 0).toString();
-
Port 1: alarms
DEPENDENT
mirca.p1.alarms.text
0
14d
0
CHAR
Battery
JAVASCRIPT
var names = ['balance wire resistance too high', 'MOSFET overtemperature', 'cell count mismatch', 'current sensor fault', 'cell overvoltage', 'battery overvoltage', 'charge overcurrent', 'charge short circuit', 'charge overtemperature', 'charge undertemperature', 'internal communication fault', 'cell undervoltage', 'battery undervoltage', 'discharge overcurrent', 'discharge short circuit', 'discharge overtemperature', 'charge MOSFET fault', 'discharge MOSFET fault', 'GPS disconnected', 'change authorization password', 'discharge enable failed', 'battery overtemperature', 'temperature sensor fault'];
var v = parseInt(value, 10) >>> 0, out = [];
for (var i = 0; i < 32; i++)
if ((v >>> i) & 1) out.push(i < names.length ? names[i] : 'bit ' + i);
return out.length ? out.join(', ') : 'none';
DISCARD_UNCHANGED_HEARTBEAT
1h
mirca.p1.alarms
Port 1: batteries discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.1.50]
mirca.p1.bat.discovery
10m
7d
Batteries seen on the parallel bus (the firmware registers their OIDs on the first frame)
Port 1: battery {#BAT}: online
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.2
mirca.p1.bat.online[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
UNSIGNED
Batteries
MiRCA online
Port 1: battery {#BAT}: seconds since last frame
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.3
mirca.p1.bat.age[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
s
Batteries
Port 1: battery {#BAT}: voltage
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.10
mirca.p1.bat.voltage[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
V
Batteries
MULTIPLIER
0.01
Port 1: battery {#BAT}: current
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.11
mirca.p1.bat.current[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
A
+ charging
Batteries
MULTIPLIER
0.01
Port 1: battery {#BAT}: power
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.12
mirca.p1.bat.power[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
W
+ charging
Batteries
Port 1: battery {#BAT}: SOC
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.13
mirca.p1.bat.soc[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
%
Batteries
MULTIPLIER
0.1
Port 1: battery {#BAT}: cycles
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.14
mirca.p1.bat.cycles[{#BAT}]
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Batteries
Port 1: battery {#BAT}: remaining capacity
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.15
mirca.p1.bat.cap_remain[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
Ah
Batteries
MULTIPLIER
0.01
Port 1: battery {#BAT}: full capacity
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.16
mirca.p1.bat.cap_full[{#BAT}]
{$MIRCA.INTERVAL.SLOW}
14d
365d
FLOAT
Ah
Batteries
MULTIPLIER
0.01
Port 1: battery {#BAT}: cell count
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.17
mirca.p1.bat.cell_count[{#BAT}]
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Batteries
Port 1: battery {#BAT}: MOSFET temperature
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.18
mirca.p1.bat.mos_temp[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
°C
Batteries
MULTIPLIER
0.1
Port 1: battery {#BAT}: alarm bits
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.19
mirca.p1.bat.alarms[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
UNSIGNED
Batteries
JAVASCRIPT
return (parseInt(value, 10) >>> 0).toString();
Port 1: battery {#BAT}: alarms
DEPENDENT
mirca.p1.bat.alarms.text[{#BAT}]
0
14d
0
CHAR
Batteries
JAVASCRIPT
var names = ['balance wire resistance too high', 'MOSFET overtemperature', 'cell count mismatch', 'current sensor fault', 'cell overvoltage', 'battery overvoltage', 'charge overcurrent', 'charge short circuit', 'charge overtemperature', 'charge undertemperature', 'internal communication fault', 'cell undervoltage', 'battery undervoltage', 'discharge overcurrent', 'discharge short circuit', 'discharge overtemperature', 'charge MOSFET fault', 'discharge MOSFET fault', 'GPS disconnected', 'change authorization password', 'discharge enable failed', 'battery overtemperature', 'temperature sensor fault'];
var v = parseInt(value, 10) >>> 0, out = [];
for (var i = 0; i < 32; i++)
if ((v >>> i) & 1) out.push(i < names.length ? names[i] : 'bit ' + i);
return out.length ? out.join(', ') : 'none';
DISCARD_UNCHANGED_HEARTBEAT
1h
mirca.p1.bat.alarms[{#BAT}]
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.online[{#BAT}].max({$MIRCA.OFFLINE.TIME})}=0
Port 1: battery {#BAT}: no frames on the parallel bus
AVERAGE
The battery stopped answering the bus master for {$MIRCA.OFFLINE.TIME}.
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.soc[{#BAT}].max(5m)}<{$MIRCA.SOC.CRIT:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.online[{#BAT}].last()}=1
Port 1: battery {#BAT}: SOC is critically low (<{$MIRCA.SOC.CRIT:"p1"}%)
HIGH
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.soc[{#BAT}].max(5m)}<{$MIRCA.SOC.WARN:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.online[{#BAT}].last()}=1
Port 1: battery {#BAT}: SOC is low (<{$MIRCA.SOC.WARN:"p1"}%)
WARNING
Port 1: battery {#BAT}: SOC is critically low (<{$MIRCA.SOC.CRIT:"p1"}%)
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.soc[{#BAT}].max(5m)}<{$MIRCA.SOC.CRIT:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.online[{#BAT}].last()}=1
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.mos_temp[{#BAT}].min(5m)}>{$MIRCA.MOS.TEMP.MAX:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.online[{#BAT}].last()}=1
Port 1: battery {#BAT}: MOSFET temperature is high (>{$MIRCA.MOS.TEMP.MAX:"p1"}°C)
AVERAGE
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.alarms[{#BAT}].band(#1,{$MIRCA.JK.ALARM.MASK})}<>0 and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.alarms.text[{#BAT}].strlen()}>0 and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.online[{#BAT}].last()}=1
Port 1: battery {#BAT}: BMS alarm: {ITEM.LASTVALUE2}
AVERAGE
Port 1: battery {#BAT}: voltage and current
0
1A7C11
-
MiRCA Port 1 JK BMS parallel bus
mirca.p1.bat.voltage[{#BAT}]
1
F63100
RIGHT
-
MiRCA Port 1 JK BMS parallel bus
mirca.p1.bat.current[{#BAT}]
Port 1: battery {#BAT}: SOC
0
1A7C11
-
MiRCA Port 1 JK BMS parallel bus
mirca.p1.bat.soc[{#BAT}]
JAVASCRIPT
var rows = JSON.parse(value), out = [];
if (!Array.isArray(rows)) rows = rows.data || [];
for (var i = 0; i < rows.length; i++) {
var m = /^(\d+)\.2$/.exec(rows[i]['{#SNMPINDEX}']);
if (!m) continue;
var o = {'{#BAT}': m[1], '{#ADDR}': String(m[1] - 1)};
out.push(o);
}
return JSON.stringify(out);
Port 1: battery cells discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.1.50]
mirca.p1.bat.cells.discovery
1h
7d
Cells of every battery on the parallel bus
Port 1: battery {#BAT}: cell {#CELL} voltage
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.20.{#CELL}
mirca.p1.bat.cell[{#BAT},{#CELL}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
V
Cells
MULTIPLIER
0.001
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.cell[{#BAT},{#CELL}].max(2m)}<{$MIRCA.CELL.UV:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.cell[{#BAT},{#CELL}].last()}>0
Port 1: battery {#BAT}: cell {#CELL} undervoltage (<{$MIRCA.CELL.UV:"p1"}V)
HIGH
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.cell[{#BAT},{#CELL}].min(2m)}>{$MIRCA.CELL.OV:"p1"}
Port 1: battery {#BAT}: cell {#CELL} overvoltage (>{$MIRCA.CELL.OV:"p1"}V)
HIGH
JAVASCRIPT
var rows = JSON.parse(value), out = [];
if (!Array.isArray(rows)) rows = rows.data || [];
for (var i = 0; i < rows.length; i++) {
var m = /^(\d+)\.20\.(\d+)$/.exec(rows[i]['{#SNMPINDEX}']);
if (!m || rows[i]['{#SNMPVALUE}'] === '0') continue;
var o = {'{#BAT}': m[1], '{#ADDR}': String(m[1] - 1), '{#CELL}': m[2]};
out.push(o);
}
return JSON.stringify(out);
Port 1: battery temperature sensors discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.1.50]
mirca.p1.bat.temps.discovery
1h
7d
Temperature sensors of every battery on the parallel bus (non-zero at discovery time)
Port 1: battery {#BAT}: temperature T{#SENSOR}
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.50.{#BAT}.21.{#SENSOR}
mirca.p1.bat.temp[{#BAT},{#SENSOR}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
°C
Temperature
MULTIPLIER
0.1
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.temp[{#BAT},{#SENSOR}].min(5m)}>{$MIRCA.TEMP.MAX:"p1"}
Port 1: battery {#BAT}: temperature T{#SENSOR} is high (>{$MIRCA.TEMP.MAX:"p1"}°C)
AVERAGE
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.temp[{#BAT},{#SENSOR}].max(5m)}<{$MIRCA.TEMP.MIN:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.bat.temp[{#BAT},{#SENSOR}].last()}<>0
Port 1: battery {#BAT}: temperature T{#SENSOR} is low (<{$MIRCA.TEMP.MIN:"p1"}°C)
WARNING
JAVASCRIPT
var rows = JSON.parse(value), out = [];
if (!Array.isArray(rows)) rows = rows.data || [];
for (var i = 0; i < rows.length; i++) {
var m = /^(\d+)\.21\.(\d+)$/.exec(rows[i]['{#SNMPINDEX}']);
if (!m || rows[i]['{#SNMPVALUE}'] === '0') continue;
var o = {'{#BAT}': m[1], '{#ADDR}': String(m[1] - 1), '{#SENSOR}': m[2]};
out.push(o);
}
return JSON.stringify(out);
{$MIRCA.INTERVAL}
30s
Polling interval of live values
{$MIRCA.INTERVAL.SLOW}
5m
Polling interval of slowly changing values (capacity, cycles, energy counters)
{$MIRCA.OFFLINE.TIME}
5m
How long the device may stay silent before a problem is raised
{$MIRCA.SOC.WARN}
20
SOC below this, %, raises a warning. Per port: {$MIRCA.SOC.WARN:"p1"}
{$MIRCA.SOC.CRIT}
10
SOC below this, %, raises a high problem. Per port: {$MIRCA.SOC.CRIT:"p1"}
{$MIRCA.CELL.UV}
2.9
Cell undervoltage threshold, V (LiFePO4 default). Per port: {$MIRCA.CELL.UV:"p1"}
{$MIRCA.CELL.OV}
3.65
Cell overvoltage threshold, V (LiFePO4 default). Per port: {$MIRCA.CELL.OV:"p1"}
{$MIRCA.TEMP.MAX}
50
Battery temperature sensor high threshold, °C. Per port: {$MIRCA.TEMP.MAX:"p1"}
{$MIRCA.TEMP.MIN}
0
Battery temperature sensor low threshold, °C. Per port: {$MIRCA.TEMP.MIN:"p1"}
{$MIRCA.MOS.TEMP.MAX}
80
MOSFET temperature threshold, °C. Per port: {$MIRCA.MOS.TEMP.MAX:"p1"}
{$MIRCA.JK.ALARM.MASK}
7602175
JK alarm bits that raise a problem (default: bits 0-22 without 18 'GPS disconnected' and 19 'change authorization password')
MiRCA Port 2 JK BMS parallel bus
MiRCA Port 2 JK BMS parallel bus
MiRCA serial port 2 running the 'JK BMS parallel bus' protocol (protocol id 8). SNMP v2c over the Ethernet interface, tree .1.3.6.1.4.1.2021.13.16.4.2.2 (doc/ports.md). Link 'MiRCA Device' too. Listens on the RS485 parallel bus of JK-PB batteries (never transmits). Port values are the group summary; every battery on the bus is discovered (.50.<address+1>). Battery N+1 = bus address N, Battery 1 = master.
Templates/MiRCA
Port 2
Battery
Batteries
Cells
Temperature
-
Port 2: protocol
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.1
mirca.p2.protocol
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Protocol configured on the port
Port 2
MiRCA protocol
-
Port 2: online
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.2
mirca.p2.online
{$MIRCA.INTERVAL}
14d
365d
UNSIGNED
1 while the device answers. All values read 0 while it is offline.
Port 2
MiRCA online
-
Port 2: seconds since last reply
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.3
mirca.p2.age
{$MIRCA.INTERVAL}
14d
365d
FLOAT
s
-1: no reply since boot
Port 2
-
Port 2: voltage
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.10
mirca.p2.voltage
{$MIRCA.INTERVAL}
14d
365d
FLOAT
V
Battery
MULTIPLIER
0.01
-
Port 2: current
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.11
mirca.p2.current
{$MIRCA.INTERVAL}
14d
365d
FLOAT
A
+ charging, - discharging
Battery
MULTIPLIER
0.01
-
Port 2: power
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.12
mirca.p2.power
{$MIRCA.INTERVAL}
14d
365d
FLOAT
W
+ charging, - discharging
Battery
-
Port 2: SOC
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.13
mirca.p2.soc
{$MIRCA.INTERVAL}
14d
365d
FLOAT
%
Battery
MULTIPLIER
0.1
-
Port 2: remaining capacity
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.15
mirca.p2.cap_remain
{$MIRCA.INTERVAL}
14d
365d
FLOAT
Ah
Battery
MULTIPLIER
0.01
-
Port 2: full capacity
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.16
mirca.p2.cap_full
{$MIRCA.INTERVAL.SLOW}
14d
365d
FLOAT
Ah
Battery
MULTIPLIER
0.01
-
Port 2: MOSFET temperature
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.18
mirca.p2.mos_temp
{$MIRCA.INTERVAL}
14d
365d
FLOAT
°C
Battery
MULTIPLIER
0.1
-
Port 2: alarm bits
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.19
mirca.p2.alarms
{$MIRCA.INTERVAL}
14d
365d
UNSIGNED
JK alarm bit mask (register 0xA0), see doc/ports.md
Battery
JAVASCRIPT
return (parseInt(value, 10) >>> 0).toString();
-
Port 2: alarms
DEPENDENT
mirca.p2.alarms.text
0
14d
0
CHAR
Battery
JAVASCRIPT
var names = ['balance wire resistance too high', 'MOSFET overtemperature', 'cell count mismatch', 'current sensor fault', 'cell overvoltage', 'battery overvoltage', 'charge overcurrent', 'charge short circuit', 'charge overtemperature', 'charge undertemperature', 'internal communication fault', 'cell undervoltage', 'battery undervoltage', 'discharge overcurrent', 'discharge short circuit', 'discharge overtemperature', 'charge MOSFET fault', 'discharge MOSFET fault', 'GPS disconnected', 'change authorization password', 'discharge enable failed', 'battery overtemperature', 'temperature sensor fault'];
var v = parseInt(value, 10) >>> 0, out = [];
for (var i = 0; i < 32; i++)
if ((v >>> i) & 1) out.push(i < names.length ? names[i] : 'bit ' + i);
return out.length ? out.join(', ') : 'none';
DISCARD_UNCHANGED_HEARTBEAT
1h
mirca.p2.alarms
Port 2: batteries discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.2.50]
mirca.p2.bat.discovery
10m
7d
Batteries seen on the parallel bus (the firmware registers their OIDs on the first frame)
Port 2: battery {#BAT}: online
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.2
mirca.p2.bat.online[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
UNSIGNED
Batteries
MiRCA online
Port 2: battery {#BAT}: seconds since last frame
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.3
mirca.p2.bat.age[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
s
Batteries
Port 2: battery {#BAT}: voltage
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.10
mirca.p2.bat.voltage[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
V
Batteries
MULTIPLIER
0.01
Port 2: battery {#BAT}: current
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.11
mirca.p2.bat.current[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
A
+ charging
Batteries
MULTIPLIER
0.01
Port 2: battery {#BAT}: power
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.12
mirca.p2.bat.power[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
W
+ charging
Batteries
Port 2: battery {#BAT}: SOC
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.13
mirca.p2.bat.soc[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
%
Batteries
MULTIPLIER
0.1
Port 2: battery {#BAT}: cycles
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.14
mirca.p2.bat.cycles[{#BAT}]
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Batteries
Port 2: battery {#BAT}: remaining capacity
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.15
mirca.p2.bat.cap_remain[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
Ah
Batteries
MULTIPLIER
0.01
Port 2: battery {#BAT}: full capacity
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.16
mirca.p2.bat.cap_full[{#BAT}]
{$MIRCA.INTERVAL.SLOW}
14d
365d
FLOAT
Ah
Batteries
MULTIPLIER
0.01
Port 2: battery {#BAT}: cell count
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.17
mirca.p2.bat.cell_count[{#BAT}]
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Batteries
Port 2: battery {#BAT}: MOSFET temperature
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.18
mirca.p2.bat.mos_temp[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
°C
Batteries
MULTIPLIER
0.1
Port 2: battery {#BAT}: alarm bits
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.19
mirca.p2.bat.alarms[{#BAT}]
{$MIRCA.INTERVAL}
14d
365d
UNSIGNED
Batteries
JAVASCRIPT
return (parseInt(value, 10) >>> 0).toString();
Port 2: battery {#BAT}: alarms
DEPENDENT
mirca.p2.bat.alarms.text[{#BAT}]
0
14d
0
CHAR
Batteries
JAVASCRIPT
var names = ['balance wire resistance too high', 'MOSFET overtemperature', 'cell count mismatch', 'current sensor fault', 'cell overvoltage', 'battery overvoltage', 'charge overcurrent', 'charge short circuit', 'charge overtemperature', 'charge undertemperature', 'internal communication fault', 'cell undervoltage', 'battery undervoltage', 'discharge overcurrent', 'discharge short circuit', 'discharge overtemperature', 'charge MOSFET fault', 'discharge MOSFET fault', 'GPS disconnected', 'change authorization password', 'discharge enable failed', 'battery overtemperature', 'temperature sensor fault'];
var v = parseInt(value, 10) >>> 0, out = [];
for (var i = 0; i < 32; i++)
if ((v >>> i) & 1) out.push(i < names.length ? names[i] : 'bit ' + i);
return out.length ? out.join(', ') : 'none';
DISCARD_UNCHANGED_HEARTBEAT
1h
mirca.p2.bat.alarms[{#BAT}]
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.online[{#BAT}].max({$MIRCA.OFFLINE.TIME})}=0
Port 2: battery {#BAT}: no frames on the parallel bus
AVERAGE
The battery stopped answering the bus master for {$MIRCA.OFFLINE.TIME}.
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.soc[{#BAT}].max(5m)}<{$MIRCA.SOC.CRIT:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.online[{#BAT}].last()}=1
Port 2: battery {#BAT}: SOC is critically low (<{$MIRCA.SOC.CRIT:"p2"}%)
HIGH
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.soc[{#BAT}].max(5m)}<{$MIRCA.SOC.WARN:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.online[{#BAT}].last()}=1
Port 2: battery {#BAT}: SOC is low (<{$MIRCA.SOC.WARN:"p2"}%)
WARNING
Port 2: battery {#BAT}: SOC is critically low (<{$MIRCA.SOC.CRIT:"p2"}%)
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.soc[{#BAT}].max(5m)}<{$MIRCA.SOC.CRIT:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.online[{#BAT}].last()}=1
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.mos_temp[{#BAT}].min(5m)}>{$MIRCA.MOS.TEMP.MAX:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.online[{#BAT}].last()}=1
Port 2: battery {#BAT}: MOSFET temperature is high (>{$MIRCA.MOS.TEMP.MAX:"p2"}°C)
AVERAGE
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.alarms[{#BAT}].band(#1,{$MIRCA.JK.ALARM.MASK})}<>0 and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.alarms.text[{#BAT}].strlen()}>0 and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.online[{#BAT}].last()}=1
Port 2: battery {#BAT}: BMS alarm: {ITEM.LASTVALUE2}
AVERAGE
Port 2: battery {#BAT}: voltage and current
0
1A7C11
-
MiRCA Port 2 JK BMS parallel bus
mirca.p2.bat.voltage[{#BAT}]
1
F63100
RIGHT
-
MiRCA Port 2 JK BMS parallel bus
mirca.p2.bat.current[{#BAT}]
Port 2: battery {#BAT}: SOC
0
1A7C11
-
MiRCA Port 2 JK BMS parallel bus
mirca.p2.bat.soc[{#BAT}]
JAVASCRIPT
var rows = JSON.parse(value), out = [];
if (!Array.isArray(rows)) rows = rows.data || [];
for (var i = 0; i < rows.length; i++) {
var m = /^(\d+)\.2$/.exec(rows[i]['{#SNMPINDEX}']);
if (!m) continue;
var o = {'{#BAT}': m[1], '{#ADDR}': String(m[1] - 1)};
out.push(o);
}
return JSON.stringify(out);
Port 2: battery cells discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.2.50]
mirca.p2.bat.cells.discovery
1h
7d
Cells of every battery on the parallel bus
Port 2: battery {#BAT}: cell {#CELL} voltage
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.20.{#CELL}
mirca.p2.bat.cell[{#BAT},{#CELL}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
V
Cells
MULTIPLIER
0.001
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.cell[{#BAT},{#CELL}].max(2m)}<{$MIRCA.CELL.UV:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.cell[{#BAT},{#CELL}].last()}>0
Port 2: battery {#BAT}: cell {#CELL} undervoltage (<{$MIRCA.CELL.UV:"p2"}V)
HIGH
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.cell[{#BAT},{#CELL}].min(2m)}>{$MIRCA.CELL.OV:"p2"}
Port 2: battery {#BAT}: cell {#CELL} overvoltage (>{$MIRCA.CELL.OV:"p2"}V)
HIGH
JAVASCRIPT
var rows = JSON.parse(value), out = [];
if (!Array.isArray(rows)) rows = rows.data || [];
for (var i = 0; i < rows.length; i++) {
var m = /^(\d+)\.20\.(\d+)$/.exec(rows[i]['{#SNMPINDEX}']);
if (!m || rows[i]['{#SNMPVALUE}'] === '0') continue;
var o = {'{#BAT}': m[1], '{#ADDR}': String(m[1] - 1), '{#CELL}': m[2]};
out.push(o);
}
return JSON.stringify(out);
Port 2: battery temperature sensors discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.2.50]
mirca.p2.bat.temps.discovery
1h
7d
Temperature sensors of every battery on the parallel bus (non-zero at discovery time)
Port 2: battery {#BAT}: temperature T{#SENSOR}
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.50.{#BAT}.21.{#SENSOR}
mirca.p2.bat.temp[{#BAT},{#SENSOR}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
°C
Temperature
MULTIPLIER
0.1
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.temp[{#BAT},{#SENSOR}].min(5m)}>{$MIRCA.TEMP.MAX:"p2"}
Port 2: battery {#BAT}: temperature T{#SENSOR} is high (>{$MIRCA.TEMP.MAX:"p2"}°C)
AVERAGE
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.temp[{#BAT},{#SENSOR}].max(5m)}<{$MIRCA.TEMP.MIN:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.bat.temp[{#BAT},{#SENSOR}].last()}<>0
Port 2: battery {#BAT}: temperature T{#SENSOR} is low (<{$MIRCA.TEMP.MIN:"p2"}°C)
WARNING
JAVASCRIPT
var rows = JSON.parse(value), out = [];
if (!Array.isArray(rows)) rows = rows.data || [];
for (var i = 0; i < rows.length; i++) {
var m = /^(\d+)\.21\.(\d+)$/.exec(rows[i]['{#SNMPINDEX}']);
if (!m || rows[i]['{#SNMPVALUE}'] === '0') continue;
var o = {'{#BAT}': m[1], '{#ADDR}': String(m[1] - 1), '{#SENSOR}': m[2]};
out.push(o);
}
return JSON.stringify(out);
{$MIRCA.INTERVAL}
30s
Polling interval of live values
{$MIRCA.INTERVAL.SLOW}
5m
Polling interval of slowly changing values (capacity, cycles, energy counters)
{$MIRCA.OFFLINE.TIME}
5m
How long the device may stay silent before a problem is raised
{$MIRCA.SOC.WARN}
20
SOC below this, %, raises a warning. Per port: {$MIRCA.SOC.WARN:"p1"}
{$MIRCA.SOC.CRIT}
10
SOC below this, %, raises a high problem. Per port: {$MIRCA.SOC.CRIT:"p1"}
{$MIRCA.CELL.UV}
2.9
Cell undervoltage threshold, V (LiFePO4 default). Per port: {$MIRCA.CELL.UV:"p1"}
{$MIRCA.CELL.OV}
3.65
Cell overvoltage threshold, V (LiFePO4 default). Per port: {$MIRCA.CELL.OV:"p1"}
{$MIRCA.TEMP.MAX}
50
Battery temperature sensor high threshold, °C. Per port: {$MIRCA.TEMP.MAX:"p1"}
{$MIRCA.TEMP.MIN}
0
Battery temperature sensor low threshold, °C. Per port: {$MIRCA.TEMP.MIN:"p1"}
{$MIRCA.MOS.TEMP.MAX}
80
MOSFET temperature threshold, °C. Per port: {$MIRCA.MOS.TEMP.MAX:"p1"}
{$MIRCA.JK.ALARM.MASK}
7602175
JK alarm bits that raise a problem (default: bits 0-22 without 18 'GPS disconnected' and 19 'change authorization password')
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.protocol.last()}<>8
Port 1: protocol is not JK BMS parallel bus (template does not match port settings)
WARNING
The port runs protocol {ITEM.LASTVALUE}. Change the port settings or link another template.
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.online.max({$MIRCA.OFFLINE.TIME})}=0 and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.protocol.last()}=8
Port 1: JK BMS parallel bus not responding
AVERAGE
No valid reply from the device for {$MIRCA.OFFLINE.TIME}. Check wiring, interface module, baud rate and device address.
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.soc.max(5m)}<{$MIRCA.SOC.CRIT:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.online.last()}=1
Port 1: battery SOC is critically low (<{$MIRCA.SOC.CRIT:"p1"}%)
HIGH
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.soc.max(5m)}<{$MIRCA.SOC.WARN:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.online.last()}=1
Port 1: battery SOC is low (<{$MIRCA.SOC.WARN:"p1"}%)
WARNING
Port 1: battery SOC is critically low (<{$MIRCA.SOC.CRIT:"p1"}%)
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.soc.max(5m)}<{$MIRCA.SOC.CRIT:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.online.last()}=1
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.mos_temp.min(5m)}>{$MIRCA.MOS.TEMP.MAX:"p1"} and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.online.last()}=1
Port 1: MOSFET temperature is high (>{$MIRCA.MOS.TEMP.MAX:"p1"}°C)
AVERAGE
{MiRCA Port 1 JK BMS parallel bus:mirca.p1.alarms.band(#1,{$MIRCA.JK.ALARM.MASK})}<>0 and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.alarms.text.strlen()}>0 and {MiRCA Port 1 JK BMS parallel bus:mirca.p1.online.last()}=1
Port 1: BMS alarm: {ITEM.LASTVALUE2}
AVERAGE
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.protocol.last()}<>8
Port 2: protocol is not JK BMS parallel bus (template does not match port settings)
WARNING
The port runs protocol {ITEM.LASTVALUE}. Change the port settings or link another template.
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.online.max({$MIRCA.OFFLINE.TIME})}=0 and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.protocol.last()}=8
Port 2: JK BMS parallel bus not responding
AVERAGE
No valid reply from the device for {$MIRCA.OFFLINE.TIME}. Check wiring, interface module, baud rate and device address.
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.soc.max(5m)}<{$MIRCA.SOC.CRIT:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.online.last()}=1
Port 2: battery SOC is critically low (<{$MIRCA.SOC.CRIT:"p2"}%)
HIGH
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.soc.max(5m)}<{$MIRCA.SOC.WARN:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.online.last()}=1
Port 2: battery SOC is low (<{$MIRCA.SOC.WARN:"p2"}%)
WARNING
Port 2: battery SOC is critically low (<{$MIRCA.SOC.CRIT:"p2"}%)
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.soc.max(5m)}<{$MIRCA.SOC.CRIT:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.online.last()}=1
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.mos_temp.min(5m)}>{$MIRCA.MOS.TEMP.MAX:"p2"} and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.online.last()}=1
Port 2: MOSFET temperature is high (>{$MIRCA.MOS.TEMP.MAX:"p2"}°C)
AVERAGE
{MiRCA Port 2 JK BMS parallel bus:mirca.p2.alarms.band(#1,{$MIRCA.JK.ALARM.MASK})}<>0 and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.alarms.text.strlen()}>0 and {MiRCA Port 2 JK BMS parallel bus:mirca.p2.online.last()}=1
Port 2: BMS alarm: {ITEM.LASTVALUE2}
AVERAGE
Port 1: voltage and current
0
1A7C11
-
MiRCA Port 1 JK BMS parallel bus
mirca.p1.voltage
1
F63100
RIGHT
-
MiRCA Port 1 JK BMS parallel bus
mirca.p1.current
Port 1: SOC
0
1A7C11
-
MiRCA Port 1 JK BMS parallel bus
mirca.p1.soc
Port 1: power
0
1A7C11
-
MiRCA Port 1 JK BMS parallel bus
mirca.p1.power
Port 2: voltage and current
0
1A7C11
-
MiRCA Port 2 JK BMS parallel bus
mirca.p2.voltage
1
F63100
RIGHT
-
MiRCA Port 2 JK BMS parallel bus
mirca.p2.current
Port 2: SOC
0
1A7C11
-
MiRCA Port 2 JK BMS parallel bus
mirca.p2.soc
Port 2: power
0
1A7C11
-
MiRCA Port 2 JK BMS parallel bus
mirca.p2.power
MiRCA online
0
Offline
1
Online
MiRCA protocol
0
Off
1
Victron VE.Bus
2
JK BMS 4G-GPS
3
PACE BMS
4
JBD BMS
5
JK BMS Modbus
6
Deye inverter Modbus
7
Serial capture
8
JK BMS parallel bus