Appendix e. the anatomy of the voice image file – Campbell Scientific VSP3 Vosponder Voice Radio Interface User Manual

Page 51

Advertising
background image

E-1

Appendix E. The Anatomy of the Voice
Image File

The voice image file can be created using any basic word processor or text
editor that is capable of saving simple .txt files. The editor must not insert any
embedded control characters, visible or invisible. .RTF, .DOC, .HTM or any
other format is unacceptable. Most offer this as an option under the “save as”
file selection.

The constructed voice image file will appear similar to Example E-1.

Example E-1

000301The battery is|NY2volts.|02The temperature
is|NY1Degrees C.|03and it’s|NN0 Minutes it’s|minutes
into the day.|~

Here is a breakdown of the voice image file shown in Example E-1.

00 The first two characters are the “Image ID”. This field is always the first

in the image and instructs the Vosponder to load the image in a particular
location in the non-volatile memory.

03 The second two characters form the “Number of Records” field. This field

tells the Vosponder how many data points to expect to be reported from
the data acquisition system each time it sends a block of input locations.

01 The third set of two characters form the “Record Identifier” field. This

field starts with 01 for the first record and increments by one for each
successive field.

The next field is the “Preamble Text” to be spoken in front of the data
point. Remember the characters, ~ | {} are not allowed in any text string.

|

The character following the “Text Block” is the “End of Text Marker”.
This marker tells the Vosponder to speak the numeric data contained in the
appropriate Data Point.

N

The next field is the “Speak Sign” character. This field tells the
Vosponder how to deal with the sign, +/-, that precedes the data point. A
“Y” will say the sign as received, “N” will ignore the sign.

Y

Next is the “Speak Decimal Point” character. A “Y” speaks the decimal
point, an “N” ignores the decimal point. An “A” will say “and” in place of
the decimal point.

2

The “Number Right Digits to Speak” character is next. This field allows
excess digits right of the decimal point to be truncated. “0” (zero) speaks
none and any number equal to or greater than the quantity received will
speak all digits. Any number “0-7” may be entered here.

Advertising