Difference between revisions of "USB Host"

From ArmadeusWiki
Jump to: navigation, search
m (Update according default configuration of armadeus3)
(Forcing an OTG port to Host mode (APF27 / APF51 / APF28))
 
(19 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
How-To use the USB Host functionnality of Armadeus boards under Linux.
 
How-To use the USB Host functionnality of Armadeus boards under Linux.
  
= Controller =
+
== Controller ==
To use USB devices on your Armadeus board, you will need to have a USB Host controller on your development board.
+
* [[APF9328DevFull|APF9328DevFull]]: it is equipped with a USB 2.0 Host controller (ISP1761) featuring three USB high speed ports. The ISP1761 driver is already configured with armadeus version 3. For older versions refer to the [[ISP1761_Linux_driver |how to install USB Host Linux driver for the DevFull]] page
*'''With an APF9328, only the [[APF9328DevFull|DevFull]] has this functionnality.''' It is equipped with a USB 2.0 Host controller featuring three USB high speed ports.
+
* [[APF27]] and [[APF27Dev]]: two Host ports are available. The controllers are integrated in the i.MX27 processor. Nothing has to be done to configure the controller. No special operation has to be done to use both USB ports (driver is included in default kernel).
**[[ISP1761_Linux_driver | To know how to install USB Host Linux driver for the DevFull]] <b>(already configured with armadeus svn version 978 or higher)</b>
+
* [[APF27 PPS]]: one Host port and one OTG port (that can be forced to Host mode). Default Linux kernel has all the needed drivers compiled in.
*On APF27 all the development boards will have at least 2 USB hosts (controllers are integrated in the i.MX27 processor).
+
* [[APF51Dev]]: 2 Host ports and one OTG port (that can be forced to Host mode). Default Linux kernel has all the needed drivers compiled in.
 +
* [[PPS51]] one Host port and one OTG port (that can be forced to Host mode). Default Linux kernel has all the needed drivers compiled in.
 +
* [[APF28Dev]]: one Host port and one OTG port (Host/slave mode automatically switched depending on cable). Default Linux kernel has all the needed drivers compiled in.
  
= Using USB devices =
+
== Forcing an OTG port to Host mode ([[APF27]] / [[APF51]] / [[APF28]])==
 +
* If you don't have an OTG compatible cable or an old APFDev board (ex: APF28Dev Rev 1), it might be needed to force Host mode on OTG port:
 +
<pre class="apf">
 +
BIOS> setenv extrabootargs ${extrabootargs} otg_mode=host
 +
BIOS> saveenv
 +
BIOS> boot
 +
</pre>
  
== USB keyboard/mouse (HID: Human Interface Device) ==  
+
== Using USB devices ==
=== Driver installation ===
+
*Add USB keyboard/mouse support in Linux <b>(already configured with armadeus svn version 978 or higher)</b>:
+
$ make linux26-menuconfig
+
  
select Device Drivers ---> [*] HID Devices  ---> <*>  Generic HID support  (static)
+
=== USB keyboard/mouse (HID: Human Interface Device) ===
select Device Drivers ---> [*] HID Devices  ---> <M>  USB Human Interface Device (full HID) support  (module)
+
==== Driver installation ====
 +
* [[Talk:USB_Host|Done by default]] in recent releases
  
=== Starting the driver===
+
====Plug the keyboard====
<b>(already active with armadeus svn version 978 or higher)</b>
+
* you should see on console (here on APF9328 for example):
# modprobe usbhid
+
<pre class="apf">
 
+
===Plug the keyboard===
+
* you should see on console (for example):
+
 
  usb 1-1.1: new low speed USB device using isp1761 and address 3
 
  usb 1-1.1: new low speed USB device using isp1761 and address 3
 
  usb 1-1.1: configuration #1 chosen from 1 choice
 
  usb 1-1.1: configuration #1 chosen from 1 choice
Line 29: Line 32:
 
  input: NOVATEK USB Keyboard as /class/input/input1
 
  input: NOVATEK USB Keyboard as /class/input/input1
 
  input: USB HID v1.10 Mouse [NOVATEK USB Keyboard] on usb-platform-1.1
 
  input: USB HID v1.10 Mouse [NOVATEK USB Keyboard] on usb-platform-1.1
* To change keyboard keymap (by default us one):
+
</pre>
 +
* To change keyboard keymap (by default US one is used):
 +
<pre class="apf">
 
  # loadkmap < /etc/i18n/fr.kmap
 
  # loadkmap < /etc/i18n/fr.kmap
 +
</pre>
  
===Plug the mouse===
+
====Plug the mouse====
* you should see on console (for example):
+
* you should see on console (here on APF9328 for example):
 +
<pre class="apf">
 
  usb 1-1.2: new low speed USB device using isp1761 and address 6
 
  usb 1-1.2: new low speed USB device using isp1761 and address 6
 
  usb 1-1.2: configuration #1 chosen from 1 choice
 
  usb 1-1.2: configuration #1 chosen from 1 choice
 
  input: Logitech USB-PS/2 Optical Mouse as /class/input/input6
 
  input: Logitech USB-PS/2 Optical Mouse as /class/input/input6
 
  input: USB HID v1.10 Mouse [Logitech USB-PS/2 Optical Mouse] on usb-platform-1.2
 
  input: USB HID v1.10 Mouse [Logitech USB-PS/2 Optical Mouse] on usb-platform-1.2
 +
</pre>
  
== USB Flash memory / USB key / USB card reader / USB Hard Drive==  
+
=== USB Flash memory / USB key / USB card reader / USB Hard Drive===  
=== Driver installation ===
+
==== Driver installation ====
<b>(already configured with armadeus svn version 978 or higher)</b>
+
* [[Talk:USB_Host|Done by default]] in recent releases.
* Add USB Flash support in Linux:
+
$ make linux26-menuconfig
+
  
select Device Drivers  ---> SCSI device support  ---> <*> SCSI device support        (static)
+
==== Plug the storage device ====
select Device Drivers  ---> SCSI device support  ---> [*] legacy /proc/scsi/ support  (static)
+
select Device Drivers  ---> SCSI device support  ---> <*> SCSI disk support          (static)
+
 
+
select Device Drivers  ---> [*] USB support  ---> [*]  USB device filesystem    (static)
+
select Device Drivers  ---> [*] USB support  ---> <*>  USB Mass Storage support  (static)
+
 
+
=== Plug the device ===
+
 
* You should see (for example):
 
* You should see (for example):
 +
<pre class="apf">
 
  usb 1-1.2: new high speed USB device using isp1761 and address 6
 
  usb 1-1.2: new high speed USB device using isp1761 and address 6
 
  usb 1-1.2: configuration #1 chosen from 1 choice
 
  usb 1-1.2: configuration #1 chosen from 1 choice
Line 60: Line 60:
 
  scsi 0:0:0:0: Direct-Access    Hama    Card Reader  CF 1.9C PQ: 0 ANSI: 0 CCS
 
  scsi 0:0:0:0: Direct-Access    Hama    Card Reader  CF 1.9C PQ: 0 ANSI: 0 CCS
 
  sd 0:0:0:0: [sda] Attached SCSI removable disk
 
  sd 0:0:0:0: [sda] Attached SCSI removable disk
 +
</pre>
  
=== Additional configuration ===
+
==== Additional configuration ====
 
* If /dev/sdaX does not exist, then create it:
 
* If /dev/sdaX does not exist, then create it:
 +
<pre class="apf">
 
  # mknod /dev/sda b 8 0
 
  # mknod /dev/sda b 8 0
 
  # mknod /dev/sda1 b 8 1
 
  # mknod /dev/sda1 b 8 1
 
  # mknod /dev/sda2 b 8 2
 
  # mknod /dev/sda2 b 8 2
 +
</pre>
 
* Create a mount directory "usbdisk"
 
* Create a mount directory "usbdisk"
 +
<pre class="apf">
 
  # mkdir -m 777 /mnt/usbdisk
 
  # mkdir -m 777 /mnt/usbdisk
 +
</pre>
  
=== Mount the device ===
+
==== Mount the device ====
 
* Mount the USB Mass Storage device
 
* Mount the USB Mass Storage device
 +
<pre class="apf">
 
  # mount -t vfat /dev/sda1 /mnt/usbdisk
 
  # mount -t vfat /dev/sda1 /mnt/usbdisk
 +
</pre>
 
* Check what is present on the USB Mass Storage device:
 
* Check what is present on the USB Mass Storage device:
 +
<pre class="apf">
 
  # ls -al /mnt/usbdisk
 
  # ls -al /mnt/usbdisk
 +
</pre>
 
* And if it is well mounted (for example):
 
* And if it is well mounted (for example):
 +
<pre class="apf">
 
  # mount
 
  # mount
 
  rootfs on / type rootfs (rw)
 
  rootfs on / type rootfs (rw)
Line 83: Line 93:
 
  sysfs on /sys type sysfs (rw)
 
  sysfs on /sys type sysfs (rw)
 
  /dev/sda1 on /mnt/usbdisk type msdos (rw,fmask=0022,dmask=0022,codepage=cp437)
 
  /dev/sda1 on /mnt/usbdisk type msdos (rw,fmask=0022,dmask=0022,codepage=cp437)
 +
</pre>
  
== USB <--> Serial adapters ==
+
=== USB <--> Serial adapters ===
 
* See [[USB_to_serial_adapter]]
 
* See [[USB_to_serial_adapter]]
  
== USB <--> WiFi adapters ==
+
=== USB <--> WiFi adapters ===
 
* See [[USB_to_WiFi_adapter]]
 
* See [[USB_to_WiFi_adapter]]
  
= Links =
+
==U-Boot usage==
 +
USB storage can also be used with U-Boot. The following commands are useful:
 +
 
 +
* start/restart the USB:
 +
<pre class="apf">
 +
BIOS> usb start
 +
</pre>
 +
* show available USB devices:
 +
<pre class="apf">
 +
BIOS> usb info
 +
</pre>
 +
* list the USB key content (mass storage only):
 +
<pre class="apf">
 +
BIOS> fatls usb 0
 +
</pre>
 +
* load the file xxx.bin in RAM:
 +
<pre class="apf">
 +
BIOS> fatload usb 0 ${loadaddr} xxx.bin
 +
</pre>
 +
 
 +
== Links ==
 
* Any links ?
 
* Any links ?
  

Latest revision as of 11:04, 23 April 2015

How-To use the USB Host functionnality of Armadeus boards under Linux.

Controller

  • APF9328DevFull: it is equipped with a USB 2.0 Host controller (ISP1761) featuring three USB high speed ports. The ISP1761 driver is already configured with armadeus version 3. For older versions refer to the how to install USB Host Linux driver for the DevFull page
  • APF27 and APF27Dev: two Host ports are available. The controllers are integrated in the i.MX27 processor. Nothing has to be done to configure the controller. No special operation has to be done to use both USB ports (driver is included in default kernel).
  • APF27 PPS: one Host port and one OTG port (that can be forced to Host mode). Default Linux kernel has all the needed drivers compiled in.
  • APF51Dev: 2 Host ports and one OTG port (that can be forced to Host mode). Default Linux kernel has all the needed drivers compiled in.
  • PPS51 one Host port and one OTG port (that can be forced to Host mode). Default Linux kernel has all the needed drivers compiled in.
  • APF28Dev: one Host port and one OTG port (Host/slave mode automatically switched depending on cable). Default Linux kernel has all the needed drivers compiled in.

Forcing an OTG port to Host mode (APF27 / APF51 / APF28)

  • If you don't have an OTG compatible cable or an old APFDev board (ex: APF28Dev Rev 1), it might be needed to force Host mode on OTG port:
BIOS> setenv extrabootargs ${extrabootargs} otg_mode=host
BIOS> saveenv
BIOS> boot

Using USB devices

USB keyboard/mouse (HID: Human Interface Device)

Driver installation

Plug the keyboard

  • you should see on console (here on APF9328 for example):
 usb 1-1.1: new low speed USB device using isp1761 and address 3
 usb 1-1.1: configuration #1 chosen from 1 choice
 input: NOVATEK USB Keyboard as /class/input/input0
 input: USB HID v1.10 Keyboard [NOVATEK USB Keyboard] on usb-platform-1.1
 input: NOVATEK USB Keyboard as /class/input/input1
 input: USB HID v1.10 Mouse [NOVATEK USB Keyboard] on usb-platform-1.1
  • To change keyboard keymap (by default US one is used):
 # loadkmap < /etc/i18n/fr.kmap

Plug the mouse

  • you should see on console (here on APF9328 for example):
 usb 1-1.2: new low speed USB device using isp1761 and address 6
 usb 1-1.2: configuration #1 chosen from 1 choice
 input: Logitech USB-PS/2 Optical Mouse as /class/input/input6
 input: USB HID v1.10 Mouse [Logitech USB-PS/2 Optical Mouse] on usb-platform-1.2

USB Flash memory / USB key / USB card reader / USB Hard Drive

Driver installation

Plug the storage device

  • You should see (for example):
 usb 1-1.2: new high speed USB device using isp1761 and address 6
 usb 1-1.2: configuration #1 chosen from 1 choice
 scsi0 : SCSI emulation for USB Mass Storage devices
 usb 1-1.2: reset high speed USB device using isp1761 and address 6
 scsi 0:0:0:0: Direct-Access     Hama     Card Reader   CF 1.9C PQ: 0 ANSI: 0 CCS
 sd 0:0:0:0: [sda] Attached SCSI removable disk

Additional configuration

  • If /dev/sdaX does not exist, then create it:
 # mknod /dev/sda b 8 0
 # mknod /dev/sda1 b 8 1
 # mknod /dev/sda2 b 8 2
  • Create a mount directory "usbdisk"
 # mkdir -m 777 /mnt/usbdisk

Mount the device

  • Mount the USB Mass Storage device
 # mount -t vfat /dev/sda1 /mnt/usbdisk
  • Check what is present on the USB Mass Storage device:
 # ls -al /mnt/usbdisk
  • And if it is well mounted (for example):
 # mount
 rootfs on / type rootfs (rw)
 /dev/root on / type jffs2 (rw)
 proc on /proc type proc (rw)
 devpts on /dev/pts type devpts (rw)
 tmpfs on /tmp type tmpfs (rw)
 sysfs on /sys type sysfs (rw)
 /dev/sda1 on /mnt/usbdisk type msdos (rw,fmask=0022,dmask=0022,codepage=cp437)

USB <--> Serial adapters

USB <--> WiFi adapters

U-Boot usage

USB storage can also be used with U-Boot. The following commands are useful:

  • start/restart the USB:
BIOS> usb start
  • show available USB devices:
BIOS> usb info
  • list the USB key content (mass storage only):
BIOS> fatls usb 0 
  • load the file xxx.bin in RAM:
BIOS> fatload usb 0 ${loadaddr} xxx.bin 

Links

  • Any links ?