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
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
103:06bafd42c324 2017-09-07 mdot-library revision 3.0.0-16-gfc4d5d4 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
102:8427de706d2b 2017-09-07 mdot-library revision 3.0.0-15-gbfe3ee6 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
101:5b51aa3dd28f 2017-09-05 mdot-library revision 3.0.0-11-gd5ea94c and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
99:691eef63ddc5 2017-08-23 mdot-library revision 3.0.0-11-gd5ea94c and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
98:7995eb81d97d 2017-08-14 mdot-library revision 3.0.0-10-gda2c532 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
97:5bcb4e213465 2017-08-08 mdot-library revision 3.0.0-10-gda2c532 and mbed-os revision mbed-os-5.5.3 File  Diff  Annotate
96:0bef7d71c209 2017-08-08 mdot-library revision 3.0.0-10-gda2c532 and mbed-os revision mbed-os-5.5.3 File  Diff  Annotate
95:05d49e2407e1 2017-08-08 mdot-library revision 3.0.0-9-gb9fedc4 and mbed-os revision mbed-os-5.5.3 File  Diff  Annotate
94:ba0cdc67db27 2017-08-08 mdot-library revision 3.0.0-9-gb9fedc4 and mbed-os revision mbed-os-5.5.3 File  Diff  Annotate
93:7bbabaabbaef 2017-08-08 mdot-library revision 3.0.0-9-gb9fedc4 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
92:7caf5cf8411f 2017-08-08 mdot-library revision 3.0.0-9-gb9fedc4 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
91:168032cfce70 2017-08-08 mdot-library revision 3.0.0-9-gb9fedc4 and mbed-os revision mbed-os-5.5.4 File  Diff  Annotate
90:79a8c8660a4e 2017-08-08 mdot-library revision 3.0.0-9-gb9fedc4 and mbed-os revision mbed-os-5.5.3 File  Diff  Annotate
89:8c49632473a5 2017-08-02 mdot-library revision 3.0.0-2-g7121642 and mbed-os revision mbed-os-5.5.3 File  Diff  Annotate
88:fae4a1751674 2017-07-28 mdot-library revision 3.0.0-1-g649b0a0 and mbed-os revision mbed-os-5.5.3 File  Diff  Annotate
87:4c32e4842896 2017-07-28 mdot-library revision 3.0.0-1-g649b0a0 and mbed-os revision mbed-os-5.5.0 File  Diff  Annotate
86:2fb7ed4aba0d 2017-07-10 mdot-library revision 3.0.0-1-g649b0a0 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
85:bc78dc03e3b5 2017-07-10 mdot-library revision 3.0.0 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
84:29648b580369 2017-06-29 mdot-library revision 3.0.0-rc7-3-g6ebbd7d and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
83:bd88089c1054 2017-06-29 mdot-library revision 3.0.0-rc7-2-gc873aa4 and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
82:0f5a742a08cd 2017-06-19 mdot-library revision 3.0.0-rc7-1-ga5165ae and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
81:d8f2c4e664f5 2017-06-19 mdot-library revision 3.0.0-rc7-1-ga5165ae and mbed-os revision mbed-os-5.4.7 File  Diff  Annotate
80:e85c370dd05d 2017-02-10 mdot-library revision 2.0.16-7-ga61aab1 and mbed-os revision mbed-os-5.3.4 File  Diff  Annotate
79:ae8514a3d49c 2017-01-06 mdot-library revision 2.0.16-7-ga61aab1 and mbed-os revision mbed-os-5.3.2 File  Diff  Annotate
78:a36c6d802ac9 2017-01-04 mdot-library revision 2.0.16-7-ga61aab1 and mbed-os revision mbed-os-5.3.1 File  Diff  Annotate
77:d1f1cb119436 2016-12-30 mdot-library revision 2.0.16-6-g8ae444b and mbed-os revision mbed-os-5.3.1 File  Diff  Annotate
76:6d61ba2bcfc1 2016-12-30 mdot-library revision 2.0.16-6-g8ae444b and mbed-os revision mbed-os-5.3.1 File  Diff  Annotate
75:60e21ba8350a 2016-11-08 mdot-library revision 2.0.16-4-g5c56af8 and mbed-os revision mbed-os-5.2.2 File  Diff  Annotate
74:5305a3b96ef9 2016-11-04 mdot-library revision 2.0.16-4-g5c56af8 and mbed-os revision mbed-os-5.2.1 File  Diff  Annotate
73:dfdcd99b1f0a 2016-11-04 mdot-library revision 2.0.16-3-g49b2451 and mbed-os revision mbed-os-5.2.1 File  Diff  Annotate
72:4d17cff35bcc 2016-11-04 mdot-library revision 2.0.16-2-g3cb21b3 and mbed-os revision mbed-os-5.2.1 File  Diff  Annotate
71:b5abd88b48fa 2016-11-04 mdot-library revision 2.0.16-1-gde96bf6 and mbed-os revision mbed-os-5.2.1 File  Diff  Annotate