Sample State Assembly

The sample state object contains measurements and their associated stamp information.

Sample State Assembly

Information

Value

Class

0x04

Instance

0x321

Attribute Number

3

Length

380 bytes

Supported Service

0x0E (GetAttributeSingle)

Attribute 3

Attribute

Name

Type

Value

Description

Access

3

Command

Byte Array

See below

Sample state information. See below for more details.

Get

Sample State Information

Byte

Name

Type

Description

0-1

Inputs

16u

Digital input state of the last frame.

2-9

Z Index Position

64s

Encoder position at time of last index pulse of the last frame.

10-13

Exposure

32u

Laser exposure in µs of the last frame.

14-17

Temperature

32u

Sensor temperature in degrees Celsius * 100 (centidegrees) of the last frame.

18-25

Encoder Position

64s

Encoder position of the last frame when the image data was scanned/taken.

26-33

Time

64u

Time stamp in microseconds of the last frame.

34-41

Frame Counter

64u

The frame number of the last frame.

42

Buffer Count

8u

Represents the number of frames waiting to be output if buffering is enabled.

43

Buffer Overflowing

8u

Indicates whether the output buffer has overflowed:
0 - No overflow
1 - Overflow

44 - 79

Reserved

 

Reserved bytes.

80-83

Measurement 0

32s

Measurement value in µm (0x80000000 if invalid).

84

Decision 0

8u

Measurement decision. A bit mask, where:

 

Bit 0:

1 - Pass

0 - Fail

 

Bits 1-7:

0 - Measurement value OK

1 - Invalid value

2 - Invalid anchor

...

...

   

375-378

Measurement 59

32s Measurement value in µm (0x80000000 if invalid).

379

Decision 59

8u

Measurement decision. A bit mask, where:

 

Bit 0:

1 - Pass

0 - Fail

 

Bits 1-7:

0 - Measurement value OK

1 = Invalid value

2 = Invalid anchor

Measurement results are reported in pairs of values and decisions. Measurement values are 32 bits wide and decisions are 8 bits wide.

The measurement ID defines the byte position of each pair within the state information. The position of the first word can be calculated as (80 + 5 * ID). For example, a measurement with ID set to 4 can be read from byte 100 (high word) to 103 (low word) and the decision at 104.

In Profile mode, the measurement results are updated after each profile is processed. In Surface mode, the measurement results are updated after each discrete part has been processed. If buffering is enabled in the Ethernet Output panel, reading the Extended Sample State Assembly Object automatically advances the buffer. See Ethernet Output for information on the Output panel.