旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � TDD v1.00 � � The Display Door � � (C) CalypsoWare/PCCS, 1994 � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 旼컴컴컴컴컴컴컴� � About TDD � 읕컴컴컴컴컴컴컴� The Display Door v1.00 Thank you for trying The Dispaly Door (TDD). This program is one many useful doors available from CalypsoWare(tm). TDD takes a simple ASCII text file and displays the information in ASCII ANSI and RIP graphic formats. The file may be of any length, with a maximum of 66 characters per line. The sysop can define if the user is allowed to read the whole document before exiting or allowing users the choice of continuing to read the document after each screen. TDD supports ASCII, ANSI, and RIP (Remote Image Protocal) graphics. TDD is fully interrupt driven and supports Fossils, DigiBoard COM/Xi boards as well as normal and non-standard com ports. The FIFO buffers of the 16550 UART chip are fully supported, enabling locked baud rates of up to 115,200 baud. TDD will monitor the carrier state and recycle if caller drops carrier. Other features include Sysop Chat, Sysop shell to DOS, "Twit" key, DESQView aware, and multi-user capable. For more information about other products from CalypsoWare, please call our support BBS at (714) 366-1355 or telnet to calypso.com. Voice support is also available at (714) 366-1350. 旼컴컴컴컴컴컴컴컴컴커 � About Shareware � 읕컴컴컴컴컴컴컴컴컴켸 Shareware is a method of software distribution designed to benefit both the software developer and the end user. Shareware (SW) should not be confused with Public Domain (PD) programs. While PD programs are released to the public with no restrictions attached to their use, SW programs are the copyrighted work of their authors. The SW programs are released to the public for evaluation purposes under the assumption that if the end user likes the program and continues to use it after a reasonable period of time, that user is obligated to register the program. If you purchased this program from a SW distributor, you have not registered it. You must still pay the programmer to register it. The money you paid to the distributor was to cover the cost of duplicating/advertising/etc the files. Programmers get to distribute their wares without the expense of advertising, packaging & distribution. The users benefit from being able to try out the programs without having to pay for the privilege of evaluation. Shareware programmers (the good ones anyway) are generally more responsive to bug reports & user requests for additional features. Everyone benefits provided that the users remember to register and programmers continue to ... well, program. 旼컴컴컴컴컴컴컴컴컴커 � Registration � 읕컴컴컴컴컴컴컴컴컴켸 Please fill out the file ORDER.FRM, copy it to your printer and mail it along with a check for $20.00 to Calypso Online Services at the address shown on the form. If you have access to a fax machine, you can fax a copy of the ORDER.FRM file along with a copy of your check if you are paying by check and we will arrange a direct withdrawal in the above amount. Or fill out the credit card information and we will charge the registration to your Mastercard or VISA account. Or if you want to register painlessly, you can now register TDD online at the CalypsoWare BBS at (714) 366-1355 with your MasterCard, VISA or by direct withdrawal from your checking or savings account.. By sending in your registration fee, you will be entitled to the following: 1) Removal of the UNREGISTERED message when door closes and the delay associated with that message. Once the door is registered, there will be now "Returning you to {BBS Name Here}..." either, so the door will be usable as a "pre-door" display as well as a general display door. 2) Continued use of this program on any single or multiuser BBS 3) Free upgrades to future versions 4) Enhanced support from programmer 5) The satisfaction of knowing that you are helping to make the shareware system alive 6) A jump to the next Karma level 旼컴컴컴컴컴컴컴컴컴커 � Requirements � 읕컴컴컴컴컴컴컴컴컴켸 1) TDD will only run on a BBS system that is capable of creating a DOOR.SYS file when a user opens a door. If your BBS will not create a DOOR.SYS file, there are conversion programs around to create a DOOR.SYS file from whatever your system creates. I strongly suggest that you ask your BBS software's author to support the DOOR.SYS standard! 2) TDD is designed to be run on any computer that is running an operating system that can emulate MS-DOS v3.xx or greater. 旼컴컴컴컴컴컴컴컴컴커 � Installation � 읕컴컴컴컴컴컴컴컴컴켸 To install TDD, simply copy all the files included in the original distribution disk (or archive file) into a single directory. The only files absolutely necessary to the operation of TDD are: TDD.EXE The door executable a configuration file used by TDD a screen file used by TDD and defined in configuration file above You will want to use a text editor to open TDD.CNF or create a new .CNF file. The Configuration format is as follows: D:\WILDCAT Your BBS Name Here 0 0 STANDARD 0 0 0 00000.0000000000 This is a Sample Banner TDD.SCR MORE Each line will be explained below: 1) This is the directory where TDD will find the DOOR.SYS file created by your BBS software when a user opens a door. If you wish to use environmental variables in place of a fixed directory name, then use the following formats: %VARIABLE% or \%VAR1%\%VAR2% or \WCWORK\NODE%WCNODEID% where the term between % signs is a valid environmental variable. 2) This is the name of your BBS. This is string that your registration number is keyed to. 3) This is the IRQ that should be used for the com port that you are using UNLESS you are using COM1 or COM2 in which case you will put a 0 here. A single environmental variable may be used here. (ex.: %wcnodeirq%) 4) This is the Base Port Address for the com port that you are using UNLESS you are using COM1 or COM2 in which case you will put a 0 here. A single environmental variable me be used here. (ex.: %wcnodeaddr%) Note, address will be a hexidecimal number. 5) This line is where you would indicate if you are running a STANDARD comm port or a DigiBoard. Your choices here are: STANDARD DIGIBOARD INT14/EBIOS FOSSIL The STANDARD interface is the one that will normally be used. If a sysop is using a DigiBoard, then either the DigiBoard or INT14/EBIOS interface may be selected. Most sysops will use the Int14/EBIOS interface. All input/output to the DigiBoard is performed via Interrupt 14 calls and a Device Driver (available from DigiBoard) handles the interface between the program and the board. The DIGIBOARD interface uses Direct Programming. TDD talks to the board directly without the need for a Device Driver. In order to use this interface, a program called RESETDIG.EXE must be used in the AUTOEXEC.BAT file to reset the DigiBoard once when the computer is first booted. If you do not have this program (it is a part of the GAP Communications BBS package) then the Int14/EBIOS interface must be used. The FOSSIL interface has been tested and confirmed to work with BNU and X00 fossil drivers. **IMPORTANT NOTE ABOUT FOSSILS*** (taken from the GAPCDR docs) Note that due to the limitations of the Fossil's Interrupt 14 interface, the highest baud rate that can be set is 38400 bps. It is possible to configure the Fossil Driver to lock the baud rate (BNU supports up to 38400 bps and X00 supports up to 115200 bps). When the port is locked, the Fossil Drivers are supposed to ignore any requests for a change in port speed (we have not confirmed if they actually do this). However, the GAPCDR Communications routines will reject any baud rate higher than 38400 bps and will return an error if you attempt to initialize the port at a higher speed. The BBS software must be configured for a port speed no higher than 38400 bps. 6) This is the DigiBoard Memory Window, or the address the board uses as a communications area between itself and the Host Computer. This line is used only if the Interface is set to DIGIBOARD. It can be set to 0 if the Interface is STANDARD or INT14/EBIOS. Valid entries are: C000, C800, D000, and D800 7) This is the DigiBoard I/O Port Address. This line is used only if the Interface is set to DIGIBOARD and can be set to 0 otherwise. Valid entries are: 100, 110, 120, 200, 220, 300 and 320 8) This is the DigiBoard Channel Number. This line is required for the DIGIBOARD and INT14/EBIOS Interfaces. It is normally 1-8 for the DIGIBOARD Interface and 4-11 for the INT14/EBIOS Interface. The Channel Number is similar to a Port Number. It tells the program which of the DigiBoard Communications ports to use. 9) This is where you will place your registration number you receive from CalypsoWare upon registering TDD. 10) This is the banner that will show at the top of every screen shown to the user. 11) This is the name of the file to display. As mentioned above, this file may be of any number of lines in length, but the lines must be limited to 66 characters/line. Any number beyond this will be truncated. YOU will be required to do any formatting (ie; centering) of the text within the 66 character line length limit. 12) This line defines which prompts TDD shows the users after each screen. On the last screen (or the first if the file is less than 9 lines long) will just offer users the option to continue on out of the door. Your choices for this line are: FORCED User must view the entire file and TDD will pause after each screen of information is displayed. MORE User is given a Yes or No option on whether they want to continue or not. REDISPLAY User is given the choice to continue, exit or redisplay the file from the top. 旼컴컴컴컴컴컴컴컴컴커 � Operation � 읕컴컴컴컴컴컴컴컴컴켸 Setup 컴컴� To run TDD door, you will need to create a batch file that will launch the door. For example: @echo off d: cd \TDD TDD TDD.CNF will work with most BBSes. Some others require that you call the BBS software at the end of a door batch file. Check with your BBS documentation. MULTI-NODE BBS NOTE: TDD will run on multiple node setups, but you must either create a seperate configuration file for each node or use environmental variables (as described above) to define the directory where the TDD door can find the DOOR.SYS file. 旼컴컴컴컴컴컴컴컴컴커 � Support � 읕컴컴컴컴컴컴컴컴컴켸 TDD is fully supported by CalypsoWare. We can be reached in the following manners (in the preferred order): 1) CalypsoWare Support BBS (714) 366-1355 (select option #2 at the PCCS Gateway Menu) 2) Internet: tdd.support@calypso.com 3) Fax (714) 366-1390 4) Voice Support (714) 366-1350 旼컴컴컴컴컴컴컴컴컴커 � Legal Disclaimer � 읕컴컴컴컴컴컴컴컴컴켸 (small print on) As with any program, every attempt is made by the programmer to kill all the bugs in the software before it is release to the public. Since this is all but impossible, it is recommended that new software should only be run (for the first time at least) when a current backup of your hard disk is available. When shareware is released for public evaluation, there is little that can be done on the programmer's end to prevent others from infecting the program with viruses or making unauthorized changes to the program. AS SUCH, user agrees to hold harmless BRETT W. MARTIN, LARRY HOOPER, MICHAEL J. GIBBS, PCCS, INC., CALYPSO ONLINE SERVICES, and CALYPSOWARE in regards to any personal, physical, emotion, financial, sexual or other damage that may occur to hardware, software or the user that may arise from the use of this program. Use of this program is considered to be acceptance of these conditions. This program remains the copyrighted work of CalypsoWare. When you register the program, you are granted a license to use this program on one (1) BBS system, regardless of how many nodes are active. You may sell your registered number to another if the following conditions are met: 1) All copies of the software and any documentation are transferred to the new owner. 2) You must discontinue use of the program following the sale. 3) The new owner must contact CalypsoWare to update our user records. This program may not be sold in it's unregistered form. It is intended to be distributed freely. Pay BBS systems are exempt from this requirement provided they are not charging specifically for access to this one program. Shareware distributors/User Groups may charge a nominal copying/library fee not to exceed $7.00. (small print off) 旼컴컴컴컴컴컴컴컴컴커 � Special Thanks � 읕컴컴컴컴컴컴컴컴컴켸 Special thanks go out to: My (Mike's) wife Lori , my sons Bobby and Adam for tolerating my weird ways. Brett Martin, for seeing, and believing in the vision that this concept can (and will) work! My (Brett's) wife, ... ya, ya, ya, same as Mike said. Mike Gibbs, for his tireless efforts in seeing this inital release to market. Larry Hooper, for the money. 旼컴컴컴컴컴컴컴컴컴커 � Appendix � 읕컴컴컴컴컴컴컴컴컴켸 Appendix A 컴컴컴컴컴 旼컴컴컴컴컴컴컴� � HISTORY: TDD � 읕컴컴컴컴컴컴컴� Version Date Fixes, Changes, etc. 컴컴컴� 컴컴컴컴 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 1.00 12/15/94 First public release of the door! Appendix C 컴컴컴컴컴 LEGAL NOTICES TDD, CalypsoWare, Calypso Online Services are the trademarks of PCCS. MS-DOS is the trademark of Microsoft. DESQView is the trademark of QuarterDeck Office Systems. GAP is the trademark of GAP Development. WILDCAT! is the trademark of Mustang Software, Inc. RIP is the trademark of Telegraphics.