Передача данных с ESP32 в ThingSpeak с помощью ESP-IDF


В данной статье мы научимся публиковать показания датчиков в ThingSpeak с помощью ESP32 и ESP-IDF. ThingSpeak — это платформа для IoT-аналитики, позволяющая хранить и считывать данные из облака. Эта облачная платформа предоставляет API, который позволяет пользователям отправлять данные, выполняя HTTP-запрос к этому API.

Мы будем использовать библиотеку HTTP-клиента, доступную в ESP-IDF, для выполнения HTTP GET-запросов к REST API ThingSpeak с использованием различных полей. Эти поля будут содержать показания датчиков. Для демонстрации мы будем использовать датчик BME280 и отправлять его показания температуры, давления и влажности. Но вы можете использовать любой датчик, например, DS18B20, DHT22, BME680 и SHT31.

Ранее на нашем сайте мы рассматривали достаточно много проектов с использованием платформы ThingSpeak, к наиболее популярным из которых относятся:

Что такое ThingSpeak

ThingSpeak — это платформа для аналитики IoT, позволяющая пользователям собирать и хранить данные с датчиков в облаке и проводить аналитику этих данных. Она может использоваться для отслеживания и мониторинга различных типов данных, таких как температура, влажность и многое другое, а также позволяет пользователям создавать визуализации в реальном времени, оповещения и многое другое. ThingSpeak также предоставляет API, позволяющий пользователям интегрировать данные с датчиков с другими платформами и приложениями.

Для использования API ThingSpeak вам сначала нужно создать учетную запись на веб-сайте ThingSpeak и настроить канал для хранения данных с ваших датчиков. Эти шаги мы рассмотрим в следующем разделе.

ThingSpeak предоставляет ключ API, и мы используем этот ключ API для создания URL-адреса, который можно вызвать из нашего кода ESP32 ESP-IDF для отправки данных в облако.

Мы отправим GET или POST запрос к указанному выше URL-адресу API, используя ESP32 и ESP-IDF.

Регистрация в ThingSpeak

Перейдите на сайт ThingSpeak (https://thingspeak.com/) и нажмите кнопку “Get Started for Free” («Начать бесплатно»), чтобы создать учетную запись.

Главная страница сервиса ThingSpeak

Заполните необходимую информацию и нажмите кнопку “Sign Up” («Зарегистрироваться»), чтобы завершить процесс регистрации.

Начало процесса регистрации в платформе ThingSpeak

Нажмите «ОК».

Регистрация на платформе ThingSpeak успешно завершена

Создание канала и получение ключа API в ThingSpeaK

После входа в систему нажмите кнопку “New Channel” («Новый канал»), чтобы создать новый канал.

Создание нового канала в ThingSpeaK

Укажите название и описание канала, а также выберите количество полей, которые вы хотите использовать. Для датчика BME280 вам потребуется три поля: температура, давление и влажность.

Ввод настроек нового канала в ThingSpeaK

Ваш канал будет создан.

Завершение создания канала в ThingSpeaK

Перейдите в приватный режим и нажмите на значок карандаша над каждым графиком поля. Это позволит вам настроить графики в соответствии с вашими предпочтениями. Вы можете добавить необходимые детали. После нажатия кнопки «Сохранить» график обновится в соответствии с заданными вами настройками.

Графики для нашего проекта в ThingSpeaK

После создания канала вы можете найти ключи API для своего канала на вкладке “API Keys” («Ключи API»). Вам понадобится ключ API для записи, чтобы отправлять данные в канал, и ключ API для чтения, чтобы получать данные из канала.

Получение ключа API в ThingSpeaK

На данный момент мы создали учетную запись ThingSpeak и получили ключ API. Теперь давайте создадим проект ESP-IDF для отправки показаний датчика BME280 на эту платформу IoT-аналитики.

Подключение BME280 к ESP32

Датчик BME280 широко используется в электронных проектах для измерения температуры окружающей среды, барометрического давления и относительной влажности, где требуется низкое энергопотребление. Для передачи данных на микроконтроллер можно использовать протоколы связи I2C и SPI. Хотя датчик BME280 выпускается в различных версиях, мы будем использовать связь I2C для обмена данными с платой ESP32. Этот протокол основан на синхронной многомастерной системе, где плата ESP32 выступает в роли ведущего устройства, а датчик BME280 — в роли ведомого.

Для подключения платы ESP32 к датчику BME280 нам понадобятся следующие компоненты:

  1. Плата ESP32.
  2. Датчик BME280.
  3. Соединительные провода.
  4. Макетная плата.

Подключение датчика BME280 к плате ESP32 довольно простое, так как оно включает в себя лишь соединение 4 контактов (GND, VCC, SDA и SCL) с ESP32. Необходимо соединить вывод VCC с контактом 3,3 В, заземление с общим заземлением, контакт SCL датчика с контактом SCL платы ESP32, а контакт SDA датчика с контактом SDA платы ESP32.

В ESP32 по умолчанию для вывода SDA используется GPIO21, а для SCL — GPIO22.

Соединения между устройствами указаны в таблице ниже:

Датчик BME280 ESP32
GND GND
VCC 3.3V
SDA GPIO21(I2C SDA)
SCL GPIO22 (I2C SCL)

Схема подключения датчика BME280 к ESP32

Более подробно про подключение датчика BME280 к плате ESP32 вы можете прочитать в этой статье.

Создание проекта ESP-IDF для отправки показаний датчиков на ThingSpeak

В этом разделе давайте создадим проект ESP-IDF для отправки показаний датчиков с ESP32 и BME280 на ThingSpeak.

Откройте VS Code и перейдите в меню View > Command Palette («Вид» > «Палитра команд»). Введите в строке поиска ESP-IDF: New Project и нажмите Enter.

Укажите название проекта и каталог, а также плату и целевое устройство ESP-IDF. Мы назвали наш проект «esp32_thingspeak». Для платы ESP-IDF мы выбрали опцию custom board ("пользовательская плата"). Для целевого устройства ESP-IDF мы выбрали модуль ESP32. Нажмите кнопку ‘Choose Template’ ("Выбрать шаблон"), чтобы продолжить.

Создание проекта ESP-IDF для отправки показаний датчиков на ThingSpeak

В разделе «Расширение» выберите опцию ESP-IDF:

Выбор опции ESP-IDF в разделе Extension («Расширение»)

На вкладке get-started («Начало работы») мы щелкнем по пункту «sample_project». Затем нажмем ‘Create project using template sample_project’) («Создать проект, используя шаблон sample_project»).

