This repository is the Arduino portion of The Things Network New York's Map The Things app the global coverage map for The Things Network (TTN).
The app was developed primarily by Frank Leon Rose. Huge thanks to Frank for his hard work and ongoing patience, as well as to Terry Moore, Chris Merck, Mimi Flynn, Manny Tsarnas, and Forrest Filler for their ongoing efforts with the software and hardware components.
Please fork the master repos and lend a hand if you identify areas for improvement or wish to create new features. This and the other related Map The Things repos are under active development.
Using RFM95 LoRa Breakout and Feather M0 Bluefruit
RFM95 | Feather |
---|---|
VIN | 3V |
GND | GND |
G0 | A2 |
CS | A5 |
RST | A4 |
SCK | SCK |
MOSI | MOSI |
MISO | MISO |
G2 | 6 |
G1 | 5 |
( You can connect either to a li-poly battery or power via USB cable )
Here is Adafruit's schematic for their Bluefruit module:
In lieu of the above breakout board, you could alternatively use the LoRa Radio Featherwing in conjunction with the Feather M0 Bluefruit. You'll want to solder up the connections like so:
-
Inside the root level directory of your copy of this repo run the following commands:
-
platformio run
(to install libraries and build code) -
platformio upload
(to install code on a device)
- Install Adafruit's Adafruit_BluefruitLE_nRF51 library Arduino library
- Install The Things Network New York's version of the IBM LMIC library
- Install Frank's enhanced Arduino logging library that supports redirection
- Verify and Upload code
- Advertise capabilities via BLE
- Respond to scan from a BLE Center (the MapTheThings-iOS app)
- Serve LoRa configuration, status, and responses as BLE characteristics
- Accept LoRa configuration and transmission commands as BLE characteristic
- Store device EUI and sequence number in NVRAM
Source code for Map The Things is released under the MIT License, which can be found in the LICENSE file.