71 lines
3.2 KiB
C
71 lines
3.2 KiB
C
// Minimal SX1262 driver for wM-Bus C1 on Heltec WiFi LoRa 32 V4.3.
|
|
// GFSK packet mode only. No LoRa support.
|
|
#pragma once
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
|
|
// IRQ bits (SX126x datasheet 13.3.1)
|
|
#define SX126X_IRQ_TX_DONE (1u << 0)
|
|
#define SX126X_IRQ_RX_DONE (1u << 1)
|
|
#define SX126X_IRQ_PREAMBLE_DETECTED (1u << 2)
|
|
#define SX126X_IRQ_SYNCWORD_VALID (1u << 3)
|
|
#define SX126X_IRQ_CRC_ERR (1u << 6)
|
|
#define SX126X_IRQ_TIMEOUT (1u << 9)
|
|
#define SX126X_IRQ_ALL 0x03FFu
|
|
|
|
typedef struct {
|
|
bool spi_ok; // sync-word register readback matched
|
|
bool reset_ok; // BUSY went low after reset
|
|
bool busy_ok; // BUSY currently low
|
|
bool tcxo_ok; // XOSC start + calibrate succeeded (no device errors)
|
|
uint16_t device_errors;
|
|
uint8_t chip_mode; // from GetStatus, 3-bit chip mode field
|
|
} sx126x_diag_t;
|
|
|
|
// Fills diag during bring-up. Returns true if the radio is usable.
|
|
bool sx126x_init(sx126x_diag_t *diag);
|
|
|
|
// Configure GFSK modem for wM-Bus C1: 100 kbps, +/-45 kHz, sync 0x543D.
|
|
// rx_payload_len is the fixed RX capture length (we truncate in software).
|
|
bool sx126x_config_wmbus_c1(uint32_t freq_hz, uint8_t rx_payload_len);
|
|
|
|
bool sx126x_set_tx_power(int8_t dbm); // -9 .. +2 (external FEM follows)
|
|
bool sx126x_set_rx(void); // continuous RX, FEM to RX path
|
|
bool sx126x_standby(void);
|
|
bool sx126x_config_intact(void); // sync-word readback still correct
|
|
bool sx126x_inject_sleep(void); // fault injection: SLEEP, config lost
|
|
|
|
// Transmit buf as GFSK payload (sync word prepended by radio).
|
|
// Handles FEM CTX switching. Blocking until commands issued; TX-done is
|
|
// signalled via DIO1/IRQ. timeout handled by caller.
|
|
bool sx126x_start_tx(const uint8_t *buf, uint8_t len); // C-mode deviation
|
|
// t1_deviation = true selects 50 kHz FSK deviation (T-mode); C uses 45 kHz
|
|
bool sx126x_start_tx_mode(const uint8_t *buf, uint8_t len, bool t1_deviation);
|
|
// Restore fixed RX payload length after a TX (packet params are shared).
|
|
bool sx126x_restore_rx_payload_len(void);
|
|
|
|
uint16_t sx126x_get_irq(void);
|
|
bool sx126x_clear_irq(uint16_t mask);
|
|
// Read last received packet. Returns actual bytes copied (<= maxlen).
|
|
int sx126x_read_rx(uint8_t *out, size_t maxlen, int8_t *rssi_dbm);
|
|
int8_t sx126x_get_rssi_inst(void);
|
|
uint16_t sx126x_get_device_errors(void);
|
|
uint8_t sx126x_get_status(void);
|
|
// Raw command exchange for diagnostics: sends op + n_tx arg bytes, captures
|
|
// the full-duplex MISO bytes into rx (same length). Returns false on error.
|
|
bool sx126x_raw(uint8_t op, const uint8_t *args, size_t n_tx,
|
|
uint8_t *rx, size_t rx_len);
|
|
|
|
// FEM control (exposed for diagnostics)
|
|
void fem_set_tx(bool tx);
|
|
void fem_power(bool on);
|
|
// Desired FEM/preamble settings are mutated only by the radio owner at a loop boundary.
|
|
void fem_set_rx_csd(bool en); // LNA experiment: FEM CSD level in RX
|
|
void sx126x_set_preamble_detect(uint8_t code); // 0x00 off, 0x04=8b, 0x05=16b, 0x06=24b, 0x07=32b
|
|
|
|
// Registered by caller before init; invoked from DIO1 GPIO ISR.
|
|
typedef void (*sx126x_irq_cb_t)(int64_t timestamp_us);
|
|
void sx126x_set_irq_callback(sx126x_irq_cb_t cb);
|