参考代码

app/drivers/data_port/sb_data_port.c

@@ -0,0 +1,249 @@
+#include "drivers/data_port/sb_data_port.h"
+
+#include "os/os.h"
+
+#define CONFIG_SYS_LOG_LEVEL SYS_LOG_LEVEL_INF
+#define SYS_LOG_DOMAIN "DATA"
+#define CONS_ABORT()
+#include "sys_log.h"
+
+/**
+ * @brief 由具体驱动实现的，以达到节省资源为主要目的，启动数据接口
+ *
+ * @param port 由对应的驱动提供的绑定接口获得的句柄
+ * @retval 0 成功
+ */
+int sb_data_port_start(sb_data_port_t *port)
+{
+    if (sb_data_port_is_started(port))
+    {
+        SYS_LOG_WRN("Data interface repeat started");
+        return 0;
+    }
+    if (port == NULL || port->vtable == NULL)
+    {
+        return false;
+    }
+
+    if (port->vtable->start)
+    {
+        return port->vtable->start(port);
+    }
+    else
+    {
+        SYS_LOG_ERR("The data interface has not been defined");
+        return -1;
+    }
+}
+
+/**
+ * @brief 由具体驱动实现的，以达到节省资源为主要目的，关闭数据接口
+ *
+ * @param port 由对应的驱动提供的绑定接口获得的句柄
+ * @retval 0 成功
+ */
+int sb_data_port_stop(sb_data_port_t *port)
+{
+    if (!sb_data_port_is_started(port))
+    {
+        SYS_LOG_WRN("The data interface has not been started yet");
+        return 0;
+    }
+
+    if (port->vtable->stop)
+    {
+        return port->vtable->stop(port);
+    }
+    else
+    {
+        SYS_LOG_ERR("The data interface has not been defined");
+        return -1;
+    }
+}
+
+/**
+ * @brief 由具体驱动实现的，写数据到对应的接口。
+ * 建议这些数据将写入到驱动的缓存中，如果 wait_ms 为 0 立即返回，
+ * 如果 wait_ms > 0 则这个时间由本函数计时并处理，但期间可能出现堵塞。
+ * 注意如果有选择 wait_ms > 0 的情况，驱动中收取缓存的线程与应用不能是同一线程。
+ *
+ * @param port      由对应的驱动提供的绑定接口获得的句柄
+ * @param data      来源数据
+ * @param size      数据长度（字节）
+ * @param wait_ms   超时时间（毫秒）
+ * @retval < 0 操作失败或在指定的时间内未满足指定的操作长度
+ * @retval >= 0 实际已缓存的长度
+ */
+int sb_data_port_write(sb_data_port_t *port, const void *data, uint32_t size, uint32_t wait_ms)
+{
+    if (!sb_data_port_is_started(port))
+    {
+        SYS_LOG_WRN("The data interface has not been started yet");
+        return -1;
+    }
+
+    if (port->vtable->write)
+    {
+        int ret = 0;
+        int cmp_time = os_get_sys_time();
+        while (size)
+        {
+            int curr_time = os_get_sys_time();
+            int wsize = port->vtable->write(port, data, size);
+            if (wsize > 0)
+            {
+                cmp_time = curr_time;
+                data = &((uint8_t *)data)[wsize];
+                size -= wsize;
+                ret += wsize;
+            }
+            else if (wsize == 0)
+            {
+                if (wait_ms == 0)
+                {
+                    break;
+                }
+                else if (curr_time - cmp_time > wait_ms)
+                {
+                    return -1;
+                }
+                else
+                {
+                    os_thread_sleep(1);
+                    continue;
+                }
+            }
+            else
+            {
+                return -1;
+            }
+        }
+
+        return ret;
+    }
+    else
+    {
+        SYS_LOG_ERR("The data interface has not been defined");
+        return -1;
+    }
+}
+
+/**
+ * @brief 由具体驱动实现的，从数据接口中读取已缓存的数据。
+ * 如果 wait_ms 为 0 将立即返回，
+ * 如果 wait_ms > 0 则这个时间由本函数计时并处理，期间可能出现堵塞。
+ * 注意如果有选择 wait_ms > 0 的情况，驱动中收取缓存的线程与应用不能是同一线程。
+ *
+ * @param port          由对应的驱动提供的绑定接口获得的句柄
+ * @param buffer[out]   保存到目标内存。值为 NULL 表示仅释放空间
+ * @param length        目标内存长度（字节）
+ * @param wait_ms       超时时间（毫秒）
+ * @retval < 0 操作失败或在指定的时间内未满足指定的操作长度
+ * @retval >= 0 实际已读取的长度
+ */
+int sb_data_port_read(sb_data_port_t *port, void *buffer, uint32_t length, uint32_t wait_ms)
+{
+    if (!sb_data_port_is_started(port))
+    {
+        SYS_LOG_WRN("The data interface has not been started yet");
+        return -1;
+    }
+
+    if (port->vtable->read)
+    {
+        int ret = 0;
+        int cmp_time = os_get_sys_time();
+        while (length)
+        {
+            int curr_time = os_get_sys_time();
+            int rsize = port->vtable->read(port, buffer, length);
+            if (rsize > 0)
+            {
+                cmp_time = curr_time;
+                buffer = &((uint8_t *)buffer)[rsize];
+                length -= rsize;
+                ret += rsize;
+            }
+            else if (rsize == 0)
+            {
+                if (wait_ms == 0)
+                {
+                    break;
+                }
+                else if (curr_time - cmp_time > wait_ms)
+                {
+                    return -1;
+                }
+                else
+                {
+                    os_thread_sleep(1);
+                    continue;
+                }
+            }
+            else
+            {
+                return -1;
+            }
+        }
+
+        return ret;
+    }
+    else
+    {
+        SYS_LOG_ERR("The data interface has not been defined");
+        return -1;
+    }
+}
+
+/**
+ * @brief 由具体驱动实现的，获取当前数据接口是否可用（是否已启动）。
+ * 本套接口内部的所有其他接口内部都会优先经过这个接口确认状态，驱动内部的其他接口不需要二次确认。
+ *
+ * @param port 由对应的驱动提供的绑定接口获得的句柄
+ * @retval true 接口已启动并可用
+ * @retval false 接口未启动，不可用
+ */
+bool sb_data_port_is_started(sb_data_port_t *port)
+{
+    SYS_ASSERT(port, "Data interface not bound");
+    SYS_ASSERT(port->vtable, "Data interface not bound");
+
+    if (port == NULL || port->vtable == NULL)
+    {
+        return false;
+    }
+
+    if (port->vtable->is_started)
+    {
+        return port->vtable->is_started(port);
+    }
+    else
+    {
+        SYS_LOG_ERR("The data interface has not been defined");
+        return false;
+    }
+}
+
+/**
+ * @brief 由具体驱动实现的，获取当前数据接口的本次可读长度
+ *
+ * @param port 由对应的驱动提供的绑定接口获得的句柄
+ * @retval uint32_t sb_data_port_read() 当前可读取的接收缓存长度
+ */
+uint32_t sb_data_port_get_rx_length(sb_data_port_t *port)
+{
+    if (!sb_data_port_is_started(port))
+    {
+        return 0;
+    }
+
+    if (port->vtable->get_rx_length)
+    {
+        return port->vtable->get_rx_length(port);
+    }
+    else
+    {
+        SYS_LOG_ERR("The data interface has not been defined");
+        return -1;
+    }
+}