Subversion Repositories or1k

README for embedded host controller SL811 (i386)

================================================

Original drivers from Pei Liu  for ARM architecture only.

Documentaion and readme for Architecture x86 (ADNP/1486) premealy.

Kernel configuration:

---------------------

o Patch USB drivers into your kerneltree

        cd Your_kernel_root

        gunzip linux-2.4.20-usb-1.patch.gz

        patch -p1 -T < linux-2.4.20-usb*.patch

   OR

        gunzip -dc linux-2.4.20-usb*.patch.gz | patch -p1 -T

o Load default configuration for CP486SX/2 with ADNP/1486 and USB

        arch/i386/adnp1486-usb104-SSV20030516

o Run "make configure" and set / verify this entries

    Code maturity level options  --->

        [*] Prompt for development and/or incomplete code/drivers

    General setup  --->

        [*] PCI support

        (BIOS)   PCI access mode

        [ ] PCI device name database

    SCSI support  --->

         SCSI support

           SCSI disk support

        (8) Maximum number of SCSI disks that can be loaded as modules

        ... Disable all other options ...

        SCSI low-level drivers  --->

            ... Disable all low level drivers ...

    Input core support  --->

         Input core support                     (Need only for Keyboard or Mouse)

           Keyboard support

           Mouse support

    Character devices  --->

        [*] Virtual terminal                    (Need only for Keyboard)

    Console drivers  --->

        [*] VGA text console                    (Need only for Key/Mouse)

        Frame-buffer support  --->              (... or use FB)

    USB support  --->

         Support for USB

        [ ]   USB verbose debug messages        (Optional)

        [*]   Preliminary USB device filesystem (Optional for debugging)

    --- USB Host Controller Drivers

           SL811HS Alternate (support isochronous mode)

        ...

           SL811HS (x86, StrongARM)  support (old driver)

        Disable all others "USB Host Controller Drivers"

    --- USB Device Class drivers

           USB Mass Storage support

        ... and some aditional devices ...

           USB Printer support

           USB HIDBP Keyboard (basic) support

           USB HIDBP Mouse (basic) support

        USB Serial Converter support  --->

             USB Serial Converter support

               USB FTDI Single Port Serial Driver

o We have no PCI- and no SCSI-System, but all USB-drivers need CONFIG_PCI=y.

  USB-Floppy driver need the SCSI-Subsystem, so we must enable this global

  and disable all low level drivers in this menu.

--- OR ---

  Download origanal kerneltree, and patch comlplete ADNP

  with USB support and load configuration for this:

        bunzip2 -c linux-2.4.20.tar.bz2 | tar xvf -

        gunzip -c linux-2.4.20-SSV20030516.diff.gz | patch -p1 -T

        Configuration: arch/i386/adnp1486-usb104-SSV20030516

o Compile the kernel

  make dep

  make ROOT_DEV=/dev/ram0 zImage

  make modules

  export INSTALL_MOD_PATH="`pwd`/_install" ; make modules_install

Default device configuration hc_sl811.o for USB1/104:

-----------------------------------------------------

io      = 0x220

irq     = 12

Remember: Second Controller was handled internal with IO offset +2.

Installation hc_sl811.o for CF1/USB:

------------------------------------

Compact Flash to USB adapter in io address of ide driver. It is for embedded

deviced only.

Please disable IDE driver in kernel configuration or do not load IDE drivers!

Change MAX_CONTROLERS = 1 into source asm/sl811-hw.h, recompile driver!

  First Controller only

    insmod hc_sl811.o io=0x1F0 irq=14

  Second Controller only

    insmod hc_sl811.o io=0x3F6 irq=14

Driver hc_sl811.o can not handle both controllers at same time.

This driver need a address-offset of 2 between controllers.

Please use alternate driver sl811.o instand.

Installation Alternate driver sl811.o:

--------------------------------------

This driver have a better interrupt handler, but don't tested with all devices.

Install both controllers on USB1-104 (default):

    insmod sl811.o io=0x220,0x222 irq=12,12

Install both controllers on CF/USB1:

    insmod sl811.o io=0x1f0,0x3f6 irq=14,14

Second controller can disable with specific IOBASE=0 for this controller.

General about USB:

------------------

Please install first the driver for hardware,

and than plugin the hardware into first USB port.

If your hardware find no driver the usbcore give ub a massage for missing

driver on conole or in file /proc/kmsg such as:

    new USB device -1.9, assigned address 7

    USB device 7 (vend/prod 0x403/0x8372) is not claimed by any active drive

In this case remove the hardware from USB port, install the driver and

than plugin hardware again.

A list of driver for this missing hardware can found in file

/_install/lib/modules/2.4.20/modules.usbmap

Search the number 8372 in this file an verify the vendor ID. So you will

find the driver name "ftdi_sio" in this file.

If your hardware not listen in this file. Look into source and search your

numbers in source.

More read file:/Documentation/usb/proc_usb_info.txt

Drivers are all under contructions. So some drivers make a kernel panic. In

this case read all about the drivers dokumentaiona and the drivers source.

Some drivers need a other kernel driver, but not strictly checked in kenel

configuration. Here can help the ksymsoops.

Install a Floppy (NEC UF0001) or USB Stick Fujitsu/Siemens/iomega:

------------------------------

Copy files to target (FTP) and load all drivers.

Load Generic USB-Handler

        insmod usbcore.o

Load USB-Host controller, parameters are optional (default urb_debug=0 io=220 irq=12)

        insmod hc_sl811.o

Run the USB-Filesystem

        mount -t usbdevfs usbdevfs /proc/bus/usb

Load drivers for disk storage and file systems

        insmod scsi_mod.o

        insmod usb-storage.o

        insmod fat.o

        insmod vfat.o

        insmod sd_mod.o

Create node for floppy

        mknod /dev/sda b 8 0

Put a disk into your floppy anth than plugin a USB-Floppy (such NEC Model UF0001)

into first USB-Port. Some Messages will be list on console or in file /proc/kmsg.

The disk is power on and the SCSI driver will search some partions on disk. Floppy

have no partions, so must use the first SCSI device without a partion number for mount.

Than mount the floppy:

        mount /dev/sda /mnt -t vfat

If you see a partions check with valid partion 1, you should mount this partion.

Mostly Memory Sticks are formated with one partion. But if Windows format it again,

no partions is use.

You see that:

        Partition check:

         sda: sda1

Than mount with follow steps:

        mknod /dev/sda1 b 8 1

        mount /dev/sda1 /mnt -t vfat

Create complete list of nodes for SCSI-devices:

    # First inserted device

    echo -n "Create /dev/sda... "

    mknod /dev/sda b 8 0

    for i in  1 2 3 4 5 6 7

    do

      echo -n "$i "

      mknod sda$i c 8 $i

    done

    # Second inserted device

    echo -n "Create /dev/sdb... "

    mknod /dev/sdb b 8 16

    mknod /dev/sdb1 b 8 17

    echo " done"

    # Set some rights

    chown root.disk sd*

    chmod 660 sd*

Install a Keyboard:

-------------------

Copy files to target (FTP) and load all drivers.

Load Generic USB-Handler

        insmod usbcore.o

Load USB-Host controller, parameters are optional (default urb_debug=0 io=220 irq=12)

        insmod hc_sl811.o

Run the USB-Filesystem

        mount -t usbdevfs usbdevfs /proc/bus/usb

Load drivers for USB-Keyboard

        insmod input.o

        insmod keybdev.o

        insmod usbkbd.o

Now you can plugin Keyboard into first USB-Port and login on first console.

Something stuff:

"Undefined Symbols handle_scancode, keyboard_tasklet, kbd_ledfunc" at install ???

USB keyboard need PC-style keyboard driver, because the USB driver

simulate standard AT-Keycodes. A normaly AT- or PS/2-Keyboard must not

exist for this. The driver says normaly error (Timeout) on boot.

You must enable CONFIG_VT in kernel konfiguration!

