1 /*
2 * Copyright (c) 2024, 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 Wake-up End Device of the subset of IEEE 802.15.4 MAC primitives.
32 */
33
34 #include "sub_mac.hpp"
35
36 #if OPENTHREAD_CONFIG_WAKEUP_END_DEVICE_ENABLE
37
38 #include "instance/instance.hpp"
39
40 namespace ot {
41 namespace Mac {
42
43 RegisterLogModule("SubMac");
44
WedInit(void)45 void SubMac::WedInit(void)
46 {
47 mWakeupListenInterval = 0;
48 mWedTimer.Stop();
49 }
50
UpdateWakeupListening(bool aEnable,uint32_t aInterval,uint32_t aDuration,uint8_t aChannel)51 void SubMac::UpdateWakeupListening(bool aEnable, uint32_t aInterval, uint32_t aDuration, uint8_t aChannel)
52 {
53 VerifyOrExit(RadioSupportsReceiveTiming());
54
55 mWakeupListenInterval = aInterval;
56 mWakeupListenDuration = aDuration;
57 mWakeupChannel = aChannel;
58 mWedTimer.Stop();
59
60 if (aEnable)
61 {
62 mWedSampleTime = TimerMicro::GetNow() + kCslReceiveTimeAhead - mWakeupListenInterval;
63 mWedSampleTimeRadio = Get<Radio>().GetNow() + kCslReceiveTimeAhead - mWakeupListenInterval;
64
65 HandleWedTimer();
66 }
67
68 exit:
69 return;
70 }
71
HandleWedTimer(Timer & aTimer)72 void SubMac::HandleWedTimer(Timer &aTimer) { aTimer.Get<SubMac>().HandleWedTimer(); }
73
HandleWedTimer(void)74 void SubMac::HandleWedTimer(void)
75 {
76 mWedSampleTime += mWakeupListenInterval;
77 mWedSampleTimeRadio += mWakeupListenInterval;
78 mWedTimer.FireAt(mWedSampleTime + mWakeupListenDuration + kWedReceiveTimeAfter);
79
80 if (mState != kStateDisabled)
81 {
82 IgnoreError(
83 Get<Radio>().ReceiveAt(mWakeupChannel, static_cast<uint32_t>(mWedSampleTimeRadio), mWakeupListenDuration));
84 }
85 }
86
87 } // namespace Mac
88 } // namespace ot
89
90 #endif // OPENTHREAD_CONFIG_WAKEUP_END_DEVICE_ENABLE
91
