Implement full SSD1306 OLED display support: - Splash screen on boot (1.5s) with project name, version, board - Dashboard showing radio state, config, counters, RSSI/SNR - RSSI history sparkline (64-sample ring buffer, 2px-wide bars) - DisplayOn/DisplayOff host commands routed via dedicated channel - Pure render functions against generic DrawTarget (no hardware coupling) - Display on/off control bypasses radio task entirely Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
966 lines
36 KiB
Rust
966 lines
36 KiB
Rust
use crate::helpers::{self, Helpers};
|
|
use crate::Rate;
|
|
use core::cmp::Ordering;
|
|
use core::convert;
|
|
use core::ops;
|
|
|
|
/// Represents a duration of time.
|
|
///
|
|
/// The generic `T` can either be `u32` or `u64`, and the const generics represent the ratio of the
|
|
/// ticks contained within the duration: `duration in seconds = NOM / DENOM * ticks`
|
|
#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
|
|
#[cfg_attr(
|
|
feature = "postcard_max_size",
|
|
derive(postcard::experimental::max_size::MaxSize)
|
|
)]
|
|
#[derive(Clone, Copy, Debug)]
|
|
pub struct Duration<T, const NOM: u32, const DENOM: u32> {
|
|
pub(crate) ticks: T,
|
|
}
|
|
|
|
macro_rules! shorthand {
|
|
($i:ty, $nom:literal, $denum:literal, $unit:ident, $to_unit:ident, $unital:ident, $unitstr:literal) => {
|
|
#[doc = concat!("Convert the Duration to an integer number of ", $unitstr, ".")]
|
|
#[inline]
|
|
pub const fn $to_unit(&self) -> $i {
|
|
(Helpers::<$nom, $denum, NOM, DENOM>::LD_TIMES_RN as $i * self.ticks)
|
|
/ Helpers::<$nom, $denum, NOM, DENOM>::RD_TIMES_LN as $i
|
|
}
|
|
|
|
#[doc = concat!("Shorthand for creating a duration which represents ", $unitstr, ".")]
|
|
#[inline]
|
|
pub const fn $unit(val: $i) -> Self {
|
|
Self::from_ticks(
|
|
(Helpers::<$nom, $denum, NOM, DENOM>::RD_TIMES_LN as $i * val)
|
|
/ Helpers::<$nom, $denum, NOM, DENOM>::LD_TIMES_RN as $i
|
|
)
|
|
}
|
|
|
|
#[doc = concat!("Shorthand for creating a duration which represents ", $unitstr, " (ceil rounded).")]
|
|
#[inline]
|
|
pub const fn $unital(val: $i) -> Self {
|
|
let mul = Helpers::<$nom, $denum, NOM, DENOM>::RD_TIMES_LN as $i * val;
|
|
let ld_times_rn = Helpers::<$nom, $denum, NOM, DENOM>::LD_TIMES_RN as $i;
|
|
Self::from_ticks(if mul % ld_times_rn == 0 {
|
|
mul / ld_times_rn
|
|
} else {
|
|
mul / ld_times_rn + 1
|
|
})
|
|
}
|
|
};
|
|
}
|
|
|
|
macro_rules! impl_duration_for_integer {
|
|
($i:ty) => {
|
|
impl<const NOM: u32, const DENOM: u32> Duration<$i, NOM, DENOM> {
|
|
/// Create a `Duration` from a ticks value.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let _d = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(1);")]
|
|
/// ```
|
|
#[inline]
|
|
pub const fn from_ticks(ticks: $i) -> Self {
|
|
helpers::greater_than_0::<NOM>();
|
|
helpers::greater_than_0::<DENOM>();
|
|
|
|
Duration { ticks }
|
|
}
|
|
|
|
/// Extract the ticks from a `Duration`.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let d = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(234);")]
|
|
///
|
|
/// assert_eq!(d.ticks(), 234);
|
|
/// ```
|
|
#[inline]
|
|
pub const fn ticks(&self) -> $i {
|
|
self.ticks
|
|
}
|
|
|
|
/// Returns true if this `Duration` spans no time
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let zero = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(0);")]
|
|
#[doc = concat!("let one = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(1);")]
|
|
///
|
|
/// assert_eq!(zero.is_zero(), true);
|
|
/// assert_eq!(one.is_zero(), false);
|
|
/// ```
|
|
#[inline]
|
|
pub const fn is_zero(&self) -> bool {
|
|
self.ticks == 0
|
|
}
|
|
|
|
/// Add two durations while checking for overflow.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let d1 = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(1);")]
|
|
#[doc = concat!("let d2 = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(2);")]
|
|
#[doc = concat!("let d3 = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(", stringify!($i), "::MAX);")]
|
|
///
|
|
/// assert_eq!(d1.checked_add(d2).unwrap().ticks(), 3);
|
|
/// assert_eq!(d1.checked_add(d3), None);
|
|
/// ```
|
|
pub const fn checked_add<const O_NOM: u32, const O_DENOM: u32>(
|
|
self,
|
|
other: Duration<$i, O_NOM, O_DENOM>,
|
|
) -> Option<Self> {
|
|
if Helpers::<NOM, DENOM, O_NOM, O_DENOM>::SAME_BASE {
|
|
if let Some(ticks) = self.ticks.checked_add(other.ticks) {
|
|
Some(Duration::<$i, NOM, DENOM>::from_ticks(ticks))
|
|
} else {
|
|
None
|
|
}
|
|
} else {
|
|
if let Some(lh) = other
|
|
.ticks
|
|
.checked_mul(Helpers::<NOM, DENOM, O_NOM, O_DENOM>::LD_TIMES_RN as $i)
|
|
{
|
|
let ticks = lh / Helpers::<NOM, DENOM, O_NOM, O_DENOM>::RD_TIMES_LN as $i;
|
|
|
|
if let Some(ticks) = self.ticks.checked_add(ticks) {
|
|
Some(Duration::<$i, NOM, DENOM>::from_ticks(ticks))
|
|
} else {
|
|
None
|
|
}
|
|
} else {
|
|
None
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Subtract two durations while checking for overflow.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let d1 = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(1);")]
|
|
#[doc = concat!("let d2 = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(2);")]
|
|
#[doc = concat!("let d3 = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(", stringify!($i), "::MAX);")]
|
|
///
|
|
/// assert_eq!(d2.checked_sub(d1).unwrap().ticks(), 1);
|
|
/// assert_eq!(d1.checked_sub(d3), None);
|
|
/// ```
|
|
pub const fn checked_sub<const O_NOM: u32, const O_DENOM: u32>(
|
|
self,
|
|
other: Duration<$i, O_NOM, O_DENOM>,
|
|
) -> Option<Self> {
|
|
if Helpers::<NOM, DENOM, O_NOM, O_DENOM>::SAME_BASE {
|
|
if let Some(ticks) = self.ticks.checked_sub(other.ticks) {
|
|
Some(Duration::<$i, NOM, DENOM>::from_ticks(ticks))
|
|
} else {
|
|
None
|
|
}
|
|
} else {
|
|
if let Some(lh) = other
|
|
.ticks
|
|
.checked_mul(Helpers::<NOM, DENOM, O_NOM, O_DENOM>::LD_TIMES_RN as $i)
|
|
{
|
|
let ticks = lh / Helpers::<NOM, DENOM, O_NOM, O_DENOM>::RD_TIMES_LN as $i;
|
|
|
|
if let Some(ticks) = self.ticks.checked_sub(ticks) {
|
|
Some(Duration::<$i, NOM, DENOM>::from_ticks(ticks))
|
|
} else {
|
|
None
|
|
}
|
|
} else {
|
|
None
|
|
}
|
|
}
|
|
}
|
|
|
|
#[doc = concat!("Const `cmp` for ", stringify!($i))]
|
|
#[inline(always)]
|
|
const fn _const_cmp(a: $i, b: $i) -> Ordering {
|
|
if a < b {
|
|
Ordering::Less
|
|
} else if a > b {
|
|
Ordering::Greater
|
|
} else {
|
|
Ordering::Equal
|
|
}
|
|
}
|
|
|
|
/// Const partial comparison.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let d1 = Duration::<", stringify!($i), ", 1, 1_00>::from_ticks(1);")]
|
|
#[doc = concat!("let d2 = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(1);")]
|
|
///
|
|
/// assert_eq!(d1.const_partial_cmp(d2), Some(core::cmp::Ordering::Greater));
|
|
/// ```
|
|
#[inline]
|
|
pub const fn const_partial_cmp<const R_NOM: u32, const R_DENOM: u32>(
|
|
self,
|
|
other: Duration<$i, R_NOM, R_DENOM>
|
|
) -> Option<Ordering> {
|
|
//
|
|
// We want to check:
|
|
//
|
|
// n_lh / d_lh * lh_ticks {cmp} n_rh / d_rh * rh_ticks
|
|
//
|
|
// simplify to
|
|
//
|
|
// n_lh * d_rh * lh_ticks {cmp} n_rh * d_lh * rh_ticks
|
|
//
|
|
// find gdc(n_lh * d_rh, n_rh * d_lh) and use that to make the constants minimal (done
|
|
// with the `helpers::Helpers` struct)
|
|
//
|
|
// then perform the comparison in a comparable basis
|
|
//
|
|
|
|
if Helpers::<NOM, DENOM, R_NOM, R_DENOM>::SAME_BASE {
|
|
// If we are in the same base, comparison in trivial
|
|
Some(Self::_const_cmp(self.ticks, other.ticks))
|
|
} else {
|
|
let lh = self
|
|
.ticks
|
|
.checked_mul(Helpers::<NOM, DENOM, R_NOM, R_DENOM>::RD_TIMES_LN as $i);
|
|
let rh = other
|
|
.ticks
|
|
.checked_mul(Helpers::<NOM, DENOM, R_NOM, R_DENOM>::LD_TIMES_RN as $i);
|
|
|
|
if let (Some(lh), Some(rh)) = (lh, rh) {
|
|
Some(Self::_const_cmp(lh, rh))
|
|
} else {
|
|
None
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Const equality check.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let d1 = Duration::<", stringify!($i), ", 1, 1_00>::from_ticks(1);")]
|
|
#[doc = concat!("let d2 = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(10);")]
|
|
///
|
|
/// assert!(d1.const_eq(d2));
|
|
/// ```
|
|
#[inline]
|
|
pub const fn const_eq<const R_NOM: u32, const R_DENOM: u32>(
|
|
self,
|
|
other: Duration<$i, R_NOM, R_DENOM>
|
|
) -> bool {
|
|
if Helpers::<NOM, DENOM, R_NOM, R_DENOM>::SAME_BASE {
|
|
// If we are in the same base, comparison in trivial
|
|
self.ticks == other.ticks
|
|
} else {
|
|
let lh = self
|
|
.ticks
|
|
.checked_mul(Helpers::<NOM, DENOM, R_NOM, R_DENOM>::RD_TIMES_LN as $i);
|
|
let rh = other
|
|
.ticks
|
|
.checked_mul(Helpers::<NOM, DENOM, R_NOM, R_DENOM>::LD_TIMES_RN as $i);
|
|
|
|
if let (Some(lh), Some(rh)) = (lh, rh) {
|
|
lh == rh
|
|
} else {
|
|
false
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Const try from, checking for overflow.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let d1 = Duration::<", stringify!($i), ", 1, 1_00>::from_ticks(1);")]
|
|
#[doc = concat!("let d2 = Duration::<", stringify!($i), ", 1, 1_000>::const_try_from(d1);")]
|
|
///
|
|
/// assert_eq!(d2.unwrap().ticks(), 10);
|
|
/// ```
|
|
pub const fn const_try_from<const I_NOM: u32, const I_DENOM: u32>(
|
|
duration: Duration<$i, I_NOM, I_DENOM>,
|
|
) -> Option<Self> {
|
|
if Helpers::<I_NOM, I_DENOM, NOM, DENOM>::SAME_BASE {
|
|
Some(Self::from_ticks(duration.ticks))
|
|
} else {
|
|
if let Some(lh) = (duration.ticks as u64)
|
|
.checked_mul(Helpers::<I_NOM, I_DENOM, NOM, DENOM>::RD_TIMES_LN as u64)
|
|
{
|
|
let ticks = lh / Helpers::<I_NOM, I_DENOM, NOM, DENOM>::LD_TIMES_RN as u64;
|
|
|
|
if ticks <= <$i>::MAX as u64 {
|
|
Some(Self::from_ticks(ticks as $i))
|
|
} else {
|
|
None
|
|
}
|
|
} else {
|
|
None
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Const try into, checking for overflow.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let d1 = Duration::<", stringify!($i), ", 1, 1_00>::from_ticks(1);")]
|
|
#[doc = concat!("let d2: Option<Duration::<", stringify!($i), ", 1, 1_000>> = d1.const_try_into();")]
|
|
///
|
|
/// assert_eq!(d2.unwrap().ticks(), 10);
|
|
/// ```
|
|
#[inline]
|
|
pub const fn const_try_into<const O_NOM: u32, const O_DENOM: u32>(
|
|
self,
|
|
) -> Option<Duration<$i, O_NOM, O_DENOM>> {
|
|
Duration::<$i, O_NOM, O_DENOM>::const_try_from(self)
|
|
}
|
|
|
|
/// Const try into rate, checking for divide-by-zero.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let d1 = Duration::<", stringify!($i), ", 1, 1_000>::from_ticks(2);")]
|
|
#[doc = concat!("let r1: Option<Rate::<", stringify!($i), ", 1, 1>> = d1.try_into_rate();")]
|
|
///
|
|
/// assert_eq!(r1.unwrap().raw(), 500);
|
|
/// ```
|
|
#[inline]
|
|
pub const fn try_into_rate<const O_NOM: u32, const O_DENOM: u32>(
|
|
self,
|
|
) -> Option<Rate<$i, O_NOM, O_DENOM>> {
|
|
Rate::<$i, O_NOM, O_DENOM>::try_from_duration(self)
|
|
}
|
|
|
|
/// Convert from duration to rate.
|
|
#[inline]
|
|
pub const fn into_rate<const O_NOM: u32, const O_DENOM: u32>(
|
|
self,
|
|
) -> Rate<$i, O_NOM, O_DENOM> {
|
|
if let Some(v) = self.try_into_rate() {
|
|
v
|
|
} else {
|
|
panic!("Into rate failed, divide-by-zero!");
|
|
}
|
|
}
|
|
|
|
/// Const try from rate, checking for divide-by-zero.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let r1 = Rate::<", stringify!($i), ", 1, 1>::from_raw(1);")]
|
|
#[doc = concat!("let d1 = Duration::<", stringify!($i), ", 1, 1_000>::try_from_rate(r1);")]
|
|
///
|
|
/// assert_eq!(d1.unwrap().ticks(), 1_000);
|
|
/// ```
|
|
#[inline]
|
|
pub const fn try_from_rate<const I_NOM: u32, const I_DENOM: u32>(
|
|
rate: Rate<$i, I_NOM, I_DENOM>,
|
|
) -> Option<Self> {
|
|
if rate.raw > 0 {
|
|
Some(Self::from_ticks(
|
|
Helpers::<I_NOM, I_DENOM, NOM, DENOM>::RATE_TO_DURATION_NUMERATOR as $i
|
|
/ rate.raw
|
|
))
|
|
} else {
|
|
None
|
|
}
|
|
}
|
|
|
|
/// Convert from rate to duration.
|
|
#[inline]
|
|
pub const fn from_rate<const I_NOM: u32, const I_DENOM: u32>(
|
|
rate: Rate<$i, I_NOM, I_DENOM>,
|
|
) -> Self {
|
|
if let Some(v) = Self::try_from_rate(rate) {
|
|
v
|
|
} else {
|
|
panic!("From rate failed, divide-by-zero!");
|
|
}
|
|
}
|
|
|
|
/// Convert between bases for a duration.
|
|
///
|
|
/// Unfortunately not a `From` impl due to collision with the std lib.
|
|
///
|
|
/// ```
|
|
/// # use fugit::*;
|
|
#[doc = concat!("let d1 = Duration::<", stringify!($i), ", 1, 100>::from_ticks(1);")]
|
|
#[doc = concat!("let d2: Duration::<", stringify!($i), ", 1, 1_000> = d1.convert();")]
|
|
///
|
|
/// assert_eq!(d2.ticks(), 10);
|
|
/// ```
|
|
/// Can be used in const contexts. Compilation will fail if the conversion causes overflow
|
|
/// ```compile_fail
|
|
/// # use fugit::*;
|
|
#[doc = concat!("const TICKS: ", stringify!($i), "= ", stringify!($i), "::MAX - 10;")]
|
|
#[doc = concat!("const D1: Duration::<", stringify!($i), ", 1, 100> = Duration::<", stringify!($i), ", 1, 100>::from_ticks(TICKS);")]
|
|
/// // Fails conversion due to tick overflow
|
|
#[doc = concat!("const D2: Duration::<", stringify!($i), ", 1, 200> = D1.convert();")]
|
|
#[inline]
|
|
pub const fn convert<const O_NOM: u32, const O_DENOM: u32>(
|
|
self,
|
|
) -> Duration<$i, O_NOM, O_DENOM> {
|
|
if let Some(v) = self.const_try_into() {
|
|
v
|
|
} else {
|
|
panic!("Convert failed!");
|
|
}
|
|
}
|
|
|
|
shorthand!($i, 1, 1_000_000_000, nanos, to_nanos, nanos_at_least, "nanoseconds");
|
|
shorthand!($i, 1, 1_000_000, micros, to_micros, micros_at_least, "microseconds");
|
|
shorthand!($i, 1, 1_000, millis, to_millis, millis_at_least, "milliseconds");
|
|
shorthand!($i, 1, 1, secs, to_secs, secs_at_least, "seconds");
|
|
shorthand!($i, 60, 1, minutes, to_minutes, minutes_at_least, "minutes");
|
|
shorthand!($i, 3600, 1, hours, to_hours, hours_at_least, "hours");
|
|
|
|
/// Shorthand for creating a duration which represents hertz.
|
|
#[inline]
|
|
#[allow(non_snake_case)]
|
|
pub const fn Hz(val: $i) -> Self {
|
|
Self::from_rate(crate::Hertz::<$i>::from_raw(val))
|
|
}
|
|
|
|
/// Shorthand for creating a duration which represents kilohertz.
|
|
#[inline]
|
|
#[allow(non_snake_case)]
|
|
pub const fn kHz(val: $i) -> Self {
|
|
Self::from_rate(crate::Kilohertz::<$i>::from_raw(val))
|
|
}
|
|
|
|
/// Shorthand for creating a duration which represents megahertz.
|
|
#[inline]
|
|
#[allow(non_snake_case)]
|
|
pub const fn MHz(val: $i) -> Self {
|
|
Self::from_rate(crate::Megahertz::<$i>::from_raw(val))
|
|
}
|
|
}
|
|
|
|
impl<const L_NOM: u32, const L_DENOM: u32, const R_NOM: u32, const R_DENOM: u32>
|
|
PartialOrd<Duration<$i, R_NOM, R_DENOM>> for Duration<$i, L_NOM, L_DENOM>
|
|
{
|
|
#[inline]
|
|
fn partial_cmp(&self, other: &Duration<$i, R_NOM, R_DENOM>) -> Option<Ordering> {
|
|
self.const_partial_cmp(*other)
|
|
}
|
|
}
|
|
|
|
impl<const NOM: u32, const DENOM: u32> Ord for Duration<$i, NOM, DENOM> {
|
|
#[inline]
|
|
fn cmp(&self, other: &Self) -> Ordering {
|
|
Self::_const_cmp(self.ticks, other.ticks)
|
|
}
|
|
}
|
|
|
|
impl<const L_NOM: u32, const L_DENOM: u32, const R_NOM: u32, const R_DENOM: u32>
|
|
PartialEq<Duration<$i, R_NOM, R_DENOM>> for Duration<$i, L_NOM, L_DENOM>
|
|
{
|
|
#[inline]
|
|
fn eq(&self, other: &Duration<$i, R_NOM, R_DENOM>) -> bool {
|
|
self.const_eq(*other)
|
|
}
|
|
}
|
|
|
|
impl<const NOM: u32, const DENOM: u32> Eq for Duration<$i, NOM, DENOM> {}
|
|
|
|
// Duration - Duration = Duration (only same base until const_generics_defaults is
|
|
// stabilized)
|
|
impl<const NOM: u32, const DENOM: u32> ops::Sub<Duration<$i, NOM, DENOM>>
|
|
for Duration<$i, NOM, DENOM>
|
|
{
|
|
type Output = Duration<$i, NOM, DENOM>;
|
|
|
|
#[inline]
|
|
fn sub(self, other: Duration<$i, NOM, DENOM>) -> Self::Output {
|
|
if let Some(v) = self.checked_sub(other) {
|
|
v
|
|
} else {
|
|
panic!("Sub failed!");
|
|
}
|
|
}
|
|
}
|
|
|
|
// Duration -= Duration
|
|
impl<const NOM: u32, const DENOM: u32> ops::SubAssign<Duration<$i, NOM, DENOM>>
|
|
for Duration<$i, NOM, DENOM>
|
|
{
|
|
#[inline]
|
|
fn sub_assign(&mut self, other: Self) {
|
|
*self = *self - other;
|
|
}
|
|
}
|
|
|
|
// Duration + Duration = Duration (only same base until const_generics_defaults is
|
|
// stabilized)
|
|
impl<const NOM: u32, const DENOM: u32> ops::Add<Duration<$i, NOM, DENOM>>
|
|
for Duration<$i, NOM, DENOM>
|
|
{
|
|
type Output = Duration<$i, NOM, DENOM>;
|
|
|
|
#[inline]
|
|
fn add(self, other: Duration<$i, NOM, DENOM>) -> Self::Output {
|
|
if let Some(v) = self.checked_add(other) {
|
|
v
|
|
} else {
|
|
panic!("Add failed!");
|
|
}
|
|
}
|
|
}
|
|
|
|
// Duration += Duration
|
|
impl<const NOM: u32, const DENOM: u32> ops::AddAssign<Duration<$i, NOM, DENOM>>
|
|
for Duration<$i, NOM, DENOM>
|
|
{
|
|
#[inline]
|
|
fn add_assign(&mut self, other: Self) {
|
|
*self = *self + other;
|
|
}
|
|
}
|
|
|
|
// integer * Duration = Duration
|
|
impl<const NOM: u32, const DENOM: u32> ops::Mul<Duration<$i, NOM, DENOM>> for u32 {
|
|
type Output = Duration<$i, NOM, DENOM>;
|
|
|
|
#[inline]
|
|
fn mul(self, mut other: Duration<$i, NOM, DENOM>) -> Self::Output {
|
|
other.ticks *= self as $i;
|
|
other
|
|
}
|
|
}
|
|
|
|
// Duration * integer = Duration
|
|
impl<const NOM: u32, const DENOM: u32> ops::Mul<u32> for Duration<$i, NOM, DENOM> {
|
|
type Output = Duration<$i, NOM, DENOM>;
|
|
|
|
#[inline]
|
|
fn mul(mut self, other: u32) -> Self::Output {
|
|
self.ticks *= other as $i;
|
|
self
|
|
}
|
|
}
|
|
|
|
// Duration *= integer
|
|
impl<const NOM: u32, const DENOM: u32> ops::MulAssign<u32>
|
|
for Duration<$i, NOM, DENOM>
|
|
{
|
|
#[inline]
|
|
fn mul_assign(&mut self, other: u32) {
|
|
*self = *self * other;
|
|
}
|
|
}
|
|
|
|
// Duration / integer = Duration
|
|
impl<const NOM: u32, const DENOM: u32> ops::Div<u32> for Duration<$i, NOM, DENOM> {
|
|
type Output = Duration<$i, NOM, DENOM>;
|
|
|
|
#[inline]
|
|
fn div(mut self, other: u32) -> Self::Output {
|
|
self.ticks /= other as $i;
|
|
self
|
|
}
|
|
}
|
|
|
|
// Duration /= integer
|
|
impl<const NOM: u32, const DENOM: u32> ops::DivAssign<u32>
|
|
for Duration<$i, NOM, DENOM>
|
|
{
|
|
#[inline]
|
|
fn div_assign(&mut self, other: u32) {
|
|
*self = *self / other;
|
|
}
|
|
}
|
|
|
|
// Duration / Duration = integer
|
|
impl<const L_NOM: u32, const L_DENOM: u32, const R_NOM: u32, const R_DENOM: u32> ops::Div<Duration<$i, R_NOM, R_DENOM>>
|
|
for Duration<$i, L_NOM, L_DENOM>
|
|
{
|
|
type Output = $i;
|
|
|
|
#[inline]
|
|
fn div(self, other: Duration<$i, R_NOM, R_DENOM>) -> Self::Output {
|
|
let conv: Duration<$i, R_NOM, R_DENOM> = self.convert();
|
|
conv.ticks / other.ticks
|
|
}
|
|
}
|
|
|
|
#[cfg(feature = "defmt")]
|
|
impl<const NOM: u32, const DENOM: u32> defmt::Format for Duration<$i, NOM, DENOM>
|
|
{
|
|
fn format(&self, f: defmt::Formatter) {
|
|
if NOM == 3_600 && DENOM == 1 {
|
|
defmt::write!(f, "{} h", self.ticks)
|
|
} else if NOM == 60 && DENOM == 1 {
|
|
defmt::write!(f, "{} min", self.ticks)
|
|
} else if NOM == 1 && DENOM == 1 {
|
|
defmt::write!(f, "{} s", self.ticks)
|
|
} else if NOM == 1 && DENOM == 1_000 {
|
|
defmt::write!(f, "{} ms", self.ticks)
|
|
} else if NOM == 1 && DENOM == 1_000_000 {
|
|
defmt::write!(f, "{} us", self.ticks)
|
|
} else if NOM == 1 && DENOM == 1_000_000_000 {
|
|
defmt::write!(f, "{} ns", self.ticks)
|
|
} else {
|
|
defmt::write!(f, "{} ticks @ ({}/{})", self.ticks, NOM, DENOM)
|
|
}
|
|
}
|
|
}
|
|
|
|
impl<const NOM: u32, const DENOM: u32> core::fmt::Display for Duration<$i, NOM, DENOM> {
|
|
fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
|
|
if NOM == 3_600 && DENOM == 1 {
|
|
write!(f, "{} h", self.ticks)
|
|
} else if NOM == 60 && DENOM == 1 {
|
|
write!(f, "{} min", self.ticks)
|
|
} else if NOM == 1 && DENOM == 1 {
|
|
write!(f, "{} s", self.ticks)
|
|
} else if NOM == 1 && DENOM == 1_000 {
|
|
write!(f, "{} ms", self.ticks)
|
|
} else if NOM == 1 && DENOM == 1_000_000 {
|
|
write!(f, "{} us", self.ticks)
|
|
} else if NOM == 1 && DENOM == 1_000_000_000 {
|
|
write!(f, "{} ns", self.ticks)
|
|
} else {
|
|
write!(f, "{} ticks @ ({}/{})", self.ticks, NOM, DENOM)
|
|
}
|
|
}
|
|
}
|
|
};
|
|
}
|
|
|
|
impl_duration_for_integer!(u32);
|
|
impl_duration_for_integer!(u64);
|
|
|
|
//
|
|
// Operations between u32 and u64 Durations
|
|
//
|
|
|
|
impl<const NOM: u32, const DENOM: u32> From<Duration<u32, NOM, DENOM>>
|
|
for Duration<u64, NOM, DENOM>
|
|
{
|
|
#[inline]
|
|
fn from(val: Duration<u32, NOM, DENOM>) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::from_ticks(val.ticks() as u64)
|
|
}
|
|
}
|
|
|
|
impl<const NOM: u32, const DENOM: u32> convert::TryFrom<Duration<u64, NOM, DENOM>>
|
|
for Duration<u32, NOM, DENOM>
|
|
{
|
|
type Error = ();
|
|
|
|
#[inline]
|
|
fn try_from(val: Duration<u64, NOM, DENOM>) -> Result<Duration<u32, NOM, DENOM>, ()> {
|
|
Ok(Duration::<u32, NOM, DENOM>::from_ticks(
|
|
val.ticks().try_into().map_err(|_| ())?,
|
|
))
|
|
}
|
|
}
|
|
|
|
// Duration - Duration = Duration (to make shorthands work, until const_generics_defaults is
|
|
// stabilized)
|
|
impl<const NOM: u32, const DENOM: u32> ops::Sub<Duration<u32, NOM, DENOM>>
|
|
for Duration<u64, NOM, DENOM>
|
|
{
|
|
type Output = Duration<u64, NOM, DENOM>;
|
|
|
|
#[inline]
|
|
fn sub(self, other: Duration<u32, NOM, DENOM>) -> Self::Output {
|
|
if let Some(v) =
|
|
self.checked_sub(Duration::<u64, NOM, DENOM>::from_ticks(other.ticks() as u64))
|
|
{
|
|
v
|
|
} else {
|
|
panic!("Sub failed!");
|
|
}
|
|
}
|
|
}
|
|
|
|
// Duration -= Duration (to make shorthands work, until const_generics_defaults is stabilized)
|
|
impl<const NOM: u32, const DENOM: u32> ops::SubAssign<Duration<u32, NOM, DENOM>>
|
|
for Duration<u64, NOM, DENOM>
|
|
{
|
|
#[inline]
|
|
fn sub_assign(&mut self, other: Duration<u32, NOM, DENOM>) {
|
|
*self = *self - other;
|
|
}
|
|
}
|
|
|
|
// Duration + Duration = Duration (to make shorthands work, until const_generics_defaults is
|
|
// stabilized)
|
|
impl<const NOM: u32, const DENOM: u32> ops::Add<Duration<u32, NOM, DENOM>>
|
|
for Duration<u64, NOM, DENOM>
|
|
{
|
|
type Output = Duration<u64, NOM, DENOM>;
|
|
|
|
#[inline]
|
|
fn add(self, other: Duration<u32, NOM, DENOM>) -> Self::Output {
|
|
if let Some(v) =
|
|
self.checked_add(Duration::<u64, NOM, DENOM>::from_ticks(other.ticks() as u64))
|
|
{
|
|
v
|
|
} else {
|
|
panic!("Add failed!");
|
|
}
|
|
}
|
|
}
|
|
|
|
// Duration += Duration (to make shorthands work, until const_generics_defaults is stabilized)
|
|
impl<const NOM: u32, const DENOM: u32> ops::AddAssign<Duration<u32, NOM, DENOM>>
|
|
for Duration<u64, NOM, DENOM>
|
|
{
|
|
#[inline]
|
|
fn add_assign(&mut self, other: Duration<u32, NOM, DENOM>) {
|
|
*self = *self + other;
|
|
}
|
|
}
|
|
|
|
impl<const L_NOM: u32, const L_DENOM: u32, const R_NOM: u32, const R_DENOM: u32>
|
|
PartialOrd<Duration<u32, R_NOM, R_DENOM>> for Duration<u64, L_NOM, L_DENOM>
|
|
{
|
|
#[inline]
|
|
fn partial_cmp(&self, other: &Duration<u32, R_NOM, R_DENOM>) -> Option<Ordering> {
|
|
self.partial_cmp(&Duration::<u64, R_NOM, R_DENOM>::from_ticks(
|
|
other.ticks() as u64
|
|
))
|
|
}
|
|
}
|
|
|
|
impl<const L_NOM: u32, const L_DENOM: u32, const R_NOM: u32, const R_DENOM: u32>
|
|
PartialEq<Duration<u32, R_NOM, R_DENOM>> for Duration<u64, L_NOM, L_DENOM>
|
|
{
|
|
#[inline]
|
|
fn eq(&self, other: &Duration<u32, R_NOM, R_DENOM>) -> bool {
|
|
self.eq(&Duration::<u64, R_NOM, R_DENOM>::from_ticks(
|
|
other.ticks() as u64
|
|
))
|
|
}
|
|
}
|
|
|
|
impl<const L_NOM: u32, const L_DENOM: u32, const R_NOM: u32, const R_DENOM: u32>
|
|
PartialOrd<Duration<u64, R_NOM, R_DENOM>> for Duration<u32, L_NOM, L_DENOM>
|
|
{
|
|
#[inline]
|
|
fn partial_cmp(&self, other: &Duration<u64, R_NOM, R_DENOM>) -> Option<Ordering> {
|
|
Duration::<u64, L_NOM, L_DENOM>::from_ticks(self.ticks as u64).partial_cmp(other)
|
|
}
|
|
}
|
|
|
|
impl<const L_NOM: u32, const L_DENOM: u32, const R_NOM: u32, const R_DENOM: u32>
|
|
PartialEq<Duration<u64, R_NOM, R_DENOM>> for Duration<u32, L_NOM, L_DENOM>
|
|
{
|
|
#[inline]
|
|
fn eq(&self, other: &Duration<u64, R_NOM, R_DENOM>) -> bool {
|
|
Duration::<u64, L_NOM, L_DENOM>::from_ticks(self.ticks as u64).eq(other)
|
|
}
|
|
}
|
|
|
|
/// Extension trait for simple short-hands for u32 Durations
|
|
pub trait ExtU32 {
|
|
/// Shorthand for creating a duration which represents nanoseconds.
|
|
fn nanos<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents microseconds.
|
|
fn micros<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents milliseconds.
|
|
fn millis<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents seconds.
|
|
fn secs<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents minutes.
|
|
fn minutes<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents hours.
|
|
fn hours<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
}
|
|
|
|
impl ExtU32 for u32 {
|
|
#[inline]
|
|
fn nanos<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::nanos(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn micros<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::micros(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn millis<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::millis(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn secs<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::secs(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn minutes<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::minutes(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn hours<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::hours(self)
|
|
}
|
|
}
|
|
|
|
/// Extension trait for simple short-hands for u32 Durations (ceil rounded)
|
|
pub trait ExtU32Ceil {
|
|
/// Shorthand for creating a duration which represents nanoseconds.
|
|
fn nanos_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents microseconds.
|
|
fn micros_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents milliseconds.
|
|
fn millis_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents seconds.
|
|
fn secs_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents minutes.
|
|
fn minutes_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents hours.
|
|
fn hours_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM>;
|
|
}
|
|
|
|
impl ExtU32Ceil for u32 {
|
|
#[inline]
|
|
fn nanos_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::nanos_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn micros_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::micros_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn millis_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::millis_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn secs_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::secs_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn minutes_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::minutes_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn hours_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u32, NOM, DENOM> {
|
|
Duration::<u32, NOM, DENOM>::hours_at_least(self)
|
|
}
|
|
}
|
|
|
|
/// Extension trait for simple short-hands for u64 Durations
|
|
pub trait ExtU64 {
|
|
/// Shorthand for creating a duration which represents nanoseconds.
|
|
fn nanos<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents microseconds.
|
|
fn micros<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents milliseconds.
|
|
fn millis<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents seconds.
|
|
fn secs<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents minutes.
|
|
fn minutes<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents hours.
|
|
fn hours<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
}
|
|
|
|
impl ExtU64 for u64 {
|
|
#[inline]
|
|
fn nanos<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::nanos(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn micros<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::micros(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn millis<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::millis(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn secs<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::secs(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn minutes<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::minutes(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn hours<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::hours(self)
|
|
}
|
|
}
|
|
|
|
/// Extension trait for simple short-hands for u64 Durations (ceil rounded)
|
|
pub trait ExtU64Ceil {
|
|
/// Shorthand for creating a duration which represents nanoseconds.
|
|
fn nanos_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents microseconds.
|
|
fn micros_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents milliseconds.
|
|
fn millis_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents seconds.
|
|
fn secs_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents minutes.
|
|
fn minutes_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
|
|
/// Shorthand for creating a duration which represents hours.
|
|
fn hours_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM>;
|
|
}
|
|
|
|
impl ExtU64Ceil for u64 {
|
|
#[inline]
|
|
fn nanos_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::nanos_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn micros_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::micros_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn millis_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::millis_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn secs_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::secs_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn minutes_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::minutes_at_least(self)
|
|
}
|
|
|
|
#[inline]
|
|
fn hours_at_least<const NOM: u32, const DENOM: u32>(self) -> Duration<u64, NOM, DENOM> {
|
|
Duration::<u64, NOM, DENOM>::hours_at_least(self)
|
|
}
|
|
}
|