* ApiHal: set frequency and path in one go. Drivers: proper frequency registers calculation for CC1101. Update subghz cli to match new api. * SubGhz: preparation for parsers porting, tim2 sharing * ApiHal: add interrupts API, move all TIM2 related things there. * SubGhz: refactor protocol lib and add keeloq. * SubGhz: proper init_set for keeloq manafacture key * SubGhz: port more protocols to lib * SubGhz: load keeloq manufacture keys from sd card (if any). * SubGhz: format output from protocols. * SubGhz: use default frequency in subghz_rx cli command. * SubGhz: keeloq key types * Fix compillation error when internal storage disabled * SubGhz: minor cleanup * SubGhz: properly handle timeout and reset signal in subghz_rx * SubGhz: Worker, Capture View. Furi: emulate thread join. * SubGhz: free strings on keeloq key load end * SubGhz: update protocols reporting API, app refactoring and capture view, update API HAL usage. * SubGhz: update dump formatting * ApiHal: backport subghz preset to F5 * ApiHal: backport subghz frequency range to F5
		
			
				
	
	
		
			144 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			144 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
#pragma once
 | 
						|
 | 
						|
#include <stdbool.h>
 | 
						|
#include <stdint.h>
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
extern "C" {
 | 
						|
#endif
 | 
						|
 | 
						|
/** Radio Presets */
 | 
						|
typedef enum {
 | 
						|
    ApiHalSubGhzPresetOokAsync,     /** OOK, asynchronous */
 | 
						|
    ApiHalSubGhzPreset2FskPacket,   /** 2FSK, 115kBaud, variable packet length */
 | 
						|
    ApiHalSubGhzPresetMP,      /** MP OOK, asynchronous */
 | 
						|
} ApiHalSubGhzPreset;
 | 
						|
 | 
						|
/**  Switchable Radio Paths */
 | 
						|
typedef enum {
 | 
						|
    ApiHalSubGhzPathIsolate,        /** Isolate Radio from antenna */
 | 
						|
    ApiHalSubGhzPath433,            /** Center Frquency: 433MHz. Path 1: SW1RF1-SW2RF2, LCLCL */
 | 
						|
    ApiHalSubGhzPath315,            /** Center Frquency: 315MHz. Path 2: SW1RF2-SW2RF1, LCLCLCL */
 | 
						|
    ApiHalSubGhzPath868,            /** Center Frquency: 868MHz. Path 3: SW1RF3-SW2RF3, LCLC */
 | 
						|
} ApiHalSubGhzPath;
 | 
						|
 | 
						|
/** 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 api_hal_subghz_init();
 | 
						|
 | 
						|
/** Dump info to stdout */
 | 
						|
void api_hal_subghz_dump_state();
 | 
						|
 | 
						|
/** Load registers from preset by preset name 
 | 
						|
 * @param preset to load
 | 
						|
 */
 | 
						|
void api_hal_subghz_load_preset(ApiHalSubGhzPreset preset);
 | 
						|
 | 
						|
/** Get status */
 | 
						|
uint8_t api_hal_subghz_get_status();
 | 
						|
 | 
						|
/** Load registers
 | 
						|
 * @param register-value pairs array, terminated with {0,0}
 | 
						|
 */
 | 
						|
void api_hal_subghz_load_registers(const uint8_t data[][2]);
 | 
						|
 | 
						|
/** Load PATABLE
 | 
						|
 * @param data, 8 uint8_t values
 | 
						|
 */
 | 
						|
void api_hal_subghz_load_patable(const uint8_t data[8]);
 | 
						|
 | 
						|
/** Write packet to FIFO
 | 
						|
 * @param data, bytes array
 | 
						|
 * @param size, size
 | 
						|
 */
 | 
						|
void api_hal_subghz_write_packet(const uint8_t* data, uint8_t size);
 | 
						|
 | 
						|
/** Read packet from FIFO
 | 
						|
 * @param data, pointer
 | 
						|
 * @param size, size
 | 
						|
 */
 | 
						|
 | 
						|
void api_hal_subghz_read_packet(uint8_t* data, uint8_t* size);
 | 
						|
 | 
						|
/** Flush rx FIFO buffer */
 | 
						|
void api_hal_subghz_flush_rx();
 | 
						|
 | 
						|
/** Shutdown
 | 
						|
 * Issue spwd command
 | 
						|
 * @warning registers content will be lost
 | 
						|
 */
 | 
						|
void api_hal_subghz_shutdown();
 | 
						|
 | 
						|
/** Reset
 | 
						|
 * Issue reset command
 | 
						|
 * @warning registers content will be lost
 | 
						|
 */
 | 
						|
void api_hal_subghz_reset();
 | 
						|
 | 
						|
/** Switch to Idle */
 | 
						|
void api_hal_subghz_idle();
 | 
						|
 | 
						|
/** Switch to Recieve */
 | 
						|
void api_hal_subghz_rx();
 | 
						|
 | 
						|
/** Switch to Transmit */
 | 
						|
void api_hal_subghz_tx();
 | 
						|
 | 
						|
/** Get RSSI value in dBm */
 | 
						|
float api_hal_subghz_get_rssi();
 | 
						|
 | 
						|
/** Set frequency and path
 | 
						|
 * This function automatically selects antenna matching network
 | 
						|
 * @param frequency in herz
 | 
						|
 * @return real frequency in herz
 | 
						|
 */
 | 
						|
uint32_t api_hal_subghz_set_frequency_and_path(uint32_t value);
 | 
						|
 | 
						|
/** Set frequency
 | 
						|
 * @param frequency in herz
 | 
						|
 * @return real frequency in herz
 | 
						|
 */
 | 
						|
uint32_t api_hal_subghz_set_frequency(uint32_t value);
 | 
						|
 | 
						|
/** Set path
 | 
						|
 * @param radio path to use
 | 
						|
 */
 | 
						|
void api_hal_subghz_set_path(ApiHalSubGhzPath path);
 | 
						|
 | 
						|
/** Front Definition for capture callback */
 | 
						|
typedef enum {
 | 
						|
    ApiHalSubGhzCaptureLevelHigh,
 | 
						|
    ApiHalSubGhzCaptureLevelLow,
 | 
						|
    ApiHalSubGhzCaptureLevelOverrun,
 | 
						|
    ApiHalSubGhzCaptureLevelUnderrun,
 | 
						|
} ApiHalSubGhzCaptureLevel;
 | 
						|
 | 
						|
typedef struct {
 | 
						|
    ApiHalSubGhzCaptureLevel level;
 | 
						|
    uint32_t duration;
 | 
						|
} LevelPair;
 | 
						|
 | 
						|
/** Signal Timings Capture callback */
 | 
						|
typedef void (*ApiHalSubGhzCaptureCallback)(ApiHalSubGhzCaptureLevel level, uint32_t time, void* context);
 | 
						|
 | 
						|
/** Set signal timings capture callback
 | 
						|
 * @param callback - your callback for front capture
 | 
						|
 */
 | 
						|
void api_hal_subghz_set_capture_callback(ApiHalSubGhzCaptureCallback callback, void* context);
 | 
						|
 | 
						|
/** Enable signal timings capture 
 | 
						|
 * Initializes GPIO and TIM2 for timings capture
 | 
						|
 */
 | 
						|
void api_hal_subghz_enable_capture();
 | 
						|
 | 
						|
/** Disable signal timings capture
 | 
						|
 * Resets GPIO and TIM2
 | 
						|
 */
 | 
						|
void api_hal_subghz_disable_capture();
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
}
 | 
						|
#endif
 |