// Minimal SX1262 driver for wM-Bus C1 on Heltec WiFi LoRa 32 V4.3. // GFSK packet mode only. No LoRa support. #pragma once #include #include #include // 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 .. +14 (PA config capped) 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); // 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); void fem_set_rx_csd(bool en); // LNA experiment: FEM CSD level in RX void sx126x_set_pa_low(bool low); // PA table: true = lowest documented output // 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);