Telegram-бот на Arduino MKR WiFi 1010: стартовое руководство по IoT

Компоненты и материалы

О проекте

Проект демонстрирует интеграцию Arduino с Telegram Bot API. В основе — новая плата MKR WiFi 1010 с модулем ESP32. Это proof-of-concept: только плата и USB-кабель. Но потенциал огромен.

Что такое Telegram-бот?

Боты — это аккаунты Telegram, управляемые программой, а не человеком. Они могут обучать, играть, искать, рассылать, напоминать, подключать сервисы и передавать команды IoT-устройствам. В нашем случае — команды Arduino. Бот отвечает на сообщения и управляет встроенным LED. Представьте: реле на пинах вкл/выкл обогреватель или кондиционер со смартфона!

Шаг 1: Что нужно

• Arduino MKR WiFi 1010 (магазин Arduino)
• Arduino IDE 1.8.5+ (скачать)
• Micro-USB кабель
• Интернет (SSID и пароль WiFi, лучше домашний роутер)
• Telegram на смартфоне (есть версии для ПК/Веб)

Шаг 2: Установка IDE и плат

1. Скачайте и установите Arduino IDE 1.8.5+.
2. Запустите IDE → Tools → Board → Boards Manager.
3. Найдите Arduino SAMD Boards (включает MKR WiFi 1010), установите последнюю версию (ставит и драйверы).
4. Sketch → Include Library → Manage Libraries → найдите WiFiNINA, установите.
5. Подключите плату, дождитесь драйверов. В Tools → Board выберите MKR WiFi 1010.
6. Для проекта нужна библиотека ESP8266TelegramBot (Giancarlo Bacchio), немного адаптированная — она в папке скетча.
7. Выберите правильный COM-порт, проверьте Get Board Info.

Шаг 3: Создание бота в Telegram

1. В Telegram найдите @BotFather, начните чат.
2. Команда /start → помощь.
3. /newbot → введите имя (отображается в контактах).
4. Введите username (5–32 символа, латиница/цифры/подчёркивание, обязательно оканчивается на «bot», напр. my_dice_bot).
5. Получите TOKEN — длинная строка, ключ к API. Сохраните! (Потеряли? /token у BotFather выдаст новый.)
6. Опционально: /setuserpic (аватар), /setabouttext (о боте), /setdescription (описание в чате).

Шаг 4: Настройка, загрузка и тест скетча

1. Скачайте прикреплённый скетч MKR1010Bot_V1_02.zip, распакуйте без переименований.
2. Откройте вкладку arduino_secrets.h:
   • Впишите SSID и пароль WiFi.
   • Впишите имя, username и токен бота от BotFather.
3. Проверьте выбор платы (MKR WiFi 1010) и порт → компилируйте → загрузите.
4. Важно! Плата имеет нативный USB (как Leonardo). После включения код ждёт открытия Serial Monitor. Оставьте подключённым к ПК, откройте Serial Monitor (9600 бод). Arduino подключится к WiFi и начнёт поллинг Telegram.
5. В Telegram найдите бота по имени (не username), откройте чат. Отправьте /start — получите приветствие. Напишите help (без слеша) — список команд. Попробуйте все (вкл/выкл LED и др.).

Проблемы с сертификатами (SSL)

Если в логах «Bot not connected»:

1. Tools → WiFi101/WiFiNINA Firmware Updater.
2. Проверьте, что плата видна в списке портов.
3. Нажмите Open updater sketch → загрузите в плату.
4. В апдейтере выберите последнюю прошивку → Update firmware.
5. В разделе SSL certificates → Add domain → введите telegram.org:443 → OK.
6. Upload certificates to wifi module.
7. Снова загрузите скетч бота.

Шаг 5: Улучшения

• Новые команды: добавьте функции-обработчики, возвращающие статус пользователю.
• Ограничение доступа: у каждого пользователя есть уникальный user_id (видно в логах Serial). Добавьте фильтр: выполнять команды только от известных ID.
• Железо: к пинам I/O можно подключать датчики и реле. Внимание: плата 3.3 В! Используйте уровнепреобразователи где нужно. Подробнее: руководство по MKR WiFi 1010.

Код

Полный скетч в архиве MKR1010Bot_V1_02.zip (C/C++). Предпросмотр недоступен — скачайте и изучите.