mqtt-shepherd

Server & manager for the LwM2M-like Lightweight Message Queuing Network (LwMQN)

Showing:

Popularity

Downloads/wk

2

GitHub Stars

38

Maintenance

Last Commit

2yrs ago

Contributors

5

Package

Dependencies

10

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Deprecated!
RENAMED: please use @lwmqn/shepherd

Readme

LWMQN Network

@lwmqn/shepherd is a network server and manager for the Lightweight Message Queuing Network (LwMQN)

NPM version NPM downloads Travis branch Gitter js-standard-style pr-welcoming-image


What is LwMQN

Lightweight Message Queuing Network (LwMQN) is an open source project that follows part of OMA LwM2M v1.0 specification to meet the minimum requirements of machine network management.

Server-side and Client-side Libraries:

  • LwMQN project provides you with this machine-side @lwmqn/qnode library and a server-side @lwmqn/shepherd library to build your machine network with JavaScript and Node.js easily.

Features

  • Communication based on MQTT protocol and Mosca broker.
  • Embedded persistence (NeDB) and auto-reloads Client Devices at boot-up.
  • Build your IoT network with or without cloud services.
  • LwM2M-like interfaces for Client/Server interaction.
  • Hierarchical Smart Object data model (IPSO), which leads to a comprehensive and consistent way in describing real-world gadgets.
  • Easy to query resources on a Client Device with the URI-style path, and everything has been well-organized to ease the pain for you to create RPC interfaces for your webapps, such as RESTful and websocket-based APIs.
  • LwMQN Server is your local machine gateway and application runner. But if you like to let your machines go up cloud, why not? It's Node.js!

Understanding Smart Objects and the IPSO Model

IPSO Model

Acronyms and Abbreviations

  • Server: LwMQN server
  • Client or Client Device: LwMQN client (machine)
  • Shepherd: Class exposed by require('@lwmqn/shepherd')
  • Qnode: Class to create a software endpoint(proxy) of a remote Client Device on the server
  • qserver: Instance of Shepherd Class
  • qnode: Instance of Qnode Class

Installation

Currently Node.js 8.x LTS or higher is required.

$ npm install @lwmqn/shepherd

Compabitility table

Shepherd versions /
Node.js versions
8.x
LTS
10.x
LTS
11.x12.x
LTS
13.x
v0.8.0

Basic Usage

const Shepherd = require('@lwmqn/shepherd')
const qserver = new Shepherd() // create a LWMQN server

qserver.on('ready', function () {
  console.log('Server is ready.')
  // when server is ready, allow devices to join the network within 180 secs
  qserver.permitJoin(180)
})

qserver.start(function (err) { // start the sever
  if (err) console.log(err)
})

// That's all to start a LwMQN server.
// Now qserver is going to automatically tackle most of the network managing things.

Documentation


License

Licensed under MIT.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial