Skip to Content

Wiki source code of 3.5 External equipment

Version 2.2 by Admin on 2025/02/26 14:32
Hide last authors
Admin 1.1 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;" %)
2 = Settings =
3
4 (% data-numbered-headings-start="5" style="--numbered-headings-start: 4;font-size: 0px;color: rgba(0, 0, 0, 0.0);margin-bottom: 0px; margin-top: 0px;" %)
5 == External equipment ==
6
7 The BMS Mini device supports joint operation with chargers, inverters, vehicle controllers and the BMS Main X board.
8
9 === J1939 charger ===
10
11 To change the parameters of communication with a charger using J1939 protocol, select the "External equipment → Chargers → J1939 charger" section:
12
13 [[image:1733753304337-511.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="191" width="800"]]
14
15 In this section:
16
17 * Enable – a flag to enable communication with the charger;
18 * Receive timeout – a timeout for receiving packets from the charger (if there is no data being received from the charger for a given time, the connection loss flag is set), millisecond;
19 * Output period – a period of sending commands to the charger, millisecond;
20 * Charge voltage – maximum charging voltage, V;
21 * Charge current – maximum charging current, А;
22 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established;
23 * OSN Power compliance – a flag to enable compatibility mode with chargers by OSN Power;
24 * OSN Power: Protocol – choose the OSN Power protocol version;
25 ** V0;
26 ** V1;
27 * OSN Power: Battery type – a type of the for OSN Power battery:
28 ** 48V
29 ** 80V
30 ** 24V
31 ** 220V
32 * OSN Power: Charging mode:
33 ** Constant current;
34 ** Constant voltage;
35 * CCS2 compliance – a flag to enable compatibility mode with the new generation of stationary chargers;
36 * CCS2: Discharging current – maximum discharging current, A;
37 * Great Power compliance – a flag to enable compatibility mode with the Great Power chargers.
38
39 Algorithm for working with the charger:
40
Admin 2.1 41 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see [[Charge>>doc:Battery management systems.BMS Mini S.3\. Configuration.3\.3 Control.WebHome||anchor="HCharge"]]).
Admin 1.1 42
43 === Eltek charger ===
44
45 To change the communication parameters with an Eltek charger, select the "External equipment → Chargers → Eltek charger" section:
46
47 [[image:1733753304340-362.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="125" width="800"]]
48
49 In this section:
50
51 * Enable – a flag to enable communication with the charger;
52 * Charger address – the charger’s network address;
53 * Receive timeout – a timeout for receiving packets from the charger (if no data is being received from the charger during this time, the connection loss flag is set), millisecond;
54 * Output period – a period of sending commands to the charger, millisecond;
55 * Charge voltage – maximum charging voltage, V;
56 * Charge current – maximum charging current, А;
57 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established;
58
59 Algorithm for working with the charger:
60
61 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see section “Control → Charge”).
62
63 === MicroPower charger ===
64
65 To change the parameters of communication with a MicroPower charger, select the "External equipment → Chargers → MicroPower charger" section:
66
67 [[image:1733753304341-156.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="146" width="800"]]
68
69 In this section:
70
71 * Enable – a flag to enable communication with the charger;
72 * Node ID – charger identifier in the CANopen network;
73 * Receive timeout – a timeout for receiving packets from the charger (if there is no data being received from the charger for a given time, the connection loss flag is set), millisecond;
74 * Charge voltage – maximum charging voltage, V;
75 * Charge current – maximum charging current, A;
76 * Charge power – maximum charging power, W;
77 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established.
78 * Use SDO communication – a flag to enable SDO communication with the charger;
79 * SDO timeout – a timeout for receiving SDO packets, milliseconds.
80
81 Algorithm for working with the charger:
82
Admin 2.1 83 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see [[Charge>>doc:Battery management systems.BMS Mini S.3\. Configuration.3\.3 Control.WebHome||anchor="HCharge"]]).
Admin 1.1 84
85 (% class="box warningmessage" %)
86 (((
87 **Warning! **To work properly with the charger, it is necessary to turn on sending synchronization messages over the CANopen network (see section CAN).
88 )))
89
90 (% class="box infomessage" %)
91 (((
92 After changing the settings, restart the BMS Mini device.
93 )))
94
95 === S.P.E. charger ===
96
97 To change the parameters of communication with an S.P.E. charger, select the "External equipment → Chargers → SPE charger" section:
98
99 [[image:1733753316196-902.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="113" width="800"]]
100
101 In this section:
102
103 * Enable – a flag to enable communication with the charger;
104 * Control ID – a control message identifier setting the charging current;
105 * Receive timeout – a timeout for receiving packets from the charger (if there is no data being received from the charger for a given time, the connection loss flag is set), millisecond;
106 * Output period - a period of sending commands to the charger, millisecond;
107 * Charge current – maximum charging current, A;
108 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established.
109
110 Algorithm for working with the charger:
111
Admin 2.1 112 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see [[Charge>>doc:Battery management systems.BMS Mini S.3\. Configuration.3\.3 Control.WebHome||anchor="HCharge"]]).
Admin 1.1 113
114 === Bassi charger ===
115
116 To change the parameters of communication with a Bassi charger, select the "External equipment → Chargers → Bassi charger" section:
117
118 [[image:1733753316198-931.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="126" width="800"]]
119
120 In this section:
121
122 * Enable – a flag to enable communication with the charger;
123 * Node ID – BMS identifier in the CANopen network;
124 * Charger ID – charger identifier in the CANopen network;
125 * Receive timeout – a timeout for receiving packets from the charger (if there is no data being received from the charger for a given time, the connection loss flag is set), millisecond;
126 * Charge voltage – maximum charging voltage, V;
127 * Charge current – maximum charging current, A;
128 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established.
129
130 Algorithm for working with the charger:
131
132 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see section Control → Charge).
133
134 (% class="box infomessage" %)
135 (((
136 After changing the settings, restart the BMS Mini device.
137 )))
138
139 === ATIB charger ===
140
141 To change the parameters of communication with an ATIB Elettronica charger, select the "External equipment → Chargers → ATIB Elettronica charger" section:
142
143 [[image:1733753316199-628.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="125" width="800"]]
144
145 In this section:
146
147 * Enable – a flag to enable communication with the charger;
148 * Receive timeout – a timeout for receiving packets from the charger (if there is no data being received from the charger for a given time, the connection loss flag is set), millisecond;
149 * Output period - a period of sending commands to the charger, millisecond;
150 * Charging voltage – maximum charging voltage, V;
151 * Charging current – maximum charging current, A;
152 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established.
153
154 Algorithm for working with the charger:
155
Admin 2.1 156 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see [[Charge>>doc:Battery management systems.BMS Mini S.3\. Configuration.3\.3 Control.WebHome||anchor="HCharge"]]).
Admin 1.1 157
158 (% class="box infomessage" %)
159 (((
160 After changing the settings, restart the BMS Mini device.
161 )))
162
163 === Fronius charger ===
164
165 To change the parameters of communication with a Fronius charger, select the "External equipment → Chargers → Fronius charger" section:
166
167 [[image:1733753316201-310.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="138" width="800"]]
168
169 In this section:
170
171 * Enable – a flag to enable communication with the charger;
172 * BMS ID – a BMS identifier in the CANopen network;
173 * Charger ID – an Fronius charger identifier in the CANopen network;
174 * Charge voltage – maximum charging voltage, V;
175 * Charge current – maximum charging current, A;
176 * Nominal voltage – nominal battery voltage, V;
177 * Nominal capacity – nominal battery capacity, A;
178 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established.
179
180 Algorithm for working with the charger:
181
Admin 2.1 182 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see [[Charge>>doc:Battery management systems.BMS Mini S.3\. Configuration.3\.3 Control.WebHome||anchor="HCharge"]]).
Admin 1.1 183
184 (% class="box infomessage" %)
185 (((
186 After changing the settings, restart the BMS Mini device.
187 )))
188
Admin 2.2 189 === Webasto charger ===
190
191 To change the parameters of communication with a Webasto charger, select the "External equipment → Chargers → Webasto charger" section:
192
193 [[image:1733753316202-874.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="114" width="800"]]
194
195 In this section:
196
197 * Enable – a flag to enable communication with the charger;
198 * Charger ID – a Webasto charger identifier in the CANopen network;
199 * Charge voltage – maximum charging voltage, V;
200 * Charge current – maximum charging current, A;
201 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established.
202
203 Algorithm for working with the charger:
204
205 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see [[Charge>>doc:Battery management systems.BMS Mini S.3\. Configuration.3\.3 Control.WebHome||anchor="HCharge"]]).
206
207 (% class="box infomessage" %)
208 (((
209 After changing the settings, restart the BMS Mini device.
210 )))
211
212 === Skytronic charger ===
213
214 To change the parameters of communication with a Skytronic charger, select the "External equipment → Chargers → Skytronic charger" section:
215
216 [[image:1733753316203-976.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="103" width="800"]]
217
218 In this section:
219
220 * Enable – a flag to enable communication with the charger;
221 * Receive timeout – a timeout for receiving packets from the charger (if there is no data being received from the charger for a given time, the connection loss flag is set), millisecond;
222 * Charge voltage – maximum charging voltage, V;
223 * Charge current – maximum charging current, A;
224 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established.
225
226 Algorithm for working with the charger:
227
228 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see [[Charge>>doc:Battery management systems.BMS Mini S.3\. Configuration.3\.3 Control.WebHome||anchor="HCharge"]]).
229
230 (% class="box infomessage" %)
231 (((
232 After changing the settings, restart the BMS Mini device.
233 )))
234
Admin 1.1 235 === Sunny Island inverter ===
236
237 To change the communication parameters with an SMA Sunny Island inverter, select the "External equipment → inverters → SMA Sunny Island inverter" section:
238
239 [[image:1733753328053-956.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="136" width="800"]]
240
241 In this section:
242
243 * Enable – a flag to enable communication with the inverter;
244 * Receive timeout – a timeout for receiving packets from the inverter (if no data is being received from the inverter during this time, the connection loss flag is set), millisecond;
245 * Output period – a period of sending commands to the inverter, millisecond;
246 * Charge voltage, V – maximum charging voltage, V;
247 * Charge current, А – maximum charging current, A;
248 * Discharge voltage (min) – minimum discharging voltage, V;
249 * Discharge current – maximum discharging current, А;
250 * Invert current – a flag to inverse current sent to the inverter;
251
252 When working with the Sunny Island inverter, the BMS Mini device sends messages with the values of voltage and charge/discharge current continuously with the period “Output period”: Charging voltage, Charging current, Discharging voltage, Discharging current.
253
254 === HYG Class I-III truck ===
255
256 The HYG Class I-III equipment is installed on the forklifts by the group of companies HYSTER-YALE.
257
258 To change communication parameters with HYG Class I-III equipment, select the "External equipment → Trucks and Vehicles → HYG Class I-III truck" section:
259
260 [[image:1733753328054-298.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="236" width="800"]]
261
262 In this section:
263
264 * Enable – a flag to enable communication with the forklift;
265 * Class – a class of equipment:
266 ** I;
267 ** II-III;
268 ** I-III Gen.2;
269 * Node ID – an equipment identifier in the CANopen network;
270 * Receive timeout – a timeout for receiving packets from the forklift (if no data is being received from the forklift during this time, the “HYG offline“ flag is set), millisecond; at a value of 0 milliseconds, the "HYG offline" error does not occur;
271 * Inhibit charging on the "HYG offline" error – a flag to forbid charging if the "HYG offline" error is generated;
272 * Inhibit discharging on the "HYG offline" error – a flag to forbid discharging if the "HYG offline" error is generated;
273 * Inhibit discharging on the “Charger connected” signal and the "HYG offline" error – a flag to forbid discharging if the “Charger connected” signal presents and "HYG offline" error is generated;
274 * Maximum voltage, V;
275 * Minimum voltage, V;
276 * Maximum charge current, А;
277 * Maximum discharge current, А;
278 * SOC: Limited operation – a SOC level, at which the forklift goes into a state of limited functionality, %;
279 * SOC: Lift lockout – a SOC level, at which the forklift locks the lift, %;
280 * Thermal derate (0%): Battery temperature - a value of the battery temperature at which the thermal derate starts, °C;
281 * Thermal derate (0%): Contactor temperature - a value of the contactor temperature at which the thermal derate starts, °C;
282 * Send Heartbeat messages – a flag to enable generation of the Heartbeat messages to the forklift;
283 * Heartbeat period – Heartbeat sending period, millisecond;
284
285 (% class="box infomessage" %)
286 (((
287 **Note:** Dependence of the thermal derate from the battery and contactor temperature is linear. The system sends maximum value of the thermal derate among values calculated for the battery temperature and contactor temperature.
288 )))
289
290 The device with the identifier “Node ID” continuously transmits to the forklift the control commands with a period of 100 milliseconds.
291
292 (% class="box infomessage" %)
293 (((
294 After changing the settings, restart the BMS Mini device.
295 )))
296
297 === Combilift truck ===
298
299 To change communication parameters with a Combilift forklift, select the "External equipment → Trucks and Vehicles → Combilift truck" section:
300
301 [[image:1733753328056-822.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="158" width="800"]]
302
303 In this section:
304
305 * Enable – a flag to enable communication with the forklift;
306 * Node ID – a BMS identifier in the CANopen network;
307 * Truck ID – a forklift identifier in the CANopen network;
308 * Receive timeout – a timeout for receiving packets from the forklift (if no data is being received from the forklift during this time, the “Combilift offline“ flag is set), millisecond; at a value of 0 milliseconds, the "Combilift offline" error does not occur;
309 * Inhibit charging on the "Combilift offline" error – a flag to forbid charging if the "Combilift offline" error is generated;
310 * Inhibit discharging on "Combilift offline" error – a flag to forbid discharging if the "Combilift offline" error is generated;
311 * SOC: Limited operation – a SOC level, at which the forklift goes into a state of limited functionality, %;
312 * SOC: Lift lockout – a SOC level, at which the forklift locks the lift, %;
313 * Send Heartbeat messages – a flag to enable generation of the Heartbeat messages to forklift;
314 * Heartbeat period – Heartbeat sending period, millisecond;
315
316 The device with the identifier “Node ID” continuously transmits to the forklift control commands with a period of 200 milliseconds.
317
318 (% class="box infomessage" %)
319 (((
320 After changing the settings, restart the BMS Mini device.
321 )))
322
323 === Spirit AGV ===
324
325 To change communication parameters with a Spirit AeroSystems truck, select the "External equipment → Trucks and Vehicles → Spirit AGV" section:
326
327 [[image:1733753328057-318.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="180" width="800"]]
328
329 In this section:
330
331 * Enable – a flag to enable communication with the truck;
332 * Protocol – version of protocol:
333 ** V1;
334 ** V2;
335 * Node ID – a BMS identifier in the CANopen network;
336 * Receive timeout – a timeout for receiving packets from the truck (if no data is being received from the truck during this time, the “Spirit offline“ flag is set), millisecond; at a value of 0 milliseconds, the "Spirit offline" error does not occur;
337 * Inhibit charging on the "Spirit offline" error – a flag to forbid charging if the "Spirit offline" error is generated;
338 * Inhibit discharging on the "Spirit offline" error – a flag to forbid discharging if the "Spirit offline" error is generated;
339 * SOC: Limited operation – a SOC level, at which the truck goes into a state of limited functionality, %;
340 * SOC: Lift lockout – a SOC level, at which the truck locks the lift, %;
341 * Send Heartbeat messages– a flag to enable generation of the Heartbeat messages to the truck;
342 * Heartbeat period – Heartbeat sending period, millisecond;
343 * Config 1 (bitfield) – configuration bitfield 1;
344 * Config 2 (bitfield) – configuration bitfield 2.
345
346 The device with the identifier “Node ID” continuously transmits to the truck control commands with a period of 100 milliseconds.
347
348 === Crown truck ===
349
350 The BMS Mini device uses the BMS Crown adapter to control powering the Crown forklift.
351
352 To change communication parameters with the BMS Crown adapter, select the "External equipment → Trucks and Vehicles → Crown truck" section:
353
354 [[image:1733753328058-587.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="102" width="800"]]
355
356 In this section:
357
358 * Enable – a flag to enable communication with the BMS Crown;
359 * Node ID – a BMS Crown identifier in the CANopen network;
360 * Delta voltage (tolerance) – a maximum deviation between the battery voltage and the voltage output by the Crown forklift system, V;
361 * Inhibit discharging on the EWS signal – a flag to inhibit reclosing the discharging contactor after sending EWS signal to the forklift.
362
363 When working with the Crown forklift, the algorithm for controlling the discharging contactor is changed. The state machine used to switch the discharging contactor is described below.
364
365 1) "Discharging off" state.
366
367 In this state, the discharging contactor is **open**.
368
369 If all the conditions are met:
370
371 * the charger is disconnected;
372 * the charging contactor is open;
373 * the “Critical error” is cleared;
374 * the "Undervoltage" error is cleared;
375 * the "Overcurrent" error is cleared;
376 * the "High temperature" error is cleared.
377
378 then the transition to the state "Load connection".
379
380 2) “Load connection” state.
381
382 In this state, the discharging contactor is still open and at the same time the battery voltage is switched to line A2 (see “Relay” status field).
383
384 If, after T = 10 seconds, the difference is |Voltage A2-Voltage A1| < “Delta voltage (tolerance)”, then the transition to the state "Load connected". If after the expiration of the time T the difference |Voltage A2-Voltage A1| > “Delta voltage (tolerance)”, then the transition to the "Crown error".
385
386 3) "Load connected" state.
387
388 In this state, the discharging contactor is **closed**.
389
390 If one of the conditions:
391
392 * the charger is connected;
393 * the “Critical error” is generated;
394 * the "Undervoltage" error is generated;
395 * the "Overcurrent" error is generated;
396 * the "High temperature" error is generated;
397 * Voltage A1 = 0V (load disconnection initiated by the forklift)
398
399 then the transition to the "Discharging Off" state is performed.
400
401 4) “Load disconnection” state.
402
403 In this state, the discharging contactor is still closed and at the same time the battery voltage is not output to the A2 line.
404
405 After T = 10 seconds, the transition to the "Load Off" state if performed.
406
407 5) "Crown error" state.
408
409 In this state, the discharging contactor is **open** and the "Crown error" is generated. If the "Inhibit discharging on the EWS signal" is not set, then after T = 10 seconds, the "Crown error" is cleared and the transition to the "Discharging Off" state is performed.
410
Admin 2.1 411 The value of T is set in the "Delay before starting discharging" field (see [[Discharge>>doc:Battery management systems.BMS Mini S.3\. Configuration.3\.3 Control.WebHome||anchor="HDischarge"]]).
Admin 1.1 412
413 (% class="box infomessage" %)
414 (((
415 After changing the settings, restart the BMS Mini device.
416 )))
417
Admin 2.2 418 === ===
Admin 1.1 419
420 (% class="box infomessage" %)
421 (((
Admin 2.2 422
Admin 1.1 423 )))
424
425 === ZiK truck ===
426
427 To change communication parameters with a ZiK truck, select the "External equipment → Trucks and Vehicles → ZiK truck" section:
428
429 [[image:1733753340658-188.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="101" width="800"]]
430
431 In this section:
432
433 * Settings:
434 ** Enable – a flag to enable communication with the ZiK truck;
435 ** Node ID – a ZiK identifier in the CANopen network;
436 ** SOC: Limited operation – a SOC level at which the truck goes to limited operation mode, %;
437 ** Send supercapacitor parameters – a flag to enable transmitting the supercapacitor parameters.
438
439 The BMS with the identifier “Node ID” continuously transmits to the truck the control commands with a period of 100 milliseconds.
440
441 (% class="box infomessage" %)
442 (((
443 After changing the settings, restart the BMS Mini device.
444 )))
445
446 === Basic J1939 vehicle ===
447
448 The basic vehicle protocol J1939 is developed by Movicom Electric, and its description is available upon request. Using this protocol, information about the parameters of the battery can be obtained. The protocol also implements the management of battery operation modes.
449
450 Communication parameters via the Basic J1939 protocol are configured in the “External equipment → Trucks and Vehicles → Basic J1939 vehicle” section:
451
452 [[image:1733753340660-256.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="91" width="800"]]
453
454 In this section:
455
456 * Enable – a flag to enable communication using the protocol;
457 * First BMS message ID – an identifier of the first message of the device in the J1939 network;
458 * Receive vehicle messages – a flag to activate receiving vehicle messages;
459 * First vehicle message ID – an identifier of the first message of the vehicle in the J1939 network.
460
461 === Main X ===
462
463 The BMS Mini device can connect to BMS Main X strings controller.
464
465 Communication parameters with the Main X are configured in the "External equipment → BMS → Main X" section:
466
467 [[image:1733753340660-300.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="106" width="800"]]
468
469 In this section:
470
471 * Enable – a flag to enable communication with the BMS Main X;
472 * Receive timeout – a timeout for receiving packets from the BMS Main X.