#include "SX127x.h" SX127x::SX127x(Module* mod) { _mod = mod; } uint8_t SX127x::begin(uint8_t syncWord) { // set module properties _mod->init(USE_SPI, INT_BOTH); // try to find the SX127x chip uint8_t i = 0; bool flagFound = false; while((i < 10) && !flagFound) { uint8_t version = _mod->SPIreadRegister(SX127X_REG_VERSION); if(version == 0x12) { flagFound = true; } else { #ifdef KITELIB_DEBUG Serial.print("SX127x not found! ("); Serial.print(i + 1); Serial.print(" of 10 tries) SX127X_REG_VERSION == "); char buffHex[5]; sprintf(buffHex, "0x%02X", version); Serial.print(buffHex); Serial.println(); #endif delay(1000); i++; } } if(!flagFound) { DEBUG_PRINTLN_STR("No SX127x found!"); SPI.end(); return(ERR_CHIP_NOT_FOUND); } else { DEBUG_PRINTLN_STR("Found SX127x!"); } // set LoRa sync word uint8_t state = SX127x::setSyncWord(syncWord); if(state != ERR_NONE) { return(state); } return(ERR_NONE); } uint8_t SX127x::transmit(uint8_t* data, size_t len) { // check packet length if(len >= 256) { return(ERR_PACKET_TOO_LONG); } // calculate timeout uint16_t base = 1; float symbolLength = (float)(base << _sf) / (float)_bw; float de = 0; if(symbolLength >= 0.016) { de = 1; } float ih = (float)_mod->SPIgetRegValue(SX127X_REG_MODEM_CONFIG_1, 0, 0); float crc = (float)(_mod->SPIgetRegValue(SX127X_REG_MODEM_CONFIG_2, 2, 2) >> 2); float n_pre = (float)_mod->SPIgetRegValue(SX127X_REG_PREAMBLE_LSB); float n_pay = 8.0 + max(ceil((8.0 * (float)len - 4.0 * (float)_sf + 28.0 + 16.0 * crc - 20.0 * ih)/(4.0 * (float)_sf - 8.0 * de)) * (float)_cr, 0.0); uint32_t timeout = ceil(symbolLength * (n_pre + n_pay + 4.25) * 1000.0); // set mode to standby setMode(SX127X_STANDBY); // set DIO mapping _mod->SPIsetRegValue(SX127X_REG_DIO_MAPPING_1, SX127X_DIO0_TX_DONE, 7, 6); // clear interrupt flags clearIRQFlags(); // set packet length _mod->SPIsetRegValue(SX127X_REG_PAYLOAD_LENGTH, len); // set FIFO pointers _mod->SPIsetRegValue(SX127X_REG_FIFO_TX_BASE_ADDR, SX127X_FIFO_TX_BASE_ADDR_MAX); _mod->SPIsetRegValue(SX127X_REG_FIFO_ADDR_PTR, SX127X_FIFO_TX_BASE_ADDR_MAX); // write packet to FIFO _mod->SPIwriteRegisterBurst(SX127X_REG_FIFO, data, len); // start transmission setMode(SX127X_TX); // wait for packet transmission or timeout uint32_t start = millis(); while(!_mod->getInt0State()) { if(millis() - start > timeout) { clearIRQFlags(); return(ERR_TX_TIMEOUT); } } // clear interrupt flags clearIRQFlags(); return(ERR_NONE); } uint8_t SX127x::transmit(const char* str) { return(SX127x::transmit((uint8_t*)str, strlen(str))); } uint8_t SX127x::transmit(String& str) { return(SX127x::transmit(str.c_str())); } uint8_t SX127x::receive(uint8_t* data, size_t len) { // set mode to standby setMode(SX127X_STANDBY); // set DIO pin mapping _mod->SPIsetRegValue(SX127X_REG_DIO_MAPPING_1, SX127X_DIO0_RX_DONE | SX127X_DIO1_RX_TIMEOUT, 7, 4); // clear interrupt flags clearIRQFlags(); // set FIFO pointers _mod->SPIsetRegValue(SX127X_REG_FIFO_RX_BASE_ADDR, SX127X_FIFO_RX_BASE_ADDR_MAX); _mod->SPIsetRegValue(SX127X_REG_FIFO_ADDR_PTR, SX127X_FIFO_RX_BASE_ADDR_MAX); // set mode to receive setMode(SX127X_RXSINGLE); // wait for packet reception or timeout uint32_t start = millis(); while(!_mod->getInt0State()) { if(_mod->getInt1State()) { clearIRQFlags(); return(ERR_RX_TIMEOUT); } } uint32_t elapsed = millis() - start; // check integrity CRC if(_mod->SPIgetRegValue(SX127X_REG_IRQ_FLAGS, 5, 5) == SX127X_CLEAR_IRQ_FLAG_PAYLOAD_CRC_ERROR) { return(ERR_CRC_MISMATCH); } // get packet length size_t length = len; if(_sf != 6) { length = _mod->SPIgetRegValue(SX127X_REG_RX_NB_BYTES); } // read packet data _mod->SPIreadRegisterBurst(SX127X_REG_FIFO, length, data); // update data rate, RSSI and SNR dataRate = (length*8.0)/((float)elapsed/1000.0); lastPacketRSSI = -157 + _mod->SPIgetRegValue(SX127X_REG_PKT_RSSI_VALUE); int8_t rawSNR = (int8_t)_mod->SPIgetRegValue(SX127X_REG_PKT_SNR_VALUE); lastPacketSNR = rawSNR / 4.0; // clear interrupt flags clearIRQFlags(); return(ERR_NONE); } uint8_t SX127x::receive(String& str, size_t len) { // create temporary array to store received data char* data = new char[0]; uint8_t state = SX127x::receive((uint8_t*)data, len); // if packet was received successfully, copy data into String if(state == ERR_NONE) { data[strlen(data) - 1] = 0; str = String(data); } delete[] data; return(state); } uint8_t SX127x::scanChannel() { // set mode to standby setMode(SX127X_STANDBY); // set DIO pin mapping _mod->SPIsetRegValue(SX127X_REG_DIO_MAPPING_1, SX127X_DIO0_CAD_DONE | SX127X_DIO1_CAD_DETECTED, 7, 4); clearIRQFlags(); // set mode to CAD setMode(SX127X_CAD); // wait for channel activity detected or timeout while(!_mod->getInt0State()) { if(_mod->getInt1State()) { clearIRQFlags(); return(PREAMBLE_DETECTED); } } // clear interrupt flags clearIRQFlags(); return(CHANNEL_FREE); } uint8_t SX127x::sleep() { // set mode to sleep return(setMode(SX127X_SLEEP)); } uint8_t SX127x::standby() { // set mode to standby return(setMode(SX127X_STANDBY)); } uint8_t SX127x::setSyncWord(uint8_t syncWord) { // set mode to standby setMode(SX127X_STANDBY); // write register uint8_t state = _mod->SPIsetRegValue(SX127X_REG_SYNC_WORD, syncWord); if(state == ERR_NONE) { _syncWord = syncWord; } return(state); } uint8_t SX127x::setFrequencyRaw(float newFreq) { // set mode to standby setMode(SX127X_STANDBY); // calculate register values uint32_t base = 1; uint32_t FRF = (newFreq * (base << 19)) / 32.0; // write registers uint8_t state = _mod->SPIsetRegValue(SX127X_REG_FRF_MSB, (FRF & 0xFF0000) >> 16); state |= _mod->SPIsetRegValue(SX127X_REG_FRF_MID, (FRF & 0x00FF00) >> 8); state |= _mod->SPIsetRegValue(SX127X_REG_FRF_LSB, FRF & 0x0000FF); return(state); } uint8_t SX127x::config() { // set mode to SLEEP uint8_t state = setMode(SX127X_SLEEP); if(state != ERR_NONE) { return(state); } // set LoRa mode state = _mod->SPIsetRegValue(SX127X_REG_OP_MODE, SX127X_LORA, 7, 7); if(state != ERR_NONE) { return(state); } // set overcurrent protection and LNA gain state = _mod->SPIsetRegValue(SX127X_REG_OCP, SX127X_OCP_ON | SX127X_OCP_TRIM, 5, 0); state |= _mod->SPIsetRegValue(SX127X_REG_LNA, SX127X_LNA_GAIN_1 | SX127X_LNA_BOOST_ON); if(state != ERR_NONE) { return(state); } // turn off frequency hopping state = _mod->SPIsetRegValue(SX127X_REG_HOP_PERIOD, SX127X_HOP_PERIOD_OFF); if(state != ERR_NONE) { return(state); } // set default preamble length state = _mod->SPIsetRegValue(SX127X_REG_PREAMBLE_MSB, SX127X_PREAMBLE_LENGTH_MSB); state |= _mod->SPIsetRegValue(SX127X_REG_PREAMBLE_LSB, SX127X_PREAMBLE_LENGTH_LSB); if(state != ERR_NONE) { return(state); } // set mode to STANDBY state = setMode(SX127X_STANDBY); return(state); } uint8_t SX127x::setMode(uint8_t mode) { _mod->SPIsetRegValue(SX127X_REG_OP_MODE, mode, 2, 0); return(ERR_NONE); } void SX127x::clearIRQFlags() { _mod->SPIwriteRegister(SX127X_REG_IRQ_FLAGS, 0b11111111); }