This tutorial shows you how to use Azure IoT Edge to send temperature and humidity data from SensorTag device to the remote monitoring preconfigured solution. The SensorTag connects to the Intel NUC gateway using Bluetooth. The tutorial uses:

• Azure IoT Edge to implement a sample gateway.
• The IoT Suite remote monitoring preconfigured solution as the cloud-based back end.

In this tutorial, you complete the following steps:

• Deploy an instance of the remote monitoring preconfigured solution to your Azure subscription. This step automatically deploys and configures multiple Azure services.
• Set up your Intel NUC gateway device to communicate with your computer and the remote monitoring solution.
• Set up your Intel NUC gateway to receive telemetry from a SensorTag device and send it to the remote monitoring dashboard.

To complete this tutorial, you need an active Azure subscription.

You need SSH client on your desktop machine to enable you to remotely access the command line on the Intel NUC.

• Windows does not include an SSH client. We recommend using PuTTY.
• Most Linux distributions and Mac OS include the command-line SSH utility.

A desktop computer to enable you to connect remotely to the command line on the Intel NUC.

IoT Commercial Gateway Kit. This tutorial uses the following items from the kit:

• Intel® NUC Kit DE3815TYKE with 4G Memory and Bluetooth expansion card
• Power adaptor

Texas Instruments BLE SensorTag. This tutorial retrieves telemetry data over Bluetooth from the SensorTag device.

If you haven't already provisioned the remote monitoring preconfigured solution in your account:

1. Log on to azureiotsuite.com using your Azure account credentials, and click + to create a solution.
2. Click Select on the Remote monitoring tile.
3. Enter a Solution name for your remote monitoring preconfigured solution.
4. Select the Region and Subscription you want to use to provision the solution.
5. Click Create Solution to begin the provisioning process. This process typically takes several minutes to run.

1. Click the tile for your solution with Provisioning status.
2. Notice the Provisioning states as Azure services are deployed in your Azure subscription.
3. Once provisioning completes, the status changes to Ready.
4. Click the tile to see the details of your solution in the right-hand pane.

Are there details you'd expect to see that aren't listed for your solution? Give us feature suggestions on User Voice.

The solution dashboard enables you to manage the deployed solution. For example, you can view telemetry, add devices, and invoke methods.

1. When the provisioning is complete and the tile for your preconfigured solution indicates Ready, choose Launch to open your remote monitoring solution portal in a new tab.

   

2. By default, the solution portal shows the dashboard. Navigate to other areas of the solution portal using the menu on the left-hand side of the page.

   

For a device to connect to the preconfigured solution, it must identify itself to IoT Hub using valid credentials. You can retrieve the device credentials from the solution dashboard. You include the device credentials in your client application later in this tutorial.

To add a device to your remote monitoring solution, complete the following steps in the solution dashboard:

1. In the lower left-hand corner of the dashboard, click Add a device.

   

2. In the Custom Device panel, click Add new.

   

3. Choose Let me define my own Device ID. Enter a Device ID such as device01, click Check ID to verify you haven't already used the name in your solution, and then click Create to provision the device.

   

4. Make a note the device credentials (Device ID, IoT Hub Hostname, and Device Key). Your client application on the Intel NUC needs these values to connect to the remote monitoring solution. Then click Done.

   

5. Select your device in the device list in the solution dashboard. Then, in the Device Details panel, click Enable Device. The status of your device is now Running. The remote monitoring solution can now receive telemetry from your device and invoke methods on the device.

To complete the hardware setup, you need to:

• Connect your Intel NUC to the power supply included in the kit.
• Connect your Intel NUC to your network using an Ethernet cable.

You have now completed the hardware setup of your Intel NUC gateway device.

You have two options to access a terminal environment on your Intel NUC:

• If you have a keyboard and monitor connected to your Intel NUC, you can access the shell directly. The default credentials are username root and password root.

• Access the shell on your Intel NUC using SSH from your desktop machine.

To sign in with SSH, you need the IP address of your Intel NUC. If you have a keyboard and monitor connected to your Intel NUC, use the ifconfig command to find the IP address. Alternatively, connect to your router to list the addresses of devices on your network.

Sign in with username root and password root.

Optionally, you may want to share a folder on your Intel NUC with your desktop environment. Sharing a folder enables you to use your preferred desktop text editor (such as Visual Studio Code or Sublime Text) to edit files on your Intel NUC instead of using nano or vi.

To share a folder with Windows, configure a Samba server on the Intel NUC. Alternatively, use the SFTP server on the Intel NUC with an SFTP client on your desktop machine.

Configure Bluetooth on the Intel NUC to enable the SensorTag device to connect and send telemetry.

1. In the shell on the Intel NUC, run the following command to unblock the Bluetooth service:

   sudo rfkill unblock bluetooth

2. Run the following commands to start the Bluetooth service on the Intel NUC and enter the Bluetooth shell:

   sudo systemctl start bluetooth
   bluetoothctl

3. Run the following command to power on the Bluetooth controller:

   power on

   When the controller is on, you see a message Changing power on succeeded.

4. Run the following command to scan for nearby Bluetooth devices:

   scan on

5. Press the power button on the SensorTag to make it discoverable. The green LED flashes.

