1 /*
2 * Copyright (c) 2017 - 2023, 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 #include <stddef.h>
36
37 #include "nrf_802154.h"
38 #include "nrf_802154_stats.h"
39
40 #define NUMBER_OF_STAT_COUNTERS (sizeof(nrf_802154_stat_counters_t) / sizeof(uint32_t))
41 #define NUMBER_OF_STAT_TOTALS (sizeof(nrf_802154_stat_totals_t) / sizeof(uint64_t))
42
43 /**@brief Structure holding statistics about the Radio Driver behavior. */
44 volatile nrf_802154_stats_t g_nrf_802154_stats;
45
46 /**@brief Structure holding total times spent in certain states. */
47 volatile nrf_802154_stat_totals_t g_nrf_802154_stat_totals;
48
nrf_802154_stats_get(nrf_802154_stats_t * p_stats)49 void nrf_802154_stats_get(nrf_802154_stats_t * p_stats)
50 {
51 *p_stats = g_nrf_802154_stats;
52 }
53
nrf_802154_stat_counters_get(nrf_802154_stat_counters_t * p_stat_counters)54 void nrf_802154_stat_counters_get(nrf_802154_stat_counters_t * p_stat_counters)
55 {
56 *p_stat_counters = g_nrf_802154_stats.counters;
57 }
58
nrf_802154_stat_counters_subtract(const nrf_802154_stat_counters_t * p_stat_counters)59 void nrf_802154_stat_counters_subtract(const nrf_802154_stat_counters_t * p_stat_counters)
60 {
61 volatile uint32_t * p_dst = (volatile uint32_t *)(&g_nrf_802154_stats.counters);
62 const uint32_t * p_src = (const uint32_t *)p_stat_counters;
63
64 for (size_t i = 0; i < NUMBER_OF_STAT_COUNTERS; ++i)
65 {
66 nrf_802154_mcu_critical_state_t mcu_cs;
67
68 nrf_802154_mcu_critical_enter(mcu_cs);
69 *p_dst -= *p_src;
70 nrf_802154_mcu_critical_exit(mcu_cs);
71
72 p_dst++;
73 p_src++;
74 }
75 }
76
nrf_802154_stat_timestamps_get(nrf_802154_stat_timestamps_t * p_stat_timestamps)77 void nrf_802154_stat_timestamps_get(nrf_802154_stat_timestamps_t * p_stat_timestamps)
78 {
79 *p_stat_timestamps = g_nrf_802154_stats.timestamps;
80 }
81
nrf_802154_stat_counters_reset(void)82 void nrf_802154_stat_counters_reset(void)
83 {
84 volatile uint32_t * p_dst = (volatile uint32_t *)(&g_nrf_802154_stats.counters);
85
86 for (size_t i = 0; i < NUMBER_OF_STAT_COUNTERS; ++i)
87 {
88 *(p_dst++) = 0U;
89 }
90 }
91
nrf_802154_stat_totals_get(nrf_802154_stat_totals_t * p_stat_totals)92 void nrf_802154_stat_totals_get(nrf_802154_stat_totals_t * p_stat_totals)
93 {
94 volatile uint64_t * p_dst = (volatile uint64_t *)p_stat_totals;
95 const uint64_t * p_src = (const uint64_t *)(&g_nrf_802154_stat_totals);
96
97 nrf_802154_stat_totals_get_notify();
98
99 for (size_t i = 0; i < NUMBER_OF_STAT_TOTALS; ++i)
100 {
101 nrf_802154_mcu_critical_state_t mcu_cs;
102
103 nrf_802154_mcu_critical_enter(mcu_cs);
104 *p_dst = *p_src;
105 nrf_802154_mcu_critical_exit(mcu_cs);
106
107 p_dst++;
108 p_src++;
109 }
110 }
111
nrf_802154_stat_totals_get_notify(void)112 __WEAK void nrf_802154_stat_totals_get_notify(void)
113 {
114 /* Implementation here is intentionally empty.
115 *
116 * Implementation can be provided by other module to update g_nrf_802154_stat_totals
117 * to hold state until the moment of call.
118 */
119 }
120
