From 05c816960b0c3135349f794caf90761b1188d02b Mon Sep 17 00:00:00 2001 From: Joey Castillo Date: Mon, 13 Sep 2021 20:46:33 -0400 Subject: deprecate debug UART --- watch-library/watch/watch_uart.c | 3 +++ watch-library/watch/watch_uart.h | 11 +++++++++-- 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); /// @} -- cgit v1.2.3