Release notes for the M52277EVB BSP
Released: Feb. 08, 2010

This is a release of the Freescale Semiconductor M52277EVB Linux BSP. 
The default configurations of this BSP have been tested and all features 
are believed to be functioning correctly except as noted in this 
document.  If you find an issue, please report it to www.freescale.com.

The following hardware is supported:

  MCF52277 processor on the M52277EVB development board.
  For configuration information, please see 
  Help/software/M5227xEVB/User_Manual_M5227xEVB.pdf on the BSP CD image.

=========================================================
SUPPORTED FEATURES IN THIS RELEASE
=========================================================

Processor Features:

    * ColdFire V2 Core at 160MHz
    * Enhanced MAC module
    * 16 KB I/D-Cache
    * 128 KB SRAM
    * Integrated peripherals
          o Three UARTs (Only 2 are supported)
          o DMA Serial Peripheral Interface
          o I2C Bus Interface
          o 16-channel eDMA controller
          o Real Time Clock
          o CANbus support
          o USB
          o 4 Timers
          o LCD
          o SSI
          o Audio
          o Touch Screen
          o 16M on-board flash
          o 2M onboard Serial Flash
          o ADC interface
          o eDMA
          o SD/MMC

Kernel Features:

 - Linux-2.6.29 kernel

u-boot 2009.08

GNU gcc 4.4.1, uclibc 0.9.53, binutils-2.19.51.20090709, and elf2flt.

GDB 6.8.50.20090630

Userspace packages highlights:

     * busybox
     * gdbserver
     * i2c-tools
     * mp3play
     * alsa-lib
     * alsa-utils
     * mtd-utils 
     * nano-X
     * strace
     * touchscreen demos

=============================================================
CFFlasher Information
=============================================================
    This CFFlasher setup procedure will help users reinstall 
the u-boot bootloader.

    Included in this BSP is a u-boot binary needed to restore 
the bootloader firmware.

    You have to use **Windows** to run the CFFlasher software.

1) Install the CFFlasher software.  That code is not included 
   in this BSP and should be downloaded from the Freescale 
   website.

        http://www.freescale.com/coldfire

2) Click on the CFflasher icon and follow the instructions to
   start the software.

3) With target power off, connect a host USB port to the USB
   P&E micro interface - the J25 connector.

4) Select the appropriate "Target Config" settings.

5) Select the "Program" option and navigate to the
   /images/M5227xEVB/u-boot.bin file or to a user built
   bootloader in <ltib>/rootfs/boot/u-boot.bin.  After
   selecting the "Program" button, a progess bar should be
   displayed on the screen.

6) Power down and remove the cable.  When you power on the 
   board again the u-boot headers and prompt should be 
   displayed on a terminal set to 115200 8N1.

7) Follow the u-boot setup procedures in the User's Manual.

=============================================================
KNOWN ISSUES
=============================================================

Audio-Video
-----------
1) Audio and video device drivers cannot operate at the same
   time.  Two kernels have been installed in flash.  The
   video kernel is at location 0x40000 and the audio kernel
   is at location 0x340000.  J5 and J6 must be reconfigured
   to switch between audio and video systems.

RTC
---
2) With the initial release of the MCF5227x silicon the RTC
   registers HOURMIN, SECONDS, and DAYS are reset during power
   up; therefore the time and date information is lost after
   a reset.

System limitations:
-------------------
3) There is a limited amount of RAM (64M) available on this
   system.  Running memory intensive programs repeatedly will
   likely fragment the memory resources available.  Care must
   be exersized when writing programs or scripts for this
   platform.  Allocating large chunks of memory (>1M) should
   be avoided.  If you do allocate large amounts of memory
   try to avoid repeated allocations/de-allocations.

4) Processes involving large files may fail and cause a 
   kernel core dump.  This has to do with the memory 
   fragmentation issue.  If you see a kernel core dump
   message that includes something similar to the following 
   line:
   ...
   Allocation of length 559231 from process 357 failed DMA per-cpu:
   ...

   The memory is fragmented and cannot be recovered.  Review 
   the existing system and try to limit processes and reduce
   the system size by disabling unused device drivers and
   packages.

UART
----
5) UART0 is the default console.  UART1 can be setup to use as
   a termianl after booting, but it cannot be used as a boot
   console to display kernel boot messages.