2021-10-03 10:36:05 +00:00
|
|
|
/**
|
|
|
|
* @file furi-hal-bt.h
|
|
|
|
* BT/BLE HAL API
|
|
|
|
*/
|
|
|
|
|
2020-12-10 14:25:20 +00:00
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <m-string.h>
|
|
|
|
#include <stdbool.h>
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Initialize
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
void furi_hal_bt_init();
|
2020-12-10 14:25:20 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Start BLE app
|
|
|
|
*
|
|
|
|
* @return true if app inited
|
|
|
|
*/
|
2021-09-15 16:58:32 +00:00
|
|
|
bool furi_hal_bt_init_app();
|
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Start advertising
|
|
|
|
*/
|
2021-09-15 16:58:32 +00:00
|
|
|
void furi_hal_bt_start_advertising();
|
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Stop advertising
|
|
|
|
*/
|
2021-09-15 16:58:32 +00:00
|
|
|
void furi_hal_bt_stop_advertising();
|
2021-03-11 09:31:07 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Returns true if BLE is advertising
|
|
|
|
*
|
|
|
|
* @return true if BLE advertising
|
|
|
|
*/
|
2021-09-16 16:12:07 +00:00
|
|
|
bool furi_hal_bt_is_active();
|
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Get BT/BLE system component state
|
|
|
|
*
|
|
|
|
* @param[in] buffer string_t buffer to write to
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
void furi_hal_bt_dump_state(string_t buffer);
|
2020-12-10 14:25:20 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Get BT/BLE system component state
|
|
|
|
*
|
|
|
|
* @return true if core2 is alive
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
bool furi_hal_bt_is_alive();
|
2020-12-10 14:25:20 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Wait for Core2 startup
|
|
|
|
*
|
|
|
|
* @return true if success, otherwise timeouted
|
|
|
|
*/
|
2021-09-01 23:22:40 +00:00
|
|
|
bool furi_hal_bt_wait_startup();
|
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Lock shared access to flash controller
|
|
|
|
*
|
|
|
|
* @param[in] erase_flag true if erase operation
|
|
|
|
*
|
|
|
|
* @return true if lock was successful, false if not
|
FL-53: new NFC worker, A/B/F/V poll and display. (#283)
* GUI: view. Flooper-blooper fix compilation error.
* GUI: view and viewdispatcher bones
* GUI: view implementation, view models, view dispatcher
* GUI: view navigation, model refinement. Power: use view, view dispatcher.
* HAL Flash: proper page write. Dolphin: views. Power: views
* Dolphin: transition idle scree to Views
* Dolphin: input events on stats view. Format sources.
* HAL: flash erase. Dolphin: permanent state storage.
* Dolphin: first start welcome. HAL: flash operation status, errata 2.2.9 crutch.
* NFC: rewrite worker
* NFC: add support for B,F,V.
* NFC: replace rfal irq hanlder with realtime thread, more details about cards.
* Bootloader: LSE and RTS shenanigans, LED control, morse code for LSE failure error.
* F4: stop in Error_Handler
* BLE: handle working FUS, but empty radio stack.
* HAL: alive FUS is now sufficient for flash controller access
* Dolphin: update model after state load
* NFC: detect navigation
* RFAL: use osPriorityISR for isr thread
* NFC: emulation
* Bootloader: rollback incorrectly merged rename
* Dolphin: rollback incorrectly merged changes
* RFAL: remove volatile from thread attr
* RFAL: do not call platform ErrorHandler, error codes is enough
* NFC: improved error handling
* Format sources
* NFC: reset detect view model on start
* Format sources
* update codeowners
* NFC: hide last info if no card detected
2021-01-11 12:42:25 +00:00
|
|
|
*/
|
2021-09-16 16:12:07 +00:00
|
|
|
bool furi_hal_bt_lock_flash(bool erase_flag);
|
2020-12-18 20:15:29 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Unlock shared access to flash controller
|
|
|
|
*
|
|
|
|
* @param[in] erase_flag true if erase operation
|
|
|
|
*/
|
2021-09-16 16:12:07 +00:00
|
|
|
void furi_hal_bt_unlock_flash(bool erase_flag);
|
2020-12-18 20:15:29 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Start ble tone tx at given channel and power
|
|
|
|
*
|
|
|
|
* @param[in] channel The channel
|
|
|
|
* @param[in] power The power
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
void furi_hal_bt_start_tone_tx(uint8_t channel, uint8_t power);
|
2021-03-11 09:31:07 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Stop ble tone tx
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
void furi_hal_bt_stop_tone_tx();
|
2021-03-11 09:31:07 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** 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
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
void furi_hal_bt_start_packet_tx(uint8_t channel, uint8_t pattern, uint8_t datarate);
|
2021-03-11 09:31:07 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Stop sending ble packets
|
|
|
|
*
|
|
|
|
* @return sent packet count
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
uint16_t furi_hal_bt_stop_packet_test();
|
2021-05-28 22:57:11 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Start receiving packets
|
|
|
|
*
|
|
|
|
* @param[in] channel RX channel
|
|
|
|
* @param[in] datarate Datarate
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
void furi_hal_bt_start_packet_rx(uint8_t channel, uint8_t datarate);
|
2021-03-11 09:31:07 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Set up the RF to listen to a given RF channel
|
|
|
|
*
|
|
|
|
* @param[in] channel RX channel
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
void furi_hal_bt_start_rx(uint8_t channel);
|
2021-03-11 09:31:07 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Stop RF listenning
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
void furi_hal_bt_stop_rx();
|
2021-03-11 09:31:07 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Get RSSI
|
|
|
|
*
|
|
|
|
* @return RSSI in dBm
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
float furi_hal_bt_get_rssi();
|
2021-05-28 22:57:11 +00:00
|
|
|
|
2021-10-03 10:36:05 +00:00
|
|
|
/** Get number of transmitted packets
|
|
|
|
*
|
|
|
|
* @return packet count
|
|
|
|
*/
|
2021-08-08 18:03:25 +00:00
|
|
|
uint32_t furi_hal_bt_get_transmitted_packets();
|
2021-05-28 22:57:11 +00:00
|
|
|
|
2020-12-10 14:25:20 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|