OpenBSD manual page server

Manual Page Search Parameters

UEAGLE(4) Device Drivers Manual UEAGLE(4)

ueagleAnalog Devices Eagle ADSL modems

ueagle* at uhub? port ?

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.

The following modems should work:

Eagle II
Eagle I
Eagle II
Eagle II
Eagle I
Eagle I
Eagle II
Eagle II
Eagle II
Eagle I
Eagle II
Eagle I
Eagle II
Eagle III
Eagle I
Eagle I
Eagle II
Eagle II
Eagle I

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 can be installed using fw_update(1).

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

uhub(4), usb(4), route(8)

The ueagle driver first appeared in OpenBSD 3.8.

The ueagle driver was written by Damien Bergamini <damien@openbsd.org>.

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.

July 16, 2013 OpenBSD-5.4