Technical Manual. Standard Communication Protocol TA3840C

Transcription

1 TA3840C Technical Manual SAS au Capital de R.C.S. Bourges - APE : 2651B Headquarter : 9, rue Isaac Newton Bourges - France

2 Technical Manual TA3840C 1 st Edition Released February 2013

3 Revision Page Rev. Date Paragraphs Modifications 00 26/07/ First issue 01 13/12/ , Clarifications regarding partially signed words Moving of enable bits in #2777; clarifications on intermediates 1 values for scaling Moving of enable bit in #15683; clarifications on intermediates 1 values for scaling 02 09/08/ Addition of 3 rd alarm limit on IG pressure; addition of Monitoring communication control 3.5 Addition of On/Off input and relay status 03 27/04/ Addition of HC gas transmitter zero line, alarm limits, enabling, measurement 04 29/02/ Correction for words 2678 / /10/ Addition of fault flags in #2866, /03/2013 all Change company name

4 TABLE OF CONTENTS 1. GENERAL PRESENTATION HARDWARE CONFIGURATION COMMUNICATION PROTOCOL General structure of frames Frames definition Description of the general system datas Description of datas related to the Radar transmitters Description of the datas related to the 4-20 ma analog transmitters... 15

5 1. GENERAL PRESENTATION The TA3840C Communication Unit is described in the document MT5008 (Technical Manual). This document describes the addresses table used by the communication protocol Modbus RTU between this Communication Unit TA3840C, and a main supervision system. Supervision System TA3840C Communication Unit RS232 or RS485 or RS422 The communication is performed by the way of a serial link according to the MODBUS RTU master / slave protocol. 2. HARDWARE CONFIGURATION The serial link uses one of the four isolated ports available on the rear face of the TA3840C rack : - Monitoring 1 or 2 ports, or TA3840R, RS232 type on Sub-D 9 pins connector for a cable length 10 m or RS485 (2 wires) or RS422 (4 wires) type for a cable length up to 1200 m; - Auxiliary port with Modbus RTU protocol, RS232 type on Sub-D 9 pins connector for a cable length 10 m or RS485 (2 wires) type for a cable length up to 1200 m. The serial link type RS232, RS485 or RS422 is selected by jumpers located on the supply electronic board of the TA3840C. See next page for details. The dialog frames are composed of words of 10 bits each : - 1 start bit - 8 data bits (no parity) - 1 stop bit The TA3840C Unit address is settable from 1 to 8; the baudrate is settable from 1200 to bauds for the Monitoring 1 or 2 ports, 1200 to bauds for the TA3840R and Auxiliary ports (default 9600 bauds). TA3840C Technical Manual 3

6 Monitoring 2 port Monitoring 1 port TA3840R port JP2/3 jumpers for read / write reverse in RS232 mode JP4 jumper for communication type selection Left=RS232 JP5 for RS485 / RS422 selection, Left=RS485 JP8 jumper for communication type selection Left=RS232 JP9 for RS485 / RS422 selection, Right=RS485 JP6/7 jumpers for read / write reverse in RS232 mode JP10/11 jumpers for read / write reverse in RS232 mode JP12 jumper for communication type selection Left=RS232 JP13 for RS485 / RS422 selection, Left=RS485 Auxiliary port JP14/15 jumpers for read / write reverse in RS232 mode JP16 jumper for communication type selection Left=RS232 TA3840C Technical Manual 4

7 3. COMMUNICATION PROTOCOL 3.1. General structure of frames The dialogues are initiated by the supervisor operating as master, while the TA3840C Communication Unit operates as slave : the supervisor asks a question to the TA3840C, which answers with required data. The "question" frame general structure is as follow : Question : Slave n Function code Data Control word CRC 16 (n bytes) This byte selects the command : - 3 or 4 : read n words - 6 : write 1 word - 16 : write n words These n bytes define : - The address of the 1 st word - The value of the word(s) - The number of words The "answer" frame general structure is as follow : Answer : Slave n Function code Data (n bytes) Control word CRC 16 These n bytes define : - The value of the read words - The value of the written words - The number of words TA3840C Technical Manual 5

