CS messages

MESSAGE 001 (no profile, no sky condition)

Example message line outputs

CS0001001

10 087 00139 ///// ///// ///// 800000000000

942f

LINE 1

SOH CS ID OS N STX CR LF

where

SOH = Start-of-Heading character

CS = Always CS

ID (1 character) = A single character, 0 to 9, a to z or A to Z, case sensitive. Default ID = 0

OS (3 characters) = Operating system, 001 to 999

N (3 characters) = Message number

STX = Start-of-Text Character

CR LF = Carriage Return + Line Feed

LINE 2

S WAV trVh1Vh2Vh3Vh4Vflags CR LF

NOTE:

Notice the spaces which are indicated by 'V'.

where

S (1 character) = detection status:

0 = No significant backscatter
1 = One cloud base detected
2 = Two cloud bases detected
3 = Three cloud bases detected
4 = Four cloud bases detected
5 = Full obscuration determined but no cloud base detected
6 = Some obscuration detected but determined to be transparent
/ = Raw data input to algorithm missing or suspect

WA (1 character) = Warning or alarm status:

0 = No alarm or warning
W = Warning
A = Alarm

tr (3 characters) = Window transmission, %

h1 (5 characters) = 1st Height

If detection status is 1, 2, 3, or 4, h1 = Lowest cloud base reported
If detection status is 5, h1 = Vertical visibility as calculated
If detection status is 0 or 6, h1 = /////

h2 (5 characters) = 2nd Height

If detection status is 2, 3, or 4, h2 = Second cloud base reported
If detection status is 5, h2 = Highest signal received
If detection status is 0, 1, or 6, h2 = /////

h3 (5 characters) = 3rd Height

If detection status is 3 or 4, h3 = Third cloud base reported
If detection status is 0, 1, 2, 5, or 6, h3 = /////

h4 (5 characters) = 4th Height

If detection status is 4, h4 = Fourth cloud base reported
If detection status is 0, 1, 2, 3, or 5, h4 = /////

flags (12 characters in 3 groups of 4) = Alarm or warning information

Most significant alarm word for CS messages

Bit1

Description

8000 XXXX XXXX Units. Feet = 0, meter = 1.
4000 XXXX XXXX Reserved for future use
2000 XXXX XXXX Reserved for future use
1000 XXXX XXXX Reserved for future use
0800 XXXX XXXX DSP clock out of specification
0400 XXXX XXXX Laser shut down due to operating temperature out of range
0200 XXXX XXXX The lead acid battery voltage is reading low
0100 XXXX XXXX Mains supply has failed (requires a PSU to be present)
0080 XXXX XXXX The external heater blower assembly temperature is out of bounds
0040 XXXX XXXX External heater blower failure
0020 XXXX XXXX The PSUs internal temperature is high
0010 XXXX XXXX PSU OS has failed its signature check
0008 XXXX XXXX No communications between DSP and PSU
0004 XXXX XXXX Photo diode and Laser windows are dirty. This can only be set if the laser is on
0002 XXXX XXXX Tilt beyond limit set by user, default 45 degrees
0001 XXXX XXXX No communications between DSP and inclinometer board

1 Alarm words are sum of error bits.

 

Middle alarm word for CS messages

Bit1

Description

XXXX 8000 XXXX The sensors internal humidity is high
XXXX 4000 XXXX Communications to the DSP board temperature and humidity chip have failed
XXXX 2000 XXXX DSP input supply voltage is low
XXXX 1000 XXXX Self-test active
XXXX 0800 XXXX Watch dog counter updated
XXXX 0400 XXXX User setting stored in flash failed their signature checks
XXXX 0200 XXXX DSP factory calibration stored in flash has failed its signature check
XXXX 0100 XXXX DSP board OS signature test failed
XXXX 0080 XXXX DSP board RAM test failed
XXXX 0040 XXXX DSP boards on board PSUs are out of bounds
XXXX 0020 XXXX TOP board non-volatile storage is corrupt
XXXX 0010 XXXX TOP board OS signature test has failed
XXXX 0008 XXXX TOP boards ADC and DAC are not within specifications
XXXX 0004 XXXX TOP boards on board PSUs are out of bounds
XXXX 0002 XXXX Communications have failed between TOP board and the DSP
XXXX 0001 XXXX Photo diode background radiance is out of range

1 Alarm words are sum of error bits.

 

Least significant alarm word for CS messages

Bit1

Description

XXXX XXXX 8000 Photo diode temperature is out of range
XXXX XXXX 4000 Photo diode is saturated
XXXX XXXX 2000 Photo diode calibrator temperature is out of range
XXXX XXXX 1000 Photo diode calibrator has failed
XXXX XXXX 0800 The sensor could not reach the desired gain levels
XXXX XXXX 0400 Laser run time or maximum laser drive current has been exceeded
XXXX XXXX 0200 Laser temperature out of range
XXXX XXXX 0100 Laser thermistor failure
XXXX XXXX 0080 Laser is obscured. This can only be set if the laser is on
XXXX XXXX 0040 Laser did not achieve significant output power
XXXX XXXX 0020 Laser max power exceeded
XXXX XXXX 0010 Laser max drive current exceeded
XXXX XXXX 0008 Laser power monitor temperature out of range
XXXX XXXX 0004 Laser power monitor test fail
XXXX XXXX 0002 Laser shutdown by top board
XXXX XXXX 0001 Laser is off

1 Alarm words are sum of error bits.

CR LF = Carriage Return and Line Feed

LINE 3

ETX CRC-16 EOT CR LF

where

ETX = End-of-Text character
CRC-16 (4 characters) = CRC-16 Checksum
EOT = End-of-Transmission character
CRLF = Carriage Return + Line Feed

MESSAGE 002 (Profile, no sky condition)

Example message line outputs

CS0001002

10 085 01123 ///// ///// ///// 800000000000

00100 05 2048 100 +40 02 0074 0070 30 000

0c5df047……………………00000         (Line output cropped for clarity)

9f68

LINE 1

SOH CS ID OS N STX CR LF

where

SOH = Start-of-Heading character

CS = Always CS

ID (1 character) = A single character, 0 to 9, a to z or A to Z, case sensitive. Default ID = 0

OS (3 characters) = Operating system, 001 to 999

N (3 characters) = Message number

STX = Start-of-Text Character

CR LF = Carriage Return + Line Feed

LINE 2

S WAVtrVh1Vh2Vh3Vh4Vflags CR LF

NOTE:

Notice the spaces which are indicated by 'V'.

where

S (1 character) = detection status:

0 = No significant backscatter
1 = One cloud base detected
2 = Two cloud bases detected
3 = Three cloud bases detected
4 = Four cloud bases detected
5 = Full obscuration determined but no cloud base detected
6 = Some obscuration detected but determined to be transparent
/ = Raw data input to algorithm missing or suspect

WA (1 character) = Warning or alarm status:

0 = No alarm or warning
W = Warning
A = Alarm

tr (3 characters) = Window transmission, %

h1 (5 characters) = 1st Height

If detection status is 1, 2, 3, or 4, h1 = Lowest cloud base reported
If detection status is 5, h1 = Vertical visibility as calculated
If detection status is 0 or 6, h1 = /////

h2 (5 characters) = 2nd Height

If detection status is 2, 3, or 4, h2 = Second cloud base reported
If detection status is 5, h2 = Highest signal received
If detection status is 0, 1, or 6, h2 = /////

h3 (5 characters) = 3rd Height

If detection status is 3 or 4, h3 = Third cloud base reported
If detection status is 0, 1, 2, 5, or 6, h3 = /////

h4 (5 characters) = 4th Height

If detection status is 4, h4 = Fourth cloud base reported
If detection status is 0, 1, 2, 3, or 5, h4 = /////

flags (12 characters in 3 groups of 4) = Alarm or warning information.

Refer to Message 001 for a breakdown of the flags.

CR LF = Carriage Return and Line Feed

LINE 3

scaleVresVnV energyVltVti_blVpulseVrateVsum CR LF

NOTE:

Notice the spaces which are indicated by 'V'.

where

scale (5 characters) = Attenuated_SCALE parameter, %, 0 to 99999. 100% is default

res (2 characters) = Backscatter profile resolution in meters

n (4 characters) = Profile length

energy (3 characters) = Laser pulse energy, %.

lt (3 characters including leading +/-) = Laser temperature, degrees C

ti (2 characters) = Total tilt angle, degrees

bl (4 characters) = Background light, millivolts at internal ADC input (0 to 2500)

pulse (4 characters) = Pulse quantity x 1000 (0000 to 9999)

rate (2 characters) = Sample rate, MHz, (00 to 99)

sum (3 characters) = Sum of detected and normalized backscatter, 0 to 999. Multiplied by scaling factor times 104. At scaling factor 100 the SUM range 0 to 999 corresponds to integrated backscatter 0 to 0. srad-1.

CR LF = Carriage Return + Line Feed

LINE 4

SSSSSSSSSSSSSSSSSSSSSSSSSSSSS........(2048 x 5 bytes) CR LF

