tests: add zephyr uart driver api test case

This commit verifies the following uart driver apis:
	uart_irq_callback_set()
	uart_irq_rx_enable()
	uart_irq_rx_disable()
	uart_irq_rx_ready()
	uart_irq_tx_enable()
	uart_irq_tx_disable()
	uart_irq_tx_ready()
	uart_fifo_fill()
	uart_fifo_read()
	uart_irq_update()
	uart_poll_in()
	uart_poll_out()

Change-Id: I9be9341aee4357f86a2bc49f19733fb84273e89c
Signed-off-by: Qiu Peiyang <[email protected]>

Author: QiuPeiyang

tests/drivers/uart/prj.conf

@@ -1,4 +1,4 @@
 BOARD ?= quark_se_c1000_devboard
-CONF_FILE = prj.conf
+CONF_FILE = prj.conf # set prj_shell.conf if debugging tc
 
 include ${ZEPHYR_BASE}/Makefile.test

tests/drivers/uart/src/Makefile

@@ -0,0 +1,3 @@
+CONFIG_SERIAL=y
+CONFIG_UART_INTERRUPT_DRIVEN=y
+CONFIG_ZTEST=y

tests/drivers/uart/src/main.c

@@ -0,0 +1,6 @@
+CONFIG_SERIAL=y
+CONFIG_UART_INTERRUPT_DRIVEN=y
+CONFIG_ZTEST=y
+
+CONFIG_CONSOLE_HANDLER=y
+CONFIG_CONSOLE_SHELL=y

tests/drivers/uart/Makefile renamed to tests/drivers/uart/uart_basic_api/Makefile

@@ -0,0 +1,3 @@
+include $(ZEPHYR_BASE)/tests/Makefile.test
+
+obj-y += main.o test_uart_poll.o test_uart_fifo.o

tests/drivers/uart/uart_basic_api/prj.conf

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2016 Intel Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @addtogroup t_driver_uart
+ * @{
+ * @defgroup t_uart_basic test_uart_basic_operations
+ * @}
+ */
+
+#include <test_uart.h>
+
+#ifdef CONFIG_CONSOLE_SHELL
+TC_CMD_DEFINE(test_uart_fifo_read)
+TC_CMD_DEFINE(test_uart_fifo_fill)
+TC_CMD_DEFINE(test_uart_poll_in)
+TC_CMD_DEFINE(test_uart_poll_out)
+#endif
+
+void test_main(void)
+{
+#ifdef CONFIG_CONSOLE_SHELL
+	/* initialize shell commands */
+	static const struct shell_cmd commands[] = {
+		TC_CMD_ITEM(test_uart_fifo_read),
+		TC_CMD_ITEM(test_uart_fifo_fill),
+		TC_CMD_ITEM(test_uart_poll_in),
+		TC_CMD_ITEM(test_uart_poll_out),
+		{ NULL, NULL }
+	};
+	SHELL_REGISTER("uart", commands);
+	shell_register_default_module("uart");
+#else
+	ztest_test_suite(uart_basic_test,
+			 ztest_unit_test(test_uart_fifo_fill),
+			 ztest_unit_test(test_uart_poll_out));
+	ztest_run_test_suite(uart_basic_test);
+#endif
+}

tests/drivers/uart/uart_basic_api/prj_shell.conf

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2016 Intel Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @file
+ * @brief UART cases header file
+ *
+ * Header file for UART cases
+ */
+
+#ifndef __TEST_UART_H__
+#define __TEST_UART_H__
+
+#include <uart.h>
+#include <ztest.h>
+
+#define UART_DEVICE_NAME CONFIG_UART_CONSOLE_ON_DEV_NAME
+
+void test_uart_poll_out(void);
+void test_uart_fifo_fill(void);
+void test_uart_fifo_read(void);
+void test_uart_poll_in(void);
+
+#endif /* __TEST_UART_H__ */

tests/drivers/uart/uart_basic_api/src/Makefile