8 Message control : The control word CRC 16 is calculated by the emitter of a message. Upon receipt of the last byte, the receiver calculates also the CRC 16 of the received frame, and doesn't answer to the question if the CRC16 word is found to be different. When the control word CRC 16 is correct, but if the receiver doesn't recognize the question (wrong address or data), it sends back the function code with the most significant bit (bit 7) to 1, followed by a byte defining the error type : Slave n Function Code (with bit 7 at 1) Error Code Control word CRC 16 Byte value : - 1 : Unknown function code - 2 : Wrong address - 3 : Wrong data CRC 16 control word calculation method : Initiate the CRC 16 at FFFF (hexadecimal) Do from the 1 st byte to the last one CRC Xor byte -> CRC Do 8 times Shift the CRC by one bit to the right If the output bit is equal to 1, do CRC Xor A001 -> CRC End do End do The least significant byte of CRC 16 is sent in first, followed by the most significant byte : Example of question with CRC 16 (HEX) = C8 55 : C8 TA3840C Technical Manual 6

9 3.2. Frames definition Read n words : function code = 3 or 4 Question: Slave n Function code = 3 or 4 Address of the 1st word msb, lsb Number of words 127 maximum Control word CRC 16 Answer: Slave n Function code = 3 or 4 Number of read bytes 1st word read.. Last word read Control word CRC Write one word : function code = 6 Question: Slave n Function code = 6 Address of the word msb, lsb Value of the word Control word CRC 16 Answer: The answer frame is identical to the question frame Write n words : function code = 16 Question: Slave n Function code = 16 Addr. of the 1st word msb, lsb Number of words Number of bytes Value of the 1st word. Control word CRC 16 Answer: Slave n Function code = 16 Address of the 1st word msb, lsb Number of words Control word CRC 16 TA3840C Technical Manual 7

10 3.3. Description of the general system data The hereunder table shows the content of the different available addresses related to the general parameters of the TA3840C : Address Type Description TA 3840C 1 Word TA3840C MODBUS slave number (1 to 8) 2 Word TA3840C Software release (3 digits) 3 Word Year of revision (2 digits) 4 Word Month + day of revision (2 + 2 digits) 5 Words Reserved Word Name of the vessel or hull number 1 (2 ASCII characters) 67 Word Name of the vessel or hull number 2 (2 ASCII characters) 68 Word Name of the vessel or hull number 3 (2 ASCII characters) 69 Words Reserved Word High/High alarm limit on cargo inert gas pressure 81 Words Reserved Word Current year + month (2 + 2 digits) 87 Word Current day + hour (2 + 2 digits) 88 Word Current minutes + seconds (2 + 2 digits) 89 Word Atmospheric pressure in 1/10 mbar (5 digits) 90 word Trim in cm (4 digits) 91 word Heel in 1/100 (4 digits) 92 word Trim angle in 1/100 (4 digits) 93 Word Reserved 94 Word Oldest fault record address 95 Word Number of fault records (from 0 to 100) 96 Word Year + month 97 Word Day + hour 98 Word Minute + second 99 Word Address + error code 100 Words Same (4 words per record) Word Bending rate in cm Words Reserved 499 Word Flag for communication fault with Monitoring 1, 2 (2 bits) 500 Words Reserved Words 50 volume tables of 10 points, n table, height in mm (5 digits) / 2055 volume in m3 then in l (8 digits) - 31 words in total 2056 Words Reserved 2675 TA3840C Technical Manual 8

