FARGO electronic 7KDAB User Manual

7K Digital Audio Board

Revision 2.0

19-Aug-2007

Vyex LLC

www.vyex.com

INTRODUCTION 1

LIMITED HARDWARE WARRANTY 2

TRADEMARKS 3

INSTALLATION 4

Installation into the rack mount cabinet. 4 Installing the FLASH Card 5 Updating the 7K repeater controller firmware 6

USING THE DAB 7

LED Status indicator 7 Basic use 8 Supported WAV File formats 9 Things to consider when deciding file storage parameters 9 Recommended editing programs 10

STORING FILES ON THE FLASH CARD 10

Multi-Media Card adapters 10 File system requirements 11 File system structure for the Audio Files 12 Special files stored in the root directory 12

CONFIG.INI 12 DAB-MAIN.BIN 12 DAB-BOOT.BIN 13 7K-IMAGE.BIN 13 7K-PATCH.BIN 13

SPECIAL WORDS 13

9700 – Custom Delay 13 9701 – Long word continuation 13

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

9702 – Playback Speed Factor 14 9710 – Play Random File 14 9720 – Send Serial Characters 15 9790 – Force 7KDAB Reset 15 9796 – Load 7K Patch file 16 9797 – Provide RTC data to DAB 16 9798 – Load 7K-IMAGE.BIN 16 9799 – Save 7K-IMAGE.BIN 16

MORSE CODE FEATURES 17

Message File Location 17 Message File contents 17 Message file control characters 17

Pitch 17 Speed 18 Amplitude 18 Sending ‘Prosigns’ 18

7KDAB ‘Busy’ message 19

USING THE SERIAL PORT 20

Hardware Interface 20 Baudrate 20 Password 20 Connecting a Modem to the Serial Port 21 The Command Line Interface 22

CD – Change Directory 22 DIR – Directory command 23 DEL – Delete File 24 REN – Rename File 24 FIND – Find a file 24 SY – Send Y-Modem 25 RY – Receive Y-Modem 25 LO – Logout 25 REBOOT – Reboot DAB 25 SMHOST – Force Smart Host Present Flag 25 STOP – Stop current WAV file playback 26 TIME – Display or Set the current Time and Date 26 TYPE – Type a file to the console 26

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Command line interface commands available with 7K firmware 2.04 27

#!; - Issuing commands to the 7K 27 RFP – Remote Front Panel 28 SCRIPT – Execute text file to program the 7K controller 29

FIRMWARE UPDATE PROCEDURE. 30

MMC card reader/writer attached to your computer running Windows 30 Use your terminal emulator to transfer a file to the MMC card 30

APPENDIX A LIBRARY CONTENTS 31

7K SSM Words 31 Sean Caldwell Words 31 Test Tones 42

APPENDIX B ASCII CHARACTER CHART 43

APPENDIX C – MORSE CODE CHARACTERS 44

APPENDIX D VERSION HISTORY 45

Product Firmware Revisions 45 User Manual Revisions 45

1.2 – 21-Oct-2003 45

1.3 – 10-Dec-2003 45

1.5 – 9-Feb-2004 45

1.5a – 17-Feb-2004 45

1.6 – 20-Mar-2004 45

1.6a – 12-May-2004 45

1.7 – 25-July-2004 45

1.7a – 13-May-2006 45

1.8 – 14-Aug-2007 45

2.0 – 19-Aug-2007 45

APPENDIX E 7K VERSION 2.04 RELEASE NOTES 46

Disclaimer 46 Overview 46 New Commands 47

{PW} 16 Stop playback of current speech word 47 {PW} 24 xxxx Remove Command From Macro 47 {PW} 36 T F xxxx Modify ID Timers 47 {PW} 49 90/91/92/93 xx Message Handler Initial Message Delay 48 {PW} 49 94/95 xx Logic output pulse duration 48

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

iii

{PW} 76 ff yyyy (zzzz) IF-THEN-ELSE 49

New Switches 50

