lorawan_handler.h

Go to the documentation of this file.

#ifndef LORAWAN_HANDLER_H
#define LORAWAN_HANDLER_H
 
#include "esp_err.h"
 
#include <stdbool.h>
#include <stdint.h>
 
// Include TTN credentials from separate config file
#include "master/ttn_credentials.h"
 
// ============================================================================
// SX1276 Pin Configuration for TTGO T3 LoRa32 V1.6.1
// These can be overridden via build flags in platformio.ini
// ============================================================================
#ifndef LORA_SPI_HOST
#define LORA_SPI_HOST SPI2_HOST
#endif
 
#ifndef LORA_PIN_MISO
#define LORA_PIN_MISO 19
#endif
 
#ifndef LORA_PIN_MOSI
#define LORA_PIN_MOSI 27
#endif
 
#ifndef LORA_PIN_SCK
#define LORA_PIN_SCK 5
#endif
 
#ifndef LORA_PIN_CS
#define LORA_PIN_CS 18
#endif
 
#ifndef LORA_PIN_RST
#define LORA_PIN_RST 23
#endif
 
#ifndef LORA_PIN_DIO0
#define LORA_PIN_DIO0 26
#endif
 
#ifndef LORA_PIN_DIO1
#define LORA_PIN_DIO1 33
#endif
 
#ifndef LORA_PIN_DIO2
#define LORA_PIN_DIO2 32
#endif
 
// ============================================================================
// LoRaWAN Configuration
// ============================================================================
// EU868 frequency plan
#define LORA_FREQUENCY        868100000 // 868.1 MHz (EU868 default)
#define LORA_SPREADING_FACTOR 7         // SF7, good balance between range and data rate
#define LORA_BANDWIDTH        0         // 125 kHz
#define LORA_CODING_RATE      1         // 4/5
#define LORA_TX_POWER         20        // dBm (max power for testing)
 
// ============================================================================
// LoRaWAN Status
// ============================================================================
typedef enum
{
    LORAWAN_STATUS_IDLE,
    LORAWAN_STATUS_JOINING,
    LORAWAN_STATUS_JOINED,
    LORAWAN_STATUS_SENDING,
    LORAWAN_STATUS_TX_COMPLETE,
    LORAWAN_STATUS_ERROR
} lorawan_status_t;
 
// Callback type for TX complete
typedef void (*lorawan_tx_done_cb_t)(bool success);
 
// ============================================================================
// API Functions
// ============================================================================
 
esp_err_t lorawan_init(void);
 
esp_err_t lorawan_join(void);
 
bool lorawan_is_joined(void);
 
lorawan_status_t lorawan_get_status(void);
 
esp_err_t lorawan_send(uint8_t port, const uint8_t* data, uint8_t len, bool confirmed);
 
void lorawan_set_tx_done_callback(lorawan_tx_done_cb_t callback);
 
void lorawan_process(void);
 
void lorawan_deinit(void);
 
#endif // LORAWAN_HANDLER_H