From e5de956e247bd95dd250f758604bd0e15f298adb Mon Sep 17 00:00:00 2001
From: Roaming <rangerroaming@gmail.com>
Date: Fri, 24 Jun 2016 07:40:18 +0530
Subject: [PATCH] Created a UART API definition in softuart.h to allow the
 example code to access UART in a standard manner , irrespective of how it is
 implemented.

---
 examples/lights/lights.c |  1 +
 include/uart/api.h       | 94 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 95 insertions(+)
 create mode 100644 include/uart/api.h

diff --git a/examples/lights/lights.c b/examples/lights/lights.c
index 8d55d90..b570c60 100644
--- a/examples/lights/lights.c
+++ b/examples/lights/lights.c
@@ -20,6 +20,7 @@
 
 #include <lights.h>
 #include <delay.h>
+#include <uart/api.h>
 
 volatile __xdata BYTE* bytes[] = { &D2ON, &D3ON, &D4ON, &D5ON, &D2OFF, &D3OFF, &D4OFF, &D5OFF };
 
diff --git a/include/uart/api.h b/include/uart/api.h
new file mode 100644
index 0000000..6c14518
--- /dev/null
+++ b/include/uart/api.h
@@ -0,0 +1,94 @@
+/** \file include/uart/api.h
+ * This file is for defining a common API for accessing UARTs.
+ **/
+
+#ifndef UART_API_H
+#define UART_API_H
+
+#include "fx2types.h"
+#include "stdarg.h"
+
+/**
+ * \brief Initalizes UART.
+ * Returns TRUE if initialization is successful.
+ * \param Rate See uartX_set_baud().
+ **/
+BOOL uartX_init(enum uart_baud rate, ...);
+
+/**
+ * \brief enum Standard available baud rates.
+ * All enum values less than 0 are not to be used unless absolutely necessary.
+ * Enum values greater than 0 are supported.
+**/
+typedef enum {
+    BAUD_FASTEST = -2,	///< The fastest BAUD available on the system.
+    BAUD_ANY = -1,	///< Virtual baud, Most efficient BAUD rate for the UART.
+    BAUD_INVALID = 0,	///< A divider between actual baud rates and virtual baud rates.
+    BAUD_2400 = 1,	///< Sets the baud rate to 2400.
+    BAUD_4800 = 2,	///< Sets the baud rate to 4800.
+    BAUD_9600 = 3,	///< Sets the baud rate to 9600.
+    BAUD_19200 = 4,	///< Sets the baud rate to 19200.
+    BAUD_38400 = 5,	///< Sets the baud rate to 38400.
+    BAUD_57600 = 6,	///< Sets the baud rate to 57600.
+    BAUD_115200 = 7	///< Sets the baud rate to 115200.
+} uart_baud;
+
+/**
+ * \brief Sets the UART baud rate to one of the allowed parameters.
+ *   Possible Baud rates:
+ *    \li 2400
+ *    \li 4800
+ *    \li 9600
+ *    \li 19200
+ *    \li 28800
+ *    \li 38400
+ *    \li 57600
+ *    \li 115200
+ * Returns TRUE if successful.
+**/
+BOOL uartX_set_baud(uart_baud rate);
+
+/**
+ * \brief Returns the baud rate currently being used.
+**/
+uart_baud uartX_get_baud();
+
+/**
+ * \brief Transmits data through UART.
+ * \param c The character to be sent out.
+**/
+
+void uartX_tx(char c);
+
+/**
+ * \brief Returns if the next transmit call will block.
+ * FALSE - Non Blocking.
+ * TRUE - Blocking.
+**/
+
+BOOL uartX_tx_will_block();
+
+/**
+ * \brief Returns how many more bytes can be loaded into the buffer.
+**/
+BYTE uartX_tx_queue_len();
+
+/**
+ * \brief Receives data through UART.
+ * Returns one byte at a time from the queue.
+**/
+char uartX_rx();
+
+/**
+ * \brief Returns if the next receive call will block.
+ * FALSE - Non Blocking.
+ * TRUE - Blocking.
+**/
+BOOL uartX_rx_will_block();
+
+/**
+ * \brief Returns count number of bytes present in the buffer.
+**/
+BYTE uartX_rx_queue_len();
+
+#endif