5.2
2026-10-07T00:00:00Z
Templates/MiRCA
MiRCA Port 1 JK BMS 4G-GPS
MiRCA Port 1 JK BMS 4G-GPS
MiRCA serial port 1 running the 'JK BMS 4G-GPS' protocol (protocol id 2). 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. JK BMS over the 4G-GPS protocol (000).
Templates/MiRCA
Port 1
Battery
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: 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: cycles
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.14
mirca.p1.cycles
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Battery
-
Port 1: cell count
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.17
mirca.p1.cell_count
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Battery
-
Port 1: power (calculated)
CALCULATED
mirca.p1.power.calc
{$MIRCA.INTERVAL}
14d
365d
FLOAT
W
last(mirca.p1.voltage)*last(mirca.p1.current)
Voltage x current; the protocol does not report power. + charging
Battery
Port 1: cells discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.1.20]
mirca.p1.cells.discovery
1h
AND
{#SNMPVALUE}
^[1-9]
A
7d
Cells the BMS reports (cell voltage > 0 at discovery time)
Port 1: cell {#SNMPINDEX} voltage
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.20.{#SNMPINDEX}
mirca.p1.cell[{#SNMPINDEX}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
V
Cells
MULTIPLIER
0.001
{MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.cell[{#SNMPINDEX}].max(2m)}<{$MIRCA.CELL.UV:"p1"} and {MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.online.last()}=1
Port 1: cell {#SNMPINDEX} undervoltage (<{$MIRCA.CELL.UV:"p1"}V)
HIGH
{MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.cell[{#SNMPINDEX}].min(2m)}>{$MIRCA.CELL.OV:"p1"} and {MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.online.last()}=1
Port 1: cell {#SNMPINDEX} overvoltage (>{$MIRCA.CELL.OV:"p1"}V)
HIGH
Port 1: temperature sensors discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.1.21]
mirca.p1.temps.discovery
1h
AND
{#SNMPVALUE}
^-?[1-9]
A
7d
Temperature sensors the BMS reports (non-zero at discovery time)
Port 1: temperature T{#SNMPINDEX}
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.1.21.{#SNMPINDEX}
mirca.p1.temp[{#SNMPINDEX}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
°C
Temperature
MULTIPLIER
0.1
{MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.temp[{#SNMPINDEX}].min(5m)}>{$MIRCA.TEMP.MAX:"p1"} and {MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.online.last()}=1
Port 1: temperature T{#SNMPINDEX} is high (>{$MIRCA.TEMP.MAX:"p1"}°C)
AVERAGE
{MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.temp[{#SNMPINDEX}].max(5m)}<{$MIRCA.TEMP.MIN:"p1"} and {MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.online.last()}=1
Port 1: temperature T{#SNMPINDEX} is low (<{$MIRCA.TEMP.MIN:"p1"}°C)
WARNING
{$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 Port 2 JK BMS 4G-GPS
MiRCA Port 2 JK BMS 4G-GPS
MiRCA serial port 2 running the 'JK BMS 4G-GPS' protocol (protocol id 2). 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. JK BMS over the 4G-GPS protocol (000).
Templates/MiRCA
Port 2
Battery
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: 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: cycles
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.14
mirca.p2.cycles
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Battery
-
Port 2: cell count
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.17
mirca.p2.cell_count
{$MIRCA.INTERVAL.SLOW}
14d
365d
UNSIGNED
Battery
-
Port 2: power (calculated)
CALCULATED
mirca.p2.power.calc
{$MIRCA.INTERVAL}
14d
365d
FLOAT
W
last(mirca.p2.voltage)*last(mirca.p2.current)
Voltage x current; the protocol does not report power. + charging
Battery
Port 2: cells discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.2.20]
mirca.p2.cells.discovery
1h
AND
{#SNMPVALUE}
^[1-9]
A
7d
Cells the BMS reports (cell voltage > 0 at discovery time)
Port 2: cell {#SNMPINDEX} voltage
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.20.{#SNMPINDEX}
mirca.p2.cell[{#SNMPINDEX}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
V
Cells
MULTIPLIER
0.001
{MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.cell[{#SNMPINDEX}].max(2m)}<{$MIRCA.CELL.UV:"p2"} and {MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.online.last()}=1
Port 2: cell {#SNMPINDEX} undervoltage (<{$MIRCA.CELL.UV:"p2"}V)
HIGH
{MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.cell[{#SNMPINDEX}].min(2m)}>{$MIRCA.CELL.OV:"p2"} and {MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.online.last()}=1
Port 2: cell {#SNMPINDEX} overvoltage (>{$MIRCA.CELL.OV:"p2"}V)
HIGH
Port 2: temperature sensors discovery
SNMP_AGENT
discovery[{#SNMPVALUE},1.3.6.1.4.1.2021.13.16.4.2.2.21]
mirca.p2.temps.discovery
1h
AND
{#SNMPVALUE}
^-?[1-9]
A
7d
Temperature sensors the BMS reports (non-zero at discovery time)
Port 2: temperature T{#SNMPINDEX}
SNMP_AGENT
1.3.6.1.4.1.2021.13.16.4.2.2.21.{#SNMPINDEX}
mirca.p2.temp[{#SNMPINDEX}]
{$MIRCA.INTERVAL}
14d
365d
FLOAT
°C
Temperature
MULTIPLIER
0.1
{MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.temp[{#SNMPINDEX}].min(5m)}>{$MIRCA.TEMP.MAX:"p2"} and {MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.online.last()}=1
Port 2: temperature T{#SNMPINDEX} is high (>{$MIRCA.TEMP.MAX:"p2"}°C)
AVERAGE
{MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.temp[{#SNMPINDEX}].max(5m)}<{$MIRCA.TEMP.MIN:"p2"} and {MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.online.last()}=1
Port 2: temperature T{#SNMPINDEX} is low (<{$MIRCA.TEMP.MIN:"p2"}°C)
WARNING
{$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 Port 1 JK BMS 4G-GPS:mirca.p1.protocol.last()}<>2
Port 1: protocol is not JK BMS 4G-GPS (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 4G-GPS:mirca.p1.online.max({$MIRCA.OFFLINE.TIME})}=0 and {MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.protocol.last()}=2
Port 1: JK BMS 4G-GPS 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 4G-GPS:mirca.p1.soc.max(5m)}<{$MIRCA.SOC.CRIT:"p1"} and {MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.online.last()}=1
Port 1: battery SOC is critically low (<{$MIRCA.SOC.CRIT:"p1"}%)
HIGH
{MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.soc.max(5m)}<{$MIRCA.SOC.WARN:"p1"} and {MiRCA Port 1 JK BMS 4G-GPS: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 4G-GPS:mirca.p1.soc.max(5m)}<{$MIRCA.SOC.CRIT:"p1"} and {MiRCA Port 1 JK BMS 4G-GPS:mirca.p1.online.last()}=1
{MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.protocol.last()}<>2
Port 2: protocol is not JK BMS 4G-GPS (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 4G-GPS:mirca.p2.online.max({$MIRCA.OFFLINE.TIME})}=0 and {MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.protocol.last()}=2
Port 2: JK BMS 4G-GPS 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 4G-GPS:mirca.p2.soc.max(5m)}<{$MIRCA.SOC.CRIT:"p2"} and {MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.online.last()}=1
Port 2: battery SOC is critically low (<{$MIRCA.SOC.CRIT:"p2"}%)
HIGH
{MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.soc.max(5m)}<{$MIRCA.SOC.WARN:"p2"} and {MiRCA Port 2 JK BMS 4G-GPS: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 4G-GPS:mirca.p2.soc.max(5m)}<{$MIRCA.SOC.CRIT:"p2"} and {MiRCA Port 2 JK BMS 4G-GPS:mirca.p2.online.last()}=1
Port 1: voltage and current
0
1A7C11
-
MiRCA Port 1 JK BMS 4G-GPS
mirca.p1.voltage
1
F63100
RIGHT
-
MiRCA Port 1 JK BMS 4G-GPS
mirca.p1.current
Port 1: SOC
0
1A7C11
-
MiRCA Port 1 JK BMS 4G-GPS
mirca.p1.soc
Port 1: power
0
1A7C11
-
MiRCA Port 1 JK BMS 4G-GPS
mirca.p1.power.calc
Port 2: voltage and current
0
1A7C11
-
MiRCA Port 2 JK BMS 4G-GPS
mirca.p2.voltage
1
F63100
RIGHT
-
MiRCA Port 2 JK BMS 4G-GPS
mirca.p2.current
Port 2: SOC
0
1A7C11
-
MiRCA Port 2 JK BMS 4G-GPS
mirca.p2.soc
Port 2: power
0
1A7C11
-
MiRCA Port 2 JK BMS 4G-GPS
mirca.p2.power.calc
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