d0b8d0675e
1. remove the old msg queue and queue: i. msg queue is not a common and reusable/flexible component(need user to config the msg pool size and this componet can only be used by tos_queue) ii. tos_queue can only deliver the pointer message(cannot do a memory buffer deliver) 2. add ring queue(tos_ring_q) componet rinq queue can be reused by tos_chr_fifi/tos_msg_q/tos_mail_q as the foundational data container 3. add message queue(tos_msg_q) a little like the old queue mechanism, supply the capability to deliver a pointer message 4. add mail queue(tos_mail_q) supply the capability to deliver a memory buffer 5. add binary heap(tos_bin_heap) the basement componet to implement priority queue 6. add priority queue(tos_prio_q) can be reused by the priority message/mail queue as the foundational data container. 7. add priority message queue(tos_prio_msg_q) a message(pointer) deliver mechanism, supply the capability of delivering the message with priority(message with higher priority comes faster to the pender than with lower) 8. add priority mail queue(tos_prio_mail_q) a mail(memory buffer) deliver mechanism, supply the capability of delivering the mail with priority(mail with higher priority comes faster to the pender than with lower)
92 lines
3.4 KiB
C
92 lines
3.4 KiB
C
/*----------------------------------------------------------------------------
|
|
* Tencent is pleased to support the open source community by making TencentOS
|
|
* available.
|
|
*
|
|
* Copyright (C) 2019 THL A29 Limited, a Tencent company. All rights reserved.
|
|
* If you have downloaded a copy of the TencentOS binary from Tencent, please
|
|
* note that the TencentOS binary is licensed under the BSD 3-Clause License.
|
|
*
|
|
* If you have downloaded a copy of the TencentOS source code from Tencent,
|
|
* please note that TencentOS source code is licensed under the BSD 3-Clause
|
|
* License, except for the third-party components listed below which are
|
|
* subject to different license terms. Your integration of TencentOS into your
|
|
* own projects may require compliance with the BSD 3-Clause License, as well
|
|
* as the other licenses applicable to the third-party components included
|
|
* within TencentOS.
|
|
*---------------------------------------------------------------------------*/
|
|
|
|
#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_MAIL_QUEUE = 0x4BEE,
|
|
PEND_TYPE_MESSAGE_QUEUE = 0x5BEE,
|
|
PEND_TYPE_PRIORITY_MAIL_QUEUE = 0x6BEE,
|
|
PEND_TYPE_PRIORITY_MESSAGE_QUEUE = 0x7BEE,
|
|
PEND_TYPE_COUNTDOWNLATCH = 0x8BEE,
|
|
PEND_TYPE_COMPLETION = 0x9BEE,
|
|
} 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_pending_prio_get(pend_obj_t *object);
|
|
|
|
__KERNEL__ k_task_t *pend_highest_pending_task_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_ */
|
|
|