tlm_ble.h

Go to the documentation of this file.

 
#ifndef TLM_BLE_H
#define TLM_BLE_H
 
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define TLM_BLE_RING_SIZE   2048u    
#define TLM_BLE_MTU_DEFAULT 23u      
typedef enum {
    TLM_BLE_OFF       = 0,   
    TLM_BLE_READY     = 1,   
    TLM_BLE_CONNECTED = 2,   
    TLM_BLE_STREAMING = 3    /* notifications enabled: data is flowing         */
} tlm_ble_state_t;
 
/* Legacy commands written on the CMD characteristic (phase 2, unchanged) */
#define TLM_BLE_CMD_SEND_INIT   0x01u   
#define TLM_BLE_CMD_STATE_DECIM 0x02u   
void     tlm_ble_reset(void);
 
/* ---- producers ---- */
int      tlm_ble_push(const uint8_t *frame, uint16_t len);      
int      tlm_ble_push_hi(const uint8_t *frame, uint16_t len);   
uint16_t tlm_ble_hi_free(void);                                  
int      tlm_ble_want_state(uint16_t seq);
int      tlm_ble_take_init_request(void);
int      tlm_ble_take_subscribe(void);
void     tlm_ble_open_streams(void);
 
/* ---- consumer side (BLE TX thread) ---- */
uint16_t tlm_ble_peek(uint8_t *dst, uint16_t max);
void     tlm_ble_consume(uint16_t n);
void     tlm_ble_discard(void);      
uint16_t tlm_ble_queued(void);
 
/* ---- link events (BLE stack glue) ---- */
void     tlm_ble_set_state(tlm_ble_state_t s);
void     tlm_ble_set_mtu(uint16_t att_mtu);
void     tlm_ble_set_error(uint8_t ble_status);   
void     tlm_ble_on_command(const uint8_t *data, uint16_t len);  
/* ---- diagnostics (STATUS frame) ---- */
tlm_ble_state_t tlm_ble_state(void);
uint16_t tlm_ble_mtu(void);
uint16_t tlm_ble_chunk_max(void);   
uint32_t tlm_ble_dropped(void);
uint8_t  tlm_ble_error(void);
uint8_t  tlm_ble_state_decim(void);
 
extern volatile uint8_t g_dbg_ble_stall;
 
#ifdef __cplusplus
}
#endif
#endif /* TLM_BLE_H */