AM35x-OMAP35x-PSP 03.00.00.03 DataSheet

Content is no longer maintained and is being kept for reference only!

Document License

This work is licensed under the Creative Commons Attribution-Share Alike 3.0 United States License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/us/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.

Read This First

Content is no longer maintained and is being kept for reference only!

About This Manual

This document provides an overview and performance data for each of the device drivers which are part of the OMAP Linux PSP package supporting AM3517 and OMAP3530 Socs. Note that only a subset of these platforms may have actually been tested and verified in the package you are using. Please refer to the release notes provided with the package for information on which platforms have actually been verified.

If You Need Assistance

For further information or to report any problems, contact http://community.ti.com/ or http://support.ti.com/

Trademarks

OMAP^TM is trademark of Texas Instruments Incorporated. All other trademarks are the property of the respective owner.

OMAP PSP Linux Drivers

This section provides brief overview of the device drivers supported in the Linux PSP release based on Linux OMAP git tree at http://git.kernel.org/?p=linux/kernel/git/tmlind/linux-omap-2.6.git

Note: The constraints may vary across product releases. Please refer to the Release Notes accompanying the release for an updated list of constraints.

OMAP Linux PSP details

1. Supports for OMAP3EVM (Rev.G) and AM3517EVM
2. Built with Linux kernel version 2.6.32-rc5/PM.
3. Compiled with code sourcery tool chain version arm-2009-q1-203.
4. Supports U-Boot version 2009.08
5. Supports boot from MMC and NAND flash.
6. Ships with sample root file system, ramdisk, pre-built u-boot, uImage binaries, sample applications and documentation.

Boot modes supported

Green colored box in the table below means that the particular boot mode is supported on the device.

Note: These are supported boot modes in PSP software, the actual hardware may support many more boot modes than shown here. Please refer to hardware documentation for list of all supported boot modes.

OMAP SDK Supported Boot Modes

Boot Mode	OMAP3EVM	AM3517EVM
NAND Flash	Yes	Yes
NOR Flash	No	No
MMC/SD	Yes	Yes

Device driver list

Device Driver List

Peripheral	Description	Linux driver type
Video Display	Video Display driver supporting LCD, DVI and TV out	V4L2 and Frame-buffer display driver
Ethernet	Transmit/receive network data. Supports Auto negotiation with 10/100 Mbps link speed	Netdev
Audio (McBSP)	Audio record and playback	ALSA SoC
MUSB Host	Supports MSC, HID and USB Audio/Video classes	USB HCD
MUSB Gadget	Supports File-storage and CDC/RNDIS	USB Gadget
MUSB OTG	Supports HNP/SRP	USB HCD
EHCI Host	MSC, HID(via a HS hub) and USB Audio/Video	USB HCD
NAND Flash	Flash storage system	MTD Character and Block
MMC/SD	Interface to MultiMedia Secure Digital cards	Block
Touch Screen	Enables the LCD to be used for touchscreen input	Input(event) driver
UART	Serial Communication Interface	Character
I2C	Inter-IC Communication	Character
SPI	Serial Peripheral Interface	Character
AM3517: CAN (HECC)	Transmit/receive data over CAN (HECC) peripheral using socketCAN interface	Netdev
AM3517: RTC (S35390A)	Real Time Clock over I2C1	RTC Framework
AM3517: Capture	Capture driver supporting BT656 mode	V4L2 Sub-Device framework based
OMAP35x: Video Capture	Capture driver supporting BT656 mode	V4L2-Int framework based
OMAP35x: Video Resizer	Character based Resizer Driver using V4L2-Buf layer for buffer management	Character driver using V4L2-Buf layer
OMAP35x: Keypad	Keypad driver for OMAP3EVM keypad	Input(event) driver
OMAP35x: Power Management	CPUIdle and dynamic tick	CPUIdle, dyntick

Drivers not supported

1. Keypad on AM3517EVM
2. Power Management (cpufreq, cpuidle) on AM35x
3. WDT

Driver DMA usage

OMAP35x/AM3517 peripheral driver DMA usage

Driver	DMA usage
Audio (McBSP)	sDMA
Ethernet	Internal DMA(AM3517 only)
MUSB OTG	Internal DMA
USB EHCI	Internal DMA
NAND Flash	None
NOR Flash	None
DSS (V4L2/Fbdev Display)	Internal DMA
OMAP35x: ISP-Resizer	Internal DMA
AM3517: VPFE Capture	Internal DMA
OMAP35x: ISP-Camera	Internal DMA
SPI	sDMA
MMC/SD	sDMA
UART	None
I2C	None
AM3517: CAN (HECC)	None

ALSA SoC Audio Driver

This section provides details on ALSA SoC audio driver along with throughput and CPU load numbers.

Introduction

OMAP35x / AM3517 audio driver complies to the ALSA SoC framework. ASoC framework provides better audio support for embedded SoC processors and portable audio codecs.

ASoC framework splits an embedded audio system into three components:

• Codec driver: The codec driver is generic and hardware independent code that configures the audio codec to provide audio capture and playback. It should contain no code that is specific to the target platform or machine.
• Platform driver: The platform driver can be divided into audio DMA and SoC Digital Audio Interface (DAI) configuration and control. The platform driver only targets the SoC CPU and must have no board specific code.
• Machine driver: The ASoC machine (or board) driver is the code that glues together the platform and codec drivers. It can contain codec and platform specific code. It registers the audio subsystem with the kernel as a platform device.

