Overview
Things
Story

Setup Your Environment
Selecting the board and port
Linux and Mac OS X
Windows
Create the Sketch
Viewing you output

Published April 26, 2018 © MIT

Publish Any Event to Wia Using Your SparkFun ESP32 Thing

Learn how to set up your SparkFun ESP32 thing and post an event to Wia in a few easy steps.

BeginnerFull instructions provided1 hour604

Publish Any Event to Wia Using Your SparkFun ESP32 Thing

Things used in this project

Hardware components

SparkFun Electronics SparkFun ESP32 Thing

Micro-USB to USB Cable (Generic)

Software apps and online services

Wia

Story

Setup Your Environment

Install the Arduino IDE. You can download it for Mac OS X, Windows and Linux here.

To use the board, you must manually install ESP32 board definitions on your Arduino Ide, you can find the official tutorial for the different operating systems here

If installed, go to here in the tutorial. Otherwise, continue on

Go to your Arduino IDE's installed directory

For Windows, it may be C:/Program Files (x86)/Arduino/hardware

For Mac, it may be /Applications/Arduino.app/Contents/Java/hardware

For Linux it may be ~/Arduino/hardware

Make an espressif directory and clone the arduino-esp32 git repository

esp32

git clone https://github.com/espressif/arduino-esp32.git esp32

If you don't have git, you can download the zip file from here, make an esp32 directory in the espressif directory e.g. espressif/esp32 then unzip the file.

Install the code for the ESP32 by:

For Windows, run the get.exe in theesp/tools folder

For Mac/Linux run python get.py in the esp/tools` folder

Restart the Arduino IDE

Selecting the board and port

Once you've got it connected to your computer, get the name of your device's port using one of the following steps:

Linux and Mac OS X

Open a terminal window and run the command ls /dev/tty.*

Look for a device with the name that begins with /dev/tty e.g. /dev/tty.usbmodemPy343431 or /dev/ttyUSB0.

Windows

Download and install the FTDI drivers from here.

Open the Windows start menu and search for 'Device Manager'

The COM port for the ESP32 device will be listed as 'USB Serial Device' or something similar

Keep note of the COM port (e.g. COM4)

Select the ESP32 Dev Module board type by going to Tools > Board

Select the port that matches from above

Check that Upload Speed is set to 115200

Create the Sketch

Click on File > New to create a new Sketch.

Copy and paste the publish event example code below in place of the empty setup() and void() functions

Replace the following values of the following variables:

ssid - with your WiFi network name.

password - with your WiFi network password.

device_secret_key with your device secret key from the Wia Dashboard (the one that begins with d_sk).

Verify/Compile the code. If it runs correctly then go to Sketch > Upload to send it to your ESP-32 Thing.

You may need to push the RST(Reset) button to run the code on the board.

Viewing you output

Click on button on the right hand of the screen to view your Serial monitor (Denoted in image below)

Make sure the baud rate is set to 1152000 (Shown in red rectangle in image below)

Publish an Event to Wia

If the Serial monitor doesn't show you connecting to a WiFi, You may need to push the RST(Reset) button to run the code on the board.

Now go to your device in the Wia dashboard and you should see the data appearing in the debugger.

Wia Device Debugger

Code

Publish an Event to Wia

#include <ArduinoJson.h>
#include <WiFi.h>
#include <ArduinoHttpClient.h>
#include <Arduino.h>


const char* ssid     = ""; // Your WiFi ssid
const char* password = ""; //Your Wifi password

WiFiClient client;
int status = WL_IDLE_STATUS;

// get this from the wia dashboard. it should start with `d_sk`
const char* device_secret_key = "";

// Wia API parameters
char server[] = "api.wia.io";
char path[] = "/v1/events";
int port = 80;

StaticJsonBuffer<200> jsonBuffer;
HttpClient httpClient = HttpClient(client, server, port);
JsonObject& root = jsonBuffer.createObject();


void setup() {

  // initialize serial communications and wait for port to open:
  Serial.begin(115200);
  while (!Serial) {
    ; // wait for serial port to connect. Needed for native USB port only
  }


  // attempt to connect to WiFi network:
  while (status != WL_CONNECTED) {
    Serial.print("Attempting to connect to SSID: ");
    Serial.println(ssid);
    // Connect to WPA/WPA2 network. Change this line if using open or WEP network:
    status = WiFi.begin(ssid, password);
    // wait 10 seconds for connection:
    delay(10000);
  }
  
  Serial.print("IP address: ");
  Serial.println(WiFi.localIP());
}

void loop() {
  root["name"] = "temperature";
  root["data"] = 21.5;

  // if you get a connection, report back via serial:
  if (client.connect(server, port)) {

    postToWia(root);

  } else {
    // if you didn't get a connection to the server:
    Serial.println("connection failed");
  }
   delay(3000); // Wait for 3 seconds to post again
}

void postToWia(JsonObject& data) {
  size_t len = data.measureLength();
  size_t size = len + 1;
  char json[size];
  httpClient.beginRequest();
  httpClient.post(path);
  httpClient.sendHeader("Content-Type", "application/json");
  httpClient.sendHeader("Content-Length", data.measureLength());
  httpClient.sendHeader("Authorization", "Bearer " + String(device_secret_key));
  httpClient.beginBody();
  data.printTo(httpClient);
  data.printTo(Serial);
  httpClient.endRequest();

}

Credits

Spivey

82 projects • 59 followers

Tourist in a Tutu || US Born || Melbourne/Mexico/California Raised || New Yorker at ❤️ || SF to Dublin to be COO of Wia the best IoT startup

Publish Any Event to Wia Using Your SparkFun ESP32 Thing