ESP8266 extended library for Arduino framework, especially for ESPectro development board, that supports Arduino IDE and Platformio.
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.
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:
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).
- What is PlatformIO?
- Official PlatformIO IDE. We recommend to use it for beginner.
- Quick Start with PlatformIO IDE or PlatformIO CLI
- Advanced using - custom settings, uploading to SPIFFS, Over-the-Air (OTA) or using stage version
- Integration with other IDE - Atom, CLion, Eclipse, Emacs, NetBeans, Qt Creator, Sublime Text, VIM and Visual Studio
- ESP8266 Project Examples
To get started fast with PlatformIO, we recommend you to install PlatformIO IDE from here.
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
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
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
andvariants
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:
- NeoPixelBus: https://github.com/Makuna/NeoPixelBus
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.
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