reTerminal is powered by a Raspberry Pi Compute Module 4 (CM4) which is a Quad-Core Cortex-A72 CPU running at 1.5GHz and a 5-inch IPS capacitive multi-touch screen with a resolution of 720 x 1280. It has sufficient amount of RAM (4GB) to perform multitasking and also has sufficient amount of eMMC storage (32GB) to install an operating system, enabling fast boot up times and smooth overall experience. It has wireless connectivity with dual-band 2.4GHz/5GHz Wi-Fi and Bluetooth 5.0 BLE.

reterminal-aziot-example is an IoT Plug and Play compatible program that allows reTerminal to communicate with Azure IoT.

It has the following features:

• Telemetry
  • Periodically measure the acceleration of the reTerminal and send it to Azure IoT.
  • Notify Azure IoT of button clicks on the front of the reTerminal.
• Property
  • Instructions from Azure IoT will turn on the LED on the front of the reTerminal.
• Command
  • The reTerminal buzzes with instructions from Azure IoT.

The following table summarizes supported device attestation/authentication methods :

You should have the following items ready before beginning the process:

For Azure IoT Central

• Azure IoT Central application

For Azure IoT Hub

• Azure IoT Hub instance

1. Download the program

   Clone or download ZIP from the GitHub repository reterminal-aziot-example.

   git clone https://github.com/SeeedJP/reterminal-aziot-example
   cd reterminal-aziot-example

2. Install the required Python package

   Install the Python packages listed in the requirements.txt.

   sudo pip3 install -r requirements.txt

1. Set environment variables

   Set the Azure IoT information to environment variables.

   For Azure IoT Central

   New the device, and then set the device connection information to environment variables.

   export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
   export IOTHUB_DEVICE_DPS_ID_SCOPE="<ID scope of device connection>"
   export IOTHUB_DEVICE_DPS_DEVICE_ID="<Device ID (as you wish)>"
   export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Primary key of SAS-IoT-Devices>"
   export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"

   For Azure IoT Hub

   New the device, and then set the primary connection string to an environment variable.

   export IOTHUB_DEVICE_SECURITY_TYPE="connectionString"
   export IOTHUB_DEVICE_CONNECTION_STRING="<Primary Connection String>"

2. Run the program

   Run reterminal_aziot_example.py.

   sudo -E python3 src/reterminal_aziot_example.py

Configuring the samples

launch.json:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "sudo": true,
            "env":{
                "IOTHUB_DEVICE_SECURITY_TYPE": "DPS",
                "IOTHUB_DEVICE_DPS_ID_SCOPE": "x",
                "IOTHUB_DEVICE_DPS_DEVICE_ID": "x",
                "IOTHUB_DEVICE_DPS_DEVICE_KEY": "x",
                "IOTHUB_DEVICE_DPS_ENDPOINT": "global.azure-devices-provisioning.net"
            }
        }
    ]
}

MIT License