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.