Semtech / lmic_MOTE_L152RC

LMIC for MOTE_L152RC

Dependents:   lmic_transmit

LoRa WAN in C for NA-mote 72

Currently version 1.5

LoRaWAN network configuration for end-device

The following three pieces of information uniquely identifies end-device to network to allow over-the-air activation. These are stored in the end-device prior to join procedure.

AppEUI

Uniquely identifies application provider of end-device.

Least-significant byte first, 8 bytes. Use LMIC_reverse_memcpy() for AppEUI to keep same byte order as that on lora server.

static const u1_t APPEUI[8]  = { 0x01, 0x00, 0x01, 0x00, 0x00, 0x0C, 0x25, 0x00 };

This is copied into LMIC by os_getArtEui() callback function in application.

DevEUI

End-device ID, unique to each end-node.

Least-significant byte first, 8 bytes. Use LMIC_reverse_memcpy() for DevEUI to keep same byte order as that on lora server.

static const u1_t DEVEUI[8]  = { 0x00, 0x00, 0x00, 0x00, 0x01, 0x0C, 0x25, 0x00 }; 

This is copied into LMIC by os_getDevEui() callback function in application.

AppKey (aka DevKey)

128-bit (16byte) AES key.

static const u1_t DEVKEY[16] = { 0xe4, 0x72, 0x71, 0xc5, 0xf5, 0x30, 0xa9, 0x9f, 0xcf, 0xc4, 0x0e, 0xab, 0xea, 0xd7, 0x19, 0x42 };

This is copied into LMIC by os_getDevKey() callback function in application.

Using over-the air activation, the end-device (LMIC) performs a join procedure every time it starts for first time, or has lost session context information. When join procedure has successfully completed, the end-device will have a network session key (NwkSKey) and an application session key (AppSKey), which are used for encryption and message integrity check.

configuration with http://us01-iot.semtech.com/

• log in to server
• click on Applications
• find your application and click it
• go to configure motes
• to create a mote, you may enter a new DevEUI
  • you may copy-paste the 16byte application key from an already existing mote, if you desire.

transmit power limits

FCC Part 15 rules permit one watt of transmit power when more than 50 channels are used. When received by a 64-channel gateway, the maximum power may be used.

However, if end-device is sending to a 8-channel gateway (single SX1301), the maximum transmit power permitted is +20dBm.

To configure LMIC for use with 8-channel gateway, CHNL_HYBRID should be defined in in config.h, and should be undefined for use with 64-channel gateway.

//#include "oslmic.h"
#include "lmic.h"
#include "debug.h"
#include "mbed.h"

Serial pc(USBTX, USBRX);

static DigitalOut red_led(PB_1);
#define LED_ON  0
#define LED_OFF 1

void debug_init()
{
    pc.baud(115200);

    // print banner
    debug_str("\r\n============== DEBUG STARTED ==============\r\n");

    red_led = LED_OFF;
}

void debug_str (const char* str)
{
    debug("%s", str);
}

void debug_event (int ev)
{
    static const u1_t* evnames[] = {
        [EV_SCAN_TIMEOUT]   = "SCAN_TIMEOUT",
        [EV_BEACON_FOUND]   = "BEACON_FOUND",
        [EV_BEACON_MISSED]  = "BEACON_MISSED",
        [EV_BEACON_TRACKED] = "BEACON_TRACKED",
        [EV_JOINING]        = "JOINING",
        [EV_JOINED]         = "JOINED",
        [EV_RFU1]           = "RFU1",
        [EV_JOIN_FAILED]    = "JOIN_FAILED",
        [EV_REJOIN_FAILED]  = "REJOIN_FAILED",
        [EV_TXCOMPLETE]     = "TXCOMPLETE",
        [EV_LOST_TSYNC]     = "LOST_TSYNC",
        [EV_RESET]          = "RESET",
        [EV_RXCOMPLETE]     = "RXCOMPLETE",
        [EV_LINK_DEAD]      = "LINK_DEAD",
        [EV_LINK_ALIVE]     = "LINK_ALIVE",
    };

    debug("%s\r\n", evnames[ev]);
}

void debug_val (const char* label, u4_t val)
{
    debug("%s%d\r\n", label, val);
}

void debug_buf(const u1_t* buf, u2_t len)
{
    while (len--) {
        debug("%02x ", *buf++);
    }
    debug("\r\n");
}

void debug_led(unsigned char on)
{
    if (on)
        red_led = LED_ON;
    else
        red_led = LED_OFF;
}

void debug_done()
{
    /* block until last bit sent out debug UART */
    while (!(USART2->SR & UART_FLAG_TC))
        __NOP();
}