{PW} 63 16 x Daylight Savings time correction 50 {PW} 63 19 x Ignore Landline Busy Input 50 {PW} 63 33 x Enable “OK” Command Responses 50 {PW} 63 34 x Enable “?ERR” Command Responses 50 {PW} 63 35 x Courtesy message can be queued during message playback 50 {PW} 63 36 x Suppress command responses within macro execution 50 {PW} 63 92 x User Soft Switch 1 51 {PW} 63 93 x User Soft Switch 2 51 {PW} 63 94 x User Soft Switch 3 51 {PW} 63 95 x User Soft Switch 4 51 {PW} 63 96 x User Soft Switch 5 51 {PW} 63 97 x User Soft Switch 6 51 {PW} 63 98 x User Soft Switch 7 51

Changed Commands 52

{PW} 02 f … CTCSS Encoder 52 {PW} 40 r xxx Set Transmit Timeout Timers 53 {PW} 89 … Select DTMF Priority/Scan 53 {PW} 50 0/1 99 Review Initial and Normal Tail ID’s 53 {PW} 96 t xx Set DTMF Mute Delay 53 {PW} 63 xx 0/1/2/3 Set User Switch 53

New Message Types 54 Operational Changes 54 Bug Fixes and Changes 55 Version 2.04 55 Version 2.04a 55 Version 2.04b 55 Version 2.04c 55 Version 2.04d 55 Version 2.04e 55 Version 2.04f 56

APPENDIX F SCHEMATICS 57

APPENDIX G – DAUGHTER PCB INSTALLATION 61

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Introduction

Thank you for purchasing the 7K Digital Audio Board (DAB). The DAB has been designed as a “drop-in” replacement for the Speech Synthesizer board in the S-Com 7K repeater

controller, but does more than just talk. The DAB utilizes a fast, FLASH based, single chip microprocessor to support audio playback from a FLASH based Multi-

Media Card (MMC) which is used to store digitized speech files played back in response to commands from the 7K repeater controller.

The MMC media card is the same type of solid state storage media that is used in many consumer devices such as cameras, personal digital assistants, and MP3 players. The file system used on the FLASH card is the same FAT16 file system used on desktop computers for years and is thus compatible with any third party MMC I/O device that supports this type of file system. The FAT16 file system constrains the total storage space to approximately 2 Gigabytes, which provides the potential to store hours of audio material. The user is free to upgrade the amount of storage space available at any time simply by purchasing higher capacity FLASH cards from the vendor of their choice.

The audio files are stored in the well-known WAV file format, which is a subset of the Microsoft Resource Interchange File Format (RIFF) file format. This flexible file format supports dozens of different audio compression methods, of which the DAB supports only a few specific types.

The DAB also has an RS-232 serial port that can be used to send or retrieve files from the FLASH card in order to allow the update of audio files, product firmware, and to make product configuration changes.

The DAB’s product firmware is fully field updateable and new firmware revisions can be installed by the end as they become available.

If you have any questions or comments regarding this product, please know that your feedback is always appreciated.

Contact information: Vyex LLC

S64 W24740 Susan Street Waukesha, WI 53189

262.513.0150

support@vyex.com

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Limited Hardware Warranty

Vyex LLC warrants that its products will be free from defects in materials and workmanship for a period of one year from the date of shipment.

This warranty does not cover damage caused by any of the following:

• Physical damage of any kind.

• Improper installation or connection.

• Electro-static discharge damage caused by improper product handling.

• Lightning.

• Any product in which the customer has attempted to make field repairs or modifications.

During the term of the warranty, Vyex LLC will cover the cost of product repair including parts, labor and return shipping. Vyex LLC may not support all third party manufacture’s Multi-Media Cards as viable storage devices for use with this

product. Vyex LLC reserves the right to refund the purchase price as its exclusive warranty remedy. For service contact Vyex at 262.513.0150 Any product return must include a Return Materials Authorization (RMA) number on the outside of the package.

