UEAGLE(4) OpenBSD Programmer's Manual UEAGLE(4)NAMEueagle - Analog Devices Eagle ADSL modems
SYNOPSIS
ueagle* at uhub? port ?
DESCRIPTION
The ueagle driver provides support for USB ADSL modems based on the
Analog Devices Eagle chipset (revision I, II and III).
The ueagle driver can only manage a single ATM AAL5 virtual circuit. The
segmentation and reassembly (SAR) of ATM cells is done by software.
To achieve high rate downstream transfer with fast ADSL connections, the
ueagle driver uses USB isochronous pipes instead of standard bulk pipes.
To establish a permanent virtual circuit (PVC) with a peer, ueagle must
be configured using the route(8) command. A typical invocation is:
# route add -iface <Peer IP> -link if:encap.vpi.vci_hi.vci_lo
The arguments to ``-link'' are as follows:
if Interface name. For example, ``ueagle0''.
encap Type of encapsulation to use. Possible types are:
AAL5 VCMUX Use hex value 0x1.
AAL5 LLC/SNAP Use hex value 0x3.
vpi See ISP's recommended setting for this. All values specified
in hex.
vci_hi
vci_lo See ISP's recommended setting for this. All values specified
in hex. The VCI is specified as
high_order_byte.low_order_byte. For example, a VCI of 35
would be specified as ``0.23''.
See also EXAMPLES below.
HARDWARE
The following modems should work:
Modem Chip
Aethra Starmodem Eagle II
Allied Telesyn AT-AR215 Eagle I
Arescom NDS1060 Eagle II
Aztech 206U Eagle II
Comtrend CT-350 Eagle I
Comtrend CT-361 Eagle I
D-Link DSL-200I Eagle I
ECI B-FOCuS USB 150 Eagle II
Elcon 111U Eagle II
Elcon 131U Eagle II
ELSA MicroLink ADSL FUN USB Eagle I
Huawei SmartAX MT810 Eagle II
Sagem F@st 800 Eagle I
Sagem F@st 800 PE/E2 Eagle II
Sagem F@st 800 E3 Eagle III
Sagem F@st 908 Eagle I
Teledat 300 USB Eagle I
Telindus ND 220 Eagle II
Telindus ND 220b Eagle II
US Robotics USR9000/2/3 Eagle I
FILES
The adapter needs some firmware files, which are loaded on demand:
/etc/firmware/ueagleI
/etc/firmware/ueagleII
/etc/firmware/ueagleIII
/etc/firmware/ueagle-dsp
These firmware files are not free because Analog Devices refuses to grant
distribution rights.
A prepackaged version of the firmware, designed to be used with
pkg_add(1), can be found at:
http://damien.bergamini.free.fr/packages/openbsd/ueagle-firmware-1.0p0.tgz
EXAMPLES
To establish a PVC (vpi=8, vci=35, vcmux) with host 192.168.1.2:
# route add -iface 192.168.1.2 -link ueagle0:1.8.0.23
To establish a PVC (vpi=0, vci=6, llc/snap) with host 192.168.1.3:
# route add -iface 192.168.1.3 -link ueagle0:3.0.0.6
SEE ALSOuhub(4), usb(4), route(8)HISTORY
The ueagle driver first appeared in OpenBSD 3.8.
AUTHORS
The ueagle driver was written by Damien Bergamini <damien@openbsd.org>.
CAVEATS
The ueagle driver only supports ADSL over POTS. ADSL over ISDN is not
supported. G.Lite modulation (aka splitterless) has never been tested
and probably won't work.
OpenBSD 4.9 June 7, 2010 OpenBSD 4.9