6. When you see a message in the shell that the controller has discovered the SensorTag, make a note of the MAC address of the device. The MAC address looks like A0:E6:F8:B5:F6:00. You need the MAC address later in the tutorial when you configure the gateway.

7. Run the following command to turn off Bluetooth scanning:

   scan off

8. Run the following command to verify that you can connect to the SensorTag device:

   connect <SensorTag MAC address>

   If you connect successfully, the shell shows the message Connection successful and prints information about the SensorTag device. If you cannot connect, check the SensorTag is still powered on.

9. You can now disconnect from the SensorTag and exit the Bluetooth shell by running the following commands:

   disconnect
   exit

This tutorial uses custom IoT Edge modules to communicate with the remote monitoring preconfigured solution. Therefore, you need to build the IoT Edge modules from custom source code. The following sections describe how to install IoT Edge and build the custom IoT Edge module.

The following steps describe how to install the pre-compiled IoT Edge software on the Intel NUC:

1. Configure the required smart package repositories by running the following commands on the Intel NUC:

   smart channel --add IoT_Cloud type=rpm-md name="IoT_Cloud" baseurl=http://iotdk.intel.com/repos/iot-cloud/wrlinux7/rcpl13/ -y
   smart channel --add WR_Repo type=rpm-md baseurl=https://distro.windriver.com/release/idp-3-xt/public_feeds/WR-IDP-3-XT-Intel-Baytrail-public-repo/RCPL13/corei7_64/

   Enter y when the command prompts you to Include this channel?.

2. Update the smart package manager by running the following command:

   smart update

3. Install the Azure IoT Edge package by running the following command:

   smart config --set rpm-check-signatures=false
   smart install packagegroup-cloud-azure -y

4. Verify the installation by running the "Hello world" sample. This sample writes a hello world message to the log.txT file every five seconds. The following commands run the "Hello world" sample:

   cd /usr/share/azureiotgatewaysdk/samples/hello_world/
   ./hello_world hello_world.json

   Ignore any invalid argument messages when you stop the sample.

   Use the following command to view the contents of the log file:

   cat log.txt | more

If you receive the error "No package provides util-linux-dev", try rebooting the Intel NUC.

You can now build the custom IoT Edge module that enables the gateway to send messages to the remote monitoring solution. For more information about configuring a gateway and IoT Edge modules, see Azure IoT Edge concepts.

Download the source code for the custom IoT Edge modules from GitHub using the following commands:

cd ~
git clone https://github.com/Azure-Samples/iot-remote-monitoring-c-intel-nuc-gateway-getting-started.git

Build the custom IoT Edge module using the following commands:

cd ~/iot-remote-monitoring-c-intel-nuc-gateway-getting-started/basic
chmod u+x build.sh
sed -i -e 's/\r$//' build.sh
./build.sh

The build script places the libsensor2remotemonitoring.so custom IoT Edge module in the build folder.

You can now configure the IoT Edge gateway to send telemetry from your SensorTag device to your remote monitoring dashboard. For more information about configuring a gateway and IoT Edge modules, see Azure IoT Edge concepts.

Open the sample configuration file in the vi editor using the following command:

vi ~/iot-remote-monitoring-c-intel-nuc-gateway-getting-started/basic/remote_monitoring.json

Locate the following lines in the configuration for the IoTHub module:

"args": {
  "IoTHubName": "<<Azure IoT Hub Name>>",
  "IoTHubSuffix": "<<Azure IoT Hub Suffix>>",
  "Transport": "http"
}

Replace the placeholder values with the IoT Hub information you created and saved at the start of this tutorial. The value for IoTHubName looks like yourrmsolution37e08, and the value for IoTSuffix is typically azure-devices.net.

Locate the following lines in the configuration for the mapping module:

args": [
  {
    "macAddress": "<<AA:BB:CC:DD:EE:FF>>",
    "deviceId": "<<Azure IoT Hub Device ID>>",
    "deviceKey": "<<Azure IoT Hub Device Key>>"
  }
]

Replace the macAddress placeholder with the MAC address of your SensorTag you noted previously. Replace the deviceID and deviceKey placeholders with the IDs and keys for the two devices you created in the remote monitoring solution previously.

Locate the following lines in the configuration for the SensorTag module:

"args": {
  "controller_index": 0,
  "device_mac_address": "<<AA:BB:CC:DD:EE:FF>>",
  ...
}

Replace the device_mac_address placeholder with the MAC address of your SensorTag you noted previously.

Save your changes.

You can now run the gateway using the following commands:

cd ~/iot-remote-monitoring-c-intel-nuc-gateway-getting-started/basic
/usr/share/azureiotgatewaysdk/samples/ble_gateway/ble_gateway remote_monitoring.json

The IoT Edge gateway starts on the Intel NUC and sends telemetry from the SensorTag to the remote monitoring solution:

Press Ctrl-C to exit the program at any time.

The gateway is now sending telemetry from the SensorTag device to the remote monitoring solution. You can view the telemetry on the solution dashboard. You can also send commands to your SensorTag device through the gateway from the solution dashboard.

• Navigate to the solution dashboard.
• Select the device you configured in the gateway that represents the SensorTag in the Device to View dropdown.
• The telemetry from the SensorTag device displays on the dashboard.

Visit the Azure IoT Dev Center for more samples and documentation on Azure IoT.