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
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 |
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 |
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 |
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
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
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
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
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
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
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
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
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
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
Cloud amounts and heights cannot be reported until the SkyVue 8 has been operating for 30 minutes.
LINE 4
scaleVresVnVenergyVltVti_blVpulseVrateVsum CR LF
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