UEAGLE(4)

NAME
ueagle - 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://firmware.openbsd.org/firmware/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 ALSO
uhub(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.