Update file headers, fix gpio call, add uart

Sync @file documentation comments from hal_* to board_* across board source/header files (gd32 and h3) for consistency. Replace FUNC_PREFIX(GpioWrite(...)) with gpio::Write(...) in ILI9341 to use the namespaced GPIO API. Add a GCC pragma to ignore -Wunused-parameter for GD32H7 in gd32xxxx.h to silence benign warnings. Add a new lib-gd32/include/uart.h providing a small uart namespace wrapper with inline constants and functions around the GD32 UART helpers for convenient use.

Author: vanvught

lib-board/include/board_statusled.h

@@ -1,5 +1,5 @@
 /**
- * @file hal_statusled.h
+ * @file board_statusled.h
  *
  */
 /* Copyright (C) 2025-2026 by Arjan van Vught mailto:info@gd32-dmx.org

lib-board/src/gd32/board_init.cpp

@@ -1,5 +1,5 @@
 /**
- * @file hal_init.cpp
+ * @file board_init.cpp
  *
  */
 /* Copyright (C) 2025-2026 by Arjan van Vught mailto:info@gd32-dmx.org

lib-board/src/gd32/board_reboot.cpp

@@ -1,5 +1,5 @@
 /**
- * @file hal_reboot.cpp
+ * @file board_reboot.cpp
  *
  */
 /* Copyright (C) 2025-2026 by Arjan van Vught mailto:info@gd32-dmx.org

lib-board/src/gd32/board_statusled.cpp

@@ -1,5 +1,5 @@
 /**
- * @file hal_statusled.cpp
+ * @file board_statusled.cpp
  *
  */
 /* Copyright (C) 2025 by Arjan van Vught mailto:info@gd32-dmx.org

lib-board/src/h3/board_init.cpp

@@ -1,5 +1,5 @@
 /**
- * @file hal_init.cpp
+ * @file board_init.cpp
  *
  */
 /* Copyright (C) 2018-2025 by Arjan van Vught mailto:info@gd32-dmx.org

lib-board/src/h3/board_reboot.cpp

@@ -1,5 +1,5 @@
 /**
- * @file hal_reboot.cpp
+ * @file board_reboot.cpp
  *
  */
 /* Copyright (C) 2025-2026 by Arjan van Vught mailto:info@gd32-dmx.org

lib-board/src/h3/board_statusled.cpp

@@ -1,5 +1,5 @@
 /**
- * @file hal_statusled.cpp
+ * @file board_statusled.cpp
  *
  */
 /* Copyright (C) 2025-2026 by Arjan van Vught mailto:info@gd32-dmx.org

lib-display/include/spi/ili9341.h

@@ -205,7 +205,7 @@ class ILI9341 : public Paint {
         rotate_ = nRotation;
     }
 
-    void SetBackLight(uint32_t value) { FUNC_PREFIX(GpioWrite(SPI_LCD_BL_GPIO, value == 0 ? LOW : HIGH)); }
+    void SetBackLight(uint32_t value) { gpio::Write(SPI_LCD_BL_GPIO, value == 0 ? LOW : HIGH); }
 
     void EnableDisplay(bool enable) { WriteCommand(enable ? ili9341::cmd::DISPON : ili9341::cmd::DISPOFF); }
 

lib-gd32/include/gd32xxxx.h

@@ -50,6 +50,7 @@
 #elif defined(GD32F407) || defined(GD32F450) || defined(GD32F470)
 #include "gd32f4xx.h" // IWYU pragma: keep
 #elif defined(GD32H757) || defined(GD32H759)
+#pragma GCC diagnostic ignored "-Wunused-parameter"
 #include "gd32h7xx.h" // IWYU pragma: keep
 #else
 #error MCU is not supported

lib-gd32/include/uart.h

@@ -0,0 +1,67 @@
+/**
+ * @file uart.h
+ * @brief GD32
+ */
+/* Copyright (C) 2026 by Arjan van Vught mailto:info@gd32-dmx.org
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#ifndef UART_H_
+#define UART_H_
+
+#include "gd32_uart.h"
+
+namespace uart {
+  inline constexpr auto BITS_8 = gd32::kUartBits8;
+  inline constexpr auto BITS_9 = gd32::kUartBits9;
+
+  inline constexpr auto PARITY_NONE = gd32::kUartParityNone;
+  inline constexpr auto PARITY_ODD = gd32::kUartParityOdd;
+  inline constexpr auto PARITY_EVEN = gd32::kUartParityEven;
+
+  inline constexpr auto STOP_1BIT = gd32::kUartStop1Bit;
+  inline constexpr auto STOP_2BITS = gd32::kUartStop2Bits;
+
+inline void Begin(uint32_t uart_base, uint32_t baudrate, uint32_t bits, uint32_t parity, uint32_t stop_bits) {
+    Gd32UartBegin(uart_base, baudrate, bits, parity, stop_bits);
+}
+
+inline void SetBaudrate(uint32_t uart_base, uint32_t baudrate) {
+    Gd32UartSetBaudrate(uart_base, baudrate);
+}
+
+inline void Transmit(uint32_t uart_base, const uint8_t* data, uint32_t length) {
+    Gd32UartTransmit(uart_base, data, length);
+}
+
+inline void TransmitString(uint32_t uart_base, const char* data) {
+    Gd32UartTransmitString(uart_base, data);
+}
+
+inline uint32_t GetRxFifoLevel(uint32_t uart_base) {
+    return Gd32UartGetRxFifoLevel(uart_base);
+}
+
+inline uint8_t GetRxData(uint32_t uart_base) {
+    return Gd32UartGetRxData(uart_base);
+}
+} // namespace uart
+
+#endif // UART_H_