Following architecture diagram shows all the components and the interactions among them:

Driver Features

The driver supports the following features:

1. Supports AIC23 audio codec (on AM3517 only) and TPS65950 audio codec (on OMAP35x only) in ALSA SoC framework.
2. Multiple sample rates support (8KHz, 16KHz, 22.05KHz, 32KHz, 44.1KHz, 48KHz, 64KHz, 88.2KHz and 96KHz - AM3517; 8 KHz, 11.025 KHz, 12 KHz, 16 KHz, 22.05 KHz, 24 KHz, 32 KHz, 44.1 KHz and 48 KHz - OMAP35x) for both capture and playback.
3. Supports audio in stereo mode.
4. Supports simultaneous playback and record (full-duplex mode).
5. Start, stop, pause and resume feature.
6. Supports mixer interface for audio codecs.
7. Supports MMAP mode for both playback and capture.

Features Not Supported

1. OSS based applications, which use ALSA-OSS emulation layer, are not supported.
2. Formats such as TDM, Left and Right Justified are currently not supported.
3. Synthesizer and midi interfaces are not supported.

Constraints

1. By default, codec is configured in master mode and McBSP is used as slave. Testing of the audio sub-system is done in this configuration only.
2. Sampling frequencies for playback and capture streams should be same.
3. The audio driver does not allow opening the same stream (playback/capture) multiple times.

Supported System Calls

Refer ALSA project - the C library reference [1] for API calls.

Supported IOCTLs

NA

Performance and Benchmarks

The performance numbers were captured using the following:

• Word length in bits = 16
• Number of channels per sample = 2
• Power Management = Disabled

The performance numbers are same for both AM3517 and OMAP35x. Commands used to capture the same are:

• aplay -c 2 -f S16_LE -r <<sample rate>> <<file_name>> :- Normal mode
• arecord -c 2 -f S16_LE -r <<sample rate>> <<file_name>> :- Normal mode
• aplay -c 2 -f S16_LE -r <<sample rate>> -M <<file_name>> :- MMAP mode
• arecord -c 2 -f S16_LE -r <<sample rate>> -M <<file_name>> :- MMAP mode

Audio Write Performance

Sampling Rate (in Hz)	CPU Load (in %)	CPU Load (in %)
	Normal Mode	MMAP Mode
8000	0	0
32000	0	0
44100	2	2
48000	2	2

Audio Read Performance

Sampling Rate (in Hz)	CPU Load (in %)	CPU Load (in %)
	Normal Mode	MMAP Mode
8000	0	0
32000	0	0
44100	2	2
48000	2	2

Ethernet Driver

This section provides details on Ethernet driver along with throughput and CPU load numbers.

Introduction

The Ethernet driver supports the Linux netdev interface.

Driver Features

The driver supports the following features:

1. 10/100 Mbps mode of operation.
2. Auto negotiation.
3. Support for multicast and broadcast frames.
4. Promiscuous mode of operation.
5. Full duplex and half duplex mode of operation.
6. Linux NAPI support

Features Not Supported

NA

Constraints

NA

Supported System Calls

Supports the socket() and related system calls in accordance with Linux architecture.

Performance and Benchmarks

OMAP35x

Ethernet 100Mbps Mode Performance

TCP Window Size (in KBytes)	Transfer size (in MBytes)	Bandwidth (in Mbits/sec)	Interval (in Seconds)
16	335	46.9	60
32	337	47	60
64	337	46.9	60
128	336	46.9	60

The performance numbers were captured using the iperf tool. Usage details are mentioned below:

• Server side command switch : "-s"
• Client side command : "-c <server ip> -w <window size> -d -t60"
• Iperf tool is run on the DUT1 in server mode and on DUT2 in client mode. Version 1.7.0 is used on both sides.
• Data captured here is for "iperf" in client mode.
• Cross cable is used to measure performance.
• Speed is set to 100Mbps
• Power Management disabled for measurement

AM3517

Ethernet 100Mbps Mode Performance

TCP Window Size (in KBytes)	Transfer size (in MBytes)	Bandwidth (in Mbits/sec)	Interval (in Seconds)
16	63.8	8.91	60
32	136	19.05	60
64	261	36.4	60
128	470	65.5	60

The performance numbers were captured using the iperf tool. Usage details are mentioned below:

• Server side command switch : "-s"
• Client side command : "-c <server ip> -w <window size> -d -t60"
• Iperf tool is run on the DUT1 in server mode and on DUT2 in client mode. Version 1.7.0 is used on both sides.
• Data captured here is for "iperf" in client mode.
• Cross cable is used to measure performance.
• Speed is set to 100Mbps
• Power Management disabled for measurement

Video Display Driver

This section describes the Video Display driver architecture, driver features and performance numbers (throughput and CPU load).

Introduction

Video Display driver is based on two different frameworks, V4L2 and FBDEV.

Driver Features

1. Supports interfaces LCD, DVI and TV out
2. Supports TV display interface at NTSC and PAL resolutions
3. Supports YUV, UYVU, RGB565, RGB24P and RGB24 unpacked on video planes, in addition ARGB on video2 plane.
4. Supports RGB565, ARGB, RGBA, RGB24 packed and unpacked on graphics plane
5. Video planes controlled through V4L2 user interface whereas Graphic plane controlled through FBDEV user interface
6. Supports setting up of OSD window destinations (TV or LCD) through sysfs
7. Supports mmapped (driver allocated) and user buffer exchange mechanism in V4L2 driver and only mmapped (driver allocated) buffers in FBDEV driver
8. Supports rotation - 0, 90, 180 and 270 degrees
9. Supports scaling from 1/4x to 8x on video pipelines
10. Supports Wait for Vsync and Panning feature under FBDEV
11. Supports Alpha blending, both global alpha and pixel alpha
12. Supports Source and Destination color keying through V4L2 ioctls
13. Supports Modular build

