Bosch IoT Device Management

Step 2 - Configure the Octopus

In this tutorial part you will make use of the Arduino IDE to prepare the sketch which will be flashed to the Octopus board.

Prerequisites

Please make sure to use the released versions of the libraries,
as we encountered difficulties with some beta versions (e.g. of ArduinoJson).

Edit the file ${ArduinoDirectory}/libraries/pubsubclient/src/PubSubClient.h
and set the MQTT_MAX_PACKET_SIZE to 2048.

If you cannot find the file instantaneously, try to find the file in ${USERHOME}\Documents\Arduino\libraries\PubSubClient\src\PubSubClient.h

Change the board

Tools > Board > Adafruit Feather HUZZAH ESP8266

Find the Octopus com port

Attach the Octopus board to your development machine via USB cable.

In case you never used the board before, first of all try to find out on which COM port it communicates.

images/confluence/download/attachments/1634788038/octo-com-board.png

In case the driver is not installed yet, check https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers.

Check via Device Manager in Windows that a correct driver for COM port is installed.
If not, install a driver from ${ArduinoDirectory}/drivers

In Arduino select Tools > Port > the port of your device.
Then, open the Arduino serial monitor, which will later display what the device is sending.

images/confluence/download/attachments/1634788038/arduino-serial-monitor-1.png

Check via Device Manager in Windows that a correct driver for COM port is installed.
If not, install a driver from ${ArduinoDirectory}/drivers

Use our sketch for the Octopus to communicate to Bosch IoT Suite

Our examples at GitHub provide ready-to-use package

https://github.com/bosch-io/iot-things-examples/tree/master/octopus-firmware

In your Arduino IDE open octopus-hub.ino (see folder /octopus-firmware/octopus-hub/octopus-hub.ino)

Configure settings.h

Use the template (see /octopus-firmware/octopus-hub/settings-template.h) and create a file called setting.h in the same folder.

Complete the file settings.h with the content as shown in the pattern below.

You must keep the quotation marks, e.g. 
#define WIFI_SSID "myGuestWLAN"
#ifndef SETTINGS_H
#define SETTINGS_H
 
// ---- WiFi configuration ----
#define WIFI_SSID "" // The SSID of the WiFi you want your octopus board to connect to.
#define WIFI_PASSWORD "" // The password of the WiFi you want your octopus board to connect to.
 
// ---- Things registration properties ----
#define THINGS_NAMESPACE "" // The namespace you created in your solution.
#define THING_NAME "" // This is the thing id without the namespace.
 
// ---- Hub registration properties +++ you can look up these values in the json file downloaded after provisioning ----
#define HUB_TENANT "" // The tenant ID of your Bosch IoT Hub instance
#define HUB_DEVICE_ID "" // The device ID
#define HUB_DEVICE_AUTH_ID "" // The auth ID
#define HUB_DEVICE_PASSWORD "" // The device password that was used for the device provisioning API request in plain text.
 
// ---- Update rate of sensors ----
#define SENSOR_UPDATE_RATE_MS 60000 // Print updated sensor value every 60 seconds. Faster update rates mean more transactions,
// which might exceed your Free plan capacities of your subscription quite fast.
#define LOOP_DELAY 100
 
// ---- Hub MQTT configuration ----
// Do not change this
#define MQTT_BROKER "mqtt.bosch-iot-hub.com"
#define MQTT_PORT 8883
 
//#define BME280 // uncomment this line if your board has a BME280 instead of BME680
 
extern const unsigned char mqtt_server_ca[];
extern const unsigned int mqtt_server_ca_len;
 
#endif

Verify the sketch and upload to the Octopus board

The Arduino IDE knows the board as "Adafruit Feather HUZZAH ESP8266”.

Use the Arduino tooling to verify that the project compiles. Otherwise fix the issues.

Use the Arduino tooling to flash the Octopus.

Upon success the Octopus LEDs should light up in blue and green color .

Check your work

The Arduino serial monitor should show which data the board tries to send to the Bosch IoT Hub.

images/confluence/download/attachments/1634788038/arduino-serial-monitor.png