943fb1bced
* ble-glue: add on connect \ disconnect, on send \ received callbacks * bt: rework service with furi-hal-bt and callbacks * bt: update battery level on connect * ble-glue: set one callback with parameters * bt: rework callbacks, remove unused API * ble-glue: remove dead code * furi-hal-bt: add documentation * ble-glue: apply changes for f7 target * bt: rename RpcInstance -> Rpc * ble: add disconnection reason * ble: don't open bt record from GAP * bt: fix RPC session close * Assets: separate targets for icons and protobuf Co-authored-by: あく <alleteam@gmail.com>
142 lines
3.0 KiB
C
142 lines
3.0 KiB
C
/**
|
|
* @file furi-hal-bt.h
|
|
* BT/BLE HAL API
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <m-string.h>
|
|
#include <stdbool.h>
|
|
#include <gap.h>
|
|
#include <serial_service.h>
|
|
|
|
#define FURI_HAL_BT_PACKET_SIZE_MAX SERIAL_SVC_DATA_LEN_MAX
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** Initialize
|
|
*/
|
|
void furi_hal_bt_init();
|
|
|
|
/** Start BLE app
|
|
* @param event_cb - BleEventCallback instance
|
|
* @param context - pointer to context
|
|
*/
|
|
bool furi_hal_bt_init_app(BleEventCallback event_cb, void* context);
|
|
|
|
/** Start advertising
|
|
*/
|
|
void furi_hal_bt_start_advertising();
|
|
|
|
/** Stop advertising
|
|
*/
|
|
void furi_hal_bt_stop_advertising();
|
|
|
|
/** Returns true if BLE is advertising
|
|
*
|
|
* @return true if BLE advertising
|
|
*/
|
|
bool furi_hal_bt_is_active();
|
|
|
|
/** Get BT/BLE system component state
|
|
*
|
|
* @param[in] buffer string_t buffer to write to
|
|
*/
|
|
void furi_hal_bt_dump_state(string_t buffer);
|
|
|
|
/** Get BT/BLE system component state
|
|
*
|
|
* @return true if core2 is alive
|
|
*/
|
|
bool furi_hal_bt_is_alive();
|
|
|
|
/** Set data event callbacks
|
|
* @param on_received_cb - SerialSvcDataReceivedCallback instance
|
|
* @param on_sent_cb - SerialSvcDataSentCallback instance
|
|
* @param context - pointer to context
|
|
*/
|
|
void furi_hal_bt_set_data_event_callbacks(SerialSvcDataReceivedCallback on_received_cb, SerialSvcDataSentCallback on_sent_cb, void* context);
|
|
|
|
/** Send data through BLE
|
|
* @param data - data buffer
|
|
* @param size - data buffer size
|
|
*/
|
|
bool furi_hal_bt_tx(uint8_t* data, uint16_t size);
|
|
|
|
/** Wait for Core2 startup */
|
|
bool furi_hal_bt_wait_startup();
|
|
|
|
/** Lock shared access to flash controller
|
|
*
|
|
* @param[in] erase_flag true if erase operation
|
|
*
|
|
* @return true if lock was successful, false if not
|
|
*/
|
|
bool furi_hal_bt_lock_flash(bool erase_flag);
|
|
|
|
/** Unlock shared access to flash controller
|
|
*
|
|
* @param[in] erase_flag true if erase operation
|
|
*/
|
|
void furi_hal_bt_unlock_flash(bool erase_flag);
|
|
|
|
/** Start ble tone tx at given channel and power
|
|
*
|
|
* @param[in] channel The channel
|
|
* @param[in] power The power
|
|
*/
|
|
void furi_hal_bt_start_tone_tx(uint8_t channel, uint8_t power);
|
|
|
|
/** Stop ble tone tx
|
|
*/
|
|
void furi_hal_bt_stop_tone_tx();
|
|
|
|
/** Start sending ble packets at a given frequency and datarate
|
|
*
|
|
* @param[in] channel The channel
|
|
* @param[in] pattern The pattern
|
|
* @param[in] datarate The datarate
|
|
*/
|
|
void furi_hal_bt_start_packet_tx(uint8_t channel, uint8_t pattern, uint8_t datarate);
|
|
|
|
/** Stop sending ble packets
|
|
*
|
|
* @return sent packet count
|
|
*/
|
|
uint16_t furi_hal_bt_stop_packet_test();
|
|
|
|
/** Start receiving packets
|
|
*
|
|
* @param[in] channel RX channel
|
|
* @param[in] datarate Datarate
|
|
*/
|
|
void furi_hal_bt_start_packet_rx(uint8_t channel, uint8_t datarate);
|
|
|
|
/** Set up the RF to listen to a given RF channel
|
|
*
|
|
* @param[in] channel RX channel
|
|
*/
|
|
void furi_hal_bt_start_rx(uint8_t channel);
|
|
|
|
/** Stop RF listenning
|
|
*/
|
|
void furi_hal_bt_stop_rx();
|
|
|
|
/** Get RSSI
|
|
*
|
|
* @return RSSI in dBm
|
|
*/
|
|
float furi_hal_bt_get_rssi();
|
|
|
|
/** Get number of transmitted packets
|
|
*
|
|
* @return packet count
|
|
*/
|
|
uint32_t furi_hal_bt_get_transmitted_packets();
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|