#define RADIOLIB_STATIC_ONLY 1 #include "RadioLibWrappers.h" #define STATE_IDLE 0 #define STATE_RX 1 #define STATE_TX_WAIT 3 #define STATE_TX_DONE 4 #define STATE_INT_READY 16 #define NUM_NOISE_FLOOR_SAMPLES 64 #define SAMPLING_THRESHOLD 14 static volatile uint8_t state = STATE_IDLE; // this function is called when a complete packet // is transmitted by the module static #if defined(ESP8266) || defined(ESP32) ICACHE_RAM_ATTR #endif void setFlag(void) { // we sent a packet, set the flag state |= STATE_INT_READY; } void RadioLibWrapper::begin() { _radio->setPacketReceivedAction(setFlag); // this is also SentComplete interrupt state = STATE_IDLE; if (_board->getStartupReason() == BD_STARTUP_RX_PACKET) { // received a LoRa packet (while in deep sleep) setFlag(); // LoRa packet is already received } _noise_floor = 0; _threshold = 0; // start average out some samples _num_floor_samples = 0; _floor_sample_sum = 0; } void RadioLibWrapper::idle() { _radio->standby(); state = STATE_IDLE; // need another startReceive() } void RadioLibWrapper::triggerNoiseFloorCalibrate(int threshold) { _threshold = threshold; // Only restart sampling when threshold > 0 (interference detection enabled). // With threshold=0 the noise floor is never used, so periodic SPI re-sampling // is pointless — and on boards with a shared-bus IRQ (e.g. TCA9535) the BUSY // transitions generated by those SPI calls fire spurious interrupts that break RX. if (threshold > 0 && _num_floor_samples >= NUM_NOISE_FLOOR_SAMPLES) { _num_floor_samples = 0; _floor_sample_sum = 0; } } void RadioLibWrapper::resetAGC() { // make sure we're not mid-receive of packet! if ((state & STATE_INT_READY) != 0 || isReceivingPacket()) return; // NOTE: according to higher powers, just issuing RadioLib's startReceive() will reset the AGC. // revisit this if a better impl is discovered. state = STATE_IDLE; // trigger a startReceive() } void RadioLibWrapper::loop() { if (state == STATE_RX && _num_floor_samples < NUM_NOISE_FLOOR_SAMPLES) { if (!isReceivingPacket()) { int rssi = getCurrentRSSI(); if (rssi < _noise_floor + SAMPLING_THRESHOLD) { // only consider samples below current floor + sampling THRESHOLD _num_floor_samples++; _floor_sample_sum += rssi; } } } else if (_num_floor_samples >= NUM_NOISE_FLOOR_SAMPLES && _floor_sample_sum != 0) { _noise_floor = _floor_sample_sum / NUM_NOISE_FLOOR_SAMPLES; if (_noise_floor < -120) { _noise_floor = -120; // clamp to lower bound of -120dBi } _floor_sample_sum = 0; MESH_DEBUG_PRINTLN("RadioLibWrapper: noise_floor = %d", (int)_noise_floor); } } void RadioLibWrapper::startRecv() { int err = _radio->startReceive(); if (err == RADIOLIB_ERR_NONE) { state = STATE_RX; } else { MESH_DEBUG_PRINTLN("RadioLibWrapper: error: startReceive(%d)", err); } } bool RadioLibWrapper::isInRecvMode() const { return (state & ~STATE_INT_READY) == STATE_RX; } int RadioLibWrapper::recvRaw(uint8_t* bytes, int sz) { // Allow subclasses to gate STATE_INT_READY on the physical IRQ pin. // On boards with a shared-bus /INT (e.g. TCA9535), this reads DIO1 // via I2C and only sets STATE_INT_READY when the radio actually asserted it. dispatchPendingIrq(); int len = 0; if (state & STATE_INT_READY) { len = _radio->getPacketLength(); MESH_DEBUG_PRINTLN("RadioLibWrapper: IRQ fired, pkt_len=%d", len); if (len > 0) { if (len > sz) { len = sz; } int err = _radio->readData(bytes, len); if (err != RADIOLIB_ERR_NONE) { MESH_DEBUG_PRINTLN("RadioLibWrapper: error: readData(%d)", err); len = 0; n_recv_errors++; } else { MESH_DEBUG_PRINTLN("RadioLibWrapper: recv %d bytes RSSI=%.1f SNR=%.1f", len, getLastRSSI(), getLastSNR()); n_recv++; } } state = STATE_IDLE; // need another startReceive() } if (state != STATE_RX) { // Note: we intentionally do NOT call isReceivingPacket() here. // On boards where DIO1/BUSY share a TCA9535 /INT line, isReceivingPacket() // does an SPI read which generates another BUSY pulse → another spurious // interrupt → infinite pkt_len=0 loop. Calling startReceive() unconditionally // is safe: if pkt_len was 0 the packet was not yet complete (or the interrupt // was fully spurious), so restarting RX is correct. int err = _radio->startReceive(); if (err == RADIOLIB_ERR_NONE) { state = STATE_RX; state &= ~STATE_INT_READY; // BUSY transitions during startReceive fire TCA9535 /INT spuriously } else { MESH_DEBUG_PRINTLN("RadioLibWrapper: error: startReceive(%d)", err); } } return len; } uint32_t RadioLibWrapper::getEstAirtimeFor(int len_bytes) { return _radio->getTimeOnAir(len_bytes) / 1000; } bool RadioLibWrapper::startSendRaw(const uint8_t* bytes, int len) { _board->onBeforeTransmit(); int err = _radio->startTransmit((uint8_t *) bytes, len); if (err == RADIOLIB_ERR_NONE) { state = STATE_TX_WAIT; return true; } MESH_DEBUG_PRINTLN("RadioLibWrapper: error: startTransmit(%d)", err); idle(); // trigger another startRecv() _board->onAfterTransmit(); return false; } bool RadioLibWrapper::isSendComplete() { if (state & STATE_INT_READY) { state = STATE_IDLE; n_sent++; return true; } return false; } void RadioLibWrapper::onSendFinished() { _radio->finishTransmit(); _board->onAfterTransmit(); state = STATE_IDLE; } bool RadioLibWrapper::isChannelActive() { return _threshold == 0 ? false // interference check is disabled : getCurrentRSSI() > _noise_floor + _threshold; } float RadioLibWrapper::getLastRSSI() const { return _radio->getRSSI(); } float RadioLibWrapper::getLastSNR() const { return _radio->getSNR(); } // Approximate SNR threshold per SF for successful reception (based on Semtech datasheets) static float snr_threshold[] = { -7.5, // SF7 needs at least -7.5 dB SNR -10, // SF8 needs at least -10 dB SNR -12.5, // SF9 needs at least -12.5 dB SNR -15, // SF10 needs at least -15 dB SNR -17.5,// SF11 needs at least -17.5 dB SNR -20 // SF12 needs at least -20 dB SNR }; float RadioLibWrapper::packetScoreInt(float snr, int sf, int packet_len) { if (sf < 7) return 0.0f; if (snr < snr_threshold[sf - 7]) return 0.0f; // Below threshold, no chance of success auto success_rate_based_on_snr = (snr - snr_threshold[sf - 7]) / 10.0; auto collision_penalty = 1 - (packet_len / 256.0); // Assuming max packet of 256 bytes return max(0.0, min(1.0, success_rate_based_on_snr * collision_penalty)); }