Play / Queue Sound Command
Sound playout can be controlled via commands received via the serial port. Sounds may be started,
stopped, queued to play sequentially and the queue flushed using variations of the ‘p’ command:
<SOH> p {+/-/&/~/!} XX <ETX>
where:
Examples:
Start playing sound #25:
<SOH>p+19<ETX>
Stop playing sound #25 (if it was playing):
<SOH>p-19<ETX>
Stop playing all sounds (background sounds will resume):
<SOH>p-00<ETX>
Queue sounds #26 and #48 to be played in sequence:
<SOH>p&1A<ETX><SOH>p&30<ETX>
Stop playing the current sound and flush the queued sounds:
<SOH>p!00<ETX>
Up to 128 sounds may be queued. Sounds that are queued are played in succession in the order that they
were queued only when no other sound is playing until the queue is exhausted or flushed. Note that this can
occur at the end of the current background sound file before it repeats. A background or other sound that is
playing may be stopped by issuing a “
<SOH>p-00<ETX>
” serial command sequence to allow queued sounds
to be heard. The background sound will be resumed when the queue has emptied.
Volume Command
Sound volume may also be controlled via commands received via the serial port. The volume is
essentially decibel linear in sixty-four, 1db increments from -66db (value of 0) → 0db (value of 63). The
current volume level is ‘remembered’ in non-volatile memory on the CFSound-IV and is restored to the last
setting upon power-up.
Sound volume may be set, increased or decreased, faded up or down using variations of the ‘v’
command:
<SOH> v {=/+/-/</^/>} XX <ETX>
<SOH>
ASCII Start of Header character 01
16
(Ctrl-A)
p
ASCII lower case letter ‘p’
{+/-}
ASCII plus character ‘+’ to start a sound, minus character
‘-‘ to stop a sound
{&/~/!}
ASCII ampersand character ‘&’ to queue a sound, tilde
character ‘~‘ to flush the queued sounds, exclamation
character ‘!’ to stop the current playing sound and flush
the queued sounds
XX
ASCII two digit hexadecimal number XX
16
of the sound (01,
02, . . . , 7E, 7F, . . . , FE (maximum))
<ETX>
ASCII End of Text character 03
16
(Ctrl-C)