Driver Features - OMAP35x

1. Supports LCD display interface at VGA resolution (480*640)

Driver Features - AM3517

1. Supports LCD display interface at resolution (480*272)

Features Not Supported

1. RGB888 rotation is not supported
2. RFBI interface is not supported
3. DSI/SDI serial interface is not supported
4. Dynamic Changing of modes (NTSC/PAL) for TV out not supported
5. Linking feature not supported on video pipelines
6. Brightness class driver is not supported
7. Mirroring is not supported

Constraints

1. Incorrect configuration of parameters results in Sync Lost
2. Minimum 3 Buffers are required for streaming in V4L2
3. PAL resolution can be set maximum to 720 x 574 instead of 720 x 576 because of hardware limitation
4. Upscaling and downscaling with images more that 720x574 resolution is not supported because of dss functional clock frequency limitation

Supported System Calls

open(), close(), read(), mmap(), munmap() and ioctl()

Performance Benchmarks

Setup Details -

• TV - Sony LCD TV (NTSC/PAL)
• DVI Monitor - Dell Monitor (720P/480P) without rotation
• File System - NFS
• CPU Idle - Disabled
• Tool Used for measurement - LFTB

Performance Benchmarks - OMAP35x

Video Display Driver Performance

Output Interface	Driver Framework	Resolution	Frame Rate (FPS)	CPU Load (%)
LCD	Fbdev	VGA (640x480)	59.3261498	0.794
TV	Fbdev	NTSC(720x480)	30.2401256	0.336
TV	Fbdev	PAL(720x574)	25.1419276	0.13
DVI	Fbdev	720P(1280x720)	60.2947784	0.742
DVI	Fbdev	480P(720x480)	59.1978132	0.096
LCD	V4L2	VGA(640x480)	58.5048148	0.704
TV	V4L2	NTSC(720x480)	30.2401256	0.336
TV	V4L2	PAL(720x574)	25.0260724	0.184
DVI	V4L2	720P(1280x720)	59.9794268	0.192
DVI	V4L2	480P(720x480)	58.6827484	0.212

Performance Benchmarks - AM3517

Video Display Driver Performance

Output Interface	Driver Framework	Resolution	Frame Rate (FPS)	CPU Load (%)
LCD	Fbdev	480x272	60.2347654	0.072
TV	Fbdev	NTSC(720x480)	30.3342076	0.036
TV	Fbdev	PAL(720x574)	25.1728302	0.02
DVI	Fbdev	720P(1280x720)	60.9794298	0.24
DVI	Fbdev	480P(720x480)	58.8871216	0.118
LCD	V4L2	480x272	59.3569404	0.048
TV	V4L2	NTSC(720x480)	30.0003102	0.012
TV	V4L2	PAL(720x574)	25.024904	0.014
DVI	V4L2	720P(1280x720)	59.965728	0.024
DVI	V4L2	480P(720x480)	58.6671648	0.036

Video Capture Driver

This section describes the Video Capture driver architecture, driver features and performance numbers (throughput and CPU load).

Introduction

Current V4L2 sub-system is supporting 3 different frameworks, V4L2-Int, SoC-Cam and Sub-Dev. Out of these, 2 has already become legacy framework and all future driver must use Sub-Dev frameowrk.

Although from user application point of view the interface will remain the same, driver follows standard V4L2 interface.

OMAP35x

OMAP35x Video Capture driver is based on V4L2-Int framework.

AM3517

AM3517 Video Capture driver is based on V4L2 Sub_device framework.

Driver Features

1. Supports one software channel and a corresponding device node (/dev/video0) for capture module
2. Supports mmapped (driver allocated) and user buffer exchange mechanism
3. Supports dynamic switching among input interfaces with some necessary restrictions wherever applicable
4. Supports NTSC and PAL standard on Composite and S-Video interfaces
5. Supports 8-bit BT.656 capture in UYVY and YUYV interleaved formats
6. Supports standard V4L2 IOCTLs to get/set various control parameters like brightness, contrast and saturation
7. Supports Modular build

Driver Features - OMAP35x

1. Supports both Multi-Media Daughter Card and on-board Video Decoder (NOTE:Both are mutual exclusive to each other)

Features Not Supported

1. Cropping and scaling operations and their corresponding V4L2 IOCTLs
2. Raw capture (capture through sensor interface)

Features Not Supported - OMAP35x

1. On-the-fly previewer interface is not supported
2. All internal processing block, H3A, Histogram, black level compensation, etc.. are not supported
3. CSI serial interface is not supported
4. On-the-fly resizing operation

Constraints

1. Dynamic switching of resolution and dynamic switching of interfaces is not supported when streaming is on
2. Driver buffer addresses and pitch must be aligned to 32 byte boundary

Constraints - OMAP35x

1. In case of USERPTR with VM_IO, the buffer size must be 4096 byte aligned

Constraints - AM3517

1. Greenish color is seen due to Hardware know issue

Supported System Calls

