1 files changed, 29 insertions, 0 deletions
diff --git a/robot/errcatch.h b/robot/errcatch.h
index 48e2a75..2297886 100644
--- a/robot/errcatch.h
+++ b/robot/errcatch.h
@@ -4,11 +4,40 @@
 
 #include "consts.h"
 
+/**
+ * error struct
+ *
+ * holds an error with type `code`, and an optional `message` with length
+ * `message_length`
+ */
+typedef struct {
+	enum w2_e_errorcodes code;
+	uint8_t message_length;
+	char message[];
+} w2_s_error;
+
+/** error ring buffer */
+extern w2_s_error g_w2_error_buffer[W2_ERROR_BUFFER_SIZE];
+/** stores head of ring buffer */
+extern uint8_t g_w2_error_index;
+/** stores start of ring buffer */
+extern uint8_t g_w2_error_offset;
+
 /** error-handler module main */
 void w2_errcatch_main();
 
+/** handle error */
+void w2_errcatch_handle_error(w2_s_error *error);
+
 /** append error to error buffer */
 void w2_errcatch_throw(enum w2_e_errorcodes code);
 
 /** append error to error buffer (with debug message) */
 void w2_errcatch_throw_msg(enum w2_e_errorcodes code, uint16_t length, const char *message);
+
+/**
+ * allocate and initialize error struct
+ *
+ * TODO: doesn't handle null pointers from calloc
+ */
+w2_s_error *w2_alloc_error(enum w2_e_errorcodes code, uint16_t length, const char *message);