Library for LoRa communication using MultiTech MDOT.

Dependents:   mDot_test_rx adc_sensor_lora mDotEVBM2X mDot_AT_firmware ... more

libmDot Change Log

Deprecated

This document is deprecated. See Dot library change log for recent release information.

1.0.8-1 Sleep

Changes

  • Improved sleep functionality.
    • Sleep (stop) mode leaves the application in control of the external I/O pins. In order to achieve lowest power draw, it is recommended that those pins be configured at analog inputs with no pull resistors during sleep. If the application needs to maintain a pull up or pull down resistor on any of the external pins, this mode needs to be used. Otherwise deep sleep (standby) is recommended.
    • Deep sleep (standby) power draw was found to be inconsistent. Deep sleep is now consistent at about 40uA. When deep sleep is requested, all I/O pin states are saved before sleep and restored after sleep. The mDot library invokes stop mode on the processor so that some internal pins can be pulled high or low during sleep to achieve minimum power draw. When exiting sleep, the processor is not reset and RAM is maintained.

1.0.8

Changes

  • Preserve Session - allow configuration to preserve session in AUTO_OTA mode over reset/power, save session must be called before power down to save uplink counter
  • Save Session - allow user to save session including uplink counter
  • Restore Session - allow user to restore session including uplink counter
  • Join Delay - allow configuration of join rx window 1 delay
  • Rx Delay - allow configuration of rx window 1 delay
  • App Port - allow configuration of port for application data
  • RTC clock not reset over sleep
  • sleep - two sleep modes available sleep and deepsleep
  • duty-cycle checks time off air instead of toggling channel in channel mask
  • add aggregate duty cycle limiting
  • add Repeat setting to repeat unconfirmed frames (0-15) 0|1 send once
  • expand send error messages to include duty cycle limits met messages
  • Keep RxTimingSetupAns in mac command buffer until downlink is received
  • Choose random datarate upto the configured datarate for join request
  • Implemented AddChannel function
  • Implemented LoRaWAN 1.0 EU868 test-mode
  • Implemented join duty-cycle based on LoRaWAN 1.0.1
    • Join duty-cycle 1% for 1st hour, 0.1% 1-10 hours and 0.01% beyond 10 hours is enforced in US and EU modes
  • Add upto 10 random seconds between join attempts
  • Add UplinkCounter, Rx1Delay, Datarate, TxPower, Repeat, Rx2Frequency, DownlinkCounter, AggregateDutyCycle to session info
  • Add seedRandom function to allow external seeding of RNG, defaults to RSSI reading from radio to generate random seed
  • Removed 1200 option for debug baud rate
  • LoRaWAN 1.0 Certified
  • Add Network join mode 3:PEER_TO_PEER
  • FSK max payload changed to 50
  • Handle packet repeat settings with timeout values and reset rx window flags
  • highBw is deprecated in the send function, setTxDatarate can accept high-speed datarates US(DR4:SF8BW500) and EU(DR6:SF7BW250,DR7:FSK)
  • setTxDatarate accepts values US(0-4,8-13) and EU(0-7) for datarates listed in LoRaWAN

Known Issues

  • Rx1 is using DR0 as the minimum receive datarate. It should be DR8.
    • This is causing DR0 to miss Rx1 when Rx1Offset is 1, 2 or 3
    • This is causing DR1 to miss Rx1 when Rx1Offset is 2 or 3
    • This is causing DR2 to miss Rx1 when Rx1Offset is 3

0.0.9

Changes

  • Features
  • Bugfixes
    • Response for US915 - DR4 fixed
    • check the duty-cycles and enable and expired duty cycles before looking for free channel.
    • [1415] +TXN may return very large number
    • added channels to the session to be restored after sleep in AUTO OTA mode.
    • Start uplink counter at 0
    • Sequence number no longer increases by 2 when acks are off
    • [1417] Duty cycle elapsed time was doubled across sleep

Known Issues


0.0.8

Changes

  • Features
  • Bugfixes
    • Session is reset on power-on/reset
    • Join stats are now counted on successful join
    • US915 - rx1 datarate for high bandwidth channel
    • AUTO OTA link check off by one
    • AUTO OTA link count is saved over sleep
    • AUTO OTA US915 frequency sub-band is saved over sleep

Known Issues

  • Response for US915 - DR4 does not follow Table 22: Data rate mapping in LoRaWAN r1.0

0.0.7

Changes

  • Features
    • Sleep mode
      • added sleep mode
      • added wake mode, interval, delay and timeout settings for sleep mode
    • User file storage, up to 4 user file may be open at a time
      • added save, append, read, move, delete options for files
      • added open, seek, read, write and close options for files
      • added firmware upgrade from user file
  • Bugfixes
    • EU868 duty cycles, check for spurious wake-ups

Known Issues

  • US915 sending using highBW option requires txDatarate to be set to SF_8 to receive response
  • LinkCheckThreshold check is off by one when using ACK's require one extra packet to detect network loss

All wikipages