open(), close(), mmap(), munmap() and ioctl()

Performance Benchmarks

Setup Details -

• DVD Player - Sony (DVP-NS51P)
• TV - Sony LCD TV (NTSC/PAL)
• File System - NFS
• CPU Idle - Disabled
• Tool Used for measurement - saUserPtrLoopback.c

Performance Benchmarks - OMAP35x

Video Display Driver Performance

Resolution	Frame Rate (FPS)	CPU Load (%)
NTSC(720x480)	30	2
PAL(720x574)	25	3

Performance Benchmarks - AM3517

Video Display Driver Performance

Resolution	Frame Rate (FPS)	CPU Load (%)
NTSC(720x480)	30	3
PAL(720x574)	25	3

Video Resizer Driver (Only for OMAP35x)

This section describes the Video Resizer driver architecture, driver features and performance numbers (throughput and CPU load).

Introduction

OMAP35x Video Resizer driver is simple character driver using V4L2-buffer layer for buffer management.

Driver Features

1. Resizes input frame stored in RAM and stores output frame in RAM
2. Supports resizing from 1/4x to 4x
3. Supports independent horizontal & vertical resizing
4. Supports YUV422 packed and color separate data
5. Supports driver allocated and user provided buffers including IOMEM
6. Supports Modular build

Features Not Supported

1. On-the-fly mode of operation

Constraints

1. All input,ouput addresses and pitch must be 32 bytes aligned
2. Output image size cannot be more than 2047x2047
3. Output width must be even
4. Output width must be 16 byte aligned for vertical resizing
5. The horizontal start pixel must be within range 0-15 for color interleaved and 0-31 for color separate data

Supported System Calls

open(), close(), mmap(), munmap() and ioctl()

Performance Benchmarks

Setup Details -

• File System - NFS
• CPU Idle - Enabled
• Tool Used for measurement - LFTB

Performance Benchmarks - OMAP35x

Video Display Driver Performance

Scaling	Time Taken (MicroSecond)	CPU Load (%)
4x (176x144 => 704x576)	1342.4	15.662
1/4x (704x576 => 176x144)	3198.2	40.756

NAND Driver

This section describes the NAND flash driver architecture, driver features and performance numbers (throughput and CPU load).

Introduction

The NAND flash driver is implemented as both - block driver and character driver, compliant with the standard MTD driver. It supports various NAND Flash chips (see drivers/mtd/nand/nand_ids.h file.) The NAND driver creates the device nodes for user space access (/dev/mtdblock0, /dev/mtdblock1, /dev/mtd0,/dev/mtd1 and so on). This release has been tested with Micron NAND device on the OMAP3EVM/AM3517EVM

This figure illustrates the stack diagram of NAND flash driver in Linux.

Driver Features

The driver supports the following features:

1. JFFS2 file system
2. Supports Read/Write, Erase operations
3. Bad Block Management
4. Polled mode of transfer
5. SLC NAND
6. NAND Flash divided into 5 partitions
   1. 512KB partition for X-loader
   2. 1920 KB (Read Only) partition for U-Boot
   3. 128 KB (Read Only) for environment variables
   4. 5 MB (Read/Write) partition for Linux
   5. Remainder for file system and others (Read/Write)

Features Not Supported

None

Constraints

None

Supported System Calls

Supports the system call support proivided by MTD interface viz. open(), close(), read(), write(), ioctl()

Performance Benchmarks

OMAP35x

NAND write performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	4.69	100
256	100	3.00	100
512	100	2.55	100
1024	100	2.21	100
5120	100	1.95	100

NAND Read performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	5.94	100
256	100	5.35	100
512	100	5.35	100
1024	100	5.35	100
5120	100	5.35	100

The performance numbers are captured using the following:

1. NAND PART Number: Micron MT29F4G08AAC
2. CPU Power Management disabled.
3. File System = JFFS2
4. NAND partition was mounted with async option.

AM3517

NAND write performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	4.84	100
256	100	3.27	100
512	100	2.82	100
1024	100	2.47	100
5120	100	2.20	100

NAND read performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	6.54	100
256	100	5.88	100
512	100	5.89	100
1024	100	5.89	100
5120	100	5.89	100

The performance numbers are captured using the following:

1. NAND PART Number: Micron MT29F4G08AAC
2. Power Management disabled.
3. File System = JFFS2
4. NAND partition was mounted with async option.

MMC/SD Driver

This section provides details on MMC/SD driver along with throughput and CPU load numbers.

Introduction

The MMC controller provides an interface to external MMC cards that follow the MMC specification v4.0. The MMC driver is implemented as a block driver. Block device nodes(such as /dev/mmcblockp1, /dev/mmcblockp2) are created for user space access.

Driver Features

The driver supports the following features:

1. MMC/SD native protocol command/response set
2. Single/multiple block data transfers
3. Linux file system and generic MMC layer abstract details of block devices (MMC)
4. High-speed (SDv1.1) and High Capacity (SDv2.0) cards
5. Support for 1/4 bit modes
6. Support for card detect and Write protect features
7. DMA mode for data transfer operations
8. SDIO functionality (tested with marvell 8686 wlan card)

Features Not Supported

1. Support for 8-bit mode of operation.
2. SPI mode of operation

Constraints

1. MMC/SD cards should not be removed when the mount operation is in progress. If done so, data integrity cannot be guaranteed.

Supported System Calls

open(),close(),read(),write()

Supported IOCTLs

None

Performance and Benchmarks

---

Important

The performance numbers can be severely affected if the media is mounted in sync mode.

---

Performance using EXT2 file system

Read performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	12.90	15.04
256	100	13.09	14.61
512	100	13.07	15.32
1024	100	13.07	14.11
5120	100	13.02	15.05

Write performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	7.28	6.82
256	100	6.51	6.40
512	100	6.24	5.54
1024	100	6.53	6.43
5120	100	7.01	6.49

The performance numbers were captured using the following:

• SD Card (Elite Pro, High Speed, 2GB)
• CPU Power Management: Disabled
• File System: ext2
• Partition was mounted with async option

Performance using VFAT file system

Read performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	12.61	6.98
256	100	12.45	9.43
512	100	12.60	7.72
1024	100	12.82	11.10
5120	100	12.83	12.08

Write performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	13.07	18.70
256	100	13.37	22.04
512	100	13.76	24.54
1024	100	14.35	25.89
5120	100	14.38	26.68

The performance numbers were captured using the following:

• SD Card (ELITE PRO High speed, 2GB)
• CPU Power Management: Disabled
• File System: VFAT
• Partition was mounted with async option

Performance using EXT2 file system

Read performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	12.98	15.35
256	100	13.04	14.82
512	100	13.09	16.27
1024	100	13.10	16.25
5120	100	13.11	15.66

Write performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	6.50	5.89
256	100	6.49	5.63
512	100	6.90	6.19
1024	100	6.98	6.80
5120	100	7.29	6.89

The performance numbers were captured using the following:

• SD Card (Elite Pro, High Speed, 2GB)
• CPU Power Management: Disabled
• File System: ext2
• Partition was mounted with async option

Performance using VFAT file system

Read performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	13.29	19.92
256	100	13.36	20.43
512	100	13.35	20.15
1024	100	13.33	20.18
5120	100	13.28	20.18

Write performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	12.86	18.77
256	100	14.38	24.59
512	100	14.09	23.52
1024	100	14.83	24.86
5120	100	14.63	25.28

The performance numbers were captured using the following:

• SD Card (ELITE PRO High speed, 2GB)
• CPU Power Management: Disabled
• File System: VFAT
• Partition was mounted with async option

Real Time Clock (RTC) Driver (Only for AM3517)

This section provides details on RTC (S35390A) driver along with throughput and CPU load numbers.

Introduction

AM3517 EVM supports external RTC chip S35390A over I2C1.

Driver Features

The driver supports the following features:

1. Supports IOCTLs to set/get the time/date value
2. Driver can be built as a loadable module and inserted dynamically.

Features Not Supported

• Interrupt based Wake-up and respective IOCTL's

Constraints

None

Supported System Calls

open(), close(), write(), read()

Performance and Benchmarks

None

USB Driver

This section describes the USB (EHCI and MUSB) driver architecture, features supported/not supported, constraints and performance numbers.

EHCI host Controller

Description

OMAP35x

OMAP3EVM (Rev < E) has EHCI port on Mistral Daughter Card (MDC) while on OMAP3EVM (Rev >= E) EHCI port is on main board itself.

AM3517

AM3517EVM has one EHCI port on base board and another EHCI port on UI card. EHCI port on UI card would work only if LCD is not enabled as LCD and UI card EHCI port share some IO pins.

Driver Features

The driver supports the following features

1. Hub Class
2. Mass Storage Class (MSC)
3. Human Interface Class (HID) (through a high speed hub)
4. USB Video Class (UVC)
5. USB Audio Class (UAC)

Features Not Supported

All other classes not mentioned in the "Supported Features" section.

MUSB OTG controller

Description

OMAP35x

The MUSB driver is implemented on top of Mentor OTG IP version 1.4 which supports all the speeds (High, Full and Low).MUSB uses inventra DMA for all the transfers. OMAP3EVM uses ISP1504 external USB PHY.

AM3517

The MUSB driver is implemented on top of Mentor OTG IP version 1.8 which supports all the speeds (High, Full and Low).MUSB uses CPPI4.1 DMA for all the transfers.AM35x has USB PHY inside IP itself.

Driver Features

The driver supports the following features

Host Mode

1. Hub Class
2. Human Interface Class (HID)
3. Mass Storage Class (MSC)
4. USB Video Class (UVC)
5. USB Audio Class (UAC)

Gadget mode

1. Mass Storage Class (MSC)
2. USB Networking - RNDIS/CDC

OTG mode

1. Session Request Protocol (SRP)
2. Host Negotiation Protocol (HNP)

Features Not Supported

1. All other classes not mentioned in the "Supported Features" section.

USB Mass Storage Class Host Driver

Description

This figure illustrates the stack diagram of the system with USB Mass Storage Class driver

Driver Features

The driver supports the following feature

1. DMA mode
2. PIO mode

Features Not Supported

None

Constraint

1. There is a limitation in the power that is supplied by the charge pump of the ISP1504 PHY on OMAP3EVM-1 (<=Rev-E). If you notice VBUSERR messages in the system console, then connect a self powered USB hub and then attach the device to the hub
2. OMAP3EVM-2 (>=Rev-E) can support upto 500mA power and thus self powered hub is not required.VBUS must be re-enabled after disconnect and reconnect of the MSC device while the MUSB image is built in OTG mode

Supported System Calls

open(), close(), read(), write(), ioctl()

