STA2X11Linux Drivers Rel 20120309

Release Note Rel_RC4_20120309
STA2X11-CUT2 Linux Drivers

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.2.
4.2.3.
New supported functionalities ................................................................................ 12
4.2.4.
4.2.5.
4.3.
PCIEAMBA ....................................................................................................................... 12
4.3.1.
Licence ..................................................................................................................... 12
4.3.2.
4.3.3.
4.3.4.
4.3.5.
4.4.
UART ............................................................................................................................... 13
2

4.4.1.
Licence ..................................................................................................................... 13
4.4.2.
4.4.3.
4.4.4.
4.4.5.
4.5.
USB Host.......................................................................................................................... 14
4.5.1.
Licence ..................................................................................................................... 14
4.5.2.
4.5.3.
4.5.4.
4.5.5.
4.6.
SATA ................................................................................................................................ 14
4.6.1.
Licence ..................................................................................................................... 15
4.6.2.
4.6.3.
4.6.4.
4.6.5.
4.7.
ETHERNET ........................................................................................................................ 15
4.7.1.
Licence ..................................................................................................................... 15
4.7.2.
4.7.3.
4.7.4.
4.7.5.
4.8.
DMA ................................................................................................................................ 16
4.8.1.
Licence ..................................................................................................................... 16
4.8.2.
4.8.3.
4.8.4.
4.8.5.
4.9.
I2C ................................................................................................................................... 17
4.9.1.
Licence ..................................................................................................................... 17
4.9.2.

3

4.9.3.
4.9.4.
4.9.5.
4.10.
VIP ............................................................................................................................... 17
4.10.1.
Licence ..................................................................................................................... 18
4.10.2.
4.10.3.
4.10.4.
4.10.5.
4.11.
USB OTG ...................................................................................................................... 18
4.11.1.
Licence ..................................................................................................................... 18
4.11.2.
4.11.3.
4.11.4.
4.11.5.
4.12.
SPI................................................................................................................................ 19
4.12.1.
Licence ..................................................................................................................... 19
4.12.2.
4.12.3.
4.12.4.
4.12.5.
4.13.
CAN.............................................................................................................................. 20
4.13.1.
Licence ..................................................................................................................... 20
4.13.2.
4.13.3.
4.13.4.
4.13.5.
4.14.
MLB ............................................................................................................................. 20
4.14.1.
Licence ..................................................................................................................... 21
4.14.2.
4.14.3.
Supported functionalities ........................................................................................ 21
4.14.4.

4

4.14.5.
4.15.

MSP ............................................................................................................................. 21
4.15.1.
Licence ..................................................................................................................... 22
4.15.2.
4.15.3.
4.15.4.
4.15.5.
4.16.
SOUND......................................................................................................................... 22
4.16.1.
Licence ..................................................................................................................... 23
4.16.2.
4.16.3.
4.16.4.
4.16.5.
4.17.
SD/MMC ...................................................................................................................... 24
4.17.1.
Licence ..................................................................................................................... 24
4.17.2.
4.17.3.
4.17.4.
4.17.5.
4.18.
FM RADIO .................................................................................................................... 24
4.18.1.
Licence ..................................................................................................................... 24
4.18.2.
4.18.3.
4.18.4.
4.18.5.
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.
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 Cant set Ethernet speed to 100mbit full/half or 10mbit half-duplex
B0094 Booting the board with two USB devices already plugged in wont load one device
B0092 Modifying e-MMC partition table reboots the board
B0091 Removing SD card during a transfer wont allow to mount the device again
B0090 Unplugging S-ATA cdrom doesnt unload /dev/sr0 node
7

B0087 stmmac: kernel function invoked from invalid context
You can find more information on bug tracking system available at https://redmine.softin.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.softin.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

8
The kernel has been verified with the Meego 1.2 image meego-ivi-ia32-conx-1.2.0-WRSI05.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
Lets 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
9

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
10

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
11

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.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)

Power management

None
4.3.
PCIEAMBA

lib/swiotlb.c
4.3.1. Licence

12


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

None

None
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.1. Licence


Platform code update

Power management

13

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.1. Licence


Update class code

Power management

B0093 Removing a USB key during a file transfer can trigger a kernel panic
(upstream bug)
o Workaround: dont 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
14
4.6.1. Licence


Update class code
Update platform code for CUT2 silicon

None

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.1. Licence


Sta2x11 patches ported to stmmac 2.6.39 manline driver
15

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

Power management

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.1. Licence


Modifications for porting to 2.6.39.4
Added support for peripheral flow control

None

None
16
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.1. Licence


Slave and multi-master not supported

None
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
17

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


Power management
Programming of GAM_DVP_CTRL register

None
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
18


Update class code

None

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
4.12.1. Licence


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

Power management

None
4.13.
CAN

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

Power management

Not tested
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
20

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.1. Licence

4.14.3. Supported functionalities
Power management

Not tested
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
21

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
4.15.1. Licence


Power Management

None
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
22

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
4.16.1. Licence


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)

None

None
23
4.17.
SD/MMC

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


None

None

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
4.18.1. Licence
24

None

None

Not tested
25

STA2X11Linux Drivers Rel 20120309

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

STA2X11Linux Drivers Rel 20120309

Transféré par

Droits d'auteur :

Formats disponibles

Release Note Rel_RC4_20120309

STA2X11-CUT2 Linux Drivers

Release Note Rel_RC4_20120309

Release Note Rel_RC4_20120309

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

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

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

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

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

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

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

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

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

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

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

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

Hardware supported platform ................................................................................. 12

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

Missing functionalities ............................................................................................. 12

Know issues and limitations..................................................................................... 12

Hardware supported platform ................................................................................. 12

New supported functionalities ................................................................................ 13

Missing functionalities ............................................................................................. 13

Know issues and limitations..................................................................................... 13

Release Note Rel_RC4_20120309

Hardware supported platform ................................................................................. 13

New supported functionalities ................................................................................ 13

Missing functionalities ............................................................................................. 13

Know issues and limitations..................................................................................... 13

Hardware supported platform ................................................................................. 14

New supported functionalities ................................................................................ 14

Missing functionalities ............................................................................................. 14

Know issues and limitations..................................................................................... 14

Hardware supported platform ................................................................................. 15

New supported functionalities ................................................................................ 15

Missing functionalities ............................................................................................. 15

Know issues and limitations..................................................................................... 15

Hardware supported platform ................................................................................. 15

New supported functionalities ................................................................................ 15

Missing functionalities ............................................................................................. 16

Know issues and limitations..................................................................................... 16

Hardware supported platform ................................................................................. 16

New supported functionalities ................................................................................ 16

Missing functionalities ............................................................................................. 16

Know issues and limitations..................................................................................... 16

Hardware supported platform ................................................................................. 17

Release Note Rel_RC4_20120309

New supported functionalities ................................................................................ 17

Missing functionalities ............................................................................................. 17

Know issues and limitations..................................................................................... 17

Hardware supported platform ................................................................................. 18

New supported functionalities ................................................................................ 18

Missing functionalities ............................................................................................. 18

Know issues and limitations..................................................................................... 18

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

Hardware supported platform ................................................................................. 19

New supported functionalities ................................................................................ 19

Missing functionalities ............................................................................................. 19

Know issues and limitations..................................................................................... 19

Hardware supported platform ................................................................................. 19

New supported functionalities ................................................................................ 19

Missing functionalities ............................................................................................. 20

Know issues and limitations..................................................................................... 20

Hardware supported platform ................................................................................. 20