Создание проекта с использованием шаблона sample_project

Вы получите уведомление о создании проекта. Чтобы открыть проект в новом окне, нажмите «Да».

Это откроет проект, который мы создали на вкладке «Проводник». Внутри папки проекта находится несколько папок. Это справедливо для каждого проекта, который вы будете создавать с помощью ESP-IDF Explorer.

Добавление библиотеки BME280 ESP-IDF в проект

Для начала добавим необходимые заголовочные файлы для библиотек, требуемых для этого проекта. Создайте новую папку с именем 'components/bme280' и добавьте в неё следующие файлы, доступные по этой ссылке. Сюда входят все файлы, перечисленные ниже:

  • bme280.h
  • bme280_support.c
  • bme280.c
  • CMakeLists.txt

Код ESP32 для отправки показаний датчиков на ThingSpeak

Этот код представляет собой программу, написанную на языке C для ESP32 с использованием фреймворка ESP-IDF, которая отправляет показания датчика BME280 в ThingSpeak каждые 5 секунд. Скопируйте следующий код в файл main.c вашего проекта esp-idf.

Как работает код?

Часть кода, касающаяся датчика BME280, аналогична той, которую мы рассматривали в этой статье. Здесь мы объясним только ту часть кода, где мы отправляем HTTP-запрос к ThingSpeak с ESP32 для отправки показаний датчика BME280.

Эти строки кода содержат несколько заголовочных файлов, таких как «stdio.h», «string.h» и «stdlib.h», которые предоставляют базовые операции ввода/вывода, функции обработки строк и выделения памяти соответственно.

В него также входят заголовочные файлы, специфичные для микроконтроллера ESP32, такие как «esp_log.h», «nvs_flash.h», «esp_event.h» и «esp_netif.h». Эти заголовочные файлы предоставляют функции для ведения журналов, энергонезависимой памяти, обработки событий, управления сетевым интерфейсом и драйвера BME280.

Эти строки определяют некоторые константы, такие как контакты шины I2C, к которым будет подключен BME280, и ключ API от ThingSpeak. Они также определяют несколько переменных для хранения данных о температуре, давлении и влажности, считываемых с датчика BME280.

Отправка данных с датчика в функцию ThingSpeak

Эта функция отвечает за отправку показаний датчика BME280 с ESP32 на ThingSpeak каждые 5 секунд с использованием библиотеки HTTP-клиента ESP-IDF. Функция send_data_to_thingspeak() принимает в качестве параметра указатель типа void.

Теперь объявите различные строки и переменные. Объявите символьный массив с именем thingspeak_url и присвойте ему строку «https://api.thingspeak.com», которая является адресом ThingSpeak. Далее, объявите символьный массив с именем data и присвойте ему строку с форматом данных, которые будут отправлены в URL-адресе запроса.

Теперь объявляется структура с именем «config», которая используется для настройки HTTP-клиента с указанием URL-адреса и метода «HTTP_METHOD_GET». Затем создается дескриптор HTTP-клиента с помощью функции «esp_http_client_init» и структуры «config».

Далее инициализируется обработчик HTTP-клиента с конфигурацией и устанавливается заголовок клиента в значение «Content-Type» со значением «application/x-www-form-urlencoded».

Код внутри цикла while выполняется каждые 5 секунд. Он отправляет показания датчика BME280 в ThingSpeak.

Сначала используйте функцию snprintf() для форматирования массива post_data, добавив в него строку данных, ключ API, переменные temp, press и hum, которые представляют собой значения API ThingSpeak, а также значения температуры, давления и влажности от датчика BME280 соответственно.

