docs/50977: Additional tips for Alcatel SpeedTouch USB users

[Dominic Marks]

>Number:         50977
>Category:       docs
>Synopsis:       Additional tips for Alcatel SpeedTouch USB users
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Apr 15 05:20:12 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Dominic Marks
>Release:        FreeBSD 4.7-RELEASE-p3 i386
>Organization:
UMIST
>Environment:
System: FreeBSD moo.cus.org.uk 4.7-RELEASE-p3 FreeBSD 4.7-RELEASE-p3 #3: Mon Jan 20 23:49:12 GMT 2003 root at moo.cus.org.uk:/usr/obj/usr/src/sys/BAA i386

	
>Description:
	Some tips on making the Alcatel SpeedTouch USB even easier to
	use under FreeBSD. This covers making usbd aware of the device
	and setting it to automatically transmit the firmware and
	dialing at startup.

	Original idea: Jason Mann <jason at b0rken.org>
	DocBook conversion: Dominic Marks <dom at cus.org.uk>

	
>How-To-Repeat:
	NA

	
>Fix:

Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v
retrieving revision 1.102
diff -u -3 -p -r1.102 chapter.sgml
--- chapter.sgml	2003/04/13 14:51:40	1.102
+++ chapter.sgml	2003/04/14 16:37:19
@@ -2138,9 +2138,43 @@ ppp_profile="name_of_service_provider"</
 	base system of FreeBSD.</para>
 
       <para>To install the software, simply use the <link
-	  linkend="ports">ports collection</link>. Install the
-	<filename role="package">net/pppoa</filename> port and follow the
-	instructions provided with it.</para>
+        linkend="ports">ports collection</link>.  Install the
+        <filename role="package">net/pppoa</filename> port and follow
+        instructions which come with it.</para>
+
+      <para>Like many USB devices the Alcatel SpeedTouch USB needs to
+        download firmware from the host computer to be usable.  It is
+        possible to automate this process in &os; so that this is done
+        whenever the device is plugged into a USB port.  The following
+        information needs to be added to
+        <filename>/etc/usbd.conf</filename> and to do this you will need
+        to be logged in as the <username>root</username> user.
+
+      <programlisting>device "Alcatel SpeedTouch USB"
+    devname "ugen[0-9]+"
+    vendor 0x06b9
+    product 0x4061
+    attach "/usr/local/sbin/modem_run -f /usr/local/libdata/mgmt.o"</programlisting>
+
+     <para>To enable the USB daemon, <application>usbd</application> put
+       following line into <filename>/etc/rc.conf</filename>.</para>
+
+     <programlisting>usbd_enable="YES"</programlisting>
+
+     <para>It is also possible to set up <application>PPP</application>
+       to dial up at startup.  To do this add the following lines to
+       <filename>/etc/rc.conf</filename>, again for this procedure you
+       will need to be logged in as the <username>root</username>
+       user.</para>
+
+     <programlisting>ppp_enable="YES"
+ppp_mode="ddial"
+ppp_profile="adsl"</programlisting>
+
+     <para>For this to work correctly you will need to have used the
+       sample <filename>ppp.conf</filename> which is supplied with the
+       <filename role="package">net/pppoa</filename> port.</para>
+     
     </sect2>
 
     <sect2>

	


>Release-Note:
>Audit-Trail:
>Unformatted: