mirror of
https://github.com/meshtastic/firmware.git
synced 2026-05-30 11:45:09 -04:00
8d8ff21e7c
* Add clamping logic for milliseconds conversion and unit tests * Simplify comments in secondsToMsClamped function Removed detailed comments about seconds to milliseconds conversion.
80 lines
3.1 KiB
C++
80 lines
3.1 KiB
C++
#include "Default.h"
|
|
|
|
#include "meshUtils.h"
|
|
|
|
// Convert seconds to ms, clamping at INT32_MAX (~24.86 days)
|
|
static inline uint32_t secondsToMsClamped(uint32_t secs)
|
|
{
|
|
constexpr uint32_t MAX_MS = static_cast<uint32_t>(INT32_MAX);
|
|
return (secs > MAX_MS / 1000U) ? MAX_MS : secs * 1000U;
|
|
}
|
|
|
|
uint32_t Default::getConfiguredOrDefaultMs(uint32_t configuredInterval, uint32_t defaultInterval)
|
|
{
|
|
return secondsToMsClamped(configuredInterval > 0 ? configuredInterval : defaultInterval);
|
|
}
|
|
|
|
uint32_t Default::getConfiguredOrDefaultMs(uint32_t configuredInterval)
|
|
{
|
|
return secondsToMsClamped(configuredInterval > 0 ? configuredInterval : default_broadcast_interval_secs);
|
|
}
|
|
|
|
uint32_t Default::getConfiguredOrDefault(uint32_t configured, uint32_t defaultValue)
|
|
{
|
|
if (configured > 0)
|
|
return configured;
|
|
return defaultValue;
|
|
}
|
|
/**
|
|
* Calculates the scaled value of the configured or default value in ms based on the number of online nodes.
|
|
*
|
|
* For example a default of 30 minutes (1800 seconds * 1000) would yield:
|
|
* 45 nodes = 2475 * 1000
|
|
* 60 nodes = 4500 * 1000
|
|
* 75 nodes = 6525 * 1000
|
|
* 90 nodes = 8550 * 1000
|
|
* @param configured The configured value.
|
|
* @param defaultValue The default value.
|
|
* @param numOnlineNodes The number of online nodes.
|
|
* @return The scaled value of the configured or default value.
|
|
*/
|
|
uint32_t Default::getConfiguredOrDefaultMsScaled(uint32_t configured, uint32_t defaultValue, uint32_t numOnlineNodes)
|
|
{
|
|
// If we are a router, we don't scale the value. It's already significantly higher.
|
|
if (config.device.role == meshtastic_Config_DeviceConfig_Role_ROUTER ||
|
|
config.device.role == meshtastic_Config_DeviceConfig_Role_ROUTER_LATE)
|
|
return getConfiguredOrDefaultMs(configured, defaultValue);
|
|
|
|
// Additionally if we're a tracker or sensor, we want priority to send position and telemetry
|
|
if (IS_ONE_OF(config.device.role, meshtastic_Config_DeviceConfig_Role_SENSOR, meshtastic_Config_DeviceConfig_Role_TRACKER,
|
|
meshtastic_Config_DeviceConfig_Role_TAK_TRACKER))
|
|
return getConfiguredOrDefaultMs(configured, defaultValue);
|
|
|
|
// Saturate at INT32_MAX to match secondsToMsClamped: float→uint32_t when
|
|
// out of range is UB, and the result is consumed as an int32_t downstream.
|
|
constexpr uint32_t MAX_MS = static_cast<uint32_t>(INT32_MAX);
|
|
uint32_t base = getConfiguredOrDefaultMs(configured, defaultValue);
|
|
float coef = congestionScalingCoefficient(numOnlineNodes);
|
|
if (static_cast<double>(base) * static_cast<double>(coef) >= static_cast<double>(MAX_MS))
|
|
return MAX_MS;
|
|
return base * coef;
|
|
}
|
|
|
|
uint32_t Default::getConfiguredOrMinimumValue(uint32_t configured, uint32_t minValue)
|
|
{
|
|
// If zero, intervals should be coalesced later by getConfiguredOrDefault... methods
|
|
if (configured == 0)
|
|
return configured;
|
|
|
|
return configured < minValue ? minValue : configured;
|
|
}
|
|
|
|
uint8_t Default::getConfiguredOrDefaultHopLimit(uint8_t configured)
|
|
{
|
|
#if USERPREFS_EVENT_MODE
|
|
return (configured > HOP_RELIABLE) ? HOP_RELIABLE : config.lora.hop_limit;
|
|
#else
|
|
return (configured >= HOP_MAX) ? HOP_MAX : config.lora.hop_limit;
|
|
#endif
|
|
}
|