Wiki source code of 3.5 External equipment

Version 1.3 by Admin on 2024/12/09 16:56

Show last authors
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
41 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see section “Control → Charge”).
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
83 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see section “Control → Charge”).
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
112 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see section “Control → Charge”).
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
156 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see section “Control → Charge”).
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
182 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see section “Control → Charge”).
183
184 (% class="box infomessage" %)
185 (((
186 After changing the settings, restart the BMS Mini device.
187 )))
188
189 === Sunny Island inverter ===
190
191 To change the communication parameters with an SMA Sunny Island inverter, select the "External equipment → inverters → SMA Sunny Island inverter" section:
192
193 [[image:1733753328053-956.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="136" width="800"]]
194
195 In this section:
196
197 * Enable – a flag to enable communication with the inverter;
198 * 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;
199 * Output period – a period of sending commands to the inverter, millisecond;
200 * Charge voltage, V – maximum charging voltage, V;
201 * Charge current, А – maximum charging current, A;
202 * Discharge voltage (min) – minimum discharging voltage, V;
203 * Discharge current – maximum discharging current, А;
204 * Invert current – a flag to inverse current sent to the inverter;
205
206 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.
207
208 === HYG Class I-III truck ===
209
210 The HYG Class I-III equipment is installed on the forklifts by the group of companies HYSTER-YALE.
211
212 To change communication parameters with HYG Class I-III equipment, select the "External equipment → Trucks and Vehicles → HYG Class I-III truck" section:
213
214 [[image:1733753328054-298.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="236" width="800"]]
215
216 In this section:
217
218 * Enable – a flag to enable communication with the forklift;
219 * Class – a class of equipment:
220 ** I;
221 ** II-III;
222 ** I-III Gen.2;
223 * Node ID – an equipment identifier in the CANopen network;
224 * 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;
225 * Inhibit charging on the "HYG offline" error – a flag to forbid charging if the "HYG offline" error is generated;
226 * Inhibit discharging on the "HYG offline" error – a flag to forbid discharging if the "HYG offline" error is generated;
227 * 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;
228 * Maximum voltage, V;
229 * Minimum voltage, V;
230 * Maximum charge current, А;
231 * Maximum discharge current, А;
232 * SOC: Limited operation – a SOC level, at which the forklift goes into a state of limited functionality, %;
233 * SOC: Lift lockout – a SOC level, at which the forklift locks the lift, %;
234 * Thermal derate (0%): Battery temperature - a value of the battery temperature at which the thermal derate starts, °C;
235 * Thermal derate (0%): Contactor temperature - a value of the contactor temperature at which the thermal derate starts, °C;
236 * Send Heartbeat messages – a flag to enable generation of the Heartbeat messages to the forklift;
237 * Heartbeat period – Heartbeat sending period, millisecond;
238
239 (% class="box infomessage" %)
240 (((
241 **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.
242 )))
243
244 The device with the identifier “Node ID” continuously transmits to the forklift the control commands with a period of 100 milliseconds.
245
246 (% class="box infomessage" %)
247 (((
248 After changing the settings, restart the BMS Mini device.
249 )))
250
251 === Combilift truck ===
252
253 To change communication parameters with a Combilift forklift, select the "External equipment → Trucks and Vehicles → Combilift truck" section:
254
255 [[image:1733753328056-822.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="158" width="800"]]
256
257 In this section:
258
259 * Enable – a flag to enable communication with the forklift;
260 * Node ID – a BMS identifier in the CANopen network;
261 * Truck ID – a forklift identifier in the CANopen network;
262 * 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;
263 * Inhibit charging on the "Combilift offline" error – a flag to forbid charging if the "Combilift offline" error is generated;
264 * Inhibit discharging on "Combilift offline" error – a flag to forbid discharging if the "Combilift offline" error is generated;
265 * SOC: Limited operation – a SOC level, at which the forklift goes into a state of limited functionality, %;
266 * SOC: Lift lockout – a SOC level, at which the forklift locks the lift, %;
267 * Send Heartbeat messages – a flag to enable generation of the Heartbeat messages to forklift;
268 * Heartbeat period – Heartbeat sending period, millisecond;
269
270 The device with the identifier “Node ID” continuously transmits to the forklift control commands with a period of 200 milliseconds.
271
272 (% class="box infomessage" %)
273 (((
274 After changing the settings, restart the BMS Mini device.
275 )))
276
277 === Spirit AGV ===
278
279 To change communication parameters with a Spirit AeroSystems truck, select the "External equipment → Trucks and Vehicles → Spirit AGV" section:
280
281 [[image:1733753328057-318.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="180" width="800"]]
282
283 In this section:
284
285 * Enable – a flag to enable communication with the truck;
286 * Protocol – version of protocol:
287 ** V1;
288 ** V2;
289 * Node ID – a BMS identifier in the CANopen network;
290 * 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;
291 * Inhibit charging on the "Spirit offline" error – a flag to forbid charging if the "Spirit offline" error is generated;
292 * Inhibit discharging on the "Spirit offline" error – a flag to forbid discharging if the "Spirit offline" error is generated;
293 * SOC: Limited operation – a SOC level, at which the truck goes into a state of limited functionality, %;
294 * SOC: Lift lockout – a SOC level, at which the truck locks the lift, %;
295 * Send Heartbeat messages– a flag to enable generation of the Heartbeat messages to the truck;
296 * Heartbeat period – Heartbeat sending period, millisecond;
297 * Config 1 (bitfield) – configuration bitfield 1;
298 * Config 2 (bitfield) – configuration bitfield 2.
299
300 The device with the identifier “Node ID” continuously transmits to the truck control commands with a period of 100 milliseconds.
301
302 === Crown truck ===
303
304 The BMS Mini device uses the BMS Crown adapter to control powering the Crown forklift.
305
306 To change communication parameters with the BMS Crown adapter, select the "External equipment → Trucks and Vehicles → Crown truck" section:
307
308 [[image:1733753328058-587.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="102" width="800"]]
309
310 In this section:
311
312 * Enable – a flag to enable communication with the BMS Crown;
313 * Node ID – a BMS Crown identifier in the CANopen network;
314 * Delta voltage (tolerance) – a maximum deviation between the battery voltage and the voltage output by the Crown forklift system, V;
315 * Inhibit discharging on the EWS signal – a flag to inhibit reclosing the discharging contactor after sending EWS signal to the forklift.
316
317 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.
318
319 1) "Discharging off" state.
320
321 In this state, the discharging contactor is **open**.
322
323 If all the conditions are met:
324
325 * the charger is disconnected;
326 * the charging contactor is open;
327 * the “Critical error” is cleared;
328 * the "Undervoltage" error is cleared;
329 * the "Overcurrent" error is cleared;
330 * the "High temperature" error is cleared.
331
332 then the transition to the state "Load connection".
333
334 2) “Load connection” state.
335
336 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).
337
338 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".
339
340 3) "Load connected" state.
341
342 In this state, the discharging contactor is **closed**.
343
344 If one of the conditions:
345
346 * the charger is connected;
347 * the “Critical error” is generated;
348 * the "Undervoltage" error is generated;
349 * the "Overcurrent" error is generated;
350 * the "High temperature" error is generated;
351 * Voltage A1 = 0V (load disconnection initiated by the forklift)
352
353 then the transition to the "Discharging Off" state is performed.
354
355 4) “Load disconnection” state.
356
357 In this state, the discharging contactor is still closed and at the same time the battery voltage is not output to the A2 line.
358
359 After T = 10 seconds, the transition to the "Load Off" state if performed.
360
361 5) "Crown error" state.
362
363 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.
364
365 The value of T is set in the "Delay before starting discharging" field (see section “Control → Discharge”).
366
367 (% class="box infomessage" %)
368 (((
369 After changing the settings, restart the BMS Mini device.
370 )))
371
372 === Webasto charger ===
373
374 To change the parameters of communication with a Webasto charger, select the "External equipment → Chargers → Webasto charger" section:
375
376 [[image:1733753316202-874.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="114" width="800"]]
377
378 In this section:
379
380 * Enable – a flag to enable communication with the charger;
381 * Charger ID – a Webasto charger identifier in the CANopen network;
382 * Charge voltage – maximum charging voltage, V;
383 * Charge current – maximum charging current, A;
384 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established.
385
386 Algorithm for working with the charger:
387
388 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see section “Control → Charge”).
389
390 (% class="box infomessage" %)
391 (((
392 After changing the settings, restart the BMS Mini device.
393 )))
394
395 === Skytronic charger ===
396
397 To change the parameters of communication with a Skytronic charger, select the "External equipment → Chargers → Skytronic charger" section:
398
399 [[image:1733753316203-976.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="103" width="800"]]
400
401 In this section:
402
403 * Enable – a flag to enable communication with the charger;
404 * 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;
405 * Charge voltage – maximum charging voltage, V;
406 * Charge current – maximum charging current, A;
407 * Set “Charger connected” signal if the charger is online – a flag to generate the “Charger connected” signal if connection with the charger is established.
408
409 Algorithm for working with the charger:
410
411 The BMS sends a command to charge the battery if the "Allow charging" flag is set (see section “Control → Charge”).
412
413 (% class="box infomessage" %)
414 (((
415 After changing the settings, restart the BMS Mini device.
416 )))
417
418 === ZiK truck ===
419
420 To change communication parameters with a ZiK truck, select the "External equipment → Trucks and Vehicles → ZiK truck" section:
421
422 [[image:1733753340658-188.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="101" width="800"]]
423
424 In this section:
425
426 * Settings:
427 ** Enable – a flag to enable communication with the ZiK truck;
428 ** Node ID – a ZiK identifier in the CANopen network;
429 ** SOC: Limited operation – a SOC level at which the truck goes to limited operation mode, %;
430 ** Send supercapacitor parameters – a flag to enable transmitting the supercapacitor parameters.
431
432 The BMS with the identifier “Node ID” continuously transmits to the truck the control commands with a period of 100 milliseconds.
433
434 (% class="box infomessage" %)
435 (((
436 After changing the settings, restart the BMS Mini device.
437 )))
438
439 === Basic J1939 vehicle ===
440
441 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.
442
443 Communication parameters via the Basic J1939 protocol are configured in the “External equipment → Trucks and Vehicles → Basic J1939 vehicle” section:
444
445 [[image:1733753340660-256.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="91" width="800"]]
446
447 In this section:
448
449 * Enable – a flag to enable communication using the protocol;
450 * First BMS message ID – an identifier of the first message of the device in the J1939 network;
451 * Receive vehicle messages – a flag to activate receiving vehicle messages;
452 * First vehicle message ID – an identifier of the first message of the vehicle in the J1939 network.
453
454 === Main X ===
455
456 The BMS Mini device can connect to BMS Main X strings controller.
457
458 Communication parameters with the Main X are configured in the "External equipment → BMS → Main X" section:
459
460 [[image:1733753340660-300.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="106" width="800"]]
461
462 In this section:
463
464 * Enable – a flag to enable communication with the BMS Main X;
465 * Receive timeout – a timeout for receiving packets from the BMS Main X.