blob: eedebc9020c6e0479e5795bd8fca3c39847b0be0 [file] [log] [blame]
FREERTOS COLDFIRE MCF523x PORT with lwIP
REQUIREMENTS
============
The FreeRTOS port is designed for the MCF523x processor where the hardware
dependent part consists of the CPU and the peripherals used in this port.
This includes a programmable timer (PIT) for the preemptive scheduler
and a UART for the demo application. The Coldfire specific part includes
the number and type of processor registers, the stack frame layout and
the usage of a software interrupt (trap) for the yield call.
The development environment used is based on the GNU C Compiler for
a m68k-elf target as well as the insight debugger with some patches for
the BDM interface[1]. GDB startup and linker scripts are supplied with
the demo for the M5235BCC evaluation kit from Freescale.
[1] ... BDM tools: http://sourceforge.net/projects/bdm/
USAGE
=====
A makefile is supplied with the demo application and a binary can be
produced by calling 'make all'. A special target 'debug' is provided
which executes the insight debugger. At the insight debugger prompt
one should select the appropriate target interface (either BDM/Direct
or BDM/TCP) and should download the application to the development
board. It is important that the GDB script setup-and-load is executed
prior to downloading to initialize the SDRAM. After downloading one
should call the GDB function 'execute' and the PC is set to the start
of the executable. Execution can be started by typing 'continue' at
the Insight console interface.
After this startup phase the insight debugger should work as usual, i.e.
no grayed out buttons, ...
COMMON PROBLEMS
===============
Most of the problems have their origin in the startup scripts. The
following list should serve as a checklist where each point must be
satisfied for the port to work.
- The FreeRTOS port only works correctly in the supervisor mode. There-
fore the Coldfire CPU must run in the supervisor mode.
- portVECTOR_TABLE does not point to the currently active vector table.
Please also note that the vector table must be in RAM such that the
FreeRTOS port can install a traphandler for the portYIELD() call.
$Id: README.txt,v 1.1 2006/08/29 02:24:03 wolti Exp $
MCF5235 + lwIP port - Copyright (c) 2006 Christian Walter.