Skip to content
/ EspX Public

ESP8266 Extended Library, especially for ESPectro IoT development board

Notifications You must be signed in to change notification settings

andriyadi/EspX

Repository files navigation

ESPectro

ESP8266 extended library for Arduino framework, especially for ESPectro development board, that supports Arduino IDE and Platformio.

Important Update!

In previous version, this library also includes support to work with Makestro Cloud. Starting with v0.7.0 that support is removed, as this library should be all about ESPectro, no need for cloud integration. The specific Makestro Cloud client library is made available here: https://github.com/dycodex/MakestroCloudClient

Version 0.7.0 or above is also optimized for ESPectro Core board v3. It's still backward compatible with previous version. Just make sure you add ESPectro_V2 parameter when instantiate ESPectro object.

About ESPectro

It's an ESP8266 development board as the culmination of our 1+ year experience in exploring and developing products with ESP8266 MCU. Initially designed for kids in mind, everybody should be able to use it. Yet it's still hacker-friendly as we break out all ESP8266 ESP-12F pins. More details: https://shop.makestro.com/en/product/espectro-core/

To start making and developing your awesome IoT things, two paths are offered:

PlatformIO

We recommend to choose this path as it offer some much easiness in term of managing board, managing library and its dependencies, and the freedom to choose your favorite Integrated Development Environment (IDE).

PlatformIO is an open source ecosystem for IoT development with cross platform build system, library manager, and offers full support for Espressif (ESP8266) development. It works on the popular host OS: Mac OS X, Windows, Linux 32/64, Linux ARM (like Raspberry Pi, BeagleBone, CubieBoard).

PlatformIO IDE

To get started fast with PlatformIO, we recommend you to install PlatformIO IDE from here.

ESPectro board support

Make sure ESPectro board is already listed when you type on Terminal/Command Prompt or from the Terminal inside PlatformIO IDE:

pio boards --installed

If for some unknown cosmic reasons the board is not listed there, please install development version of espressif8266 platform by typing on terminal:

pio platform install https://github.com/platformio/platform-espressif8266/archive/develop.zip

Then try to list boards again, you should see:

espectro                       ESP8266        80Mhz     4096kB  80kB   ESPrectro Core

Installing Library

After you install PlatformIO, to install this library for PlatformIO, all you have to do is typing this command from Terminal/Command Prompt:

platformio lib install 369

Arduino IDE

Development with Arduino IDE is still supported. Please install the latest Arduino IDE and make sure that you already add support ESP8266 boards via Boards Manager by following the guide here. Then, download this repo and unzip it. Put unzipped folder to libraries folder of your Arduino IDE (depends on your OS).

We have submitted the necessary files to ESP8266 Arduino project so ESPectro is supported by Arduino IDE out of the box. But for now, please follow these steps:

  • In folder ArduinoIDESupport there are two files: boards.txt and variants folder
  • Copy and overwrite boards.txt file to [root_folder]/Arduino15/packages/esp8266/hardware/esp8266/[version]
  • Copy and overwrite variants folder to the same folder as above

Notes: [root_folder] depends on your OS. For Windows 7/8/10, it should be on C:\Users\[username]\AppData\Local. On macOS it resides on: /Users/[username]/Library. [version] depends on installed ESP8266 Arduino framework.

Then, please install following libraries:

Or if you already have those library installed, make sure to have the latest version.

Please consult to Arduino documentation on how to install a library for Arduino IDE.

To get started, please try some examples provided, a lot of them.

About Makestro Cloud

Makestro Cloud (formerly known as iothub.id) is our contribution to makers community to get up fast for connecting their things to the cloud. It's not meant to be production-grade IoT backend, but you can use it to test publishing data from the things and visualize them to a nice dashboard, or controlling your things. Let's get acquainted with it by here: https://www.hackster.io/winter/getting-started-with-makestro-cloud-f4a646, or watching this intro video and follow it along: https://youtu.be/7HNz-JNF8EU

As explained above, this library doesn't include support of Makestro Cloud client anymore. Please refer to this repo