summaryrefslogtreecommitdiffstats
path: root/bsps/include/grlib/ahbstat.h
diff options
context:
space:
mode:
Diffstat (limited to 'bsps/include/grlib/ahbstat.h')
-rw-r--r--bsps/include/grlib/ahbstat.h76
1 files changed, 76 insertions, 0 deletions
diff --git a/bsps/include/grlib/ahbstat.h b/bsps/include/grlib/ahbstat.h
new file mode 100644
index 0000000000..71e2330f69
--- /dev/null
+++ b/bsps/include/grlib/ahbstat.h
@@ -0,0 +1,76 @@
+/* AHBSTAT driver interface
+ *
+ * COPYRIGHT (c) 2011.
+ * Cobham Gaisler AB.
+ *
+ * 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 __AHBSTAT_H__
+#define __AHBSTAT_H__
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* AHBSTAT Registers layout */
+struct ahbstat_regs {
+ volatile uint32_t status;
+ volatile uint32_t failing;
+};
+
+/* AHB fail interrupt callback to user. This function is declared weak so that
+ * the user can define a function pointer variable containing the address
+ * responsible for handling errors
+ *
+ * minor Index of AHBSTAT hardware
+ * regs Register address of AHBSTAT
+ * status AHBSTAT status register at IRQ
+ * failing_address AHBSTAT Failing address register at IRQ
+ *
+ * * User return
+ * 0: print error onto terminal with printk and reenable AHBSTAT
+ * 1: just re-enable AHBSTAT
+ * 2: just print error
+ * 3: do nothing, let user do custom handling
+ */
+extern int (*ahbstat_error)(
+ int minor,
+ struct ahbstat_regs *regs,
+ uint32_t status,
+ uint32_t failing_address);
+
+/* Get Last received AHB Error
+ *
+ * \param minor Index used to indentify a specific AHBSTAT core
+ * \param status Status register at time of error IRQ was recevied
+ * \param address Failing address register at time of error IRQ
+ *
+ * Return
+ * 0: No error received
+ * 1: Error Received, last status and address stored into argument pointers
+ * -1: No such AHBSTAT device
+ */
+extern int ahbstat_last_error(int minor, uint32_t *status, uint32_t *address);
+
+/* Get AHBSTAT registers address from minor. Can also be used to check if
+ * AHBSTAT hardware is present.
+ *
+ * Return
+ * NULL returned if no such device
+ * non-zero Address to AHBSTAT register
+ */
+extern struct ahbstat_regs *ahbstat_get_regs(int minor);
+
+/* Registers the AHBSTAT driver to the Driver Manager */
+void ahbstat_register_drv (void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif