xref: /aosp_15_r20/external/pigweed/pw_thread_embos/sleep.cc (revision 61c4878ac05f98d0ceed94b57d316916de578985)
1*61c4878aSAndroid Build Coastguard Worker // Copyright 2021 The Pigweed Authors
2*61c4878aSAndroid Build Coastguard Worker //
3*61c4878aSAndroid Build Coastguard Worker // Licensed under the Apache License, Version 2.0 (the "License"); you may not
4*61c4878aSAndroid Build Coastguard Worker // use this file except in compliance with the License. You may obtain a copy of
5*61c4878aSAndroid Build Coastguard Worker // the License at
6*61c4878aSAndroid Build Coastguard Worker //
7*61c4878aSAndroid Build Coastguard Worker //     https://www.apache.org/licenses/LICENSE-2.0
8*61c4878aSAndroid Build Coastguard Worker //
9*61c4878aSAndroid Build Coastguard Worker // Unless required by applicable law or agreed to in writing, software
10*61c4878aSAndroid Build Coastguard Worker // distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
11*61c4878aSAndroid Build Coastguard Worker // WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
12*61c4878aSAndroid Build Coastguard Worker // License for the specific language governing permissions and limitations under
13*61c4878aSAndroid Build Coastguard Worker // the License.
14*61c4878aSAndroid Build Coastguard Worker 
15*61c4878aSAndroid Build Coastguard Worker #include "pw_thread/sleep.h"
16*61c4878aSAndroid Build Coastguard Worker 
17*61c4878aSAndroid Build Coastguard Worker #include <algorithm>
18*61c4878aSAndroid Build Coastguard Worker 
19*61c4878aSAndroid Build Coastguard Worker #include "RTOS.h"
20*61c4878aSAndroid Build Coastguard Worker #include "pw_assert/check.h"
21*61c4878aSAndroid Build Coastguard Worker #include "pw_chrono/system_clock.h"
22*61c4878aSAndroid Build Coastguard Worker #include "pw_chrono_embos/system_clock_constants.h"
23*61c4878aSAndroid Build Coastguard Worker #include "pw_thread/thread.h"
24*61c4878aSAndroid Build Coastguard Worker 
25*61c4878aSAndroid Build Coastguard Worker using pw::chrono::SystemClock;
26*61c4878aSAndroid Build Coastguard Worker 
27*61c4878aSAndroid Build Coastguard Worker namespace pw::this_thread {
28*61c4878aSAndroid Build Coastguard Worker 
sleep_for(chrono::SystemClock::duration sleep_duration)29*61c4878aSAndroid Build Coastguard Worker void sleep_for(chrono::SystemClock::duration sleep_duration) {
30*61c4878aSAndroid Build Coastguard Worker   // Ensure we are invoking this from a thread.
31*61c4878aSAndroid Build Coastguard Worker   PW_DCHECK(get_id() != Thread::id());
32*61c4878aSAndroid Build Coastguard Worker 
33*61c4878aSAndroid Build Coastguard Worker   // Yield for negative and zero length durations.
34*61c4878aSAndroid Build Coastguard Worker   if (sleep_duration <= SystemClock::duration::zero()) {
35*61c4878aSAndroid Build Coastguard Worker     OS_Yield();
36*61c4878aSAndroid Build Coastguard Worker     return;
37*61c4878aSAndroid Build Coastguard Worker   }
38*61c4878aSAndroid Build Coastguard Worker 
39*61c4878aSAndroid Build Coastguard Worker   // In case the timeout is too long for us to express through the native
40*61c4878aSAndroid Build Coastguard Worker   // embOS API, we repeatedly wait with shorter durations. Note that on a tick
41*61c4878aSAndroid Build Coastguard Worker   // based kernel we cannot tell how far along we are on the current tick, ergo
42*61c4878aSAndroid Build Coastguard Worker   // we add one whole tick to the final duration. However, this also means that
43*61c4878aSAndroid Build Coastguard Worker   // the loop must ensure that timeout + 1 is less than the max timeout.
44*61c4878aSAndroid Build Coastguard Worker   constexpr SystemClock::duration kMaxTimeoutMinusOne =
45*61c4878aSAndroid Build Coastguard Worker       pw::chrono::embos::kMaxTimeout - SystemClock::duration(1);
46*61c4878aSAndroid Build Coastguard Worker   while (sleep_duration > kMaxTimeoutMinusOne) {
47*61c4878aSAndroid Build Coastguard Worker     OS_Delay(static_cast<OS_TIME>(kMaxTimeoutMinusOne.count()));
48*61c4878aSAndroid Build Coastguard Worker     sleep_duration -= kMaxTimeoutMinusOne;
49*61c4878aSAndroid Build Coastguard Worker   }
50*61c4878aSAndroid Build Coastguard Worker   // On a tick based kernel we cannot tell how far along we are on the current
51*61c4878aSAndroid Build Coastguard Worker   // tick, ergo we add one whole tick to the final duration.
52*61c4878aSAndroid Build Coastguard Worker   OS_Delay(static_cast<OS_TIME>(sleep_duration.count()) + 1);
53*61c4878aSAndroid Build Coastguard Worker }
54*61c4878aSAndroid Build Coastguard Worker 
55*61c4878aSAndroid Build Coastguard Worker }  // namespace pw::this_thread
56