sta2x11linux drivers rel 20120309

Release Note Rel_RC4_20120309

1

STA2X11-CUT2 Linux Drivers



2

1. Introduction .............................................................................................................................. 6

1.1. Release Description ........................................................................................................... 6

1.2. NOTES ................................................................................................................................ 6

1.3. NEW FUNCTIONALITIES ..................................................................................................... 7

1.4. RESOLVED BUGS ................................................................................................................ 7

1.5. KNOWN BUGS ................................................................................................................... 8

1.5.1. HW DEPENDENT BUGS ................................................................................................... 8

1.5.2. UPSTREAM BUG ............................................................................................................. 8

1.6. Reference test setup.......................................................................................................... 8

1.7. Acronyms .......................................................................................................................... 9

2. Format of deliverables .............................................................................................................. 9

3. Installation ................................................................................................................................ 9

4. Components detailed description ........................................................................................... 10

4.1. Platform .......................................................................................................................... 10

4.1.1. Licence ..................................................................................................................... 11

4.1.2. Hardware supported platform ................................................................................. 11

4.1.3. Supported functionalities ........................................................................................ 11

4.1.4. Missing functionalities ............................................................................................. 11

4.1.5. Know issues and limitations..................................................................................... 11

4.2. MFD ................................................................................................................................. 11

4.2.1. Licence ..................................................................................................................... 12


4.2.3. New supported functionalities ................................................................................ 12



4.3. PCIEAMBA ....................................................................................................................... 12

4.3.1. Licence ..................................................................................................................... 12





4.4. UART ............................................................................................................................... 13


3

4.4.1. Licence ..................................................................................................................... 13





4.5. USB Host .......................................................................................................................... 14

4.5.1. Licence ..................................................................................................................... 14





4.6. SATA ................................................................................................................................ 14

4.6.1. Licence ..................................................................................................................... 15





4.7. ETHERNET ........................................................................................................................ 15

4.7.1. Licence ..................................................................................................................... 15





4.8. DMA ................................................................................................................................ 16

4.8.1. Licence ..................................................................................................................... 16





4.9. I2C ................................................................................................................................... 17

4.9.1. Licence ..................................................................................................................... 17



4




4.10. VIP ............................................................................................................................... 17

4.10.1. Licence ..................................................................................................................... 18





4.11. USB OTG ...................................................................................................................... 18

4.11.1. Licence ..................................................................................................................... 18





4.12. SPI ................................................................................................................................ 19

4.12.1. Licence ..................................................................................................................... 19





4.13. CAN .............................................................................................................................. 20

4.13.1. Licence ..................................................................................................................... 20





4.14. MLB ............................................................................................................................. 20

4.14.1. Licence ..................................................................................................................... 21


4.14.3. Supported functionalities ........................................................................................ 21



5


4.15. MSP ............................................................................................................................. 21

4.15.1. Licence ..................................................................................................................... 22





4.16. SOUND ......................................................................................................................... 22

4.16.1. Licence ..................................................................................................................... 23





4.17. SD/MMC ...................................................................................................................... 24

4.17.1. Licence ..................................................................................................................... 24





4.18. FM RADIO .................................................................................................................... 24

4.18.1. Licence ..................................................................................................................... 24






6

1. Introduction

This release note describes the contents of the Linux delivery for the STA2X11-CUT2 device from STMicroelectronics. The STA2X11 is an I/O Hub for next generation of Intel® Atom product. It allows connecting a PCI Express root complex to a number of interfaces.

1.1. Release Description

This release includes patches for STA2X11-CUT2 Linux drivers, a tar ball of all changed source files, test code and test results.

This release package include following drivers:

Platform MFD PCIEAMBA UART USB HOST SATA ETHERNET DMA I2C VIP USB OTG SPI CAN MLB MSP SOUND SD/MMC FM RADIO

CAN, MLB, FM RADIO and USB-OTG are released as candidate engineering release with known functional limitation. Other drivers are delivered as their final CUT2 release. This release will only be modified to fix possible notified bugs.

1.2. NOTES

The license of all the source code within this release is GPLv2.


7

1.3. NEW FUNCTIONALITIES See specific driver section.

1.4. RESOLVED BUGS Here the list of solved bug reported on Soft-In bug tracking system:

B0218 ETH link detected without cable (hw dependent) B0204 Bug sta662_sdec_spi driver B0200 Kernel doesn't boot without CONFIG_STA2X11_NORTHVILLE=y on icar (b1) B0197 release-20111201 branch issues B0196 Can not build kernel without PL011 serial driver B0195 USB errors since commit 75345fc08d2bfd96eeda39b4c6d4fae4fa69918c B0188 [Audio] Playing a 16-bit LE PCM wav file isn't handled correctly B0169 eMMC on ICM4 (4Gb) Sandisk accessing issue B0141 ETH; Ethernet connection falls down during transferring files B0140 USB : Loading usb modules after boot won't let any usb device work afterwards B0139 Platform : sta2x11version mismatch B0137 Audio; different behavior with Meego or Debian distribution B0136 Audio : Audio streaming from linein to lineout stops working after a few seconds. B0131 pl011-pci (uart) oopses when dma is enabled on rx and tx B0125 Ethernet: Jumbo frames cause "Out of SW-IOMMU space" error B0124 Accessing a non-existent GPIO pin will cause a kernel crash B0123 Test failed: Serial port - Baudrate, data bits, parity B0122 Crash with dmatest.ko module. B0121 missing build dependency on pci_slave B0119 mmci-pci error messages B0118 "STA2x11 board: northville" massage with quiet cmdline option B0116 Kernel doesn't build without debugfs B0115 Random behaviour accessing MMC on CUT2B1 (hw dependent) B0114 Kernel Build Dependency on CONFIG_PM B0105 Kernel Build Failure when disabling DMA for MMC #2 B0099 Kernel Build Failure when disabling DMA for MMC B0098 Fix BUG in CUT2 B1-Stepping B0095 Low Can’t set Ethernet speed to 100mbit full/half or 10mbit half-duplex B0094 Booting the board with two USB devices already plugged in won’t load one device B0092 Modifying e-MMC partition table reboots the board B0091 Removing SD card during a transfer won’t allow to mount the device again B0090 Unplugging S-ATA cdrom doesn’t unload /dev/sr0 node


8

B0087 stmmac: kernel function invoked from invalid context

You can find more information on bug tracking system available at https://redmine.soft-in.com/

1.5. KNOWN BUGS

B0259 ETH: Ethernet connection falls down during transferring files There are also some known issues that are platform dependent (see 1.5.1) and other issues related to upstream kernel (see 1.5.2).

You can find more information on bug tracking system available at https://redmine.soft-in.com/

1.5.1. HW DEPENDENT BUGS Here the list of open bugs:

B0115 Random behavior accessing MMC on CUT2B1 (this bug is closed as HW issue specific to the Micron component used on Abbeville builds prior to Build 4)

B0218 ETH link detected without cable (this issue existed with the cut 1 driver as well, but didn't occur on Northville, only on Crossville's. It seems to be Crossville PHY specific)

1.5.2. UPSTREAM BUG Here the list of upstream bugs:

B0093 Removing USB flash drive during a file transfer might crash the kernel B0097 Problem with usb: scsi: killing requests for dead queue B0117 4 seconds boot slowdown B0166 SATA: kernel oops after surprise removal

1.6. Reference test setup


9

The kernel has been verified with the Meego 1.2 image meego-ivi-ia32-conx-1.2.0-WRSI-05.27-1.iso replacing the kernel and modules with the binaries compiled with the current release. The kernel command line included the following options: rw root=/dev/sda3 vga=current 3

1.7. Acronyms

PCI Peripheral Component Interconnect

PCIe Peripheral Component Interconnect express

DID PCI Device ID This is the 2 bytes code that identifies a PCI device. Reference available into the site www.pcidatabase.com

