path: root/TI_OMAP4_Kernel_Release_Notes_L24.x.txt

Release notes for the Linux kernel for L24.0.8
----------------------------------------------

02 JUNE 2009

Copyright (C) 2009 Texas Instruments Incorporated.  All rights reserved.


1.  Introduction
----------------
This document accompanies OMAP(TM) Software Release L24.0.8 for Linux 2.6.30 on
OMAP4430 VPOM4430_1.08a_Patch1. The document specifies:
	- Instructions for unpacking the release
	- New features and features the release supports
	- Planned future features
	- Postponed features


2. Release Summary
------------------
This is a Linux Baseport Release for SDP4430 on Virtio.
The kernel is based on Linux-omap version 2.6.30 -rc6 from open source.
U-boot is based on open-source version 1.1.4.

The u-boot source can be obtained via GIT from:
  http://git.omapzoom.org/?p=repo/u-boot.git;a=shortlog;h=refs/heads/omap4_dev

The kernel source can be obtained via GIT from:
  http://dev.omapzoom.org/?p=integration/kernel-omap4.git;a=summary

Virtio version used: VPOM4430_1.08a + VPOM4430_1.08a_Patch1.var

All drivers planned for this release are working as expected and
overall platform stability is good.

current L24.0.8 support:
	SMP OS Kernel boot-up on with UART, GPTimers, McBSP, McSPI, I2c, 
	GPIO, WATCHDOG.

3.  Instructions
----------------

3.1 Virtio Setup

This release works on VPOM4430_1.08a_Patch1.


3.2 Virtio Installation Instructions

a. Install to C:\Virtio
b. Once installation for virtio is started, you will be prompted for
   installation
   for virtual serial port. Say yes to it and give a port number (say 5 or 6).
   Multiple serial ports can also be installed.
c. Install C:\Virtio\Shared\Disassembler\Setup\VirtioDisassembler.exe.
   This is to enable debugging using virtio.
d. License for virtio has to be set in the environment variables
   LM_LICENSE_FILE.
e. Install VPOM4430_1.08a_Patch1.


3.3 Virtio Configuration Instructions

Run virtio and if modify the following parameters

a. On some versions SSM is generating error due to illegal instruction fetch.
   To workaround this you can disable SsmDisableSecurity user parameter.
   Params->User Parameters-> SsmDisableSecurity = yes
   Right click on SsmDisableSecurity parameter and change properties to editable
   mode. Then you can set this parameter to Yes. Default value is no.
b. If IVAHD is enabled the image boot up takes lot of time. If IVAHD component
   is not required it can be disabled.
   Browse to VPOM4430::SDP::OMAP4430::TIOMAP4CORES and disable all the enabled
   components under it
c. Open the Params tab and look at the User Parameters. Set the UARTx_COM_PORT
   to the virtual port number you had provided while installation.
d. Both CPU cores support has been enabled.
e. L2 Cache is not enabled in software. This requires the cache to be turned 
   off in the Virtio parameter list too. For this browse to
   VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_1 and set the CacheDisabled parameter
   to true. Browse to VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_2 and set the
   CacheDisabled parameter to true.Also browse to
   VPOM4430::SDP::OMAP4430::CPU_SS::pl310_cache and set the CacheDisabled
   parameter to true.
f. Once booted with two CPU, you can see two penguins on LCD instead on one.
   Linux kernel shows one penguin per CPU.

3.4 Compiling U-Boot

Set the environment variable PATH such that cross compile binaries point to the
needed tool chain. Refer to section 5 for tool chain information.

To select the default configuration for U-Boot type:
	# make CROSS_COMPILE=arm-none-linux-gnueabi- omap4430sdp_config

To build the U-Boot image type:
	# make CROSS_COMPILE=arm-none-linux-gnueabi-

3.5 Compiling X-Loader

Not yet supported

3.6 Compiling the Kernel

Set the environment variable PATH such that cross-compile binaries point to the
needed tool chain. Refer to section 5 for tool chain information.

The default configuration file for Virtio4430 is present at
arch/arm/configs/omap_4430sdp_defconfig.

To work with the default configuration file, run following commands:
	# make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi-
					omap_4430sdp_defconfig

Build kernel with:
	# make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- uImage

NOTE:	The above steps will create arch/arm/boot/uImage in the kernel directory
	which is the binary used for booting.

Filesystem:
NFS file system is not yet supported. Use ramdisk instead.
The default configuration for ramdisk is in the 4430 defconfig.
	Load address = 0x81600000
	Default size = 20MB


3.7 Running U-Boot boot loader on RAM

Go to the design tab. Open Scripts-> configs/Native Apps/Native Apps.script.
Replace it as shown below.
Then launch HyperTerminal and connect to the virtual serial port installed.
(e.g. COM5).
Now choose Native Apps in the configuration tabs at the top and select run.
The SDP4430 U-Boot prompt will appear in your terminal emulation program.

