Campbell Hausfeld SDM-SIO4 manual

SDM-SIO4 4-Channel Serial I/O Interface User Guide Issued 17.3.97 Copyright  1997 Campbell Scientific Ltd.[...]

[...]

Guarantee This equipment is guaranteed against defects in materials, workmanship, and software. This guarantee applies for twelve months from date of deliv ery. We will repair or replace products which prove to be defective during the guarantee period provided they are returned to us prepaid. The guaran tee will not apply to: • Equipment which ha[...]

[...]

i Contents Section 1. Introduction ..................................................... 1-1 1.1 What is the SDM-SIO4? .................................................................................1-1 1.2 Specifications .................................................................................................1-3 1.2.1 Serial Ports .......[...]

ii 5.2.6 Command 5: Status ............................................................................. 5-4 5.2.7 Command 6: Flush Transmit Buffer.................................................... 5-5 5.2.8 Command 7: Activate Command Line ................................................ 5-5 5.2.9 Command 8: Poll Tx Buffers for Data ............[...]

1- 1 Section 1. Introduction The SDM-SIO4 has four configurable serial RS232 ports which allow it to be connected to intelligent serial sensors, display boards, printers or satellite links. It can also be used in many other applications where the data is transferred in a serial fashion. This device is designed to send data to and receive data from [...]

SDM-SIO4 4-Channel Ser ial I/O Interface User G uide 1-2 Switches - Go to 1 if command line active To Other Ports To Other Ports 1 PORT Handshak e Control Tx Buffe r Rx B uffe r Command Line Control Datalogge r Command Control CRC/SIG Driver Format Driver & User Strings CRC/SIG Driver Filter Driver Converted Data Buff er 1 0 0 K K K Handshake L[...]

Section 1 . Introduction 1- 3 1.2 Specifications 1.2.1 Serial Ports The SDM-SIO4 has four serial ports which can be configured independently to use different serial data formats and baud rates (from 25 to 115,200 baud). These ports are 0-5V logic or ±5V for RS232 and are configured similar to a PC ‘AT’ style DTE serial port. Handshaking, to co[...]

SDM-SIO4 4-Channel Serial I/O Interface User Guide 1- 4 1.2.2 SDM Port This serial port is to connect to the SDM port of the datalogger, e.g. via C1, C2 and C3 on a CR10X. The port is a set of screw terminals marked C1, C2, C3, I/O, +12 and G. C3 is the Synchronous Device Enable line, C1 is the Data line, C2 is the Clock line and I/O is a special-p[...]

Section 1 . Introduction 1- 5 1.2.6 Other Key Features • An internal lithium battery which retains configuration information (estimated life 10 years) • A built-in system watchdog which will reset the processor in the event of a crash caused by transients, etc. • A multi-tasking operating system allowing concurrent transmission and receipt of[...]

[...]

2- 1 Section 2. Installation and Hardware Set-Up The SDM - SIO4 is designed to be mounted on an enclosure chassis plate using the two mounting holes in the tabs on the side of the case . Before installation, it is necessary to set up the address of the SDM-SIO4 and also the mode of operation of each serial port. These settings are determined by jum[...]

SDM-SIO4 User Guide 2- 2 2.2 Selecting RS232 or 5V Logic for Each Port The output voltage levels of each serial port can be set to either: • Logic level output: +5V (high) / 0V (low) or • RS232 output: +5V (high) / -5V (low) (compatible with RS232 driver requirements). The logic level output is used when driving a logic level compatible device,[...]

Section 2. Installation and Hardware Set-Up 2- 3 • Electrical noise causing possible loss or corruption of serial data. • Electrical noise being transferred back to the datalogger causing errors on analogue measurements. • Long term damage in the form of corrosion caused by current flowing along electro-chemical gradients. If it is not possib[...]

[...]

3-1 Section 3. Understanding How the SDM-SIO4 Handles Data For simple applications the SDM-SIO4 can be configured and controlled from the datalogger alone, using the datalogger program instruction P113 (CR10X and CR7 dataloggers only). Future developments will include support for other dataloggers. More complicated applications require configuratio[...]

