Skip to content
This repository has been archived by the owner on Jul 19, 2024. It is now read-only.

Latest commit

 

History

History
80 lines (60 loc) · 4.69 KB

README.md

File metadata and controls

80 lines (60 loc) · 4.69 KB
Raw

IoTHub Extension

Fully featured IoT Hub input and output bindings to Azure IoT Hub, allowing common interactions between cloud and devices to be done from Azure Functions. Common scenarios currently supported are:

  • Cloud to Device: output binding that sends messages from Azure Functions to IoTHub, which then transfer the messages to specified device id in the message structure
  • Direct Method: output binding that invokes methods in the device from Azure Functions
  • Set Device Twin: output binding that updates desired properties of specified device from Azure Functions
  • Get Device Twin: input binding that gets device twin of the specified device once the Function's trigger is fired

Current Status

This extension is still in the prototype phase and has not been published to NuGet. If you need to process IOT Hub messages with Azure Functions, the currently supported method is documented here.

Example

Cloud to Device
function.json
{
  "bindings": [
    {
      "type": "eventHubTrigger",
      "name": "myEventHubMessage",
      "direction": "in",
      "path": "messages/events",
      "connection": "IoTConnectionString",
      "consumerGroup": "secondconsumergroup"
    },
    {
      "name": "cloudToDevice",
      "type": "ioTCloudToDevice",
      "direction": "out",
      "connection": "IoTConnectionString" // connection string can differ from the trigger's
    }
  ],
  "disabled": false
}
run.csx
using System;

public static void Run(string myEventHubMessage, ICollector<string> cloudToDevice, ICollector<string> setDeviceTwin, TraceWriter log)
{
    cloudToDevice.Add("{\"DeviceId\":\"myFirstDevice\",\"MessageId\":1,\"Message\":\"C2D message\"}");
}

See more sample code for each scenario

Sample Code

functions folders contains functions to use in Azure Functions portal. To run, do the following:

  1. Zip extension .dll files and put them in Function's library via Advanced tools (Kudu)
  2. Add the path where the extension lives to appsetting using AzureWebJobs_ExtensionsPath as key
  3. Create a new function in portal and copy codes from selected scenario in the sample folder
  4. Change the appsetting key for connection string in function.json to IoTConnectionString or change the key for connection string (and/or consumerGroup for EventHubTrigger) in function.json according to your custom app setting.
  5. Run your device code or sender.js Your function should receive messages from sender.js
  6. Run your device receiver code or select ones in simulatedDevices folder according to your scenario.

Direct Method assumes that the device has a method matched with the specified method's name given in the argument. Otherwise, Function throws an exception.

Executing direct method that takes longer than the lifetime of a Function (5 minutes by default and can be set up to 10 minutes) can never be completed.

License

This project is under the benevolent umbrella of the .NET Foundation and is licensed under the MIT License

Contributing

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.