1 /***************************************************************************//**
2  * @brief Packet API provides several functions to read detailed information from
3  * the received packet.
4  *
5  * Currently only RSSI reading is supported.
6  *******************************************************************************
7  * # License
8  * <b>Copyright 2023 Silicon Laboratories Inc. www.silabs.com</b>
9  *******************************************************************************
10  *
11  * SPDX-License-Identifier: Zlib
12  *
13  * The licensor of this software is Silicon Laboratories Inc.
14  *
15  * This software is provided 'as-is', without any express or implied
16  * warranty. In no event will the authors be held liable for any damages
17  * arising from the use of this software.
18  *
19  * Permission is granted to anyone to use this software for any purpose,
20  * including commercial applications, and to alter it and redistribute it
21  * freely, subject to the following restrictions:
22  *
23  * 1. The origin of this software must not be misrepresented; you must not
24  *    claim that you wrote the original software. If you use this software
25  *    in a product, an acknowledgment in the product documentation would be
26  *    appreciated but is not required.
27  * 2. Altered source versions must be plainly marked as such, and must not be
28  *    misrepresented as being the original software.
29  * 3. This notice may not be removed or altered from any source distribution.
30  *
31  ******************************************************************************/
32 
33 #ifndef SL_BTCTRL_PACKETS_H
34 #define SL_BTCTRL_PACKETS_H
35 
36 #include <stdint.h>
37 
38 typedef const void * sl_btctrl_packet_t;
39 
40 /***************************************************************************//**
41  * @addtogroup sl_btctrl_packets API to get detailed information of received packet
42  * @{
43  ******************************************************************************/
44 
45 /**
46  * Get RSSI of received packet
47  *
48  * @param packet Packet where the RSSI value is read from.
49  * @return Signed RSSI value of the given packet in dBm.
50  */
51 int8_t sl_btctrl_get_packet_rssi(sl_btctrl_packet_t packet);
52 
53 /** @} sl_btctrl_packets */
54 #endif
55