beautypg.com

Command 7 request system status – Vernier LabPro User Manual

Page 45

background image

Revision Date: 08/02/02

LabPro Technical Manual

45

Command 7

Request System Status

This command returns LabPro’s 17 status registers.

Syntax: {7}

Return values: The following information is returned.

Register

Description

softwareID

Current software ID in format: X.MMmms where X=product code number,

MM=major ID number, mm=minor ID number, and s=step ID number.

error

If non-zero, LabPro should be reset and the cause of the error corrected.

battery

Battery status. Can return the following values:

0

Battery is OK for use

1

Battery is low during sampling

2

Battery is low all the time

8888

Constant value. If the correct list location is set to zero prior to requesting and getting
the list, this value can be used to ensure that the status message was received correctly.

Sample time

Sample time that was commanded by the host during the last sample run.

trigger condition

Triggering condition that was commanded by the host during the last sample run.

channel function

Triggering channel that was commanded by the host during the last sample run.

channel post

Post-processing setting that was commanded by the host during the last sample run.

channel filter

Filter that was commanded by the host during the last sample run.

num samples

Number of samples that was commanded by the host during the last sample run. If
sampling was aborted, this parameter reflects the actual number of samples taken.

record time

This can have the following values:

0

No time was recorded in the last run

1

Absolute time was recorded in the last run

2

Relative time was recorded in the last run

temperature

Temperature used for the temperature correction of the sonic data during the last run if

a sonic sensor was selected.

piezo flag

This is the buzz/no-buzz value that was last commanded. Values are:

0

Sound is disabled (OFF)

1

Sound is enabled (ON)

system state

The following values are used for the system state:

1

Idle

2

Armed

3

Busy

4

Done

5

Self-test

99 Initializing code

Add 16 to the value if the last mode was QuickSetup.
Add 32 to the value if the last data collected has not yet been retrieved.

datastart

First point of data available for transmission to the host unless the host has sent
Command 5 to override this value.

dataend

Last point of data available for transmission to the host unless the host has sent
Command 5 to override this value.

System ID

The System ID that was set using Command 6.

Example 1: Request LabPro’s system status registers.
Computer

Calculator

s{7}

:Send({7})
:Get(L1)