RTOS/rtems
1
0
Fork 0
forked from Imagelibrary/rtems
Code Pull Requests Activity

Merged bsp structure into target dependent files chapter.

Browse Source
This commit is contained in:
Joel Sherrill
1998-10-15 21:18:24 +00:00
parent 0a5e510c6d
commit 7595ae6749
2 changed files with 64 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

67
doc/bsp_howto/target.t
View File

@@ -6,9 +6,9 @@
@c $Id$
@c
@chapter Target Dependent and Board Dependent Files
@chapter CPU and Board Dependent Files
RTEMS divides board dependencies into two parts :
RTEMS divides board dependencies into two parts:
@itemize @bullet
@@ -22,7 +22,6 @@ descriptions of each needed CPU dependant function.
@item the board dependant code : it includes support for a given board,
such as the board initialization code and drivers for the various devices:
@end itemize
Porting RTEMS on a new board should raise two questions:
@@ -39,3 +38,65 @@ If the main board CPU is supported, you will only have do write the Board
Support Package. Otherwise you'll have to write both CPU dependant code
and the BSP. One should always start writing a BSP from a similar one.
@section CPU Dependent Executive Files
XXX
@section CPU Dependent Support Files
XXX
@section Board Support Package Structure
The BSPs are kept in the $RTEMS_ROOT/c/src/lib/libbsp directory. They
are filed under the processor family (m68k, powerpc, etc.). A given BSP
consists in the following directories:
@itemize @bullet
@item @b{clock} -
support for the realtime clock, which provides a regular
time basis to the kernel,
@item @b{console} -
rather the serial driver than only a console driver, it
deals with the board UARTs (i.e. serial devices),
@item @b{include} -
the include files,
@item @b{startup} -
the board initialization code,
@item @b{timer} -
support of timer devices,
@item @b{shmsupp} -
support of shared memory in a multiprocessor system,
@item @b{network} -
the Ethernet driver.
@item @b{rtc} -
the real-time clock driver.
@item @b{wrapup} - XXX
@end itemize
Another important element are the makefiles, which have to be provided by
the user.
@b{NOTE:} This manual refers to the gen68340 BSP for numerous concrete
examples. You should have a copy of the gen68340 BSP available while
reading this piece of documentation. This BSP is located in the
following directory:
@example
$RTEMS_ROOT/c/src/lib/libbsp/m68k/gen68340
@end example
Later in this document, the $BSP340_ROOT label will be used
to refer to this directory.