OMAP35x SOM-LV / Torpedo Linux Demo readme.txt ----------------------------------------------------------------------------- The OMAP35x SOM-LV/Torpedo Linux Demonstration image is an executable loaded/executed by LogicLoader (LoLo) on an OMAP35x SOM-LV OR Torpedo with attached LCD panel. For instructions on how to install and use this demonstration image, please refer to the Zoom OMAP35x Development Kit User Manual, available on the Logic website: --- Product Support Services platformsupport@logicpd.com ----------------------------------------------------------------------------- --------------- ToC --------------- 1 Release Notes 2 What's New 3 General Information 4 Known Issues 5 Dependencies - Change Log --------------- 1) Release Notes ---------------- --) This release contains only one image/rootfs which contains the following user-land programs and packages: + alsa-lib 1.0.18 + alsa-utils 1.0.11rc2 + bash 2.05b + bluez-libs 2.25 + bluez-utils 2.25 + busybox 1.15.1 + cpufrequtils 005 + draw-test 1.0 + udev 117 + DirectFB 1.1.0 + DirectFB-exmpales 0.9.23 + dropbear 0.52 + e2fsprogs 1.41.4 + ethtool 3 + freetype 2.1.7 + gdb (server) 6.6 + helloworld_mod 1.2 + hotplug 2004_3_29 + i2c-tools 3.0.2 + iperf 1.7.0 + less 381 + libid3tag 0.15.1b + libjpeg v6b + libmad 0.15.1b + libpng 1.2.8 + libtermcap 2.0.8-31_1 + libusb 0.1.8 + Linux kernel 2.6.32 + lzo 2.03 + module-init-tools 3.1.0.pre5 + mp3play 1.0-0 + mtd-utils 20080618 + ncurses 5.3 + play 1.0 + procps 3.2.7 + skell 1.19 + strace 4.5.14 + sysconfig-omap 1.2 + sysfsutils 2.1.0 + timezone 2006n + tslib 1.0-1 + usbutils 0.70-1 + u-boot 2009.08-rc2 + u-boot-tools 1.1.6 + wireless-tools 29 + x-loader 2 + zlib 1.2.3 --) This archive contains only two pre-built .elf images suitable for loading by LoLo: The pre-built images include the following features: --) linux-omap35x-2.1-ramdisk.elf + Built for OMAP SOM-LV/Torpedo (will boot on both) --) linux-omap35x-2.1-yaffs.elf + Built for OMAP SOM-LV/Torpedo (will boot on both) + root filesystem is expected to be in NAND. --) This archive also contains the following images: --) uImage + 2.6.32 kernel that loads/boots on both LV SOM/Torpedo --) u-boot + u-boot-2009.08-rc2 image, both as .elf and .bin --) x-loader + x-load.bin.ift image used to optionally replace NoLo --) rootfs.ext2.gz.uboot + ramdisk root filesystem image loaded to RAM --) rootfs.yaffs2 + YAFFS2 root filesystem image burned to NAND 2) What's New ------------- --) Add support for new -11 LV SOM and -21 Torpedo platforms: + replace uf1050a 802.11 wireless module with wl127x + replace isp1760 with internal OMAP USB controller/USB3320 PHY + Support new Hynix NAND/DDR PoP + Support 4Gbit Micron w/internal 4-bit ECC NAND/DDR PoP --) Add x-loader/u-boot support to handle new DDR/NAND combinations on -11 and -21 platforms as optional replacement of NoLo/LoLo. --) Add GPIO API interface (/sys/class/gpio) to access GPIO pins not used by kernel as input or output. --) Add spidev support to allow userspace access to SPI devices (see spi-test package source code for an example). 3) General Information ---------------------- Per the Linux 2.1, Rev F Software Test Plan, the following sections have been formally verified for this release: Section 1 - Display Driver (Qtopia excluded) Section 2 - Audio Output Section 3 - Wired Ethernet Section 4 - USB Host Section 5 - Serial UART Section 6 - Compact Flash SEction 7 - MMC/SD Section 8 - Touch Screen (Qtopia excluded) Section 9 - SPI (tested per Jira issues) Section 10 - MTD File System Section 11 - Power Management Section 12 - Wireless Ethernet (also reference Omap35x_linux_wlan_STP.pdf) Section 13 - Bluetooth Section 15 - USB OTG Host/Device Untested sections of the STP mentioned above due to exclusion from this release include: Section 14 - DSPLink Additional verification was performed for new features within their respective issues. See the Omap35x_Linux_2.1_TPL.pdf for more information. 4) Known Issues --------------- --) The wireless connection is not enabled by default. To install the WiFi driver (ont -10 LV SOM platforms with wireless with wl127x), use the command: OMAP-35x# /etc/rc.d/init.d/uf1050a start On -11 LV SOM platform with wl127x use the command: OMAP-35x# cd /home/root/wlan OMAP-35x# ./sta_run Then run the ./wlan_cu command (using the parameters specified in the output of sta_run script). --) OMAP3LINUX-416: Introduction of 4Gbit Micron w/internal 4-bit ECC NAND PoP parts, jffs2 on 4Gbit Micron is unstable; due to only 16 bytes of Out-Of-Band bytes available. YAFFS is known to work on all NAND platforms. --) u-boot introduces a new hwecc method, "nandecc chip" necessary for use on the 4Gbit Micron w/internal 4-bit ECC PoP parts for any data outside of initial x-loader burned into NAND (as internal bootrom requires "nandecc hw" method to read out data with Linux, and "nandecc sw" (or "nandecc chip" for 4Gbit Micron NAND) to read out u-boot image via X-loader from NAND as 2nd stage bootloader). --) LCD touch on Torpedo platform is unstable. Touch returns pen up immediately after initial pen-down. Touch on LV SOM is unaffected. --) To use the OTG Peripheral in host-mode, you MUST use a true OTG cable with a Mini-A connector. Please note that the development kit connector will also accept a Mini-B connector, but that will not properly configure the ID-pin to set the OTG interface in host-mode. Logic tests the interface using a 2m USB OTG cable from Lindy (part #31634 | www.lindy-usa.com). --) OMAP3LINUX-109: Upgrading udev causes mount points to change. Note that SD/MMC, and USB auto-mounted mass-storage devices can be found in /media/*. --) OMAP3LINUX-128: Kernel hangs attempting to connect to DHCP server when ethernet cable is unplugged. --) OMAP3LINUX-132: Cannot invoke suspend state. --) OMAP3LINUX-137 pehci Never Error on unplug of hub --) OMAP3LINUX-257: Audio-playing batch wav (*.wav) files results in variable bitrate issues. --) OMAP3LINUX-274 brf6300 requires a power-cycle between reloads --) OMAP3LINUX-276 Qtopia not included in this release --) OMAP3LINUX-289 Torpedo - UBIFS file system corruption --) OMAP3LINUX-292 Unmount of CF card causes warning messages --) OMAP3LINUX-305 Oops error and hang on unplug of USB Web Camera intermittent --) For Baseboard PN 1013374, J42 jumper must not be present for proper OTG operation --) The OMAP3530-11 SOM-LV and OMAP3530-21 Torpedo hardware can be ordered with a 4Gbit Micron NAND flash device. Unlike prior NAND flash, this device requires 4 bits of ECC to maintain the same level of data integrity as previous 1 bit ECC NAND flash devices. NAND flash requiring 4 and 8 bits of ECC correction has become more common with all NAND flash manufacturers. The YAFFS file system tracks how often each block has required ECC correction using a "strike count." Anytime an ECC correction is done, YAFFS internally garbage collects the block(effectively copying the contenst out to another block then erassing the block and reusing later). When this strike count reaches three, YAFFS marks the block bad not to be used again. This strike count is maintained in RAM, and the count is reset after any power cycle. Issue: The 4Gbit Micron NAND flash device is more susceptible to ECC correction due to the fact that the device requires 4 bit ECC correction instead of the legacy 1 bit ECC NAND flash devices. Because of this, YAFFS will increment the strike count much faster on 4 bit ECC NAND flash devices than, 1 bit ECC NAND flash devices. This results in YAFFS marking blocks as bad at a much higher rate for 4 bit ECC devices than 1 bit ECC devices. It should be noted that YAFFS continues to maintain data integrity. But with prolonged use, the number of blocks available to use for data storage will drop prematurely over the lifetime of the device. Solution: Until a solution is created that determines the number of corrected bits (as the part itself only indicates that some correction was required) to better manage the life expectancy of 4 bit ECC NAND flash devices, Logic PD has devised a work around that can be used to help mitigate the premature retirement of NAND flash blocks. This work around is to allow the user to adjust the strike count limit. Where YAFFS has a fixed value of three strikes causing a block to be marked bad, a user can now modify this limit to any value from 0 (no blocks are retired) to 255. The strike count threshold is made configurable using a mount option to YAFFS as show below(where "" can range from "3" to "255", or "0" to disable block retirement due to excessive ECC correction). If no mount option is used, then a default of 128 for a strike count is used only for the 4Gbit Micron NAND: OMAP-35x# mount -t yaffs -o strikes= /dev/mtdblock3 /mnt/yaffs --) Torpedo battery charging is supported in this release. 5) Dependencies --------------- --) Use LogicLoader (LoLo) version 2.4.13p1 or greater to boot; failure to do so can cause the board to not operate properly --) If replacing NoLo/LoLo with x-loader/u-boot, must use included x-loader-2 binary image. --) This release was tested on OMAP 35x Development kits using the following combinations of System on Modules (SOM) and Baseboards (BB). Modules not listed here may or may not work with this release due to those assemblies being alpha/engineering or custom assemblies: --) + SOMOMAP3530-10-1672IFCR-C + SOM : 1012637 + BB : 1013374 --) + SOMOMAP3530-10-1670EFCR-A + SOM : 1013047 + BB : 1013374 --) + SOMOMAP3503-10-1670HFCR-A + SOM : 1013281 + BB : 1013374 --) + SOMOMAP3530-11-1672IFCR-A + SOM : 1016346 + BB : 1013374 --) + SOMOMAP3530-11-1782JFIR-A + SOM : 1016361 + BB : 1013374 --) + SOMOMAP3530-11-1670EFCR-A + SOM : 1016373 + BB : 1013374 --) + SOMOMAP3503-11-1670HFCR-A + SOM : 1016383 + BB : 1013374 --) + SOMOMAP3530-21-1780AGIR-A + SOM : 1016185 (Torpedo w/new Micron 4-bit ECC) 1016336 + BB : 1014845 --) + SOMOMAP3530-21-1670AGCR-A + SOM : 1016185 (Torpedo w/Hynix) 1016334 + BB : 1014845 --) + SOMOMAP3530-20-1670AGCR-A + SOM : 1013994 (Torpedo w/old Micron 1-bit ECC) + BB : 1014845 Change Log: ----------- --) v1.0 ---- + Initial Release --) v1.1 ---- + Add touch support + Add 12.1" display support + Add default pointer calibrations for 3.6", 4.3", 10.4", 12.1" displays + Add custom LCD display definition via commandline. + Add audio support + Add YAFFS2 support --) v1.4 ---- + Add Compact Flash support + Add Wireless Ethernet support + Can use NOR/NAND as root file system via JFFS2 or YAFFS(2) + I2C support + Backlight on/off support + Moved to newest version of SmSC wired Ethernet driver + Support for 2.6.28-rc8 kernel --) v1.5 ---- + Add Bluetooth support + Add support for Audio mute + Remove auto-loading of WiFi + Add support for revision ES3.1 silicon + Automatically disable Compact Flash interface on ES3.1 hardware --) v1.6.1 ------ + Add support for ISP1760 + Bug fixes + Support for CODEC Engine + Support for USB OTG host-mode + Support for USB OTG device-mode + Ability to load root file system and kernel directly from YAFFS partitions on the device --) v1.7.0 ------ + Add support for Torpedo kit + USB OTG fixes + Update u-boot to 2009.08-rc2 + Update to CodeSourcery 2009q1-203 toolchain + Add support for added external audio mute FETs + Update BusyBox to v1.15.1 + Update codec to v2.24 + Update udev to v117 and have SD/CF/USB storage devices auto-mount under /media + Modify u-boot to use last *two* blocks to hold environment in case one of the blocks is bad. --) v1.7.1 ------ + add support to boot on SOMOMAP3530-10-1670EFCR which do not have Ethernet or NOR flash + Fix SMI reset issue requiring change to LoLo v2.4.10 + Add nand lock/unlock support to u-boot + Add support for new(er) production data ID chips --) v2.0 ------ + Updated kernel to 2.6.32 + Fix RTC to now keep wall clock across reboots + CPU frequency utility usable to change OPP levels + SmartReflex enabled to change voltages on changed OPP levels + Revamp NAND driver to use hardware R/B# line to determine when NAND chip ready to provide data. + Update from DSS to DSS2 video subsystem. As a result, user control of backlight is lost (will be fixed in next release) + Use "hackable" SSH key in dropbear. + Full/proper OTG support, can switch from USB ethernet to USB file storage by changing(via rmmod/modprobe) of g_ether/g_file_storage modules --) v2.1 ------ + Add support for new -11 LV SOM and -21 Torpedo modules: + Add support for new Micron 4-bit ECC NAND/DDR PoP + Add support for Hynix NAND/DDR PoP + Add support for wl127x wireless module + Add x-loader inclusion/support + Add spidev support. + Add GPIO class API support. ----------------------------------------------------------------------------- (c) 2010 Logic Product Development Company, All Rights Reserved.