Manuals / Brands / Computer Equipment / Network Card / Campbell Hausfeld / Computer Equipment / Network Card

Campbell Hausfeld SDM-SIO4 5.2.1 Understanding Parameter Options and Returned Values, 5.2.2 Command 1: Poll of Available Data

1 72

Download 72 pages, 401.79 Kb

Section 5. Programming the Datalogger

5-3

5.2.1 Understanding Parameter Options and Returned Values

In the following examples, ‘x’ indicates a single digit from 0 to 9.

When the command requires or returns values, each digit, or combination of

digits, can signify either a value, flag or setting.

Using Command 5 as an example:

Number of watch dog resets

| | Number of invalid commands executed

| | | Lithium battery level

| | | |

x x x x

The first value returned by Command 5 indicates:

• Actual number of watch dog resets (two digits 00 to 99) – a value.

• Number of invalid commands executed (single digit 0 to 9) – a value.

• Level (state) of the lithium battery (0=low, 1=good) – a flag.

If the value returned was, for example, 1281, then it would have the following

meaning:

12 watch dog resets

8 invalid commands

1 battery level good

The second value returned shows whether or not data is available from a specific

port. A non-zero digit indicates that data is available, whereas a zero signifies that

no data is available.

Command 5 is explained in detail later.

When a command parameter requires values to be entered (e.g.

Command 1026), it is a good idea to always enter all four digits.

Only trailing zeros are significant to the SDM-SIO4, and so entering

0001 or 1 would be identical. However, if the first parameter needs

to be 1, you must enter 1000. The habit of always entering all four

values helps to minimise input errors.

5.2.2 Command 1: Poll of Available Data

This command has no additional options after the command. The SDM-SIO4

returns one Campbell Scientific floating point number to indicate if data is

available as below:

Port 4 data available

| Port 3 data available

| | Port 2 data available

| | | Port 1 data available

| | | |

x x x x

If any of these four digits is greater than zero then data is available.

Values per repetition = 1

NOTE

NOTE

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