longfi-arduino/RAKWireless-WisBlock/longfi-us915
Leroy Levin 03988de42b
Update README.md
fix minor typ0
2021-05-23 11:52:31 -05:00
..
console-decoders rename ttgo-tb.. to TTGO-TB, add decoder to RAK WisBlock sample, update READMEs to make note of decoders 2021-04-22 11:41:03 -05:00
README.md Update README.md 2021-05-23 11:52:31 -05:00
longfi-us915.ino updates for SX126x-Arduino version 2 compatibility 2021-05-23 11:38:14 -05:00

README.md

Helium Basic Example

Here you will find a very basic example of a WisBlock/Helium embedded project that uses the Arduino IDE. This version will join the Helium network and periodically send a "Hello" to the Helium network.

Support Library Version Incompatibility

Recent API changes to the runtime support library, SX126x-Arduino, have resulted in library version incompatibility between version 1.3x and version 2.x.

⚠️ WARNING: This will require changes to the Arduino IDE installation, in particular the installed board support package files. The complete details of the changes required can be found here.

In addition to the IDE support file changes there are two major changes at the device application level if you are moving from version 1 to version 2 of the support library:

  • The lmh_init() API requires 2 more parameters
  • the device application is no longer required to call Radio.IrqProcess() within it's main processing loop. The processing will now be handled by the runtime layer.

The sample .ino file has been updated to be compatible with version 2 of the support library.

Hardware

The only hardware required is:

  • the WisBlock Starter Kit containing the base board with the core module installed.
  • one USB 2.0 A-Male to Micro B interface cable.

Antenna Type/location

The WisBlock starter kit comes with two antenna types,

  • the one that resembles an "I" is the LoRa antenna, this one connects to the connector on the core module marked LoRa, which is below the large K in the RAK logo.
  • the one that resembles a "T" is the BLE antenna, this one connects to the connector on the core module marked BLE

Sample Decoder

  • In the console-decoders directory you will find a simple sample decoder that goes along with this sample code. It is intended to be used as a Helium Console "Function". This will allow one to view the decoded payload within the Helium Console device debug view.