mirror of
https://github.com/liquidraver/ZephCore.git
synced 2026-10-15 20:19:56 +00:00
liquidraver
38f815a0a1
Server roles (slice 7) - CommonCLI split into upstream's shape; region CLI moved into CommonCLI; ClientACL, RegionMap, TransportKeyStore and both server meshes in upstream shape over an Arduino compat shim (helpers/compat: Arduino.h, Stream/Print, Serial, SHA256, FILESYSTEM/File over Zephyr fs) - room server processAck port; `get acl` prints as upstream - room: default name Room-XXXX, display/input rotation, live radio UI refresh Event loops (slice 7b) - repeater and room server share server_main_common with a ServerRole descriptor; shared event bits in src/mesh_events.h - room server deadline-driven (idle wakes 2.2/s -> 0.08/s); companion loop() runs on housekeeping (closes the lazy contact-flush gap) - `get loop.wakes` in debug builds (CONFIG_ZEPHCORE_LOOP_WAKE_STATS) Companion transports and WiFi (slice 8) - upstream MultiSerialInterface: BLE, USB/UART and TCP are each a BaseSerialInterface, every connected transport gets every frame; CompanionSerial holds a lossless reply; shared frame_txq for BLE/TCP - SerialCompanionTransport and LinuxTCPTransport replaced by TcpCompanionTransport; ZephyrBLE split (gatt layout, DFU) - WiFi companion (upstream wifi.ssid/pwd/enabled CLI, TCP port 5000) on boards declaring `capabilities: wifi` in zephcore.yml: the PSRAM ESP32-S3 boards, plus Heltec V3 (140 contacts), Wireless Tracker (130) and both C6 boards (280); ESP32-S3 without PSRAM gets bounded WiFi buffers and a measured 72 KB heap; PSRAM boards' internal heap 72 KB - TCP queues: own depth (ZEPHCORE_TCP_QUEUE_SIZE=8), RX waits instead of dropping - RAM: companion ClientACL dropped; main/BT-TX/TCP stacks sized from measured peaks (-7 KB nRF companions, -9 KB ESP32 companions) - ESP32 WiFi stopped working under ~200 frames/s unicast. Fixed by: patches/zephyr/0017 never block the WiFi task in the RX callback; patches/zephyr/0018 lock shared_multi_heap (heap corruption with the WiFi heap in PSRAM); patches/modules/hal_espressif/0001 backport of hal_espressif af97fb02df (PSRAM realloc) Storage and prefs (slice 9) - prefs are now prefs.json through upstream's ConfigSerializer (ported verbatim), with upstream's key names for shared fields and ZephCore's own under "zc"; on first boot the binary new_prefs / repeater prefs is migrated and kept, so a downgrade still boots with the old settings - helpers/PrefsCodec: both legacy binary layouts (companion 272 B, server 311 B) as Zephyr-free codecs; sanitizeNodePrefs is the only validator - fix: server prefs could be replaced by a truncated file when a write failed; identity, prefs and channel writes go through one checked atomic replace (ZephyrFsUtil) - fix: a corrupt cad_auto byte turned adaptive CAD off instead of the default on - fix: a deliberate 300 s GPS duty on a repeater was rewritten to 48 h on every boot (that migration now runs on legacy files only) - one identity loader for all roles (IdentityFile); an unusable key file is always parked as .bad before regenerating - server store no longer stamps repeater defaults on room server and observer; companion first-boot volume policy moved into the store (adoptVolume) - ZephyrDataStore 1435 -> ~850 lines
48 lines
1.6 KiB
C
48 lines
1.6 KiB
C
/*
|
|
* SPDX-License-Identifier: MIT
|
|
* ZephyrFsUtil - small filesystem helpers shared by every role's store.
|
|
*
|
|
* One implementation of the power-safe replace (temp file, sync, rename) and
|
|
* of the probes that must not log. Zephyr's fs layer logs at ERR level for a
|
|
* missing path (fs_open, fs_unlink) and an unknown mount point (fs_statvfs),
|
|
* so every probe here checks first: an <err> line on the happy path of each
|
|
* boot or save hides the real filesystem errors.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include <zephyr/fs/fs.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Mount-list lookup; never logs. */
|
|
bool zephcore_fs_is_mounted(const char *mount_point);
|
|
|
|
bool zephcore_fs_exists(const char *path);
|
|
|
|
/* Idempotent: an absent file is a successful removal. */
|
|
bool zephcore_fs_remove(const char *path);
|
|
|
|
/* Read up to cap bytes of path. False if the file is absent or unreadable. */
|
|
bool zephcore_fs_read_file(const char *path, uint8_t *buf, size_t cap, size_t *out_len);
|
|
|
|
/* Write path through "<path>.tmp": writer fills the open temp file, then it is
|
|
* synced and renamed over path. On any failure (writer false, sync, rename)
|
|
* the temp is removed and path is left as it was. tag prefixes the log. */
|
|
typedef bool (*zephcore_fs_writer_t)(struct fs_file_t *file, void *ctx);
|
|
bool zephcore_fs_atomic_write(const char *path, zephcore_fs_writer_t writer, void *ctx,
|
|
const char *tag);
|
|
|
|
/* zephcore_fs_atomic_write() of one buffer; every byte must be written. */
|
|
bool zephcore_fs_atomic_replace(const char *path, const uint8_t *buf, size_t len,
|
|
const char *tag);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|