summaryrefslogtreecommitdiff
path: root/include/bsp/boot.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/bsp/boot.h')
-rw-r--r--include/bsp/boot.h114
1 files changed, 114 insertions, 0 deletions
diff --git a/include/bsp/boot.h b/include/bsp/boot.h
new file mode 100644
index 0000000000..b9c845bc8f
--- /dev/null
+++ b/include/bsp/boot.h
@@ -0,0 +1,114 @@
+/**
+ * @file
+ *
+ * @ingroup lpc32xx_boot
+ *
+ * @brief Boot support API.
+ */
+
+/*
+ * Copyright (c) 2010
+ * 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.
+ */
+
+#ifndef LIBBSP_ARM_LPC32XX_BOOT_H
+#define LIBBSP_ARM_LPC32XX_BOOT_H
+
+#include <stdint.h>
+
+#include <bsp/nand-mlc.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
+/**
+ * @defgroup lpc32xx_boot Boot Support
+ *
+ * @ingroup arm_lpc32xx
+ *
+ * @brief Boot support.
+ *
+ * The NXP internal boot program shall be the "stage-0 program".
+ *
+ * The boot program within the first page of the first or second block shall be
+ * "stage-1 program". It will be invoked by the stage-0 program from NXP.
+ *
+ * The program loaded by the stage-1 program will be the "stage-2 program" or the
+ * "boot loader".
+ *
+ * The program loaded by the stage-2 program will be the "stage-3 program" or the
+ * "application".
+ *
+ * The stage-1 program image must have a format specified by NXP.
+ *
+ * The stage-2 and stage-3 program images may have any format.
+ *
+ * @{
+ */
+
+#define LPC32XX_BOOT_BLOCK_0 0
+#define LPC32XX_BOOT_BLOCK_1 1
+
+#define LPC32XX_BOOT_ICR_SP_3AC_8IF 0xf0
+#define LPC32XX_BOOT_ICR_SP_4AC_8IF 0xd2
+#define LPC32XX_BOOT_ICR_LP_4AC_8IF 0xb4
+#define LPC32XX_BOOT_ICR_LP_5AC_8IF 0x96
+
+typedef union {
+ struct {
+ uint8_t d0;
+ uint8_t reserved_0 [3];
+ uint8_t d1;
+ uint8_t reserved_1 [3];
+ uint8_t d2;
+ uint8_t reserved_2 [3];
+ uint8_t d3;
+ uint8_t reserved_3 [3];
+ uint8_t d4;
+ uint8_t reserved_4 [3];
+ uint8_t d5;
+ uint8_t reserved_5 [3];
+ uint8_t d6;
+ uint8_t reserved_6 [3];
+ uint8_t d7;
+ uint8_t reserved_7 [3];
+ uint8_t d8;
+ uint8_t reserved_8 [3];
+ uint8_t d9;
+ uint8_t reserved_9 [3];
+ uint8_t d10;
+ uint8_t reserved_10 [3];
+ uint8_t d11;
+ uint8_t reserved_11 [3];
+ uint8_t d12;
+ uint8_t reserved_12 [463];
+ } field;
+ uint32_t data [MLC_SMALL_DATA_WORD_COUNT];
+} lpc32xx_boot_block;
+
+void lpc32xx_setup_boot_block(
+ lpc32xx_boot_block *boot_block,
+ uint8_t icr,
+ uint8_t page_count
+);
+
+void lpc32xx_set_boot_block_bad(
+ lpc32xx_boot_block *boot_block
+);
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
+#endif /* LIBBSP_ARM_LPC32XX_BOOT_H */