The product software and associated audio files represent copyrighted materials, an original work of Vyex LLC. Vyex LLC retains all right, title, and interest in and to the Software, and any rights not granted to you herein are reserved

by Vyex LLC. You may not reverse engineer, disassemble, decompile, or translate the Software, or otherwise attempt to derive the source code of the Software, except to the extent allowed under any applicable law. If applicable law permits such activities, any information so discovered must be promptly disclosed to Vyex LLC and shall be deemed to be the confidential proprietary information of Vyex LLC.

Vyex LLC provides the following End-User License Agreements with respect to the software it distributes. An End-User License Agreement is a legal agreement between you (either an individual or a single entity) and Vyex LLC for a Vyex LLC software product. Such software product includes computer software and may include associated media, printed materials, and "online" or electronic documentation ("SOFTWARE PRODUCT"). By installing, copying, or otherwise using the SOFTWARE PRODUCT, you agree to be bound by the terms of the End-User License Agreement. If you do not agree to the terms of the agreement, do not install or use the SOFTWARE PRODUCT; you may, however, return it to your place of purchase for a full refund.

You may permanently transfer all of your rights under this End-User License Agreement, provided the recipient agrees to the terms of this End-User License Agreement.

All title and copyrights in and to the SOFTWARE PRODUCT (including but not limited to any images, photographs, audio, and text, incorporated into the SOFTWARE PRODUCT), the accompanying printed materials, and any copies of the SOFTWARE PRODUCT are owned by Vyex LLC or its suppliers. The SOFTWARE PRODUCT is protected by copyright laws and international treaty provisions. Therefore, you must treat the SOFTWARE PRODUCT like any other copyrighted material.

Vyex LLC expressly disclaims any warranty for the SOFTWARE PRODUCT. The SOFTWARE PRODUCT and any related documentation is provided "as is" without warranty of any kind, either express or implied, including, without limitation, the implied warranties or merchantability, fitness for a particular purpose, or noninfringement. The entire risk arising out of use or performance of the SOFTWARE PRODUCT remains with you.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

In no event shall Vyex LLC or its suppliers be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use of or inability to use this Vyex LLC product, even if Vyex LLC has been advised of the possibility of such damages. Because some states/jurisdictions do not allow the exclusion or limitation of liability for consequential or incidental damages, the above limitation may not apply to you.

LICENSEE understands that the Software is subject to export control laws and regulations. LICENSEE may not download or otherwise export or re-export the software or any underlying information or technology

except in full compliance with all United States and other applicable laws and regulations. LICENSEE is responsible for paying any sales or use tax imposed at any time whatsoever on this transaction. LICENSEE acknowledges that LICENSEE has read this Agreement, understands it, and agrees to be bound by its terms

and conditions. This Agreement embraces the full and complete understanding of the parties as to the subject matter hereof and supersedes any prior agreement, whether written or oral, relating to the subject matter hereof, and may not be altered or modified, except by written amendment which expressly refers to this Agreement and which is duly executed by authorized representatives of both parties. If any part of this Agreement is found void and unenforceable, it will not affect the validity of the balance of the Agreement, which shall remain valid and enforceable according to its terms. Further, this Agreement shall be construed and governed in accordance with the laws of the State of Wisconsin, excluding the application of its conflicts of law rules.

Trademarks

MultiMediaCardTM is a trademark of Infineon Technologies AG Microsoft, Windows, and MS-DOS are registered trademarks of Microsoft Corporation. All other brand and product names are trademarks or registered trademarks of their respective companies and are hereby

acknowledged.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Installation

CAUTION: The DAB is a static sensitive electronic device. Proper precautions should be exercised when handling the DAB. Installation and connection of the DAB can only be performed with power removed from the controller.

Installation into the rack mount cabinet.

The DAB is installed in the controller cabinet to the left of the repeater controller circuit board and secured in place with four 6-32 screws.

Using the supplied ribbon cable, connect the ribbon cable between J4 on the DAB and the speech board connection, P8, on the 7K repeater controller PCB.

