1 | Introduction |
---|
2 | ############ |
---|
3 | |
---|
4 | Before reading this documentation, it is strongly advised to read the |
---|
5 | RTEMS Development Environment Guide to get acquainted with the RTEMS |
---|
6 | directory structure. This document describes how to do a RTEMS Board |
---|
7 | Support Package, i.e. how to port RTEMS on a new target board. Discussions |
---|
8 | are provided for the following topics: |
---|
9 | |
---|
10 | - RTEMS Board Support Package Organization |
---|
11 | |
---|
12 | - Makefiles and the Linker Command Script |
---|
13 | |
---|
14 | - Board Initialization Sequence |
---|
15 | |
---|
16 | - Device Drivers Including: |
---|
17 | - Console Driver |
---|
18 | - Clock Driver |
---|
19 | - Timer Driver |
---|
20 | - Real-Time Clock Driver |
---|
21 | - Non-Volatile Memory Driver |
---|
22 | - Networking Driver |
---|
23 | - Shared Memory Support Driver |
---|
24 | - Analog Driver |
---|
25 | - Discrete Driver |
---|
26 | |
---|
27 | The original version of this manual was written by Geoffroy Montel |
---|
28 | <g_montel@yahoo.com>. When he started development of the gen68340 |
---|
29 | BSP, this manual did not exist. He wrote the initial version of |
---|
30 | this manual as the result of his experiences. At that time, this |
---|
31 | document was viewed internally as the most important "missing manual" |
---|
32 | in the RTEMS documentation set. |
---|
33 | |
---|
34 | The gen68340 BSP is a good example of the life of an RTEMS BSP. It is |
---|
35 | based upon a part not recommended for new designs and none of the core RTEMS |
---|
36 | Project team members have one of these boards. Thus we are unlikely to |
---|
37 | perform major updates on this BSP. So as long as it compiles and links all |
---|
38 | tests, it will be available. |
---|
39 | |
---|
40 | The RTEMS Project team members are always trying to identify common |
---|
41 | code across BSPs and refactoring the code into shared routines. |
---|
42 | As part of this effort, the we will enhance the common BSP Framework. |
---|
43 | Not surprisingly, not every BSP takes advantage of every feature in |
---|
44 | the framework. The gen68340 does not take advantage of as many features |
---|
45 | as the ERC32 BSP does. So in many ways, the ERC32 is a better example |
---|
46 | BSP at this point. But even the ERC32 BSP does not include examples |
---|
47 | of every driver template and framework available to the BSP author. |
---|
48 | So in this guide we will try to point out good examples from other BSPs. |
---|
49 | |
---|
50 | Our goal is for you to be able to reuse as much code as possible and |
---|
51 | write as little board specific code as possible. |
---|
52 | |
---|
53 | .. COMMENT: COPYRIGHT (c) 1988-2002. |
---|
54 | |
---|
55 | .. COMMENT: On-Line Applications Research Corporation (OAR). |
---|
56 | |
---|
57 | .. COMMENT: All rights reserved. |
---|
58 | |
---|