omaskery / rn2483

Go library for interfacing with RN2483 and RN2903 LoRa modules via their serial interface, particularly LoStik USB devices.

rn2483

Go library for interfacing with RN2483 and RN2903 LoRa modules via their serial interface, particularly LoStik USB devices.

Feature Completeness

• Building blocks for implementing commands:
  • rn2483.(Device).Sendf for sending commands
  • rn2483.(Device).ReadResponse for reading responses
  • rn2483.CheckCommandResponse for validating common command responses
  • rn2483.(Device).ExecuteCommand as a common building block for commands
  • rn2483.(Device).ExecuteCommandChecked and rn2483.(Device).ExecuteCommandCheckedStrict as a common building block for simple commands with easily validated responses
• All sys commands
  • purposely excludes sys eraseFW as it seemed too dangerous to make convenient, easy to implement manually using the building blocks provided above
• mac commands have only been implemented where they facilitate accessing the radio commands:
  • mac pause
• Basic radio commands have been implemented
  • radio tx and radio rx
  • generic radio set <x> <y> and radio get <x> commands
  • radio set pwr
• Simple fake implementation for local development and automated testing

Todo

• Add implementations for more commands

References

• LoStik devices used to test this library
  • LoStik GitHub repo - provides a nice introduction to interacting with RN2483 and RN2903 modules
• RN2483 Command Reference
• RN2903 Command Reference

Alternatives

• https://github.com/sagneessens/RN2483 - a more fully featured library, but is implemented using a global singleton restricting you to one device per application, depends on a specific serial port implementation, and has limited error handling/reporting.