Character devices  --->

    [*] Virtual terminal

    [ ]   Support for console on virtual terminal

Read 

Install a Mouse:

----------------

Load Generic USB-Handle

        insmod usbcore.o

Load USB-Host controller

        insmod hc_sl811.o

Run the USB-Filesystem

        mount -t usbdevfs usbdevfs /proc/bus/usb

Load Generic Input device

        insmod input.o

Load USB-Mouse driver

        insmod input.o

        insmod mousedev.o

        insmod usbmouse.o

Read 

Install a serial adapter (Sample FTDI):

---------------------------------------

Load Generic USB-Handle

        insmod usbcore.o

Load USB-Host controller

        insmod hc_sl811.o

Run the USB-Filesystem

        mount -t usbdevfs usbdevfs /proc/bus/usb

Load Generic derial device and hardware specific device

        insmod usbserial.o

        insmod ftdi_sio.o

Create node entry for this device

        mknod /dev/ttyUSB0 c 188 0

Than plugin the hardware into first USB port and

use serial device on /dev/ttyUSB0, such call a login:

        /sbin/getty 115200 ttyUSB0 vt100 &

USB-Utils:

----------

- usb-0.6-7.rpm, usb-0.6-7.src.rpm

  /usr/sbin/lsusb, /usr/share/usb.ids

  Good tool to list devices parameters.

  You must load usbcore.o, hc_sl811.o and proc-usb before

  program works right (use script usb.sh).

  More details: Install usb-0.6-7.rpm on Your desktop and use "man lsusb".

Known Bugs:

-----------

PL2302 Profilic USB to serial converter will not work with hc_sl811.c (Bulk/Timeout).

USB Floppy will not work with alternate driver sl811.o (Sector not found)

CHANGELOG:

----------

* Fri 03 Okt 2003 hne

- Patch for 2.4.23-pre6

- Only low level port io in hardware include as inline functions.

- Move hc_sl811 and sl811 into host directory.

- sl811 for two controllers (alternate x86 only).

* Mit 24 Sep 2003 hne

- Misplaced "host/uhci.o" in Makefile.

- Move all x86/arm arch depens from main sl811.c to sl811-hw.h.

* Die 23 Sep 2003 hne

- Put arm and x86 architectur into separate file in include directory.

- Modifications for both controllers on CF/USB1, alternate sl811 only.

  Parameter for CF/USB1: "io=0x1f0,0x3f6 irq=14".

* Fri 19 Sep 2003 hne

- First version for both controllers on USB1-104.

- Alternative driver sl811.c from kernel 2.4.22 (thanks Yinah),

  also for 2.4.20. USB Sticks works, Floppy not.

* Die 02 Sep 2003 hne

- IO range only 2 address. For CF1USB we need io addres 3F6 and 3F7,

  but do not use 3f8 (ttyS0).

* Mon 11 Aug 2003 hne

- Comments for using iomega Memory Stick

* Don 12 Jun 2003 hne

- Added Bus-Name for Kernel 2.4.20, no pattern_test at unload driver.

- more doc

* Fri May 16 2003 hne

- More comments, new patchfile, include usb-konfiguration as file

* Wed May 14 2003 hne

- Patch error: Old Sources was in Kerneltree!

* Mon Mar 17 2003 hne

- Copy usb SL811 from 2.4.19-rc into 2.4.20 kerneltree

- Add SL811 in Config and Make

* 18.11.2002 hne

- hc_sl811_rh.c:

  rh_unlink_urb: Use usb_dec_dev_use instand of usb_put_dev. Function

  usb_put_dev isn't known in this module. Some others have a macro for

  this. What is right usb_put_dev or usb_dec_dev_use?

- hc_sl811.c:

  Split into 3 files. Arcitectures store in hc_sl811-arm.c and hc_sl811-x86.c

  Correct release_region() for both io address, so we can unload modul and

  load again without reboot.

  All IO access use 8 bit Data and register number (type __u8).

  All functions static.

  Only x86: base_addr renamed to io. data_reg_addr not used.