Medusa3 Linux installation manual

1. Unpack Medusa3 driver pack (appropriate your kernel version).

2. Ensure kernel is configured & compiled with "Generic HDLC Driver"
feature. Install kernel (if it's not installed).
It's not necessary to have kernel sources.
Only headers & configuration files corresponding kernel image is needed 
(Linux-headers-??? packages for Debian)

3. Build & install kernel driver & utilities.
type: "make install"
    Make will try to find corresponding kernel tree (analysing /usr/src/ &
    uname -r for active kernel). 
    select or type kernel source tree (when requested)

4. Load modules and install protocol (If you choosed M while
configuring kernel for GENERIC HDLC):   
    modprobe hdlc  
    modprobe medusa

WARNING:
    eepro100 & e100 will grab Medusa3 adapter if loaded before medusa.ko.
    To prevent this - unload modules eepro100 & e100 in junior rc scripts,
    load medusa and load eepro100 & e100 if needed.

5. Configure HDLC link level protocol for medusa interface with sethdlc: 
    sethdlc <Interface name> <mode> 
	Interface name - hdlc0, hdlc1, ... 
	mode - hdlc, cisco, ppp, fr-ansi, fr-ccitt. 
    type: "sethdlc" for the details. 

WARNING: sethdlc is used for configurint HDLC stack, not hardware !
    It will not crush your system, but it's useless for hardware configuration.

6. Configure interface(or virtual PVC interfaces) with ifconfig
    ifconfig < interface > <ip1> pointopoint <ip2>

7. Configure interface using med3cfg utility & save configuration to disk:
    type "med3cfg -h" for the details.

8. Connect network cable.

9. Try ping <ip2>

=========
NOTES:  |
=========
Getting loadtime error:
"version magic '2.6.11-1-686-smp SMP 686 gcc-4.0' should be '2.6.11-1-686-smp SMP 686 gcc-3.3'"
Compile kernel driver using non-default gcc version,
type: make CC=gcc-3.3 modules

There are sample scripts called up.sh, up2.sh, down.sh provided.
Kernel versions tested - 2.6.11 and 2.6.15.
The most robust source - from kernel.org, but can be used precompiled 
distribution built-in.

Website: http://eng.parabel.ru/
support: support@parabel.ru
