Merge pull request #137 from SuperHouse/feature/better_crash_dumps

Better crash dumps

core/include/common_macros.h

@@ -65,18 +65,16 @@
 */
 #define IRAM __attribute__((section(".iram1.text")))
 
-/* Use this macro to place read-only data into Instruction RAM (IRAM)
+/* Use this macro to place data into Instruction RAM (IRAM)
    instead of loaded into rodata which resides in DRAM.
 
+   (IRAM can also be written to as necessary.)
+
    This may be useful to free up data RAM. However all data read from
    the instruction space must be 32-bit aligned word reads
    (non-aligned reads will use an interrupt routine to "fix" them and
    still work, but are very slow..
 */
-#ifdef	__cplusplus
-    #define IRAM_DATA __attribute__((section(".iram1.rodata")))
-#else
-    #define IRAM_DATA __attribute__((section(".iram1.rodata"))) const
-#endif
+#define IRAM_DATA __attribute__((section(".iram1.rodata")))
 
 #endif

core/include/debug_dumps.h

@@ -0,0 +1,25 @@
+/* Functions for dumping status/debug output/etc, including fatal
+ * exception handling.
+ *
+ * Part of esp-open-rtos
+ *
+ * Copyright (C) 2015-2016 Superhouse Automation Pty Ltd
+ * BSD Licensed as described in the file LICENSE
+ */
+#ifndef _DEBUG_DUMPS_H
+#define _DEBUG_DUMPS_H
+#include <stdint.h>
+
+/* Dump stack memory to stdout, starting from stack pointer address sp. */
+void dump_stack(uint32_t *sp);
+
+/* Dump heap statistics to stdout */
+void dump_heapinfo(void);
+
+/* Called from exception_vectors.S when a fatal exception occurs.
+
+   Probably not useful to be called in other contexts.
+*/
+void __attribute__((noreturn)) fatal_exception_handler(uint32_t *sp, bool registers_saved_on_stack);
+
+#endif

core/include/xtensa_ops.h

@@ -14,6 +14,20 @@
 // GCC macros for reading, writing, and exchanging Xtensa processor special
 // registers:
 
+/* Read stack pointer to variable.
+ *
+ * Note that the compiler will push a stack frame (minimum 16 bytes)
+ * in the prelude of a C function that calls any other functions.
+ */
+#define SP(var) asm volatile ("mov %0, a1" : "=r" (var))
+
+/* Read the function return address to a variable.
+ *
+ * Depends on the containing function being simple enough that a0 is
+ * being used as a working register.
+ */
+#define RETADDR(var) asm volatile ("mov %0, a0" : "=r" (var))
+
 #define RSR(var, reg) asm volatile ("rsr %0, " #reg : "=r" (var));
 #define WSR(var, reg) asm volatile ("wsr %0, " #reg : : "r" (var));
 #define XSR(var, reg) asm volatile ("xsr %0, " #reg : "+r" (var));