BleUartService.h

Go to the documentation of this file.

#pragma once
 
#include "cdc_hal/IBluetoothController.h"
#include <atomic>
#include <cstdint>
#include <cstddef>
#include <functional>
 
namespace cdc::mod_ble_serial {

class BleUartService {
public:
    bool init();

    void deinit();

    bool isInitialized() const { return initialized_; }
 
    // === TX (Badge -> Phone) ===

    size_t send(const uint8_t* data, size_t len);

    size_t send(const char* str);

    bool txReady() const;
 
    // === RX (Phone -> Badge) ===

    size_t available() const;

    int getchar();

    size_t read(uint8_t* buf, size_t maxLen);
 
    // === Connection State ===

    bool isConnected() const;
 
    // === Callbacks (invoked by API) ===

    void onRxData(const uint8_t* data, size_t len);

    void onConnectionChange(bool connected);
 
    // === Application Callbacks ===
 
    using ConnectCallback = std::function<void()>;
    using DisconnectCallback = std::function<void()>;
 
    void setOnConnect(ConnectCallback cb) { onConnect_ = cb; }
    void setOnDisconnect(DisconnectCallback cb) { onDisconnect_ = cb; }
 
    // === Singleton ===
    static BleUartService& instance();
 
private:
    BleUartService() = default;
 
    bool initialized_ = false;
 
    // GATT handle for TX characteristic (populated by registerGattService)
    uint16_t txCharHandle_ = 0;
 
    // Callbacks
    ConnectCallback onConnect_;
    DisconnectCallback onDisconnect_;
 
    // RX ring buffer with atomic indices for safe interaction between the
    // BLE host task (writer) and the application task (reader).
    static constexpr size_t RX_BUFFER_SIZE = 1024;
    uint8_t rxBuffer_[RX_BUFFER_SIZE] = {};
    std::atomic<size_t> rxHead_{0};
    std::atomic<size_t> rxTail_{0};
 
    // TX state
    volatile bool txCongested_ = false;
    volatile bool txInProgress_ = false;  // Recursion guard
 
    // BLE callback tokens for safe removal on deinit.
    cdc::hal::IBluetoothController::ListenerToken connToken_ =
        cdc::hal::IBluetoothController::INVALID_LISTENER;
    cdc::hal::IBluetoothController::ListenerToken disconnToken_ =
        cdc::hal::IBluetoothController::INVALID_LISTENER;
};
 
} // namespace cdc::mod_ble_serial