11 Modbus slave number of the Communication Unit #1 : from 1 to 8; Release index and date of the TA3840C software #2, #3 et #4 : release (without dot) and year in the least significant byte, month in the most significant byte, day in the least significant byte; these data are engraved in the EPROM; so even modified, they are restored when power is set on; Name or hull number of the Vessel #66 to #68 : 6 ASCII characters, 2 per address with 1 st letter in the most significant byte of #66 and so on; Example : the name «VESSEL» is encoded : (#66) HEX = 5645, (#67) HEX = 5353 and (#68) HEX = 454C; High / High alarm limit on inert gas pressure measurement connected on Radar #80 : signed word; Current date #86 to #88 : year, day and minutes in the most significant byte, month, hours and seconds in the least significant byte; this date can be initiated, but later it is refreshed by the TA3840C; Environment data #89 to #92 : atmospheric pressure in 1/10 mbar, Trim in cm, Heel in 1/100, Trim angle in 1/100, used values for the measurements corrections; they can be initiated but later they are refreshed by the TA3840C; System faults Historical #94 to #495 : the chronological list of faults is sliding from the word 96; the year, the day the minute and the address are in the most significant byte; Vessel bending rate value #496 : it is calculated in cm from the measurements of the drafts; COM1 and COM2 communication status #499 : least to most significant bit in the indicated order; Volume tables from #506 to #2055 : 50 tables of 31 words each, each table includes an index from 1 to 50, then 10 x 3 words respectively for the height in mm, the relevant volume in m 3 then in liters for 10 points dispatched on the height of the table; TA3840C Technical Manual 9

12 3.4. Description of data related to the Radar transmitters The hereunder table shows the content of the different available addresses regarding the parameters of the Radar transmitters, from the transmitter n 1; the following transmitters are on the addresses modulo 203 : Address Type Description Transmitter Radar n Word Address of the Radar transmitter (2 digits) 2677 Word Reserved 2678 Word Name1 of the tank or HC gas transmitter (2 characters ASCII) 2679 Word Name2 of the tank or HC gas transmitter (2 characters ASCII) 2680 Words Reserved word Offset in mm (5 digits) 2722 word Zero line in mm (5 digits) 2723 Words Reserved Word Density for Radar in hg/m3 (5 digits) 2727 Words Reserved Word Name1 of the analog transmitter 1 (2 characters ASCII) 2736 Word Name2 of the analog transmitter 1 (2 characters ASCII) 2737 Word Name1 of the analog transmitter 2 (2 characters ASCII) 2738 Word Name2 of the analog transmitter 2 (2 characters ASCII) 2739 Word Name1 of the analog transmitter 3 (2 characters ASCII) 2740 Word Name2 of the analog transmitter 3 (2 characters ASCII) 2741 Words Reserved word Zero line of the analog transmitter 1 in mm or HC gas transmitter (5 digits) 2748 word Zero line of the analog transmitter 2 in mm (5 digits) 2749 word Zero line of the analog transmitter 3 in mm (5 digits) 2750 Words Reserved Word Density for the analog transmitter 1 in hg/m3 (5 digits) 2760 Word Density for the analog transmitter 2 in hg/m3 (5 digits) 2761 Word Density for the analog transmitter 3 in hg/m3 (5 digits) 2762 Word Level alarm 1 en mm (5 digits) 2763 Word Level alarm 2 en mm (5 digits) 2764 word Average temperature alarm 1 in tenth of C (4 digits) 2765 word Average temperature alarm 2 in tenth of C (3 digits) 2766 Word Level and average temperature alarm types (1 + 1 digits) TA3840C Technical Manual 10

13 Address Type Description Transmitter Radar n Word Analog transmitter 1 alarm 1 or HC gas transmitter (5 digits ) 2768 Word Analog transmitter 1 alarm 2 or HC gas transmitter (5 digits ) 2769 Word Analog transmitter 2 alarm 1 (5 digits ) 2770 Word Analog transmitter 2 alarm 2 (5 digits ) 2771 Word Analog transmitter 3 alarm 1 (5 digits ) 2772 Word Analog transmitter 3 alarm 2 (5 digits ) 2773 Word Analog transmitters 1, 2, 3 alarm types ( digits) 2774 Words Reserved Flags for Radar or HC gas transmitter, temperatures H, M, L, analog tr. 1, 2, 3 enable (7 bits) 2778 Words Reserved Word Distance in mm (5 digits) 2818 word Temperature High in tenth of C (4 digits) 2819 word Temperature Middle in tenth of C (4 digits) 2820 word Temperature Low in tenth of C (4 digits) 2821 word Temperature High user scale in tenth of C (4 digits) 2822 word Temperature Middle user scale in tenth of C (4 digits) 2823 word Temperature Low user scale in tenth of C (4 digits) 2824 Word Reserved 2825 Word "Ullage" in mm (5 digits) 2826 Word "Innage" in mm (5 digits) 2827 Word Corrected Ullage en mm (5 digits) 2828 Word Corrected Innage in mm (5 digits) 2829 Word Volume in m Word Volume in l 2831 Word Mass in T 2832 Word Mass in kg 2833 word Average temperature in tenth of C (4 digits) 2834 Word ADC code measurement from analog tr. 1 or HC gas transmitter (4 digits) Measurement from analog tr. 1 or HC gas transmitter in user scale ( Word digits) 2836 Word Corrected measurement (5 digits) 2837 Word Intermediate Value 1-1 TA3840C Technical Manual 11

14 Address Type Description Transmitter Radar n word Intermediate Value word Intermediate Value Word Volume in m Word Volume in l 2842 Word Mass in T 2843 Word Mass in kg 2844 Word ADC code measurement from analog tr. 2 (4 digits) 2845 Word Measurement from analog tr. 2 in user scale (5 digits) 2846 Word Corrected measurement (5 digits) 2847 Word Intermediate Value word Intermediate Value word Intermediate Value Word Volume in m Word Volume in l 2852 Word Mass in T 2853 Word Mass in kg 2854 Word ADC code measurement from analog tr. 3 (4 digits) 2855 Word Measurement from analog tr. 3 in user scale (5 digits) 2856 Word Corrected measurement (5 digits) 2857 Word Intermediate Value word Intermediate Value word Intermediate Value Word Volume in m Word Volume in l 2862 Word Mass in T 2863 Word Mass in kg 2864 Word Reserved 2865 Word Fault flags : location fault non acknowledged and acknowledged, internal diagnosis non acknowledged and acknowledged, distance measurement fault non acknowledged and acknowledged, communication fault non acknowledged and acknowledged (12 bits) TA3840C Technical Manual 12

15 Address Type Description Transmitter Radar n Word Fault flags : invalid distance measurement fault non acknowledged and acknowledged, invalid temperature measurements faults non acknowledged and acknowledged, invalid analog measurements faults non acknowledged and acknowledged, average temperature measurement fault (15 bits) 2867 Word Flags : alarms 1 et 2 level, temperature, non ack. and ack. (8 bits) 2868 Word Flags : alarms 1 et 2 analog inputs, alarm 3 analog input 1, non ack. and ack. (14 bits) 2869 Words Reserved End for Radar transmitter n 64 : word over : Not signed word for level measurement, signed for all other measurements Slave number of the Radar #2676 : address for communication with the TA3840C by special protocol in the most significant byte; WARNING : the least significant byte is reserved; Name of the tank where the Radar is installed #2678 et #2679 : 4 ASCII characters, 2 per address with 1 st letter in the most significant bit #2678; Example : the name of channel 1 «WB1P» is encoded : (#2678) HEX = 5742 and (#2679) HEX = 3150; Offset #2721 : difference in mm between the Radar flange and the tank ullage measurement reference; Zero line #2722 : difference in mm between the tank bottom seen by the Radar and the relevant point of the volume table; Density #2726 : density in hg/m 3 of the product in the tank; Name of the measurements by the analog transmitters connected to the Radar #2735 to #2740 : 4 ASCII characters, 2 per address with the 1 st letter of the transmitter 1 in the most significant byte of #2735; Example : the name of the channel 1 «WB1P» is encoded : (#2735) HEX = 5742 and (#2736) HEX = 3150; Offset of the analog transmitters connected to the Radar or HC gas transmitter on input 1 #2747 to #2749 : for a level measurement, difference in mm between the zero value of the measurement and the tank bottom or the relevant point of the volume table; zero difference for the other measurements, in 1/10 C for a temperature measurement, in 1/10 mbar for a low pressure measurement, in 1/100 bar for a high pressure measurement, in 1/100 for an angle measurement; Density for a level measurement by the analog transmitter connected to the Radar #2759 to #2761 : density en hg/m 3 of the product in the tank; TA3840C Technical Manual 13

