Como Integrar Arduino com Bots do Telegram

Nesse tutorial, vamos aprender como Integrar Arduino com Bots do Telegram feito em Python. Faremos uma simples implementação para controlar o LED que já vem no Arduíno com um simples bot do Telegram. Para o momento, vamos considerar que todos possuem os conhecimentos necessários:

• Python básico;
• Noções de POO;
• Arduino básico.

Configurando o ambiente

Inicialmente precisaremos instalar algumas bibliotecas no nosso ambiente. Primeiro, temos que instalar  python-telegram-bot (lib de comunicação com o Telegram):

pip install python-telegram-bot --upgrade

Caso você não tenha instalado o pip na sua distribuição, temos esses post que que mostra como instalar.

Instalando a PySerial (lib de comunicação com o Arduino):

pip install pyserial --upgrade

Precisamos baixar também a IDE do Arduino nesse link.

Mexendo com Arduino

Iremos criar um arquivo básico, onde o Arduino estará ouvindo na porta 9600 os comandos que serão enviados através do código python (pelo bot).

//arduino_python.ino
int led = 13;                       
void setup() {                         
    Serial.begin(9600);
    pinMode(led, OUTPUT);
}                                               
void loop() {
    char light = Serial.read();
    if(light == '0') {
        digitalWrite(led, false);
    }else if(light == '1') {
        digitalWrite(led, true);
    }
}

O código vai ascender a luz que está associada ao pino 13 da placa. Ao receber o zero ‘0’, a luz será apagada e, ao receber o ‘1’ a luz será acesa.

 # python_serial.py

from serial import Serial

serial_port = '/dev/ttyUSB0'
boud_rate = 9600

conn = Serial(serial_port, boud_rate)

def light_on():
    conn.write(b'1')

def light_off():
    conn.write(b'0')

Aqui criamos duas funções responsáveis por acender e apagar a luz com o comando que escreve na porta serial /dev/ttyUSB0 , em 9600 bits por segundos.

Arduino com Bots do Telegram

Agora vou introduzir um conceito novo para muitos de vocês, que é a programação de bots para Telegram. Um bot é um programa (script) desenvolvido para automatizar procedimentos geralmente repetitivos. A palavra ‘bot’ é um apelido para ‘robot’, robô em inglês.

Um bot para Telegram é algum serviço que fica online em um chat especifico. Neste caso, você pode fazer desde download de vídeos ou áudios de links do YouTube, até transições entre carteiras de criptomoedas.

Primeiro temos que iniciar uma conversa com o ‘pai dos bots’, o botfather. Para configurarmos um ‘domínio’ para nosso bot. Será com ele que pegaremos um username e definir algumas configurações iniciais como permissão para grupos e tipos de privacidade.

Após iniciar o botão para dar inicio à conversa com o bot, ele vai enviar uma mensagem com todos os comandos possíveis. Iremos utilizar o comando /newbot.

Essa é a conversa necessária para criar seu bot. Tudo ocorrendo bem, ao final do processo, ele te enviará um token, que será de suma importância quando formos desenvolver o bot (Não se preocupem, já revoquei o token do bot três vezes após esse print).

BOTando tudo junto

Agora vamos unir todas as partes que fizemos até agora. Primeiro temos que subir o código do Arduino (arduino_python.ino) para a plaquinha e abrir o ‘Serial Monitor’ (caso prefira, pode fechar a IDE e testar o código diretamente com python).

Vamos reutilizar o código para comunicação serial (python_serial.py).

# python_bot.py

from telegram.ext import (Updater, CommandHandler, MessageHandler, Filters)
import logging

from python_serial import (light_on, light_off)

logging.basicConfig(format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
                    level=logging.INFO)

logger = logging.getLogger(__name__)


def start(bot, update):
    update.message.reply_text('Bem vind@ ao bot do ArduinoDay!!')

def set_light_on(bot, update):
    light_on()
    update.message.reply_text('O led está ligado!')

def set_light_off(bot, update):
    light_off()
    update.message.reply_text('O led está desligado!')

def help(bot, update):
    update.message.reply_text('Comando ainda não implementado!')

def error(bot, update, error):
    logger.warning('Update "%s" caused error "%s"', update, error)

def main():
    updater = Updater("TOKEN")
    dp = updater.dispatcher
    dp.add_handler(CommandHandler("start", start))
    dp.add_handler(CommandHandler("help", help))
    dp.add_handler(CommandHandler("light_on", set_light_on))
    dp.add_handler(CommandHandler("light_off", set_light_off))
    dp.add_error_handler(error)
    updater.start_polling()
    updater.idle()

if __name__ == '__main__':
    main()

As funções que serão usadas como comandos terão que receber dois parâmetros: bot e update. O bot é para executar funções, como enviar mensagens, imagens, etc. Já o update é para capturar mensagens enviadas para o bot (suas atualizações).