Skip to Content

Wiki source code of 3.2 Inputs and outputs

Version 18.3 by Admin on 2025/06/18 15:31
Hide last authors
Admin 3.2 1 (% data-numbered-headings-start="3" style="--numbered-headings-start: 2;font-size: 0px;color: rgba(0, 0, 0, 0.0);margin-bottom: 0px; margin-top: 0px;" %)
Admin 4.1 2 = Configuration =
Admin 1.1 3
Admin 3.2 4 (% data-numbered-headings-start="2" style="--numbered-headings-start: 1;font-size: 0px;color: rgba(0, 0, 0, 0.0);margin-bottom: 0px; margin-top: 0px;" %)
5 == Inputs and outputs ==
Admin 3.1 6
7 === ​​​​​​Discrete inputs ===
8
Admin 1.1 9 The BMS Main 3 device has 6 discrete inputs that detect signal line closing to the virtual ground, and 2 inputs that detect 9-32V input voltage. For each discrete input, its assignment and inversion flag are set.
10
11 Also, BMS has two additional configurable inputs named “KEYRUN” and “CHARGE_ON”, each serves 9-32V input voltage. Those inputs serve as power buttons with additional functions that can be set.
12
13 Assignments of discrete inputs are configured in the "Signals → Input discrete signals → Assignments" section:
14
Admin 6.3 15 [[image:1735053944168-184.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="236" width="800"]]
Admin 1.1 16
Admin 17.1 17 (% class="box infomessage" %)
18 (((
19 A list of available **discrete input** assignments is available in [[Input signals>>doc:Battery management systems.Additional information.1\. Battery controllers\: signals and errors.WebHome||anchor="HInputsignals"]].
20 )))
Admin 1.1 21
22 Inversion flags for discrete inputs are configured in the "Signals → Input discrete signals → Inversion" section:
23
Admin 6.3 24 [[image:1735054242278-319.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="207" width="800"]]
Admin 1.1 25
26 The behavior of “KEYRUN” signal can be configured in the "Signals → Input discrete signals → KEYRUN mode" section:
27
28 [[image:1733320685772-445.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="112" width="800"]]
29
30 The behavior of “CHARGE_ON” signal can be configured in the "Signals → Input discrete signals → CHARGE_ON mode" section:
31
32 [[image:1733320685772-786.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="111" width="800"]]
33
34 In both “KEYRUN mode” and “CHARGE_ON mode“ sections:
35
36 * Do nothing – power on device and do nothing;
37 * Set “Discharge request” – power on device and set “Discharge request” signal immediately;
38 * Set “Charge request” – power on device and set “Charge request” signal immediately.
39
Admin 3.1 40 === Current sensor ===
Admin 1.1 41
42 The BMS Main 3 device has an ability to measure battery current by 3 external Hall-Effect current sensors.
43
44 Current sensor settings are configured in the "Signals → Current sensor" section:
45
Admin 7.2 46 [[image:1735054422436-925.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="391" width="800"]]
Admin 1.1 47
48 The device supports the following current sensor settings:
49
50 * Connection – type of multiple sensors connection
51 ** One sensor (#1) – only first sensor is used to measure the battery current;
52 ** Two sensors (#1 and #2) in parallel – sensors are connected in parallel (the total battery current equals the sum of two sensors);
53 ** Two sensors (#1 and #2) in different branches – sensors located in two halves of the battery (used in batteries with a middle point);
54 * Sensor 2, 3: Enable – a flag to enable the second of third current sensor;
55 * Sensor 1, 2, 3: Nominal current – rated current I,,nom,, of the sensor according to the datasheet, А;
56 * Sensor 1, 2, 3: Sensitivity – sensitivity of the current sensor according to the datasheet, V / I,,nom.,,;
57 * Sensor 1, 2, 3: Invert – invert the sign of the measured value;
58 * Sensor 1, 2, 3: Multiply charging current (experimental) – an experimental flag for scaling the charging current by given multiplier;
59 * Sensor 1, 2, 3: Multiplier for charging current – charging current multiplier;
60 * Sensor 1, 2, 3: REF_IN2 mode – mode of additional analog line:
61 ** Not connected;
62 ** Reference line – reference output of the sensor;
63 ** Low range (for the dual range sensor) - a second output of a dual-range sensor (for example, LEM DHAB series);
64 * Sensor 1, 2, 3: Low range nominal current - rated current I,,nom,, of the low current line of dual range sensor according to the datasheet, А;
65 * Sensor 1, 2, 3: Low range sensitivity – sensitivity of the low current line of dual range sensor according to the datasheet, V / I,,nominal.,,;
66 * Sensor 1, 2, 3: Threshold for low range – a threshold current value at which the device uses the readings of the high current sensor instead of low current, A;
67 * Calibrate – a flag to calibrate (find a 0A point) the current sensor when the device is started;
68 * Calibration time – calibration time of the current sensor, millisecond;
69 * Recalibrate current sensor – a command to calibrate the current sensor manually.
70
Admin 3.1 71 === Shunt sensor (CAN bus) ===
Admin 1.1 72
73 The BMS Main 3 device has an ability to measure battery current via a shunt sensor, connected to the CAN bus.
74
75 (% class="box infomessage" %)
76 (((
77 **Note: **The shunt sensor communication protocol can be provided by request.
78 )))
79
80 Shunt sensor settings are configured in the "Signals → Shunt sensor (CAN bus)" section:
81
82 [[image:1733320685776-802.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="108" width="800"]]
83
84 The device supports the following shunt sensor settings:
85
86 * Enable – a flag to start interaction with the BMS Current Sensor (if interaction is enabled, then BMS doesn’t use Hall-Effect current sensor which settings are described in the section "Signals → Current sensor");
87 * Node ID – an address of BMS Current Sensor in the CANopen network;
88 * Invert – a flag to invert current measurements;
89 * Receive timeout – a timeout for receiving messages from the BMS Current Sensor (if no data is being received from the current sensor during this time, the “Shunt offline” flag is set), millisecond;
90 * Mean value threshold – T,,M,, level, A (if module of instantaneous current (I,,I,,) which is received from the shunt sensor is between T,,M,, and T,,0,,, the BMS will use mean value of current I,,M,,; if I,,I,, is greater than T,,M,,, the BMS will use instantaneous value of current I,,I,,);
91 * Zero threshold – T,,0,, level, A (if module of instantaneous current (I,,I,,) which is received from the shunt sensor is lower than T,,0,,, the BMS will assume that current flowing through the battery is zero);
92
Admin 3.1 93 === Temperature sensors ===
Admin 1.1 94
95 Temperature sensors settings are configured in the "Signals → Temperature sensors" section:
96
97 [[image:1733320685777-354.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="97" width="800"]]
98
99 In this section:
100
Admin 18.2 101 * Type of cell temperature sensors – a type of temperature sensors connected to BMS Logic devices and used to measure cells temperature;
Admin 18.3 102 * Unused cell temperature sensors – a bitfield to select unused temperature sensors on each BMS Logic;ры на каждом BMS Logic;
Admin 18.2 103 * Type of temperature sensors 1 and 2 – тип температурных датчиков, подключенных к BMS Main 3.
104 *
Admin 1.1 105 * Type – a type of temperature sensors.
106
Admin 3.1 107 === Output discrete signals ===
Admin 1.1 108
109 The BMS Main 3 device has 4 open drain type outputs. For each discrete output, its assignment and inversion flag are set.
110
111 Assignments of discrete outputs are configured in the "Signals → Output discrete signals → Assignments" section:
112
Admin 8.2 113 [[image:1735054536275-447.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="148" width="800"]]
Admin 1.1 114
Admin 17.1 115 (% class="box infomessage" %)
116 (((
117 A list of available **discrete output** assignments is available in [[Internal signals>>doc:Battery management systems.Additional information.1\. Battery controllers\: signals and errors.WebHome||anchor="HInternalsignals"]].
118 )))
Admin 1.1 119
120 Inversion flags for discrete outputs are configured in the "Signals → Output discrete signals → Inversion" section:
121
Admin 9.2 122 [[image:1735054654975-772.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="124" width="800"]]
Admin 1.1 123
Admin 3.1 124 === Power switches ===
Admin 1.1 125
126 The BMS Main 3 device has 6 power switches to drive contactors. For each switch, its assignment and inversion flag are set.
127
128 Assignments of power switches are configured in the "Signals → Power switches → Assignments" section:
129
Admin 11.2 130 [[image:1735054694689-808.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="167" width="800"]]
Admin 1.1 131
Admin 17.1 132 (% class="box infomessage" %)
133 (((
134 A list of available **switch **assignments is available in [[Internal signals>>doc:Battery management systems.Additional information.1\. Battery controllers\: signals and errors.WebHome||anchor="HInternalsignals"]].
135 )))
Admin 1.1 136
137 Inversion flags for switches are configured in the “Signals → Power switches → Inversion” section:
138
Admin 12.1 139 [[image:1735054793459-953.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="149" width="800"]]
Admin 2.1 140
141