Отправка SMS с помощью ESP32, Twilio и ESP-IDF


В этом уроке мы научимся отправлять SMS с помощью ESP32 и ESP-IDF, используя API веб-сервисов Twilio. Twilio — это облачная коммуникационная платформа, которая позволяет разработчикам программного обеспечения программно совершать и принимать телефонные звонки, отправлять и получать текстовые сообщения, а также выполнять другие коммуникационные функции, используя API своих веб-сервисов.

Отправка SMS с помощью ESP32, Twilio и ESP-IDF

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

Также на нашем сайте мы рассматривали и другие проекты по отправке SMS:

Веб-сервис Twilio

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

Веб-сервис Twilio

С помощью Twilio разработчики могут программно отправлять и получать текстовые сообщения, совершать и принимать телефонные звонки, отправлять мультимедийные сообщения и управлять каналами связи, такими как WhatsApp и Facebook Messenger, используя простые REST API.

Twilio также предоставляет дополнительные инструменты и сервисы, такие как Twilio Studio, визуальный конструктор приложений, и Twilio Flex, облачная платформа для контакт-центров.

В целом, Twilio предоставляет комплексную и масштабируемую платформу для предприятий и разработчиков, позволяющую создавать и интегрировать коммуникационные возможности в свои приложения, продукты и системы.

Создание пробного аккаунта Twilio

Перейдите на сайт Twilio (www.twilio.com) и зарегистрируйте бесплатный аккаунт.

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

Введите свои данные и нажмите кнопку ‘Start your free trial’ («Начать бесплатную пробную версию»).

Начало регистрации на платформе Twilio

Подтвердите свой адрес электронной почты, перейдя по ссылке, отправленной на ваш электронный адрес.

Подтверждение своего адреса электронной почты

После подтверждения адреса электронной почты войдите в консоль Twilio.

Окно входа в консоль Twilio

После успешной проверки вам станет доступна панель управления вашей учетной записи Twilio:

Панель управления учетной записи Twilio

Создание бесплатного аккаунта Twilio

Перейдите в раздел Phone Numbers > Manage > Verified Caller IDs («Номера телефонов» > «Управление» > «Подтвержденные идентификаторы вызывающего абонента»). Здесь номер телефона, предоставленный в процессе верификации, будет отображаться в вашем аккаунте Twilio.

Ввод данных об идентификаторах вызывающих абонентов

В консоли Twilio нажмите “Add a new Caller ID” («Добавить новый идентификатор вызывающего абонента»).

  • Введите желаемый номер телефона.
  • Код подтверждения будет отправлен на указанный номер по SMS.
  • Введите проверочный код в консоли Twilio, чтобы завершить процесс добавления идентификатора вызывающего абонента.

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

Добавление нового идентификатора вызывающего абонента

Получение номера телефона от Twilio

Чтобы приобрести номер телефона для использования с Twilio, выполните следующие шаги:

  • Перейдите в раздел “Phone Numbers” («Номера телефонов») в консоли Twilio.
  • Выберите “Buy a Number” («Купить номер») и укажите необходимые функции, включая SMS.
  • Используйте поля country («Страна») и расширенный поиск, чтобы найти подходящий номер среди доступных вариантов.

Примечание: даже если вы используете бесплатную пробную учетную запись Twilio, вы получите 15,50 долларов США в виде кредита, который можно использовать для покупки телефонного номера.

Покупка номера телефона в Twilio

Примите условия и положения и нажмите кнопку Buy («Купить»).

Кнопка для покупки телефонного номера на платформе Twilio

Кроме того, вам может потребоваться настроить параметры приобретенного номера.

Настройка параметров приобретенного телефонного номера

Чтобы просмотреть недавно приобретенный номер телефона, перейдите в консоль Twilio в раздел “Phone Numbers” > “Manage” > “Active Numbers” («Номера телефонов» > «Управление» > «Активные номера»).

Настройка программируемой службы обмена сообщениями

После создания бесплатной учетной записи Twilio, добавления подтвержденного идентификатора вызывающего абонента и получения номера Twilio для отправки SMS, следующим шагом является настройка сервиса программируемых сообщений. Для этого:

  • В консоли Twilio перейдите в раздел “Messaging” > “Try it out” > “Get Set Up” («Сообщения» > «Попробовать» > «Настроить»).
  • Откроется приветственная страница сервиса программируемых сообщений.
  • Нажмите кнопку “Start setup” («Начать настройку»), чтобы запустить процесс настройки.

Настройка программируемой службы обмена сообщениями в Twilio

  • На странице настроек укажите название для сервиса.
  • Нажмите кнопку “Create Messaging Service” («Создать службу обмена сообщениями»).

Создание службы обмена сообщениями в Twilio

Введите номер телефона Twilio, который вы только что приобрели. Затем нажмите ‘Add this number’ («Добавить этот номер»).

Добавление номера телефона в созданную службу обмена сообщениями

После завершения процесса настройки у вас теперь есть доступ к идентификаторам службы сообщений (Message Service SID), учетной записи (Account SID) и токена аутентификации (Auth Token). Эти учетные данные понадобятся при программировании ESP32 с помощью ESP-IDF для отправки SMS.

Завершение процесса настройки службы обмена сообщениями