2. Format of deliverables

The device drivers are released as Linux patches based on the 2.6.39.4 kernel version. An additional tar file with all changed source files is added in order to facilitate the access to users without a Linux expertise:

The sta2x11_RC4_20120309_2.6.39.4_patches.tgz file contain a snapshot of all the latest STA2X11-CUT2 patches to be applied to Linux kernel version 2.6.39.4.

The sta2x11_RC4_20120309_2.6.39.4_src.tgz file contain all changed files with respect to original Linux kernel version 2.6.39.4.

3. Installation

Let’s have the full kernel 2.6.39.4 into the folder work/linux-2.6.

Extract all the patches from the file sta2x11_xxxxxxxxx_patches.tgz into the folder work/patches

Using the following script you can easily apply them on the top of a clean 2.6.39.4 kernel. Copy it inside kernel source folder

#!/bin/sh for file in `ls $1` do patch -p1 < $1/$file


10

done

Execute the script: cd work/ linux-2.6

./patchKernel.sh ../patches

Configure the kernel with the following command:

make sta2x11_defconfig

Compile and install the kernel as usual.

4. Components detailed description

This release note covers the release of the following set of PCI drivers:

Platform MFD PCIEAMBA UART USB HOST SATA ETHERNET DMA I2C VIP USB OTG SPI CAN MLB MSP SOUND SD/MMC FM RADIO

4.1. Platform

The files modified in this release are: arch/x86/platform/Makefile


11

arch/x86/platform/sta2x11/Makefile arch/x86/platform/sta2x11/boards.lds arch/x86/platform/sta2x11/clk.c arch/x86/platform/sta2x11/clk.h arch/x86/platform/sta2x11/clock.c arch/x86/platform/sta2x11/clock.h arch/x86/platform/sta2x11/icar.c arch/x86/platform/sta2x11/northville.c arch/x86/platform/sta2x11/sta2x11.c arch/x86/platform/sta2x11/sta2x11.h arch/x86/platform/sta2x11/steval.c include/linux/pci_ids.h kernel/irq/chip.c kernel/irq/irqdesc.c

4.1.1. Licence

These files are released under the GPL v2 terms.

4.1.2. Hardware supported platform This component release has been tested on the following hardware platforms:

Intel® IVI Reference Design for Tunnel Creek - Crossville TC B1 / ST CUT2 iCAR B sample Soft-In board – ICM4 CPU with TC / ST CUT2

4.1.3. Supported functionalities Automatic hw rev detection. Unified board file for northville cut1 & cut2. Unified board file for steval cut1 & cut2. Pci device table automatically selected based on hw rev. Platform data tables automatically selected based on hw rev. Avoid compiling useless config tables (if a driver is not included in the kernel

config file, the relevant config table is not compiled anymore).

4.1.4. Missing functionalities None

4.1.5. Know issues and limitations None

4.2. MFD


12

The files modified in this release are:

drivers/mfd/Kconfig drivers/mfd/Makefile drivers/mfd/ sta2x11-mfd.c drivers/mfd/sta2x11/Makefile include/linux/mfd/sta2x11-mfd.h

4.2.1. Licence These files are released under the GPL v2 terms

4.2.2. Hardware supported platform

This component release has been tested on the following hardware platforms: Intel® IVI Reference Design for Tunnel Creek - Crossville TC B1 / ST CUT2 iCAR B sample Soft-In board – ICM4 CPU with TC / ST CUT2

4.2.3. New supported functionalities Check SCTL registers (modifications needed for sd/mmc driver) Added function for atomically writing a bitmask to SCTL (needed by sd/mmc)

4.2.4. Missing functionalities Power management


4.3. PCIEAMBA


lib/swiotlb.c



This component release has been tested on the following hardware platforms: Intel® IVI Reference Design for Tunnel Creek - Crossville TC B1 / ST CUT2


13

iCAR B sample Soft-In board – ICM4 CPU with TC / ST CUT2