As the 7K does not use a keyed or shrouded connector, use due caution when making the connection to the 7K connector. If the cable is not inserted correctly, severe

damage may occur to the DAB and will not be covered by warranty.

If the serial port on the DAB will be utilized, the short ribbon cable assembly containing the DB-9 connector can be connected to J3 on the DAB. The method of routing the cable out of the 7K cabinet and/or mounting of the DB-9 connector in the cabinet is left to the end user. Please note that the modification of the controller cabinet may void your warranty with S-Com.

If you do attempt to modify the cabinet, please use proper precautions to guard against physical damage to the circuit boards inside the cabinet, and against any metal debris which could potentially short components on the PCB’s.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Installing the FLASH Card

The multi-media FLASH card should be inserted into the connector as shown, with the gold contacts facing downward. When the card is not installed in the DAB, do not touch the gold contacts.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Updating the 7K repeater controller firmware

An EPROM containing new firmware for the 7K has also been included with the DAB. This new firmware provides better integration between the DAB and 7K controller as well as providing new, generic, features to the 7K itself.

When version 2.04 firmware is installed in the 7K, the 7K will need to be re-initialized before it will work, and the user will need to reload their program into the controller.

The DAB will work with any version of S-Com firmware that supported the speech synthesizer module, and you may elect to defer the installation of the new controller firmware.

If your controller is not already at a 2.x version status, and you wish to utilize the new firmware, you will need to contact SCom regarding upgrading other components on the 7K controller board.

To change the Firmware, use an IC extraction tool to exert equal force on each end of the old EPROM while pulling straight up. Place the old EPROM in conductive foam, and then install the new EPROM as shown in the picture below. Pin one, on the notched end of the EPROM, should be facing towards the rear of the cabinet.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Using the DAB

LED Status indicator

The DAB has a dual color surface mount LED mounted near the board edge near the FLASH card connector. If the FLASH card is present upon power up, the dual color LED on the DAB should briefly illuminate green as the FAT file

system code initializes its internal variables. If the FLASH card is removed, both LED’s will illuminate and provide a yellowish glow to indicate the absence of the card. When the FLASH card is present, if the LED glows solid Red, with brief flashes of Green, this indicates that the FLASH

media is not correctly formatted. In normal operation, the Green LED will flicker when the FLASH card is being accessed for reading, and the Red LED will

flicker when the FLASH card is being accessed for writing.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Basic use

In its simplest form, the DAB will mimic the original S-Com speech synthesizer board, and thus it is compatible with any version of 7K firmware that supported the speech board.

The default speech library included with the DAB includes digitized versions of the original TI speech synthesizer vocabulary. The recordings of the TI speech synthesizer have been low pass filtered to provide a sound which is less harsh than the original speech synthesizer.

In addition to the original vocabulary, additional words have been recorded by a professional voice over talent. The list of those words can be found in Appendix A.

If the user wishes to have custom words and phrases recorded in the same voice they may contact: Sean Caldwell, KF4IWT Phone: 212.898.1222

http://www.seancaldwell.com/

Sean has agreed to contract with the end users of this product for a very reasonable price.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Supported WAV File formats

For those that wish to create their own WAV files, you will need to know about some specific constraints of exactly what the DAB does and does not support.

PCM. 8 or 16 bit linear (uncompressed) values, in either mono or stereo format. The maximum supported sample rate is

22.05kHz. muLaw. This is a logarithmically compressed format which stores 8 bits per sample and expands to approximately 12 bits

of precision. Mono and Stereo forms are supported. The maximum supported sample rate is 22.05kHz. IMA/DVI ADPCM. Adaptive Delta Pulse Code Modulation essentially stores the difference from one sample to the next.

Several different ADPCM methods and subsets are part of the WAV file specification, the one that the DAB supports is specifically this type, with 4 bits per sample, in mono format only. The maximum supported sample rate is 16kHz.

