mqtt-rpc

0.1.5 • Public • Published

mqtt-rpc Build Status

This module provides an rpc interface for an mqtt connection, in essence this is a request and response strategy which uses an MQTT topic structure as transport.

NPM NPM

Installation

npm install mqtt-rpc

server

Exposes an array of functions which retrieves and returns data.

var mqtt = require('mqtt')
  , mqttrpc = require('mqtt-rpc')
  , debug = require('debug')('remote-time:server');
 
var settings = {
  reconnectPeriod: 5000 // chill on the reconnects
}
 
// client connection
var mqttclient = mqtt.connect('mqtt://localhost', settings);
 
// build a mqtt new RPC server
var server = mqttrpc.server(mqttclient);
 
// optionally configure the codec, which defaults to JSON, also supports msgpack
server.format('json');
 
// provide a new method
server.provide('$RPC/time', 'localtime', function (args, cb) {
  debug('localtime');
  cb(null, new Date());
});

client

Consumes the api exposed by the previous example.

var mqtt = require('mqtt')
  , mqttrpc = require('mqtt-rpc')
  , debug = require('debug')('remote-time:client');
 
var settings = {
  reconnectPeriod: 5000 // chill on the reconnects
}
 
// client connection
var mqttclient = mqtt.connect('mqtt://localhost', settings);
 
// build a new RPC client
var client = mqttrpc.client(mqttclient);
 
// optionally configure the codec, which defaults to JSON, also supports msgpack
client.format('json');
 
// call the remote method
client.callRemote('$RPC/time', 'localtime', {}, function(err, data){
  debug('callRemote', err, data);
});

License

Copyright (c) 2013 Mark Wolfe Licensed under the MIT license.

Readme

Keywords

Package Sidebar

Install

npm i mqtt-rpc

Weekly Downloads

1

Version

0.1.5

License

MIT

Last publish

Collaborators

  • wolfeidau