Device Setup

This guide will provide basic steps for using ESP8266 along with OpenDevice. Other devices have similar procedures.

Install Arduino IDE

Download and install the Arduino IDE by following the instructions at:
https://www.arduino.cc/en/Main/Software

Configure Arduino IDE

In order for the board to show up as a board in Arduino, you must add the following to the “Additional Boards Manager URLs” field in the preferences. Arduino -> Preferences.

http://arduino.esp8266.com/stable/package_esp8266com_index.json

Install ESP8266 Board

Open the Board Manager at Tools -> Board -> Boards Manager. Change the Type field to Contributed and enter esp8266 in the Search field. Select the esp8266 and click the Install button.

May be need restart the Arduino IDE. We can now configure the Arduino IDE to use the board we just installed.

Open the Arduino IDE, select the Tools menu, and change the Board to: Generic ESP8266 Module

Install Libraries

The libraries can be installed using Arduino's Library Manager. Open the manager from the Sketch -> Include Library -> Manage Libraries menu.

The first required library is OpenDevice. Type that in the filter field, select the entry in the list and install the latest version.

To know more about a library, access this link

Opt2: Install from sources

To install the library, you can simply clone the repository: opendevice-lib-arduino 

git clone https://github.com/OpenDevice/opendevice-lib-arduino OpenDevice

And put in the "/libraries" folder of the Arduino IDE.

Remember that some examples in this library need extra libraries that must be downloaded and enabled in the configuration file: dependencies.h


Next required library is PubSubClient. Type that in the filter field, select the entry in the list and install the latest version.


If you don't see an entry under the port menu, double check the following:

  1. Did you install the USB driver?
  2. Your user has permission to access serial devices ?
  3. Did you connect the microcontroller to your computer with the supplied USB cable?