OpenWeave ESP-32 Demo

A simple demo application showing how to build and use OpenWeave on the Espressif ESP32.

OpenWeave is the open source release of Nest's Weave technology, the application layer framework that provides a secure, reliable communications backbone for Nest's products.

---

• Supported Devices
• Building the Demo Application
• Pairing
• Developer Resources

---

Supported Devices

The OpenWeave demo application currently works on two categories of ESP32 devices: the ESP32-DevKitC, and the M5Stack.

ESP32-DevKitC

The ESP32-DevKitC is a small development board containing an ESP-WROOM-32 module plus a power regulator and a Silicon Labs CP2102 USB-to-UART bridge. The board provides a USB connector for power and host connectivity, two buttons (one for reset and a second for general input) and two LEDs (power and general output).

There are a large number of clone boards manufactured by various third-party companies, many of which can be found on Amazon. Of these, the HiLetgo ESP-WROOM-32 ESP-32S development board is one that is known to work and is available for a very reasonable price.

You can find a schematic for the ESP32-DevKitC here.

M5Stack

The M5Stack is a modular IoT development platform consisting of an ESP32-D0WDQ6 module and an integrated ILI9341 TFT LCD screen (320x240 resolution). The M5Stack includes a USB-C interface, an integrated speaker and audio output circuit, a TF-CARD reader, a 150mAh battery, and a set of general purpose buttons. The M5Stack can be extended by adding (stacking) various expansion modules, including modules for GSM, LORA, GPS and a larger battery.

You can find a schematic for the M5Stack core here.

---

Building the Demo Application

• Download and install the Espressif ESP32 IoT Development Framework and the xtensa-esp32-elf toolchain. Instructions can be found on Espressif's Get Started page.

• Checkout version 3.0 of ESP-IDF

    cd <esp-idf-directory>
    git checkout release/v3.0
  

• Clone the demo application repository and fetch the referenced submodules.

    git clone git@github.com:openweave/openweave-esp32-demo.git openweave-esp32-demo
    cd openweave-esp32-demo
    git submodule init
    git submodule update
  

• Within the source directory, create a shell script called setup.sh containing the following lines, substituting the paths to the ESP-IDF directory and the xtensa-esp32 toolchain installed above.

    :
    IDF_PATH=<path-to-esp-idf>
    ESP32_TOOLS_BIN=<path-to-xtensa-esp32-toolchain>/bin
    export PATH=${ESP32_TOOLS_BIN}:${PATH}
    export IDF_PATH
  

• Source the setup.sh script

    source setup.sh
  

• In the root of the source directory, run make menuconfig to configure the following build-time settings for your device:

Config Setting	Value
OpenWeave ESP32 Demo >   Device Type	Select either M5Stack or ESP32-DevKitC, depending on the type of your device.
Component Config >   OpenWeave Device Layer >     Testing Options >       Use Test Device Identity	Choose a unique number between 1 and 255 for your device. This number will become the last byte in the device id for your device - e.g. a value of 15 will result in a device id of 18B430000000000F. To avoid confusion, the number chosen must be unique for all devices on your network, as well as all devices that connect to the same service.

• Run make to build the demo application

    make
  

• Connect your device via USB. Then run the following command to flash the demo application onto the device and then monitor its output. If necessary, replace /dev/ttyUSB0 with the correct USB device name for your system.

  make flash monitor ESPPORT=/dev/ttyUSB0
  

---

Pairing

The device can be paired via either BLE (using Weave-over-BLE) or via the device's WiFi soft-AP.

Upon boot, if the device detects is has not been fully provisioned, it will automatically enable its soft-AP. By default, the SSID for the device's soft-AP is the string NEST-xxxx, where the trailing characters are the last four hex digits of the device's WiFi MAC address. One can inspect device log output to see the device's SSID, which is printed whenever it enables the soft-AP.

When BLE support is enabled (the default), the device will periodically send BLE advertisements that are compatible with the Nest BLE advertising format. By default, the device's BLE device name is Nxxxx, where the trailing characters are the last four hex digits of the device's Weave node id.

The OpenWeave demp app supports all the necessary Weave profiles to enable full device pairing, including Network Provisioning, Fabric Provisioning, Service Provisioning, Device Identity and Device Control.

Pairing Code

By default, the demo application uses the pre-defined pairing code NESTUS. This can be overridden by changing the Component config > OpenWeave Device Layer > Testing Options > Use Test Device Identity config setting.

QR Code

On devices with a screen, pressing the attention button (the right button on the M5Stack) while the device is in an unpaired state will cause it to display its pairing code and corresponding QR code. The pairing screen remains active until a PASE session is established with the device, or the attention button is pressed again.

---

Reset to Defaults

Pressing and holding the attention button for 5 seconds will cause the device to wipe its configuration and reboot. On devices with a screen, a countdown screen is displayed showing the time remaining before the reboot.

---

Developer Resources

Documentation for Expressif's ESP-32 development environment can be found here: ESP-IDF Programming Guide.

Instructions for building and incorporating OpenWeave into a new ESP32 project can be found here: Building OpenWeave for the ESP32.