Stable version of the mDot library for mbed 5. This version of the library is suitable for deployment scenarios. See lastest commit message for version of mbed-os library that has been tested against.

Dependents:   mdot_two_way unh-hackathon-example unh-hackathon-example-raw TelitSensorToCloud ... more

Fork of libmDot-dev-mbed5-deprecated by MultiTech

libmDot mbed5 changelog

Deprecated

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

libmDot Release Log

2.0.14

Changes

  • Better stop mode current 55 uA
  • Calibrate tx power based on measure power at each setting
  • ADR reduce datarate after each ADR_ACK_DELAY (32)
  • Alternate between 125 and 500 kHz channels on join for US915/AU915
  • Calculate join backoff as random value between 0 and max duty-cycle for current backoff period.
  • Join backoff keep track of time-on-air for current period
  • Cycle through datarates on join attempts
  • Class C handle rx timeouts for missed ACK and missed join, skip rx2 window event as rx2 is opened on timeout of rx1
  • Add support for generating CW of cert testing
  • ADR check if datarate was lowered below current payload size and increment as necessary
  • Do not allow mac commands in payload and options bytes. Bad check caused link check failure. [IN:1928]
  • P2P will use TX frequency setting in EU868 and respect duty cycle according to set power level (Must set to 869.85 MHz and Power + Ant < 7 dBm for 100% duty-cycle)
  • Antenna gain param change will take effect immediately
  • Public/Private mode will take effect immediately
  • Function to clear uplink mac command buffer
  • Function to retrieve uplink mac command buffer
  • Function to cancel rx windows
  • Join Duty cycle limitation 1% first hour, 0.1% next ten hours, 0.01% there after
  • Random Join Datarate
  • Aggregate Duty Cycle limitation configurable by MAC command
  • AU915 Support according to LoRaWAN 1.0.1
  • ACK and REP settings take effect without save/restart
  • Peer to peer rx window open at start
  • Duty cycle will run for all datarates
  • Added check for max payload

Bug Fixes

  • FSK mode fixes for xDot, can send up to 242 bytes
  • Allow dev address 00000000
  • Fix P2P power limiting based on configured frequency and regional regulations
  • US915 Rx1 with datarate offset for TxDR 0,1,2 and Offset 1,2,3 fixed
  • Convert input of SF_12 or SF_11 to DR0 in US915
  • US915 64 channel mode skipped channel 16

Known Issues

  • TX DataRate will be reset to DR0 during OTA join process - workaround is to set TX DataRate after joining the network

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

Bug Fixes

  • US ADR fixed for 64 channels
  • EU ADR commands accept only ctrl mask of 0 or 6
  • Add configured channels only in EU868 mode
  • Peer-to-peer mode correctly ignores duty-cycle because of low-power setting at VARIABLE duty band frequency
  • next tx ms now looks only at channels that support current datarate
  • add configured channels to session on startup in EU868
  • SNR - reports correct value in cB
  • NewChannelReq - disable channel when freq = 0
  • Reset server ACK requested on txdone
  • SxRadio - increase FSK rx timeout
  • Use radio random to seed psuedo rand function in LoRaMac
  • 868 optional channels in join accept message received as LSB
  • Update downlink counter only if mic passes
  • Save timer value to temp variable, addresses race condition that led to MAX_INT wait times [IN:001725]
  • Power adjustments of txPower as radio output and antenna gain accounted for
  • Removed redundant max payload size check at 242
  • Mac timers start on Wakeup [IN:001719]

Known Issues

0.0.9

Changes

  • 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

Bug Fixes

  • 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
  • EU868 duty cycles, check for spurious wake-ups
  • 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


All wikipages