diff options
author | Ricardo Perez Olivares <richo@ti.com> | 2009-10-23 14:39:44 -0500 |
---|---|---|
committer | Ricardo Perez Olivares <richo@ti.com> | 2009-10-23 14:41:29 -0500 |
commit | 8315c440dedd2ac4b0e8e70c8ccb958f4281756a (patch) | |
tree | f38e2fb0aad897b85ff0ffdad0403925a0b5923b | |
parent | 607cc8b8d55966f3d34a01714bf6aae01a7f7ff6 (diff) |
RLS_NOTES L24.0.13ti-2.6.31-omap4-24.0.13
Adding changes for current L24.0.13 release
Signed-off-by: Ricardo Perez Olivares <richo@ti.com>
-rwxr-xr-x | TI_OMAP4_Kernel_Release_Notes_L24.x.txt | 479 |
1 files changed, 479 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 100755 index 000000000000..2ed20a7e19e6 --- /dev/null +++ b/TI_OMAP4_Kernel_Release_Notes_L24.x.txt @@ -0,0 +1,479 @@ +Release notes for the Linux kernel for L24.0.13 +---------------------------------------------- + +22 October 2009 + +Copyright (C) 2009 Texas Instruments Incorporated. All rights reserved. + + +1. Introduction +---------------- +This document accompanies OMAP(TM) Software Release L24.0.13 for Linux 2.6.31 +on OMAP4430 VPOM4430_1.09a_Patch33. 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.31 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 + L24.0.13 branch +Virtio version used: VPOM4430_1.09a + VPOM4430_1.09a_Patch33.var + +All drivers planned for this release are working as expected and +overall platform stability is good. + +Current L24.0.13 support: + UART with DMA support,SMP OS Kernel boot-up on with UART, GPTimers, McBSP, + McSPI, I2c, GPIO, WATCHDOG, Keypad, Phoenix PM IC, RTC, ALSA AUDIO, Neon, + PM - Clock framework, Clock Domain framework, Power Domain framework, + Shared Resource Framework, Tick suppression. + U-boot USB support. +Code has been added for following drivers, but cannot be tested on Virtio: + Phoenix - General Purpose ADC, Battery charging. + +3. Instructions +---------------- + +3.1 Virtio Setup + +This release works on VPOM4430_1.09a_Patch33. + + +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.09a_Patch33. + + +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,kernel and file system +[VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_1]l 0x80300000 -bin <uImage PATH> +[VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_1]l 0x81600000 -bin <ramfs PATH> +[VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_1]l 0x88e80000 -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 + +#Mux configuration for Keypad +dp 0x4A100188 = 0x01010101 +dp 0x4A10018C = 0x01010101 +dp 0x4A100190 = 0x01010101 + +dp 0x4A10017C = 0x01010101 +dp 0x4A100180 = 0x01010101 +dp 0x4A100184 = 0x01010101 + +#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 + +[VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_1]r r15=0x88e80000 +[VPOM4430::SDP::OMAP4430::CPU_SS::Cortex_2]r r15=0x88e80000 +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 +Note that the new NativeApp.script can load the kernel image & file sytem +image. + +Just give below command on u-boot prompt. + 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 + +>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 + +4.2 Supported Features + +- Boot-loader: + U-boot from RAM, + U-boot USB support. + +- 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) + Phoenix Regulator + Phoenix core + RTC + KEYPAD + MMC/eMMC/SD + Tiler + Neon + + Code has been added for following drivers, but cannot be tested on Virtio: + Phoenix - General Purpose ADC, Battery charging. + +- 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. + Shared Resource Framework + Tick suppression enabled. + + +-Audio + Added Audio Backend playback support with MM interface + Added TWL6030 ALSA SoC codec driver + Support for Low Power and High Performance modes of TWL6030 codec + Basic support for audio interrupt: power-up sequence completion + Added McPDM base and SoC platform drivers + Added SDP4430 ALSA SoC machine driver + Additional Comments: + - Supported 44.1/48 kHz signed 32-bits LE format + - twl6030 i2c bus 1 speed was reduced to 400 kbits/s to match codec + requirements + NOTE: Audio support is disabled in SDP4430 kernel defconfig due to the + requirement of an additional license for dMACe component in Virtio, + which is used as a part of Audio Backend. + +-Video + Basic Frame Buffer support. + +-Display + Tiler + +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. + |