Dear SCO Customer, The High Speed Modems Extended Feature Supplement (EFS) provides software to operate high speed modem devices. It includes a program that will allow a system administrator to create a dialer for a high speed modem, without a development system. It is designed to be used with SCO UNIX System V/386 Release 3.2 Version 2.0 or SCO's Open Desktop Release 1.1.0. Default dialer entries for the Hayes Ultra 96-2000US, MICC 9610, MULTITECH MT932EA, and U.S. Robotics Courier V.32 are included. These four modems have been tested to work at 9600 bps with CU and UUCP. To install the High Speed Modems EFS, perform the following steps: (1) Log in as root. (2) Make sure that your operating system installation includes the UUCP utilities. This can be accomplished by listing the available packages within custom utility and checking to make sure that the word YES appears next to UUCP. (3) Use CUSTOM to install the High Speed Modems EFS. Make sure you are at the / directory and type custom. From the custom menu choose Install A New Product. Next, choose Entire Product. You will then be prompted to insert the EFS diskette into your primary floppy disk drive. Insert the floppy in to the drive, close the drive door, then press . You will then be asked if you wish to continue installing the High Speed Modems EFS. Press return. After the message "Checking File Permissions" appears, you may exit the custom utility by pressing the key and the key. (4) The installation is now complete. If you have any questions, please call our SCO Customer Services Department at (800) 347-4381. SCO Customer Service is available Monday through Friday, 6:00 A.M. to 5:00 P.M., Pacific Time. We appreciate your business. SCO Support Services ________________________________________________________________________ 1. Making A Dialer 1.1 Introduction The High Speed Modems EFS (Extended Feature Supplement) allows system administrators to create dialers for modems. Historically, dialers were programmed using C code and were dedicated to a specific modem brand and model. The High Speed Modems EFS makes it possible to create a dialer for a modem without purchasing a development system or learning to program in C. To create a dialer, however, the system administrator should understand how the modem works. This guide was developed to help you understand the registers and what they do in a particular modem. Many different modems are available in the marketplace. They range in speed from 300 to 38400 bps. Note: SCO does not support serial communication speeds greater than 9600 bps. In some cases, higher speeds are known to work. Some modems also have data compression while others don't. Most modems use the AT command set that Hayes Corporation created, and is referred to as ``Hayes Compatible.'' The High Speed Modems EFS allows the system administrator to enable or disable the desired options by defining the ``setup strings''. Thus, the High Speed Modems EFS can configure each modem by putting the appropriate commands into the strings to be issued to the modem. Some newer, high speed modems can run the serial port at specified speeds, while the modem varies the line speed as needed. As discussed later, the modem must be prepared for this option by putting the appropriate commands in the ``option string'' and then ensuring that UNIX always ``talks'' to the modem at that speed. This preparation requires establishing /usr/lib/uucp/Devices to have the set speed as the highest speed available and /etc/inittab to use that same speed. You must also tell the program make.dialer that the connect speed for all connections is ``NOT USED,'' except for the ``9600'' entry. That entry can be modified to CONNECT 2400/rel, indicating a 2400 bps connection with 4X data compression on the MICC MNP Class 5 modem. This step creates a 9600 connection between two machines and may require adjusting the registers and serial line settings. Each time UUGETTY is run on a modem control port, the first dialer associated with that port in the file /usr/lib/uucp/Devices is executed to set up the modem for dial-in. This process is necessary for ensuring that the appropriate dialer is listed for each modem in this file. Although different dialers can run one modem if the default setup dialer is listed first, additional adjustments may be required. 1.2 Program atdialer Overview The key to the entire Configurable Dialer package, the program atdialer, is the C program that ``talks'' to the modem. The source code included with this package details how the program functions; the following discussion provides an overview of that process. The program atdialer reads information about the modem. This information enables atdialer to work, and includes data the program needs to talk to a particular modem. For example, atdialer must know the entry to set up a modem, and the response expected from the modem. If ``AT'' were typed to a Hayes Compatible modem, the response expected from the modem would be ``OK.'' atdialer looks for this information in a simple text file, created using a program called make.dialer. make.dialer is the support program that allows the text file from which atdialer reads modem specific information to be created. The concepts discussed below are useful for understanding how atdialer functions. In the SCO UNIX System V/386 Operating System, you can execute a program by typing its name on the command line. The name typed to run a program is called argv[0]. You can execute that same program by typing in a different name if a new name is linked to the old name. For example, if a program called TEST can be executed by typing ``TEST'' at the command line, the name ``TEST01'' can be linked to TEST. You then can execute TEST by typing TEST01 at the command line, known as the same program with a different argv[0]. In this same manner, atdialer knows which information to read to control a modem. The program atdialer reads the information contained in the file /etc/default/argv[0]. Therefore, a file with the same name as the program executed must exist in the default directory and contain information about the modem. If an MICC modem is used, atdialer is linked to the file atdialMICC for execution and /etc/default/atdialMICC contains the information needed to run the MICC modem. In addition to the above functions, atdialer ``talks'' to the modem. After it is called from the command line, CU, UUCICO, or UUGETTY, atdialer puts the modem into dial-in mode or establishes a connection to another modem. It then returns a status to the calling program. The status is either an error or the speed at which the request was processed. For example, if you type a CU command on the command line, CU calls the dialer program with arguments describing the speed, port number, and phone number. atdialer then attempts to make the modem on that port dial the given phone number and connect to a modem at the other end at the given speed. The modem then either makes the connection and returns a success status of the speed the connection was made, or it returns an error status, such as "BUSY" or "NO CARRIER." 1.3 Program make.dialer Overview The program make.dialer is the support file used to create data files for atdialer to read. Although you can use an editor to create the files that atdialer reads, this program provides a simple user interface, default values, and instructions for creating a new dialer. Section 1.4 provides an example of creating a dialer. This program creates a simple text file containing the information to run a particular modem. When make.dialer is executed, a short help screen is printed to the screen. This text emphasizes the need to understand the modem registers and suggests a naming convention for modem dialers. The program then asks for the name of the dialer to create and moves on to setup strings. Later, it will ask about answers the modem will return. This information is needed for atdialer to run properly. This program also gives instructions on how to build the new dialer by moving the text file to the appropriate location and linking another name to atdialer. As documented in the SCO installation manuals, make sure you create the proper /etc/gettydefs entry for the modem. The modem must use RTS/CTS flow control if UUCP is selected and these restrictions also apply to both /etc/inittab and /etc/conf/cf.d/init.base. Also ensure that /usr/lib/uucp/Devices, /usr/lib/uucp/Systems and /usr/lib/uucp/Permissions files are set up correctly. 1.4 Dialer Creation Example 1. Log in as root. 2. Change directories to /usr/lib/uucp. 3. Enter the following command: ./make.dialer The following is displayed on your screen: Some Help --------- The following string is an example of a modem setup string. It demonstrates some standard things that need to be set up in order to make a modem work with UNIX. Please make sure that you understand what each of the options does. AT&F&D2&C1S0=1S2=043\Q3&W The following is an example of a good dialer name for brand XY modem atdialXY When you are entering strings into this program simply press q to go on to the next question. You can hit the key to quit out of the program with no ill effects. Press to continue: Please enter the name of the dialer to create: atdialXY The current modem SETUP string is: "AT&F&D2&C1S0=1S2=043\Q3&W" Enter new modem SETUP string or 'q' to accept this one -> AT&F&D2&C1S0=1S2=043\Q3&W The current modem SETUP string is: "AT&F&D2&C1S0=1S2=043\Q3&W" Enter new modem SETUP string or 'q' to accept this one -> q The current OPTION STRING is: This string is usually left blank, but is included for modems that need an extra setup and response string pair. It is completely optional. Press q to continue without using this option RE-Enter OPTION STRING or q to accept this one: q The current RESPONSE STRING is: This string is usually left blank, but is included for modems that need an extra setup and response string pair. It is completely optional. Press q to continue without using this option RE-Enter RESPONSE STRING or q to accept this one: q The current modem DIAL string is: "ATDT" Enter new modem DIAL string or 'q' to accept this one -> q The current modem ESCAPE string is: "+++" Enter new modem ESCAPE string or 'q' to accept this one -> q The current modem HANGUP string is: "ATQ0H0" Enter new modem HANGUP string or 'q' to accept this one -> ATQ0H0 The current modem HANGUP string is: "ATQ0H0" Enter new modem HANGUP string or 'q' to accept this one -> q The current modem RESET string is: "ATQ0Z" Enter new modem RESET string or 'q' to accept this one -> q The current enable AUTOANSWER string is: "ATS0=1Q1" Enter new enable AUTOANSWER string or 'q' to accept this one -> q The current get modem attention string is: "AT" Enter new get modem attention string or 'q' to accept this one -> q The current modem DISABLE ESCAPE string is: "ATS2=128" Enter new modem DISABLE ESCAPE string or 'q' to accept this one -> q The current result code for OK is: "OK" Enter new result code for OK or 'q' to accept this one -> q The current result code for NO CARRIER is: "NO CARRIER" Enter new result code for NO CARRIER or 'q' to accept this one -> q The current result code for ERROR is: "ERROR" Enter new result code for ERROR or 'q' to accept this one -> q The current result code for NO DIALTONE is: "NO DIALTONE" Enter new result code for NO DIALTONE or 'q' to accept this one -> q The current result code for BUSY is: "BUSY" Enter new result code for BUSY or 'q' to accept this one -> q The current result code for NO ANSWER is: "NO ANSWER" Enter new result code for NO ANSWER or 'q' to accept this one -> q The current result code for 300 baud connection is: "CONNECT" Enter new result code for 300 baud connection or 'q' to accept this one -> q The current result code for 1200 baud connection is: "CONNECT 1200" Enter new result code for 1200 baud connection or 'q' to accept this one -> q The current result code for 2400 baud connection is: "CONNECT 2400" Enter new result code for 2400 baud connection or 'q' to accept this one -> q The current result code for 4800 baud connection is: "CONNECT 4800" Enter new result code for 4800 baud connection or 'q' to accept this one -> q The current result code for 9600 baud connection is: "CONNECT 9600" Enter new result code for 9600 baud connection or 'q' to accept this one -> q The current result code for 19200 baud connection is: "CONNECT 19200" Enter new result code for 19200 baud connection or 'q' to accept this one -> q The current result code for 38400 baud connection is: "CONNECT 38400" Enter new result code for 38400 baud connection or 'q' to accept this one -> q You now need to complete the dialer installation by moving the modem specification file into the standard default directory, and by creating the actual dialer binary. Do you wish to do this now? (y/n) y