crosstyan
1da86dd657
Remove app::utils helpers with zero fleet call sites after the app_common merge (as_u8s, hexdump, add_overflow/overflow_error, try_get/try_get_ref, constrain_value_in_range_static — a template-bounds reimplementation of std::clamp) and the unused app_clock milliseconds alias. This drops several heavy includes from a header every consumer compiles. Rewrite deferrer as a stdlib scope guard that owns the callable directly (template<F>, non-copyable/non-movable) instead of type-erasing through std::move_only_function/std::function, so it never heap-allocates. The 3 call sites (band max32664d) are unchanged via CTAD.
36 lines
1.5 KiB
Markdown
36 lines
1.5 KiB
Markdown
# app_common
|
|
|
|
Shared header-only utilities for the TrackBackFwd / healthy-band-nrf /
|
|
zephyr_gateway_fwd fleet. Single source of truth for code that used to be
|
|
hand-copied (and had drifted) between the three repos.
|
|
|
|
## Contents
|
|
|
|
- `inc/app_utils.hpp` — byte/span casts (`as_bytes`), `overloads`, `deferrer`,
|
|
`to_mac_string` (only when the toolchain has `<format>`; guarded by
|
|
`__cpp_lib_format`).
|
|
- `inc/app_clock.hpp` — monotonic microsecond `TrivialClock`. The only
|
|
OS-specific code in this repo: `now()` is `k_uptime_ticks()` on Zephyr and
|
|
`esp_timer_get_time()` on ESP-IDF, selected by `__ZEPHYR__` / `ESP_PLATFORM`.
|
|
- `inc/app_clock_instant.hpp` — `Instant`, Rust-style elapsed-time helper on
|
|
top of `clock_t`. Pure `std::chrono`, no OS dependency.
|
|
|
|
Everything requires C++23 (all consumers build with `-std=gnu++23` /
|
|
`CONFIG_STD_CPP2B`).
|
|
|
|
## Consuming
|
|
|
|
**ESP-IDF**: add as a git submodule under `components/app_common`. The root
|
|
`CMakeLists.txt` registers the component; add `app_common` to your `REQUIRES`.
|
|
|
|
**Zephyr**: add as a git submodule (e.g. `modules/app_common`) and append it to
|
|
`EXTRA_ZEPHYR_MODULES` in the application CMakeLists before
|
|
`find_package(Zephyr)`. The include directory is registered globally; targets
|
|
`app_common` / `app_utils` / `app_utils_clock` exist for explicit linking.
|
|
|
|
## Rules
|
|
|
|
- Nothing platform-specific beyond the `app_clock.hpp` seam. If a helper needs
|
|
ESP-IDF or Zephyr APIs, it belongs in the consuming repo, not here.
|
|
- Never copy these headers back into a consumer repo. Bump the submodule.
|