A gateway to Azure IoT Hub that can represent multiple devices over a single connection.

To see an implementation of the same pattern in .NET Core, please see this project.

Basic functionality

var gateway = new Gateway();

// The connection string must include a shared access key with the `device connect` permission.
// The value can be copied, for example, from the Azure Portal.
await gateway.open(process.env.IOTHUB_CONNECTION_STRING);

// Setup the message handler.
gateway.on('message', (message) => {
  // Do something when C2D messages arrive.
  // This handler is called to messages targeting any device and includes the target device id.
});

// Add the devices you want to handle with this gateway.
// Note that only device id is enough and there is no need for device-specific keys.
await gateway.addDevice('<some-device-id>');

// Send D2C messages on behalf of any device id.
await gateway.sendMessage('<some-device-id>', <message>);

See the sample server.ts for more details about the usage.

Running sample locally

export IOTHUB_CONNECTION_STRING="HostName=..."
npm install
npm start

Running tests locally

npm install
npm test