Supported IOCTLS

None

Performance Benchmarks

---

Important

For Mass-storage applications, the performance numbers can be severely affected if the media is mounted in sync mode. Hot plug scripts in the filesystem mount removable media in sync mode to ensure data integrity. For performance sensitive applications, umount the auto-mounted filesystem and re-mount in async mode.

---

OMAP35x

USB MSC (MUSB) Host mode DMA Ext2 File System Performance

USB-MSC MUSB Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	23.23	40.67
256	100	23.37	39.56
512	100	23.23	44.22
1024	100	22.90	43.11
5120	100	22.89	42.11

USB-MSC MUSB Host-DMA-Read Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	11.50	34.43
256	100	11.59	34.14
512	100	11.43	37.95
1024	100	11.41	32.39
5120	100	11.64	34.89

The performance numbers are captured using the following.

1. Hard disk: Toshiba 80GB DISK DRIVE
2. File format: ext2
3. CPU Idle state: Disabled
4. System DMA on all Rx channels: Disabled

USB MSC (MUSB) Host mode DMA VFAT File System Performance

USB-MSC MUSB Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	16.89	49.68
256	100	17.32	46.26
512	100	15.26	48.98
1024	100	16.41	50.00
5120	100	16.97	51.70

USB-MSC MUSB Host-DMA-Read Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	11.16	38.76
256	100	11.17	38.66
512	100	11.22	37.31
1024	100	11.42	32.86
5120	100	11.38	36.48

The performance numbers are captured using the following.

1. Hard disk: Toshiba 80GB DISK DRIVE
2. File format: vfat
3. CPU Idle state: Disabled
4. System DMA on all Rx channels: Disabled

USB MSC (EHCI) Host mode DMA Ext2 File System Performance

USB-MSC EHCI Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	50	21.10	38.99
256	50	21.51	37.73
512	50	21.97	41.61
1024	50	21.55	41.58
5120	50	21.90	42.19

USB-MSC EHCI Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	50	20.42	45.81
256	50	20.13	46.03
512	50	20.41	44.42
1024	50	20.38	46.69
5120	50	20.26	49.03

The performance numbers are captured using the following.

1. Hard disk: Toshiba 80GB DISK DRIVE
2. File format: ext2
3. CPU Idle state: Disabled

USB MSC (EHCI) Host mode DMA VFAT File System Performance

USB-MSC EHCI Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	50	14.60	42.60
256	50	16.01	46.00
512	50	15.32	51.10
1024	50	15.81	50.00
5120	50	15.69	49.17

USB-MSC EHCI Host-DMA-Read Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	50	20.55	50.29
256	50	20.75	51.89
512	50	20.68	45.96
1024	50	20.66	45.94
5120	50	20.60	47.02

The performance numbers are captured using the following.

1. Hard disk: Toshiba 80GB DISK DRIVE
2. File format: vfat
3. CPU Idle state: Disabled

AM3517

USB MSC (MUSB) Host mode DMA Ext2 File System Performance

USB-MSC MUSB Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	24.95	34.37
256	100	24.06	34.21
512	100	24.22	38.66
1024	100	23.41	34.82
5120	100	24.16	37.56

USB-MSC MUSB Host-DMA-Read Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	21.16	43.93
256	100	21.16	45.67
512	100	21.59	39.71
1024	100	21.30	37.60
5120	100	21.23	36.67

The performance numbers are captured using the following.

1. Hard disk: Toshiba 80GB DISK DRIVE
2. File format: ext2
3. CPU Idle state: Disabled

USB MSC (MUSB) Host mode DMA VFAT File System Performance

USB-MSC MUSB Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	17.83	41.26
256	100	18.70	43.57
512	100	17.94	48.97
1024	100	17.94	46.06
5120	100	18.23	46.77

USB-MSC MUSB Host-DMA-Read Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	100	21.38	42.57
256	100	21.58	42.59
512	100	21.44	37.83
1024	100	21.47	38.24
5120	100	21.61	38.14

The performance numbers are captured using the following.

1. Hard disk: Toshiba 80GB DISK DRIVE
2. File format: vfat
3. CPU Idle state: Disabled

USB MSC (EHCI) Host mode DMA Ext2 File System Performance

USB-MSC EHCI Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	50	23.68	32.66
256	50	23.63	32.36
512	50	23.73	39.14
1024	50	23.67	38.10
5120	50	23.30	36.59

USB-MSC EHCI Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	50	20.99	38.08
256	50	21.14	42.42
512	50	21.46	41.19
1024	50	21.43	38.57
5120	50	21.26	41.99

The performance numbers are captured using the following.

1. Hard disk: Toshiba 80GB DISK DRIVE
2. File format: ext2
3. CPU Idle state: Disabled

USB MSC (EHCI) Host mode DMA VFAT File System Performance

USB-MSC EHCI Host-DMA-Write Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	50	17.42	37.88
256	50	17.49	38.44
512	50	16.87	41.79
1024	50	16.90	42.63
5120	50	17.17	42.50

USB-MSC EHCI Host-DMA-Read Performance values

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
100	50	20.61	43.48
256	50	20.68	41.78
512	50	20.84	41.15
1024	50	20.82	37.00
5120	50	21.50	42.62

The performance numbers are captured using the following.

1. Hard disk: Toshiba 80GB DISK DRIVE
2. File format: vfat
3. CPU Idle state: Disabled

USB Mass Storage Class Slave Driver

Description

This figure illustrates the stack diagram of the system with USB File Storage Gadget driver

