Nick
793685e76b
Field session: after a recovery teardown the heap settles at ~72 KB -- below the 100 KB start floor -- and never recovers on its own (the defrag silent-restart only fires when a build FAILS, and builds succeed now). BT stayed paused forever, the menu toggle claimed ON, and toggling off/on changed nothing. - Menu label tells the truth: ON / PAUSED (enabled but stack down) / OFF (new STR_STATE_PAUSED string) - Toggling BT on below the heap floor silent-restarts into the current book: the fresh boot's ~118 KB passes the gate and BT auto-starts on resume. Explicit user intent is the right trigger for the defrag. - Hoist the floor to bleinput::kStartMinFreeHeap, shared by the lifecycle gate and the toggle
61 lines
2.6 KiB
C++
61 lines
2.6 KiB
C++
#pragma once
|
|
|
|
// CrossPoint <-> FreeInk BLE HID host glue.
|
|
//
|
|
// Thin, capability-safe helpers around freeink::BleKeyboardHost (the `BleHid`
|
|
// singleton). When FREEINK_CAP_BLE_HID_HOST is compiled out the SDK links stubs,
|
|
// so every call here is still valid and simply no-ops / returns false — callers
|
|
// need no #ifdefs.
|
|
//
|
|
// The (kind, value) pair produced by encodeKey() is the stable identity stored in
|
|
// CrossPointSettings::bleKeyMap. Page-turner remotes emit "special" keys
|
|
// (PageUp/PageDown/arrows); plain keyboards emit usage codes. We deliberately
|
|
// ignore modifiers and the printable char for matching (page turners don't use
|
|
// modifiers), keeping the persisted entry a trivial two-byte comparison.
|
|
|
|
#include <BleKeyboardHost.h>
|
|
|
|
#include <cstdint>
|
|
|
|
class GfxRenderer;
|
|
class MappedInputManager;
|
|
|
|
namespace bleinput {
|
|
|
|
// Advertised central name shown to peripherals during pairing.
|
|
inline constexpr const char* kHostName = "CrossPoint";
|
|
|
|
// Heap floor for starting the NimBLE stack (~57 KB) while leaving the reader's
|
|
// section-build pre-flight (40 KB) satisfiable afterwards. Shared by the main-loop
|
|
// lifecycle gate and the reader menu's toggle (which offers a defrag restart when a
|
|
// user turns BT on below the floor).
|
|
inline constexpr size_t kStartMinFreeHeap = 100 * 1024;
|
|
|
|
// Start the BLE HID host (idempotent). Returns false if BLE is compiled out or
|
|
// NimBLE init failed. Safe to call repeatedly.
|
|
bool ensureStarted();
|
|
|
|
// Drop the active link (e.g. before deep sleep or when the user disables BT).
|
|
void stop();
|
|
|
|
// Temporarily block the main-loop BLE lifecycle from auto-starting the stack.
|
|
// Used while a render path deliberately frees BLE RAM for a large allocation.
|
|
void setLifecyclePaused(bool paused);
|
|
bool lifecyclePaused();
|
|
|
|
// Encode a decoded key event into the stable (kind, value) identity used by the
|
|
// settings map. kind: 0 = SpecialKey, 1 = HID usage. Returns false when the event
|
|
// carries no usable identity (no special key and no usage code).
|
|
bool encodeKey(const freeink::KeyEvent& ev, uint8_t& kind, uint8_t& value);
|
|
|
|
// Human-readable name for a stored (kind, value) identity, for the mapping UI.
|
|
// Writes a null-terminated string into out (e.g. "Page Down", "Key 0x4B").
|
|
void describeKey(uint8_t kind, uint8_t value, char* out, size_t outLen);
|
|
|
|
// Draw a "BT Connecting..." popup and pump the BLE host until the bonded remote
|
|
// links, the user presses a button to dismiss, or a timeout. No-op if BLE isn't
|
|
// running or is already connected. The caller must redraw afterward to clear it.
|
|
void showConnectingUntilLinked(const GfxRenderer& renderer, const MappedInputManager& input);
|
|
|
|
} // namespace bleinput
|