1cfa857f98
* SubGhz: scene based application * SubGhz: encoder/decoder separation, DMA streaming, update app and cli. * SubGhz: 2 stage async tx complete, minor cleanup * SubGhz: 2 stage async tx complete, FIX state pin end transmit * SubGhz: Pricenton, receive TE signal * SubGhz: Pricenton, add save data, add load data * SubGhz: Add Read scene, Fix pricenton save, load funtion * SubGhz: Add Read, Receiver, SaveName scene * SubGhz: Read and Save (pricenton) * SubGhz: add Load scence * SubGhz: Fix select file scene, add load scene, add transmitter view, add send tx pricenton * SubGhz: Fix pricenton encoder, fix transmitter send * SubGhz: modified Pricenton Encoder (added guard time at the beginning), modified CC1101 config, code refactoring * SubGhz: Fix pricenton encoder defalut TE * Archive: Fix path and name SubGhz * Archive: Fix name app SubGhz * GubGhz: Came: add Save, Load key * GubGhz: GateTX: add Save, Load key * GubGhz: NeroSketch: add Save, Load key * Github: better linters triggers * SubGhz: adding fast loading keys Archive -> Run in app * GubGhz: KeeLog: add Save, Load key, key generation from the serial number of the meter and the button * SubGhz: format sources and fix compilation * FuriHal: add subghz configuration description for AGC section * SubGhz: save only protocols that can be saved. Cleanup. * Github: lint on pull requests Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
167 lines
4.3 KiB
C
167 lines
4.3 KiB
C
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
#include <toolbox/level_duration.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** Radio Presets */
|
|
typedef enum {
|
|
FuriHalSubGhzPresetOokAsync, /** OOK, asynchronous */
|
|
} FuriHalSubGhzPreset;
|
|
|
|
/** Switchable Radio Paths */
|
|
typedef enum {
|
|
FuriHalSubGhzPathIsolate, /** Isolate Radio from antenna */
|
|
FuriHalSubGhzPath433, /** Center Frquency: 433MHz. Path 1: SW1RF1-SW2RF2, LCLCL */
|
|
FuriHalSubGhzPath315, /** Center Frquency: 315MHz. Path 2: SW1RF2-SW2RF1, LCLCLCL */
|
|
FuriHalSubGhzPath868, /** Center Frquency: 868MHz. Path 3: SW1RF3-SW2RF3, LCLC */
|
|
} FuriHalSubGhzPath;
|
|
|
|
/** SubGhz state */
|
|
typedef enum {
|
|
SubGhzStateInit, /** Init pending */
|
|
|
|
SubGhzStateIdle, /** Idle, energy save mode */
|
|
|
|
SubGhzStateAsyncRx, /** Async RX started */
|
|
|
|
SubGhzStateAsyncTx, /** Async TX started, DMA and timer is on */
|
|
SubGhzStateAsyncTxLast, /** Async TX continue, DMA completed and timer got last value to go */
|
|
SubGhzStateAsyncTxEnd, /** Async TX complete, cleanup needed */
|
|
} SubGhzState;
|
|
|
|
/** Initialize and switch to power save mode
|
|
* Used by internal API-HAL initalization routine
|
|
* Can be used to reinitialize device to safe state and send it to sleep
|
|
*/
|
|
void furi_hal_subghz_init();
|
|
|
|
/** Send device to sleep mode */
|
|
void furi_hal_subghz_sleep();
|
|
|
|
/** Dump info to stdout */
|
|
void furi_hal_subghz_dump_state();
|
|
|
|
/** Load registers from preset by preset name
|
|
* @param preset to load
|
|
*/
|
|
void furi_hal_subghz_load_preset(FuriHalSubGhzPreset preset);
|
|
|
|
/** Get status */
|
|
uint8_t furi_hal_subghz_get_status();
|
|
|
|
/** Load registers
|
|
* @param register-value pairs array, terminated with {0,0}
|
|
*/
|
|
void furi_hal_subghz_load_registers(const uint8_t data[][2]);
|
|
|
|
/** Load PATABLE
|
|
* @param data, 8 uint8_t values
|
|
*/
|
|
void furi_hal_subghz_load_patable(const uint8_t data[8]);
|
|
|
|
/** Write packet to FIFO
|
|
* @param data, bytes array
|
|
* @param size, size
|
|
*/
|
|
void furi_hal_subghz_write_packet(const uint8_t* data, uint8_t size);
|
|
|
|
/** Read packet from FIFO
|
|
* @param data, pointer
|
|
* @param size, size
|
|
*/
|
|
void furi_hal_subghz_read_packet(uint8_t* data, uint8_t* size);
|
|
|
|
/** Flush rx FIFO buffer */
|
|
void furi_hal_subghz_flush_rx();
|
|
|
|
/** Shutdown
|
|
* Issue spwd command
|
|
* @warning registers content will be lost
|
|
*/
|
|
void furi_hal_subghz_shutdown();
|
|
|
|
/** Reset
|
|
* Issue reset command
|
|
* @warning registers content will be lost
|
|
*/
|
|
void furi_hal_subghz_reset();
|
|
|
|
/** Switch to Idle */
|
|
void furi_hal_subghz_idle();
|
|
|
|
/** Switch to Recieve */
|
|
void furi_hal_subghz_rx();
|
|
|
|
/** Switch to Transmit */
|
|
void furi_hal_subghz_tx();
|
|
|
|
/** Get RSSI value in dBm */
|
|
float furi_hal_subghz_get_rssi();
|
|
|
|
/** Check if frequency is in valid range
|
|
* @return true if frequncy is valid, otherwise false
|
|
*/
|
|
bool furi_hal_subghz_is_frequency_valid(uint32_t value);
|
|
|
|
/** Set frequency and path
|
|
* This function automatically selects antenna matching network
|
|
* @param frequency in herz
|
|
* @return real frequency in herz
|
|
*/
|
|
uint32_t furi_hal_subghz_set_frequency_and_path(uint32_t value);
|
|
|
|
/** Set frequency
|
|
* @param frequency in herz
|
|
* @return real frequency in herz
|
|
*/
|
|
uint32_t furi_hal_subghz_set_frequency(uint32_t value);
|
|
|
|
/** Set path
|
|
* @param radio path to use
|
|
*/
|
|
void furi_hal_subghz_set_path(FuriHalSubGhzPath path);
|
|
|
|
/* High Level API */
|
|
|
|
/** Signal Timings Capture callback */
|
|
typedef void (*FuriHalSubGhzCaptureCallback)(bool level, uint32_t duration, void* context);
|
|
|
|
/** Enable signal timings capture
|
|
* Initializes GPIO and TIM2 for timings capture
|
|
*/
|
|
void furi_hal_subghz_start_async_rx(FuriHalSubGhzCaptureCallback callback, void* context);
|
|
|
|
/** Disable signal timings capture
|
|
* Resets GPIO and TIM2
|
|
*/
|
|
void furi_hal_subghz_stop_async_rx();
|
|
|
|
/** Async TX callback type
|
|
* @param context - callback context
|
|
* @return LevelDuration
|
|
*/
|
|
typedef LevelDuration (*FuriHalSubGhzAsyncTxCallback)(void* context);
|
|
|
|
/** Start async TX
|
|
* Initializes GPIO, TIM2 and DMA1 for signal output
|
|
*/
|
|
void furi_hal_subghz_start_async_tx(FuriHalSubGhzAsyncTxCallback callback, void* context);
|
|
|
|
/** Wait for async transmission to complete */
|
|
bool furi_hal_subghz_is_async_tx_complete();
|
|
|
|
/** Stop async transmission and cleanup resources
|
|
* Resets GPIO, TIM2, and DMA1
|
|
*/
|
|
void furi_hal_subghz_stop_async_tx();
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|