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.

5 files changed, 528 insertions, 0 deletions

diff --git a/bsps/sh/gensh2/include/sh/io_types.h b/bsps/sh/gensh2/include/sh/io_types.h
new file mode 100644
index 0000000000..1dab885672
--- /dev/null
+++ b/bsps/sh/gensh2/include/sh/io_types.h
@@ -0,0 +1,84 @@
+/************************************************************************
+ *
+ *  Data types and constants for Hitachi SH704X on-chip peripherals
+ *
+ *  Author: John M.Mills (jmills@tga.com)
+ *
+ *  COPYRIGHT (c) 1999, TGA Technologies, Norcross, GA, USA
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ *
+ *  This file may be distributed as part of the RTEMS software item.
+ *
+ *  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.
+ *
+ *      John M. Mills (jmills@tga.com)
+ *      TGA Technologies, Inc.
+ *      100 Pinnacle Way, Suite 140
+ *      Norcross, GA 30071 U.S.A.
+ *
+ *      This modified file may be copied and distributed in accordance
+ *      the above-referenced license. It is provided for critique and
+ *      developmental purposes without any warranty nor representation
+ *      by the authors or by TGA Technologies.
+ *
+ *
+ ************************************************************************/
+
+#ifndef _sh_io_types_h
+#define _sh_io_types_h
+
+#include <rtems/score/iosh7045.h>
+#include <termios.h>
+
+typedef enum {SCI0, SCI1} portNo;
+typedef enum {eight, seven} dataBits;
+typedef enum {one, two} stopBits;
+typedef enum {even, odd} parity;
+
+typedef struct {
+  portNo   line;
+  int      speed_ix;
+  dataBits dBits;
+  int      parEn;
+  parity   par;
+  int      mulPro;
+  stopBits sBits;
+} sci_setup_t;
+
+typedef union{
+	unsigned char Reg;         /* By Register */
+	struct {                   /* By  Field */
+		 unsigned char Sync  :1; /* Async/Sync */
+		 unsigned char DBts  :1; /* Char.Length */
+		 unsigned char ParEn :1; /* Parity En.*/
+		 unsigned char Odd   :1; /* Even/Odd */
+		 unsigned char SBts  :1; /* No.Stop Bits */
+		 unsigned char MulP  :1; /* Multi-Proc. */
+		 unsigned char Dvsr  :2; /* Clock Sel. */
+	} Fld;
+} sci_smr_t;
+
+typedef union {
+	unsigned char Reg;          /*  By Register */
+	struct {                    /*  By Field */
+		 unsigned char TIE :1;    /*  Tx.Int.En. */
+		 unsigned char RIE :1;    /*  Rx.Int.En. */
+		 unsigned char TE  :1;    /*  Tx.En. */
+		 unsigned char RE  :1;    /*  Rx.En. */
+		 unsigned char MPIE:1;    /*  Mult.Pro.Int.En. */
+		 unsigned char TEIE:1;    /*  Tx.End Int.En. */
+		 unsigned char CkSrc :2;   /*  Clock Src. */
+	} Fld;
+} sci_scr_t;
+
+typedef struct {
+  unsigned char n ;
+  unsigned char N ;
+} sci_bitrate_t;
+
+#endif /* _sh_io_types_h */
diff --git a/bsps/sh/gensh2/include/sh/sci.h b/bsps/sh/gensh2/include/sh/sci.h
new file mode 100644
index 0000000000..dc34371d48
--- /dev/null
+++ b/bsps/sh/gensh2/include/sh/sci.h
@@ -0,0 +1,89 @@
+/*
+ *  Driver for the sh2 704x on-chip serial devices (sci)
+ *
+ *  Authors: Ralf Corsepius (corsepiu@faw.uni-ulm.de) and
+ *           Bernd Becker (becker@faw.uni-ulm.de)
+ *
+ *  COPYRIGHT (c) 1997-1998, FAW Ulm, Germany
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ *
+ *
+ *  COPYRIGHT (c) 1998.
+ *  On-Line Applications Research Corporation (OAR).
+ *
+ *  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 _sh_sci_h
+#define _sh_sci_h
+
+#include <rtems/libio.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*
+ * Devices are set to 9600 bps, 8 databits, 1 stopbit, no
+ * parity and asynchronous mode by default.
+ *
+ * NOTE:
+ *       The onboard serial devices of the SH do not support hardware
+ *       handshake.
+ */
+
+#define DEVSCI_DRIVER_TABLE_ENTRY \
+  { sh_sci_initialize, sh_sci_open, sh_sci_close, sh_sci_read, \
+      sh_sci_write, sh_sci_control }
+
+extern rtems_device_driver sh_sci_initialize(
+  rtems_device_major_number,
+  rtems_device_minor_number,
+  void *
+);
+
+extern rtems_device_driver sh_sci_open(
+  rtems_device_major_number,
+  rtems_device_minor_number,
+  void *
+);
+
+extern rtems_device_driver sh_sci_close(
+  rtems_device_major_number,
+  rtems_device_minor_number,
+  void *
+);
+
+extern rtems_device_driver sh_sci_read(
+  rtems_device_major_number,
+  rtems_device_minor_number,
+  void *
+);
+
+extern rtems_device_driver sh_sci_write(
+  rtems_device_major_number,
+  rtems_device_minor_number,
+  void *
+);
+
+extern rtems_device_driver sh_sci_control(
+  rtems_device_major_number,
+  rtems_device_minor_number,
+  void *
+);
+
+extern const rtems_termios_callbacks * sh_sci_get_termios_handlers(
+  bool poll
+);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
diff --git a/bsps/sh/gensh2/include/sh/sci_termios.h b/bsps/sh/gensh2/include/sh/sci_termios.h
new file mode 100644
index 0000000000..63750c9461
--- /dev/null
+++ b/bsps/sh/gensh2/include/sh/sci_termios.h
@@ -0,0 +1,65 @@
+/*
+ *  COPYRIGHT (c) 1989-2001.
+ *  On-Line Applications Research Corporation (OAR).
+ *
+ *  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 _SH_SCI_TERMIOS_H_
+#define _SH_SCI_TERMIOS_H_
+
+#ifdef __cplusplus
+extern "C"{
+#endif
+
+
+int sh_sci_set_attributes(
+  int minor,
+  const struct termios *t
+);
+
+void sh_sci_initialize_interrupts(int minor);
+
+void sh_sci_init(int minor);
+
+ssize_t sh_sci_write_support_int(
+    int         minor,
+    const char *buf,
+    size_t      len
+);
+
+ssize_t sh_sci_write_support_polled(
+  int         minor,
+  const char *buf,
+  size_t      len
+);
+
+void sh_sci_write_polled(
+    int minor,
+    char c
+);
+
+int sh_sci_inbyte_nonblocking_polled(int minor);
+
+
+int sh_sci_first_open(
+  int major,
+  int minor,
+  void *arg
+);
+
+int sh_sci_last_close(
+  int major,
+  int minor,
+  void *arg
+);
+
+#ifdef __cplusplus
+}
+#endif
+
+
+#endif /* _SH_SCI_TERMIOS_H_ */
diff --git a/bsps/sh/gensh2/include/sh/sh7_pfc.h b/bsps/sh/gensh2/include/sh/sh7_pfc.h
new file mode 100644
index 0000000000..b56433a9e2
--- /dev/null
+++ b/bsps/sh/gensh2/include/sh/sh7_pfc.h
@@ -0,0 +1,202 @@
+/*
+ * Bit values for the pin function controller of the Hitachi SH704x
+ *
+ * From Hitachi tutorials
+ *
+ *  Authors: Ralf Corsepius (corsepiu@faw.uni-ulm.de) and
+ *           Bernd Becker (becker@faw.uni-ulm.de)
+ *
+ *  COPYRIGHT (c) 1997-1998, FAW Ulm, Germany
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ *
+ *
+ *  COPYRIGHT (c) 1998.
+ *  On-Line Applications Research Corporation (OAR).
+ *
+ *  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 _sh7_pfc_h
+#define _sh7_pfc_h
+
+#include <rtems/score/iosh7045.h>
+
+/*
+ * Port A IO Registers (PAIORH, PAIORL)
+ *    1 => OUTPUT
+ *    0 => INPUT
+ */
+#define PAIORH     PFC_PAIORH
+#define PAIORL     PFC_PAIORL
+
+/* PAIORH */
+#define PA23IOR    0x0080
+#define PA22IOR    0x0040
+#define PA21IOR    0x0020
+#define PA20IOR    0x0010
+#define PA19IOR    0x0008
+#define PA18IOR    0x0004
+#define PA17IOR    0x0002
+#define PA16IOR    0x0001
+
+/* PAIORL */
+#define PA15IOR    0x8000
+#define PA14IOR    0x4000
+#define PA13IOR    0x2000
+#define PA12IOR    0x1000
+#define PA11IOR    0x0800
+#define PA10IOR    0x0400
+#define PA9IOR     0x0200
+#define PA8IOR     0x0100
+#define PA7IOR     0x0080
+#define PA6IOR     0x0040
+#define PA5IOR     0x0020
+#define PA4IOR     0x0010
+#define PA3IOR     0x0008
+#define PA2IOR     0x0004
+#define PA1IOR     0x0002
+#define PA0IOR     0x0001
+
+/*
+ * Port A Control Registers (PACRH, PACRL1, PACRL2)
+ * and mode bits
+ */
+#define PACRH      PFC_PACRH
+#define PACRL1     PFC_PACRL1
+#define PACRL2     PFC_PACRL2
+
+/* PACRH */
+#define PA23MD0    0x4000
+#define PA22MD0    0x1000
+#define PA21MD0    0x0400
+#define PA20MD0    0x0100
+#define PA19MD1    0x0080
+#define PA19MD0    0x0040
+#define PA18MD1    0x0020
+#define PA18MD0    0x0010
+#define PA17MD0    0x0004
+#define PA16MD0    0x0001
+
+/* PACRL1 */
+#define PA15MD0    0x4000
+#define PA14MD0    0x1000
+#define PA13MD0    0x0400
+#define PA12MD0    0x0100
+#define PA11MD0    0x0040
+#define PA10MD0    0x0010
+#define PA9MD1     0x0008
+#define PA9MD0     0x0004
+#define PA8MD1     0x0002
+#define PA8MD0     0x0001
+
+/* PACRL2 */
+#define PA7MD1     0x8000
+#define PA7MD0     0x4000
+#define PA6MD1     0x2000
+#define PA6MD0     0x1000
+#define PA5MD1     0x0800
+#define PA5MD0     0x0400
+#define PA4MD0     0x0100
+#define PA3MD0     0x0040
+#define PA2MD1     0x0020
+#define PA2MD0     0x0010
+#define PA1MD0     0x0004
+#define PA0MD0     0x0001
+
+#define PA_TXD1    PA4MD0
+#define PA_RXD1    PA3MD0
+#define PA_TXD0    PA1MD0
+#define PA_RXD0    PA0MD0
+
+/*
+ * Port B IO Register (PBIOR)
+ */
+#define PBIOR      PFC_PBIOR
+#define PB15IOR    0x8000
+#define PB14IOR    0x4000
+#define PB13IOR    0x2000
+#define PB12IOR    0x1000
+#define PB11IOR    0x0800
+#define PB10IOR    0x0400
+#define PB9IOR     0x0200
+#define PB8IOR     0x0100
+#define PB7IOR     0x0080
+#define PB6IOR     0x0040
+#define PB5IOR     0x0020
+#define PB4IOR     0x0010
+#define PB3IOR     0x0008
+#define PB2IOR     0x0004
+#define PB1IOR     0x0002
+#define PB0IOR     0x0001
+
+/*
+ * Port B Control Register (PBCR1)
+ */
+#define PBCR1      PFC_PBCR1
+#define PB15MD1    0x8000
+#define PB15MD0    0x4000
+#define PB14MD1    0x2000
+#define PB14MD0    0x1000
+#define PB13MD1    0x0800
+#define PB13MD0    0x0400
+#define PB12MD1    0x0200
+#define PB12MD0    0x0100
+#define PB11MD1    0x0080
+#define PB11MD0    0x0040
+#define PB10MD1    0x0020
+#define PB10MD0    0x0010
+#define PB9MD1     0x0008
+#define PB9MD0     0x0004
+#define PB8MD1     0x0002
+#define PB8MD0     0x0001
+
+#define PB15MD     PB15MD1|PB14MD0
+#define PB14MD     PB14MD1|PB14MD0
+#define PB13MD     PB13MD1|PB13MD0
+#define PB12MD     PB12MD1|PB12MD0
+#define PB11MD     PB11MD1|PB11MD0
+#define PB10MD     PB10MD1|PB10MD0
+#define PB9MD      PB9MD1|PB9MD0
+#define PB8MD      PB8MD1|PB8MD0
+
+#define PB_TXD1    PB11MD1
+#define PB_RXD1    PB10MD1
+#define PB_TXD0    PB9MD1
+#define PB_RXD0    PB8MD1
+
+/*
+ * Port B Control Register (PBCR2)
+ */
+#define PBCR2      PFC_PBCR2
+#define PB7MD1     0x8000
+#define PB7MD0     0x4000
+#define PB6MD1     0x2000
+#define PB6MD0     0x1000
+#define PB5MD1     0x0800
+#define PB5MD0     0x0400
+#define PB4MD1     0x0200
+#define PB4MD0     0x0100
+#define PB3MD1     0x0080
+#define PB3MD0     0x0040
+#define PB2MD1     0x0020
+#define PB2MD0     0x0010
+#define PB1MD1     0x0008
+#define PB1MD0     0x0004
+#define PB0MD1     0x0002
+#define PB0MD0     0x0001
+
+#define PB7MD      PB7MD1|PB7MD0
+#define PB6MD      PB6MD1|PB6MD0
+#define PB5MD      PB5MD1|PB5MD0
+#define PB4MD      PB4MD1|PB4MD0
+#define PB3MD      PB3MD1|PB3MD0
+#define PB2MD      PB2MD1|PB2MD0
+#define PB1MD      PB1MD1|PB1MD0
+#define PB0MD      PB0MD1|PB0MD0
+
+#endif /* _sh7_pfc_h */
diff --git a/bsps/sh/gensh2/include/sh/sh7_sci.h b/bsps/sh/gensh2/include/sh/sh7_sci.h
new file mode 100644
index 0000000000..7218313704
--- /dev/null
+++ b/bsps/sh/gensh2/include/sh/sh7_sci.h
@@ -0,0 +1,88 @@
+/*
+ * Bit values for the serial control registers of the Hitachi SH704X
+ *
+ * From Hitachi tutorials
+ *
+ *  Authors: Ralf Corsepius (corsepiu@faw.uni-ulm.de) and
+ *           Bernd Becker (becker@faw.uni-ulm.de)
+ *
+ *  COPYRIGHT (c) 1997-1998, FAW Ulm, Germany
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ *
+ *
+ *  COPYRIGHT (c) 1998.
+ *  On-Line Applications Research Corporation (OAR).
+ *
+ *  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 _sh7_sci_h
+#define _sh7_sci_h
+
+#include <rtems/score/iosh7045.h>
+
+/*
+ * Serial mode register bits
+ */
+
+#define SCI_SYNC_MODE               0x80
+#define SCI_SEVEN_BIT_DATA          0x40
+#define SCI_PARITY_ON               0x20
+#define SCI_ODD_PARITY              0x10
+#define SCI_STOP_BITS_2             0x08
+#define SCI_ENABLE_MULTIP           0x04
+#define SCI_PHI_64                  0x03
+#define SCI_PHI_16                  0x02
+#define SCI_PHI_4                   0x01
+#define SCI_PHI_0                   0x00
+
+/*
+ * Serial register offsets, relative to SCI0_SMR or SCI1_SMR
+ */
+
+#define SCI_SMR			0x00
+#define SCI_BRR			0x01
+#define SCI_SCR			0x02
+#define SCI_TDR			0x03
+#define SCI_SSR			0x04
+#define SCI_RDR			0x05
+
+/*
+ * Serial control register bits
+ */
+#define SCI_TIE                 0x80    /* Transmit interrupt enable */
+#define SCI_RIE                 0x40    /* Receive interrupt enable */
+#define SCI_TE                  0x20    /* Transmit enable */
+#define SCI_RE                  0x10    /* Receive enable */
+#define SCI_MPIE                0x08    /* Multiprocessor interrupt enable */
+#define SCI_TEIE                0x04    /* Transmit end interrupt enable */
+#define SCI_CKE1                0x02    /* Clock enable 1 */
+#define SCI_CKE0                0x01    /* Clock enable 0 */
+
+/*
+ * Serial status register bits
+ */
+#define SCI_TDRE                0x80    /* Transmit data register empty */
+#define SCI_RDRF                0x40    /* Receive data register full */
+#define SCI_ORER                0x20    /* Overrun error */
+#define SCI_FER                 0x10    /* Framing error */
+#define SCI_PER                 0x08    /* Parity error */
+#define SCI_TEND                0x04    /* Transmit end */
+#define SCI_MPB                 0x02    /* Multiprocessor bit */
+#define SCI_MPBT                0x01    /* Multiprocessor bit transfer */
+
+/*
+ * INTC Priority Settings
+ */
+
+#define SCI0_IPMSK	0x00F0
+#define SCI0_LOWIP	0x0010
+#define SCI1_IPMSK	0x000F
+#define SCI1_LOWIP	0x0001
+
+#endif /* _sh7_sci_h */