4.3.3. New supported functionalities Check SCTL registers (modifications needed for sd/mmc driver) Added function for atomically writing a bitmask to SCTL (needed by sd/mmc)



4.4. UART


drivers/tty/serial/Kconfig drivers/tty/serial/Makefile drivers/tty/serial/pl011-pci-debugfs.c drivers/tty/serial/pl011-pci.c drivers/tty/serial/pl011-pci.h include/asm-generic/ioctls.h




4.4.3. New supported functionalities Platform code update


4.4.5. Know issues and limitations


14

None

4.5. USB Host


drivers/usb/Kconfig drivers/usb/Makefile drivers/usb/host/ehci-mem.c drivers/usb/host/ehci-pci.c drivers/usb/host/ehci-q.c drivers/usb/host/ohci-pci.c




4.5.3. New supported functionalities Update class code


4.5.5. Know issues and limitations B0093 Removing a USB key during a file transfer can trigger a kernel panic

(upstream bug) o Workaround: don’t remove USB devices during data transfer

B0097 Problem with usb: scsi: killing requests for dead queue (upstream bug)

4.6. SATA


drivers/ata/ahci.c drivers/ata/libahci.c


15




4.6.3. New supported functionalities Update class code Update platform code for CUT2 silicon


4.6.5. Know issues and limitations B0166 SATA: kernel oops after surprise removal (upstream bug)

4.7. ETHERNET


drivers/net/stmmac/stmmac_main.c drivers/net/stmmac/stmmac_ethtool.c include/linux/stmmac.h




4.7.3. New supported functionalities Sta2x11 patches ported to stmmac 2.6.39 manline driver


16

MAC address can now be passed as platform data, module parameter or using kernel command line.


4.7.5. Know issues and limitations B0259 ETH: Ethernet connection falls down during transferring files

4.8. DMA


drivers/dma/Kconfig drivers/dma/Makefile drivers/dma/amba-pl08x.c drivers/dma/amba-pl08x.h drivers/dma/sta2x11_pl080.c include/linux/amba/pl080.h include/linux/amba/pl08x.h




4.8.3. New supported functionalities Modifications for porting to 2.6.39.4 Added support for peripheral flow control




17

4.9. I2C


drivers/i2c/busses/Kconfig drivers/i2c/busses/Makefile drivers/i2c/busses/i2c-sta2x11-pci-debugfs.c drivers/i2c/busses/i2c-sta2x11-pci-test-slave.c drivers/i2c/busses/i2c-sta2x11-pci.c drivers/i2c/busses/i2c-sta2x11-pci.h




4.9.3. New supported functionalities

4.9.4. Missing functionalities

Slave and multi-master not supported


4.10. VIP


drivers/media/video/Kconfig drivers/media/video/Makefile drivers/media/video/adv7180.c drivers/media/video/sta2x11/Kconfig drivers/media/video/sta2x11/Makefile drivers/media/video/sta2x11/sta2x11_vip.h


18

drivers/media/video/sta2x11/sta2x11_vip_main.c drivers/media/video/videobuf-dma-contig.c include/media/videobuf-dma-contig.h






Power management Programming of GAM_DVP_CTRL register


4.11. USB OTG

The file modified in this release are:

drivers/usb/gadget/Kconfig drivers/usb/sta2x11_otg/Kconfig drivers/usb/sta2x11_otg/Makefile drivers/usb/sta2x11_otg/sta2x11_hcd-dbg.h drivers/usb/sta2x11_otg/sta2x11_hcd-hub.c drivers/usb/sta2x11_otg/sta2x11_hcd.c drivers/usb/sta2x11_otg/sta2x11_hcd.h drivers/usb/sta2x11_otg/sta2x11_main.c drivers/usb/sta2x11_otg/sta2x11_otg.h drivers/usb/sta2x11_otg/sta2x11_udc.c drivers/usb/sta2x11_otg/sta2x11_udc.h

4.11.1. Licence


19

These files are released under the GPL v2 terms


4.11.3. New supported functionalities Update class code


