Bleeding edge development version of the mDot library for mbed 5. This version of the library is not guaranteed to be stable or well tested and should not be used in production or deployment scenarios.

Dependents:   mDot-IKS01A1 mDot-IKS01A1 mDot-Examples mDot-IKS01A1-Explora ... more

Fork of libmDot-dev-mbed2-deprecated by MultiTech

The Dot library provides a LoRaWan certified stack for LoRa communication using MultiTech mDot and xDot devices. The stack is compatible with mbed 5.

Dot Library Version 3 Updates

Dot Library versions 3.x.x require a channel plan to be injected into the stack. Channel plans are included with the 3.x.x Dot Library releases. The following code snippet demonstrates how to create a channel plan and inject it into the stack.

#include "mDot.h"
#include "channel_plans.h"

int main() {
    ChannelPlan* plan = new lora::ChannelPlan_US915();
    assert(plan);
    mDot* dot = mDot::getInstance(plan);
    assert(dot);

    // ...
}

Dot devices must not be deployed with software using a different channel plan than the Dot's default plan! This functionality is for development and testing only!

Multicast Sessions

Multicast sessions and packet rx events in library. When in Class C mode Multicast downlinks can be received. Recieved packets should be filtered on address, counter value will be maintained in the session or can be set explicitly depending on Application support to share Multicast Address, Keys and Counters.

mDot.h

        /**
         * Add a multicast session address and keys
         * Downlink counter is set to 0
         * Up to 3 MULTICAST_SESSIONS can be set
         */
        int32_t setMulticastSession(uint8_t index, uint32_t addr, const uint8_t* nsk, const uint8_t* dsk);
 
        /**
         * Set a multicast session counter
         * Up to 3 MULTICAST_SESSIONS can be set
         */
        int32_t setMulticastDownlinkCounter(uint8_t index, uint32_t count);

mDotEvent.h

The address field was added to PacketRx event.

        virtual void PacketRx(uint8_t port, uint8_t *payload, uint16_t size, int16_t rssi, int8_t snr, lora::DownlinkControl ctrl, uint8_t slot, uint8_t retries, uint32_t address);

The name of the repository can be used to determine which device the stack was compiled for and if it's a development or production-ready build:

A changelog for the Dot library can be found here.

The Dot library version and the version of mbed-os it was compiled against can both be found in the commit message for that revision of the Dot library. Building your application with the same version of mbed-os as what was used to build the Dot library is highly recommended!

The Dot-Examples repository demonstrates how to use the Dot library in a custom application.

The mDot and xDot platform pages have lots of platform specific information and document potential issues, gotchas, etc, and provide instructions for getting started with development. Please take a look at the platform page before starting development as they should answer many questions you will have.

Revisions of libmDot-ARMCC.ar

Revision Date Message Actions
170:093b1469d58a 2018-08-07 mdot-library revision 3.1.0-rc6-5-g9b4e85e and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
169:83e934fbe81a 2018-08-03 mdot-library revision 3.1.0-rc6-4-g53b5205 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
168:d6956e03850b 2018-07-23 mdot-library revision 3.1.0-rc6-3-g8f7bc37 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
167:09fd17fee0f5 2018-07-20 mdot-library revision 3.1.0-rc6-2-g3cad58a and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
166:869297b078fc 2018-07-17 mdot-library revision 3.1.0-rc6-1-gb726ff6 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
165:c5fd635f9366 2018-06-29 mdot-library revision 3.1.0-rc5-21-gfe609f3 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
164:ffa0f1d5ede9 2018-06-19 mdot-library revision 3.1.0-rc5-17-g6dbbebf and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
163:db3864a732f3 2018-06-19 mdot-library revision 3.1.0-rc5-16-gd057800 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
162:a45f78579e7a 2018-06-19 mdot-library revision 3.1.0-rc5-15-g98db902 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
161:e0f066fecfca 2018-06-18 mdot-library revision 3.1.0-rc5-14-g80e9b22 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
160:cabd3925fe66 2018-06-15 mdot-library revision 3.1.0-rc5-13-g6b383ec and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
159:42322c8949d6 2018-06-11 mdot-library revision 3.1.0-rc5-12-gca17957 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
158:6c54591aecf1 2018-06-06 mdot-library revision 3.1.0-rc5-11-g27d3bfa and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
157:8e9b1e84ffac 2018-06-04 mdot-library revision 3.1.0-rc5-10-g10868b7 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
156:98ca7710192a 2018-06-04 mdot-library revision 3.1.0-rc5-9-gae3ce76 and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
155:ecb07dbd16e3 2018-05-30 mdot-library revision 3.1.0-rc5-8-g6ac9f1c and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
154:0992eaed401c 2018-05-29 mdot-library revision 3.1.0-rc5-7-g751a3fe and mbed-os revision mbed-os-5.7.7 File  Diff  Annotate
146:eb7bca47f6d8 2018-04-06 mdot-library revision 3.1.0-rc3 and mbed-os revision mbed-os-5.7.4 File  Diff  Annotate
145:28d25a44c1e0 2018-04-04 mdot-library revision 3.1.0-rc2-2-ged9817a and mbed-os revision mbed-os-5.7.4 File  Diff  Annotate
144:72731889d6da 2018-03-20 mdot-library revision 3.1.0-rc2-1-g9b74cf2 and mbed-os revision mbed-os-5.7.4 File  Diff  Annotate
143:5f43af30cf22 2018-03-08 mdot-library revision 3.1.0-rc2 and mbed-os revision mbed-os-5.7.5 File  Diff  Annotate
142:8134b50eb439 2018-03-08 mdot-library revision 3.1.0-rc1-4-g4409111 and mbed-os revision mbed-os-5.7.5 File  Diff  Annotate
141:c6247c5469ff 2018-03-06 mdot-library revision 3.1.0-rc1-3-g43dd6d6 and mbed-os revision mbed-os-5.7.5 File  Diff  Annotate
140:652f41d22629 2018-03-06 mdot-library revision 3.1.0-rc1-1-g46e4f33 and mbed-os revision mbed-os-5.7.5 File  Diff  Annotate
139:b2e9d643eef9 2018-02-28 mdot-library revision 3.1.0-rc1 and mbed-os revision mbed-os-5.7.5 File  Diff  Annotate
138:10ab1fc347b3 2018-02-22 mdot-library revision 3.0.2-54-ge5f8ac1 and mbed-os revision mbed-os-5.7.5 File  Diff  Annotate
137:893a90334924 2018-02-22 mdot-library revision 3.0.2-53-g4c557ea and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
136:d7d7093d4754 2018-02-16 mdot-library revision 3.0.2-51-g6ba87fb and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
135:69d2d725ea1e 2018-02-16 mdot-library revision 3.0.2-50-g861f38a and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
134:e5ad4bd55ce5 2018-02-14 mdot-library revision 3.0.2-41-g8e44939 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
133:05a58ba6d281 2018-02-06 mdot-library revision 3.0.2-39-g641818c and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
132:1e538eb986b8 2018-02-02 mdot-library revision 3.0.2-38-g20900c1 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
131:3519affd34ff 2018-01-24 mdot-library revision 3.0.2-37-g56034c6 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
130:fc3c8230eea9 2018-01-24 mdot-library revision 3.0.2-36-g3bae9ec and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
129:3d65480c7adc 2018-01-23 mdot-library revision 3.0.2-35-g4b99fdb and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
128:79ed06543c8e 2018-01-23 mdot-library revision 3.0.2-33-gf3c51e5 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
127:92e7f17b510d 2018-01-11 mdot-library revision 3.0.2-32-gcd1e1de and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
126:8245ecf2d64c 2018-01-10 mdot-library revision 3.0.2-30-g6f7dbc9 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
125:e2a22b15adaa 2018-01-09 mdot-library revision 3.0.2-29-g79a1f3a and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
124:e73c9372626e 2018-01-05 mdot-library revision 3.0.2-28-gca661ca and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
123:fda4713001cf 2018-01-04 mdot-library revision 3.0.2-27-g0d6bf96 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
122:26567b729386 2018-01-04 mdot-library revision 3.0.2-26-g6299b0f and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
121:46761af2bdab 2018-01-02 mdot-library revision 3.0.2-25-gc4a979b and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
120:1fbda752c380 2018-01-02 mdot-library revision 3.0.2-24-gee0f782 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
119:f188af848026 2017-12-29 mdot-library revision 3.0.2-22-g75c6bcb and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
118:64f20bc150dd 2017-12-29 mdot-library revision 3.0.2-21-g4442bfe and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
117:48e0c1761b55 2017-12-29 mdot-library revision 3.0.2-20-g82ebd00 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
116:bf760c5926cb 2017-12-28 mdot-library revision 3.0.2-19-g4ac921c and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
115:bcd44682ac1e 2017-12-28 mdot-library revision 3.0.2-18-gc1ba0dc and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
114:8462870088eb 2017-12-28 mdot-library revision 3.0.2-13-gdaed0e4 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
113:53cb35474afb 2017-12-08 mdot-library revision 3.0.2-2-g27df862 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
112:417b4a3d19b0 2017-12-08 mdot-library revision 3.0.2-2-g27df862 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
111:4bebf247fa58 2017-11-29 mdot-library revision 3.0.1-4-gbca77ab and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
110:78dedfa78471 2017-11-28 mdot-library revision 3.0.1-2-gf5e8667 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
109:41d16d4ab0f0 2017-11-13 mdot-library revision 3.0.1-1-gada985f and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
108:5c06ef91e5b8 2017-09-21 mdot-library revision 3.0.0-19-gb6c0ba2 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
107:054bc6c9f582 2017-09-20 mdot-library revision 3.0.0-18-gadbeda7 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
106:85b1a3946310 2017-09-20 mdot-library revision 3.0.0-18-gadbeda7 and mbed-os revision mbed-os-5.5.7 File  Diff  Annotate
105:f6d92dbced12 2017-09-14 mdot-library revision 3.0.0-18-gadbeda7 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
104:9662b62f1977 2017-09-07 mdot-library revision 3.0.0-17-g1b61e28 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate