Remove make preinstall

A speciality of the RTEMS build system was the make preinstall step.  It
copied header files from arbitrary locations into the build tree.  The
header files were included via the -Bsome/build/tree/path GCC command
line option.

This has at least seven problems:

* The make preinstall step itself needs time and disk space.

* Errors in header files show up in the build tree copy.  This makes it
  hard for editors to open the right file to fix the error.

* There is no clear relationship between source and build tree header
  files.  This makes an audit of the build process difficult.

* The visibility of all header files in the build tree makes it
  difficult to enforce API barriers.  For example it is discouraged to
  use BSP-specifics in the cpukit.

* An introduction of a new build system is difficult.

* Include paths specified by the -B option are system headers.  This
  may suppress warnings.

* The parallel build had sporadic failures on some hosts.

This patch removes the make preinstall step.   All installed header
files are moved to dedicated include directories in the source tree.
Let @RTEMS_CPU@ be the target architecture, e.g. arm, powerpc, sparc,
etc.  Let @RTEMS_BSP_FAMILIY@ be a BSP family base directory, e.g.
erc32, imx, qoriq, etc.

The new cpukit include directories are:

* cpukit/include

* cpukit/score/cpu/@RTEMS_CPU@/include

* cpukit/libnetworking

The new BSP include directories are:

* bsps/include

* bsps/@RTEMS_CPU@/include

* bsps/@RTEMS_CPU@/@RTEMS_BSP_FAMILIY@/include

There are build tree include directories for generated files.

The include directory order favours the most general header file, e.g.
it is not possible to override general header files via the include path
order.

The "bootstrap -p" option was removed.  The new "bootstrap -H" option
should be used to regenerate the "headers.am" files.

Update #3254.

1 files changed, 118 insertions, 0 deletions