Driver Features

The driver supports the following feature

1. DMA mode
2. PIO mode
3. File backed storage driver was tested with SD media as the storage medium

Features Not Supported

None

Constraint

None

Supported System Calls

NA

Supported IOCTLS

NA

Performance Benchmarks

OMAP35x

USB Slave-DMA Performance

USB Slave-DMA-Read Performance values

Bytes Transferred (MB)	Number of files transferred	Total Bytes transferred (MB)	Data Rate (MB/sec)
200	1	200	13.33
1000	1	1000	14.28

USB Slave-DMA-Write Performance values

Bytes Transferred (MB)	Number of files transferred	Total Bytes transferred (MB)	Data Rate (MB/sec)
200	1	200	4.25
1000	1	1000	4.44

The performance numbers are captured using the following.

1. Storage media: Toshiba 80 GB HDD connected to EHCI port
2. File format: vfat on Windows XP
3. CPU Idle state: off
4. System DMA for Rx channel : Enabled

AM3517

USB Slave-DMA Performance

USB Slave-DMA-Read Performance values

Bytes Transferred (MB)	Number of files transferred	Total Bytes transferred (MB)	Data Rate (MB/sec)
200	1	200	14.28
1000	1	1000	15.38

USB Slave-DMA-Write Performance values

Bytes Transferred (MB)	Number of files transferred	Total Bytes transferred (MB)	Data Rate (MB/sec)
200	1	200	6.66
1000	1	1000	6.45

The performance numbers are captured using the following.

1. Storage media: Toshiba 80 GB HDD connected to EHCI port
2. File format: vfat on Windows XP
3. CPU Idle state: off

USB CDC/RNDIS Slave Driver

Description

The CDC RNDIS gadget driver that is used to send standard Ethernet frames using USB. The driver will create an Ethernet device by the name usb0.

Driver Features

The driver supports the following feature

1. DMA mode
2. PIO mode
3. 10/100 Mbps speed.

Features Not Supported

None

Constraint

None

Supported System Calls

open(), close(), read(), write(), ioctl()

Supported IOCTLS

None

Performance Benchmarks

Performance benchmarks were collected using the Iperf tool and default options were used to collect the throughput numbers.

OMAP35x

USB CDC-DMA Performance

USB CDC-DMA Performance values - Client

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
16	487	68.1	60
32	490	68.5	60
64	496	69.3	60
128	496	69.3	60
208	496	69.3	60

USB RNDIS-DMA Performance

USB RNDIS-DMA Performance values - Client

Buffer Size (in KBytes)	Total Bytes Transferred (in MBytes)	Transfer Rate (in MBytes/sec)	CPU Load (in %)
16	529	73.6	60
32	576	80.6	60
64	510	71.2	60
128	518	72.4	60
208	520	72.4	60

AM3517

USB CDC-DMA Performance

USB CDC-DMA Performance values - Client

TCP window size (in KBytes)	Bandwidth (Mbits/Sec)	Transfer size (in Mbytes)	Interval (in sec)
16	59.2	8.27	60
32	136.8	19.12	60
64	267	37.3	60
128	470	65.5	60
208	598	83.6	60

USB RNDIS-DMA Performance

USB RNDIS-DMA Performance values - Client

TCP window size (in KBytes)	Bandwidth (Mbits/Sec)	Transfer size (in Mbytes)	Interval (in sec)
16	603	84.2	60
32	614	85.9	60
64	642	89.8	60
128	540	75.6	60
208	529	73.8	60

USB Human Interface Device (HID) Driver

Description

The event sub system creates /dev/input/event* devices with the help of mdev.

Driver Features

The driver supports the following feature

1. DMA mode
2. PIO mode
3. USB Mouse and Keyboards that conform to the USB HID specifications

Features Not Supported

None

Constraint

None

Supported System Calls

NA

Supported IOCTLS

NA

Performance Benchmarks

NA

USB Isochronous Driver

Description

USB camera, speaker and mic uses isochronouse transfers. USB Video Class (UVC) is used by most of the USB cameras to capture image.

Driver Features

The driver supports the following feature

1. DMA mode
2. PIO mode
3. Support for USB Audio and video class(UVC class)

Features Not Supported

None

Constraint

None

Supported System Calls

NA

Supported IOCTLS

NA

Performance Benchmarks

NA

USB OTG Driver

Description

MUSB controller on OMAP3530EVM and AM3517EVM supports USB On The Go (OTG). OTG protocol enables runtime role switch between USB host and device. This is achieved using Session Request Protocol (SRP) and Host Negotiation Protocol (HNP).

Driver Features

The driver supports the following feature

1. Both HNP and SRP are supported

Constraint

None

Supported System Calls

NA

Supported IOCTLS

NA

Performance Benchmarks

NA

 

Power Management

Introduction

OMAP35x silicon provides a rich set of power management features. The features include Clock control at module level, multiple power and voltage domains etc.

This section provides provides an overview of power management features supported and steps to enable these features in the kernel configuration. It also provides the typical power consumption observed for different scenarios.

cpuidle

When idle loop is executed, kernel is not doing any useful 'work'. This is an opportunity to save power. The cpuidle framework helps in saving power during the idle state.

cpufreq

CPU is not loaded evenly during execution. This provides an opportunity to save power by adjusting/scaling voltage and frequency based on the current cpu load.

SmartReflex

SmartReflex is a power-management technique for controlling the operating voltage of a device to reduce its active power consumption. It helps in achieving optimal performance/power trade-off for all devices across the technology process spectrum and across temperature variations.

Features

The features supported in this release are:

• Dynamic Tick (NO_HZ) framework.
  • The cpuidle framework with MPU and Core transition to retention(RET) and OFF states.
    • The menu governor is supported.
• Static selection of VDD1 OPP via bootarg - mpurate.
  • VDD1 OPP can be scaled (if silicon supports) upto 720MHz.
  • When OPP1 is selected for VDD1, the VDD2 is set at OPP2.
  • Basic implementation for cpufreq.
• Support SmartReflex with automatic (hardware-controlled) mode of operation.

Features not supported

1. Allow drivers and applications to limit the idle state that can be entered.
2. Support for SmartReflex with manual (software-controlled) mode of operation.

Constraints

1. Only basic implementation of cpufreq is supported.
2. Some of the drivers do not leverage the power-saving features supported by the silicon. They need to enable/ disable corresponding clocks via clk_enable() and clock_disable() only when the clocks are really needed.
3. After the system is suspended, the resume operation does not succeed from the touchscreen.

Power Measurements

OMAP3530

The measurements in this section were done on OMAP3EVM (Rev G) with NI-USB 6251 and TI power consumption tool.

• The measurements were done at identified system state for period of ~60 secs.
• Voltage and current values for VDD1 and VDD2 are measured across jumpers J6 and J5 respectively.
• SmartReflex is enabled in the kernel configuration; but is not activated at runtime.

Specific scenarios associated with the measurement are indicated in the details below.

At each OPP

This table indicates the voltages measured for VDD1 and VDD2 at various OPPs (selected via bootarg - mpurate). The measurements were done with the uImage created using omap3_evm_defconfig.

Power Measurements

OPP	VDD1		VDD2
	Voltage (Volts)	Current (in mA)	Voltage (Volts)	Current (in mA)
OPP1	1.003	3.999	1.070	6.387
OPP2	1.098	7.123	1.179	11.797
OPP3	1.201	15.544	1.181	11.837
OPP4	1.271	18.202	1.180	11.798
OPP5	1.341	21.013	1.180	11.750
OPP6	1.337	25.011	1.180	11.818

Against specific scenarios

The scenarios listed below were executed at OPP5 (mpurate=600).

Scenario 1

1. Build uImage with power management disabled and dynamic tick disabled.
2. Boot the EVM with this uImage and ramdisk.

Scenario 2

1. Build uImage with power management disabled but dynamic tick enabled.
2. Boot the EVM with this uImage and ramdisk

Scenario 3

1. Build uImage with power management, power management debug, DebugFS and dynamic tick enabled; but no cpuidle.
2. Boot the EVM with this uImage and ramdisk.
3. After boot-up, mount debugfs

   $ mkdir /debug

   $ mount -t debugfs debugfs /debug

4. Execute these commands:

   $ echo 1 > /debug/pm_debug/sleep_while_idle

5. Wait for 30 secs and start the measurement.

Scenario 4

1. Build uImage with power management, power management debug, DebugFS, dynamic tick and cpuidle enabled.
2. Boot the EVM with this uImage and ramdisk.
3. After boot-up, mount debugfs

   $ mkdir /debug

   $ mount -t debugfs debugfs /debug

4. Execute these commands:

   $ echo 1 > /debug/pm_debug/sleep_while_idle

5. Wait for 30 secs and start the measurement.

Scenario 5

1. Build uImage with power management, power management debug, DebugFS, dynamic tick and cpuidle enabled.
2. Boot the EVM with this uImage and ramdisk.
3. After boot-up, mount debugfs

   $ mkdir /debug

   $ mount -t debugfs debugfs /debug

4. Execute these commands:

   $ echo 1 > /debug/pm_debug/sleep_while_idle

   $ echo 1 > /debug/pm_debug/enable_off_mode

5. Wait for 30 secs and start the measurement.

Power Measurements

Scenario	Voltage (Volts)	Current (in mA)
Scenario 1	1.207	9.166
Scenario 2	1.207	9.167
Scenario 3	1.369	0.231
Scenario 4	1.369	0.230
Scenario 5	1.371	0.140

Note1: For scenarios 1 and 2 the voltage doesn't scale to required level (~1.34V) as power management is disabled.

Note2: For scenarios 3, 4 and 5 the voltage scales to required level (~1.34V) as power management is enabled.

Note3: A ramdisk image based on minimal busybox configuration used during these measurements. Actual numbers may vary with daemons and processes running (configured in the filesystem).

CAN(HECC) Driver

This section provides details on CAN(HECC) driver.

Introduction

The CAN (HECC) driver supports the Linux netdev interface. CAN driver supports TX and RX mailbox priority feature ensuring in-order packet processing at various bit rates.

Driver Features

The driver supports the following features:

1. SocketCAN networking framework
2. Linux NAPI support for Rx operations
3. Local loopback of sent frames (IFF_ECHO)
4. Standard CAN bus bit-rates namely 10K, 20K, 50K, 100K, 125K, 250K, 500K & 1M

Features Not Supported

1. ID filtering / Acceptance masks - since Linux infrastructure does not support this the driver cannot provide the feature

Constraints

NA

Supported System Calls

Supports the socket() and related system calls in accordance with Linux architecture. Refer to can.txt under Documentation/networking folder

Performance and Benchmarks

NA