OMAP4: OSKernel: L24.0.8 Release Note

Signed-off-by: Santosh Shilimkar <santosh.shilimkar@ti.com>

1 files changed, 439 insertions, 0 deletions

diff --git a/TI_OMAP4_Kernel_Release_Notes_L24.x.txt b/TI_OMAP4_Kernel_Release_Notes_L24.x.txt
new file mode 100644
index 000000000000..eda18131a099
--- /dev/null
+++ b/TI_OMAP4_Kernel_Release_Notes_L24.x.txt
@@ -0,0 +1,439 @@
+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
+
+-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.