UEAGLE(4)                 OpenBSD Programmer's Manual                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 Ana-
     log 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_or-
                der_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 ALSO
     uhub(4), usb(4), route(8)

     The uEagle Web Page, http://damien.bergamini.free.fr/ueagle/.

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.7                      July 25, 2008                               2