Далее, присвойте полю POST клиента массив post_data и его длину. Наконец, выполните HTTP-запрос с помощью функции esp_http_client_perform() и присвойте результат переменной err.

В конце кода проверяется, равна ли переменная err значению ESP_OK, что указывает на успешность HTTP-запроса. Если err равно ESP_OK, код проверяет код состояния ответа. Если код состояния равен 200, выводится сообщение об успешной отправке сообщения. Если код состояния не равен 200, выводится сообщение о неудачной отправке сообщения, после чего выполняется код завершения.

Если err не равен ESP_OK, это означает, что HTTP-запрос не был успешным, и данные с датчика не были успешно отправлены. В этом случае выводится сообщение о том, что отправка сообщения не удалась, после чего происходит переход к метке завершения.

Функция esp_http_client_cleanup вызывается для освобождения ресурсов, связанных с переменной клиента. Функция vTaskDelete(NULL) вызывается для удаления текущей задачи.

Вкратце, эта функция отправляет данные в облако ThingSpeak, используя библиотеку HTTP-клиента ESP-IDF. Данные включают ключ API и три поля: field1, field2 и field3. Код отправляет данные в бесконечном цикле с задержкой в ​​5000 миллисекунд между каждой итерацией.

Основная функция

Функция «app_main» является точкой входа в приложение. Она инициализирует энергонезависимую флэш-память (NVS) микроконтроллера ESP32, используемую для хранения данных, которые должны сохраняться после выключения и включения питания. После этого вызывается функция «nvs_flash_init» для инициализации NVS-флэш-памяти и проверяется возвращаемое значение. Если возвращаемое значение равно «ESP_ERR_NVS_NO_FREE_PAGES» или «ESP_ERR_NVS_NEW_VERSION_FOUND», это означает, что NVS-флэш-память необходимо стереть и инициализировать заново. Затем вызывается функция «ESP_ERROR_CHECK» для проверки наличия ошибок при инициализации NVS-флэш-памяти.

Инициализирует I2C-мастер, используемый для связи с датчиком BME280.

Подключается к сети Wi-Fi, вызывая функцию «connect_wifi()».

Если подключение к Wi-Fi установлено успешно, создаются две задачи:

  • Первая задача — это задача «bme280_get_readings», которая считывает данные с датчика BME280 и сохраняет их в глобальных переменных.
  • Вторая задача — это задача «send_data_to_thingspeak», которая отправляет данные с датчиков на платформу ThingSpeak IoT с помощью HTTP-запросов.

Примечание: в этом проекте есть один заголовочный файл с именем «connect_wifi.h», мы создали его в предыдущих уроках. Вам также необходимо добавить этот файл. Вы можете скачать полный проект по ссылке для скачивания в следующем разделе.

Демонстрация работы проекта

В этом разделе мы рассмотрим демонстрацию отправки сообщений в WhatsApp. Для начала скачайте полный проект по следующей ссылке и соберите его.

Настройка учетных данных Wi-Fi

Теперь перейдите в меню menuconfig. Щелкните значок, показанный ниже. Откроется редактор конфигурации ESP-IDF SDK.

Кнопка в ESP_IDF для открытия меню menuconfig

Прокрутите вниз и откройте Example Configuration (пример конфигурации). Здесь мы можем установить параметры конфигурации для этого примера в соответствии с нашими потребностями. Это включает в себя SSID сети Wi-Fi, пароль сети Wi-Fi и максимальное количество попыток повтора. Укажите SSID и пароль сети Wi-Fi вашего маршрутизатора, к которому будет подключаться плата ESP32. По умолчанию максимальное количество попыток повтора установлено на 5. Вы можете изменить это значение по своему усмотрению. После указания параметров конфигурации нажмите кнопку «Сохранить» вверху.

Настройка примера конфигурации

Отключение ESP TLS

Мы используем HTTP вместо HTTPS, поэтому нам необходимо отключить компонент ESP-TLS в settings->Components Config>ESP-TL.

Отключение ESP TLS в ESP-IDF

Для прошивки микросхемы введите следующую команду в последовательном терминале. Не забудьте заменить COM-порт на тот, через который подключена ваша плата.

Ввод команды в последовательном терминале для компиляции скетча

После успешной прошивки кода вы можете просмотреть все информационные журналы. Сначала инициализируется Wi-Fi станции. Затем мы можем просмотреть esp_netif_handlers, который включает IP-адрес, маску и адрес шлюза. Затем мы получаем запись «получен IP-адрес», за которой следует IP-адрес, что показывает, что ESP32 успешно подключился к вашей сети Wi-Fi.

Если всё работает правильно, в консоли появится сообщение “Message sent Successfully” («Сообщение успешно отправлено»), как показано ниже.

Сообщение в терминале об успешной отправке данных

Теперь откройте свою учетную запись ThinkgSpeak, и вы сможете просмотреть показания датчиков на графиках, как показано ниже:

Тестирование работы проекта в своей учетной записи ThinkgSpeak

(Проголосуй первым!)
Загрузка...
14 просмотров

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *