Пример чтения текстовой переменной на Arduino UNO

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

• Отладочная плата AVR. Предпочтительно Arduino UNO/Piranha UNO или любая другая плата AVR, совместимая с Ethernet шилдом. Если Ваша панель использует большое количество переменных и/или Ваш скетч использует большое количество библиотек, необходимо использовать отладочную плату на базе микроконтроллера с большей статической и динамической памятью, такую как Arduino MEGA или Piranha ULTRA
• Ethernet шилд W5500 (если Вы используете шилд на базе чипа ENC28J60, необходимо использовать отладочную плату на базе микроконтроллера с большей статической и динамической памятью, такую как Arduino MEGA или Piranha ULTRA, при этом необходимо скачать и установить последнюю версию библиотеки UIPEthernet и изменить в скетче Ethernet.h на UIPEthernet.h).
• Провод RJ45-RJ45 категории cat5e.
• Маршрутизатор со свободным гнездом RJ-45 LAN.
• Подключение к сети Интернет.

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

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

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

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

Подключите Ethernet Shield к Arduino UNO

Подключите Arduino к ПК, подключите Ethernet Shield к сети LAN

Скетч Arduino

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

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

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

#include <iocontrol.h>
#include <SPI.h>
#include <Ethernet.h>

// Название панели на сайте iocontrol.ru
const char* myPanelName = "название_панели";
// Название переменной с типом int на сайте iocontrol.ru
const char* myVarName = "название_переменной";

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

// MAC адреса Ethernet шилда. Должен быть уникальным в сети
byte mac[] = {
    0xFE, 0xED, 0xDE, 0xAD, 0xFA, 0xCC
};


void setup()
{
    Serial.begin(9600);
    Ethernet.begin(mac);

    // Вызываем функцию первого запроса к сервису
    mypanel.begin();
}

void loop()
{
    // Обновляем переменные в памяти и записываем
    // статус запроса в переменную
    int status = mypanel.readUpdate();

    // Если статус равен константе OK...
    if (status == OK) {
        // Записываем значение в переменную
        String myString = mypanel.readString(myVarName);
        // Выводим значение в монитор последовательного порта
        Serial.println(myString);
    }
}

Выберите последовательный порт к которому подключена отладочная плата нажав в меню Инструменты -> Порт -> %НОМЕР ПОРТА%, затем нажмите на кнопку загрузка или на клавиатуре ctrl+u.

Откройте монитор последовательного порта нажав левой кнопкой мыши на пункт меню Инструменты -> Монитор порта или сочетанием клавиш CTRL+SHIFT+M. В монитор последовательного порта будет выводиться значение переменной Вашей панели.