14/04/2001 Benoit PAPILLAULT <benoit.papillault@free.fr>
26/04/2001 Updated.
22/07/2001 Updated. 

1. Which linux kernel version was used to develop this software:
	linux kernel version 2.4.3 >=

2. What configuration has been tested:

  See results.txt

3. I can see a lot of line like
  "usbdevfs: USBDEVFS_BULK failed dev 2 ep 0x81 len 16 ret -110", what's that?

There are "normal" error messages output by your linux kernel.
Don't worry too much about them. It may be fixed in a future release.

4. I can see a lot of line like:
  "usbdevfs: async_completed: status -2 errcount 0 actlen 0 pipe 0xc0008280"

This is entirely normal message output by your kernel. If this is a worry
for you (log file are too big), there is only one solution :

  - go to /usr/src/linux/drivers/usb/devio.c 
  - change #if 1 to #if 0 in async_completed() function
  - compile/install your new usbcore.o module.

5. I try everything you said and it does not work.

You may get some help from the mailing list speedtouch@ml.free.fr or directly
from the author (benoit.papillault@free.fr). The mailing list archive is at 
http://www.mail-archive.com/speedtouch@ml.free.fr/.

However, you must give as many details about your configuration as possible.

- your USB controller : cat /proc/pci
- your kernel version : uname -a
- your pppd version   : pppd -V
- your driver version : modem_run --help
- your vpi/vci
- your ADSL provider & ISP name
- relevant section of /var/log/messages & /var/log/kern/info & /tmp/pppoa2.log
  you can modify your ppp option file to run the pppoa2 program with option -v 2
  This will result in a more detailed pppoa2.log
- your problem description : crash, can't connect, poor performance
- anything you think it might be usefull

You are of course encourage to modify the source code yourself & post
your working modification to the list.

6. Does it need kernel patches or pppd patches to work?
NO! No patch at all are required. They may just be incompatible with this 
driver. 

7. What kernel version is known to work?

  2.2.x series : 2.2.17, 2.2.17-21mdk
  2.4.x series : 2.4.0, 2.4.2, 2.4.3, 2.4.4, 2.4.5
                 2.4.6, 2.4.7

Kernel older than 2.2.17 does not work
Kernel 2.4.1 freezes.

8. I have seen messages like:
"usbdevfs: process 833 (pppoa2) did not claim interface 1 before use".
Does it mean that something is wrong?

No. It is just a programmer error in the source code of the program. It has
no consequence on the behaviour of the driver. Just signal them to the 
maintainer.

9. I have heard about upload problems. What is the current status?

This problem is solved by using the HDLC line discipline. No upload or
download limits are hardcoded in the driver. The upstream/downstream speed 
messages is purely informationnal and is not use in any part of this driver.

10. Sometimes the line is disconnected. What happens?

There are many people having this problem. I'm currently working on it. If you
think that you can help us or can reproduce the problem, send an email to the
mailing list.

11. I'd like to start my connection when linux is started. How to do that?

Just copy adsl.sh to /etc/rc.d/init.d (exact path may vary according to your
distribution):

[example for Mandrake 7.2]
cp adsl.sh /etc/rc.d/init.d/
cd /etc/rc.d/init.d
chkconfig adsl.sh on

12. pppd says that there is no PPP support.

=> look at /dev/ppp. "ls -la"  should give
crw-rw----    1 root     root     108,   0 sep 27  2000 /dev/ppp

If not, create /dev/ppp with the following commands:
mknod /dev/ppp c 108 0

Q.13 When I got disconnect by my Internet provider, pppd is unable to
reconnect automatically, saying "Modem hangup". If I look at /tmp/pppoa2.log
files, it shows the following messages

"usbfs_claimintf: Device or resource busy".

This is a known pb. See the file HDLC_BUG for instructions on how to patch
your kernel sources. If the problem persist, get in touch.

Q.14

> May 18 01:53:43 panoramix pppd[908]: pppd 2.4.0 started by Stephane, uid 0
> May 18 01:53:43 panoramix pppd[908]: ioctl(PPPIOCSDEBUG): Invalid argument
> May 18 01:53:43 panoramix pppd[908]: ioctl(PPPIOCGFLAGS): Invalid argument
> May 18 01:53:43 panoramix pppd[908]: Exit.
> May 18 01:53:43 panoramix modprobe: modprobe: Can't locate module
> tty-ldisc-13

==> ??? 

Q.15 What interesting files I should look at in case of problems?

/var/log/messages
/var/log/daemong.log
/tmp/pppoa2.log

If /var/log/daemon.log does not exist, you can create it by adding
"daemon.* /var/log/daemon.log" at the end of "/etc/syslog.conf"
Next, restart syslog with '/etc/rc.d/init.d/syslog restart'

Q.16 What login I should use with Club Internet (ISP)?

Use : login@clubadsl1

Q.17 Which vpi.vci should I use? 

Here are some working values for some people, your configuration may differ

vpi.vci = 8.48 for netherlands
          8.35 or 8.67 for france
          8.35 for Belgium
          8.35 for Italy
          0.38 for UK
