Technical specification - Xtender serial protocol
Contents
1. FLOAT V1 3 1 12 25 Ms TUDER Technical specification Xtender serial protocol 4 5 Parameter objects All parameters accessible from the remote control can also be modified with the protocol The behaviour is the same as if a physical person changes the value with the remote control buttons Currently only changes at the level qsp are possible Values of type FLOAT can take any value between min and max but are rounded to the edition step on the remote control object type 0x02 4 5 1 Properties Name property id format Remark the value that can be entered on the remote value qsp 0x05 DYNAMIC control in level qsp or installer Minimum that can be entered on the remote min qsp 0x06 DYNAMIC M Deseo control in level qsp or installer Maximum that can be entered on the remote max qsp 0x07 DYNAMIC 7 r i control in level qsp or installer accessibility level of this parameter modifiable ae 0x08 ENUM ha 2 in level qsp or installer 4 5 2 Values of level properties The property 1evel qsp of type ENUM can take the following values Name value VIEW ONLY 0x00 BASIC 0x10 EXPERT 0x20 INSTALLER 0x30 5 0x40 4 5 3 Available parameters on the Xtender Inverter The change of parameters when the inverters are in operation should be done carefully The modification of parameters can restart the cor2. 6 AB SERVICES vee HW 6 7 2 OBJECT MODE eA E ER Fd ed Fre ca ped udi EIN de noQ 6 4 2 1 READ PROPERTY ETna EEY 4 2 2 WRITE PROPERTY service ADB out A 3 ERROR CODES 9 AA SYSTEMISTATE OBJECTS do va a vea esa due sace 10 4 4 1 5 ERE 10 4 4 2 Available system states on the Xtender 1 ans 10 4 4 3 Available system states on the BSP nn 12 4 5 PARAMETER OBJECTS iin cute need e ca laa eia sa ar i se xd nc E a c dr adr a a de Pao saa da dad 13 49 1 Properties set less sabe 4 5 2 Values of level properties 4 5 3 Available parameters on the Xtender Inverter 4 5 4 Cyclic write of parameters on the Xtender 1 14 4 5 5 Hours encoding eter Pu pa ERE AEN ed Y Aaa tele tan Ra ets 4 5 6 Days of the week encoding 4 5 7 Month of the year encoding nasse netta ansa snas 14 25 8 Date encoding i a m t
3. AUX 2 Contact activated only if the battery is charged AUX 2 Contact active according to SOC AUX 2 Only with BSP Contact activated with the SOC 1 of battery AUX 2 Contact activated below SOC 1 AUX 2 Delay 1 AUX 2 Contact activated with the SOC 2 of battery AUX 2 Contact activated below SOC 2 AUX 2 Delay 2 AUX 2 Contact activated with the SOC 3 of battery AUX 2 Contact activated below SOC 3 AUX 2 Delay 3 AUX 2 Contact deactivated over SOC AUX 2 Delay to deactivate AUX 2 Deactivate if battery in floating phase AUX 2 Security maximum time of contact AUX 2 Maximum time of operation of contact AUX 2 Reset all settings AUX 2 AUXILIARY CONTACTS 1 AND 2 EXTENDED FUNCTIONS Generator control active Number of starting attempts Starter pulse duration with AUX2 Time before a starter pulse Main contact hold interrupt time SYSTEM Remote entry Remote ON OFF Remote entry active Prohibits transfert relay Prohibits inverter Prohibits charger Prohibits Smart Boost Prohibits grid feeding Use an alternate max input current Second maximum current of AC source Input limit Decrease max input limit activated by remote entry ON OFF command Activated by AUX1 state Prohibits battery priority Batteries priority as energy source Battery priority voltage Buzzer alarm duration Auto restarts After battery undervoltage Number of batteries undervoltage allowed before definitive stop Time period for batter
4. AY Technical specification Xtender serial protocol Author Marc Emery Date 08 09 11 Version V1 3 1 5 Tech sF Specifications techniques Technical specification Xtender serial protocol Contents 1 INTRODUCTION m 2 1 1 CONVENTIONS USED IN THIS DOCUMENT states tarn VD e nee sera TERR Ya ns dits eda kN ka en 2 1 2 L ISTIOFACRONYMS aire dede eoo sra ts vr duc EO beate e at dre du n Perder ceti e de eu iR ra pd uci Diane 2 2 PHYSICAL LAYER EE 3 2 1 CONNECTOR du Uc 3 2 2 CABLE TO US Ens 3 3 DATA LINK E nets 4 3 TL USART CONFIGURATION ane perra tte au repre dives dan id e deae uie ves vl Ee teen 4 3 2 BYTE ENDIANNESS a cen tea erae coo e aeree vede ag coner ates urea aan ane OOo m eva E Toup e der we de Nordic e Teu dE aeu 4 TN SERRE A ET DE a EP EE a 4 3 4 ADDRESSING THE DEVICES si 55 56 52 n cp dee paa ca cc eu eve cp arp obo oso veio db ea 5 3 5 RESPONSE DELAY cose ete cage a Cdp nc Ra v kv e eo coat s ree eg reed ip cocum Ve eva e oco v ee eoo pates 5 A APPLICATION LAYER em
5. 1468 for example is coded as a INT32 To send a signal you must write the value 1 to the parameter value Ms TUDER V1 3 1 15 25 Technical specification Xtender serial protocol 5 Examples of frames The byte stream is represented in hexadecimal As specified above the encoding is little endian 5 1 Command line tool To help the implementation of the protocol we supply the command line tool scom exe Please contact Studer Innotec for the last version of the executable 5 2 Read the value of a system state generated by the command 2Scom exe port COM3 verbose 3 read property src addr 1 object type 1 object id 3000 property id 1 format FLOAT dst addr 101 Request start frame src addr dst addr 101 data length header frame data byte flags 1 first inverter 10 checksum data checksum AA 00 01000000 65000000 0A00 6F71 10 bytes C590 flags service id object type object id property id is response false READ SYSTEM STATE 3000 error false PROPERTY value 00 01 0100 B80B0000 0100 Total number of bytes 144 1042 26 bytes Response start frame src addr dst addr 1 data length header frame data byte flags 101 14 checksum data checksum AA 00 65000000 01000000 7309 14 bytes 6357 flags service_id object_type objec
6. INT32 INT32 V1 3 1 21 25 Ms TUDER Technical specification Xtender serial protocol Inst Inst Inst Inst Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert 1329 1330 1331 1332 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1456 1333 1519 1544 1334 1335 1336 1337 1521 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1350 1351 1352 1530 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1517 1366 1367 1368 1369 1370 1371 1372 Program 5 AUX 2 Day of the week AUX 2 Start hour AUX 2 End hour AUX 2 Contact active with a fixed time schedule AUX 2 Program 1 AUX 2 Day of the week AUX 2 Start hour AUX 2 End hour AUX 2 Program 2 AUX 2 Day of the week AUX 2 Start hour AUX 2 End hour AUX 2 Program 3 AUX 2 Day of the week AUX 2 Start hour AUX 2 End hour AUX 2 Contact active on event AUX 2 Xtender is OFF AUX 2 Xtender ON AUX 2 Remote entry AUX 2 Battery undervoltage A
7. The Studer Innotec remote control used to configure the Xtender system Xcom 232i The Studer Innotec RS 232 communication module that has the function of a DCE Data Communications Equipment DTE Data Terminal Equipment the PC or controller system that wants to communicate with the Xcom 232i SCOM Naming prefix used for the Studer Innotec serial protocol V1 3 1 2 25 Technical specification Xtender serial protocol 2 Physical layer The physical layer is RS 232 The Xcom 232i is equiped with a DE 9 also known as DB 9 Female connector which provides this interface The serial port is galvanically separated with an isolation of 500 V DC relative to the negative battery potential 2 1 Connector Pinning On the female connector of the RCC only the wires receive data transmitted data and ground are connected The other wires are not connected and the DTE must ignore signals such as CTS DTR or DCD pin number usage 1 not connected RxD TxD not connected GND not connected not connected not connected Ul A WI N not connected 2 2 Cable to use The cable to be used with a PC is a Female Male straight v1 3 1 3 25 amp Technical specification Xtender serial protocol 3 Data link layer The data link layer as defined in the OSI model is used to send and receive frame on the RS 232 3 1 USART configur
8. battery E out Day E10 kWh FLOAT of the current day 3080 Energy from AC In of Eac in YD E2 kWh FLOAT the previous day 3081 Energy from AC In of Eac in E1 kWh FLOAT the current day Day 3082 Consumers energy of Eac out E2 kWh FLOAT the previous day YD 3083 Consumers energy of Eac out El kWh FLOAT the current day Dy V1 3 1 11 25 Ms TUDER Technical specification Xtender serial protocol 4 4 3 Available system states on the BSP As on the inverter all values that can be displayed on the RCC can be read id Description short unit on unit FORMAT related parameter or name the description RCC 7000 Battery voltage Ubat V V FLOAT 7001 Battery current Ibat A A FLOAT 7002 State of Charge SOC 96 96 FLOAT 7003 Power C cons Ww 926 FLOAT 7004 Remaining autonomy Trem minutes minutes FLOAT 7006 Relative capacity Crel 96 96 FLOAT 7007 Ah charged today Od lt Ah Ah FLOAT 7008 Ah discharged today Od gt Ah Ah FLOAT 7009 Ah charged yesterday 1d lt Ah Ah FLOAT 7010 Ah discharged yesterday 1d gt Ah Ah FLOAT 7011 Total KAh charged tot lt kAh kAh FLOAT 7012 Total kAh discharged tot kAh kAh FLOAT 7013 Total time Ttot days days FLOAT Custom charge FLOAT 7017 counter cus Ah Ah Custom discharge Ah FLOAT 7018 counter cus lt Ah Ah 7019 Custom counter duration Tcus h h FLOAT 7029 Battery temperature That
9. this version of the protocol BIT1 is response flag O if it is a request from the DTE to the Xcom 232i 1 if it is response from the Xcom 232i BITO error flag O in case of success 1 if an error occurred In case of a request error is always 0 service id One of the following services described later in this document READ PROPERTY 0x01 service data The data specific to the service In case of a problem the errors are reported in a service specific way but the response has to include the error code described in the next section 4 2 Object model The different data accessible on each device are organized in object classes Every object class has a number of properties The service READ PROPERTY is used to read the object s properties Ms TUDER V1 3 1 6 25 Technical specification Xtender serial protocol 4 2 1 READ PROPERTY service This service is used to read an object s property The DTE sends a request frame with the following frame data flags service id object type object id property id 0x00 0x01 2 bytes 4 bytes 2 bytes flags is response 0 error 0 service id 0x01 for READ PROPERTY object type object id property id the object type identifier defined later in this document the object identifier specific to each object type i e two objects with different type can have the same id identify the property in the object The RCC responds with a frame
10. tolerant UPS mode Input voltage giving an opening of the transfer relay with delay Time delay before opening of transfer relay Input voltage giving an immediate opening of the transfer relay UPS Absolute max limit for input voltage Standby of the charger allowed Delta frequency allowed above the standard input frequency Delta frequency allowed under the standard input frequency Duration with frequency error before opening the transfer AC IN current active filtering AUXILIARY CONTACT 1 Operating mode AUX 1 Combination of the events for the auxiliary contact AUX 1 Temporal restrictions AUX 1 FLOAT BOOL FLOAT BOOL FLOAT ONLY LEVEL BOOL FLOAT FLOAT ONLY LEVEL BOOL FLOAT FLOAT FLOAT ONLY LEVEL BOOL FLOAT BOOL FLOAT FLOAT BOOL BOOL FLOAT FLOAT ONLY LEVEL FLOAT FLOAT FLOAT FLOAT BOOL BOOL ONLY LEVEL BOOL FLOAT BOOL FLOAT ONLY LEVEL BOOL FLOAT BOOL BOOL FLOAT FLOAT FLOAT FLOAT BOOL ENUM FLOAT FLOAT FLOAT FLOAT FLOAT BOOL FLOAT FLOAT FLOAT BOOL ONLY LEVEL ENUM BOOL ONLY LEVEL V1 3 1 19 25 Ms TUDER Technical specification Xtender serial protocol Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Inst Inst Inst Inst Inst Inst Inst Inst Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expe
11. 00 number of bytes 14 10 2 26 bytes V1 3 1 17 25 Ms TUDER Technical specification Xtender serial protocol 6 Annexes 6 1 Xtender parameters User Level ref Parameter Scom format Basic 1100 BASIC SETTINGS Basic 1551 Basic parameters set with buttons inside XTS Basic 1107 Maximum current of AC source Input limit Basic 1138 Battery charge current Basic 1126 Smart Boost allowed Basic 1124 Inverter allowed Basic 1552 Type of detection of AC input loss UPS Basic 1187 Standby level Basic 1395 Restore default settings Inst 1287 Restore factory settings Expert 1137 BATTERY MANAGEMENT AND CYCLE Expert 1125 Charger allowed Basic 1138 Battery charge current Expert 1139 Battery temperature compensation Expert 1568 Undervoltage Expert 1108 Battery undervoltage level without load Expert 1531 Battery undervoltage dynamic compensation Expert 1191 Battery undervoltage dynamic compensation Expert 1532 Kind of dynamic compensation Expert 1109 Battery undervoltage level at full load Expert 1190 Battery undervoltage duration before turn off Expert 1110 Restart voltage after batteries undervoltage Expert 1194 Battery adaptive low voltage B L O Expert 1195 Max voltage for adaptive low voltage Expert 1307 Reset voltage for adaptive correction Expert 1298 Increment step of the adaptive low voltage Expert 1121 Batte
12. 1 4 6 set the parameter 1550 to no on all targeted inverter avoid to write cyclically on other devices like BSP RCC ensure that no reset default factory settings apply configuration file masterfile or modification with the remote control change 1550 to yes It is a good pratice to cyclically write no to 1550 A write of yes to the parameter 1550 reactivate the write in flash It will be written in the flash every time and should not be used more that 1000 time 4 5 5 Hours encoding the hours encoding is in minute since 00 00 in INT32 For example 13 41 is 13 60 41 821 4 5 6 Days of the week encoding The days of the week selection parameters 1205 for example is coded as a bit field in a INT32 A day selected as it bit set to 1 bit BIT31 7 BIT6 BITS BIT4 BIT3 BIT2 BIT1 BITO day of the week undefined SU SA FR TH WE TU MO 4 5 7 Month of the year encoding The month of the year selection parameters 1479 for example is coded as a bit field in a INT32 A month selected as it bit set to 1 January is BITO and December BIT11 The BIT31 to 12 are undefined Ms TUDER V1 3 1 14 25 Technical specification Xtender serial protocol 4 5 8 Date encoding The Date parameters 5002 for example is coded as a INT32 The value is the number of second since 1 1 1970 00 00 00 4 5 9 Signal encoding The Signal parameters
13. Basic 5068 Restore all files system recovery INT32 Basic 5070 Apply configuration files masterfile INT32 Expert 5032 Separator of the csv files ENUM Expert 5069 Advanced backup functions ONLY LEVEL Expert 5030 Save messages INT32 Expert 5049 Save and restore RCC files ONLY LEVEL Expert 5015 Save RCC parameters INT32 Expert 5016 Load RCC parameters INT32 Expert 5050 Save and restore Xtender files ONLY LEVEL Expert 5017 Save Xtender parameters INT32 Expert 5018 Load Xtender parameters INT32 Inst 5033 Create Xtender configuration file masterfile INT32 Expert 5034 Load Xtender configuration file masterfile INT32 Expert 5045 Load Xtender parameters preset Not supported Expert 5051 Save and restore BSP files ONLY LEVEL Expert 5052 Save BSP parameters INT32 Expert 5053 Load BSP parameters INT32 Inst 5054 Create BSP configuration file masterfile INT32 Expert 5055 Load BSP configuration file masterfile INT32 Inst 5047 Format the SD card INT32 Expert 5061 Start update INT32 Inst 5042 Modification of access levels of many parameters ONLY LEVEL Inst 5043 Change all parameters access level to ENUM Inst 5044 Restore default access level of all parameters INT32 Expert 5007 Backlight ONLY LEVEL Expert 5008 Backlight always off BOOL Expert 5009 Backlight switch off after FLOAT Expert 5026 Red backlight flashing on Xtender off and faulty BOOL Basic 5021 Extended and special functions ONLY LE
14. L BOOL BOOL BOOL ONLY LEVEL BOOL BOOL FLOAT FLOAT BOOL FLOAT FLOAT BOOL FLOAT FLOAT FLOAT FLOAT BOOL ONLY LEVEL BOOL FLOAT FLOAT BOOL FLOAT FLOAT V1 3 1 22 25 Ms TUDER Technical specification Xtender serial protocol Expert Expert Expert Expert Expert Inst Inst Inst Inst Inst Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Inst Inst Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert 1373 1374 1375 1376 1377 1504 1457 1458 1459 1460 1502 1442 1443 1590 1591 1592 1593 1594 1595 1596 1444 1597 1598 1513 1515 1570 1489 1491 1493 1492 1494 1574 1101 1537 1545 1538 1539 1540 1541 1542 1566 1567 1554 1576 1578 1579 1296 1297 1565 1129 1130 1304 1404 1305 1405 1131 1132 1533 1134 1111 1484 Inverter power level 3 activate AUX 2 Power level 3 AUX 2 Time delay 3 AUX 2 Inverter power level to deactivate AUX 2 Time delay to deactivate AUX 2 Contact active according to battery temperature AUX 2 With BSP or BTS Contact activated with the temperature of battery AUX 2 Contact activated over AUX 2 Contact deactivated below
15. LOAT BOOL FLOAT FLOAT FLOAT FLOAT FLOAT FLOAT INT32 ONLY LEVEL INT32 FLOAT FLOAT FLOAT FLOAT BOOL BOOL FLOAT ONLY LEVEL BOOL FLOAT FLOAT BOOL FLOAT BOOL FLOAT ONLY LEVEL BOOL INT32 BOOL FLOAT FLOAT FLOAT V1 3 1 18 25 Ms TUDER Technical specification Xtender serial protocol Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Basic Expert Expert Expert Expert Expert Expert Expert Expert Expert Basic Expert Expert Expert Expert QSP Expert Expert Expert Basic Basic Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Basic Expert Expert Expert Expert Inst QSP Expert Expert Expert Expert Expert Expert Expert Expert 1166 1284 1285 1168 1169 1453 1170 1171 1172 1454 1173 1174 1175 1176 1186 1124 1286 1548 1560 1112 1536 1549 1546 1534 1420 1187 1189 1188 1599 1438 1572 1197 1128 1580 1126 1107 1471 1566 1567 1527 1554 1309 1433 1553 1295 1436 1552 1510 1199 1198 1200 1432 1500 1505 1506 1507 1575 1201 1202 1497 1203 Number of cycles before an equalization Equalization at fixed interval Weeks between equalizations End of equalization triggered with current Current limit to quit the equalization phase Phase of reduced floating Reduced floating allowed Floating duration before reduced floating Red
16. UX 2 Battery overvoltage AUX 2 Inverter or Smart Boost overload AUX 2 Overtemperature AUX 2 No overtemperature AUX 2 Active charger AUX 2 Active inverter AUX 2 Active Smart Boost AUX 2 AC input presence but with fault AUX 2 AC input presence AUX 2 Transfer contact ON AUX 2 AC out presence AUX 2 Bulk charge phase AUX 2 Absorption phase AUX 2 Equalization phase AUX 2 Floating AUX 2 Reduced floating AUX 2 Periodic absorption AUX 2 Autonomy test running AUX 2 Contact active according to battery voltage AUX 2 Use dynamic compensation of battery level AUX 2 Battery voltage 1 activate AUX 2 Battery voltage 1 AUX 2 Delay 1 AUX 2 Battery voltage 2 activate AUX 2 Battery voltage 2 AUX 2 Delay 2 AUX 2 Battery voltage 3 activate AUX 2 Battery voltage 3 AUX 2 Delay 3 AUX 2 Battery voltage to deactivate AUX 2 Delay to deactivate AUX 2 Deactivate if battery in floating phase AUX 2 Contact active with inverter power or Smart Boost AUX 2 Inverter power level 1 activate AUX 2 Power level 1 AUX 2 Time delay 1 AUX 2 Inverter power level 2 activate AUX 2 Power level 2 AUX 2 Time delay 2 AUX 2 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOO
17. VEL Basic 5006 Display contrast FLOAT Inst 5073 Choice of standard display ENUM Expert 5010 Come back to standard display after FLOAT Expert 5011 Visibility of the transitory messages FLOAT Basic 5027 Acoustic alarm active BOOL Expert 5031 Remote control acoustic alarm duration FLOAT Expert 5056 Switching ON and OFF of system on level VIEW ONLY BOOL Inst 5071 Reset of all the remotes control INT32 Inst 5072 Activation of old CAN protocol v 1 1 x BOOL V1 3 1 25 25 Ms TUDER
18. age ripple Ubat ond Vrip V FLOAT 3010 Battery cycle phase Phase 0 invalid value ENUM see parameter 1137 1 Bulk 2 Absorpt 3 Equalise 4 Floating 5 R float 6 Per abs 7 Mixing 8 Forming 3011 Input voltage AC In U in Vac V FLOAT 3012 input current AC Iin FLOAT In 3013 Input power AC In Pin kVA kVA FLOAT 3014 Input frequency F in Hz Hz FLOAT 3018 Power sharing active P sharing BOOL see parameter 1107 3019 Boost active Boost BOOL see parameter 1126 3020 State of transfer Transfert 0 Opened ENUM relay 1 Closed 3021 Output voltage AC U out Vac V FLOAT Out 3022 Output current AC I out Aac A FLOAT Out 3023 Output power AC P out kVA kVA FLOAT Out 3024 Output frequency F out Hz Hz FLOAT 3028 Operating state Mode 0 invalid value ENUM give the current working 1 Inverter mode of the inverter See 2 Charger 1107 for Boost 1522 for 3 Boost Injection grid feeding 4 Injection charger and inverter mode are oblivious 3030 State of output relay Rel out 0 Opened ENUM 1 Closed 3031 State of auxiliary Aux 1 0 Opened ENUM see parameter 1201 relay I 1 Closed 3032 State of auxiliary Aux 2 0 Opened ENUM see parameter 1201 relay II 1 Closed 3049 State of the system Sys state 0 Off ENUM 1 On 3051 Search mode state SB state 0 Off ENUM see parameter 1187 1 On 3076 Discharge of battery E out YD E20 kWh FLOAT of the previous day 3078 Discharge of
19. ation The RS 232 is defined with e A fixed baudrate of 38400 bps e 1 start bit e 8 bit of data LSB first e 1 parity bit e even parity e 1 stop bit 3 2 Byte Endianness All values are in little endian i e LSB bytes are send on the Physical layer first 3 3 Frame The Xcom 232i and the DTE exchange frames consist of a header of 14 bytes followed by a variable number of data bytes and 2 bytes of checksum start_ frame_ src_ dst_ data_ header_ frame_ data_ byte flags addr addr length checksum data checksum 2 bytes 1 byte 1 byte 4 bytes 4 bytes 2 bytes N bytes 2 bytes e The start byte is always OxAA e frame flags field reserved must be 0x00 in this version of the protocol e src addr is the source address 32 bit little endian e dest addr is the destination address 32 bit little endian e the length of the frame s data in byte e the checksum of the header from frame flags to data length included e the data bytes e the checksum of all the data bytes of frame data The maximum number of frame data is 242 so that 14 242 2 256 Ms TUDER V1 3 1 4 25 Technical specification Xtender serial protocol The checksum is computed with the following algorithm A OxFF B 0 For I FROM 0 TO number of bytes 1 DO A A DATA I mod 0x100 B B A mod 0x100 END checksum 0 A checksum 1 B A and B are byte values and the addition is mad
20. bytes flags flags response 1 error 1 service id 0x01 for READ PROPERTY object type same as the request object id same as the request property id same as the request property data If the flag error 0 O byte of data if not to byte of type bytes identifying the error code 4 2 3 Format The property data are encoded in different formats described below Some properties have a format that can be different from one object to an other in the same object type For example an the value qsp of parameter can be an ENUM or a FLOAT depending on the parameter id identified by the object id In this case it is described here as type DYNAMIC The DTE must then know the exact type of the property for each object to decode it INVALID FORMAT O BOOL 1 binary data 1 byte 0 false 1 true other values are invalid V1 3 1 8 25 amp Technical specification Xtender serial protocol FORMAT 2 a property what define the format of an other property 16 bit integer ENUM 3 a value that is part of a enumeration of possible values represented with a 16 bit integer ERROR 4 16 bit error code INT32 5 32 bit signed value FLOAT 6 float in 32 bit IEEE 754 format little endian STRING 7 ISO_8859 15 string of 8 bit characters DYNAMIC 8 a property with a different format for each object id BYTE_STREAM 9 a stream a byte of abitrary length example of dynamic value a
21. d received the wrong arguments 4 4 System state objects These objects are the information about the current state of the system They cannot be modified and their values change during the operation of the system object type 0x01 object id see the table in next section 4 4 1 Properties Name property id format remark variable length see the format in following Value 0x01 DYNAMIC table 4 4 2 Available system states on the Xtender Inverter The values defined in the following table are accessible on the Xtender XTH and XTM inverters The states available are the same as the values that can be chosen to be displayed on the RCC The system states are related with inverter parameters that you can be configured with the RCC The description of the functionalities for each parameter can be found in the RCC manual with the index by id number at the end V1 3 1 10 25 Merten Technical specification Xtender serial protocol id Description short unit on unit FORMAT related parameter or name the description RCC 3000 Battery voltage Ubat Vdc V FLOAT 3001 Battery temperature ec C FLOAT value given by the external no sensor battery temperature sensor return 32767 BTS 01 C 3005 Battery charge Ibat Adc A FLOAT current 3006 Battery volt
22. e modulo 256 After an invalid parity bit header or data checksum the data link layer is reseted and waits for an other frame 3 4 Addressing the devices address devices remarks 101 to 109 XTH and XTM inverters ordered by the index displayed on the RCC 301 to 331 MPPT ordered by the index displayed on the RCC 401 Xcom MS 501 to 503 Xcom 232i 601 BSP 1 alias for the gateway that the DTE uses to communicate the Xcom 232i to which you speak with RS 232 3 5 Response delay The response delay of the Xcom 232i can be up to 2 seconds This is a good value for a timeout in the DTE implementation Vis 5 25 Msrtuen Technical specification Xtender serial protocol 4 Application layer The OSI layers 3 to 6 are not used The application layer defines a number of services A DTE sends a request frame and waits for a response frame from the Xcom 232i If an error in the header checksum or data checksum is detected there is no response from the application layer and the Xcom 232i waits for another request as if nothing has been received The Xcom 232i copies the src addr of the request in the response dst addr 4 1 Services The first two bytes of frame data define the type of service and different flags for this service service flags service id service data 1 byte 1 byte N bytes service flags BIT7 BIT2 reserved must be all zero in
23. esoros E eine dette nn 15 4 5 9 5 2 reet te an etre ne 15 5 EXAMPLES OF FRAMES sicescccscsescscnessvcnssicencserscenascsesunessvevesesvncterescnessscnunedvvcndvedesehevetenasdsesunessvenevestuedsvesenevescs 16 5 1 COMMAND LINE TOOL 2225522 Error ERE FEX ERR E ENS ERES CREE YR ch sien 5 2 READ THE VALUE OF A SYSTEMI STATE ss cecidere e iere eee ve e rex Ee ehe ede pee Ee eere Rad bete poses 5 3 WRITE THE QSP_ VALUE OF A PARAMETER 2 nn nn nn nd 9966 906905 560068 955600555 18 6 1 XTENDER PARAMETERS 6 2 BSP PARAMETERS plenae te ke ti lens i ane lee ebd co i E 6 3 RCC PARAMETERS EHE PEE ot Xa REL etant ER CAE SEE ER LEER DERE ERE ERE hs TUDER V1 3 1 1 25 Technical specification Xtender serial protocol 1 Introduction This technical specification describes the protocol used to communicate with the Studer Innotec Xcom 232i communication module It is also valid for the discontinuted RCC 02 03 special execution ES N 32 RCC 02 03 32 1 1 Conventions used in this document e Numbers that start with Ox in hexadecimal like in the C integer litterals e constant values are usually represented in UPPER CASE e field names are in lower case with underscore 1 2 List of acronyms RCC
24. ies undervoltages counting Number of batteries critical undervoltage allowed before definitive stop Time period for critical batteries undervoltages counting After battery overvoltage After inverter or Smart Boost overload Delay to restart after an overload After overtemperature Autostart to the battery connection System earthing Earth Neutral BOOL FLOAT FLOAT FLOAT FLOAT ONLY LEVEL BOOL FLOAT FLOAT BOOL ONLY LEVEL BOOL FLOAT FLOAT BOOL FLOAT FLOAT BOOL FLOAT FLOAT FLOAT FLOAT BOOL BOOL FLOAT INT32 ONLY LEVEL BOOL FLOAT FLOAT FLOAT FLOAT ONLY LEVEL ONLY LEVEL BOOL BOOL BOOL BOOL BOOL BOOL BOOL FLOAT BOOL BOOL BOOL BOOL BOOL FLOAT FLOAT ONLY LEVEL BOOL FLOAT FLOAT FLOAT FLOAT BOOL BOOL FLOAT BOOL BOOL ONLY LEVEL V1 3 1 23 25 Ms TUDER Technical specification Xtender serial protocol Expert 1485 Expert 1486 Expert 1473 Expert 1474 Expert 1495 Expert 1475 Expert 1476 Expert 1477 Expert 1478 Expert 1496 Expert 1479 Expert 1480 Expert 1481 Expert 1482 Expert 1483 Inst 1550 Inst 1415 Inst 1399 Expert 1468 Expert 1282 Expert 1283 Expert 1461 Expert 1462 Expert 1555 Expert 1547 Expert 1571 Inst 1437 Inst 1577 Expert 1522 Expert 1127 Expert 1523 Expert 1524 Expert 1525 Expert 1526 Prohibited ground relay Continuous neutral Autotest of the batte
25. n object class has the property type of format FORMAT and the property value of format DYNAMIC for the object x if type 6 FLOAT value is a 4 byte IEEE 754 little endian float 4 3 Error codes The following error codes can be returned name error id meaning INVALID FRAME 0x0001 malformed frame DEVICE NOT FOUND 0x0002 wrong dst addr field RESPONSE TIMEOUT 0x0003 no response of the server SERVICE NOT SUPPORTED 0 0011 wrong service id field INVALID SERVICE ARGUMENT 0x0012 wrong service data SCOM ERROR GATEWAY BUSY 0x0013 gateway for example XCOM 232i busy TYPE NOT SUPPORTED 0x0021 the object type requested doesn t exist OBJECT ID NOT FOUND 0x0022 no object with this object id was found PROPERTY NOT SUPPORTED ONE d E dL INVALID DATA LENGTH 0x0024 su property_data has an invalid number of PROPERTY IS READ ONLY 0x0025 a writing to this property is not allowed INVALID DATA 0x0026 this value is impossible for this property DATA TOO SMALL 0x0027 the value is below the minimum limit DATA TOO BIG 0x0028 the value is above the maximum limit Ms TUDER V1 3 1 9 25 Technical specification Xtender serial protocol WRITE PROPERTY FAILED 0x0029 writing is possible but failed READ PROPERTY FAILED 0x002A readind is possible but failed ACCESS DENIED 0x002B insufficient user access INVALID SHELL ARG 0x0081 the command line tool use
26. perature AUX 1 No overtemperature AUX 1 Active charger AUX 1 Active inverter AUX 1 Active Smart Boost AUX 1 AC input presence but with fault AUX 1 AC input presence AUX 1 Transfer relay ON AUX 1 AC out presence AUX 1 Bulk charge phase AUX 1 Absorption phase AUX 1 Equalization phase AUX 1 Floating AUX 1 Reduced floating AUX 1 Periodic absorption AUX 1 Autonomy test running AUX 1 Contact active according to battery voltage AUX 1 Use dynamic compensation of battery level AUX 1 Battery voltage 1 activate AUX 1 Battery voltage 1 AUX 1 Delay 1 AUX 1 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL ONLY LEVEL BOOL BOOL FLOAT FLOAT V1 3 1 20 25 Ms TUDER Technical specification Xtender serial protocol Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Inst Inst Inst Inst Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Ex
27. pert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Inst Inst Inst Inst 1249 1250 1251 1252 1253 1254 1255 1256 1516 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1503 1446 1447 1448 1501 1439 1440 1581 1582 1583 1584 1585 1586 1587 1441 1588 1589 1512 1514 1569 1310 1311 1498 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 Battery voltage 2 activate AUX 1 Battery voltage 2 AUX 1 Delay 2 AUX 1 Battery voltage 3 activate AUX 1 Battery voltage 3 AUX 1 Delay 3 AUX 1 Battery voltage to deactivate AUX 1 Delay to deactivate AUX 1 Deactivate if battery in floating phase AUX 1 Contact active with inverter power or Smart Boost AUX 1 Inverter power level 1 activate AUX 1 Power level 1 AUX 1 Time delay 1 AUX 1 Inverter power level 2 activate AUX 1 Power level 2 AUX 1 Time delay 2 AUX 1 Inverter power level 3 activate AUX 1 Power level 3 AUX 1 Time delay 3 AUX 1 Inverter power level to deactivate AUX 1 Time delay to deactivate AUX 1 Contact active according to battery temperature AUX 1 With BSP or BTS Contact activated with the temperature of battery AUX 1 Contact activated over AUX 1 Contact deactivated below AUX 1 Contact active according to SOC AUX 1 Only with BSP Con
28. responding algorithm inside the inverter and thus the change of a value in a cyclic way could sometimes lead to unexpected behaviour object id a number starting at 1000 See the complete parameter references at the end of the RCC User manual V1 3 1 13 25 Merten Technical specification Xtender serial protocol 4 5 4 Cyclic write of parameters on the Xtender Inverter The Xtender inverter store the parameter values in a non volatile flash memory Because of the endurance of this memory the number of write on a single parameter property is only garanted for 1000 write operations To allow the cyclic write of parameters without count limit the parameter 1550 Parameters saved in flash memory as been introduced in the Xtender software This parameter has the value yes by default A write of no to this parameter value stop the write in the non volatile flash memory This operation is written in the flash memory only the first time so consecutive writes of the value no to 1550 can be repeated without limit After parameter 1550 has been set to no all other parameters can be written without count limit Because the values of all other parameters are not stored in flash the read operation will give the values before 1550 as be changed to no Also after a reset the old values will be taken To use the inverter with cyclic write operations you must ensure that all inverters have a firmware version gt
29. rt Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert Expert 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1455 1225 1518 1543 1226 1227 1228 1229 1520 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1242 1243 1244 1529 1245 1288 1246 1247 1248 Program 1 AUX 1 Day of the week AUX 1 Start hour AUX 1 End hour AUX 1 Program 2 AUX 1 Day of the week AUX 1 Start hour AUX 1 End hour AUX 1 Program 3 AUX 1 Day of the week AUX 1 Start hour AUX 1 End hour AUX 1 Program 4 AUX 1 Day of the week AUX 1 Start hour AUX 1 End hour AUX 1 Program 5 AUX 1 Day of the week AUX 1 Start hour AUX 1 End hour AUX 1 Contact active with a fixed time schedule AUX 1 Program 1 AUX 1 Day of the week AUX 1 Start hour AUX 1 End hour AUX 1 Program 2 AUX 1 Day of the week AUX 1 Start hour AUX 1 End hour AUX 1 Program 3 AUX 1 Day of the week AUX 1 Start hour AUX 1 End hour AUX 1 Contact active on event AUX 1 Xtender is OFF AUX 1 Xtender ON AUX 1 Remote entry AUX 1 Battery undervoltage AUX 1 Battery overvoltage AUX 1 Inverter or Smart Boost overload AUX 1 Overtem
30. ry autonomy Functionality test weekly Start manually a functionality test weekly Day in the week of the test Hour of the beginning of the test Duration of the test Autonomy test monthly Start manually an autonomy test monthly Months of the test Day in the month of the test Day in the week of the test Hour of the beginning of the test Duration of the test Parameters saved in flash memory Global ON of the system Global OFF of the system Reset of all the inverters MULTI XTENDER SYSTEM Integral mode Multi inverters allowed Multi inverters independents Battery cycle synchronized by master Allow slaves standby in multi Xtender system Splitphase L2 with 180 degrees phaseshift Minigrid compatible Minigrid with shared battery energy GRID FEEDING Grid feeding allowed Max grid feeding current Battery voltage target for forced grid feeding Forced grid feeding start time Forced grid feeding stop time BOOL BOOL ONLY LEVEL BOOL INT32 ENUM INT32 FLOAT BOOL INT32 ENUM FLOAT ENUM INT32 FLOAT BOOL INT32 INT32 INT32 ONLY LEVEL BOOL BOOL BOOL BOOL BOOL BOOL BOOL BOOL ONLY LEVEL BOOL FLOAT FLOAT INT32 INT32 6 2 BSP parameters User Level ref Parameter Scom format Basic 6000 BASIC SETTINGS ONLY LEVEL Basic 6001 Nominal capacity FLOAT Basic 6002 Nominal discharge duration C rating FLOAT Basic 6017 Nominal shunt current FLOAT Basic 6018 Nominal shunt voltage FLOAT Expert 6003 Reset of ba
31. ry overvoltage level Expert 1122 Restart voltage level after an battery overvoltage Expert 1140 Battery floating level Expert 1467 Force phase of floating Expert 1141 New cycle menu Expert 1142 Force a new cycle Expert 1143 Battery voltage level 1 to start a new cycle Expert 1144 Time period under battery voltage level 1 to start a new cycle Expert 1145 Battery voltage level 2 to start a new cycle Expert 1146 Time period under battery voltage level 2 to start a new cycle Expert 1149 New cycle priority on absorption and equalization phases Expert 1147 Battery cycling restricted Expert 1148 Minimal delay between cycles Expert 1451 Phase of absorption Expert 1155 Absorption phase allowed Expert 1156 Battery absorption voltage Expert 1157 Absorption duration Expert 1158 End of absorption triggered with current Expert 1159 Current limit to quit the absorption phase Expert 1160 Maximal frequency of absorption control Expert 1161 Minimal delay since last absorption Expert 1452 Phase of equalization Expert 1163 Equalization allowed Expert 1162 Force equalization Expert 1291 Equalization before absorption phase Expert 1290 Equalization current Expert 1164 Equalization voltage Expert 1165 Equalization duration ONLY LEVEL BOOL FLOAT FLOAT BOOL BOOL ENUM FLOAT INT32 INT32 ONLY LEVEL BOOL FLOAT FLOAT ONLY LEVEL FLOAT ONLY LEVEL BOOL BOOL FLOAT FLOAT F
32. t_id property_id value is response true READ PROPERTY SYSTEM STATE 3000 value 23 453125 error false 02 01 0100 B80B0000 0100 OOAOBB41 V1 3 1 16 25 hs TUDER Technical specification Xtender serial protocol Total number of bytes 14 14 2 30 bytes 5 3 Write the qsp value of a parameter Set the battery charge current at 12 0 A generated by the command 2Scom exe port COM3 verbose 3 write property object type 2 object id 1138 property id 5 format FLOAT value 12 0 src addr 1 dst addr 101 Request data start frame src dst addr length header_ data byte flags addr 1 101 id checksum checksum OxAA 00 01000000 65000000 7379 14 bytes FF9B flags service id object type object id property id property data 12 0 is response WRITE PARAMETER 1138 value qsp false PROPERTY error false 00 02 0200 72040000 0500 00004041 Total number of bytes 14 14 2 30 bytes Response data start frame src dst addr length header_ fram data data byte flags addr 1 101 _ 16 checksum checksum OxAA 00 65000000 01000000 0A00 6F01 10 bytes Ox80F6 flags service_id object_type object_id property_id is_response WRITE PARAMETER 1138 value qsp true PROPERTY error false Total 02 02 0200 72040000 05
33. tact activated with the SOC 1 of battery AUX 1 Contact activated below SOC 1 AUX 1 Delay 1 AUX 1 Contact activated with the SOC 2 of battery AUX 1 Contact activated below SOC 2 AUX 1 Delay 2 AUX 1 Contact activated with the SOC 3 of battery AUX 1 Contact activated below SOC 3 AUX 1 Delay 3 AUX 1 Contact deactivated over SOC AUX 1 Delay to deactivate AUX 1 Deactivate if battery in floating phase AUX 1 Security maximum time of contact AUX 1 Maximum time of operation of contact AUX 1 Reset all settings AUX 1 AUXILIARY CONTACT 2 Operating mode AUX 2 Combination of the events for the auxiliary contact AUX 2 Temporal restrictions AUX 2 Program 1 AUX 2 Day of the week AUX 2 Start hour AUX 2 End hour AUX 2 Program 2 AUX 2 Day of the week AUX 2 Start hour AUX 2 End hour AUX 2 Program 3 AUX 2 Day of the week AUX 2 Start hour AUX 2 End hour AUX 2 Program 4 AUX 2 Day of the week AUX 2 Start hour AUX 2 End hour AUX 2 BOOL FLOAT FLOAT BOOL FLOAT FLOAT FLOAT FLOAT BOOL ONLY LEVEL BOOL FLOAT FLOAT BOOL FLOAT FLOAT BOOL FLOAT FLOAT FLOAT FLOAT ONLY LEVEL BOOL FLOAT FLOAT ONLY LEVEL BOOL FLOAT FLOAT BOOL FLOAT FLOAT BOOL FLOAT FLOAT FLOAT FLOAT BOOL BOOL FLOAT INT32 ONLY LEVEL ENUM BOOL ONLY LEVEL ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM INT32 INT32 ONLY LEVEL ENUM
34. ttery history INT32 Basic 6004 Restore default settings INT32 Inst 6005 Restore factory settings INT32 Expert 6016 ADVANCED SETTINGS ONLY LEVEL Expert 6031 Reset of user counters INT32 Expert 6019 Self discharge rate FLOAT Expert 6020 Nominal temperature FLOAT Expert 6021 Temperature coefficient FLOAT Expert 6022 Charge efficiency factor FLOAT Expert 6023 Peukert s exponent FLOAT Expert 6042 Activate the end of charge synchronization BOOL Expert 6024 End of charge voltage level FLOAT Expert 6025 End of charge current level FLOAT Expert 6026 Minimum duration before end of charge FLOAT V1 3 1 24 25 Ms TUDER Technical specification Xtender serial protocol 6 3 RCC parameters User Level ref Parameter Scom format Basic 5000 Language ENUM Expert 5036 Other languages ONLY LEVEL Basic 5038 Choice of the second language ENUM Basic 5039 Choice of the third language ENUM Basic 5040 Choice of the fourth language ENUM Basic 5001 Time INT32 Basic 5002 Date INT32 Basic 5003 Day FLOAT Basic 5004 Month ENUM Basic 5005 Year FLOAT V O 5012 User level Not supported Expert 5019 Force remote control to user BASIC level INT32 Expert 5057 Datalogger ONLY LEVEL Expert 5058 Datalogger enabled BOOL Expert 5059 Save today s datas INT32 Basic 5013 Save and restore files ONLY LEVEL Basic 5041 Save all files system backup INT32
35. uced floating voltage Phase of periodic absorption Periodic absorption allowed Periodic absorption voltage Reduced floating duration before periodic absorption Periodic absorption duration INVERTER Inverter allowed AC Output voltage AC voltage increase according to battery voltage Max AC voltage increase with battery voltage Inverter frequency Inverter frequency increase when battery full Inverter frequency increase according to battery voltage Max frequency increase Speed of voltage or frequency change in function of battery Standby and turn on Standby level Time delay between standby pulses Standby number of pulses Softstart duration Solsafe presence Energy source at AC Out side Modulator soll AC IN AND TRANSFER Transfer relay allowed Delay before closing transfer relay Smart Boost allowed Maximum current of AC source Input limit Max input current modification Use an alternate max input current Second maximum current of AC source Input limit Decrease max input limit current with AC In voltage Decrease max input limit activated by remote entry AC input low limit voltage to allow charger function Adaptation range of the input current according to the input voltage Speed of input limit increase Charge current decrease coef at voltage limit to turn back in inverter mode Overrun AC source current limit without opening the transfer relay Input limit Type of detection of AC input loss UPS Tolerance on detection of AC input loss
36. with the following frame data service flags service id object type object id property id property data 0x02 or 0x03 0x01 2 bytes 4 bytes 2 bytes N bytes flags service id object type object id property id property data flags response 1 error 0 or 1 0x01 for READ PROPERTY same as the request same as the request same as the request If error 0 the value of the property in the type of the property If error 1 two bytes identifying the error code V1 3 1 Ms TUDER 7 25 Technical specification Xtender serial protocol 4 2 2 WRITE PROPERTY service This service is used to write an object s property The DTE sends a request frame with the following frame data flags service id object type object id property id property data 0x00 0x02 2 bytes 4 bytes 2 bytes n byte flags ds response 0 error 0 service id 0x02 for WRITE PROPERTY object type the object type identifier defined later in this document object id the object identifier specific to each object type i e two objects with different types can have the same id property id identify the property in the object property data the data in the right data type The RCC responds with a frame with the following frame data service flags service id object type object id property id error id 0x02 or 0x03 0x02 2 bytes 4 bytes 2 bytes 0 or 2
Download Pdf Manuals
Related Search