1 /*
2  *  Copyright (c) 2019, The OpenThread Authors.
3  *  All rights reserved.
4  *
5  *  Redistribution and use in source and binary forms, with or without
6  *  modification, are permitted provided that the following conditions are met:
7  *  1. Redistributions of source code must retain the above copyright
8  *     notice, this list of conditions and the following disclaimer.
9  *  2. Redistributions in binary form must reproduce the above copyright
10  *     notice, this list of conditions and the following disclaimer in the
11  *     documentation and/or other materials provided with the distribution.
12  *  3. Neither the name of the copyright holder nor the
13  *     names of its contributors may be used to endorse or promote products
14  *     derived from this software without specific prior written permission.
15  *
16  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
17  *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
20  *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21  *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22  *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23  *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24  *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25  *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26  *  POSSIBILITY OF SUCH DAMAGE.
27  */
28 
29 /**
30  * @file
31  *   This file implements the radio callbacks.
32  */
33 
34 #include "radio.hpp"
35 
36 #include "common/instance.hpp"
37 #include "common/locator_getters.hpp"
38 
39 namespace ot {
40 
HandleReceiveDone(Mac::RxFrame * aFrame,Error aError)41 void Radio::Callbacks::HandleReceiveDone(Mac::RxFrame *aFrame, Error aError)
42 {
43 #if OPENTHREAD_CONFIG_RADIO_STATS_ENABLE && (OPENTHREAD_FTD || OPENTHREAD_MTD)
44     Get<RadioStatistics>().RecordRxDone(aError);
45 #endif
46     Get<Mac::SubMac>().HandleReceiveDone(aFrame, aError);
47 }
48 
HandleTransmitStarted(Mac::TxFrame & aFrame)49 void Radio::Callbacks::HandleTransmitStarted(Mac::TxFrame &aFrame) { Get<Mac::SubMac>().HandleTransmitStarted(aFrame); }
50 
HandleTransmitDone(Mac::TxFrame & aFrame,Mac::RxFrame * aAckFrame,Error aError)51 void Radio::Callbacks::HandleTransmitDone(Mac::TxFrame &aFrame, Mac::RxFrame *aAckFrame, Error aError)
52 {
53 #if OPENTHREAD_CONFIG_RADIO_STATS_ENABLE && (OPENTHREAD_FTD || OPENTHREAD_MTD)
54     Get<RadioStatistics>().RecordTxDone(aError, aFrame.GetLength());
55 #endif
56     Get<Mac::SubMac>().HandleTransmitDone(aFrame, aAckFrame, aError);
57 }
58 
HandleEnergyScanDone(int8_t aMaxRssi)59 void Radio::Callbacks::HandleEnergyScanDone(int8_t aMaxRssi) { Get<Mac::SubMac>().HandleEnergyScanDone(aMaxRssi); }
60 
61 #if OPENTHREAD_CONFIG_DIAG_ENABLE
HandleDiagsReceiveDone(Mac::RxFrame * aFrame,Error aError)62 void Radio::Callbacks::HandleDiagsReceiveDone(Mac::RxFrame *aFrame, Error aError)
63 {
64 #if OPENTHREAD_RADIO && !OPENTHREAD_RADIO_CLI
65     // Pass it to notify OpenThread `Diags` module on host side.
66     HandleReceiveDone(aFrame, aError);
67 #else // For OPENTHREAD_FTD, OPENTHREAD_MTD and OPENTHREAD_RADIO(CLI)
68     Get<FactoryDiags::Diags>().ReceiveDone(aFrame, aError);
69 #endif
70 }
71 
HandleDiagsTransmitDone(Mac::TxFrame & aFrame,Error aError)72 void Radio::Callbacks::HandleDiagsTransmitDone(Mac::TxFrame &aFrame, Error aError)
73 {
74 #if OPENTHREAD_RADIO && !OPENTHREAD_RADIO_CLI
75     // Pass it to notify OpenThread `Diags` module on host side.
76     HandleTransmitDone(aFrame, nullptr, aError);
77 #else // For OPENTHREAD_FTD, OPENTHREAD_MTD and OPENTHREAD_RADIO(CLI)
78     OT_UNUSED_VARIABLE(aFrame);
79     Get<FactoryDiags::Diags>().TransmitDone(aError);
80 #endif
81 }
82 #endif // OPENTHREAD_CONFIG_DIAG_ENABLE
83 
84 } // namespace ot
85