summaryrefslogtreecommitdiffstats
path: root/c/src/lib/libbsp/shared
diff options
context:
space:
mode:
authorSebastian Huber <sebastian.huber@embedded-brains.de>2017-03-07 10:57:46 +0100
committerSebastian Huber <sebastian.huber@embedded-brains.de>2017-03-08 07:19:00 +0100
commit9cd20cde4d06cb55339a33368d901c29dc2d2f28 (patch)
treec6461b3f0ecb0321bfe6b570551ce97b01eff21c /c/src/lib/libbsp/shared
parentmonitor: Do not zero sema id and name (diff)
downloadrtems-9cd20cde4d06cb55339a33368d901c29dc2d2f28.tar.bz2
bsps: Provide <bsp/fdt.h> for every BSP
Add bsp_fdt_map_intr() intended for the libbsd FDT support.
Diffstat (limited to 'c/src/lib/libbsp/shared')
-rw-r--r--c/src/lib/libbsp/shared/include/fdt.h38
-rw-r--r--c/src/lib/libbsp/shared/src/bsp-fdt.c7
2 files changed, 42 insertions, 3 deletions
diff --git a/c/src/lib/libbsp/shared/include/fdt.h b/c/src/lib/libbsp/shared/include/fdt.h
index a4c7df6dc1..bb71f7d03b 100644
--- a/c/src/lib/libbsp/shared/include/fdt.h
+++ b/c/src/lib/libbsp/shared/include/fdt.h
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2015 embedded brains GmbH. All rights reserved.
+ * Copyright (c) 2015, 2017 embedded brains GmbH. All rights reserved.
*
* embedded brains GmbH
* Dornierstr. 4
@@ -15,14 +15,50 @@
#ifndef LIBBSP_SHARED_FDT_H
#define LIBBSP_SHARED_FDT_H
+#include <bsp.h>
+
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
+/*
+ * BSPs that implement the FDT support functions must define
+ * BSP_FDT_IS_SUPPORTED.
+ */
+
+/**
+ * @brief Copies the specified source FDT to a dedicated global data area.
+ *
+ * The source FDT is usually provided by a bootloader and may be located in a
+ * memory area that is used by the program. The low-level initialization
+ * should copy the FDT for later use.
+ *
+ * The copy can be accessed by bsp_fdt_get().
+ *
+ * @param[in] src The source FDT.
+ */
void bsp_fdt_copy(const void *src);
+/**
+ * @brief Returns the FDT of the BSP.
+ *
+ * @return The FDT of the BSP.
+ */
const void *bsp_fdt_get(void);
+/**
+ * @brief Maps the interrupt number of the FDT to the interrupt vector used by
+ * the interrupt management.
+ *
+ * This function is used by the libbsd to implement the OFW_BUS_MAP_INTR bus
+ * method.
+ *
+ * @param[in] intr The FDT interrupt number.
+ *
+ * @return The interrupt vector of the FDT interrupt number.
+ */
+uint32_t bsp_fdt_map_intr(uint32_t intr);
+
#ifdef __cplusplus
}
#endif /* __cplusplus */
diff --git a/c/src/lib/libbsp/shared/src/bsp-fdt.c b/c/src/lib/libbsp/shared/src/bsp-fdt.c
index 635cb85571..faf59be8fc 100644
--- a/c/src/lib/libbsp/shared/src/bsp-fdt.c
+++ b/c/src/lib/libbsp/shared/src/bsp-fdt.c
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2015 embedded brains GmbH. All rights reserved.
+ * Copyright (c) 2015, 2017 embedded brains GmbH. All rights reserved.
*
* embedded brains GmbH
* Dornierstr. 4
@@ -16,10 +16,13 @@
#include <libfdt.h>
-#include <bsp.h>
#include <bsp/fdt.h>
#include <bsp/linker-symbols.h>
+#ifndef BSP_FDT_IS_SUPPORTED
+#warning "BSP FDT support indication not defined"
+#endif
+
#ifndef BSP_FDT_BLOB_SIZE_MAX
#define BSP_FDT_BLOB_SIZE_MAX 0
#endif