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

diff --git a/bsps/arm/stm32f4/include/bsp/stm32f4xxxx_flash.h b/bsps/arm/stm32f4/include/bsp/stm32f4xxxx_flash.h
new file mode 100755
index 0000000000..f81b19cd40
--- /dev/null
+++ b/bsps/arm/stm32f4/include/bsp/stm32f4xxxx_flash.h
@@ -0,0 +1,83 @@
+/*
+ * Copyright (c) 2013 Chris Nott.  All rights reserved.
+ *
+ *  Virtual Logic
+ *  21-25 King St.
+ *  Rockdale NSW 2216
+ *  Australia
+ *  <rtems@vl.com.au>
+ *
+ * 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 LIBBSP_ARM_STM32F4_STM32F4XXXX_FLASH_H
+#define LIBBSP_ARM_STM32F4_STM32F4XXXX_FLASH_H
+
+#include <bsp/utility.h>
+
+struct stm32f4_flash_s {
+
+  uint32_t acr;   // Access and control register
+#define STM32F4_FLASH_ACR_DCRST   BSP_BIT32(12) // Data cache reset
+#define STM32F4_FLASH_ACR_ICRST   BSP_BIT32(11) // Instruction cache reset
+#define STM32F4_FLASH_ACR_DCEN    BSP_BIT32(10) // Data cache enable
+#define STM32F4_FLASH_ACR_ICEN    BSP_BIT32(9)  // Instruction cache enable
+#define STM32F4_FLASH_ACR_PRFTEN  BSP_BIT32(8)  // Prefetch enable
+#define STM32F4_FLASH_ACR_LATENCY(val)  BSP_FLD32(val, 0, 2)  // Flash access latency
+#define STM32F4_FLASH_ACR_LATENCY_GET(reg)  BSP_FLD32GET(reg, 0, 2)
+#define STM32F4_FLASH_ACR_LATENCY_SET(reg, val) BSP_FLD32SET(reg, val, 0, 2)
+
+  uint32_t keyr;  // Key register
+#define STM32F4_FLASH_KEYR_KEY1 0x45670123
+#define STM32F4_FLASH_KEYR_KEY2 0xCDEF89AB
+
+  uint32_t optkeyr; // Option key register
+#define STM32F4_FLASH_OPTKEYR_OPTKEY1 0x08192A3B
+#define STM32F4_FLASH_OPTKEYR_OPTKEY2 0x4C5D6E7F
+
+  uint32_t sr;    // Status register
+#define STM32F4_FLASH_SR_BSY    BSP_BIT32(16) // Busy
+#define STM32F4_FLASH_SR_PGSERR BSP_BIT32(7)  // Programming sequence error
+#define STM32F4_FLASH_SR_PGPERR BSP_BIT32(6)  // Programming parallelism error
+#define STM32F4_FLASH_SR_PGAERR BSP_BIT32(5)  // Programming alignment error
+#define STM32F4_FLASH_SR_WRPERR BSP_BIT32(4)  // Write protection error
+#define STM32F4_FLASH_SR_OPERR  BSP_BIT32(1)  // Operation error
+#define STM32F4_FLASH_SR_EOP    BSP_BIT32(0)  // End of operation
+
+  uint32_t cr;    // Control register
+#define STM32F4_FLASH_CR_LOCK   BSP_BIT32(31) // Lock
+#define STM32F4_FLASH_CR_ERRIE  BSP_BIT32(25) // Error interrupt enable
+#define STM32F4_FLASH_CR_EOPIE  BSP_BIT32(24) // End of operation interrupt enable
+#define STM32F4_FLASH_CR_STRT   BSP_BIT32(16) // Start
+#define STM32F4_FLASH_CR_PSIZE(val) BSP_FLD32(val, 8, 9)  // Program size
+#define STM32F4_FLASH_CR_PSIZE_GET(reg) BSP_FLD32GET(reg, 8, 9)
+#define STM32F4_FLASH_CR_PSIZE_SET(reg, val)  BSP_FLD32SET(reg, val, 8, 9)
+#define STM32F4_FLASH_CR_SNB  BSP_FLD32(val, 3, 6)  // Sector number
+#define STM32F4_FLASH_CR_SNB_GET(reg) BSP_FLD32GET(reg, 3, 6)
+#define STM32F4_FLASH_CR_SNB_SET(reg, val)  BSP_FLD32SET(reg, val, 3, 6)
+#define STM32F4_FLASH_CR_MER    BSP_BIT32(2)  // Mass erase
+#define STM32F4_FLASH_CR_SER    BSP_BIT32(1)  // Sector erase
+#define STM32F4_FLASH_CR_PG     BSP_BIT32(0)  // Programming
+
+  uint32_t optcr;   // Option control register
+#define STM32F4_FLASH_OPTCR_NWRP(val) BSP_FLD32(val, 16, 27)  // Not write protect
+#define STM32F4_FLASH_OPTCR_NWRP_GET(reg) BSP_FLD32GET(reg, 16, 27)
+#define STM32F4_FLASH_OPTCR_NWRP_SET(reg, val)  BSP_FLD32SET(reg, val, 16, 27)
+#define STM32F4_FLASH_OPTCR_RDP(val)  BSP_FLD32(val, 8, 15) // Read protect
+#define STM32F4_FLASH_OPTCR_RDP_GET(reg)  BSP_FLD32GET(reg, 8, 15)
+#define STM32F4_FLASH_OPTCR_RDP_SET(reg, val) BSP_FLD32SET(reg, val, 8, 15)
+#define STM32F4_FLASH_OPTCR_USER(val) BSP_FLD32(val, 5, 7)  // User option bytes
+#define STM32F4_FLASH_OPTCR_USER_GET(reg) BSP_FLD32GET(reg, 5, 7)
+#define STM32F4_FLASH_OPTCR_USER_SET(reg, val)  BSP_FLD32SET(reg, val, 5, 7)
+#define STM32F4_FLASH_OPTCR_BOR_LEVEL(val)  BSP_FLD32(val, 2, 3)  // BOR reset level
+#define STM32F4_FLASH_OPTCR_BOR_LEVEL_GET(reg)  BSP_FLD32GET(reg, 2, 3)
+#define STM32F4_FLASH_OPTCR_BOR_LEVEL_SET(reg, val) BSP_FLD32SET(reg, val, 2, 3)
+#define STM32F4_FLASH_CR_OPTSTRT  BSP_BIT32(1)  // Option start
+#define STM32F4_FLASH_CR_OPTLOCK  BSP_BIT32(0)  // Option lock
+
+} __attribute__ ((packed));
+typedef struct stm32f4_flash_s stm32f4_flash;
+
+#endif /* LIBBSP_ARM_STM32F4_STM32F4XXXX_FLASH_H */