Cyclades Cyclom-Y Operating and maintenance instructions

1
Quick Installation Manual
Cyclom-Y
Cyclades Corporation

2
DESCRIPTION OF THE DOCUMENTATION FOR THE CYCLOM-Y BOARD
The Cyclom-Y is accompanied by an Installation Manual (included in the Documentation CD)
and this Quick Installation Manual which repeats some sections of the Installation Manual for
convenience during the installation process. Since it is difficult to read an electronic
installation manual while installing a board or a driver, the instructions for hardware installation
and driver installation are provided here.
The Installation Manual (in Adobe pdf format on the Documentation CD) should be read
before starting. It contains the following chapters:
Chapter 1 What is in the Box -- explains what goes where and how to upgrade.
Chapter 2 Hardware Installation -- repeated below for PCI boards, ISA information
available only on the CD.
Chapter 3 Software Installation -- repeated below.
Chapter 4 Troubleshooting -- what to do if at first you do not succeed.
Chapter 5 Electrical Installation Requirements
Appendix A Pinout Diagrams
HARDWARE INSTALLATION
The body carries static electricity and if the person installing the Cyclom-Y is not correctly
grounded, the board could suffer irreversible damage. Please follow the instructions outlined
below carefully to avoid harming the board.
Step One:
Unplug the computer and remove all cables connecting the computer to other devices.
Step Two:
Carry the computer to a workbench or table where an anti-static wrist-strap is available. It is
highly recommended that a wrist-strap be used. Remove the computer cover, exposing the
boards inside. Attach the wrist-strap to your wrist.
.

3
Step Three:
Be careful to not touch any components inside the computer’s chassis, as they also can be
damaged by static electricity. Confirm that the wrist-strap is grounded. If a wrist-strap is not
available, touch a non-painted, metallic part of a computer plugged in to a wall outlet to
remove any excess charge. Remove the board from its anti-static packaging, being careful to
not touch the components or metal parts of the board.
.
ISA Slot
PCI Slot
If the board is an ISA model, select an available IRQ and address window (the factory
defaults are IRQ 10, address 0xD4000) and configure the dip switches accordingly. ISA
boards use one IRQ line and one 8 KB window in the ISA Memory Address Space. Make
sure that the parameters selected do not conflict with any other adapter already installed in
the system.
Step Four:
If the board has a PCI interface, insert it carefully into any unused PCI slot. If it has an ISA
interface, insert it carefully into any unused ISA slot. The external connector should be
aligned with the opening in the back of the computer. Make sure that the board does not
touch any metallic parts of the interior of the computer.

4
Step Five:
Fasten the bracket to the back panel of the computer with a screw. Replace the computer’s
cover and replace the screws. Now you can remove the wrist-strap.
SOFTWARE INSTALLATION
SCO Open Server and ISC UNIX
Overview
The Cyclom-Y UNIX SVR3 driver supports:
• SCO UNIX System V R3.2 v5.x (Open Server 5) or v4.x (SCO UNIX, ODT 3.0)
• ISC UNIX 3.0
The driver is known to work in other SVR3 systems with workarounds during the installation
process. Try it at your own risk, knowing that Cyclades only supports the operating systems
mentioned above.
Once the driver is configured, Cyclom-Y ports are accessible as a standard tty to any UNIX
application.
How to Install the Device Driver
The Cyclom-Y UNIX SVR3 driver is provided on a 3.5’’ floppy diskette (tar/custom format).
The driver is installed using the standard SCO Software Installation mechanism (custom).
Cyclades recommends that the Cyclom-Y board be installed first and that hardware confilicts
be elimiated before installing the driver.
Turn the computer on, booting UNIX, and log in as root.
In SCO Open Server 5, double-click on the Software Manager icon to start the installation.
In SCO UNIX SVR3.2 v4.x and ISC UNIX, execute “custom” to start the installation.
After the new kernel is built and installed, shut down and restart the computer. Verify the
driver’s boot messages to confirm that the board was recognized and initialized.

5
Configuration Issues
For additional information on how to configure serial ports in UNIX, refer to the system
documentation.
The devices under the /dev directory are:
ttyy1a, ttyy1b... ; ttyy1A, ttyy1B... for the first board
ttyy2a, ttyy2b... ; ttyy2A, ttyy2B... for the second board
ttyy3a, ttyy3b... ; ttyy3A, ttyy3B... for the third board
ttyy4a, ttyy4b... ; ttyy4A, ttyy4B... for the fourth board
Devices with lowercase letters in the name are for local terminals and printers (DCD is
ignored on these ports). Devices with uppercase letters are for modem connections.
To enable a local terminal at the port ttyy1a for login, use the command enable /dev/ttyy1a.
By default, the Cyclom-Y ports are enabled at 19200 bps, 8 bits, no parity, 1 stop-bit. Serial
printers are enabled by using the system administration tools provided by the operating
system.
The Cyclom-Y SVR3 Driver has a special feature called “Extended Baud Rate.” The Cyclom-
Y allows serial speeds up to 115.2 Kbps but SCO UNIX termio structures do not support
speeds above 38.4 Kbps.
The Cyclom-Y driver is initially in “Normal Mode” (termio compatible) and supports the
standard speeds up to 38.4 Kbps. Using the “cyytty” utility, it is possible to activate the
“Extended Baud Rate” mode. The execution of the cyytty can be placed in the system
initialization (rc files) to activate the extended mode automatically after the boot.
In “Extended Baud Rate mode,” the lower speeds in the termio structure are mapped to
speeds above 38400: 50bps is mapped to 57.6kbps, 75bps is mapped to 76.8kbps and
110bps is mapped to 115.2kbps.
The syntax of the cytty command is:
cytty <nrm|ext> [dev]
Where:
nrm turns the Extended Mode off, “ext” turns the Extended Mode on and dev
optionally indicates the device (default: current terminal).
Linux
Overview
The Cyclom-Y Linux driver is included in the standard Linux Kernel Distribution since early
kernels in the 1.1.x series. Once the driver is configured, the Cyclom-Y ports are accessible
as standard UNIX ttys to any application running in the Linux operating system.

6
How to Install the Device Driver
The Cyclom-Y Linux driver is already in the kernel distribution tree. Normally, there is no need
to apply patches or install files. Be aware, however, that the Linux system is constantly
evolving and it is very difficult to keep documentation updated. Refer to the README files in
the Linux distribution package for the latest information.
To configure the Cyclom-Y driver in the kernel:
Refer to Chapter 2 when installing the hardware in order to eliminate hardware conflicts.
Turn the computer on, booting Linux, and log in as root. Configure the kernel :
# cd /usr/src/linux
# make config
<Answer “Yes” when asked about Cyclom-Y support>
<If installing a PCI board, answer Yes to PCI support>
Rebuild and install the kernel
# make zlilo
Reboot the computer and check the Cyclom-Y message on boot (use “dmesg” if
necessary).
Optionally, the Cyclom-Y driver can be configured as a loadable module instead of a
kernel driver. Follow the steps above but answer “M”— Loadable Module to the
Cyclom-Y support when configuring the kernel.
Verify that the driver reports the IRQ, address and number of ports for each board
installed.
Create the special devices in the /dev directory. If you have a 1.2.x kernel, use “mkcyc”,
available in the Linux distribution package. For 2.x.x kernels, use the standard Linux
MKDEV.
Configuration Issues
For additional information on how to configure serial ports in Linux, refer to the Linux
documentation, Linux FAQ’s and newsgroups or see the README file included in the Linux
distribution package.
The Cyclom-Y driver normally uses the device names ttyC0, ttyC1, ... for dial-in (major
number 19) and cub0, cub1, ... for dial-out (major number 20).
To enable a serial port for dial-in, start a getty process by editing the /etc/inittab file.

7
Microsoft Windows NT
Overview
The Cyclom-Y NT driver supports Microsoft Windows NT version 3.51 or 4.0.
Once the Cyclom-Y NT driver is installed in a system, the Cyclom-Y serial ports are seen by
the NT applications as generic COM ports. Remote access, terminal emulation and bulletin
board services are some examples of applications that use serial ports in the NT environment.
How to Install the Device Driver
The Cyclom-Y NT driver is provided on a 3.5’’ floppy disk or can be downloaded from the
Cyclades Web site. Read the file readme.txt before beginning installation. It will describe any
changes made to the driver since this manual was published.
To install the driver in NT 3.51:
1. Turn the computer on, booting Windows NT, and login.
2. In the Control Panel window, double click on Network.
3. Windows will display the Network Settings dialog box.
4. Click on the Add Adapter... button.
5. Windows will present a Add Network Adapter list.
6. Select <Other>Requires Disk from Manufacturer at the end of the list and click
Continue.
7. Insert the Cyclom-Y NT Driver disk or enter the path of the directory where the driver
files are located.
8. Windows will copy the driver files and open the Cyclom-Y NT Driver Setup dialog
box.
9. Configure the Cyclom-Y NT Driver (use the help function if necessary).
The parameters are the following:
• Not Installed: If the Board is not installed.
• PCI: If a Cyclom-Y/PCI board is being installed.
• ISA: If a Cyclom-Y/ISA is being installed. Address and IRQ: the Memory Address
and the IRQ must be set for an ISA board. Make sure that the selected address
and IRQ are not being used by other adapters in the computer and that they match
the configuration of the dip-switches.
• Starting COM: Starting COM specifies the first COM port to be associated
with the Cyclom-Y. For example: if you select COM5 as the Starting COM, the first
Cyclom-Y port will be associated with the device COM5, the second Cyclom-Y port
will be associated with COM6 and so on. If you have more than one board
installed, 32 COMs are reserved for each board. In the same example, the second
board would start at the COM37 (5+32). Make sure that the COM devices do not
conflict with other devices already assigned in your system.
10.Click on the OK button to finish the installation.
11. Reboot the computer.
12.Verify that the installation succeeded by checking the messages in the Event Log.

