<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>change log for rtems (2011-05-23)</title>
</head>
<body text='#000000' bgcolor='#ffffff'>
<a name='cs1'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
<font color='#bb2222'><strong>joel</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2011-05-23 Marta Rybczynska <marta.rybczynska@kalray.eu>
PR 1805/cpukit
* sapi/include/confdefs.h: Currently unified areas are defined
per-application. For some memory constrained and/or very dynamic
environments (BSPs), it may be better to have per-BSP default value.
This patch introduces such option. The default behaviour is left
unchanged.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/ChangeLog.diff?r1=text&tr1=1.2843&r2=text&tr2=1.2844&diff_format=h">M</a></td><td width='1%'>1.2844</td><td width='100%'>cpukit/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/sapi/include/confdefs.h.diff?r1=text&tr1=1.166&r2=text&tr2=1.167&diff_format=h">M</a></td><td width='1%'>1.167</td><td width='100%'>cpukit/sapi/include/confdefs.h</td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/cpukit/ChangeLog:1.2843 rtems/cpukit/ChangeLog:1.2844
--- rtems/cpukit/ChangeLog:1.2843 Mon May 23 09:55:58 2011
+++ rtems/cpukit/ChangeLog Mon May 23 11:06:22 2011
</font><font color='#997700'>@@ -1,3 +1,12 @@
</font><font color='#000088'>+2011-05-23 Marta Rybczynska <marta.rybczynska@kalray.eu>
+
+ PR 1805/cpukit
+ * sapi/include/confdefs.h: Currently unified areas are defined
+ per-application. For some memory constrained and/or very dynamic
+ environments (BSPs), it may be better to have per-BSP default value.
+ This patch introduces such option. The default behaviour is left
+ unchanged.
+
</font> 2011-05-23 Joel Sherrill <joel.sherrilL@OARcorp.com>
PR 1804/cpukit
<font color='#006600'>diff -u rtems/cpukit/sapi/include/confdefs.h:1.166 rtems/cpukit/sapi/include/confdefs.h:1.167
--- rtems/cpukit/sapi/include/confdefs.h:1.166 Mon May 23 09:55:58 2011
+++ rtems/cpukit/sapi/include/confdefs.h Mon May 23 11:06:23 2011
</font><font color='#997700'>@@ -798,6 +798,12 @@
</font> * combined provided one larger memory pool. This is particularly
* useful in combination with the unlimited objects configuration.
*/
<font color='#000088'>+ #ifdef BSP_DEFAULT_UNIFIED_WORK_AREAS
+ #ifndef CONFIGURE_UNIFIED_WORK_AREAS
+ #define CONFIGURE_UNIFIED_WORK_AREAS
+ #endif
+ #endif
+<span style="background-color: #FF0000"> </span>
</font> #ifdef CONFIGURE_UNIFIED_WORK_AREAS
#include <rtems/score/wkspace.h>
Heap_Control *RTEMS_Malloc_Heap = &_Workspace_Area;
</pre>
<p> </p>
<a name='cs2'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
<font color='#bb2222'><strong>joel</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2011-05-23 Joel Sherrill <joel.sherrilL@OARcorp.com>
* bsp_howto/support.t: Add section describing configuration macros
which may be defined at the BSP level to alter defaults in
rtems/confdefs.h.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/ChangeLog.diff?r1=text&tr1=1.310&r2=text&tr2=1.311&diff_format=h">M</a></td><td width='1%'>1.311</td><td width='100%'>doc/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/doc/bsp_howto/support.t.diff?r1=text&tr1=1.7&r2=text&tr2=1.8&diff_format=h">M</a></td><td width='1%'>1.8</td><td width='100%'>doc/bsp_howto/support.t</td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/doc/ChangeLog:1.310 rtems/doc/ChangeLog:1.311
--- rtems/doc/ChangeLog:1.310 Thu May 19 10:40:42 2011
+++ rtems/doc/ChangeLog Mon May 23 11:07:35 2011
</font><font color='#997700'>@@ -1,3 +1,9 @@
</font><font color='#000088'>+2011-05-23 Joel Sherrill <joel.sherrilL@OARcorp.com>
+
+ * bsp_howto/support.t: Add section describing configuration macros
+ which may be defined at the BSP level to alter defaults in
+ rtems/confdefs.h.
+
</font> 2011-05-19 Gedare Bloom <giddyup44@yahoo.com>
* user/conf.t: Fix typos.
<font color='#006600'>diff -u rtems/doc/bsp_howto/support.t:1.7 rtems/doc/bsp_howto/support.t:1.8
--- rtems/doc/bsp_howto/support.t:1.7 Wed Oct 14 08:08:39 2009
+++ rtems/doc/bsp_howto/support.t Mon May 23 11:07:35 2011
</font><font color='#997700'>@@ -34,11 +34,11 @@
</font> @end group
@end example
<font color='#880000'>-The first section of this file renames the built-in definition of<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+The first section of this file renames the built-in definition of
</font> some specification variables so they can be augmented without
embedded their original definition. The subsequent sections
specify what behavior is expected when the @code{-qrtems} or
<font color='#880000'>-@code{-qrtems_debug} option is specified.<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+@code{-qrtems_debug} option is specified.
</font>
The @code{*startfile} section specifies that the BSP specific file
@code{start.o} will be used instead of @code{crt0.o}. In addition,
<font color='#997700'>@@ -61,7 +61,7 @@
</font> describes the board and its hardware configuration, provides vendor
information, local configuration information, information on downloading
code to the board, debugging, etc.. The intent of this
<font color='#880000'>-file is to help someone begin to use the BSP faster.<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+file is to help someone begin to use the BSP faster.
</font>
A @code{README} file in a BSP subdirectory typically explains something
about the contents of that subdirectory in greater detail. For example,
<font color='#997700'>@@ -98,10 +98,10 @@
</font>
@section bsp.h Include File
<font color='#880000'>-The file @code{include/bsp.h} contains prototypes and definitions<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+The file @code{include/bsp.h} contains prototypes and definitions
</font> specific to this board. Every BSP is required to provide a @code{bsp.h}.
The best approach to writing a @code{bsp.h} is copying an existing one
<font color='#880000'>-as a starting point.<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+as a starting point.
</font>
Many @code{bsp.h} files provide prototypes of variables defined
in the linker script (@code{linkcmds}).
<font color='#997700'>@@ -113,7 +113,7 @@
</font> @itemize @bullet
@item @code{MUST_WAIT_FOR_INTERRUPT} - modifies behavior of @code{tm27}.
<font color='#880000'>-@item @code{Install_tm27_vector} - installs the interrupt service<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+@item @code{Install_tm27_vector} - installs the interrupt service
</font> routine for the Interrupt Benchmark Test (@code{tm27}).
@item @code{Cause_tm27_intr} - generates the interrupt source
<font color='#997700'>@@ -179,6 +179,7 @@
</font> BSP's Pretasking Hook but now the BSP Boot Card Framework can perform
this operation.
<font color='#000088'>+@findex CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
</font> If your BSP does not want to support dynamic heap extension, then you do not have to do anything special. However, if you want to support @code{sbrk}, you must provide an implementation of this method and define @code{CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK} in @code{bsp.h}. This informs @code{rtems/confdefs.h} to configure the Malloc Family Extensions which support @code{sbrk}.
@section bsp_cleanup() - Cleanup the Hardware
<font color='#997700'>@@ -201,6 +202,43 @@
</font> using the boards in a development environment and may be disabled for
production use.
<font color='#000088'>+@section Configuration Macros
+
+Each BSP can define macros in bsp.h which alter some of the the default configuration parameters in @code{rtems/confdefs.h}. This section describes those macros:
+
+@itemize @bullet
+
+@findex CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
+@item @code{CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK} must be defined if the
+BSP has proper support for @code{sbrk}. This is discussed in more detail
+in the previous section.
+
+@findex BSP_IDLE_TASK_BODY
+@item @code{BSP_IDLE_TASK_BODY} may be defined to the entry point of a
+BSP specific IDLE thread implementation. This may be overridden if the
+application provides its own IDLE task implementation.
+
+@findex BSP_IDLE_TASK_STACK_SIZE
+@item @code{BSP_IDLE_TASK_STACK_SIZE} may be defined to the desired
+default stack size for the IDLE task as recommended when using this BSP.
+
+@findex BSP_INTERRUPT_STACK_SIZE
+@item @code{BSP_INTERRUPT_STACK_SIZE} may be defined to the desired default interrupt stack size as recommended when using this BSP. This is sometimes required when the BSP developer has knowledge of stack intensive interrupt handlers.
+
+@findex BSP_ZERO_WORKSPACE_AUTOMATICALLY
+@item @code{BSP_ZERO_WORKSPACE_AUTOMATICALLY} is defined when the BSP
+requires that RTEMS zero out the RTEMS C Program Heap at initialization.
+If the memory is already zeroed out by a test sequence or boot ROM,
+then the boot time can be reduced by not zeroing memory twice.
+
+@findex BSP_DEFAULT_UNIFIED_WORK_AREAS
+@item @code{BSP_DEFAULT_UNIFIED_WORK_AREAS} is defined when the BSP
+recommends that the unified work areas configuration should always
+be used. This is desirable when the BSP is known to always have very
+little RAM and thus saving memory by any means is desirable.
+
+@end itemize
+
</font> @section set_vector() - Install an Interrupt Vector
On targets with Simple Vectored Interrupts, the BSP must provide
<font color='#997700'>@@ -222,8 +260,8 @@
</font> rtems_isr_entry handler, /* isr routine */
rtems_vector_number vector, /* vector number */
int type /* RTEMS or RAW intr */
<font color='#880000'>-)<span style="background-color: #FF0000"> </span>
-@{<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+)
+@{
</font> if the type is RAW
install the raw vector
else
</pre>
<p> </p>
<p>--<br />
<small>Generated by <a href="http://www.codewiz.org/projects/index.html#loginfo">Deluxe Loginfo</a> 2.122 by Bernardo Innocenti <bernie@develer.com></small></p>
</body>
</html>