SDM-SIO4 User Guide 3-2 The hex. number must always be t wo ASCII charact ers. Control characters can be entered for all commands in a similar way: • ^M is carriage return, ^J line feed etc. • ^^ means ^ • "" means " • ]] means ] • && means & • &0d means line feed • &hex,hex used to enter 2-character[...]

Section 3. Understanding How the SDM- SIO4 Handles Data 3-3 See Section 5 – ‘P rogramming the Datalogger’. Filter Strings These are used to defin e how to filter incoming data from a port into a format the datalogger can use. This is done by having a user-defined filter s tring pre-stored in the battery-backed memory of the SDM-SIO4. These st[...]

SDM-SIO4 User Guide 3-4 • i[ ] Scan until any ASCII ch aracters entered between the br ackets are encountered. The maximum number of characters bet ween the brackets is 255. Note that this filter doe s not remove the match ed character from the buffer. • n n Discard ‘n’ bytes . ‘n’ can be in the range of 0-255. • N n Read ‘n’ byte[...]

Section 3. Understanding How the SDM- SIO4 Handles Data 3-5 2. n8 discards everyt hing up to 12.65V. 3. F converts the number t o Campbell S cientific floating point . If a valid number is not found -99999 i s sent to the datal ogger. 4. i[c] waits for the trigger character ‘c’ of ‘current’. 5. n8 discards everyt hing up to 12mA. 6. F conve[...]

SDM-SIO4 User Guide 3-6 • Convert a locati on sent into a 16-bi t binary word. If this option is s elected an extra ASCII character/delimiter can be added to the end of the 16-bit word sent. See Section 5 – ‘P rogramming the Datalogger’. 3.3.2 Output Format Strings These allow either j ust long st rings to be s ent from the SDM-S IO4 or a c[...]

Section 3. Understanding How the SDM- SIO4 Handles Data 3-7 Table 4 Fixed Strings Currently Allocated String number String (e nclosed in quotes) 256 ‘+0000000000123.45670000000000CrLf’ 257 ‘Voltage’ 258 ‘Amps’ 259 ‘Watts ’ 260 ‘Joules’ 261 ‘Temperature’ 262 ‘Pressure’ 263 ‘Speed’ 264 ‘Power’ 265 ‘Depth’ 266 ?[...]

SDM-SIO4 User Guide 3-8 z273 – This outputs the fixed string ‘C rLf (carriage return line feed)’. *Table 1 Program 01: 2 Execution Interval (seconds) ;get battery voltag e. 1: Batt Voltage (P10) 1: 2 Loc [ Batt_v ] ;get panel temperat ure. 2: Internal Temperature (P17) 1: 1 Loc [ Temp_C ] ;send batter y voltage and t emperatur e to port 2 on [...]

4-1 Section 4. Programming the SDM-SIO4 This section gives both the basic commands and advanced comm and line options which allow testing and advanced configuration of the SDM-SIO4. 4.1 Command Line Operation and Structure To use the command line mode, connect a computer to port 1 of the SDM-SIO4. The computer should run a termi nal emulation progr[...]

SDM-SIO4 User Guide 4- 2 Control characters can be entered for all commands in a similar way: • ^M is carriage return, ^J line feed etc. • ^^ means ^ • "" means " • ]] means ] • && means & • &0d means line feed • &hex,hex used to enter 2-character hex. codes (0-9, A-F) 4.3 Basic Commands fltst [strin[...]

Section 4. Programming the SDM- SIO4 4-3 because they are compiled. exit This command exits the command lin e and returns port 1 of the SDM-SIO4 to normal operation. 4.4 Advanced Commands version This returns t he internal EPR OM part number, signat ure and the string s ignature if good or 0 if bad. This will give the same signature as Campbell Sci[...]

SDM-SIO4 User Guide 4- 4 WD n WDERR n WDADDR n WD n is a count of the number of watchdog resets, WDER R is the number of the last task that crashed and W DADDR is the address at which the crash was found. NC 0-9 This is t he number of SDM commands the datalogger sent t o the SDM-S IO4 that the SDM-SIO4 did not recognise. This counter may be increme[...]