diff --git a/bsps/bfin/include/libcpu/twiRegs.h b/bsps/bfin/include/libcpu/twiRegs.h
new file mode 100644
index 0000000000..c776f7886e
--- /dev/null
+++ b/bsps/bfin/include/libcpu/twiRegs.h
@@ -0,0 +1,118 @@
+/*  Blackfin Two Wire Interface Registers
+ *
+ *  Copyright (c) 2008 Kallisti Labs, Los Gatos, CA, USA
+ *             written by Allan Hessenflow <allanh@kallisti.com>
+ *
+ *  The license and distribution terms for this file may be
+ *  found in the file LICENSE in this distribution or at
+ *  http://www.rtems.org/license/LICENSE.
+ */
+
+#ifndef _twiRegs_h_
+#define _twiRegs_h_
+
+
+/* register addresses */
+
+#define TWI_CLKDIV_OFFSET                             0x0000
+#define TWI_CONTROL_OFFSET                            0x0004
+#define TWI_SLAVE_CTL_OFFSET                          0x0008
+#define TWI_SLAVE_STAT_OFFSET                         0x000c
+#define TWI_SLAVE_ADDR_OFFSET                         0x0010
+#define TWI_MASTER_CTL_OFFSET                         0x0014
+#define TWI_MASTER_STAT_OFFSET                        0x0018
+#define TWI_MASTER_ADDR_OFFSET                        0x001c
+#define TWI_INT_STAT_OFFSET                           0x0020
+#define TWI_INT_MASK_OFFSET                           0x0024
+#define TWI_FIFO_CTL_OFFSET                           0x0028
+#define TWI_FIFO_STAT_OFFSET                          0x002c
+#define TWI_XMT_DATA8_OFFSET                          0x0080
+#define TWI_XMT_DATA16_OFFSET                         0x0084
+#define TWI_RCV_DATA8_OFFSET                          0x0088
+#define TWI_RCV_DATA16_OFFSET                         0x008c
+
+
+/* register fields */
+
+#define TWI_CLKDIV_CLKHI_MASK                         0xff00
+#define TWI_CLKDIV_CLKHI_SHIFT                             8
+#define TWI_CLKDIV_CLKLOW_MASK                        0x00ff
+#define TWI_CLKDIV_CLKLOW_SHIFT                            0
+
+#define TWI_CONTROL_SCCB                              0x0200
+#define TWI_CONTROL_TWI_ENA                           0x0080
+#define TWI_CONTROL_PRESCALE_MASK                     0x007f
+#define TWI_CONTROL_PRESCALE_SHIFT                         0
+
+#define TWI_SLAVE_CTL_GEN                             0x0010
+#define TWI_SLAVE_CTL_NAK                             0x0008
+#define TWI_SLAVE_CTL_STDVAL                          0x0004
+#define TWI_SLAVE_CTL_SEN                             0x0001
+
+#define TWI_SLAVE_STAT_GCALL                          0x0002
+#define TWI_SLAVE_STAT_SDIR                           0x0001
+
+#define TWI_SLAVE_ADDR_SADDR_MASK                     0x007f
+#define TWI_SLAVE_ADDR_SADDR_SHIFT                         0
+
+#define TWI_MASTER_CTL_SCLOVR                         0x8000
+#define TWI_MASTER_CTL_SDAOVR                         0x4000
+#define TWI_MASTER_CTL_DCNT_MASK                      0x3fc0
+#define TWI_MASTER_CTL_DCNT_SHIFT                          6
+#define TWI_MASTER_CTL_RSTART                         0x0020
+#define TWI_MASTER_CTL_STOP                           0x0010
+#define TWI_MASTER_CTL_FAST                           0x0008
+#define TWI_MASTER_CTL_MDIR                           0x0004
+#define TWI_MASTER_CTL_MEN                            0x0001
+
+#define TWI_MASTER_STAT_BUSBUSY                       0x0100
+#define TWI_MASTER_STAT_SCLSEN                        0x0080
+#define TWI_MASTER_STAT_SDASEN                        0x0040
+#define TWI_MASTER_STAT_BUFWRERR                      0x0020
+#define TWI_MASTER_STAT_BUFRDERR                      0x0010
+#define TWI_MASTER_STAT_DNAK                          0x0008
+#define TWI_MASTER_STAT_ANAK                          0x0004
+#define TWI_MASTER_STAT_LOSTARB                       0x0002
+#define TWI_MASTER_STAT_MPROG                         0x0001
+
+#define TWI_MASTER_ADDR_MADDR_MASK                    0x007f
+#define TWI_MASTER_ADDR_MADDR_SHIFT                        0
+
+#define TWI_INT_STAT_RCVSERV                          0x0080
+#define TWI_INT_STAT_XMTSERV                          0x0040
+#define TWI_INT_STAT_MERR                             0x0020
+#define TWI_INT_STAT_MCOMP                            0x0010
+#define TWI_INT_STAT_SOVF                             0x0008
+#define TWI_INT_STAT_SERR                             0x0004
+#define TWI_INT_STAT_SCOMP                            0x0002
+#define TWI_INT_STAT_SINIT                            0x0001
+
+#define TWI_INT_MASK_RCVSERVM                         0x0080
+#define TWI_INT_MASK_XMTSERVM                         0x0040
+#define TWI_INT_MASK_MERRM                            0x0020
+#define TWI_INT_MASK_MCOMPM                           0x0010
+#define TWI_INT_MASK_SOVFM                            0x0008
+#define TWI_INT_MASK_SERRM                            0x0004
+#define TWI_INT_MASK_SCOMPM                           0x0002
+#define TWI_INT_MASK_SINITM                           0x0001
+
+#define TWI_FIFO_CTL_RCVINTLEN                        0x0008
+#define TWI_FIFO_CTL_XMTINTLEN                        0x0004
+#define TWI_FIFO_CTL_RCVFLUSH                         0x0002
+#define TWI_FIFO_CTL_XMTFLUSH                         0x0001
+
+#define TWI_FIFO_STAT_RCVSTAT_MASK                    0x000c
+#define TWI_FIFO_STAT_RCVSTAT_EMPTY                   0x0000
+#define TWI_FIFO_STAT_RCVSTAT_SHIFT                        2
+#define TWI_FIFO_STAT_XMTSTAT_MASK                    0x0003
+#define TWI_FIFO_STAT_XMTSTAT_FULL                    0x0003
+#define TWI_FIFO_STAT_XMTSTAT_SHIFT                        0
+
+#define TWI_XMT_DATA8_XMTDATA8_MASK                   0x00ff
+#define TWI_XMT_DATA8_XMTDATA8_SHIFT                       0
+
+#define TWI_RCV_DATA8_RCVDATA8_MASK                   0x00ff
+#define TWI_RCV_DATA8_RCVDATA8_SHIFT                       0
+
+
+#endif /* _twiRegs_h_ */