Campbell Hausfeld SDM-SIO4 Section 5. Programming the Datalogger

5-1

Section 5. Programming the Datalogger

The datalogger instruction specific to the SDM-SIO4 is P113 (CR7 and CR10/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 Address of SDM-SIO4 (0..15)

03 Mode (0..5)

04 Command (0..9999).

05 First command option (0..9999)

06 Second command option (0..9999)

07 Values per rep

08 Starting input location

09 Multiplier

10 Offset

5.1 Instruction 113 Parameters

5.1.1 Parameter 1 — Reps

This specifies the number of times you wish this command to repeat for each

SDM-SIO4 connected to the datalogger with sequential addresses. This will

normally be set to one.

5.1.2 Parameter 2 — Address

This is the address of the SDM-SIO4 that the instruction applies to.

See Section 2 – ‘Installation and Hardware Set-Up’ for information on setting the

SDM-SIO4 address

5.1.3 Parameter 3 — Mode

This defines which port the command applies to:

Code Port

1 Send/Receive port 1

2 Send/Receive port 2

3 Send/Receive port 3

4 Send/Receive port 4

5 Send to all four ports (global)

5.1.4 Parameters 4, 5 and 6 — SDM-SIO4 Command

This command (with up to two options) defines exactly what the instruction will

do. Where no options are needed, enter values of 0000 for parameters 5 and 6.

Contents

Main Page Guarantee Page Contents Section 1. Introduction..................................................... 1-1 Section 2. Installation and Hardware Set-Up.................. 2-1 Section 4. Programming the SDM-SIO4.......................... 4-1 Section 5. Programming the SDM-SIO4.......................... 5-1 Figures Tables Section 1. Introduction 1.1 What is the SDM-SIO4? SDM-SIO4 4-Channel Serial I/O Interface User Guide K K K Figure 1 Schematic Diagram of the SDM-SIO4 PORT Command Line Control Datalogger Command Control 1.2 Specifications 1.2.1 Serial Ports Serial Port Buffers 1.2.2 SDM Port 1.2.3 Case 1.2.4 Power Requirements 1.2.5 Environmental Operating Range 1.2.6 Other Key Features Page Section 2. Installation and Hardware Set-Up 2.1 Setting the SDM Address 2.2 Selecting RS232 or 5V Logic for Each Port 2.3 Connections to the SDM-SIO4 2.3.1 Transient Protection and Grounding 2.4 Power-on Tests the Status LED Page Section 3. Understanding How the SDM-SIO4 Handles Data 3.1 Introduction 3.1.1 Method of Entering Special / Control Characters 3.2 Input Filters 3.2.1 Filter Types Simple Filters Filter Strings Page Predefined Filter Strings 3.3 Output Formatting 3.3.1 Simple Output Formatter 3.3.2 Output Format Strings CR10X Program Example Page Section 4. Programming the SDM-SIO4 4.1 Command Line Operation and Structure 4.2 Entering Commands 4.3 Basic Commands fltst [string number] ["filter definition"] strst [string number] ["string definition"] fmtst [string number] ["format definition"] strdelete [string number] 4.4 Advanced Commands version portset [delay] reset hexdump errorres bytewr Section 4. Programming the SDM-SIO4 testio [test#] Page Section 5. Programming the Datalogger 5.1 Instruction 113 Parameters 5.1.1 Parameter 1 Reps 5.1.2 Parameter 2 Address 5.1.3 Parameter 3 Mode 5.2 Commands and Options (Parameters 4, 5 and 6) 5.2.1 Understanding Parameter Options and Returned Values 5.2.2 Command 1: Poll of Available Data 5.2.3 Command 2: Signatures 5.2.4 Command 3: Flush all Receive Buffers 5.2.5 Command 4: Send Data to Datalogger 5.2.6 Command 5: Status 5.2.7 Command 6: Flush Transmit Buffer 5.2.8 Command 7: Activate Command Line 5.2.9 Command 8: Poll Tx Buffers for Data 5.2.10 Command 9: Flush Converted Data Buffer 5.2.11 Command 66: Send Single-Byte Data to Datalogger 5.2.12 Command 67: Get Return Code 5.2.13 Command 320: Send Byte Data to SDM-SIO4 5.2.14 Command 321: Execute Command Line Command Program Example for P113 Command 321 5-7 ;execute the command line string. ;delay large enough (10ms) to allow SDM-SIO4 instruction 321 to finish. 5.2.15 Command 1024: Send String to Device 5.2.16 Command 1025: Transmit a Byte 5.2.17 Command 1026: Serial Port Status First Value Returned Second Value Returned Third Value Returned Fourth Value Returned First Command Option Reset Error Counters 5.2.18 Command 1027: Manual Handshake Mode 5.2.19 Command 2049: Set Communications Parameters Second Command Option (Parameter 6) 5.2.20 Command 2054: Set Up Receive Filter 5.2.21 Command 2304: Transmit String and/or Data to Device (Formatter/Filter) Second Command Option (Parameter 6) String Number or Character Code 5.2.22 Command 2305: Transmit Byte(s) 5.3 SDM-SIO4 Configuration Examples Example CR10X Program 5-15 ;set up a simple filter 1999 search for floating point number. ;the set up filter command requires a delay of 4ms, the nearest we can get ;is 10ms with P22. ;set flag one high so the above will only be done once. ;end of serial and filter setup. 5.3.1 Sensors Where the Datalogger Can Request Data by Sending a Prompt or Using a Handshaking Line Example CR10X Program Using Instruction P113 Command 4 Page 5.3.2 Sensors Which Send Data Out Without Prompting Example CR10X Program without Polling or Interrupts Example CR10X Program using the Polling Method Page Example CR10X Program using Interrupts Page Page 5.4 Outputting Datalogger Data 5.5 Flushing the Input and Output Buffers 5.6 Return Error Codes Section 6. Data Error Detection 6.1 Error Detection with the SDM-SIO4 6.2 Received Data Page 6.2.1 Example of Using Received Data Filters 6.2.2 CR10X Program Example Page Page 6.3 Transmitted Data 6.3.1 Example of Using Transmitted Data Filters 6.3.2 CR10X Program Example 6.3.3 Alternative CR10X Program 6-9 ;use formatter string 100 to set up the CRC16 on port 1 ;A minimum delay of 1ms is required after this command ;use formatter string 101 to transmit the string get data to port 1 ;a minimum delay of 3.8ms is required after this command Page Page Page Appendix A. ASCII Table Page Appendix B. Serial Port Data Transfer Modes B.1 Baud rates B.2 Stop Bits B.3 Data Length B.4 Parity Bits B.5 Serial Handshake Modes