Section 4. Programming the SDM- SIO4 4-5 testio [test#] This is used by Camp bell Scientific for test purp oses. Each test command is carried out for 2 seconds. Test# can be in the range 0-255; only five test numbers are currently valid, as shown below. testio returns test 0 DTR,RTS,I O=LOW test1 DTR=HIGH,RTS,IO=LOW test2 DTR=LOW,RTS=HIGH,IO=LOW te[...]

[...]

5-1 Section 5. Programming the Datalogger The datalogger instruction specific to the SDM-SIO4 is P113 (CR7 and C R10/10X only). (Please check with Campbell Scientific to see if your version of the operating system supports this.) The instruction has the following format: Parameter No. Description 01 Reps (number of adjacent addressed SDM-SIO4s) 02 [...]

SDM-SIO4 User Guide 5-2 5.1.5 Parameter 7 — Values per Rep This determines how many values to send or receive, starting from the specified input location (paramet er 8). Data can be either 4-byte floating point val u es or single bytes , determined by the SDM-SIO4 command number. Some commands require no input or output of values; for these comma[...]

Section 5. Programming the Datalogger 5-3 5.2.1 Under standi ng Par ameter Options and Returned Values In the following examples, ‘ x ’ indicates a s ingle digit from 0 to 9. When the command requires or returns values, each digit, or combination of digits, can s ignify either a value, flag or setti ng. Using Command 5 as an exampl e: Number of[...]

SDM-SIO4 User Guide 5-4 5.2.3 Command 2: Signatures This command gets the SDM-SIO4 EPROM signature and the string memory area signature; the two values are written into consecutive input locations . If the signatures are zero t h en there could be corrupt data. Values per repetition = 2 5.2.4 Command 3: Flush all Receive Buffers Stored data in th e[...]

Section 5. Programming the Datalogger 5-5 If any of these four digits is greater than zero then data is available. Values per repetition = 2 5.2.7 Command 6: Flush Transmit Buffer This command flushes the SDM-SIO4 transmit bu ffer of data it is waiting to send . Values per repetition = 0 5.2.8 Command 7: Activate Command Line This command si mulate[...]

SDM-SIO4 User Guide 5-6 5.2.12 Command 67: Get Return Code This command gets the return error code and places it into a specified location. Command 67 is us ed in conjunction with command 321 and provides a single return code value which indicates if the command was successful or not . See Section 5.6 for the return codes. Values per repetition = 1[...]

Section 5. Programming the Datalogger 5-7 P65 Bulk load 1:102 f 2:108 l 3:116 t 4:115 s 5:116 t 6:32 ascii space 7:50 2 8:53 5 9:1 First location to store the first lot of 8 characters. P65 Bulk load 1:32 ascii space 2:34 “ 3:102 f 4:102 f 5:67 C 6:99 c 7:34 “ 8:0 9:9 First location to store second lot of characters. ;execute the command line s[...]

SDM-SIO4 User Guide 5-8 ;set flag one so that set-up will only be done once. P86 11 ;end of set-up. P95 If you use the RAMTEST command you will have to wait a minimum of 6 s econds for it to complete before you t ry to execute another P113. Some Dataloggers do not support P65 Bulk Load. In that case you would have t o use a P30 Instruction for each[...]

Section 5. Programming the Datalogger 5-9 Second Value Returned CTS status (0=CTS low, 1=CTS high) | DSR status (0=DSR low, 1=DSR high) | | RI status (see below) | | | DCD status (0=DCD low, 1=DCD high) | | | | x x x x For the RI (Ring Indicator): 0 = no trailing edge seen since last read 1 = trailing edge seen since last read Third Value Returned [...]

SDM-SIO4 User Guide 5-10 Break reset: 0 Do nothing 1 Reset line break count to zero Framing reset: 0 Do nothing 1 Reset framing error count to zero Overrun reset: 0 Do nothing 1 Reset overrun error count to zero Parity reset: 0 Do nothing 1 Reset parity error count t o zero 5.2.18 Command 1027: ‘ Manual ’ Handshake Mode In this mode, the datalo[...]

Section 5. Programming the Datalogger 5-11 First Command Option ( P arameter 5) Handshake mode | Stop bits + parity | | Data length | | | Baud rate | | | | x x x x Handshake Mode: 0 Leave as set previously 1 DTR always set, set RTS when data is av ailable to transmit, only transm it if CTS is set 2 DTR always set, RTS always set, o nly transmit if [...]

SDM-SIO4 User Guide 5-12 5.2.20 Command 2054: Set Up Receive Filter This command clears al l buffers relevant to the mode number and restart s the filter. Values per repetition = 0 With the string filter typ e the SDM-SIO4 buffers are not cleared . First Command Option ( P arameter 5) Input mode | String number or character code | | | | x x x x Inp[...]

Section 5. Programming the Datalogger 5-13 Output Mode: 0 No output format s tring 1 Convert locati on to ASCII floating point. Add character/ d elimi ter between values if enabled . The last value will not have a delimiter after it. 2 Convert locati on to ASCII hex pair. Add character/delimite r between values if enabled. The last v alue will not [...]

SDM-SIO4 User Guide 5-14 5.2.22 Command 2305: Transmit Byte(s) By using P 113 command 2305 it is possi ble to transmit eit h er one or two byt es from the command options. If any command opt ion is set to 999 t hen the byte will not be sent. The number range for each command option is 0-255 and 999. An example of its use is below: 1:SDM-SIO4 (P113)[...]

Section 5. Programming the Datalogger 5-15 ;set ser ial mode to DTR, RTS always s et, ignore CTS, 1 stop bi t no parity, ;8 bit data le ngth, 9600 baud and no handshake delay. 2: SDM-SIO4 (P113) 1: 1 Reps 2: 0 Address 3: 1 Send/Receive Port 1 4: 2049 Command 5: 3146 1st Parameters 6: 0 2nd Parameters 7: 0 Values per Rep 8: 0000 Loc [ _________ ] 9:[...]

SDM-SIO4 User Guide 5-16 *Table 2 Program 02: 0.0000 Execution Interval (seconds) *Table 3 Subroutines End Program The normal configuration would i nclude setting the speed and seri al data format by calling the dat alogger instruction wit h command 2049 and the relevant parameters. For the majority of se nsor applications where data is returned in[...]

Section 5. Programming the Datalogger 5-17 ^J^M – this is a way of entering control characters fo r carriage return/linefeed into a string The following program example works as follows: 1. The first P113 sets up a s imple filter to search for floating point numbers. 2. The first parameter of th is command is used to tran smit a string which will[...]

SDM-SIO4 User Guide 5-18 ;get data fr om SDM-SIO4 and put into locations 1 and 2. 3: SDM-SIO4 (P113) 1: 1 Reps 2: 0 Address 3: 1 Send/Receive Port 1 4: 4 Command 5: 0 1st Parameters 6: 0 2nd Parameters 7: 2 Values per Rep 8: 1 Loc [ number ] 9: 1.0 Mult 10: 0.0 Offset ;At zero minut es into a 10 minute interval set the output ;so that the d ata fro[...]

Section 5. Programming the Datalogger 5-19 Example CR10X Program without Polling or Interrupts This simpl e program is an example for sensors t hat send data at random i ntervals. If no data was available when the datalogger asked for it then -99999 will be put into locations 1 and 2. An IF THEN structure could be used in the datal ogger program to[...]

SDM-SIO4 User Guide 5-20 ;end of set up. 5: End (P95) ;get the two f loating point values from t h e SDM-SIO4. 6: SDM-SIO4 (P113) 1: 1 Reps 2: 0 Address 3: 1 Send/Receive Port 1 4: 4 Command 5: 0 1st Parameters 6: 0 2nd Parameters 7: 2 Values per Rep 8: 1 Loc [ Voltage ] 9: 1.0 Mult 10: 0.0 Offset ;Only set the out put flag when the voltage is ;gre[...]

Section 5. Programming the Datalogger 5-21 x – this filter marks the start o f the data set. In this case the d ata set is two floating point numbers. f – this filter searches for the first ASC II floating point number to convert. f – this filter searches for the second ASC II floating point number to convert. *Table 1 Program 01: 2 Execution[...]

SDM-SIO4 User Guide 5-22 ;if value returned from poll is >=1 then data must be a vailable. 7: IF (X<=>F) (P89) 1: 2 X Loc [ poll ] 2: 3 >= 3: 1 F 4: 30 Then Do ;get voltages into locations 3 and 4 if pol l was true. 8: SDM-SIO4 (P113) 1: 1 Reps 2: 0 Address 3: 1 Send/Receive Port 1 4: 4 Command 5: 0 1st Parameters 6: 0 2nd Parameters 7:[...]

Section 5. Programming the Datalogger 5-23 – see ‘SDM Port’ i n Secti on 1 for details. This shoul d be connected to control port 8 for this example. A typical filter that could be used is as follows: fltst 200 "t[d ata]A5xff" This filter works as follows: t[data] – this filter waits for an exact string match before it starts the [...]

SDM-SIO4 User Guide 5-24 ;end of IF 6: End (P95) *Table 2 Program 02: 0.0000 Execution Interval (seconds) *Table 3 Subroutines ;interr upt routine for contr ol port 8 1: Beginning of Subroutine (P85) 1: 98 Subroutine 98 ;get voltages into locations 3 and 4 2: SDM-SIO4 (P113) 1: 1 Reps 2: 0 Address 3: 1 Send/Receive Port 1 4: 4 Command 5: 0 1st Para[...]

Section 5. Programming the Datalogger 5-25 5.4 Outputting Datalogger Data The SDM-SIO4 can be used t o drive dis p lays , printout devices and other output- only systems. In this cas e after the initial configuration (as above) either simple data can be sent using commands 0320, 1025 or just data strings using 1024 or strings plus formatted data se[...]

SDM-SIO4 User Guide 5-26 *Table 2 Program 02: 0.0000 Execution Interval (seconds) *Table 3 Subroutines End Program 5.5 Flushing the Input and Output Buffers One importan t aspect of the SDM-SIO4 is that it will contin ue to collect data and store it i n its buffers even if the datalogger program stops runni ng. Care must be taken to ensure that dat[...]

6-1 Section 6. Data Error Detection Error detection by checksum, CRC or signatures is a way of detecting errors in data, either transmitted or received. This section gives details on how to use filter strings together w ith datalogger program examples to im plement error detection methods. 6.1 Error Detection with the SDM-SIO4 Error detection is ca[...]

SDM-SIO4 User Guide 6-2 3 CRC16-CCITT-IB M (Tag Receiver). 4 CRC32 st andard. Polynomial x 32 +x 26 +x 23 +x 22 +x 16 +x 12 +x 11 +x 10 +x 8 +x 7 +x 5 +x 4 +x 2 +x+1. 5 CSI Signature (see Appendi x C of the CR10X Manual). 6 Checksum usi ng modulo 256. 7 Checksum using modul o 8192 (See Section 5 of the CR10X Manual ). 8-255 For future use. Gn This [...]

Section 6. Data Error Detection 6-3 6.2.1 Example of Using Received Data Filters If a sensor transmitted th e following string: Frequency=12.34567HzBB3DCrLf then a user defined filter string would have to be used. The BB3D part of the string is the CRC sent in hex. from the sensor. To produce a filter string to deal with the se nsor output you coul[...]

SDM-SIO4 User Guide 6-4 *Table 1 Program 01: 1.0 Execution Interval (seconds) ;test flag 1 – if n ot set tell the SDM-SIO4 to use filter string 100 1: If Flag/Port (P91) 1: 21 Do if Flag 1 is Low 2: 30 Then Do ;tell the SDM-SIO4 to use filter string 100 2: SDM-SIO4 (P113) 1: 1 Reps 2: 0 Address 3: 1 Send/Receive Port 1 4: 2054 Command 5: 9100 1st[...]

Section 6. Data Error Detection 6-5 ;if the value in locat ion 1 is greater than z ero then there must be data ;this ass umes only one sensor is connected to the SDM-SIO4 7: IF (X<=>F) (P89) 1: 1 X Loc [ _________ ] 2: 3 >= 3: 1 F 4: 30 Then Do ;if data is available then get the value and put into location 2 8: SDM-SIO4 (P113) 1: 1 Reps 2:[...]

SDM-SIO4 User Guide 6-6 1,2 CRC 16 and CRC16-CCITT 0.159ms/char. 3 CRC 16-CCITT-IBM 0.159ms/char. 4 CRC32 0.369ms/ char. 5 CSI Signature 0.077ms/char. 6 Checksum using modul o 256 0.066ms/char. 7 Checksum using modul o 8192 0.071ms/char. c The time for the differen t data types is shown belo w. Note that this is the time needed to convert the recei[...]

Section 6. Data Error Detection 6-7 5 CSI Signature (CR 10X user manual section C-4). 6 Check sum using modul o 256. 7 Check sum using modul o 8192 (CR10X user manual secti on 5-2). 8-255 reserved for future use. Gn This formatter type can b e put into the formatter string to m ark the end of the string and the point at which the signature s hould [...]

SDM-SIO4 User Guide 6-8 6.3.2 CR10X Program Example A typical CR 10X datalogger program to work with the above formatter is shown below. The program assumes that the SDM-SIO4 is set to address 0, the sensor is connected to port 1 of the SDM-S IO4 and the port settings, baud rate etc have been set. The output from t he SDM-SIO4 is every second: *Tab[...]

Section 6. Data Error Detection 6-9 *Table 1 Program 01: 1.0 Execution Interval (seconds) ;use form atter stri ng 100 to set up the CRC16 on por t 1 1: SDM-SIO4 (P113) 1: 1 Reps 2: 0 Address 3: 1 Send/Receive Port 1 4: 2304 Command 5: 9100 1st Parameters 6: 0 2nd Parameters 7: 0 Values per Rep 8: 0000 Loc [ _________ ] 9: 1 Mult 10: 0 Offset ;A min[...]

SDM-SIO4 User Guide 6-10 ;use for matter st ring 102 and output datalogger location 1 as ASCII f loating poi nt ;to port 1 and t h en output t he calculated ASCII hex CRC 16 6: SDM-SIO4 (P113) 1: 1 Reps 2: 0 Address 3: 1 Send/Receive Port 1 4: 2304 Command 5: 9102 1st Parameters 6: 0 2nd Parameters 7: 1 Values per Rep 8: 0000 Loc [ _________ ] 9: 1[...]

Section 6. Data Error Detection 6-11 1 8 bit binary 0.155ms 2,3 16 bi t binary 0.216ms 4,5 32 bi t binary 0.334ms 6 ASCII decimal 1.125ms 7 8 bit ASCII hex 0.226ms 8 16 bit ASCII hex 0.355ms 9 32 bit ASCII hex 0.613ms The above timings are prel iminary. d With the C RC32 and CRC16-CC ITT there is a extra 0.19ms for an additional calculatio n. This [...]

[...]

A- 1 Appendix A. ASCII Table American Standard Code for Information Interchange Decimal Values and Characters (X3.4-1968) Dec. Char. Dec. Char. Dec. Char. Dec. Char. 0 CONTROL @ 32 SPACE 64 @ 96 ` 1 CONTROL A 33 ! 65 A 97 a 2 CONTROL B 34 " 66 B 98 b 3 CONTROL C 35 # 67 C 99 c 4 CONTROL D 36 $ 68 D 100 d 5 CONTROL E 37 % 69 E 101 e 6 CONTROL F[...]

[...]

B- 1 Appendix B. Serial Port Data Transfer Modes This appendix describes the serial port set-up in some detail. Please note that the numerical option codes vary between the command line set-up and the datalogger command set-up. The ones listed below are those for the command line mode. B.1 Baud rates The SDM-SIO4 ports can support 16 baud rates if [...]

SDM-SIO4 4-Channel Serial I/O Interface B- 2 B.4 Parity Bits Parity can be enabled and set to either odd or even. 0. No parity set 1. Odd parity set 2. Even parity set B.5 Serial Handshake Modes You can select different kinds of handshaking from none at all, hardware (DTR, CTS etc.) and XON/XOFF. On modes 0 and 1 there is a user-set delay (0..254 x[...]