uart: add API support for wide data

This adds API to support datum more than 8-bit wide. Drivers are
still responsible for the implementation.

Fixes #31914

Signed-off-by: Daniel Leung <[email protected]>

Author: dcpleung

drivers/serial/Kconfig

@@ -37,6 +37,13 @@ config SERIAL_INIT_PRIORITY
 	help
 	  Serial driver device initialization priority.
 
+config SERIAL_SUPPORT_WIDE_DATA
+	bool
+	help
+	  This is an option to be enabled by individual serial driver
+	  to signal that the driver and hardware support data longer
+	  than 8-bit.
+
 config UART_USE_RUNTIME_CONFIGURE
 	bool "Enable runtime configuration for UART controllers"
 	default y
@@ -83,6 +90,13 @@ config UART_DRV_CMD
 
 	  Says no if not sure.
 
+config UART_WIDE_DATA
+	bool "Enable API to support data longer than 8-bit"
+	help
+	  This enables the API to process data longer than 8-bit.
+	  This is up to the driver to implement the necessary functions
+	  to properly support this.
+
 comment "Serial Drivers"
 
 source "drivers/serial/Kconfig.b91"

drivers/serial/uart_handlers.c

@@ -33,6 +33,15 @@ static inline int z_vrfy_uart_poll_in(const struct device *dev,
 }
 #include <syscalls/uart_poll_in_mrsh.c>
 
+static inline int z_vrfy_uart_poll_in_u16(const struct device *dev,
+					  uint16_t *p_u16)
+{
+	Z_OOPS(Z_SYSCALL_DRIVER_UART(dev, poll_in));
+	Z_OOPS(Z_SYSCALL_MEMORY_WRITE(p_u16, sizeof(uint16_t)));
+	return z_impl_uart_poll_in_u16(dev, p_u16);
+}
+#include <syscalls/uart_poll_in_u16_mrsh.c>
+
 static inline void z_vrfy_uart_poll_out(const struct device *dev,
 					unsigned char out_char)
 {
@@ -41,6 +50,14 @@ static inline void z_vrfy_uart_poll_out(const struct device *dev,
 }
 #include <syscalls/uart_poll_out_mrsh.c>
 
+static inline void z_vrfy_uart_poll_out_u16(const struct device *dev,
+					    uint16_t out_u16)
+{
+	Z_OOPS(Z_SYSCALL_DRIVER_UART(dev, poll_out));
+	z_impl_uart_poll_out_u16((const struct device *)dev, out_u16);
+}
+#include <syscalls/uart_poll_out_u16_mrsh.c>
+
 static inline int z_vrfy_uart_config_get(const struct device *dev,
 					 struct uart_config *cfg)
 {
@@ -77,6 +94,18 @@ static inline int z_vrfy_uart_tx(const struct device *dev, const uint8_t *buf,
 }
 #include <syscalls/uart_tx_mrsh.c>
 
+#ifdef CONFIG_UART_WIDE_DATA
+static inline int z_vrfy_uart_tx_u16(const struct device *dev,
+				     const uint16_t *buf,
+				     size_t len, int32_t timeout)
+{
+	Z_OOPS(Z_SYSCALL_DRIVER_UART(dev, tx));
+	Z_OOPS(Z_SYSCALL_MEMORY_ARRAY_READ(buf, len, sizeof(uint16_t)));
+	return z_impl_uart_tx_u16(dev, buf, len, timeout);
+}
+#include <syscalls/uart_tx_u16_mrsh.c>
+#endif
+
 UART_SIMPLE(tx_abort);
 #include <syscalls/uart_tx_abort_mrsh.c>
 
@@ -90,6 +119,18 @@ static inline int z_vrfy_uart_rx_enable(const struct device *dev,
 }
 #include <syscalls/uart_rx_enable_mrsh.c>
 
+#ifdef CONFIG_UART_WIDE_DATA
+static inline int z_vrfy_uart_rx_enable_u16(const struct device *dev,
+					    uint16_t *buf,
+					    size_t len, int32_t timeout)
+{
+	Z_OOPS(Z_SYSCALL_DRIVER_UART(dev, rx_enable));
+	Z_OOPS(Z_SYSCALL_MEMORY_ARRAY_WRITE(buf, len, sizeof(uint16_t)));
+	return z_impl_uart_rx_enable_u16(dev, buf, len, timeout);
+}
+#include <syscalls/uart_rx_enable_u16_mrsh.c>
+#endif
+
 UART_SIMPLE(rx_disable);
 #include <syscalls/uart_rx_disable_mrsh.c>
 #endif /* CONFIG_UART_ASYNC_API */