Dot Library Change Log¶

2.0.16¶

Changes¶

• check PVD before executing filesystem transactions - greatly reduces chance of filesystem corruption on mDots running at voltages < 3.3V

Bug Fixes¶

Known Issues¶

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

2.0.15¶

Changes¶

• Save and restore internal GPIO state around sleep mode to achieve lowest possible power consumption
• add mbed library version to library version
• ADR: check adr request datarate and channel mask independently
• enable test mode TX delay
• ADR: Do not change datarate until ACK_LIMIT + ACK_DELAY + 1 (64 + 32 + 1 = 97)
• update test mode packet timeout to 160

Bug Fixes¶

• Wake up from Sleep mode on either edge instead of only falling edge

Known Issues¶

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

2.0.14¶

Changes¶

• FSK mode fixes for xDot, can send up to 242 bytes

Bug Fixes¶

Known Issues¶

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

2.0.10¶

Changes¶

• Allow dev address 00000000
• Fix P2P power limiting based on configured frequency and regional regulations

Bug Fixes¶

Known Issues¶

2.0.8¶

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)

Bug Fixes¶

Known Issues¶

2.0.1¶

Changes¶

• 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

Bug Fixes¶

Known Issues¶

1.1.0¶

Changes¶

• Function to clear uplink mac command buffer
• Function to retrieve uplink mac command buffer
• Function to cancel rx windows

Bug Fixes¶

• 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¶

1.0.13¶

Changes¶

• 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

Bug Fixes¶

• AT+TXCH output is fixed

Known Issues¶

1.0.12¶

Changes¶

• 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
• Class C support AT+DC=C (use AT+SD or debug log to see packets received from server)
• AT+MAC command to inject mac commands into mac layer (see attached doc for command instructions, debug output will show effect of commands)
• AT+TXCH output has been changed
• AT+CHM - allows changing the channel mask of enabled channels AT+CHM=0,00FF (enable 0-15) AT+CHM=1,FF00 (enable 48-55)
• +PING and +NLC fixed
• Peer to peer much better (aka works)

Bug Fixes¶

Known Issues¶

1.0.9¶

Changes¶

Switched LoRaWAN implementation to MTS-Lora

Bug Fixes¶

Known Issues¶

1.0.8¶

Changes¶

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

Known Issues¶

1.0.6¶

Changes¶

• Handle packet repeat settings with timeout values and reset rx window flags
• Fix SF to DR convert in setTxDatarate function

Bug Fixes¶

• Add configured channels to the session on startup [IN:001786]
• next tx ms now looks only at channels that support current datarate

Known Issues¶

1.0.5¶

Changes¶

• FSK Payload 50 bytes

Bugfixes¶

• Stop RX2 window only if valid packet received
• Apply correct frequency for duty-cycle in peer-to-peer mode [IN:1775]

Known Issues¶

1.0.4¶

Changes¶

• LoRaWAN 1.0 Certified

Bug Fixes¶

• Extract RX Datarate from MAC command correctly

Known Issues¶

1.0.3¶

Changes¶

• ADR functionality complete

Bug Fixes¶

• ADR parameter validation

Known Issues¶

1.0.0-rc2¶

Changes¶

• Reset server ACK requested on txdone

Bugfixes¶

• 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¶

1.0.0¶

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
• 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

Bugfixes¶

• 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¶

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¶

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¶

• 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