-------------------------------------------------------------------------------- - Logic iMX31 SOM-LV Windows Embedded CE 6.0 port - - - - Source drop - 1.0.0 - - - - Release Notes - - - - Logic, June 2009 - -------------------------------------------------------------------------------- This file contains information pertaining to the usage of Logic's Windows Embedded CE 6.0 port on the iMX31 SOM-LV platform. It provides information on the contents of the enclosed .zip file. PLATFORM REQUIREMENTS -------------------------------------------------------------------------------- + The Logic iMX31 BSP for Windows Embedded CE 6.0 requires that Microsoft Visual Studio 2005 be installed on the development workstation with Microsoft Visual Studio 2005 Team Suite Service Pack 1. For developers running Vista operating system, Visual Studio 2005 Service Pack 1 Update for Windows Vista must also be installed to improve performance and stability. Ensure that the following updates for Windows CE 6.0 development have been applied before working with the Logic OMAP35x BSP: - Windows Embedded CE 6.0 Platform Builder Service Pack 1 - Windows Embedded CE 6.0 R2 - Windows Embedded CE 6.0 2008 Yearly Update Rollup Package - Windows Embedded CE 6.0 2009 Monthly Updates NOTE: This release has been tested with QFEs through April 2009. PACKAGE CONTENTS -------------------------------------------------------------------------------- + \binary_images This folder contains pre-built OS images based on OS Designs also included with this package. The differences are listed below. - dev_image/NK.bin Release build of the lpd_imx31_dev osdesign. Contains most peripheral drivers, and very little extras. No Media Player, Internet Explorer, etc. For applicaiton development, ActiveSync over USB Function (OTG) or using active Ethernet connection to connect the Visual Studio tools. Contains most application support components. - show_image/NK.bin Release build of lpd_imx31_show osdesign. Contains all of the bells and whistles, including mutlimedia support and internet explorer. A very large image, most components are included. - quick_boot_image/NK.bin Release build of lpd_imx31_quickboot osdesign. This is meant to be a small binary image that boots into a custom shell application. The custom shell also accesses a GPIO that controls GPIO0 LED on the development kit. - LogicLoader_Scripts/ Contains example scripts for loading and launching the binary NK.bin files. + load_from_nand_script.txt Mounts YAFFS partition and loads NK.bin from YAFFS. + load_from_sd_script.txt Mounts SD card and loads NK.bin from SD. + LoLo_bootme_192.168.0.154_NET Sets up static IP address, sends bootme packet to Platform Builder/VS2005, and loads NK.bin from Platform Builder. + LoLo_bootme_dhcp_NET Sets up DHCP address, sends bootme packet to Platform Builder/VS2005, and loads NK.bin from Platform Builder. + WinCE_Launch_LCD-x.x-xxxx-xx_ram_boot_script.losh Command to run after NK.bin is loaded to launch OS, sets up specific display kit before launching into OS. + \Documentation This folder contains documents describing the operation and use of the driver components built into the OS design. + \OSDesigns - lpd_imx31_show This folder contains the OSDesign for the 'Show' image. This contains a lot of things, including media and internet explorer, plus all application support. - lpd_imx31_dev This folder contains the OSDesign for the 'Dev' image. This is a good starting point for the entire driver set and necessary components. It also includes most applicaiton support components. - lpd_imx31_smallfootprint This folder contains the OSDesign for the 'Tiny' image. The starting point for building the simplest image that can be built for this platform. - lpd_imx31_quickboot This folder contains the OSDesign for the 'quick boot' image. This is a very simple and slimmed down OSDesign, showing how to add a custom shell (included as a subproject), how to slim down the OS, and how to access GPIO by the custom shell application talking to the GPIO driver. + \PLATFORM\LPD_iMX31 This folder contains the iMX27 SOM-LV platform specific port of the Windows CE 6.0 operating system. Will go to (\WINCE600\PLATFORM\LPD_iMX31) + \COMMON\SRC\SOC\MX31_LPD_V1 This folder contains the iMX31 SOM-LV chip specific port of the Windows CE 6.0 operating system. Will go to (\WINCE600\PLATFORM\COMMON\SRC\SOC\MX31_LPD_V1) + \SDK This folder contains an example SDK, built from the lpd_imx31_dev OSDesign. It is recommended to build a specific SDK based on the specific OSDesign created for an end-product. BASIC USER GUIDE -------------------------------------------------------------------------------- 1) Install VS2005, Windows CE 6.0, and all appropriate updates from Microsoft's WIndows CE 6.0 updates page. Make sure to install for ARM. 2) Move \WINCE600\PLATFORM\LPD_iMX31 to X:\WINCE600\PLATFORM\LPD_iMX31 (X: being Windows CE install drive) 3) Move \WINCE600\PLATFORM\COMMON\SRC\SOC\MX31_LPD_V1 to X:\WINCE600\PLATFORM\COMMON\SRC\SOC\MX31_LPD_V1 (X: being Windows CE install drive) 4) Move all folders in \WINCE600\OSDesigns\ to X:\WINCE600\OSDesigns\ (X: being Windows CE install drive) 5) Open one of the OSDesign solutions in VS2005/Platform Builder or create a new OSDesign using the LPD_iMX31 BSP. 6) Use LogicLoader 'bootme' to connect to VS2005 (set up Target) and download NK.bin. 7) Use proper LogicLoader boot script to launch into Windows CE once downloaded. exec dbg_serial:IMX31_UART:rtc:rtc_imx31_pmic:dbg_leds:1:disp_num:5: - 6.4" display, debug serial, rtc in PMIC, debug LED exec rtc:rtc_imx31_pmic:dbg_leds:1:disp_num:5:kitl:true: - 6.4" display, debug ethernet, rtc in PMIC, debug LED SUPPORTED DRIVERS AND FEATURES -------------------------------------------------------------------------------- + Basic kernel functionality - Interrupts, 1ms system timer - Shared access to PMIC chip, I2C interface, and GPIO - Performance counter supported - Boot Parameters (Can be passed by LogicLoader) - Debug Serial (enabled via boot parameter dbg_serial:IMX31_UART: ) - Activity LED (SDK D4 LED) (enabled via boot parameter dbg_leds:1: ) - Real Time Clock - PMIC RTC (enabled via boot parameter rtc:rtc_imx31_pmic: ) - Real Time Clock - iMX31 RTC (enabled via boot parameter rtc:rtc_imx31:) - Suspend/Resume + KITL (Enabled with Boot Parameters kitl:true: ) - Debugging with break points - Remote Tools + PMCICA (CF Card) - CF card support + Display driver - Supports Logic's 3.6", 4.3", 6.4" and 12.1" displays - Support pre-init of custom displays in LogicLoader (skiplcdcinit:1 boot parameter) + Ethernet NDIS driver - Boot-time and run-time cable detection - 10/100 MB/s full/half duplex modes supported - Auto negotiation support. - Static IP and DHCP address support + SDIO driver - Boot-time and run-time card detection - DMA supported read and write transfers - Only SD Memory cards have been tested at this time - SD1 and SD2 Supported (SD1 is SDK SD connector) - SD2 has not been verified. + Touch driver - System wake-up capability + UART driver - Supports 5, 6, 7, 8N1 with standard baud rates up to and including 115200b/s. + Audio Driver - Supports audio playback through audio jack on the base board. - Supports audio record through audio jack on base board. + USB Host Driver - Supports Human Interface Devices (HID) e.g. Mouse, Keyboard. - Supports Mass Storage Devices + USB OTG function Driver - Can function as an ActiveSync device - Can function as a mass storage device + USB OTG Host Driver - Supports HID devices - Supports mass storage devices + YAFFS NAND Driver (File System) - Supports YAFFS file system on the onboard NAND Flash. + I2C Driver - Supports I2C1 and I2C2 + Backlight Driver - Controls LCD_BACKLIGHT_PWR signal - PWM not supported + Battery Driver - MC13783 Battery Support - Not Tested at this time + General Purpose Timer Driver - Supports GPT + Power Button Driver - Example driver for Swith S2 on iMX31 SDK Baseboard KNOWN ISSUES -------------------------------------------------------------------------------- + KITL Auto Negotiation If auto negotiation is not supported on the network to which KITL tries to connect, KITL will fail connecting. In current release, auto negotiation must be available for KITL to work. + Only SD Memory cards have been tested, no SD I/O cards have been tested. HOW TO -------------------------------------------------------------------------------- + How to enable debug messages The debug serial port can be used for debug messages. This can be enabled by using the following boot parameter when launching (exec) the OS image in LogicLoader. The Serial Driver will not load an instance for UARTA, since it is being used for debug serial. losh> exec dbg_serial:IMX31_UART: + How to enable KITL - Open Project-> properties window - Select active configuration from drop-down box - Under Configuration Properties->Build Options - check "Enable Kernel debugger" - check "Enable KITL" - Use the following boot parameter when launching (exec) the OS image in LogicLoader. - Use the following two boot parameters for enabling KITL and using the shared ethernet driver (VMINI). losh> exec kitl:true losh> exec kitl:true:share_eth:1 + How to disable KITL - Do not use the 'kitl:true' boot parameter or set it to 'kitl:false'. + How to enable the activity LED - Use the 'dbg_leds:1:' boot parameter losh> exec dbg_leds:1: + How to enable the RTC - Use the 'rtc:rtc_imx31_pmic' boot parameter losh> exec rtc:rtc_imx31_pmic: + How to change LCD mode at boot - Use the 'disp_num:x' boot parameter, as shown below. The example used mode 5, which is the 6.4" display kit. losh> exec disp_num:5: + How to shorten delay between removal of removable storage device and icon disappearance in Explorer window - adjust the following registry entries in platform.reg. The values shown here are recommended values only. [HKEY_LOCAL_MACHINE\System\StorageManager] "PNPUnloadDelay"=dword:3E8 ; 0.5s - default: dword:1000 (4096ms) "PNPWaitIODelay"=dword:1F4 ; 1.0s - default: dword:1000 (4096ms) + How to enable/disable drivers Setting the a driver catalog items sets the appropriate environment variables or check component in catalog. The drivers' catalog items can be found under: Third Party\BSP\LogicPD iMX31 LVSOM:ARMV4I\Device Drivers\ REVISION HISTORY -------------------------------------------------------------------------------- - [Logic Issue #] - Description -------------------------------------------------------------------------------- + Version 1.0.0 - 5/8/09 - SVN Revision:7221 - [MX31WCE600-50] - Added ARM VFP Floating Point Driver to BSP - [MX31WCE600-49] - Fixed Ethernet lock-up with heavy traffic - [MX31WCE600-30] - Fixed issue with most video files not able to play in Media Player - [MX31WCE600-37] - Fixed OTG driver catalog entries - [MX31WCE600-39] - Fixed PMIC RTC reset issue - [MX31WCE600-33] - Fixed Power button drive coming back from suspend right away - [MX31WCE600-40] - Fixed Serial Driver loading on top of Debug Serial - [MX31WCE600-48] - Added 'MonoAdder' registry entry to Audio driver. - n/a - Verified USB OTG Host support (HID devices, memory, hub) + Version 0.2.0 - 2/11/09 - SVN Revision:6320 - Internal Release - CETK has not been run - [MX31WCE600-34] - Fixed Suspend/Resume issue (Note: Power Button driver still has debounce issue) - [MX31WCE600-28] - Add UART4/UART5 registry support. (Need to set BSP variable for use) - [MX31WCE600-35] - Cleaned up Debug Output from OAL - [MX31WCE600-32] - Updated the PMIC ONxB Signal Thread Handlers, same as CE 5.0 BSP now. + ON1B - PWR_ON signal -> Code stub + ON2B - nSUSPEND signal -> Puts system into Suspend, can wake system + ON3B - nSTANDBY signal -> Code stub + Version 0.1.0 - 2/10/09 - SVN Revision:6290 - Internal Release - CETK has not been run - Added CF Driver Support - Added Ethernet NDIS driver Support - Fixed Display initialization issue, when skiplcdcinit:1 is used. - Change OAL to use same clock settings as LogicLoader (allows default 399 MHz) - Fixed Touch Pen-Down issue - Fixed KITL being always enabled + Version 0.0.1 - 2/3/09 - SVN Revision:6185 - Initial internal Release - CETK has not been run REVISION INFORMATION -------------------------------------------------------------------------------- + The files used to generate this release were checked out of SVN at revision: 7221 -------------------------------------------------------------------------------- (c) 2009, Logic Product Development Company. All Rights Reserved