AVP Amiga Voicemessage Player © 1994 Michael Krauß 1. Leagal stuff This software is still under development and I have decided, to distribute only the binary at the current stage. However, everyone is free to use and redistribute this archive, as long as all the files are not modified and remain together. This software may be included in CD-ROM distributions. This software is provided as is and I am not responsible for any damages it causes. Use it at your own risk. Remember: THIS IS STILL BETA ! 2. Software- and Hardwarerequirements This Software requires at least Kickstart 37.175. To play voicefiles in CELP-compression mode, you need a ZyXEL Plus Modem. AVP does not test, wether your modem is a 'Plus' version or not. If you tell AVP to play CELP on normal Modems, it will receive an error. I don't know, what will happen then, cause I have only a Plus modem to test. You have been warend. Beside this, AVP should be usable with any Amiga and any ZyXEL Modem. Note: There is a known problem with BUSY-detection in ROM-versions >6.00. The BUSY-handling has changed and I was not able to implement this yet. All other things should work fine, though. (I use 6.11a at the moment.) AVP is able to handle device-locking via OwnDevUnit.library. AVP expects OwnDevUnit.library to be available in your LIBS:-drawer. It has been testet with version 2 and 3 of ODU-library. If AVP can not open OwnDevUnit.library for whatever reason, it should continue without the device-locking stuff. NOTE: As I need OwnDevUnit.library in my system, I have not tested AVP without it. Please send me a bugreport, if anything fails. 3. Usage AVP is a CLI-command. You can only start it from CLI by typing 'AVP'. AVP uses the following template for the Options you can specify : 'Voicefile/A,Line/S,Dial=dial_string/K,Tone/S,Device=device_name/K,Unit=unit/K/N:' This template is Amiga OS compatible (I use ReadArgs() ). 'Voicefile/A' is a prerecorded Voicefile in ZyXEL format. This argument must always be specified. 'Line/S' is a switch, to tell AVP to use the Line to replay the voicefile instead of the internal speaker. The internal speaker is the default used, if nothing else is specified (see option 'Dial'). 'Dial=dial_string/K' is used to tell AVP to dial the number before playing the voicefile. 'dial_string' is send to the modem as is. It can have a maximum length of 15 characters. It is always prefixed with 'ATD'. 'dial_string' can contain any valid character the ATD-command understands. See your modem documentation for more details. 'Tone/S' switches the default dial method of the modem from pulse to tone. ('ATT' instead of 'ATP' is send before dialing.) 'Device=device_name/K' is used, to tell AVP which device it should use to communicate with the modem. The dafault device used is 'serial.device'. You can specify any valid device-name that is located in your devs:-drawer (e.g. Device=hkduart.device). Remember that device-names are case-sensitiv. The device you use must be compatible with the Commodore serial.device for the internal serial port. 'Unit=unit/K/N' is the number of the Unit to use. Default is '0'. If you have more than one serial port on the device you use, you can use the Unit-option to select one of them (e.g. Unit=2). 4. Device-Locking AVP uses OwnDevUnit.library to coexist with other programms, that are using the serial port. Please be sure to have OwnDevUnit.library available in your LIBS:-drawer. If the device AVP trys to use is already locked by another program, AVP puts out a message and terminates. If AVP can not open OwnDevUnit.library for whatever reason, it tries to continue without it. This is not tested, though. I strongly recommend using OwnDevUnit.library for compatibility reasons. 5. How You Can Reach Me Please send bugreports or any other comments on AVP or this readme to Michael Krauss Wildhubenweg 18 65428 Rüsselsheim FAX: [+49] (0)6142 35470 e-mail: mk@mkrara.rara.sub.org 6. Final Words I want to thank all betatesters for helping me testing and debuging this program.