Attachment #82541 for bug #110665

View | Details | Raw Unified | Return to bug 110665 | Differences between
Collapse All | Expand All




Configuration
=============

Most SpeedTouch USB modems are connected via the ATM protocol, rather
than Ethernet. For ATM, run the following:
   euse -E atm && emerge net-dialup/ppp net-dialup/speedtouch-usb

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.modules.d/pppd
link_ppp0='/dev/null'  # Not required by PPPoA links, but must be specified
# The 2 numbers represent the VPI & VCI of your ISP, and they are separated
# by a dot. Choose here, or ask your ISP:
#   http://www.linux-usb.org/SpeedTouch/faq/index.html#q12
plugins_ppp0=( 'pppoa 0.38' ) 
# '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/ppp/resolv.conf
pppd_ppp0=( updetach debug defaultroute noaccomp nobsdcomp noccp
	nodeflate nopcomp novj novjccomp )
username_ppp0='username@isp.com'  # E.g. 'fredbloggs@hg5.btclick.com'
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 pppoatm
		modprobe -q speedtch
	fi
}


b) PPPoE configuration:

config_ppp0=( 'ppp' )  # Runs /lib/rcscripts/net.modules.d/pppd
# The name of the Ethernet interface over which PPPoE links
link_ppp0='nas0' # Must correspond to the -c option of the br2684ctl utility
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/ppp/resolv.conf
pppd_ppp0=( updetach debug defaultroute noaccomp nobsdcomp noccp
	nodeflate nopcomp novj novjccomp )
username_ppp0='username@isp.com'  # E.g. 'fredbloggs@hg5.btclick.com'
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 speedtch
		# The number after "-c" corresponds with the Ethernet interface,
		# e.g. 0 for nas0.
		# 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. Choose here, or ask your ISP:
		#   http://www.linux-usb.org/SpeedTouch/faq/index.html#q12
		eval local nasifname=\$\{link_$1\}
		start-stop-daemon --start --pidfile /var/run/${nasifname}.pid --makepid -- \
			br2684ctl -c ${nasifname#nas} -e 0 -a 0.38
	fi
}

function postdown() {
	if [[ "$1" = "ppp0" ]] ; then
		eval local nasifname=\$\{link_$1\}
		start-stop-daemon --stop --pidfile /var/run/${nasifname}.pid
	fi
}

a) /etc/conf.d/net for PPPoA links:
  config_ppp0=( 'ppp' )  # Runs /lib/rcscripts/net.modules.d/pppd
  link_ppp0='/dev/null'  # Not required by PPPoA links, but must be specified
  # The 2 numbers represents the VPI&VCI of your ISP and they are separated 
  #by a dot. Choose here, or ask your ISP:
  #   http://www.linux-usb.org/SpeedTouch/faq/index.html#q12
  plugins_ppp0=( 'pppoa 0.38' ) 
  # '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/ppp/resolv.conf
  pppd_ppp0=( updetach debug defaultroute noaccomp nobsdcomp noccp
    nodeflate nopcomp novj novjccomp )
  username_ppp0='username@isp.com'  # E.g. 'fredbloggs@hg5.btclick.com'
  password_ppp0='password'  # ADSL password, assigned by your ISP

  # If the kernel modules are not built-in, then you also need to load
  # them before starting the PPP daemon:
  function preup() {
    if [[ "$1" = "ppp0" ]] ; then
      modprobe -q pppoatm
      modprobe -q speedtch
    fi
  }
  
b) /etc/conf.d/net for PPPoE links:
  config_ppp0=( 'ppp' )  # Runs /lib/rcscripts/net.modules.d/pppd
  # The name of the Ethernet interface over which PPPoE link
  link_ppp0='nas0' #must correspond to the -c option of the br2684ctl utility
  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/ppp/resolv.conf
  pppd_ppp0=( updetach debug defaultroute noaccomp nobsdcomp noccp
    nodeflate nopcomp novj novjccomp )
  username_ppp0='username@isp.com'  # E.g. 'fredbloggs@hg5.btclick.com'
  password_ppp0='password'  # ADSL password, assigned by your ISP

  # If the kernel modules are not built-in, then you also need to load
  # them before starting the PPP daemon:
  function preup() {
    if [[ "$1" = "ppp0" ]] ; then
      modprobe -q speedtch
	  # The number after -c correspond with the name of the Ethernet
      # interface (e.g. 0 for nas0, ...)
      # Use -e 0 for LLC mux or -e 1 for VC mux 
      # The 2 numbers after -a represents the VPI&VCI of your ISP and 
      # they are separated by a dot. Choose here, or ask your ISP:
      #   http://www.linux-usb.org/SpeedTouch/faq/index.html#q12
	  eval local nasifname=\$\{link_$1\}
	  start-stop-daemon --start --pidfile /var/run/${nasifname}.pid --makepid -- \
	  	br2684ctl -c ${nasifname#nas} -e 0 -a 0.38
    fi
  }
  function postdown() {
    if [[ "$1" = "ppp0" ]] ; then
	  eval local nasifname=\$\{link_$1\}
	  start-stop-daemon --stop --pidfile /var/run/${nasifname}.pid
    fi
  }

Create a symlink for the new network interface, for it to be enabled by
baselayout:

"sent [LCP ConfReq id=0x1 <magic 0x7bea6ef1>]". It is wise to keep the
option on permanently, due to its usefulness when debugging.

Alternatively, if you choosed to compile speedtouch driver as a 
kernel module, you could load it through /etc/modules.autoload.d/kernel-2.6
instead of loading it in preup function.
This allows the kernel to load the firmware during bootup, before the
network is configured, thus saving a couple of seconds from the startup
time.

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

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 preferable, 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. "speedtouch"
to see exactly where an option is - the location of an option and its

   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  --->

        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

Return to bug 110665

Lines 10-83 Link Here

(-)README-old (-70 / +76 lines)
10	Configuration	10	Configuration
11	=============	11	=============
12		12
		13	Most SpeedTouch USB modems are connected via the ATM protocol, rather
		14	than Ethernet. For ATM, run the following:
		15	euse -E atm && emerge net-dialup/ppp net-dialup/speedtouch-usb
		16
13	It is necessary to choose an interface number for the connection. This	17	It is necessary to choose an interface number for the connection. This
14	is arbitrary - the only requirement is that the connection number is	18	is arbitrary - the only requirement is that the connection number is
15	not already in use. The first available number is 0, and it is usual to	19	not already in use. The first available number is 0, and it is usual to
16	choose the lowest unused number. For the purposes of this document, 0	20	choose the lowest unused number. For the purposes of this document, 0
17	will be chosen.	21	will be chosen.
18		22
19	Add the following lines to /etc/conf.d/net, then customize them as per	23	Add the following lines from the appropriate section below to
20	the inline comments.	24	/etc/conf.d/net, then customize them as per the inline comments.
		25
		26
		27	a) PPPoATM configuration:
		28
		29	config_ppp0=( 'ppp' ) # Runs /lib/rcscripts/net.modules.d/pppd
		30	link_ppp0='/dev/null' # Not required by PPPoA links, but must be specified
		31	# The 2 numbers represent the VPI & VCI of your ISP, and they are separated
		32	# by a dot. Choose here, or ask your ISP:
		33	# http://www.linux-usb.org/SpeedTouch/faq/index.html#q12
		34	plugins_ppp0=( 'pppoa 0.38' )
		35	# 'man pppd' shows other options. Compression is disabled because it is
		36	# rarely taken advantage of, and may interfere with the connection.
		37	# Add option 'usepeerdns' to populate /etc/ppp/resolv.conf
		38	pppd_ppp0=( updetach debug defaultroute noaccomp nobsdcomp noccp
		39	nodeflate nopcomp novj novjccomp )
		40	username_ppp0='username@isp.com' # E.g. 'fredbloggs@hg5.btclick.com'
		41	password_ppp0='password' # ADSL password, assigned by your ISP
		42
		43	# If the kernel modules are not built-in, then they must be loaded
		44	# before starting the PPP daemon:
		45	function preup() {
		46	if [[ "$1" = "ppp0" ]] ; then
		47	modprobe -q pppoatm
		48	modprobe -q speedtch
		49	fi
		50	}
		51
		52
		53	b) PPPoE configuration:
		54
		55	config_ppp0=( 'ppp' ) # Runs /lib/rcscripts/net.modules.d/pppd
		56	# The name of the Ethernet interface over which PPPoE links
		57	link_ppp0='nas0' # Must correspond to the -c option of the br2684ctl utility
		58	plugins_ppp0=( pppoe )
		59	# 'man pppd' shows other options. Compression is disabled because it is
		60	# rarely taken advantage of, and may interfere with the connection.
		61	# Add option 'usepeerdns' to populate /etc/ppp/resolv.conf
		62	pppd_ppp0=( updetach debug defaultroute noaccomp nobsdcomp noccp
		63	nodeflate nopcomp novj novjccomp )
		64	username_ppp0='username@isp.com' # E.g. 'fredbloggs@hg5.btclick.com'
		65	password_ppp0='password' # ADSL password, assigned by your ISP
		66
		67	# If the kernel modules are not built-in, then they must be loaded
		68	# before starting the PPP daemon:
		69	function preup() {
		70	if [[ "$1" = "ppp0" ]] ; then
		71	modprobe -q speedtch
		72	# The number after "-c" corresponds with the Ethernet interface,
		73	# e.g. 0 for nas0.
		74	# Use "-e 0" for LLC mux or "-e 1" for VC mux.
		75	# The 2 numbers after "-a" represent the VPI & VCI of your ISP, and
		76	# they are separated by a dot. Choose here, or ask your ISP:
		77	# http://www.linux-usb.org/SpeedTouch/faq/index.html#q12
		78	eval local nasifname=\$\{link_$1\}
		79	start-stop-daemon --start --pidfile /var/run/${nasifname}.pid --makepid -- \
		80	br2684ctl -c ${nasifname#nas} -e 0 -a 0.38
		81	fi
		82	}
		83
		84	function postdown() {
		85	if [[ "$1" = "ppp0" ]] ; then
		86	eval local nasifname=\$\{link_$1\}
		87	start-stop-daemon --stop --pidfile /var/run/${nasifname}.pid
		88	fi
89	}
21		90
22	a) /etc/conf.d/net for PPPoA links:
23	config_ppp0=( 'ppp' ) # Runs /lib/rcscripts/net.modules.d/pppd
24	link_ppp0='/dev/null' # Not required by PPPoA links, but must be specified
25	# The 2 numbers represents the VPI&VCI of your ISP and they are separated
26	#by a dot. Choose here, or ask your ISP:
27	# http://www.linux-usb.org/SpeedTouch/faq/index.html#q12
28	plugins_ppp0=( 'pppoa 0.38' )
29	# 'man pppd' shows other options. Compression is disabled because it is
30	# rarely taken advantage of, and may interfere with the connection.
31	# Add option 'usepeerdns' to populate /etc/ppp/resolv.conf
32	pppd_ppp0=( updetach debug defaultroute noaccomp nobsdcomp noccp
33	nodeflate nopcomp novj novjccomp )
34	username_ppp0='username@isp.com' # E.g. 'fredbloggs@hg5.btclick.com'
35	password_ppp0='password' # ADSL password, assigned by your ISP
36
37	# If the kernel modules are not built-in, then you also need to load
38	# them before starting the PPP daemon:
39	function preup() {
40	if [[ "$1" = "ppp0" ]] ; then
41	modprobe -q pppoatm
42	modprobe -q speedtch
43	fi
44	}
45
46	b) /etc/conf.d/net for PPPoE links:
47	config_ppp0=( 'ppp' ) # Runs /lib/rcscripts/net.modules.d/pppd
48	# The name of the Ethernet interface over which PPPoE link
49	link_ppp0='nas0' #must correspond to the -c option of the br2684ctl utility
50	plugins_ppp0=( pppoe )
51	# 'man pppd' shows other options. Compression is disabled because it is
52	# rarely taken advantage of, and may interfere with the connection.
53	# Add option 'usepeerdns' to populate /etc/ppp/resolv.conf
54	pppd_ppp0=( updetach debug defaultroute noaccomp nobsdcomp noccp
55	nodeflate nopcomp novj novjccomp )
56	username_ppp0='username@isp.com' # E.g. 'fredbloggs@hg5.btclick.com'
57	password_ppp0='password' # ADSL password, assigned by your ISP
58
59	# If the kernel modules are not built-in, then you also need to load
60	# them before starting the PPP daemon:
61	function preup() {
62	if [[ "$1" = "ppp0" ]] ; then
63	modprobe -q speedtch
64	# The number after -c correspond with the name of the Ethernet
65	# interface (e.g. 0 for nas0, ...)
66	# Use -e 0 for LLC mux or -e 1 for VC mux
67	# The 2 numbers after -a represents the VPI&VCI of your ISP and
68	# they are separated by a dot. Choose here, or ask your ISP:
69	# http://www.linux-usb.org/SpeedTouch/faq/index.html#q12
70	eval local nasifname=\$\{link_$1\}
71	start-stop-daemon --start --pidfile /var/run/${nasifname}.pid --makepid -- \
72	br2684ctl -c ${nasifname#nas} -e 0 -a 0.38
73	fi
74	}
75	function postdown() {
76	if [[ "$1" = "ppp0" ]] ; then
77	eval local nasifname=\$\{link_$1\}
78	start-stop-daemon --stop --pidfile /var/run/${nasifname}.pid
79	fi
80	}
81		91
82	Create a symlink for the new network interface, for it to be enabled by	92	Create a symlink for the new network interface, for it to be enabled by
83	baselayout:	93	baselayout:
Lines 88-100 Link Here
88	"sent [LCP ConfReq id=0x1 <magic 0x7bea6ef1>]". It is wise to keep the	98	"sent [LCP ConfReq id=0x1 <magic 0x7bea6ef1>]". It is wise to keep the
89	option on permanently, due to its usefulness when debugging.	99	option on permanently, due to its usefulness when debugging.
90		100
91	Alternatively, if you choosed to compile speedtouch driver as a
92	kernel module, you could load it through /etc/modules.autoload.d/kernel-2.6
93	instead of loading it in preup function.
94	This allows the kernel to load the firmware during bootup, before the
95	network is configured, thus saving a couple of seconds from the startup
96	time.
97
98	Set RC_NET_STRICT_CHECKING="yes" in /etc/conf.d/rc, to prevent Internet	101	Set RC_NET_STRICT_CHECKING="yes" in /etc/conf.d/rc, to prevent Internet
99	services in /etc/init.d/ from starting before the Internet connection	102	services in /etc/init.d/ from starting before the Internet connection
100	is established. Other options are to start/stop programs in	103	is established. Other options are to start/stop programs in
Lines 123-129 Link Here
123	into the kernel, whereas "[M]" means that the option can either be	126	into the kernel, whereas "[M]" means that the option can either be
124	compiled into the kernel, or as a module. Compiling them into the	127	compiled into the kernel, or as a module. Compiling them into the
125	kernel is preferable, to guarantee that the modules are already loaded	128	kernel is preferable, to guarantee that the modules are already loaded
126	when they are needed.	129	when they are needed, and it will improve the bootup time by a couple
		130	of seconds.
127		131
128	In "make menuconfig", you can press "/" and search on e.g. "speedtouch"	132	In "make menuconfig", you can press "/" and search on e.g. "speedtouch"
129	to see exactly where an option is - the location of an option and its	133	to see exactly where an option is - the location of an option and its
Lines 151-156 Link Here
151	Networking options --->	155	Networking options --->
152	[*] Packet socket - CONFIG_PACKET	156	[*] Packet socket - CONFIG_PACKET
153	[M] Asynchronous Transfer Mode (ATM) - CONFIG_ATM	157	[M] Asynchronous Transfer Mode (ATM) - CONFIG_ATM
		158	[M] RFC1483/2684 Bridged protocols - CONFIG_ATM_BR2684 (only needed for PPPoE)
154		159
155	Device Drivers --->	160	Device Drivers --->
156	Network device support --->	161	Network device support --->
Lines 160-166 Link Here
160	compression is supported - rare)	165	compression is supported - rare)
161	[M] PPP BSD-Compress compression - CONFIG_PPP_BSDCOMP (only useful	166	[M] PPP BSD-Compress compression - CONFIG_PPP_BSDCOMP (only useful
162	if compression is supported - rare)	167	if compression is supported - rare)
163	[M] PPP over ATM - CONFIG_PPPOATM	168	[M] PPP over Ethernet - CONFIG_PPPOE (only needed for PPPoE)
		169	[M] PPP over ATM - CONFIG_PPPOATM (only needed for PPPoATM)
164	USB support --->	170	USB support --->
165	[*] Support for Host-side USB - CONFIG_USB	171	[*] Support for Host-side USB - CONFIG_USB
166	[*] USB device filesystem - CONFIG_USB_DEVICEFS	172	[*] USB device filesystem - CONFIG_USB_DEVICEFS