Тестирование сервиса

Перед написанием кода для ESP32 для отправки SMS рекомендуется протестировать службу программируемых сообщений, созданную с помощью curl.

Для этого:

  • В консоли Twilio перейдите в раздел “Messaging” > “Try it out” > “Send an SMS” («Сообщения» > «Попробовать» > «Отправить SMS»).
  • Введите номер телефона получателя. Примечание: номер получателя должен быть подтвержденным идентификатором вызывающего абонента, а сообщение должно быть отправлено с использованием идентификатора службы обмена сообщениями (SID).
  • Введите текст сообщения и нажмите кнопку “Send test SMS” («Отправить тестовое SMS»), чтобы отправить тестовое сообщение.

Тестирование отправки тестового SMS на Twilio

Создание проекта в ESP-IDF для отправки SMS с помощью Twilio

В этом разделе давайте создадим проект ESP-IDF для отправки SMS с помощью Twilio.

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

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

Создание проекта в ESP-IDF для отправки SMS с помощью Twilio

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

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

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

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

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

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

Код ESP32 для отправки SMS с помощью Twilio

ESP-IDF реализует функцию отправки SMS-сообщений с использованием API Twilio. Для этого требуется учетная запись Twilio, которая предоставляет идентификатор учетной записи (SID) и токен аутентификации. Номера телефонов получателя и отправителя, а также отправляемое сообщение определяются в коде как переменные.

URL-адрес API Twilio и данные для отправки формируются из этих переменных и информации об аутентификации. Библиотека esp_http_client используется для отправки HTTP POST-запроса к API Twilio с сформированными данными. Результат запроса проверяется, и в случае успеха в журнал записывается сообщение, указывающее на успешную отправку сообщения. В случае ошибки в журнал записывается сообщение о сбое. Функция вызывается как задача, созданная основной функцией после подключения к сети Wi-Fi.

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

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

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

Определите четыре символьных массива для хранения идентификатора учетной записи Twilio (SID), токена аутентификации Twilio, номера телефона получателя и номера телефона отправителя. Это строковые литералы, используемые для отправки SMS-сообщения через API Twilio.

Функция отправки SMS в Twilio

Эта функция отвечает за отправку SMS с использованием API Twilio и клиентской библиотеки ESP-IDF HTTP. Функция twilio_send_sms() принимает в качестве параметра указатель типа void.

Объявляет символьный массив twilio_url размером 200 символов, который используется для хранения URL-адреса конечной точки API Twilio для отправки SMS-сообщений.

Формирует URL-адрес для конечной точки API Twilio путем объединения различных строковых литералов и значений переменных account_sid и auth_token. Результат сохраняется в массиве twilio_url.

Объявляет символьный массив post_data размером 200, который используется для хранения данных, которые будут отправлены на конечную точку API Twilio.

Эта функция формирует данные, которые будут отправлены на конечную точку API Twilio, путем конкатенации различных строковых литералов и значений переменных recipient_num, sender_num и message. Результат сохраняется в массиве post_data.

Объявляет структуру конфигурации типа esp_http_client_config_t и инициализирует её значениями переменной twilio_url, а также константами HTTP_METHOD_POST и HTTP_AUTH_TYPE_BASIC.

Вызовите функцию esp_http_client_init, передав ей указатель на структуру конфигурации, и сохраните полученный дескриптор клиента в переменной client.

Вызывает функцию esp_http_client_set_header, передавая ей дескриптор клиента и строковый литерал, для установки значения заголовка Content-Type для запроса.

Вызывает функции esp_http_client_set_username и esp_http_client_set_password, передавая им дескриптор клиента и значения переменных account_sid и auth_token соответственно, для установки учетных данных для базовой аутентификации.

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

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

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

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

Вкратце, эта функция отправляет SMS-сообщения, используя API Twilio и ESP32 ESP-IDF. Для связи с API Twilio и отправки сообщения используется протокол HTTP. Для аутентификации функция использует SID учетной записи и токен аутентификации из учетной записи Twilio. Номера телефонов получателя и отправителя передаются в качестве глобальных переменных, а тело сообщения — в качестве еще одной глобальной переменной.

Эта функция подготавливает URL-адрес и POST-данные, необходимые для HTTP-запроса. Она инициализирует HTTP-клиент, устанавливает заголовок и имя пользователя/пароль для аутентификации, задает в POST-поле тело сообщения, выполняет HTTP-запрос и проверяет статус ответа. Если код состояния равен 201, она регистрирует сообщение об успехе, в противном случае — сообщение об ошибке. Наконец, она очищает HTTP-клиент и удаляет задачу.

Основная функция приложения

Функция «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-флэш-памяти.

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

Если подключение к Wi-Fi установлено успешно, создается задача «twilio_send_sms», которая отправляет SMS с использованием API Twilio.

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

Демонстрация отправки SMS с помощью ESP-IDF и Twilio

В этом разделе мы рассмотрим демонстрацию отправки сообщений в 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” («Сообщение успешно отправлено»), как показано ниже.

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

Теперь вы можете посмотреть на своем смартфоне успешно отправленное с помощью Twilio SMS.

Демонстрация на смартфоне успешно отправленного с помощью Twilio SMS

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

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

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