----------------------- [start of Native Apps.script]--------------------------

[VPOM4430::SDP::OMAP4430::L3FW_GPMC] bypass on
[VPOM4430::SDP::OMAP4430::L3FW_EMIF] bypass on
g #10

cc VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_1

# Configure DMM to allow SDRAM accesses during ELF load.
# DMM_LISA_MAP[0]: 0x80000000 mapped to 0x0 on SDRC0 (128MiB, no interleaving)
d 0x4E000100=0x80301000

#load up the u-boot
[VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_1]l 0x80e80000 -bin <u-boot.bin PATH>
[VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_2]l 0x80e80000 -bin <u-boot.bin PATH>

# PRCM setup
# WKUP Domain
dp 0x4a307800 = 0x3
dp 0x4a307830 = 0x2
dp 0x4a307838 = 0x102
dp 0x4a307840 = 0x01000002
dp 0x4a307858 = 0x2
dp 0x4a307878 = 0x2
dp 0x4a307880 = 0x1

# ABE Domain
dp 0x4A004500 = 0x3
dp 0x4A004528 = 0x2
dp 0x4A004530 = 0x2
dp 0x4A004538 = 0x2
dp 0x4A004540 = 0x2
dp 0x4A004548 = 0x2
dp 0x4A004550 = 0x2
dp 0x4A004558 = 0x2
dp 0x4A004560 = 0xf02
dp 0x4A004568 = 0x2
dp 0x4A004570 = 0x2
dp 0x4A004578 = 0x2
dp 0x4A004580 = 0x2
dp 0x4A004588 = 0x2

# CORE Domain
# WakeUp Module domains
dp 0x4A008900 = 0x2
dp 0x4A008a00 = 0x2
dp 0x4A008b00 = 0x2
dp 0x4A008c00 = 0x2
dp 0x4A008900 = 0x3

# SDMA No Sleep!!
dp 0x4A008a00 = 0x0
dp 0x4A008b00 = 0x3
dp 0x4A008c00 = 0x3
dp 0x4A008828 = 0x1
dp 0x4A008920 = 0x1

# IVAHD Domain
dp 0x4A008F00 = 0x2
dp 0x4A008F00 = 0x3
dp 0x4A008F20 = 0x1
dp 0x4A008F28 = 0x1

# CAM Domain
dp 0x4A009000 = 0x2
dp 0x4A009000 = 0x3
dp 0x4A009020 = 0x102
dp 0x4A009028 = 0x2

# DSS Domain
dp 0x4A009100 = 0x2
dp 0x4A009100 = 0x3
dp 0x4A009120 = 0xf02
dp 0x4A009128 = 0x2

# GFX Domain
dp 0x4A009200 = 0x2
dp 0x4A009200 = 0x3
dp 0x4A009220 = 0x2

# L3INT Domain
dp 0x4A009300 = 0x3
dp 0x4A009328 = 0x2
dp 0x4A009330 = 0x2
dp 0x4A009338 = 0x2
dp 0x4A009340 = 0x102
dp 0x4A009358 = 0xff02
dp 0x4A009360 = 0x102
dp 0x4A009368 = 0x712
dp 0x4A009380 = 0x2
dp 0x4A009388 = 0x2
dp 0x4A009390 = 0x2
dp 0x4A009398 = 0x2
dp 0x4A0093A8 = 0x2
dp 0x4A0093C0 = 0x2
dp 0x4A0093C8 = 0x2
dp 0x4A0093D0 = 0x2
dp 0x4A0093E0 = 0x2

# L4PER Domain
dp 0x4A009400 = 0x2
dp 0x4A009580 = 0x2
dp 0x4A009400 = 0x3
dp 0x4A009580 = 0x3
dp 0x4A009420 = 0x2
dp 0x4A009428 = 0x2
dp 0x4A009430 = 0x2
dp 0x4A009438 = 0x2
dp 0x4A009440 = 0x2
dp 0x4A009448 = 0x2
dp 0x4A009450 = 0x2
dp 0x4A009458 = 0x2
dp 0x4A009460 = 0x102
dp 0x4A009468 = 0x102
dp 0x4A009470 = 0x102
dp 0x4A009478 = 0x102
dp 0x4A009480 = 0x102
dp 0x4A009488 = 0x2
dp 0x4A009490 = 0x2
dp 0x4A009498 = 0x2
dp 0x4A0094A0 = 0x2
dp 0x4A0094A8 = 0x2
dp 0x4A0094B0 = 0x2
dp 0x4A0094B8 = 0x2
dp 0x4A0094D0 = 0x2
dp 0x4A0094D8 = 0x2
dp 0x4A0094E0 = 0x2
dp 0x4A0094E8 = 0x2
dp 0x4A0094F0 = 0x2
dp 0x4A0094F8 = 0x2
dp 0x4A009500 = 0x2
dp 0x4A009508 = 0x2
dp 0x4A009520 = 0x2
dp 0x4A009528 = 0x2
dp 0x4A009530 = 0x2
dp 0x4A009538 = 0x702
dp 0x4A009540 = 0x2
dp 0x4A009548 = 0x2
dp 0x4A009550 = 0x2
dp 0x4A009558 = 0x2
dp 0x4A009560 = 0x2
dp 0x4A0095A0 = 0x2
dp 0x4A0095A8 = 0x2
dp 0x4A0095B0 = 0x2
dp 0x4A0095B8 = 0x2
dp 0x4A0095C0 = 0x2
dp 0x4A0095C8 = 0x2