@@ -0,0 +1,133 @@
+/*
+ * Copyright (c) 2016 Intel Corporation
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*
+ * @addtogroup t_uart_basic
+ * @{
+ * @defgroup t_uart_fifo test_uart_fifo
+ * @brief TestPurpose: verify UART works well in fifo mode
+ * @details
+ * - Test Steps
+ *   - FIFO Output:
+ *      -# Set UART IRQ callback using uart_irq_callback_set().
+ *      -# Enable UART TX IRQ using uart_irq_tx_enable().
+ *      -# Output the prepared data using uart_fifo_fill().
+ *      -# Disable UART TX IRQ using uart_irq_tx_disable().
+ *      -# Compare the number of characters sent out with the
+ *         original data size.
+ *   - FIFO Input:
+ *      -# Set UART IRQ callback using uart_irq_callback_set().
+ *      -# Enable UART RX IRQ using uart_irq_rx_enable().
+ *      -# Wait for data sent to UART console and trigger RX IRQ.
+ *      -# Read data from UART console using uart_fifo_read().
+ *      -# Disable UART TX IRQ using uart_irq_rx_disable().
+ * - Expected Results
+ *   -# When test UART FIFO output, the number of characters actually
+ *      sent out will be equal to the original length of the characters.
+ *   -# When test UART FIFO input, the app will wait for input from UART
+ *      console and exit after receiving one character.
+ * @}
+ */
+
+#include <test_uart.h>
+
+static volatile bool data_transmitted;
+static volatile bool data_received;
+static int char_sent;
+static const char *fifo_data = "This is a FIFO test.\r\n";
+
+#define DATA_SIZE	strlen(fifo_data)
+
+static void uart_fifo_callback(struct device *dev)
+{
+	char recvData;
+
+	/* Verify uart_irq_update() */
+	uart_irq_update(dev);
+
+	/* Verify uart_irq_tx_ready() */
+	if (uart_irq_tx_ready(dev)) {
+		data_transmitted = true;
+		char_sent++;
+	}
+
+	/* Verify uart_irq_rx_ready() */
+	if (uart_irq_rx_ready(dev)) {
+		/* Verify uart_fifo_read() */
+		uart_fifo_read(dev, &recvData, 1);
+		TC_PRINT("%c", recvData);
+
+		if (recvData == '\n') {
+			data_received = true;
+		}
+	}
+}
+
+static int test_fifo_read(void)
+{
+	struct device *uart_dev = device_get_binding(UART_DEVICE_NAME);
+
+	/* Verify uart_irq_callback_set() */
+	uart_irq_callback_set(uart_dev, uart_fifo_callback);
+
+	/* Enable Tx/Rx interrupt before using fifo */
+	/* Verify uart_irq_rx_enable() */
+	uart_irq_rx_enable(uart_dev);
+
+	TC_PRINT("Please send characters to serial console\n");
+
+	data_received = false;
+	while (data_received == false)
+		;
+	/* Verify uart_irq_rx_disable() */
+	uart_irq_rx_disable(uart_dev);
+
+	return TC_PASS;
+}
+
+static int test_fifo_fill(void)
+{
+	struct device *uart_dev = device_get_binding(UART_DEVICE_NAME);
+
+	char_sent = 0;
+
+	/* Verify uart_irq_callback_set() */
+	uart_irq_callback_set(uart_dev, uart_fifo_callback);
+
+	/* Enable Tx/Rx interrupt before using fifo */
+	/* Verify uart_irq_tx_enable() */
+	uart_irq_tx_enable(uart_dev);
+
+	/* Verify uart_fifo_fill() */
+	for (int i = 0; i < DATA_SIZE; i++) {
+		data_transmitted = false;
+		while (!uart_fifo_fill(uart_dev, &fifo_data[i], 1))
+			;
+		while (data_transmitted == false)
+			;
+	}
+
+	/* Verify uart_irq_tx_disable() */
+	uart_irq_tx_disable(uart_dev);
+
+	/* strlen() doesn't include \r\n*/
+	if (char_sent - 1 == DATA_SIZE) {
+		return TC_PASS;
+	} else {
+		return TC_FAIL;
+	}
+
+}
+
+void test_uart_fifo_fill(void)
+{
+	assert_true(test_fifo_fill() == TC_PASS, NULL);
+}
+
+void test_uart_fifo_read(void)
+{
+	assert_true(test_fifo_read() == TC_PASS, NULL);
+}