8
To install the driver in NT 4.0:
1. Power on the system, boot NT, login.
2. In the Control Panel window, double click on Network.
3. Select the Adapters tab.
4. Click on the Add... button.
5. Windows will display the Select Network Adapter dialog box.
6. Click on the Have Disk button.
7. Insert the Cyclom-Y NT Driver disk or enter the path to where the driver files are
located.
8. Windows will copy the driver files and open the Cyclom-Y NT Driver Setup dialog
box.
9. Configure the Cyclom-Y NT Driver (use the help function if necessary). See
description of configuration parameters in step 9 for Windows NT version 3.51,
above.
10.Click on the OK button to finish the installation.
11. Reboot the computer.
12.Verify that the installation succeeded by checking the messages in the Event Log.
To verify the installation, execute the “Event Viewer” and look for the
Cyclom-Y driver messages. You should find three messages:
1. Version and Copyright information,
2. a message indicating that there is a Cyclom-Y board configured and
3. a message indicating whether the configured boards were found or not.
Configuration Issues
Once the driver is installed, the Cyclom-Y ports are accessible to any application as COM n ,
where n are sequential numbers for each port starting from the Starting COM number
configured during the installation (default: COM5).
To use the Cyclom-Y ports with any NT application, configure the application to access the
proper COM
n port.
To change the IRQ or address information (ISA cards only) or the Starting COM after the
driver is installed, select Cyclades Cyclom-Y in the Adapters tab (Network applet in the
Control Panel), then click on the Properties button.
To uninstall the driver, select Cyclades Cyclom-Y and click on the Remove button.

9
Microsoft Windows 95 or Windows 98
The Cyclom-Y Windows 95/Windows 98 Driver supports all versions of Windows 95 and
Windows 98. Once the driver is installed in a computer, the board´s serial ports are seen by
Windows applications as generic COM ports. Dial-up access, terminal emulation and BBSs
are examples of applications that use serial ports in this environment.
How to Install the Device Driver
The Cyclom-Y Windows 95/Windows 98 Driver is provided on a 3.5” floppy disk or it can be
downloaded from the Cyclades Web site.
To install a Cyclom-Y ISA card in Windows 95:
1. Turn on the computer, booting Windows, and log in.
2. In the Control Panel window, double click on Add New Hardware.
3. To the question “Do you want Windows to search for your new hardware?”, answer
No.
4. Select the type of hardware to Install: Multi-function adapters.
5. Click on Have Disk.
6. Indicate the Cyclom-Y Win95/Win 98 Driver disk or enter the path of the directory
where the driver files are located.
7. Select which Cyclom-Y ISA model should be installed and click on Next.
8. Note the information about system resources (Memory and Interrupt Request)
assigned to the Cyclom-Y.
9. The driver files will be copied.
10.Click on Finish.
11. Windows will ask if you want to shut down the computer. Select No.
12.Windows will detect an unknown device. Select “Driver from disk provided by
hardware manufacturer.”
13.Windows will install the remaining Cyclom-Y Ports.
14.Open the Control Panel window, double-click on System, select Device Manager
and open Multi-Function Adapters. Select the Cyclom-Y device and click on
Properties. Select the Board Options tab. Click on OK.
15.Shut down the system. Configure the Cyclom-Y dip-switches to match the resources
allocated by Windows. Place the card in any available ISA slot. Boot the computer.
16.If you have not yet clicked OK in the Board Options tab, as explained above, it is time
to do so.
17.The Installation is complete
To install a Cyclom-Y ISA in Windows 95 OSR2 or Windows 98:
1. Turn on the computer, booting Windows, and log in.
2. In the Control Panel window, double click on Add New Hardware.
3. To the question “Do you want Windows to search for your new hardware?”, select “No,
I want to select the hardware from a list.”

