Home IO Control
ESPHome add-on for IO-Homecontrol devices
Loading...
Searching...
No Matches
radio_sx1262.h File Reference
Architecture Layers » Radio Driver Layer

SX1262 radio driver for IO-Homecontrol. More...

#include "radio_soft_phy_driver_base.h"
#include "esphome/core/hal.h"
Include dependency graph for radio_sx1262.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes

class  esphome::home_io_control::RadioSX1262
 SX1262 implementation of RadioDriver. More...

Namespaces

namespace  esphome
namespace  esphome::home_io_control

Variables

static constexpr uint8_t esphome::home_io_control::SX1262_SET_STANDBY = 0x80
static constexpr uint8_t esphome::home_io_control::SX1262_SET_RX = 0x82
static constexpr uint8_t esphome::home_io_control::SX1262_SET_TX = 0x83
static constexpr uint8_t esphome::home_io_control::SX1262_SET_RF_FREQUENCY = 0x86
static constexpr uint8_t esphome::home_io_control::SX1262_SET_RX_TX_FALLBACK_MODE = 0x93
static constexpr uint8_t esphome::home_io_control::SX1262_WRITE_BUFFER = 0x0E
static constexpr uint8_t esphome::home_io_control::SX1262_READ_BUFFER = 0x1E
static constexpr uint8_t esphome::home_io_control::SX1262_SET_DIO_IRQ_PARAMS = 0x08
static constexpr uint8_t esphome::home_io_control::SX1262_GET_IRQ_STATUS = 0x12
static constexpr uint8_t esphome::home_io_control::SX1262_GET_PACKET_STATUS = 0x14
static constexpr uint8_t esphome::home_io_control::SX1262_GET_DEVICE_ERRORS = 0x17
static constexpr uint8_t esphome::home_io_control::SX1262_CLEAR_IRQ_STATUS = 0x02
static constexpr uint8_t esphome::home_io_control::SX1262_CLEAR_DEVICE_ERRORS = 0x07
static constexpr uint8_t esphome::home_io_control::SX1262_SET_PACKET_TYPE = 0x8A
static constexpr uint8_t esphome::home_io_control::SX1262_SET_MODULATION_PARAMS = 0x8B
static constexpr uint8_t esphome::home_io_control::SX1262_SET_PACKET_PARAMS = 0x8C
static constexpr uint8_t esphome::home_io_control::SX1262_SET_BUFFER_BASE_ADDRESS = 0x8F
static constexpr uint8_t esphome::home_io_control::SX1262_SET_PA_CONFIG = 0x95
static constexpr uint8_t esphome::home_io_control::SX1262_SET_TX_PARAMS = 0x8E
static constexpr uint8_t esphome::home_io_control::SX1262_SET_DIO2_AS_RF_SWITCH_CTRL = 0x9D
static constexpr uint8_t esphome::home_io_control::SX1262_SET_DIO3_AS_TCXO_CTRL = 0x97
static constexpr uint8_t esphome::home_io_control::SX1262_CALIBRATE = 0x89
static constexpr uint8_t esphome::home_io_control::SX1262_CALIBRATE_IMAGE = 0x98
static constexpr uint8_t esphome::home_io_control::SX1262_GET_RX_BUFFER_STATUS = 0x13
static constexpr uint8_t esphome::home_io_control::SX1262_GET_RSSI_INST = 0x15
static constexpr uint8_t esphome::home_io_control::SX1262_SET_REGULATOR_MODE = 0x96
static constexpr uint8_t esphome::home_io_control::SX1262_GET_STATUS = 0xC0
static constexpr uint8_t esphome::home_io_control::SX1262_WRITE_REGISTER = 0x0D
static constexpr uint8_t esphome::home_io_control::SX1262_READ_REGISTER = 0x1D
static constexpr uint16_t esphome::home_io_control::SX1262_IRQ_TX_DONE = 0x0001
static constexpr uint16_t esphome::home_io_control::SX1262_IRQ_RX_DONE = 0x0002
static constexpr uint16_t esphome::home_io_control::SX1262_IRQ_PREAMBLE_DETECTED = 0x0004
static constexpr uint16_t esphome::home_io_control::SX1262_IRQ_SYNC_WORD_VALID = 0x0008
static constexpr uint16_t esphome::home_io_control::SX1262_IRQ_CRC_ERR = 0x0040
static constexpr uint16_t esphome::home_io_control::SX1262_REG_SYNC_WORD = 0x06C0
static constexpr uint16_t esphome::home_io_control::SX1262_REG_RX_GAIN = 0x08AC
static constexpr uint16_t esphome::home_io_control::SX1262_REG_TX_CLAMP_CONFIG = 0x08D8
static constexpr uint16_t esphome::home_io_control::SX1262_REG_TX_MODULATION = 0x0889
 TX modulation-quality erratum register (SX1262 datasheet §15.1, "Modulation Quality with 500 kHz LoRa Bandwidth" — the title names LoRa, but the workaround table covers every modulation).
static constexpr uint8_t esphome::home_io_control::SX1262_TX_MODULATION_GFSK_BIT = 0x04
 Bit 2 of SX1262_REG_TX_MODULATION — the (G)FSK-correct value is 1.
static constexpr uint8_t esphome::home_io_control::SX1262_TX_BUFFER_BASE = 0x00
 Data-buffer split programmed by configure_buffer_base(): TX packets build from 0x00, RX packets land at 0x80.
static constexpr uint8_t esphome::home_io_control::SX1262_RX_BUFFER_BASE = 0x80
static constexpr uint8_t esphome::home_io_control::SX1262_GFSK_PACKET_TYPE_KNOWN_LENGTH = 0x00
static constexpr uint8_t esphome::home_io_control::SX1262_GFSK_CRC_OFF = 0x01
static constexpr uint8_t esphome::home_io_control::SX1262_FALLBACK_STDBY_XOSC = 0x30
static constexpr int32_t esphome::home_io_control::SX1262_EXCHANGE_RESPONSE_WAIT_SLICE_MS = 90
 SX1262-specific per-channel dwell while waiting for authenticated exchange responses.

Detailed Description

SX1262 radio driver for IO-Homecontrol.

Implements the RadioDriver interface for the Semtech SX1262 transceiver. Unlike the SX1276, the SX1262 uses opcode-based SPI commands and requires a BUSY pin check before every SPI transaction. The capture path preserves the radio-reported RX metadata so offline analysis can work from trustworthy data. The IRQ-driven RX/TX orchestration this driver shares with RadioLR1121 lives in SoftPhyDriverBase (see radio_soft_phy_driver_base.h) — this file has the SX1262-specific SPI transport and register/opcode encoding underneath it.

Todo
Validate Heltec V4-family boards on real hardware, especially the assumed front-end module enable pins and the required TCXO voltage selection.

Definition in file radio_sx1262.h.