/****************************************************************************

Copyright(c) 2019 by Aerospace C.Power (Chongqing) Microelectronics. ALL RIGHTS RESERVED.

This Information is proprietary to Aerospace C.Power (Chongqing) Microelectronics and MAY NOT
be copied by any method or incorporated into another program without
the express written consent of Aerospace C.Power. This Information or any portion
thereof remains the property of Aerospace C.Power. The Information contained herein
is believed to be accurate and Aerospace C.Power assumes no responsibility or
liability for its use in any way and conveys no license or title under
any patent or copyright and makes no representation or warranty that this
Information is free from patent or copyright infringement.

****************************************************************************/

#ifndef MAC_TASK_H
#define MAC_TASK_H

/* os shim includes */
#include "os_types.h"

/* mac module internal includes */
#include "mac.h"

#ifdef __cplusplus
extern "C" {
#endif

/*
 * mac_start_task() - start mac layer task
 * @glb:    pointer of mac global data
 *
 * return:
 *      0         -- for success case
 *      othersie  -- error code
 */
uint32_t mac_start_task(mac_global_t *glb);

/*
 * mac_stop_task() - stop mac layer task
 * @glb:    pointer of mac global data
 */
void mac_stop_task(mac_global_t *glb);

/*
 * mac_handle_msg_cancel() - handle cancel mac message
 * @glb:    pointer of mac global data
 * @msg:    the message to be canceled
 * return:  none
 */
void mac_handle_msg_cancel(mac_global_t *glb, mac_msg_t *msg);

/*
 * mac_boost_task_prio() - boost mac task priority to the highest value.
 *                         this function is mainly used in critical message
 *                         handling case only.
 */
void mac_boost_task_prio();

/*
 * mac_restore_task_prio() - restore task priority of mac task.
 *                           this function is mainly used in critical message
 *                           handling case only.
 */
void mac_restore_task_prio();


#ifdef __cplusplus
}
#endif

#endif /* MAC_TASK_H */