1 /*
2  * Copyright (c) 2017, Nordic Semiconductor ASA
3  * All rights reserved.
4  *
5  * SPDX-License-Identifier: BSD-3-Clause
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions are met:
9  *
10  * 1. Redistributions of source code must retain the above copyright notice, this
11  *    list of conditions and the following disclaimer.
12  *
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
18  *    contributors may be used to endorse or promote products derived from this
19  *    software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
25  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  *
33  */
34 
35 #ifndef NRF_802154_RSCH_CRIT_SECT_H__
36 #define NRF_802154_RSCH_CRIT_SECT_H__
37 
38 #include <stdbool.h>
39 
40 #include "rsch/nrf_802154_rsch.h"
41 
42 /**
43  * @defgroup nrf_802154_rsch_crit_sect RSCH event queue used during critical sections
44  * @{
45  * @ingroup nrf_802154_rsch
46  */
47 
48 /**
49  * @brief Initializes the RSCH critical section module.
50  */
51 void nrf_802154_rsch_crit_sect_init(void);
52 
53 /**
54  * @brief Requests the priority level from RSCH through the critical section module.
55  *
56  * @param[in]  prio  Requested priority level.
57  */
58 void nrf_802154_rsch_crit_sect_prio_request(rsch_prio_t prio);
59 
60 /**
61  * @brief Notifies the core that the approved RSCH priority has changed.
62  *
63  * @note This function is called from the critical section context and does not preempt
64  *       other critical sections.
65  *
66  * @param[in]  prio  Approved priority level.
67  */
68 extern void nrf_802154_rsch_crit_sect_prio_changed(rsch_prio_t prio);
69 
70 /**
71  *@}
72  **/
73 
74 #endif // NRF_802154_RSCH_CRIT_SECT_H__
75