azure-iot-device

)#azure-iot-device The core components of the Azure IoT device SDK.

Features

Use the Azure IoT device SDK to:

• Send event data to Azure IoT Hub.
• Receive messages from IoT Hub.
• Communicate with the service via MQTT (optionally over WebSockets, AMQP (optionally over WebSockets), or HTTP.
• Synchronize an Azure IoT Hub device Twin with Azure IoT Hub from a device
• Implement Azure IoT Hub Direct Device Methods on devices
• Implement Azure IoT Device Mangement features on devices

Prerequisites

You need to install Node.js JavaScript runtime environment for Azure IoT JavaScript client SDK to run on your platform. For downloading Node.js refer to Node.js. To check if your platform (OS) is supported check if install package is available at Node.js. npm is a package manager command line tool that will be included when Node.js is installed. This is the tool that you will use to install Azure IoT node.js client side SDK.

Install

npm install -g azure-iot-device to get the latest version.

Getting Started

This package contains the core components of the Azure IoT device SDK, but doesn't include a transport over which to communicate with Azure IoT Hub. Your application must require a transport package in addition to the core package to do something useful.

For example, if you want to send an event from your device to an IoT Hub using the AMQP protocol you must first install the azure-iot-device-amqp package:

npm install -g azure-iot-device-amqp

Then you can use the code below to send a message to IoT Hub.

Note that for this sample to work, you will need to setup your IoT hub and provision your device and get its credentials. In the code, replace '[IoT Hub device connection string]' with the device credentials created in the IoT Hub.

var connectionString = '[IoT Hub device connection string]';

// use factory function from AMQP-specific package
var clientFromConnectionString = require('azure-iot-device-amqp').clientFromConnectionString;

// AMQP-specific factory function returns Client object from core package
var client = clientFromConnectionString(connectionString);

// use Message object from core package
var Message = require('azure-iot-device').Message;

var connectCallback = function (err) {
  if (err) {
    console.error('Could not connect: ' + err);
  } else {
    console.log('Client connected');
    var msg = new Message('some data from my device');
    client.sendEvent(msg, function (err) {
      if (err) {
        console.log(err.toString());
      } else {
        console.log('Message sent');
      };
    });
  };
};


client.open(connectCallback);

See the azure-iot-device-* transport-specific packages for more information.

More samples

You will find more samples showing how to use the Azure IoT device SDK for node here.

Work with the code of the module

If you want to modify the module's code and/or contribute changes, you will need to setup your development environement following these instructions.

Read More

• Azure IoT Hub dev center
• Azure IoT Hub documentation
• API reference