kopia lustrzana https://github.com/helium/longfi-arduino
migrated st disco basic example to new lib
Kent Wiliams
rodzic
3c8e8acf66
commit
05e456509c
|
|
@ -1,30 +1,28 @@
|
||||||
# LongFi Arduino
|
# ST B-L072Z-LRWAN1 - Basic LongFi Example
|
||||||
|
|
||||||
## Installing the MCCI LMIC Library
|
|
||||||
|
|
||||||
From the Arduino IDE, open the Library Manager (Sketch->Include Library->Manage Libraries). In the search box, type MCCI and select the MCCI LoRaWAN LMIC library should be the first result.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Board Support
|
|
||||||
|
|
||||||
### B-L072Z-LRWAN1 - ST STM32L0 Discovery kit
|
|
||||||
Install board support package, find instructions [here](https://github.com/stm32duino/Arduino_Core_STM32#getting-started).
|
|
||||||
|
|
||||||
Arduino IDE:
|
|
||||||
1. Select Tools -> Board: -> Discovery
|
|
||||||
2. Select Tools -> Board part number: -> Discovery L072Z-LRWAN1
|
|
||||||
|
|
||||||
[B-L072Z-LRWAN1 Product Page](https://www.st.com/en/evaluation-tools/b-l072z-lrwan1.html)
|
[B-L072Z-LRWAN1 Product Page](https://www.st.com/en/evaluation-tools/b-l072z-lrwan1.html)
|
||||||
[B-L072Z-LRWAN1 User Manual](https://www.st.com/content/ccc/resource/technical/document/user_manual/group0/ac/62/15/c7/60/ac/4e/9c/DM00329995/files/DM00329995.pdf/jcr:content/translations/en.DM00329995.pdf)
|
[B-L072Z-LRWAN1 User Manual](https://www.st.com/content/ccc/resource/technical/document/user_manual/group0/ac/62/15/c7/60/ac/4e/9c/DM00329995/files/DM00329995.pdf/jcr:content/translations/en.DM00329995.pdf)
|
||||||
|
|
||||||
|
## Required Board Support & Library
|
||||||
|
|
||||||
|
### Arduino Core for STM32L0
|
||||||
|
Arduino IDE:
|
||||||
|
1. Navigate to (File > Preferences)
|
||||||
|
Find the section at the bottom called Additional Boards Manager URLs:
|
||||||
|
2. Add the URL below to the list and click ok to close the preferences.
|
||||||
|
```
|
||||||
|
https://grumpyoldpizza.github.io/ArduinoCore-stm32l0/package_stm32l0_boards_index.json
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
3. Open Boards Manager: Select Tools > Board: > Boards Manager...
|
||||||
|
4. Search for "Tlera Corp STM32L0 Boards"
|
||||||
|
5. Select the newest version and install.
|
||||||
|
|
||||||
|
|
||||||
## Programming (Uploading Method):
|
## Programming (Uploading Method):
|
||||||
|
|
||||||
### B-L072Z-LRWAN1 - ST STM32L0 Discovery kit
|
|
||||||
|
|
||||||
#### STM32CubeProgrammer(SWD)
|
|
||||||
Will use onboard ST-Link(Flasher/Debugger) to upload sketch.
|
|
||||||
Download and Install required utility from ST [here](https://www.st.com/en/development-tools/stm32cubeprog.html).
|
|
||||||
|
|
||||||
Arduino IDE:
|
Arduino IDE:
|
||||||
Select Tools -> Upload Method -> STM32CubeProgrammer(SWD)
|
1. Select Board: Tools > Board: > B-L072Z-LRWAN1
|
||||||
|
2. Select Port: Tools > Port > COM# or /dev/ttyACM#(B-L072Z-LRWAN1)
|
||||||
|
3. Upload Sketch: Select > Upload
|
||||||
|
|
|
||||||
|
|
@ -1,320 +1,82 @@
|
||||||
/*******************************************************************************
|
/* Simple OTAA join for a LoRaWAN network
|
||||||
* Copyright (c) 2015 Thomas Telkamp and Matthijs Kooijman
|
|
||||||
* Copyright (c) 2018 Terry Moore, MCCI
|
|
||||||
*
|
*
|
||||||
* Permission is hereby granted, free of charge, to anyone
|
* In setup() below please replace the argument to LoRaWAN.begin()
|
||||||
* obtaining a copy of this document and accompanying files,
|
* with your appropriate region specific band:
|
||||||
* to do whatever they want with them without any restriction,
|
|
||||||
* including, but not limited to, copying, modification and redistribution.
|
|
||||||
* NO WARRANTY OF ANY KIND IS PROVIDED.
|
|
||||||
*
|
*
|
||||||
* This example sends a valid LoRaWAN packet with payload "Hello,
|
* AS923
|
||||||
* world!", using frequency and encryption settings matching those of
|
* AU915
|
||||||
* the The Things Network. It's pre-configured for the Adafruit
|
* EU868
|
||||||
* Feather M0 LoRa.
|
* IN865
|
||||||
|
* KR920
|
||||||
|
* US915
|
||||||
*
|
*
|
||||||
*******************************************************************************/
|
* AU915/US915 networks have 64+8 channels. Typical gateways support only
|
||||||
|
* 8 (9) channels. Hence it's a good idea to pick the proper channel
|
||||||
/*******************************************************************************
|
* subset via select via LoRaWAN.setSubBand(),
|
||||||
*
|
*
|
||||||
* For Helium developers, follow the Arduino Quickstart guide:
|
* EU868/IN865 have duty cycle restrictions. For debugging it makes sense
|
||||||
* https://developer.helium.com/device/arduino-quickstart
|
* to disable those via setDutyCycle(false);
|
||||||
* TLDR: register your device on the console:
|
|
||||||
* https://console.helium.com/devices
|
|
||||||
*
|
*
|
||||||
* The App EUI (as lsb) and App Key (as msb) get inserted below.
|
* For an external antenna one should set the proper antenna gain
|
||||||
|
* (default is 2.0) via setAntennaGain().
|
||||||
*
|
*
|
||||||
*******************************************************************************/
|
* Please edit the keys below as they are just debugging samples.
|
||||||
|
*
|
||||||
|
*
|
||||||
|
* This example code is in the public domain.
|
||||||
|
*/
|
||||||
|
|
||||||
#include <SPI.h>
|
#include "LoRaWAN.h"
|
||||||
#include <arduino_lmic.h>
|
|
||||||
#include <arduino_lmic_hal_boards.h>
|
|
||||||
#include <arduino_lmic_hal_configuration.h>
|
|
||||||
#include <arduino_lmic_lorawan_compliance.h>
|
|
||||||
#include <arduino_lmic_user_configuration.h>
|
|
||||||
#include <hal/hal.h>
|
|
||||||
#include <lmic.h>
|
|
||||||
|
|
||||||
// This is the "App EUI" in Helium. Make sure it is little-endian (lsb).
|
const char *devEui = "00D644FC35CFC35E";
|
||||||
static const u1_t PROGMEM APPEUI[8] = {FILL_ME_IN};
|
const char *appEui = "5C23E22B09F08C65";
|
||||||
void os_getArtEui(u1_t *buf) { memcpy_P(buf, APPEUI, 8); }
|
const char *appKey = "BFE99D0DFCE6258295413283A87F8403";
|
||||||
|
|
||||||
// This should also be in little endian format
|
// Max Payload 11 Bytes for DR 0
|
||||||
// These are user configurable values and Helium console permits anything
|
const uint8_t payload[] = "Hello!";
|
||||||
static const u1_t PROGMEM DEVEUI[8] = {FILL_ME_IN};
|
|
||||||
void os_getDevEui(u1_t *buf) { memcpy_P(buf, DEVEUI, 8); }
|
|
||||||
|
|
||||||
// This is the "App Key" in Helium. It is big-endian (msb).
|
void setup( void )
|
||||||
static const u1_t PROGMEM APPKEY[16] = {FILL_ME_IN};
|
{
|
||||||
void os_getDevKey(u1_t *buf) { memcpy_P(buf, APPKEY, 16); }
|
Serial.begin(9600);
|
||||||
|
|
||||||
static uint8_t mydata[] = "Hello, world!";
|
while (!Serial) { }
|
||||||
static osjob_t sendjob;
|
|
||||||
|
|
||||||
// Schedule TX every this many seconds (might become longer due to duty
|
// US Region
|
||||||
// cycle limitations).
|
LoRaWAN.begin(US915);
|
||||||
const unsigned TX_INTERVAL = 60;
|
// Helium SubBand
|
||||||
|
LoRaWAN.setSubBand(7);
|
||||||
|
// Set Data Rate 0 - Max Payload 11 Bytes
|
||||||
|
LoRaWAN.setDataRate(0);
|
||||||
|
// Device IDs and Key
|
||||||
|
LoRaWAN.joinOTAA(appEui, appKey, devEui);
|
||||||
|
|
||||||
// Pin mapping
|
Serial.println("JOIN( )");
|
||||||
//
|
}
|
||||||
// Adafruit BSPs are not consistent -- m0 express defs ARDUINO_SAMD_FEATHER_M0,
|
|
||||||
// m0 defs ADAFRUIT_FEATHER_M0
|
|
||||||
//
|
|
||||||
#if defined(ARDUINO_SAMD_FEATHER_M0) || defined(ADAFRUIT_FEATHER_M0)
|
|
||||||
// Pin mapping for Adafruit Feather M0 LoRa, etc.
|
|
||||||
const lmic_pinmap lmic_pins = {
|
|
||||||
.nss = 8,
|
|
||||||
.rxtx = LMIC_UNUSED_PIN,
|
|
||||||
.rst = 4,
|
|
||||||
.dio = {3, 6, LMIC_UNUSED_PIN},
|
|
||||||
.rxtx_rx_active = 0,
|
|
||||||
.rssi_cal = 8, // LBT cal for the Adafruit Feather M0 LoRa, in dB
|
|
||||||
.spi_freq = 8000000,
|
|
||||||
};
|
|
||||||
#elif defined(ARDUINO_AVR_FEATHER32U4)
|
|
||||||
// Pin mapping for Adafruit Feather 32u4 LoRa, etc.
|
|
||||||
// Just like Feather M0 LoRa, but uses SPI at 1MHz; and that's only
|
|
||||||
// because MCCI doesn't have a test board; probably higher frequencies
|
|
||||||
// will work.
|
|
||||||
const lmic_pinmap lmic_pins = {
|
|
||||||
.nss = 8,
|
|
||||||
.rxtx = LMIC_UNUSED_PIN,
|
|
||||||
.rst = 4,
|
|
||||||
.dio = {7, 6, LMIC_UNUSED_PIN},
|
|
||||||
.rxtx_rx_active = 0,
|
|
||||||
.rssi_cal = 8, // LBT cal for the Adafruit Feather 32U4 LoRa, in dB
|
|
||||||
.spi_freq = 1000000,
|
|
||||||
};
|
|
||||||
#elif defined(ARDUINO_CATENA_4551)
|
|
||||||
// Pin mapping for Murata module / Catena 4551
|
|
||||||
const lmic_pinmap lmic_pins = {
|
|
||||||
.nss = 7,
|
|
||||||
.rxtx = 29,
|
|
||||||
.rst = 8,
|
|
||||||
.dio =
|
|
||||||
{
|
|
||||||
25, // DIO0 (IRQ) is D25
|
|
||||||
26, // DIO1 is D26
|
|
||||||
27, // DIO2 is D27
|
|
||||||
},
|
|
||||||
.rxtx_rx_active = 1,
|
|
||||||
.rssi_cal = 10,
|
|
||||||
.spi_freq = 8000000 // 8MHz
|
|
||||||
};
|
|
||||||
#elif defined(MCCI_CATENA_4610)
|
|
||||||
#include "arduino_lmic_hal_boards.h"
|
|
||||||
const lmic_pinmap lmic_pins = *Arduino_LMIC::GetPinmap_Catena4610();
|
|
||||||
#elif defined(ARDUINO_DISCO_L072CZ_LRWAN1)
|
|
||||||
const lmic_pinmap lmic_pins = *Arduino_LMIC::GetPinmap_Disco_L072cz_Lrwan1();
|
|
||||||
#else
|
|
||||||
#error "Unknown target"
|
|
||||||
#endif
|
|
||||||
|
|
||||||
void onEvent(ev_t ev) {
|
void loop( void )
|
||||||
Serial.print(os_getTime());
|
{
|
||||||
Serial.print(": ");
|
if (LoRaWAN.joined() && !LoRaWAN.busy())
|
||||||
switch (ev) {
|
|
||||||
case EV_SCAN_TIMEOUT:
|
|
||||||
Serial.println(F("EV_SCAN_TIMEOUT"));
|
|
||||||
break;
|
|
||||||
case EV_BEACON_FOUND:
|
|
||||||
Serial.println(F("EV_BEACON_FOUND"));
|
|
||||||
break;
|
|
||||||
case EV_BEACON_MISSED:
|
|
||||||
Serial.println(F("EV_BEACON_MISSED"));
|
|
||||||
break;
|
|
||||||
case EV_BEACON_TRACKED:
|
|
||||||
Serial.println(F("EV_BEACON_TRACKED"));
|
|
||||||
break;
|
|
||||||
case EV_JOINING:
|
|
||||||
Serial.println(F("EV_JOINING"));
|
|
||||||
break;
|
|
||||||
case EV_JOIN_TXCOMPLETE:
|
|
||||||
Serial.println(F("EV_JOIN_TXCOMPLETE"));
|
|
||||||
break;
|
|
||||||
case EV_JOINED:
|
|
||||||
Serial.println(F("EV_JOINED"));
|
|
||||||
{
|
{
|
||||||
u4_t netid = 0;
|
Serial.print("TRANSMIT( ");
|
||||||
devaddr_t devaddr = 0;
|
Serial.print("TimeOnAir: ");
|
||||||
u1_t nwkKey[16];
|
Serial.print(LoRaWAN.getTimeOnAir());
|
||||||
u1_t artKey[16];
|
Serial.print(", NextTxTime: ");
|
||||||
LMIC_getSessionKeys(&netid, &devaddr, nwkKey, artKey);
|
Serial.print(LoRaWAN.getNextTxTime());
|
||||||
Serial.print("netid: ");
|
Serial.print(", MaxPayloadSize: ");
|
||||||
Serial.println(netid, DEC);
|
Serial.print(LoRaWAN.getMaxPayloadSize());
|
||||||
Serial.print("devaddr: ");
|
Serial.print(", DR: ");
|
||||||
Serial.println(devaddr, HEX);
|
Serial.print(LoRaWAN.getDataRate());
|
||||||
Serial.print("artKey: ");
|
Serial.print(", TxPower: ");
|
||||||
for (size_t i = 0; i < sizeof(artKey); ++i) {
|
Serial.print(LoRaWAN.getTxPower(), 1);
|
||||||
if (i != 0)
|
Serial.print("dbm, UpLinkCounter: ");
|
||||||
Serial.print("-");
|
Serial.print(LoRaWAN.getUpLinkCounter());
|
||||||
Serial.print(artKey[i], HEX);
|
Serial.print(", DownLinkCounter: ");
|
||||||
}
|
Serial.print(LoRaWAN.getDownLinkCounter());
|
||||||
Serial.println("");
|
Serial.println(" )");
|
||||||
Serial.print("nwkKey: ");
|
|
||||||
for (size_t i = 0; i < sizeof(nwkKey); ++i) {
|
// Send Packet
|
||||||
if (i != 0)
|
LoRaWAN.sendPacket(1, payload, sizeof(payload));
|
||||||
Serial.print("-");
|
|
||||||
Serial.print(nwkKey[i], HEX);
|
|
||||||
}
|
|
||||||
Serial.println("");
|
|
||||||
}
|
}
|
||||||
// Disable link check validation (automatically enabled
|
|
||||||
// during join, but because slow data rates change max TX
|
delay(20000);
|
||||||
// size, we don't use it in this example.
|
|
||||||
LMIC_setLinkCheckMode(0);
|
|
||||||
break;
|
|
||||||
/*
|
|
||||||
|| This event is defined but not used in the code. No
|
|
||||||
|| point in wasting codespace on it.
|
|
||||||
||
|
|
||||||
|| case EV_RFU1:
|
|
||||||
|| Serial.println(F("EV_RFU1"));
|
|
||||||
|| break;
|
|
||||||
*/
|
|
||||||
case EV_JOIN_FAILED:
|
|
||||||
Serial.println(F("EV_JOIN_FAILED"));
|
|
||||||
break;
|
|
||||||
case EV_REJOIN_FAILED:
|
|
||||||
Serial.println(F("EV_REJOIN_FAILED"));
|
|
||||||
break;
|
|
||||||
break;
|
|
||||||
case EV_TXCOMPLETE:
|
|
||||||
Serial.println(F("EV_TXCOMPLETE (includes waiting for RX windows)"));
|
|
||||||
if (LMIC.txrxFlags & TXRX_ACK)
|
|
||||||
Serial.println(F("Received ack"));
|
|
||||||
if (LMIC.dataLen) {
|
|
||||||
Serial.println(F("Received "));
|
|
||||||
Serial.println(LMIC.dataLen);
|
|
||||||
Serial.println(F(" bytes of payload"));
|
|
||||||
}
|
|
||||||
// Schedule next transmission
|
|
||||||
os_setTimedCallback(&sendjob, os_getTime() + sec2osticks(TX_INTERVAL),
|
|
||||||
do_send);
|
|
||||||
break;
|
|
||||||
case EV_LOST_TSYNC:
|
|
||||||
Serial.println(F("EV_LOST_TSYNC"));
|
|
||||||
break;
|
|
||||||
case EV_RESET:
|
|
||||||
Serial.println(F("EV_RESET"));
|
|
||||||
break;
|
|
||||||
case EV_RXCOMPLETE:
|
|
||||||
// data received in ping slot
|
|
||||||
Serial.println(F("EV_RXCOMPLETE"));
|
|
||||||
break;
|
|
||||||
case EV_LINK_DEAD:
|
|
||||||
Serial.println(F("EV_LINK_DEAD"));
|
|
||||||
break;
|
|
||||||
case EV_LINK_ALIVE:
|
|
||||||
Serial.println(F("EV_LINK_ALIVE"));
|
|
||||||
break;
|
|
||||||
/*
|
|
||||||
|| This event is defined but not used in the code. No
|
|
||||||
|| point in wasting codespace on it.
|
|
||||||
||
|
|
||||||
|| case EV_SCAN_FOUND:
|
|
||||||
|| Serial.println(F("EV_SCAN_FOUND"));
|
|
||||||
|| break;
|
|
||||||
*/
|
|
||||||
case EV_TXSTART:
|
|
||||||
Serial.println(F("EV_TXSTART"));
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
Serial.print(F("Unknown event: "));
|
|
||||||
Serial.println((unsigned)ev);
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
void do_send(osjob_t *j) {
|
|
||||||
// Check if there is not a current TX/RX job running
|
|
||||||
if (LMIC.opmode & OP_TXRXPEND) {
|
|
||||||
Serial.println(F("OP_TXRXPEND, not sending"));
|
|
||||||
} else {
|
|
||||||
// Prepare upstream data transmission at the next possible time.
|
|
||||||
LMIC_setTxData2(1, mydata, sizeof(mydata) - 1, 0);
|
|
||||||
Serial.println(F("Packet queued"));
|
|
||||||
}
|
|
||||||
// Next TX is scheduled after TX_COMPLETE event.
|
|
||||||
}
|
|
||||||
|
|
||||||
void setup() {
|
|
||||||
delay(5000);
|
|
||||||
while (!Serial)
|
|
||||||
;
|
|
||||||
Serial.begin(9600);
|
|
||||||
Serial.println(F("Starting"));
|
|
||||||
|
|
||||||
#if defined(ARDUINO_DISCO_L072CZ_LRWAN1)
|
|
||||||
SPI.setMOSI(RADIO_MOSI_PORT);
|
|
||||||
SPI.setMISO(RADIO_MISO_PORT);
|
|
||||||
SPI.setSCLK(RADIO_SCLK_PORT);
|
|
||||||
SPI.setSSEL(RADIO_NSS_PORT);
|
|
||||||
// SPI.begin();
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifdef VCC_ENABLE
|
|
||||||
// For Pinoccio Scout boards
|
|
||||||
pinMode(VCC_ENABLE, OUTPUT);
|
|
||||||
digitalWrite(VCC_ENABLE, HIGH);
|
|
||||||
delay(1000);
|
|
||||||
#endif
|
|
||||||
|
|
||||||
// LMIC init
|
|
||||||
os_init();
|
|
||||||
// Reset the MAC state. Session and pending data transfers will be discarded.
|
|
||||||
LMIC_reset();
|
|
||||||
|
|
||||||
// allow much more clock error than the X/1000 default. See:
|
|
||||||
// https://github.com/mcci-catena/arduino-lorawan/issues/74#issuecomment-462171974
|
|
||||||
// https://github.com/mcci-catena/arduino-lmic/commit/42da75b56#diff-16d75524a9920f5d043fe731a27cf85aL633
|
|
||||||
// the X/1000 means an error rate of 0.1%; the above issue discusses using
|
|
||||||
// values up to 10%. so, values from 10 (10% error, the most lax) to 1000
|
|
||||||
// (0.1% error, the most strict) can be used.
|
|
||||||
LMIC_setClockError(1 * MAX_CLOCK_ERROR / 40);
|
|
||||||
|
|
||||||
LMIC_setLinkCheckMode(0);
|
|
||||||
LMIC_setDrTxpow(DR_SF8, 20);
|
|
||||||
LMIC_selectSubBand(6);
|
|
||||||
|
|
||||||
// Start job (sending automatically starts OTAA too)
|
|
||||||
do_send(&sendjob);
|
|
||||||
}
|
|
||||||
|
|
||||||
void loop() { os_runloop_once(); }
|
|
||||||
|
|
||||||
namespace Arduino_LMIC {
|
|
||||||
|
|
||||||
class HalConfiguration_Disco_L072cz_Lrwan1_t : public HalConfiguration_t {
|
|
||||||
public:
|
|
||||||
enum DIGITAL_PINS : uint8_t {
|
|
||||||
PIN_SX1276_NSS = 37,
|
|
||||||
PIN_SX1276_NRESET = 33,
|
|
||||||
PIN_SX1276_DIO0 = 38,
|
|
||||||
PIN_SX1276_DIO1 = 39,
|
|
||||||
PIN_SX1276_DIO2 = 40,
|
|
||||||
PIN_SX1276_RXTX = 21,
|
|
||||||
};
|
|
||||||
|
|
||||||
virtual bool queryUsingTcxo(void) override { return false; };
|
|
||||||
};
|
|
||||||
// save some typing by bringing the pin numbers into scope
|
|
||||||
static HalConfiguration_Disco_L072cz_Lrwan1_t myConfig;
|
|
||||||
|
|
||||||
static const HalPinmap_t myPinmap = {
|
|
||||||
.nss = HalConfiguration_Disco_L072cz_Lrwan1_t::PIN_SX1276_NSS,
|
|
||||||
.rxtx = HalConfiguration_Disco_L072cz_Lrwan1_t::PIN_SX1276_RXTX,
|
|
||||||
.rst = HalConfiguration_Disco_L072cz_Lrwan1_t::PIN_SX1276_NRESET,
|
|
||||||
|
|
||||||
.dio =
|
|
||||||
{
|
|
||||||
HalConfiguration_Disco_L072cz_Lrwan1_t::PIN_SX1276_DIO0,
|
|
||||||
HalConfiguration_Disco_L072cz_Lrwan1_t::PIN_SX1276_DIO1,
|
|
||||||
HalConfiguration_Disco_L072cz_Lrwan1_t::PIN_SX1276_DIO2,
|
|
||||||
},
|
|
||||||
.rxtx_rx_active = 1,
|
|
||||||
.rssi_cal = 10,
|
|
||||||
.spi_freq = 8000000, /* 8MHz */
|
|
||||||
.pConfig = &myConfig};
|
|
||||||
|
|
||||||
}; // end namespace Arduino_LMIC
|
|
||||||
Ładowanie…
Reference in New Issue