first

2025-10-29 13:10:02 +08:00
commit 49a07fa419
2284 changed files with 642060 additions and 0 deletions
--- a/include_lib/system/os/os_api.h
+++ b/include_lib/system/os/os_api.h
@ -0,0 +1,442 @@
+#ifndef   OS_API_H
+#define   OS_API_H
+
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+
+
+
+#include "generic/typedef.h"
+//#include "generic/list.h"
+#include "os/os_cpu.h"
+#include "os/os_error.h"
+#include "os/os_type.h"
+
+
+typedef void *TaskHandle_t;
+
+#define Q_MSG           0x100000
+#define Q_EVENT         0x200000
+#define Q_CALLBACK      0x300000
+#define Q_USER          0x400000
+
+#define  OS_DEL_NO_PEND               0u
+#define  OS_DEL_ALWAYS                1u
+
+#define  OS_TASK_DEL_REQ           0x01u
+#define  OS_TASK_DEL_RES           0x02u
+#define  OS_TASK_DEL_OK            0x03u
+
+
+#define  OS_TASK_SELF        (char *)0x1
+#define  OS_TASK_FATHER      (char *)0x2
+
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief reserved
+ */
+/* ----------------------------------------------------------------------------*/
+void os_init(void);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief reserved
+ */
+/* ----------------------------------------------------------------------------*/
+void os_start(void);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief reserved
+ */
+/* ----------------------------------------------------------------------------*/
+void os_init_tick(int);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 创建任务
+ *
+ * @param task 任务回调函数
+ * @param p_arg 传递给任务回调函数的参数
+ * @param prio 任务的优先级
+ * @param stksize 任务的堆栈大小, 单位(u32)
+ * @param qsize 任务的queue大小，单位(byte)
+ * @param name 任务名 (名字长度不能超过configMAX_TASK_NAME_LEN字节)
+ *
+ * @return 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_task_create(void (*task)(void *p_arg),
+                   void *p_arg,
+                   u8 prio,
+                   u32 stksize,
+                   int qsize,
+                   const char *name);
+
+int os_task_create_affinity_core(void (*task)(void *p_arg),
+                                 void *p_arg,
+                                 u8 prio,
+                                 u32 stksize,
+                                 int qsize,
+                                 const char *name,
+                                 u8 core);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 获取当前任务名
+ *
+ * @return 当前任务名
+ */
+/* ----------------------------------------------------------------------------*/
+const char *os_current_task();
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 删除任务
+ *
+ * @param name 任务名
+ *
+ * @return 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_task_del_req(const char *name);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 响应任务删除请求，标记资源已经释放，可以删除当前任
+ *
+ * @param name 任务名，任务自己可以用OS_TASK_SELF
+ *
+ * @return 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_task_del_res(const char *name);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 删除任务
+ *
+ * @param name 任务名
+ *
+ * @return 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_task_del(const char *name);
+
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 延时。中断函数或者关闭系统总中断的情况下不能调用此函数
+ *
+ * @param time_tick 延时时间
+ */
+/* ----------------------------------------------------------------------------*/
+void os_time_dly(int time_tick);
+
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 发送Q_USER类型taskq
+ *
+ * @param name 任务名
+ * @param argc 后面传入的参数的个数。发送的最大参数个数限制为8个int类型
+ *
+ * @return 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_taskq_post(const char *name, int argc, ...);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 非阻塞方式查询taskq
+ *
+ * @param argc 最大可获取的queue长度，单位(int)
+ * @param argv 存放queue的buf
+ *
+ * @return 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_taskq_accept(int argc, int *argv);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 阻塞方式获取taskq
+ *
+ * @param fmt 保留，传NULL
+ * @param argv 存放queue的buf
+ * @param argc 最大可获取的queue长度，单位(int)
+ *
+ * @return 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_taskq_pend(const char *fmt, int *argv, int argc);
+// int os_task_pend(const char *fmt, int *argv, int argc);
+// int __os_taskq_pend(int *argv, int argc, int tick);
+
+
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 发送指定类型的taskq
+ *
+ * @param name 任务名
+ * @param type queue类型
+ * @param argc 后面传入的参数的个数
+ * @param argv
+ *
+ * @return 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_taskq_post_type(const char *name, int type, int argc, int *argv);
+
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 发送Q_MSG类型的taskq
+ *
+ * @param name 任务名
+ * @param argc 后面参数的个数
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_taskq_post_msg(const char *name, int argc, ...);
+
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 发送Q_EVENT类型的taskq
+ *
+ * @param name 任务名
+ * @param argc 后面参数的个数
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_taskq_post_event(const char *name, int argc, ...);
+
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 删除指定类型的taskq
+ *
+ * @param name 任务名
+ * @param type taskq的类型
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_taskq_del_type(const char *name, int type);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 清除所有taskq
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_taskq_flush(void);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 创建信号量
+ *
+ * @param sem 信号量
+ * @param int 初始计数值
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_sem_create(OS_SEM *, int);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 非阻塞方式查询信号量
+ *
+ * @param sem 信号量
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_sem_accept(OS_SEM *);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 阻塞方式获取信号量
+ *
+ * @param sem 信号量
+ * @param timeout 等待时长，0表示一直等待
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_sem_pend(OS_SEM *, int timeout);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 发送信号量
+ *
+ * @param sem 信号量
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_sem_post(OS_SEM *);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 信号量删除
+ *
+ * @param sem 信号量
+ * @param block 保留
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_sem_del(OS_SEM *, int block);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 信号量设置
+ *
+ * @param sem 信号量
+ * @param cnt 计数值
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_sem_set(OS_SEM *, u16 cnt);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 信号量类型是否queueQUEUE_TYPE_COUNTING_SEMAPHORE
+ *
+ * @param true:信号量匹配, fail:信号量不匹配
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_sem_valid(OS_SEM *);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 判断信号量是否可用
+ *
+ * @param sem 信号量
+ *
+ * @reutrn 可用数量
+ */
+/* ----------------------------------------------------------------------------*/
+int os_sem_query(OS_SEM *);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 创建互斥量
+ *
+ * @param mutex 互斥量
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_mutex_create(OS_MUTEX *);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 非阻塞方式查询互斥量
+ *
+ * @param mutex:互斥量
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_mutex_accept(OS_MUTEX *);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 阻塞方式查询互斥量
+ *
+ * @param mutex 互斥量
+ * @param timeout 等待时间，0表示一直等待
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_mutex_pend(OS_MUTEX *, int timeout);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 发送斥量
+ *
+ * @param mutex 互斥量
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_mutex_post(OS_MUTEX *);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 删除斥量
+ *
+ * @param mutex 互斥量
+ * @param block 保留
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_mutex_del(OS_MUTEX *, int block);
+
+/* --------------------------------------------------------------------------*/
+/**
+ * @brief 互斥量类型是否queueQUEUE_TYPE_MUTEX
+ *
+ * @param true:互斥量匹配, fail:互斥量不匹配
+ *
+ * @reutrn 错误码
+ */
+/* ----------------------------------------------------------------------------*/
+int os_mutex_valid(OS_MUTEX *);
+
+/*struct os_msg *os_message_create(int size);
+
+int os_message_receive(struct os_msg **msg, int block_time);
+
+int os_message_send(const char *task_name, struct os_msg *msg, int msgflg);
+
+int os_message_delete(struct os_msg *msg);*/
+
+
+
+int os_q_create(OS_QUEUE *pevent, /*void **start, */QS size);
+
+int os_q_del(OS_QUEUE *pevent, u8 opt);
+
+int os_q_flush(OS_QUEUE *pevent);
+
+int os_q_pend(OS_QUEUE *pevent, int timeout, void *msg);
+
+int os_q_post(OS_QUEUE *pevent, void *msg);
+
+int os_q_query(OS_QUEUE *pevent);
+
+int os_q_valid(OS_QUEUE *pevent);
+
+int task_queue_post_event(const char *name, void *data, int len);
+
+void *os_task_get_handle(const char *name);
+
+void os_suspend_other_core(void);
+
+void os_resume_other_core(void);
+
+void os_system_info_output(void);
+
+#ifdef __cplusplus
+}
+#endif
+#endif