10
4. Select the type of hardware to install: Multi-function adapters.
5. Click on Have Disk.
6. Insert the Cyclom-Y Win95/Win 98 Driver disk or enter the path to where the driver
files are located.
7. Select which Cyclom-Y ISA model you want to install and click on Next.
8. Write down the information about system resources (Memory and Interrupt Request)
assigned to the Cyclom-Y.
9. The driver files will be copied.
10.Click on Finish.
11. Windows asks if you want to shut down the computer. Select No.
12.Windows should detect an Unknown Device.
13.Let Windows search for the driver.
14.Windows should find the driver for Cyclom-Y Port 01.
15.Click on Finish.
16.Windows will install the remaining Cyclom-Y Ports.
17.Open the Control Panel, double-click on System, select Device Manager and open
Multi-Function Adapters. Select the Cyclom-Y device and click on Properties.
Select the Board Options tab. Click OK.
18.Shut down the system. Configure the Cyclom-Y dip switches to match the resources
allocated by Windows. Place the card in any available ISA slot. Boot the system.
19.If you have not clicked OK in the Board Options tab as explained above, it is time to
do so.
20.The installation is complete.
To install a Cyclom-Y PCI card in Windows 95:
1. Place the card in any available PCI slot.
2. Turn on the computer, booting Windows, and log in.
3. Windows will detect a PCI Card and will ask for the driver. Select “Driver from disk
provided by hardware manufacturer.”
4. Insert the Cyclom-Y Win95/Win 98 Driver disk or enter the path to where the driver
files are located.
5. The driver files will be copied.
6. Windows should detect an Unknown Device. Select “Driver from disk provided by
hardware manufacturer.”
7. Windows will install the remaining Cyclom-Y Ports.
8. Open the Control Panel, double-click on System, select Device Manager and open
Multi-Function Adapters. Select the Cyclom-Y device and click on Properties. Select
the Board Options tab. Click OK.
9. The installation is complete.

11
To install a Cyclom-Y PCI card in Windows 95 OSR2 or Windows 98:
1. Place the card in any available PCI slot.
2. Turn on the computer, booting Windows, and log in.
3. Windows should detect a PCI Communication Device.
4. Let Windows search for the driver. Insert the Cyclom-Y Win95/Win 98 Driver disk or
enter the path to where the driver files are located.
5. Windows should find the driver for the Cyclom-Y device.
6. The driver files will be copied.
7. Click on Finish.
8. Windows should detect an Unknown Device.
9. Let Windows search for the driver.
10.Windows should find the driver for Cyclom-Y Port 01.
11. Click on Finish.
12.Windows will install the remaining Cyclom-Y Ports.
13.Open the Control Panel, double-click on System, select Device Manager and open
Multi-Function Adapters. Select the Cyclom-Y device and click on Properties.
Select the Board Options tab. Click OK.
14.The installation is complete.
FreeBSD
Overview
The Cyclom-Y FreeBSD driver has been included in the standard FreeBSD Kernel
Distribution since release 2.0 of the operating system. This driver was developed by the
FreeBSD project with hardware and technical support provided by Cyclades. FreeBSD is
responsible for driver maintenance. Problem reports and suggestions should be directed to
<[email protected]>. Cyclades can assist you in both hardware and software installation.
Once the driver is configured, the Cyclom-Y ports are accessible to any application running in
the FreeBSD operating system.
How to Install the Device Driver
Normally, there is no need to apply patches or install files. To enable the driver, edit the
kernel configuration file and rebuild the kernel. Check the operating system documentation
for additional information. After the installation is complete, shut down and restart the system.
Verify the driver’s boot messages to confirm that the board was recognized and initialized.

12
Cyclades Corporation
41829 Albrae Street
Fremont, CA 94538 - USA
Phone: [phone]
Fax: [phone]
www.cyclades.com
Cyclades South America
Av. Santa Catarina, 155
04635-000 São Paulo, SP, Brazil
Phone: [phone]
Fax [phone]
www.cyclades.com.br
Cyclades Europe
Kenzestrasse 5-7
D-85737 Ismaning - Germany
Phone: [phone]
Fax: [phone]
www.cyclades.de
BSD/OS
Overview
The Cyclom-Y BSD/OS driver is included in the standard BSD/OS Kernel Distribution since
release 2.1 of the operating system. Version 2.0 of BSD/OS is also supported, but the driver
must be downloaded from the Cyclades Web Site. Once the driver is configured, the Cyclom-
Y ports are accessible to any application running in the BSD/OS operating system.
How to Install the Device Driver
There is normally no need to apply patches or install files. To enable the driver, edit the kernel
configuration file and rebuild the kernel. Read the “cy” man page for additional information.
After the installation is complete, shut down and restart the system. Verify the driver’s boot
messages to verify that the board was recognized and initialized.
v1.0 Dec/00