Demo/MB91460_Softune/readme.txt - third_party/github/FreeRTOS/FreeRTOS-Kernel - Git at Google


 ==========================================================================
                    Template Project for MB91F467D
 ==========================================================================
                    Fujitsu Microelectronics Europe GmbH
                  http://emea.fujitsu.com/microelectronics

 The  following  software  is for  demonstration  purposes only.  It is not
 fully  tested, nor validated  in  order  to fullfill  its task  under  all
 circumstances.  Therefore,  this software  or  any part of it must only be
 used in an evaluation laboratory environment.
 This software is subject to  the rules of our standard DISCLAIMER, that is
 delivered  with  our  SW-tools  on  the  Fujitsu  Microcontrollers CD /DVD
 (V3.4 or higher "\START.HTM").
 ==========================================================================

 History
 Date        Ver     Author  Softune     Description
 2007-11-12  1.0     MPi     V60L06		original version
 2007-11-12  1.1     MPi     V60L06		Changed the version for consistency
 										with SVN
 2007-11-23  1.2     MPi     V60L06		Seperated Watchdog functionality
 										added watchdog.c and watchdog.h
 2007-12-13  1.3     MPi     V60L06		Tested with the FreeRTOS version 4.6.1.
 2007-12-13  1.4     MPi     V60L06		Tested with the FreeRTOS version 4.7.0.
 2007-01-07  1.5     MPi     V60L06		Removed watchdog.c, watchdog.h, port.c
 										and portmacro.h from directory
 										\FreeRTOS_Port_FR\91467d_FreeRTOS\SRC
 2007-01-18  1.6     MPi     V60L06		Tested with monitor debugger
 ==========================================================================
 1.0.
 This is a project is to test the FreeRTOS port for FR (91467D) and the demo
 application which runs on SK-91F467-Felxray V1.1.

 1.1.
 This FreeRTOS port uses the Task Stack pointed by User Stack pointer (USP) for
 tasks and the system stack pointed by System Stack pointer (SSP) for everything
 else.

 1.2.
 In this port, the functionality is added to initialize and clear the watchdog in
 the dedicated task, Tick Hook or the Idle Hook. The place exactly where the
 watchdog can be cleared can be configured. Though Idle Hook is not an approproiate
 place to clear the watchdog, its done here for demonstration purpose only.

 Also from Main function vTaskStartScheduler() function is called instead of
 xPortStartScheduler(). After doing this change now no more IDLE task is required
 to be added seperately as vTaskStartScheduler() adds prvIdleTask() on its own.

 The System Stack required by each of the RLT0 and Delayed Interrupt ISR is around 100
 bytes. This is considering no interrupts has higher priority than the RLT0 and Delayed
 interrupt (23). If an application has interrupt whose priority is higher than these
 interrupts, which is very likely, then for each such interrupt the user has to increase
 the stack size at least by 50 bytes, though this is not an optimum figure and very well
 depends upon the application.
 Hence though the STACK_SYS_SIZE is defined as 2000, its optimum value would be very well
 dependent on the application where the port would be used.

 1.3.
 Tested with the FreeRTOS version 4.6.1.

 Changed portBYTE_ALIGNMENT to 4 from 1.

 Added portYIELDFromISR() which uses delayed interrupt. This macro needs to be used from the
 application ISRs in order to force a context switch from them if required. It should be noted
 that the interrupt priority of such application ISRs MUST be always higher than the dealyed
 interrupt (currently 23) in order to perform the context switch correctly.

 It should be also noted that the RLT0 and Delayed Interrupt priority MUST be always same in order
 to assure correct working of this port.

 Now portYIELD() used software interrupt INT #40H instead of delayed interrupt.

 Now all the queue functions works ok.

 Tested with the heap_1.c, heap_2.c and heap_3.c.

 Added the __STD_LIB_sbrk.c file in order to define the *sbrk() function. This is required while using
 heap_3.c file which uses the dynamic memory allocation.

 Made changes to the demo application files crflash.c and crhook.c. Please refer those file
 and grep for "Added by MPi" to find the changes.

 Added taskutility.c file. This file contains vUART4Task() which calls vTaskList() and vTaskStartTrace()
 functions.

 If vCreateBlockTimeTasks() is not called then the LED at PDR25_D7 blinks at normal rate (3s).

 1.4.
 Tested with the FreeRTOS version 4.6.1.

 At one time, either of heap_1.c or heap_2.c or heap_3.c needs to be used. Hence the files those are not
 required to be used should be removed from the target of the build.

 1.5.
 Removed watchdog.c, watchdog.h, port.c and portmacro.h from directory \FreeRTOS_Port_FR\91467d_FreeRTOS\SRC,
 since they are moved to folders watchdog and port respectively.

 1.6.
 It should be noted that the readme, appnote and SVN tag version numbers may be different for the same release.

 Used relative path to include files instead of absolute.

 Created config, MemMang, serial and utility subdirectories and moved corresponding functionlaity there.

 Updated taskuitlity.c, vectors.c in oredr to use UART 5 instead of UART 4

 Updated flash.c to increase LEDs to 4 from 3.

 Clock settings:
 ---------------
 Crystal:  4 MHz
 CPU:     64 MHz
 CLKP:    16 MHz

	==========================================================================
	Template Project for MB91F467D
	==========================================================================
	Fujitsu Microelectronics Europe GmbH
	http://emea.fujitsu.com/microelectronics

	The following software is for demonstration purposes only. It is not
	fully tested, nor validated in order to fullfill its task under all
	circumstances. Therefore, this software or any part of it must only be
	used in an evaluation laboratory environment.
	This software is subject to the rules of our standard DISCLAIMER, that is
	delivered with our SW-tools on the Fujitsu Microcontrollers CD /DVD
	(V3.4 or higher "\START.HTM").
	==========================================================================

	History
	Date Ver Author Softune Description
	2007-11-12 1.0 MPi V60L06 original version
	2007-11-12 1.1 MPi V60L06 Changed the version for consistency
	with SVN
	2007-11-23 1.2 MPi V60L06 Seperated Watchdog functionality
	added watchdog.c and watchdog.h
	2007-12-13 1.3 MPi V60L06 Tested with the FreeRTOS version 4.6.1.
	2007-12-13 1.4 MPi V60L06 Tested with the FreeRTOS version 4.7.0.
	2007-01-07 1.5 MPi V60L06 Removed watchdog.c, watchdog.h, port.c
	and portmacro.h from directory
	\FreeRTOS_Port_FR\91467d_FreeRTOS\SRC
	2007-01-18 1.6 MPi V60L06 Tested with monitor debugger
	==========================================================================
	1.0.
	This is a project is to test the FreeRTOS port for FR (91467D) and the demo
	application which runs on SK-91F467-Felxray V1.1.

	1.1.
	This FreeRTOS port uses the Task Stack pointed by User Stack pointer (USP) for
	tasks and the system stack pointed by System Stack pointer (SSP) for everything
	else.

	1.2.
	In this port, the functionality is added to initialize and clear the watchdog in
	the dedicated task, Tick Hook or the Idle Hook. The place exactly where the
	watchdog can be cleared can be configured. Though Idle Hook is not an approproiate
	place to clear the watchdog, its done here for demonstration purpose only.

	Also from Main function vTaskStartScheduler() function is called instead of
	xPortStartScheduler(). After doing this change now no more IDLE task is required
	to be added seperately as vTaskStartScheduler() adds prvIdleTask() on its own.

	The System Stack required by each of the RLT0 and Delayed Interrupt ISR is around 100
	bytes. This is considering no interrupts has higher priority than the RLT0 and Delayed
	interrupt (23). If an application has interrupt whose priority is higher than these
	interrupts, which is very likely, then for each such interrupt the user has to increase
	the stack size at least by 50 bytes, though this is not an optimum figure and very well
	depends upon the application.
	Hence though the STACK_SYS_SIZE is defined as 2000, its optimum value would be very well
	dependent on the application where the port would be used.

	1.3.
	Tested with the FreeRTOS version 4.6.1.

	Changed portBYTE_ALIGNMENT to 4 from 1.

	Added portYIELDFromISR() which uses delayed interrupt. This macro needs to be used from the
	application ISRs in order to force a context switch from them if required. It should be noted
	that the interrupt priority of such application ISRs MUST be always higher than the dealyed
	interrupt (currently 23) in order to perform the context switch correctly.

	It should be also noted that the RLT0 and Delayed Interrupt priority MUST be always same in order
	to assure correct working of this port.

	Now portYIELD() used software interrupt INT #40H instead of delayed interrupt.

	Now all the queue functions works ok.

	Tested with the heap_1.c, heap_2.c and heap_3.c.

	Added the __STD_LIB_sbrk.c file in order to define the *sbrk() function. This is required while using
	heap_3.c file which uses the dynamic memory allocation.

	Made changes to the demo application files crflash.c and crhook.c. Please refer those file
	and grep for "Added by MPi" to find the changes.

	Added taskutility.c file. This file contains vUART4Task() which calls vTaskList() and vTaskStartTrace()
	functions.

	If vCreateBlockTimeTasks() is not called then the LED at PDR25_D7 blinks at normal rate (3s).

	1.4.
	Tested with the FreeRTOS version 4.6.1.

	At one time, either of heap_1.c or heap_2.c or heap_3.c needs to be used. Hence the files those are not
	required to be used should be removed from the target of the build.

	1.5.
	Removed watchdog.c, watchdog.h, port.c and portmacro.h from directory \FreeRTOS_Port_FR\91467d_FreeRTOS\SRC,
	since they are moved to folders watchdog and port respectively.

	1.6.
	It should be noted that the readme, appnote and SVN tag version numbers may be different for the same release.

	Used relative path to include files instead of absolute.

	Created config, MemMang, serial and utility subdirectories and moved corresponding functionlaity there.

	Updated taskuitlity.c, vectors.c in oredr to use UART 5 instead of UART 4

	Updated flash.c to increase LEDs to 4 from 3.

	Clock settings:
	---------------
	Crystal: 4 MHz
	CPU: 64 MHz
	CLKP: 16 MHz