==========================================================================================
= =
= Golden Series Board Driver Installation Guide =
= =
= For Kernel 2.6.x =
= =
= Version: 1.06 =
= Date: 2007/03/31 =
==========================================================================================
Item
A. Release note
B. Introduction
C. Distributions test
D. Installation
D.1 Driver install
D.2 Device node creation
E. Loading driver automatic after system boot
E.1 Fedora Core 2
E.2 Fedora Core 3
E.3 Fedora Core 4
E.4 Fedora Core 5
E.5 Fedora Core 6
E.6 Suse 9.1
E.7 Suse 9.2
E.8 Suse 9.3
E.9 Suse 10.0
E.10 Mandrake 10.0
E.11 Mandrake 10.1
E.12 Mandriva 2005
E.13 Mandriva 2006
E.14 RedHat Enterprise Linux AS 4.0
E.15 RedHat Enterprise Linux ES 4.0
E.16 TurboLinux 10
F. Utility
F.1 snxdump
F.2 snxlink
F.3 snxterm
==========================================================================================
A. Release note
Support kernel 2.6.x on x86 machine only. Distributions test please refer to item C.
Before install driver. Make sure system with c compiler and kernel development package.
2006/07/10 - Ver:1.02
1) Add snxterm program into driver package.
2) Fix read fcr register in driver and backup a fcr register value in struct.
3) Test RedHat Enterprise Linux AS 4.0 and ES 4.0.
2006/10/02 - Ver:1.03
1) Add GNU information in driver.
2) Test SlackWare 10.2 (kernel 2.6.13).
3) Support 4027D, 4037D and 4056D.
2006/10/12 - Ver:1.04
1) Fix system hanged. Modem interrupt can't be cleared by reading iir and msr
register for SUN1699 chip.
2006/12/01 - Ver:1.05
1) Fix system hanged. Data coming but device node didn't opened, when open, system
maybe crash.
2) Add version information in /var/log/messages
3) Test TurboLinux 10
2007/03/31 - Ver:1.06
1) Fix data receiving function.
2) Modify ioctl function for dump port informations.
------------------------------------------------------------------------------------------
B. Introduction
Maximum 4 boards can be installed in combination, support golden series boards as
list below.
1 port -
4027T
4027A
4027D
4027P
2 port -
4037T
4037A
4037AL
4037D
4037U
4037P
4036A3V
8139
8139S
8139SI
4 port -
4056A
4056AL
4056D
4056J
4056U
4056UE
4056P
4055WN
4056WN
4056DW
8159
8159S
8159SI
8 port -
4066A
4066R
4066J
4066U
4066UE
8169
8169S
8169SI
------------------------------------------------------------------------------------------
C. Distributions test
Driver tested with distributions as list.
Fedora Core 2
Fedora Core 3
Fedora Core 4
Fedora Core 5
Fedora Core 6
Suse 9.1
Suse 9.2
Suse 9.3
Suse 10.0
Mandrake 10.0
Mandrake 10.1
Mandriva 2005
Mandriva 2006
RedHat Enterprise Linux AS 4.0
RedHat Enterprise Linux ES 4.0
SlackWare 10.2 (kernel 2.6.13)
TurboLinux 10
------------------------------------------------------------------------------------------
D. Installation
D.1 Driver install
Please create a directory under root directory, e.g /temp, do commands:
# cd /
# mkdir temp
After get driver file "golden_2.6_Vx.xx.tgz". Copy file to /temp
directory, then extract and install, do commands:
# cp golden_2.6_Vx.xx.tgz /temp
# cd /temp
# tar xvfz golden_2.6_Vx.xx.tgz
# cd /temp/golden_2.6
# make clean ; make install
Load driver module, do command:
# modprobe snx_golden
or
# insmod /temp/golden_2.6/driver/snx_golden.ko
Check driver module, do command:
# lsmod | grep snx_golden
Unload driver, do command:
# rmmod snx_golden
D.2 Device node creation
Each serial port has one device node which is named "ttySNX?".
Do commands:
# cd /temp/golden_2.6/snxmknod
# ./snxmknod
This will create device nodes in /dev.
If there are more than two boards installed, device
nameing convention as list below.
Board Number Device Name
1st board ttySNX0 ~ ttySNX7
2nd board ttySNX8 ~ ttySNX15
3rd board ttySNX16 ~ ttySNX23
4th board ttySNX24 ~ ttySNX31
------------------------------------------------------------------------------------------
E. Loading driver automatic after system boot
E.1 Fedora Core 2
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.2 Fedora Core 3
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.3 Fedora Core 4
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.4 Fedora Core 5
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.5 Fedora Core 6
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.6 Suse 9.1
After finish item C.
Modify /etc/rc.d/boot.local for loading driver on system boot. Use vi or other
editor to open boot.local, and add "modprobe snx_golden" in last line.
Modify /etc/rc.d/halt.local for unloading driver on system halt. Use vi or other
editor to open halt.local, and add "rmmod snx_golden" in last line.
E.7 Suse 9.2
After finish item C.
Modify /etc/rc.d/boot.local for loading driver on system boot. Use vi or other
editor to open boot.local, and add "modprobe snx_golden" in last line.
Modify /etc/rc.d/halt.local for unloading driver on system halt. Use vi or other
editor to open halt.local, and add "rmmod snx_golden" in last line.
E.8 Suse 9.3
After finish item C.
Modify /etc/rc.d/boot.local for loading driver on system boot. Use vi or other
editor to open boot.local, and add "modprobe snx_golden" in last line.
Modify /etc/rc.d/halt.local for unloading driver on system halt. Use vi or other
editor to open halt.local, and add "rmmod snx_golden" in last line.
E.9 Suse 10.0
After finish item C.
Modify /etc/rc.d/boot.local for loading driver on system boot. Use vi or other
editor to open boot.local, and add "modprobe snx_golden" in last line.
Modify /etc/rc.d/halt.local for unloading driver on system halt. Use vi or other
editor to open halt.local, and add "rmmod snx_golden" in last line.
E.10 Mandrake 10.0
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.11 Mandrake 10.1
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.12 Mandriva 2005
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.13 Mandriva 2006
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.14 RedHat Enterprise Linux AS 4.0
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.15 RedHat Enterprise Linux ES 4.0
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
E.16 TurboLinux 10
After finish item C. Modify /etc/rc.d/rc.local for loading driver
on system boot. Use vi or other editor to open rc.local, and add
"modprobe snx_golden" in last line.
------------------------------------------------------------------------------------------
F. Utility
F1. snxdump - dump port informations, do command:
# snxdump
the informations should be like this
================ Found 2 GOLDEN port, list informations ====================
ttySNX0 --
GOLDEN 4037 Series (bus:2 device: 2) , base address = b800, irq = 7
ttySNX1 --
GOLDEN 4037 Series (bus:2 device: 2) , base address = b808, irq = 7
=============================================================================
In this case, means ttySNX0 is the first port on golden 4037
series board, base address is 0xb800 and irq is 7.
bus:2 means the bus number of board is 2.
device:2 means the device number of board is 2.
If no information print on screen. Make sure the device node
exist in /dev and driver module loaded.
F2. snxlink - build softlink for ttySNX device node, do command:
# snxlink
commands are:
? help (this text)
B build soft link in /dev (for example, B ttySNX0 ttyS4)
A backup device node in /dev (for example, A ttyS4)
R remove device node in /dev (for example, R ttyS4)
Q program end
Please enter command:
command B: build soft link in /dev, for example
b ttySNX0 ttyS4
ttySNX0 is source device node file
ttyS4 is softlink that want to build
command A: backup device node in /dev, for example
a ttyS4
/dev/ttyS4 will rename to /dev/ttyS4.bak
command R: remove device node in /dev, for example
r ttyS4
delete /dev/ttyS4
F3. snxterm - dumb terminal for test tty device node data transmitting and receiving
, do command:
# snxterm
------------------------------------------------------------------------------------------
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.