From 4f2d7949f03e1c198bc888f2d05f421d35c57e21 Mon Sep 17 00:00:00 2001 From: V3n3RiX Date: Mon, 9 Oct 2017 18:53:29 +0100 Subject: reinit the tree, so we can have metadata --- net-dialup/ueagle4-atm/Manifest | 6 + net-dialup/ueagle4-atm/files/README | 235 ++++++++++++++++++++++++++ net-dialup/ueagle4-atm/metadata.xml | 7 + net-dialup/ueagle4-atm/ueagle4-atm-1.0.ebuild | 56 ++++++ 4 files changed, 304 insertions(+) create mode 100644 net-dialup/ueagle4-atm/Manifest create mode 100644 net-dialup/ueagle4-atm/files/README create mode 100644 net-dialup/ueagle4-atm/metadata.xml create mode 100644 net-dialup/ueagle4-atm/ueagle4-atm-1.0.ebuild (limited to 'net-dialup/ueagle4-atm') diff --git a/net-dialup/ueagle4-atm/Manifest b/net-dialup/ueagle4-atm/Manifest new file mode 100644 index 000000000000..5af27bf1d589 --- /dev/null +++ b/net-dialup/ueagle4-atm/Manifest @@ -0,0 +1,6 @@ +AUX README 8682 SHA256 f2a6ec2f20670e6bef283f032c7c8d63d5fc6868aabcc5a5547b4f45b3ef0b3f SHA512 4441464519b518d3b666df88323624a6ca4ce746b75dcd2d8ba638d0a3b953d9d5a34344e6acdb400b5a4fe5ccd9fec49202bb357a6d9c76b49dd8e0accb265c WHIRLPOOL 2218d6c830bf876f0fa0315df6b6c88ec859c4ca45496ba9d2c1be79625a447d29e69c549cfc13f1ab140534233ef5109dd8dc84eea44573b69faa1f241cc2b9 +DIST ueagle4-data-1.0.tar.gz 217512 SHA256 1e3547821d69b9f576add1e35223df159aadfd9e3dae913b6429a1cbbe1a3691 SHA512 3d47150eb288865432e7201390669262e0d12239f5d45d194da8abe535e69cabcb53ef6b8757ab7e3c495394ecd74b781ac724635918b70c479a1219b3bcaa74 WHIRLPOOL 69926d2f8d4606db044f08f16c0cc274ed3b139db2415773a67b0857ac614f7632d85362c8bbcd189f2394355211d8c26112f1d7214717e6a6b4b41c63a3976f +EBUILD ueagle4-atm-1.0.ebuild 1673 SHA256 0f1731c6b2bbc1bbba84cac588054c0b574b70693a615d03047a7197a01722e5 SHA512 f6b5c31eb8193aa2812229943f37b48ad8868ec4a692d30cb8a067b0904ea5ce774e4d3b94c633295afae40f868b5449bffb84995b09d56c3535dac9fbc1114d WHIRLPOOL b9a853878bb891f7a98e2622c1891dda3f1cf5edc424e4a4570b974906b3f4fdbc2912b40aeeb9fcb76096371b42042dabed294ec62573824815bd1d0a89189e +MISC ChangeLog 2874 SHA256 5dd797cc6add40b495be83f8115d02b0a922a9c9406b10b6cc2404ef56bbfacf SHA512 d797d373cde021936f77a762dd5329b1f0d44861ff4e6cd99916ff443ae3f8b2617143241955eb610b45ff0110ee968bdb2c594930e8b397c1572ad92e4d4dd8 WHIRLPOOL 7ca24c755d8532e17382320e33a9a86f10583657f558f739ff7dd802dba72cb77720b32e2c2267a43aeb8f88a93575c4d7839545cbff37231e27cb013b3e0f1d +MISC ChangeLog-2015 561 SHA256 290c5e1b430fb94c317caee171c37f90d5846413f9822cb2532a753bb63341f0 SHA512 89011834d180773cc8fd1731d9fe73bbbbdef06c1140360aa5c4cd4573d820d88cd187863d4f83a7194f4365c59b988f208ef046ba8393066919caca779b23d0 WHIRLPOOL 66455e50f2c199f58e160880c414816f02ad7847c1225b001106942fd66dfe83c189e807025167a12fb980c19ce606eb5de5878607abb6e7dff6a103540e56a3 +MISC metadata.xml 313 SHA256 c3d37e08ccf7ac07585bdf49c8f50c50808542729ca62d949bb63eac5b0e6683 SHA512 5e82ee1abcd89c42e7519966aae253537495a2b471b479a75a0aa0f9d5c11b57772a0138223abd3edd29c7393f0ad198bd8e7da9c3035660e441c11f21641458 WHIRLPOOL 5c08b8bbbe9f8c1319a35c9335259da452cd6a7dfe6cf23716ef69c47feea0cf7cc50a209038dfc938a0f4cd6275e3bd3aea815b425471f0c74ee346f4469a81 diff --git a/net-dialup/ueagle4-atm/files/README b/net-dialup/ueagle4-atm/files/README new file mode 100644 index 000000000000..20067824f303 --- /dev/null +++ b/net-dialup/ueagle4-atm/files/README @@ -0,0 +1,235 @@ +Introduction +============ + +This ebuild installs firmware files necessary for Eagle USB E4 ADSL +Modem driver which first appeared in kernel 2.6.16. + +Configuration +============= + +Most ADSL modems are connected via the ATM protocol, rather +than Ethernet. For ATM, run the following: + euse -E atm && emerge net-dialup/ppp net-dialup/ueagle-atm + +It is necessary to choose an interface number for the connection. This +is arbitrary - the only requirement is that the connection number is +not already in use. The first available number is 0, and it is usual to +choose the lowest unused number. For the purposes of this document, 0 +will be chosen. + +Add the following lines from the appropriate section below to +/etc/conf.d/net, then customize them as per the inline comments. + + +a) PPPoATM configuration: + +config_ppp0='ppp' # Runs /lib/rcscripts/net/pppd.sh +# The 2 numbers represent the VPI & VCI of your ISP, and they are separated +# by a dot. Ask your ISP about those numbers. +link_ppp0='0.38' +plugins_ppp0='pppoa' +# 'man pppd' shows other options. Compression is disabled because it is +# rarely taken advantage of, and may interfere with the connection. +# Add option 'usepeerdns' to populate /etc/resolv.conf +pppd_ppp0='updetach noauth debug defaultroute noaccomp nobsdcomp noccp + nodeflate nopcomp novj novjccomp child-timeout 60' +username_ppp0='username@isp.com' # ADSL login, assigned by your ISP +password_ppp0='password' # ADSL password, assigned by your ISP + +# If the kernel modules are not built-in, then they must be loaded +# before starting the PPP daemon: +function preup() { + if [[ "$1" = "ppp0" ]] ; then + modprobe -q ueagle-atm + return 0 + fi +} + + +b) PPPoE configuration: + +# Configure first the RFC2684 bridge interface +config_nas0='null' +# Use "-e 0" for LLC mux or "-e 1" for VC mux. +# The 2 numbers after "-a" represent the VPI & VCI of your ISP, and +# they are separated by a dot. Ask your ISP about those numbers. +br2684ctl_nas0='-e 0 -a 0.38' + +config_ppp0='ppp' # Runs /lib/rcscripts/net/pppd.sh +link_ppp0='nas0' # The name of the RFC2684 bridge interface +plugins_ppp0='pppoe' +# 'man pppd' shows other options. Compression is disabled because it is +# rarely taken advantage of, and may interfere with the connection. +# Add option 'usepeerdns' to populate /etc/resolv.conf +pppd_ppp0='updetach noauth debug defaultroute noaccomp nobsdcomp noccp + nodeflate nopcomp novj novjccomp child-timeout 60' +username_ppp0='username@isp.com' # ADSL login, assigned by your ISP +password_ppp0='password' # ADSL password, assigned by your ISP + +depend_ppp0() { + need net.nas0 +} + +# If the kernel modules are not built-in, then they must be loaded +# before starting the RFC2684 bridge: +function preup() { + if [[ "$1" = "nas0" ]] ; then + modprobe -q ueagle-atm + return 0 + fi +} + + +Configuration continued +======================= + +Create a symlink for the new network interface, for it to be enabled by +baselayout: + cd /etc/init.d && ln -sfn net.lo net.ppp0 +If you use PPPoE, you should also create the symlink for the RFC2684 +bridge interface: + cd /etc/init.d && ln -sfn net.lo net.nas0 + +The "debug" option adds some extra commentary from pppd regarding the +connection to /var/log/messages, e.g.: +"sent [LCP ConfReq id=0x1 ]". It is wise to keep the +option on permanently, due to its usefulness when debugging. + +Set RC_NET_STRICT_CHECKING="yes" in /etc/conf.d/rc, to prevent Internet +services in /etc/init.d/ from starting before the Internet connection +is established. Other options are to start/stop programs in +/etc/ppp/ip-{up,down}.local, and to customize initscript dependencies +as described in: + http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=4 + + +Starting the Connection +======================= + +To start manually, with the modem connected: + /etc/init.d/net.ppp0 start + +To start automatically when the PC boots: + rc-update add net.ppp0 default + + +Kernel Configuration +==================== + +The ebuild, during an emerge, checks that the required kernel modules +are present. + +Note that in the list below, "[*]" means that the option is compiled +into the kernel, whereas "[M]" means that the option can either be +compiled into the kernel, or as a module. Compiling them into the +kernel is recommended, to guarantee that the modules are already loaded +when they are needed, and it will improve the bootup time by a couple +of seconds. + +In "make menuconfig", you can press "/" and search on e.g. "eagle" +to see exactly where an option is - the location of an option and its +dependencies can change between kernel versions. + +Check that the following kernel options are configured as shown (this +list includes the prerequisites, e.g. USB_UEAGLEATM depends on USB): + + Code maturity level options ---> + [*] Prompt for development and/or incomplete code/drivers + - CONFIG_EXPERIMENTAL + + Device Drivers ---> + Generic Driver Options ---> + [ ] Select only drivers that don't need compile-time external + firmware (*unselected*) - CONFIG_STANDALONE + [*] Hotplug firmware loading support - CONFIG_FW_LOADER + + Networking ---> + [*] Networking support - CONFIG_NET + Networking options ---> + [*] Packet socket - CONFIG_PACKET + [M] Asynchronous Transfer Mode (ATM) - CONFIG_ATM + [M] RFC1483/2684 Bridged protocols - CONFIG_ATM_BR2684 (only needed for PPPoE) + + Device Drivers ---> + Network device support ---> + [*] Network device support - CONFIG_NETDEVICES + [*] PPP (point-to-point protocol) support - CONFIG_PPP + [M] PPP Deflate compression - CONFIG_PPP_DEFLATE (only useful if + compression is supported - rare) + [M] PPP BSD-Compress compression - CONFIG_PPP_BSDCOMP (only useful + if compression is supported - rare) + [M] PPP over Ethernet - CONFIG_PPPOE (only needed for PPPoE) + [M] PPP over ATM - CONFIG_PPPOATM (only needed for PPPoATM) + USB support ---> + [*] Support for Host-side USB - CONFIG_USB + [*] USB device filesystem - CONFIG_USB_DEVICEFS + [M] (O or U)HCI HCD support + USB DSL modem support ---> + [M] USB DSL modem support - CONFIG_USB_ATM + [M] ADI 930 and eagle USB DSL modem - CONFIG_USB_UEAGLEATM + + + +Troubleshooting +=============== + +Try "emerge ueagle-atm" again, because the ebuild checks that the +required kernel modules are present (showing a warning message if +appropriate), and creates the firmware files in /lib/firmware/ueagle-atm. + +If the modem is unresponsive, then run "/etc/init.d/net.ppp0 stop" and +unplug the modem for 30 seconds, to drain its memory. Then reconnect +the modem to the PC and run "/etc/init.d/net.ppp0 start" + +To check the modem's connection progress, run: + tail -f /var/log/messages +/var/log/messages should show e.g.: + +pppd[nnn]: Plugin pppoatm.so loaded. +pppd[nnn]: pppd n.n.n started by root, uid 0 +pppd[nnn]: Using interface ppp0 +pppd[nnn]: Connect: ppp0 <--> n.nn +ADSL line is synchronising +DSL line goes up +ADSL line is up (nnn Kib/s down | nnn Kib/s up) +pppd[nnn]: CHAP authentication succeeded +pppd[nnn]: local IP address nnn.nnn.nnn.nnn +pppd[nnn]: remote IP address nnn.nnn.nnn.nnn + + +If the authentification fails, then check username_ppp0 and +password_ppp0. + +If the ADSL connection is not established, then check the options in +pppd_ppp0. "man pppd" explains all the options in that file. + +If the ADSL connection seems to have worked, but no websites can be +contacted, then check that /etc/resolv.conf is populated, and possibly +add the "usepeerdns" option (to use the ISP's DNS) to pppd_ppp0 in +/etc/conf.d/net . + +If the problem is still not resolved, post to the Gentoo Forums at +http://forums.gentoo.org/ and ultimately, if there is no answer, +file a bug at http://bugs.gentoo.org/ . + + +Compression +=========== + +Some ISPs require compression to be disabled in order for the +connection to work, so the default configuration described above +disables compression. Few ISPs support ADSL compression anyway. If you +are lucky enough to have an ISP which *does* support compression +(Google is your best friend for determining this), then compression can +be enabled by following these steps: + +* Compile the kernel modules CONFIG_PPP_DEFLATE and CONFIG_PPP_BSDCOMP +(only one is strictly necessary - pppd prefers "deflate" compression). +Add them to /etc/modules.autoload.d/kernel-2.6 or /etc/conf.d/net above +the "pppoatm" line, if they are not built-in. +* Remove the following options in pppd_ppp0: + noaccomp nobsdcomp noccp nodeflate nopcomp novj novjccomp +* Ensure that "debug" is in the pppd_ppp0 options, to check that +compression is being utilized. Note that "module registered" in +/var/log/messages only confirms that the kernel module is loaded - +it does not indicate that the connection is compressed. diff --git a/net-dialup/ueagle4-atm/metadata.xml b/net-dialup/ueagle4-atm/metadata.xml new file mode 100644 index 000000000000..331b50f53b69 --- /dev/null +++ b/net-dialup/ueagle4-atm/metadata.xml @@ -0,0 +1,7 @@ + + + + + Firmware and configuration instructions for Eagle USB E4 ADSL Modem driver +available in kernels >= 2.6.16. + diff --git a/net-dialup/ueagle4-atm/ueagle4-atm-1.0.ebuild b/net-dialup/ueagle4-atm/ueagle4-atm-1.0.ebuild new file mode 100644 index 000000000000..80b2ba00625b --- /dev/null +++ b/net-dialup/ueagle4-atm/ueagle4-atm-1.0.ebuild @@ -0,0 +1,56 @@ +# Copyright 1999-2017 Gentoo Foundation +# Distributed under the terms of the GNU General Public License v2 + +EAPI=6 + +inherit eutils linux-info + +DESCRIPTION="Firmware and configuration instructions for Eagle USB E4 ADSL Modem driver" +HOMEPAGE="https://gna.org/projects/ueagleatm/" +SRC_URI="http://eagle-usb.org/ueagle-atm/non-free/ueagle4-data-${PV}.tar.gz" + +LICENSE="Ikanos" +SLOT="0" +KEYWORDS="~amd64 ~x86" + +DEPEND="" +RDEPEND="net-dialup/ppp + !sys-kernel/linux-firmware" + +S="${WORKDIR}/ueagle4-data-${PV}" + +src_install() { + # Copy to the firmware directory + insinto /lib/firmware/ueagle-atm + doins * + + # Documentation necessary to complete the setup + dodoc "${FILESDIR}/README" +} + +pkg_postinst() { + # Check kernel configuration + local CONFIG_CHECK="~FW_LOADER ~NET ~PACKET ~ATM ~NETDEVICES ~USB_DEVICEFS ~USB_ATM ~USB_UEAGLEATM \ + ~PPP ~PPPOATM ~PPPOE ~ATM_BR2684" + local WARNING_PPPOATM="CONFIG_PPPOATM:\t is not set (required for PPPoA links)" + local WARNING_PPPOE="CONFIG_PPPOE:\t is not set (required for PPPoE links)" + local WARNING_ATM_BR2684="CONFIG_ATM_BR2684:\t is not set (required for PPPoE links)" + check_extra_config + echo + + # Check user-space for PPPoA support + if ! has_version net-dialup/ppp[atm] ; then + ewarn "Run the following command if connecting via PPPoA protocol:" + ewarn " euse -E atm && emerge net-dialup/ppp" + echo + fi + # Check user-space for PPPoE support + if ! has_version net-dialup/linux-atm ; then + ewarn "Run the following command if connecting via PPPoE protocol:" + ewarn " emerge net-dialup/linux-atm" + echo + fi + + ewarn "To complete the installation, you must read the documentation in" + ewarn " ${ROOT}usr/share/doc/${PF}" +} -- cgit v1.2.3