deprecate debug UART

2 files changed, 12 insertions, 2 deletions

diff --git a/watch-library/watch/watch_uart.c b/watch-library/watch/watch_uart.c
index a747e71b..3d97803d 100644
--- a/watch-library/watch/watch_uart.c
+++ b/watch-library/watch/watch_uart.c
@@ -80,6 +80,9 @@ void watch_debug_putc(char c) {
     SERCOM3->USART.DATA.reg = c;
 }
 
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wdeprecated-declarations"
 void watch_debug_puts(char *s) {
     while (*s) watch_debug_putc(*s++);
 }
+#pragma GCC diagnostic pop
diff --git a/watch-library/watch/watch_uart.h b/watch-library/watch/watch_uart.h
index a26d60d2..3c4f7aef 100644
--- a/watch-library/watch/watch_uart.h
+++ b/watch-library/watch/watch_uart.h
@@ -26,21 +26,28 @@
 /** @addtogroup debug Debug UART
   * @brief This section covers functions related to the debug UART, available on
   *        pin D1 of the 9-pin connector.
-  * @todo Refactor this as a USB CDC so that folks can debug over USB.
-  */
+  * @warning These functions were used early on in development, before the TinyUSB
+  *          CDC was implemented. You can now print debug messages to the USB console
+  *          using printf, rendering this bit irrelevant. These methods will likely
+  *          be refactored out in the future, in favor of a more full-featured UART
+  *          on the nine-pin connector.
+  **/
 /// @{
 /** @brief Initializes the debug UART.
   * @param baud The baud rate
   */
+__attribute__((deprecated("Use printf to log debug messages over USB.")))
 void watch_enable_debug_uart(uint32_t baud);
 
 /** @brief Outputs a single character on the debug UART.
   * @param c The character you wish to output.
   */
+__attribute__((deprecated("Use printf to log debug messages over USB.")))
 void watch_debug_putc(char c);
 
 /** @brief Outputs a string on the debug UART.
   * @param s A null-terminated string.
   */
+__attribute__((deprecated("Use printf to log debug messages over USB.")))
 void watch_debug_puts(char *s);
 /// @}