Skip to content

Latest commit

 

History

History
53 lines (35 loc) · 2.26 KB

readme-modules.md

File metadata and controls

53 lines (35 loc) · 2.26 KB
Raw

Microsoft Azure IoT SDK for Node.js modules-preview branch for Microsoft Edge modules.

This branch of the Azure IoT SDK for Node.js contains code to use the Mqtt protocol to act as a Microsoft Azure IoT Edge module and talk to a Microsoft Azure IoT Edge hub instance.

Important note

This code is not currently published on NPM. In order to use these modules, you need to use the versions in this branch. Instructions for working with this code outside of the NPM repository can be found here

Current functionality.

Recent updates:

  • It is no longer to extract the connection string from an existing module.
  • It is now possible to run and debug your module code inside of a docker container.
  • You no longer need to edit mqtt_base.ts to change the value of reject_unauthorized
  • Module methods are supported

Module inputs

A module can receive inputs by registering for the inputMessage event.

client.on('inputMessage', function(inputName, msg) {
  // inputName is a string that contains the name of the input, and msg is a Message object
});

Module outputs

A module can send a Message to an output by using the sendOutputEvent function

client.sendOutputEvent(outputName, msg);
// outputName is a string that contains the name of the output and msg is a Message object.

Module twin

A module can act as a twin using the existing twin API. The only difference between a device twin and a module twin is the connection string used to connect.

Module methods

A module can also support methods using the existing method API.

Sample Code.

Some sample code can be found in the device/samples directory:

  • simple_sample_module.js has an example of on('inputMessage') and sendOutputEvent functionality.
  • simple_sample_module_twin.js has an example of module twin functionality.
  • simple_sample_module_method.js has an example of module method functionality.