Files
MeshCore/src/helpers/BaseSerialInterface.h
T
mikecarper ecaa5ac2a0 Harden nRF52 OTA, USB sessions, and T096 controls
Bind Companion replies to request transports, make dual-CDC USB sessions nonblocking and reconnect-safe, and harden nRF52 watchdog/OTA storage paths. Fix T096 button debounce, display wake, sleep races, and the compact message layout; add exact WisBlock OTA profiles plus expanded native/static/HIL documentation.
2026-09-01 20:51:43 -07:00

50 lines
2.0 KiB
C++

#pragma once
#include <Arduino.h>
#define MAX_FRAME_SIZE 176 // +4 for transport codes (region scoping)
class BaseSerialInterface {
protected:
BaseSerialInterface() { }
public:
virtual void enable() = 0;
virtual void disable() = 0;
virtual bool isEnabled() const = 0;
virtual bool isConnected() const = 0;
virtual void loop() {};
virtual bool isReadBusy() const = 0;
virtual bool isWriteBusy() const = 0;
// True while application-level transport work still needs loop service.
// Backends whose busy methods are throttling/high-water signals should
// override this with their actual queue state.
virtual bool hasPendingIO() const { return isReadBusy() || isWriteBusy(); }
// Returns true once for each pending Bluetooth pairing prompt. Non-BLE
// transports keep the default implementation so UI code can poll safely.
virtual bool takePairingRequest() { return false; }
// Capture and later address the transport which supplied the current
// command. Multi-transport implementations override these so asynchronous
// replies do not follow a newer client's command or fall back to broadcast.
virtual BaseSerialInterface* captureReplyRoute() { return this; }
virtual bool isReplyRouteAvailable(BaseSerialInterface* route) const {
return route == this && isEnabled() && isConnected();
}
virtual bool isReplyRouteWriteBusy(BaseSerialInterface* route) const {
return !isReplyRouteAvailable(route) || isWriteBusy();
}
virtual size_t writeFrameToRoute(BaseSerialInterface* route,
const uint8_t src[], size_t len) {
return route == this ? writeFrame(src, len) : 0;
}
// Multi-transport implementations can pin a sequence of response frames to
// the interface which supplied the current command. Single transports have
// nothing to route, so their default implementations are no-ops.
virtual void lockReplyRoute() {}
virtual void unlockReplyRoute() {}
virtual size_t writeFrame(const uint8_t src[], size_t len) = 0;
virtual size_t checkRecvFrame(uint8_t dest[]) = 0;
};