16 Level alarm limits #2762 et #2763 : limits in mm of the alarms, alarm 1 = the lowest, 2 = the highest; the type H/HH, L/H or LL/L is defined in #2766; signed word over 50000; Average temperature alarm limits #2764 et #2765 : limits in 1/10 C of the alarms, alarm 1 = the lowest, 2 = the highest; the type H/HH, L/H or LL/L is defined in #2766; Alarm type for the level and average temperature #2766 : level alarm type in the least significant digit, temperature in 2 nd digit; 0 = no alarm, 1 = H/HH, 2 = L/H, 3 = LL/L; Alarm limits of the analog transmitters connected to the Radar or HC gas transmitter on input 1 #2767 to #2772 : limits in unit according to the relevant type of measurement, alarm 1 = the lowest, 2 = the highest; the type H/HH, L/H or LL/L is defined in #2773; these words are not signed for a level measurement, and signed for any other measurements; Alarm type for the analog transmitters connected to the Radar #2773 : alarm type for the transmitters 1, 2, 3 in successive digits from the least significant digit; 0 = no alarm, 1 = H/HH, 2 = L/H, 3 = LL/L; Enable of the Radar or HC gas transmitter, and the transmitters connected #2777 : least significant bit to most significant bit in the indicated order; Values of the current measurements by the Radar transmitter #2817 to #2820 : distance in mm, then the 3 raw spot temperatures H then M then B in 1/10 C; the word #2817 is signed over 50000; Values oft the spot temperatures #2821 to #2823 : values in user scale in tenth of C; Values "Ullage" and "Innage" #2825 to #2828 : raw calculated values and corrected by Trim and Heel in mm; the words #2826 and 2828 are signed over 50000; Volume and mass # 2829 to #2832 : calculated values in indicated units; Value of the average temperature #2833 : calculated value in tenth of C, from the submerged probes; ADC value of the measurement from the analog transmitter connected in position 1 on the Radar or HC gas transmitter #2834; Value of the measurement by the analog transmitter connected in position 1 on the Radar or HC gas transmitter #2835 : value in user scale according to the nature of the relevant measurement; this word is not signed for a level measurement, and signed for any other measurement; the used units are : mm for a level, 1/10 C for a temperature, 1/10 mbar for a low pressure, 1/100 bar for a high pressure, 1/100 for an angle; Value of the measurement by the analog transmitter connected in position 1 on the Radar #2836 and #2837 : value corrected by Trim and Heel in mm for a level measurement, and intermediate value 1; these words are not signed for a level measurement, and signed for any other measurements; the intermediate 1 value contents the result of the just scaled measurement, without further calculation (atmospheric pressure correction, level from hydrostatic measurement calculation), except for the drafts; Intermediate 2 and 3 values for the measurement by the analog transmitter connected in position 1 on the Radar #2838 et #2839 : calculated values in mm for a level measurement; Volume and mass # 2840 to #2843 : calculated values in indicated units for a level measurement; #2840 contents the result of the just scaled measurement, without further calculation, for the drafts; TA3840C Technical Manual 14