The two-way attenuated normalized backscatter profile (Backscatter profile reporting

CR LF = Carriage Return + Line Feed

LINE 5

ETX CRC-16 EOT CR LF

where

ETX = End-of-Text character
CRC-16 (4 characters) = CRC-16 Checksum
EOT = End-of-Transmission character
CR LF = Carriage Return + Line Feed

MESSAGE 003 (no profile, sky condition)

Example message line outputs

CS0001003

10 091 00828 ///// ///// ///// 800000000000

99 //// 0 //// 0 //// 0 //// 0 ////

f62a

LINE 1

SOH CS ID OS N STX CR LF

where

SOH = Start-of-Heading character

CS = Always CS

ID (1 character) = A single character, 0 to 9, a to z, or A to Z, case sensitive. Default ID = 0

OS (3 characters) = Operating system, 001 to 999

N (3 characters) = Message number

STX = Start-of-Text Character

CR LF = Carriage Return + Line Feed

LINE 2

S WAVtrVh1Vh2Vh3Vh4Vflags CR LF

NOTE:

Notice the spaces which are indicated by 'V'.

where

S (1 character) = detection status:

0 = No significant backscatter
1 = One cloud base detected
2 = Two cloud bases detected
3 = Three cloud bases detected
4 = Four cloud bases detected
5 = Full obscuration determined but no cloud base detected
6 = Some obscuration detected but determined to be transparent
/ = Raw data input to algorithm missing or suspect

WA (1 character) = Warning or alarm status:

0 = No alarm or warning
W = Warning
A = Alarm

tr (3 characters) = Window transmission, %

h1 (5 characters) = 1st Height

If detection status is 1, 2, 3, or 4, h1 = Lowest cloud base reported
If detection status is 5, h1 = Vertical visibility as calculated
If detection status is 0 or 6, h1 = /////

h2 (5 characters) = 2nd Height

If detection status is 2, 3, or 4, h2 = Second cloud base reported
If detection status is 5, h2 = Highest signal received
If detection status is 0, 1, 5, or 6, h2 = /////

h3 (5 characters) = 3rd Height

If detection status is 3 or 4, h3 = Third cloud base reported
If detection status is 0, 1, 2, 5, or 6, h3 = /////

h4 (5 characters) = 4th Height

If detection status is 4 h4 = Fourth cloud base reported
If detection status is 0, 1, 2, 3, or 5 h4 = /////

flags (12 characters in 3 groups of 4) = Alarm or warning information.

Refer to Message 001 for a breakdown of the flags.

CR LF = Carriage Return and Line Feed

LINE 3

VdVh1VVd2Vh2VVd3Vh3VVd4_h4VVd5_h5 CR LF

NOTE:

Notice the spaces which are indicated by 'V'.

where

d (1 or 2 characters) = Data available

0 to 8  Amount of lowest layer in oktas
9  Vertical visibility only available
–1  No sky condition data available
99  Insufficient data

NOTE:

Two spaces are at the beginning of the line if data is available. One space is at the beginning of the line if –1 (no sky condition data available) or 99 (insufficient data) are output.

Examples:

V–1_h1...” (single space) no sky condition data available

V99_h1...” (single space) insufficient data available

VV9_h1...” (two spaces) vertical visibility only available

VV5_h1...” (two spaces) 5/8ths of sky covered in lowest layer

h1 (4 characters) = Height of the lowest cloud layer in 10 s of meters or 100 s of feet

d2 (1 character) = Cloud amount of the 2nd layer in oktas

h2 (4 characters) = Height of the 2nd cloud layer in 10 s of meters or 100 s of feet (if no 2nd layer is reported, h2 = ////).

d3 (1 character) = Cloud amount of the 3rd layer in oktas

h3 (4 characters) = Height of the 3rd cloud layer in 10 s of meters or 100 s of feet (if no 3rd layer is reported h3 = ////).

d4 (1 character) = Cloud amount of the 4th layer in oktas

h4 (4 characters) = Height of the 4th cloud layer in 10 s of meters or 100 s of feet, if no 4th layer is reported, h4 = ////).

d5 (1 character) = Cloud amount of the 5th layer in oktas

h5 (4 characters) = Height of the 5th cloud layer in 10 s of meters or 100 s of feet (if no 5th layer is reported, h5 = ////).

CR LF = Carriage Return + Line Feed

NOTE:

Cloud amounts and heights cannot be reported until the SkyVue 8 has been in operation for 30 minutes.

LINE 4

ETX CRC-16 EOT CR LF

where

ETX = End-of-Text character
CRC-16 (4 characters) = CRC-16 Checksum
EOT = End-of-Transmission character
CR LF = Carriage Return + Line Feed

MESSAGE 004 (profile, sky condition) — default message

Example message line outputs

CS0001004

10 092 00698 ///// ///// ///// 800000000000

99 //// 0 //// 0 //// 0 //// 0 ////

00100 05 2048 100 +40 02 0074 0070 30 000

071fc024d………………….000 (Line output cropped for clarity)

6212

LINE 1

SOH CS ID OS N STX CR LF

where

SOH = Start-of-Heading character

CS = Always CS

ID (1 character) = A single character, 0 to 9, a to z or A to Z, case sensitive. Default ID = 0

OS (3 characters) = Operating system, 001 to 999

N (3 characters) = Message number

STX = Start-of-Text Character

CR LF = Carriage Return + Line Feed

LINE 2

S WAVtrVh1Vh2Vh3Vh4Vflags CR LF

NOTE:

Notice the spaces which are indicated by 'V'.

where

S (1 character) = detection status:

0 = No significant backscatter
1 = One cloud base detected
2 = Two cloud bases detected
3 = Three cloud bases detected
4 = Four cloud bases detected
5 = Full obscuration determined but no cloud base detected
6 = Some obscuration detected but determined to be transparent
/ = Raw data input to algorithm missing or suspect

WA (1 character) = Warning or alarm status:

0 = No alarm or warning
W = Warning
A = Alarm

Tr (3 characters) = Window transmission, %

h1 (5 characters) = 1st Height

If detection status is 1, 2, 3, or 4, h1 = Lowest cloud base reported
If detection status is 5, h1 = Vertical visibility as calculated
If detection status is 0 or 6, h1 = /////

h2 (5 characters) = 2nd Height

If detection status is 2, 3, or 4, h2 = Second cloud base reported
If detection status is 5, h2 = Highest signal received
If detection status is 0, 1, or 6, h2 = /////

h3 (5 characters) = 3rd Height

If detection status is 3 or 4, h3 = Third cloud base reported
If detection status is 0, 1, 2, 5, or 6, h3 = /////

h4 (5 characters) = 4th Height

If detection status is 4, h4 = Fourth cloud base reported
If detection status is 0, 1, 2, 3, or 5, h4 = /////

flags (12 characters in 3 groups of 4) = Alarm or warning information. Refer to Message 001 for a breakdown of the flags.

CR LF = Carriage Return + Line Feed.

LINE 3

VdVh1h1h1VVd2Vh2h2h2VVd3Vh3h3h3VVd4Vh4h4h4VVd5_h5h5h5 CR LF

NOTE:

Notice the spaces which are indicated by 'V'.

where

d (2 characters) = Data available

0 to 8  Amount of lowest layer in oktas
9  Vertical visibility only available
–1  No sky condition data available
99  Insufficient data

NOTE:

Two spaces are at the beginning of the line if data is available. One space is at the beginning of the line if –1 (no sky condition data available) or 99 (insufficient data) are output.

Examples:

V–1_h1h1h1...” (single space) no sky condition data available

V99_h1h1h1...” (single space) insufficient data available

VV9_h1h1h1...” (two spaces) vertical visibility only available

VV5_h1h1h1...” (two spaces) 5/8ths of sky covered in lowest layer

h1 (4 characters) = Height of the lowest cloud layer in 10 s of meters or 100 s of feet

d2 (1 character) = Cloud amount of the 2nd layer in oktas

h2 (4 characters) = Height of the 2nd cloud layer in 10s of meters or 100 s of feet (if no 2nd layer is reported, h2 = ////).

d3 (1 character) = Cloud amount of the 3rd layer in oktas

h3 (4 characters) = Height of the 3rd cloud layer in 10s of meters or 100s of feet (if no 3rd layer is reported, h3 = ////).

d4 (1 character) = Cloud amount of the 4th layer in oktas

h4 (4 characters) = Height of the 4th cloud layer in 10 s of meters or 100s of feet (if no 4th layer is reported, h4 = ////).

d5 (1 character) = Cloud amount of the 5th layer in oktas

h5 (4 characters) = Height of the 5th cloud layer in 10s of meters or 100s of feet (if no 5th layer is reported, h5 = ////).

CR LF = Carriage Return + Line Feed

NOTE:

Cloud amounts and heights cannot be reported until the SkyVue 8 has been operating for 30 minutes.

LINE 4

scaleVresVnVenergyVltVti_blVpulseVrateVsum CR LF

NOTE:

Notice the spaces which are indicated by 'V'.

where

scale (5 characters) = Scale parameter,%, 0 to 99999. 100% is default

res (2 characters) = Backscatter profile resolution in meters

n (4 characters) = Profile length

energy (3 characters) = Laser pulse energy, %.

lt (3 characters including leading +/-) = Laser temperature, degrees C

ti (2 characters) = Total tilt angle, degrees

bl (4 characters) = Background light, millivolts at internal ADC input (0 to 2500)

pulse (4 characters) = Pulse quantity x 1000 (0000 to 9999)

rate (2 characters) = Sample rate, MHz, (00 to 99)

sum = (3 characters) Sum of detected and normalized backscatter, 0 to 999. Multiplied by scaling factor times 104. At scaling factor 100 the SUM range 0 to 999 corresponds to integrated backscatter 0 to 0. srad-1.

CR LF = Carriage Return + Line Feed

LINE 5

SSSSSSSSSSSSSSSSSSSSSSSSSSSSS........(2048 x 5 bytes) CR LF

The two-way attenuated normalized backscatter profile (Backscatter profile reporting

CR LF = Carriage Return + Line Feed

LINE 6

ETX CRC-16 EOT CR LF

where

ETX = End-of-Text character
CRC-16 (4 characters) = CRC-16 Checksum
EOT = End-of-Transmission character
CR LF = Carriage Return + Line Feed