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, 128 insertions, 0 deletions

diff --git a/bsps/powerpc/include/mpc55xx/dspi.h b/bsps/powerpc/include/mpc55xx/dspi.h
new file mode 100644
index 0000000000..8ad98274ef
--- /dev/null
+++ b/bsps/powerpc/include/mpc55xx/dspi.h
@@ -0,0 +1,128 @@
+/**
+ * @file
+ *
+ * @ingroup mpc55xx_dspi
+ *
+ * @brief Header file for the LibI2C bus driver for the Deserial Serial Peripheral Interface (DSPI).
+ */
+
+/*
+ * Copyright (c) 2008
+ * Embedded Brains GmbH
+ * Obere Lagerstr. 30
+ * D-82178 Puchheim
+ * Germany
+ * rtems@embedded-brains.de
+ *
+ * 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.
+ */
+
+/**
+ * @defgroup mpc55xx_dspi Deserial Serial Peripheral Interface (DSPI)
+ *
+ * @ingroup mpc55xx
+ */
+
+#ifndef LIBCPU_POWERPC_MPC55XX_DSPI_H
+#define LIBCPU_POWERPC_MPC55XX_DSPI_H
+
+#include <rtems/libi2c.h>
+
+#include <mpc55xx/edma.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
+struct DSPI_tag;
+
+typedef struct {
+  edma_channel_context edma;
+  rtems_id id;
+} mpc55xx_dspi_edma_entry;
+
+/**
+ * @brief LibI2C bus driver entry.
+ */
+typedef struct {
+	/**
+	 * @brief Standard bus driver fields.
+	 */
+	rtems_libi2c_bus_t bus;
+
+	/**
+	 * @brief Index in the bus table: @ref mpc55xx_dspi_bus_table.
+	 */
+	unsigned table_index;
+
+	/**
+	 * @brief Bus number (available after rtems_libi2c_register_bus()).
+	 *
+	 * @note You must set it in the initialization code after the bus registration.
+	 */
+	unsigned bus_number;
+
+	/**
+	 * @brief Hardware registers.
+	 */
+	volatile struct DSPI_tag *regs;
+
+	/**
+	 * @brief Selects SPI master or slave mode.
+	 */
+	bool master;
+
+	/**
+	 * @brief Data for the Push Register.
+	 */
+	union DSPI_PUSHR_tag push_data;
+
+	/**
+	 * @brief eDMA entry for transmission.
+	 *
+	 * The channel is fixed to a particular DSPI.
+	 */
+	mpc55xx_dspi_edma_entry edma_transmit;
+
+	/**
+	 * @brief eDMA entry for push data generation.
+	 *
+	 * You can choose every available channel.
+	 */
+	mpc55xx_dspi_edma_entry edma_push;
+
+	/**
+	 * @brief eDMA entry for receiving.
+	 *
+	 * The channel is fixed to a particular DSPI.
+	 */
+	mpc55xx_dspi_edma_entry edma_receive;
+
+	/**
+	 * @brief Idle character transmitted in read only mode.
+	 */
+	uint32_t idle_char;
+
+	/**
+	 * @brief Current baud.
+	 */
+	uint32_t baud;
+} mpc55xx_dspi_bus_entry;
+
+/**
+ * @brief Number of DSPIs.
+ */
+#define MPC55XX_DSPI_NUMBER 4
+
+/**
+ * @brief Table with bus driver entries.
+ */
+extern mpc55xx_dspi_bus_entry mpc55xx_dspi_bus_table [ /* MPC55XX_DSPI_NUMBER */ ];
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
+#endif /* LIBCPU_POWERPC_MPC55XX_DSPI_H */