Skip to content

Latest commit

 

History

History
 
 

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

LMIC Documentation

This directory contains documentation on the use and implementation of the LMIC.

Online browsable documentation (including API docs generated by Doxygen) is available at the GitHub Pages site.

User Guides

  • Configuration Reference -- compile-time settings for region, radio, LoRaWAN version, and all LMIC_ENABLE_*/DISABLE_* macros
  • Timing -- protocol timing, clock error compensation, and interrupt handling
  • Class C Guide -- Class C continuous receive mode: compile-time and runtime configuration, API reference, usage examples
  • Hardware Configuration -- wiring, pin mapping, and HalConfiguration_t for non-pre-integrated boards
  • Encoding Utilities -- sflt16, uflt16, sflt12, uflt12 format descriptions and JavaScript decoder functions
  • Adding Regions -- step-by-step guide for adding a new LoRaWAN regional configuration

API Reference

  • LMIC-v5.0.0.pdf -- API documentation (based on original IBM documentation, adapted for this library). Note: update to v6.0.0 is pending.
  • LMIC-v5.0.0-redline.pdf -- changes since last document update, marked up by Litera Workshare Compare.

Radio Driver

  • RadioDriver.md -- radio driver interface specification (os_radio() commands, parameters, and results)

Architecture and Background

  • LMIC-structure-diagram.pdf -- structural diagram of the LMIC (UML-like, created with Cadifra)
  • LMIC-FSM.pdf -- operating logic modeled as a finite state machine. As of version 3.2, this model is idealized; the actual implementation uses event callbacks via os_setCallback()/os_setTimedCallback().
  • LoRaWAN-at-a-glance.pdf -- wall chart summarizing key features of the LoRaWAN 1.0.3 protocol (source: Visio file)

Secure Element

Historical

  • IBM-DISCLAIMER.txt and IBM-release-notes.txt are artifacts of the original IBM distribution, retained for reference.

Meta

Source files are included for documents that have separate sources.

  • The source for the API documentation is a Microsoft Word file.
  • The source for "LoRaWAN at a glance" is a Visio file.
  • The sources for LMIC-FSM and LMIC-structure are Cadifra files.