443 lines
12 KiB
C
443 lines
12 KiB
C
#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
|