safety interlocking and a bunch of other fun stuff

main/uart_comms.h

@@ -1,16 +1,21 @@
-/*
- * uart_comms.h
- *
- *  Created on: Dec 13, 2025
- *      Author: Thad
- */
-
-#ifndef MAIN_UART_COMMS_H_
-#define MAIN_UART_COMMS_H_
+#ifndef UART_COMMS_H
+#define UART_COMMS_H
 
 #include "esp_err.h"
 
-esp_err_t uart_init();
-esp_err_t uart_stop();
+/**
+ * Initialize UART communication interface
+ * Provides JSON-based GET/POST commands over serial
+ * 
+ * Commands:
+ *   GET                    - Returns complete system status as pretty-printed JSON
+ *   POST: {json data}      - Sends JSON command/parameter update
+ */
+esp_err_t uart_init(void);
 
-#endif /* MAIN_UART_COMMS_H_ */
+/**
+ * Stop UART communication interface
+ */
+esp_err_t uart_stop(void);
+
+#endif // UART_COMMS_H