For the types that support stereo file playback, no attempt is made to “mix” the two channels together and the data stream for only the left channel will be audible.

If a WAV file is stored using an unsupported compression method, or at too high of a sample rate, the DAB will simply treat the file as a missing file and refuse to play it.

Things to consider when deciding file storage parameters

If the user wishes to provide for the highest fidelity playback, then the files should be stored as 16 bit PCM files. Using this storage method consumes two bytes of disk space per sample.

If the user wishes to conserve as much disk space as possible, then the ADPCM compression method is recommended. Using this storage method, two samples are stored in one byte of disk space.

The default speech libraries included with the DAB utilize muLaw compression for the TI speech synthesizer recordings, and ADPCM for the live recordings. Both types are sampled at 11.025kHz.

It was found that applying ADPCM compression to the TI synthesizer recordings resulted in objectionable artifacts when the files were played, but these same artifacts were not nearly as noticeable for the live recordings.

The practical limit of a narrowband FM voice channel is about 48dB Signal to Noise ratio, so what may sound objectionable in your recording studio, may be inaudible to the end user.

Sample rates higher than 11.025kHz will be of little practical use when the high frequency rolloff of a normal twoway radio is considered. In fact, the end user may find that recordings at 8kHz sample rates are quite satisfactory.

When making your own live recordings using “built-in” audio hardware in your budget desktop computer, you may find that recording at these lower sample rates results in muddy sounding audio, and come to the conclusion that even a 22.05kHz sample rate just isn’t enough. In this case, the real culprit is the poor performance of the low cost audio card in your computer. Here you have two potential solutions. Either record at a higher sample rate, such as 44.1kHz and then downsample to a lower rate, or buy yourself a professional grade audio card that doesn’t have these same performance limitations.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

Recommended editing programs

Adobe Audition, formally Syntrillium Software’s Cool Edit Pro product, is a preferred tool we use here.

http://www.adobe.com/

SoX – Sound eXchange is a useful tool that claims to be the “swiss army knife of sound processing programs”. This useful utility can convert from just about any sound format to another format, change sample rates, pitch, speed, filter, etc.

http://sox.sourceforge.net/

Goldwave – is a low cost, simple digital audio editor.

http://www.goldwave.com/

Sound Forge – is a higher end digital audio editor, with capabilities similar to Adobe’s Audition product.

http://www.sonicfoundry.com/

There are literally hundreds, if not thousands of software utilities available to edit, and manipulate WAV files, and to cover them all in this manual would be impossible. The short list above represents those we have direct experience with and wouldn’t hesitate to recommend.

Storing files on the FLASH card

Multi-Media Card adapters

A wide range of options exist in both internal and external FLASH card adapters that are compatible with modern desktop computers. One of the most common adapters plugs into the USB port on your computer and allows you to read and write files to one or more FLASH card media types.

These types of media adapters can generally be purchased new for less than $20 at your local computer store. Due to the variety of products available, it is beyond the scope of this manual to provide a tutorial on their use.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

File system requirements

The Multi-Media Card needs to be formatted with a DOS FAT16 file format. For smaller media types, the default of the format program you utilize may format the card with a FAT12 file system, and you will need to override the default settings.

Example: To format a 16MB card under Windows 2000, open a Command Prompt Window and type:

FORMAT d: /a:1024

Where ‘d’ equals the drive letter corresponding to the MMC card, and 1024 equals the size, in bytes, of each cluster. You will be prompted:

Insert new disk for drive d: and press ENTER when ready...

Hit [Enter] to continue.

The type of the file system is FAT. Verifying 15M Initializing the File Allocation Table (FAT)... Volume label (11 characters, ENTER for none)?

Hit [Enter] to continue.

Format complete.

15,960,064 bytes total disk space. 15,960,064 bytes available on disk.

1,024 bytes in each allocation unit. 15,586 allocation units available on disk.

16 bits in each FAT entry.

Volume Serial Number is 10D5-D722

The key thing here is to select a cluster size for the disk that results in the format program showing a summary of “16 bits in each FAT entry.”.

The most efficient disk utilization will generally be realized when the smallest possible cluster size is selected, however other factors, such as the increase in the FAT table size may offset any gains that may occur through any increase in disk utilization efficiency.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

File system structure for the Audio Files

The WAV files need to be stored in a predetermined manner in order on the FLASH card. The Root directory needs to contain a “WAV” subdirectory, and the WAV subdirectory needs to contain additional four

digit numeric subdirectories corresponding to the “hundreds” portion of the word number to be spoken. Within each of those subdirectories, up to 100 WAV files can be stored.

The file naming convention for each WAV file simply correlates one-for-one with the word number issued from the 7K command 15.

For example if you wanted to associate a given WAV file with word 3024 you would name the file “3024.WAV” and store it in the “\WAV\3000\” subdirectory. Similarly word 0007 would be named as “0007.WAV” and stored in the “\WAV\0000\” subdirectory.

With the exception of the reserved word “0000” and words greater than “9699”, you may utilize as many of the word numbers as you like, up to the limits of the storage space on your FLASH card.

Special files stored in the root directory

CONFIG.INI

This text file contains user settings that need to survive a power failure. It is a simple text file that contains a variable keyword, equals sign, and desired setting for the associated parameter.

Comment lines can be preceded with a semicolon, or simply contain white space. The supported keywords are:

• BaudRate. Specify any standard baudrate up through 115200 baud. If not specified, the default baudrate of 115200 baud will be used.

• Password. This is the case sensitive password used to protect access to the serial port. Only the first 8 characters are used, and if not specified, the serial port will not require a password.

• BusyMsg. Specify a Morse code message to be played when the 7K commands the 7KDAB to play a file during periods when the file system is busy. Only the first 9 characters are used. If not specified, the default message of “BZ” will be used.

Example file contents:

; Configuration file for 7K-DAB BaudRate = 38400 Password = Secret BusyMsg = WR9ACY/R

DAB-MAIN.BIN

This file contains the microcontroller’s firmware. If this file exists, its contents are checked against the current program stored in the microcontrollers own FLASH memory. If they are different, the microcontroller will reprogram itself and reboot to begin execution of the new firmware.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

DAB-BOOT.BIN

This file contains the small bootstrap loader used to reprogram the microcontroller. If this file exists, its contents are checked against its program storage space in FLASH memory. If they are different, the microcontroller will reprogram this portion of the FLASH memory.

7K-IMAGE.BIN

This file contains an image of the 7K controller’s battery backed SRAM. Special commands can be used to save or restore the contents of the controllers programming.

7K-PATCH.BIN

This file contains a program image of the 7K firmware patch area.

Special Words

Words 9700 through 9799 have been reserved for use by the DAB. When these special words are “spoken” they trigger special things to occur. Some of the functions represent a stand-alone function performed by the DAB and others represent a cooperative effort between the new firmware on the 7K and the DAB.

9700 – Custom Delay

When this word is spoken, the word that follows it is used as a delay factor with its time specified in milliseconds. For example, “9700 1000” would cause a 1 second silent pause during playback. The maximum delay that can be specified is 5000ms.

9701 – Long word continuation

With 7K firmware revisions prior to 2.04, there is a hard coded timeout timer in the 7K firmware designed to detect a failed speech board. While the 7K documentation documents this timeout timer as being 5 seconds, in reality a software bug caused it to be 25 seconds.

In order to allow a DAB user to playback a speech file longer than 25 seconds, the DAB has a timer which artificially signals the 7K that a phrase has been completely spoken even though playback continues. If the next word received is 9701, the DAB will continue to play the file already in progress, and approximately 25 seconds later signal the 7K that the phrase has been completely spoken.

For example, “{PW} 15 9960 5000 9701 9701 9701” would allow 5000.WAV to play for approximately 100 seconds if needed.

There is no harm in issuing too many 9701 continuation words. If no playback is in process, the DAB will simply handshake with the 7K and move on to the next word.

This command is not needed with version 2.04 firmware as the keep-alive handshake will occur automatically in the background.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

9702 – Playback Speed Factor

When this word is spoken, the word that follows it is used as a playback speed multiplier against the playback rate specified in the WAV file header. The word value supplied is specified as a percentage of the playback speed with 0100 (100%) being the normal playback rate.

The value specified can range from 1 to 255%, but if the resulting playback rate exceeds the sample rate limits for the WAV file, the playback rate will be limited to appropriate maximum playback rate.

The playback speed factor is a static value which defaults to 100% on reset. Whenever a user supplied value is specified, that playback speed factor remains as the new playback rate until either a new factor is specified, or until a reset occurs.

For example, “{PW}15 9960 9702 0120” would set the playback rate to 120% of normal speed.

9710 – Play Random File

When this control word is issued, the next two word values are used as a starting and ending word value for the controller to psuedo-randomly play an audio file within the inclusive range supplied. There is no restriction on the start or end value other than that they need to be in the range of 0001 through 9699.

Due to the integer math used, and the fact that any pseudo-random number generator has its limitations, the user will find that the span will affect the apparent randomness of the file chosen. Spans that represent a power of two will appear to give the best degree of randomness, but the span may be of any desired size and should still to be sufficiently random for the purposes of this function.

Some examples: {PW} 15 9960 9710 3000 3010 ;play one audio file from the range of 3000 – 3010

{PW} 15 9960 9710 1000 4000 ;play one audio file from the range of 1000 - 4000 {PW} 15 9960 9710 4021 4022 ;play either audio file 4021 or 4022

Note: This will also select and play CW files included within the selection range, so it is conceivable to mix audio tracks with CW messages if desired.

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

9720 – Send Serial Characters

In order to allow a modem to share the same phone line that the repeater controller is connected to, one or more macros will need to be created in the 7K to cause the modem to answer, or place a call on its own.

Once special word 9720 is encountered, the decimal of each word encountered after it will be used to determine which ASCII character to send on the serial port. Any word value greater than 0256 will exit the ASCII character mode.

A null character can be sent by using a word value of 0256. A chart of ASCII characters is provided in Appendix B. In the following example, two macro’s are created to allow the 7K to answer the phone line. The first macro causes the

modem to generate answer tones, and then, after pausing, executes a second macro to cause the 7K to hang up the phone line. The delay in this process ensures that the phone call is not dropped in the process of handing off the call to the modem.

; Macro 5782 sends “ATA<CR>” to modem, delays for 2 seconds, then triggers macro 5783 {PW} 20 5782 {PW} 15 9960 9720 0065 0084 0065 0013 0500 9700 2000 9999 5783

; Macro 5783 disconnects Autopatch line. {PW} 20 5783 {PW} 83

If you wanted the repeater to call you back on a separate modem line you could configure macro’s as follows. ;Macro 5784 disconnects the autopatch line, pauses for two seconds then sends “ATDT5551212<CR>”.

{PW} 20 5784 {PW} 83 {PW} 29 5784 {PW} 15 9960 9700 2000 9720 0065 0084 0068 0084 0053 0053 0053 0049 0050 0049 0050 0013 0500

Obviously you will need to replace 555-1212 with the phone number you desire the modem to call.

9790 – Force 7KDAB Reset

In the event that the 7KDAB firmware should get “stuck”, it may be possible to issue this word to force the 7KDAB to reset. Although the 7KDAB does contain a hardware watchdog that will reset the CPU in the event that the 7KDAB should stop

executing as desired, there may be unforeseen situations where the software may appear to operate properly yet fail to respond to the serial port. Because the 7K host interface software operates at an interrupt level, it may be possible for the 7KDAB to respond to this command.

Example: {PW} 15 9960 9790

7KDAB, Version 2.0, 19-Aug-2007

 Vyex LLC, 2003-2007

+ 46 hidden pages