4.11.5. Know issues and limitations Not tested

4.12. SPI


drivers/spi/Kconfig drivers/spi/Makefile drivers/spi/dummyspichip.c drivers/spi/pci-pl022.c drivers/spi/pci-pl022.h drivers/spi/sta662_sdec_spi.c drivers/spi/steval.c





Synchronous userspace interface to devices that communicate via SDEC protocol over SPI interface


20



4.13. CAN


drivers/net/can/Kconfig drivers/net/can/Makefile drivers/net/can/sta2x11_can.c drivers/net/can/sta2x11_can.h





Power management


4.14. MLB


drivers/net/most/Kconfig drivers/net/most/Makefile drivers/net/most/sta2x11mlb.c include/net/most/async.h include/net/most/ctl.h


21

include/net/most/dev.h include/net/most/most.h include/net/most/most_core.h include/net/most/sync.h net/Kconfig net/Makefile net/most/Kconfig net/most/Makefile net/most/af_most.c net/most/async_sock.c net/most/ctl_sock.c net/most/dev_sock.c net/most/most_core.c net/most/most_sock.c net/most/sync_sock.c



4.14.3. Supported functionalities


Power management


4.15. MSP


drivers/misc/Kconfig drivers/misc/Makefile drivers/misc/sta2x11_msp/Kconfig drivers/misc/sta2x11_msp/Makefile drivers/misc/sta2x11_msp/sta2x11_msp_core.c


22

drivers/misc/sta2x11_msp/sta2x11_msp_core.h drivers/misc/sta2x11_msp/sta2x11_msp_debugfs.c drivers/misc/sta2x11_msp/sta2x11_msp_debugfs.h drivers/misc/sta2x11_msp/sta2x11_msp_pci.c drivers/misc/sta2x11_msp/sta2x11_msp_regs.h drivers/misc/sta2x11_msp/sta2x11_msp_test.c






Power Management


4.16. SOUND


include/sound/ak4xxx-adda.h sound/drivers/Kconfig sound/drivers/Makefile sound/drivers/sta2x11_ak4628.c sound/drivers/sta2x11i2s.c sound/i2c/other/Makefile sound/i2c/other/ak4xxx-adda.c sound/soc/Kconfig sound/soc/Makefile sound/soc/codecs/Kconfig sound/soc/codecs/Makefile


23

sound/soc/codecs/ak4628.c sound/soc/codecs/generic-i2s.c sound/soc/sta2x11/Kconfig sound/soc/sta2x11/Makefile sound/soc/sta2x11/sta2x11-dma.c sound/soc/sta2x11/sta2x11-dma.h sound/soc/sta2x11/sta2x11-i2s.c sound/soc/sta2x11/sta2x11-i2s.h sound/soc/sta2x11/sta2x11-machine.c sound/soc/sta2x11/sta2x11-msp-debugfs.c sound/soc/sta2x11/sta2x11-msp-debugfs.h sound/soc/sta2x11/sta2x11-msp-pci.c sound/soc/sta2x11/sta2x11-msp-regs.h sound/soc/sta2x11/sta2x11-msp.h





Completely redesigned in compliance with ALSA-SoC architecture. Now audio framework is modular and include three separate structures:

o Codecs: all ALSA-SoC compliant codes are supported, and: AK4628 has been added for Crossville board Generic-i2s codec has been added for I2S device with no (or

non ALSA) command interface (STA662 for ICAR boards) o Digital Audio Interfaces o Machine (platform)




24

4.17. SD/MMC


drivers/mmc/host/Kconfig drivers/mmc/host/Makefile drivers/mmc/host/mmci-pci.c drivers/mmc/host/mmci-pci.h





None



4.18. FM RADIO


drivers/media/radio/Kconfig drivers/media/radio/Makefile drivers/media/radio/tda7706_core.c drivers/media/radio/tda7706_i2c.c drivers/media/radio/tda7706_i2c.h



25



None



sta2x11linux drivers rel 20120309

Documents