Пример записи переменной-кнопки из ESP32 (ESP8266) на сайт

Нам понадобится

  • Отладочная плата ESP32 (ESP8266).
  • Маршрутизатор с точкой доступа WiFi
  • Подключение к сети Интернет.

Создание переменной-кнопки на сайте iocontrol.ru

Подробнее о создании переменных и работе с API на сайте Вы можете узнать по этой ссылке

  1. Если у Вас уже есть созданная панель, пропустите этот шаг, если у Вас ещё не создано ни одной панели, создайте её руководствуясь нашей инструкцией.
  2. Теперь зайдите в одну из созданных ранее панелей сначала нажав на вкладку "ПАНЕЛИ" (сверху, если Вы находитесь на десктоповом сайте, или снизу, если Вы используете мобильное приложение или мобильную версию сайта) и, затем, на название созданной Вами ранее панели.
  3. Внутри панели нажмите "Создать переменную". Введите название переменной, например myButton. Нажмите создать. В Вашей панели появится новая карточка с названием переменной.
  4. Нажмите на шестеренку в правом верхнем углу карточки переменной
  5. Нажмите на меню "Вид панели" справа от карточки переменной и выберите "Кнопка".
  6. Нажмите кнопку "Сохранить"
  7. Перейдите в панель в навигаторе сверху от карточки переменной
  8. Ваша переменная имеет вид кнопки и её можно переключать прямо в панели

Подключение оборудования

Подключите ESP32 (ESP8266) к ПК

Скетч Arduino

Если Вы никогда не работали в среде разработки Arduino, по этой ссылке можно узнать как её установить и настроить.

Для работы в среде Arduino с платами ESP32 и ESP8266 необходимо установить их поддержку

Установка поддержки плат ESP32

Для работы с ESP32 необходимо настроить поддержку плат ESP32. Выберите пункт меню Файл -> Настройки (или на клавиатуре нажмите ctrl+,). В поле ввода "Дополнительные ссылки для Менеджера плат" вставьте ссылку https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json. Далее необходимо выбрать пункт меню Инструменты -> Плата: -> Менеджер плат. Откроется окно Менеджера плат. В поле поиска наберите ESP32 и установите последнюю версию плат. Подробнее об установке плат можно узнать по ссылке.

Установка поддержки плат ESP8266

Выберите пункт меню Файл -> Настройки (или на клавиатуре нажмите ctrl+,). В поле ввода "Дополнительные ссылки для Менеджера плат" вставьте ссылку https://arduino.esp8266.com/stable/package_esp8266com_index.json. Далее необходимо выбрать пункт меню Инструменты -> Плата: -> Менеджер плат. Откроется окно Менеджера плат. В поле поиска наберите ESP8266 и установите последнюю версию плат. Подробнее об установке плат можно узнать по ссылке.

Установка библиотеки

Для работы с библиотекой iocontrol её необходимо установить в Arduino IDE. Для установки скачайте библиотеку и в Arduino IDE в меню выберите Скетч -> Подключить библиотеку -> Добавить .ZIP библиотеку и выберите скачанный .zip файл библиотеки. Подробнее об установке библиотек можно узнать по этой ссылке.

Работа с протоколом HTTPS

Для простоты и быстрого начала работы с сервисом скетч ниже использует протокол HTTP, который передаёт данные не шифруя. Если Вам необходимо передавать критические данные, такие как пароли или коды запуска фейерверков, или Вы просто не хотите, чтобы ваш интернет провайдер знал показания Ваших датчиков, воспользуйтесь статьёй по настойке ESP32 и ESP8266 на работу через HTTPS. (Примечание: через HTTPS могут работать только платы ESP, для плат Arduino AVR работа через HTTPS на данный момент не реализована).

В скетче ниже необходимо заменить "название_панели" на название Вашей панели и "название_переменной" на название переменной кнопки, которую мы создали ранее (например "myButton")

Данный скетч переключает созданную на сайте кнопку с частотой, заданной функцией writeUpdate() подобно примеру BlinkWithoutDelay из Arduino IDE, но в отличии от него все интервалы осуществлены внутри библиотеки в функции writeUpdate(). Так же, функция делает запрос на сервер только если произошли какие-либо изменения переменных. Из-за этого в коде функции setup() переменная myButton инициируется со значением, отличным от прочитанного с сервера, иначе функция writeUpdate() никогда не вернёт статус код OK и переменная myButton никогда не поменяет своё значение. Подробнее про статус коды, возвращаемые функциями begin(), writeUpdate() и readUpdate() можно прочитать по этой ссылке.

#include <iocontrol.h>
#include <WiFi.h>
// Если ESP8266, вместо WiFi.h:
// #include <ESP8266WiFi.h>

// Название панели на сайте iocontrol.ru
const char* myPanelName = "название_панели";
// Название переменной с типом кнопки на сайте iocontrol.ru
const char* myVarName = "название_переменной";
// Если панель использует ключ
// const char* key = "ключ";

const char* ssid = "ssid_точки_доступа_WiFi";
const char* password = "пароль_точки_доступа_WiFi";

// Переменная, значение которой необходимо записать
bool myButton;

// Создаём объект клиента класса WiFiClient
WiFiClient client;
// Создаём объект iocontrol, передавая в конструктор название панели и клиента
iocontrol mypanel(myPanelName, client);
// Если панель использует ключ
// iocontrol mypanel(myPanelName, key, client);

void setup()
{
    Serial.begin(115200);
    WiFi.begin(ssid, password);

    // Ждём подключения
    while (WiFi.status() != WL_CONNECTED) {
        delay(500);
        Serial.print(".");
    }
    Serial.println();

    // Вызываем функцию первого запроса к сервису
    mypanel.begin();
    // Инициируем переменную с противоположным значением
    myButton = !mypanel.readBool(myVarName);
}

void loop()
{

    // Записываем состояние переменной
    mypanel.write(myVarName, myButton);

    // Обновляем переменные на сайте
    int status = mypanel.writeUpdate();

    // Если статус равен константе OK...
    if (status == OK) {

        // Выводим текст в последовательный порт
        Serial.println("Updated");
        // Меняем состояние переменной
        myButton = !myButton;
    }
}

Теперь скетч, загруженный в микроконтроллер, будет менять переменную на сайте.

О сервисе
Библиотека
    Для работы с Arduino, Piranha, ESP32 или ESP8266
  • Скачать: ZIP, GitHub