path: root/doc/supplements/template/cpumodel.t
diff options
authorJoel Sherrill <>1998-10-19 12:49:37 +0000
committerJoel Sherrill <>1998-10-19 12:49:37 +0000
commit81423a1ad01184b0f3589e85689428813bc25261 (patch)
tree9f2d1c0f7550e62756ed05d0cd7561aa1055c870 /doc/supplements/template/cpumodel.t
parenta9d74246ccf6e3d836e9a2cf8cafd497421f91ed (diff)
Added 2 chapters
Diffstat (limited to '')
1 files changed, 68 insertions, 0 deletions
diff --git a/doc/supplements/template/cpumodel.t b/doc/supplements/template/cpumodel.t
new file mode 100644
index 0000000000..3540c1dc02
--- /dev/null
+++ b/doc/supplements/template/cpumodel.t
@@ -0,0 +1,68 @@
+@c COPYRIGHT (c) 1988-1998.
+@c On-Line Applications Research Corporation (OAR).
+@c All rights reserved.
+@c $Id$
+@chapter CPU Model Dependent Features
+@section Introduction
+Microprocessors are generally classified into
+families with a variety of CPU models or implementations within
+that family. Within a processor family, there is a high level
+of binary compatibility. This family may be based on either an
+architectural specification or on maintaining compatibility with
+a popular processor. Recent microprocessor families such as the
+SPARC or PA-RISC are based on an architectural specification
+which is independent or any particular CPU model or
+implementation. Older families such as the M68xxx and the iX86
+evolved as the manufacturer strived to produce higher
+performance processor models which maintained binary
+compatibility with older models.
+RTEMS takes advantage of the similarity of the
+various models within a CPU family. Although the models do vary
+in significant ways, the high level of compatibility makes it
+possible to share the bulk of the CPU dependent executive code
+across the entire family. Each processor family supported by
+RTEMS has a list of features which vary between CPU models
+within a family. For example, the most common model dependent
+feature regardless of CPU family is the presence or absence of a
+floating point unit or coprocessor. When defining the list of
+features present on a particular CPU model, one simply notes
+that floating point hardware is or is not present and defines a
+single constant appropriately. Conditional compilation is
+utilized to include the appropriate source code for this CPU
+model's feature set. It is important to note that this means
+that RTEMS is thus compiled using the appropriate feature set
+and compilation flags optimal for this CPU model used. The
+alternative would be to generate a binary which would execute on
+all family members using only the features which were always
+This chapter presents the set of features which vary
+across SPARC implementations and are of importance to RTEMS.
+The set of CPU model feature macros are defined in the file
+c/src/exec/score/cpu/XXX/XXX.h based upon the particular CPU
+model defined on the compilation command line.
+@section CPU Model Name
+The macro CPU_MODEL_NAME is a string which designates
+the name of this CPU model. For example, for the MODEL
+processor, this macro is set to the string "XXX".
+@section Floating Point Unit
+The macro XXX_HAS_FPU is set to 1 to indicate that
+this CPU model has a hardware floating point unit and 0
+otherwise. It does not matter whether the hardware floating
+point support is incorporated on-chip or is an external
+@section Another Optional Feature
+The macro XXX