17 Values of the measurements by the analog transmitter connected in position 2 and 3 on the Radar #2844 to #2863 : organization of the data identical to these from the transmitter in position 1; Operating faults flags #2865 : least to most significant bits in the indicated order, for the location, internal diagnosis, distance measurement faults non acknowledged and acknowledged; Measurement faults flags #2866 : least to most significant bits in the indicated order, for the distance, temperature, analog transmitters connected to the Radar measurement validity faults, non acknowledged and acknowledged, for the average temperature measurement fault display; Alarm flags #2867 et #2868 : least to most significant bits in the indicated order, for the alarms 1 and 2 of distance, temperature, analog transmitter connected to the Radar measurements, for alarm 3 of analog transmitter 1, non acknowledged and acknowledged; 3.5. Description of the data related to the 4-20 ma analog transmitters The hereunder table shows the content of the different available addresses regarding the parameters of the analog transmitters 4-20 ma, from the transmitter n 1; the following transmitters are on the addresses modulo 47 : Address Type Description 4-20 ma analog Transmitter n Word Address of the transmitter (2 digits) Word Reserved Word Name1 of transmitter (2 characters ASCII) Word Name2 of transmitter (2 characters ASCII) Words Reserved word Zero line in mm (5 digits) Words Reserved Word Density in hg/m3 (5 digits) Word Alarm 1 (5 digits ) Word Alarm 2 (5 digits ) Word Alarm Type (1 digit) Word Reserved Word Flag for enable (1 bit) Words Reserved Word Measurement ADC Code Word Measurement in current in µa (5 digits) Word Measurement in user scale (5 digits) or On/Off input or relay status Word Corrected measurement (5 digits) TA3840C Technical Manual 15

18 Address Type Description 4-20 ma analog Transmitter n Word Intermediate Value word Intermediate Value word Intermediate Value Word Volume in m Word Volume in l Word Mass in T Word Mass in kg Word Flags : reserved, measurement validity fault non acknowledged and acknowledged, communication fault non acknowledged and acknowledged, measurement alarm 1 and 2 non acknowledged and acknowledged (9 bits) Words Reserved End of analog transmitter 4-20 ma n 96 Slave number #15668 : address for communication with the TA3840C by special protocol in the least significant byte; Name of the measurement #15670 and #15671 : 4 ASCII characters, 2 per address with the 1 st letter of the transmitter 1 in the most significant byte of #15670; Example : the name of the channel 1 «WB1P» is encoded : (#15670) HEX = 5742 and (#15671) HEX = 3150; Offset #15674 : for a level measurement, difference in mm between the zero value of the measurement and the tank bottom or the relevant point of the volume table; zero difference for the other measurements, in 1/10 C for a temperature measurement, in 1/10 mbar for a low pressure measurement, in 1/100 bar for a high pressure measurement, in 1/100 for an angle measurement; Density for a level measurement #15678 : density en hg/m 3 of the product in the tank; Alarm limits #15679 et #15680 : limits in unit according to the relevant type of measurement, alarm 1 = the lowest, 2 = the highest; the type H/HH, L/H or LL/L is defined in #15681; these words are not signed for a level measurement, and signed for any other measurements; Alarm type #15681 : alarm type in the least significant digit; 0 = no alarm, 1 = H/HH, 2 = L/H, 3 = LL/L; Transmitter enable #15683 : least significant bit; the other bits are reserved; ADC value of the measurement #15693; Value of the measurement #15694 : value in µa of the measurement; Value of the measurement #15695 : value in user scale according to the nature of the relevant measurement; this word is not signed for a level measurement, and signed for any other measurement; the used units are : mm for a level, 1/10 C for a temperature, 1/10 mbar for a low pressure, 1/100 bar for a high pressure, 1/100 for an angle; On/Off input status or relay status; TA3840C Technical Manual 16

19 Value of the measurement #15696 et #15697 : value corrected by Trim and Heel in mm for a level measurement, and intermediate value 1; these words are not signed for a level measurement, and signed for any other measurements; the intermediate 1 value contents the result of the just scaled measurement, without further calculation (atmospheric pressure correction, level from hydrostatic measurement calculation), except for the drafts, or On/Off input status; Intermediate 2 and 3 values #15698 et #15699 : calculated values in mm for a level measurement; Volume and mass #15700 to #15703 : calculated values in indicated units for a level measurement; #15700 contents the result of the just scaled measurement, without further calculation, for the drafts; Channel status #15704 : least to most significant bits in the indicated order for enable, reserved then communication fault, measurement validity fault, alarms 1 and 2, non acknowledged and acknowledged; TA3840C Technical Manual 17

20 Honeywell Marine SAS 9, Rue Isaac Newton Bourges France Tel + 33 (0) Fax + 33 (0) contact.marine@honeywell.com ST1128E-rev07-ENG February Honeywell International Inc.