Real world Azure Edge Hub scenario with raspberry pi as leaf node connects to edge transparent gateway.

Step by Step Guidance

To accomplish this tutorial, user your computer or virtual machime or LattePanda(with Widnows Enterprise) as the Azure IoT Edge transparent gateway. Mac OS support is on the way.

Use the Raspberry Pi 3 as leaf node. Prepare a temperature and humidity sensor if possible. Make sure that your gateway and leaf node correctly setup and connect to the same network.

Follow the steps to setup your Raspbeery Pi as leaft node and your Edge Transparent Gateway.


Follow the first two parts in this document to Create an IoT Hub and Register two IoT Edge devices if you don't have any.

Create an edge device for gateway and another edge device for raspberry pi, here I name the gateway panda.

Generate all necessary certificates in gateway following this guidance.

If you has Windows 10 running in your gateway, commands could be summarized as:

git clone 

cd azure-iot-sdk-c\tools\CACertificates

Set-ExecutionPolicy -ExecutionPolicy Unrestricted

. ./ca-certs.ps1 



New-CACertsEdgeDevice myGateway

Go to Azure portal Azure IoT Hub and navigate to Certificates, add a new certificate, providing the root CA file when prompted (RootCA.pem for powershell, ./certs/ in Bash)

For the IoT Edge device, you could create the deployment and setup Edge for it with Azure IoT Edge extension:

Start the IoT Edge runtime (Windows): iotedgectl setup --connection-string {device connection string} --edge-hostname {gateway hostname} --device-ca-cert-file {full path}/certs/myGateway-public.pem --device-ca-chain-cert-file {full path}/certs/myGateway-all.pem --device-ca-private-key-file {full path}/private/myGateway-private.pem --owner-ca-cert-file {full path}/RootCA.pem If you are wokring on Linux gateway, you could find corresponding command in document when you generated the certificates.

Check that you have two docker containers running: edgeAgent, edgeHub.

Raspberry Pi

  • Install Raspbian
  • Optional: If you have the sensor in hand, wire them up following the link above, otherwise we could just simulate the data

Plugin a real screen to you raspberry pi or just ssh it.

Generate .crt from the PEM file you generated when step the gateway. Install it to Raspberry Pi, commands for reference: ``` openssl x509 -in RootCA.pem -inform PEM -out RootCA.crt

sudo cp RootCA.crt /use/local/share/ca-certificates/RootCA.crt

sudo update-ca-certificates ```

Follow the steps to clone the python sample from

Follow the instructions to run to get python sdk to work.

Run the with device connectionstring appended with GatewayHostName, e.g.:

python ";DeviceId=pi;SharedAccessKey=XXXXX;GatewayHostName=<gateway host name>"

You could see Raspberry Pi sending messages to Edge Gateway:

Verify the gateway receives the messages with dockers log –f edgeHub

Verify messages goes to iothub with VSCode extension:


If there is [ERR] Received message does not contain device id kind of error in edgeHub logs, comment those lines in iot-hub-raspberry-pi-kit-python-get-started#set-up-raspberry-pi/ could solve it: