[ISSUE-34]: cleanup and some srcdoc

Author: SzigetiJ

examples/0uart/defines.h

@@ -1,5 +1,5 @@
 /*
- * Copyright 2024 SZIGETI János
+ * Copyright 2025 SZIGETI János
  *
  * This file is part of Bilis ESP32 Basic, which is released under GNU General Public License.version 3.
  * See LICENSE or <https://www.gnu.org/licenses/> for full license details.

examples/0uart/uartprint.c

@@ -6,15 +6,9 @@
  */
 #include <stdbool.h>
 #include <inttypes.h>
-#include <stdio.h>
-#include <string.h>
-#include <ctype.h>
 
-#include "gpio.h"
 #include "main.h"
 #include "defines.h"
-#include "typeaux.h"
-#include "print.h"
 #include "uart.h"
 #include "utils/uartutils.h"
 

src/utils/uartutils.c

@@ -22,8 +22,16 @@
 #include "uartutils.h"
 #include "typeaux.h"
 
-#define BUFFER_SIZE 100
+#define BUFFER_SIZE 128
 
+/**
+ * printf with UART TX buffer as destination.
+ * The UART TX buffer is fed via FIFO register byte-by-byte.
+ * @param psUART UART controller (destiny).
+ * @param pcFormat Format string.
+ * @param ... printf arguments
+ * @return number of sent bytes.
+ */
 int uart_printf(UART_Type *psUART, const char *pcFormat, ...) {
   char acBuf[BUFFER_SIZE];
   va_list va;