#Route UART1 signals
dp 0x4a10013C = 0x00010001

#Route GPIO11 for Phoenix AudioCodec PowerUp
dp 0x4a31E084 = 0x01080003

# EMIF firewall bypass mode can now be turned off
[VPOM4430::SDP::OMAP4430::L3FW_EMIF] bypass off

# Open up the EMIF and OCMRAM firewalls to all accessors before anything runs
d 0x4a20c08c=0xffffffff
d 0x4a21208c=0xffffffff
d 0x4a22808c=0xffffffff

g

------------------------- [End of Native Apps.script]---------------------------

3.8 Running Linux kernel

The kernel binary used will be arch/arm/boot/uImage.


3.8.1 Loading the kernel image via Virtio

Select 'break' in the VPOM4430 innovator window. This will halt the system.
Use the following commands from the console window (will be open at the bottom
of virtio innovator window) to load up Image and the file system
	l 0x81600000 -bin <path where you have your ramdisk>
	l 0x80300000 -bin <path where Image file is put>/uImage>
	r r15=0x80e80054

Select 'go' in the virtio window.
Go to the hyper terminal and execute the following
set bootargs root=/dev/ram0 rw mem=128M console=ttyS0,115200n8
initrd=0x81600000,20M ramdisk_size=20480

bootm  0x80300000
You should see the kernel booting and ramdisk getting loaded in a few seconds

3.8.2 Loading the kernel image via Trace32

Launch the T32. If console window is already running t32.cmm script is
automatically run and you will be attached to the system. If not you will have
to manually run t32.cmm script file.
Break the system through t32
Use the following commands from T32 window to load up the kernel image and
file system
	Data.load.binary <your Image path>/Image 0x80300000
	Data.load.binary <your ramdisk path> 0x81600000
        r r15=0x80e80054

Select 'go' in the T32 window
Go to the hyper terminal and execute the following

>set bootargs root=/dev/ram0 rw mem=128M console=ttyS0,115200n8
initrd=0x81600000,20M ramdisk_size=20480
>bootm  0x80300000

You should see the kernel booting and ramdisk getting loaded in a few seconds

NOTE: The kernel binary used is arch/arm/boot/uImage and 
      not arch/arm/boot/Image.


4. Features
-----------

4.1 New Features

NA

4.2 Supported Features

- Boot-loader:
	U-boot from RAM

- OS Kernel
	SMP Kernel with GIC, LOCAL timer support.
	GP-Timers
	32 KHz Sync timer
	Watchdog timer
	I2C
	DMA
	GPIO
	McBSP
	McSPI
	Console UART (Uart 1, Uart 2, Uart 3,Uart 4)
- Power related
	Clock nodes in PRM/CM1/CM2 modules modelled.
	Clock nodes for ABE/PER/CORE/MPU/DSP/UNIPRO DPLL's modelled.
	Not present:
	USB DPLL not modelled
	None of the DPLL set_rate and recalc functions are implemented.

-Audio
	ALSA SoC compliant
	McBSP Audio Stub
	Added McPDM driver

-Video
	No support yet


4.3 Postponed Features

None


4.4 Future Planned Features

Refer to Program schedule.


4.5 Defects Fixed in This Release

None

4.6 Open Defects

None


4.7 Open Change Requests

None


4.8 Rejected Defects

None


4.9 Postponed Defects

None

4.10 Limitations

None


5. Tool Chain
-------------
The toolchain used to build the code can be obtained from CodeSourcery at the
following URL:
	http://www.codesourcery.com/gnu_toolchains/arm/portal/release644

The tool chain version is Sourcery G++ Lite 2008q3-72 for ARM GNU/Linux.

The tool chain requires glibc 2.3.0 or higher to compile the source code on
the host machine.


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

OMAP(TM) is a Trademark of Texas Instruments Incorporated
Innovator(TM) is a Trademark of Texas Instruments Incorporated
Code Composer Studio(TM) is a Trademark of Texas Instruments Incorporated
DSP/BIOS(TM) is a Trademark of Texas Instruments Incorporated

All other trademarks are the property of the respective owner.