first commit for opensource

first commit for opensource

kernel/core/include/tos_pend.h

@@ -0,0 +1,67 @@
+#ifndef _TOS_PEND_H_
+#define  _TOS_PEND_H_
+
+typedef struct k_task_st k_task_t;
+
+/**
+ * The reason why we wakeup from a pend.
+ * when we wakeup, we need to know why.
+ */
+typedef enum pend_state_en {
+    PEND_STATE_NONE,        /**< nothing. */
+    PEND_STATE_POST,        /**< someone has post, we get what we want. */
+    PEND_STATE_TIMEOUT,     /**< a post has never came until time is out. */
+    PEND_STATE_DESTROY,      /**< someone has destroyed what we are pending for. */
+    PEND_STATE_OWNER_DIE,   /**< the pend object owner task is destroyed. */
+} pend_state_t;
+
+// what we are pending
+/* actually, it's some kind of magic number, mainly for identifing whether the pend
+   is initialized, or whether user pass the correct parameter.
+ */
+typedef enum pend_type_en {
+    PEND_TYPE_NONE      = 0x0000,
+    PEND_TYPE_SEM       = 0x1BEE,
+    PEND_TYPE_MUTEX     = 0x2BEE,
+    PEND_TYPE_EVENT     = 0x3BEE,
+    PEND_TYPE_QUEUE     = 0x4BEE,
+} pend_type_t;
+
+typedef enum opt_post_en {
+    OPT_POST_ONE,
+    OPT_POST_ALL,
+} opt_post_t;
+
+typedef struct pend_object_st {
+    pend_type_t     type;
+    k_list_t        list;
+} pend_obj_t;
+
+__KERNEL__ void     pend_object_init(pend_obj_t *object, pend_type_t type);
+
+__KERNEL__ void     pend_object_deinit(pend_obj_t *object);
+
+__KERNEL__ int      pend_object_verify(pend_obj_t *object, pend_type_t type);
+
+__KERNEL__ int      pend_is_nopending(pend_obj_t *object);
+
+__KERNEL__ k_prio_t pend_highest_prio_get(pend_obj_t *object);
+
+__KERNEL__ void     pend_list_remove(k_task_t *task);
+
+__KERNEL__ void     pend_list_adjust(k_task_t *task);
+
+__KERNEL__ k_err_t  pend_state2errno(pend_state_t state);
+
+__KERNEL__ void     pend_task_wakeup(k_task_t *task, pend_state_t state);
+
+__KERNEL__ void     pend_task_block(k_task_t *task, pend_obj_t *object, k_tick_t timeout);
+
+__KERNEL__ void     pend_wakeup_one(pend_obj_t *object, pend_state_t state);
+
+__KERNEL__ void     pend_wakeup_all(pend_obj_t *object, pend_state_t state);
+
+__KERNEL__ void     pend_wakeup(pend_obj_t *object, pend_state_t state, opt_post_t opt);
+
+#endif /* _TOS_PEND_H_ */
+