ESP8266 do Rui, em português

Tabela de conteúdos 1. Introdução 2. NodeMCU i. Gravar do Linux ii. Gravar do Windows 3. ESplorer 4. Comandos AT i. Referência 5. Tutoriais i. Twitter ii. Servidor web iii. Cliente-servidor iv. Home Automation Server 6. Comprando hardware 7. Mais fontes

2

ESP8266 do Rui, em português

O que é este livro? O principal crédito é dado a Rui Santos: Exposição, em português, do básico sobre o módulo wifi ESP8266; Tradução de conteúdo do site randomnerdtutorials.com, de Rui Santos; Obra derivada de outra sob a licença CC BY-NC-SA 3.0; Obra liberada sob a licença CC BY-NC-SA 4.0, por compatibilidade de licença. Alexandre Magno é apenas um tradutor e organizador. Este livro é basicamente a tradução reformatada e simplificada do site de Rui. Também são usadas outras referências, indiretamente.

ATENÇÃO! USE POR SUA PRÓPRIA CONTA E RISCO. Autor e tradutor não garantem que todas as informações encontradas aqui estejam corretas.

Introdução

3

ESP8266 do Rui, em português

NodeMCU É um firmware alternativo para o ESP8266 que embute no chip um framework para programação de controle mediante scripts Lua. Pode ser gravado por Arduino ou programador FTDI de 3.3 volts.

Esquema com programador FTDI

RX → TX TX → RX CH_PD → 3.3V GPIO 0 → GND VCC → 3.3V GND → GND

NodeMCU

4

ESP8266 do Rui, em português

Gravar o NodeMCU usando Windows O software gravador para Windows é um projeto no GitHub, com versões para 32 bits e 64 bits.

Talvez você precise realizar alguma configuração avançada. Mas, em geral, o uso do nodemcu-flasher é bem simples: basta pressionar o botão Flash e aguardar a conclusão (sinal verde).

Gravar do Windows

5

ESP8266 do Rui, em português

ESPlorer ‒ gerenciador para NodeMCU É como uma sofisticada interface gráfica Java para o Luatool. Possibilita o envio facilitado dos scripts LUA para o chip módulo ESP8266. Inclui LUA para NodeMCU e MicroPython. Suporta todos os comandos AT.

Sistemas operacionais suportados Windows (x86, x86-64) Linux (x86, x86-64, ARM soft & hard float) Solaris (x86, x86-64) Mac OS X (x86, x86-64, PPC, PPC64)

Lista de recursos Sintaxe colorida para LUA Sintaxe colorida para Python Temas para o editor de códigos: default , dark , Eclipse, IDEA, Visual Studio Desfazer/Refazer Auto-compleção de código ‒ Ctrl+Space Envio de dados ao ESP82266 com validação Exemplos de código Log detalhado E muito mais!

Instalação Atenção! Você precisará do Java (SE versão 7 ou superior). 1. 2. 3. 4.

Baixe o ESPlorer Descompacte o ZIP Acesse o diretório raiz Execute ESPlorer.jar

Envio de script LUA 1. 2. 3. 4. 5. 6. 7.

Conecte o programador FTDI ao computador Configure o baud raute para 9600 Selecione a porta do programador (COM3, por exemplo) Pressione Open/Close Selecione a aba NodeMCU+MicroPtyhon Copie seu script LUA dentro do ESPlorer Simplesmente clique o botão Send to ESP Você deverá ver uma mensagem " Posted Tweet "

Só é necessário atenção ao que está em vermelho na imagem a seguir:

ESplorer

6

ESP8266 do Rui, em português

ESplorer

7

ESP8266 do Rui, em português

Para usar ESP8266 com Arduino Controlando por comandos AT...

Certifique-se de ter um sketch em branco:

void setup() {} void loop() {}

Dica elétrica  No projeto final, não alimente o módulo com os 3.3 V do Arduino. Use uma fonte ou bateria, ou divida a tensão para do pino RX.

Para gravar firmware O circuito acima deverá ser mudado:

Comandos AT

GPIO 0

ser conectado a

GND

.

8

ESP8266 do Rui, em português

Referência de comando AT para o ESP8266

Referência

9

ESP8266 do Rui, em português

Sobre os "tutoriais" Este livro não reúne muitas instruções discursivas. Cada "tutorial" é na realidade um conjunto de notas rápidas estruturado, contendo imagens, esquemas e referências. O objetivo maior é aprender com a prática, quando o leitor deverá estar aplicando os conhecimentos teóricos que já possui, para manter o hardware intacto.

Conteúdo interessante, mas externo SP8266 + 2 relay module + usb charger , por pawelka  As simple as possible two channels switcher controlled from web

The Button - a WiFi connected push button

Tutoriais

10

ESP8266 do Rui, em português

Twitter a partir do ESP8266 A dica é usar o serviço gratuito IFTTT, um plataforma que viabiliza controle para uma variedade de serviços web e apps. Enviar uma requisição HTTP ao IFTTT pode significar disparar um gatinho para o envio de um e-mail ou a publicação de um tweet pré-configurados.

Criando a conta no IFTTT 1. Acesse ifttt.com 2. Clique o botão Sign Up no meio da página. 3. Preencha o(s) formulário(s) seguindo em frente

Configurando a ação ‒ exemplo Ou: criando o "recipiente". 1. Conecte sua conta ao Maker Channel  2. Conecte sua conta ao Twitter Channel  O resultado deverá ser uma tela assim:

Twitter

11

ESP8266 do Rui, em português

Você deverá preencher o recipiente com informações suas: 1. Digite "post_tweet"  para o nome do evento 2. Edite o texto desejado para o ESP8266 enviar como tweet  3. Pressione o botão "Add" 

Twitter

12

ESP8266 do Rui, em português

Chave secreta  Será necessária para a realização das requisições. 1. Acesse ifttt.com/maker 2. Copie a chave secreta e a guarde em local seguro No exemplo, a chave é: b6eDdHYblEv2Sy32qLwe

Twitter

13

ESP8266 do Rui, em português

A tela para o conhecimento da chave secreta é como na imagem abaixo:

Uso Substitua a chave secreta na URL de ação (requisição para o recipiente):   https://maker.ifttt.com/trigger/post_tweet/with/key/YOUR_API_KEY

Assim:   https://maker.ifttt.com/trigger/post_tweet/with/key/b6eDdHYblEv2Sy32qLwe

Teste

Twitter

14

ESP8266 do Rui, em português

Exemplo: código LUA ‒ versão 1 O módulo deverá estar com NodeMCU Use o ESPlorer para fazer a transferência do arquivo Não esqueça de editar a linha 5 com suas credenciais de rede Não esqueça de editar a linha 13 com sua chave secreta

-- Rui Santos -- Complete project details at http://randomnerdtutorials.com wifi.setmode(wifi.STATION) wifi.sta.config( "YOUR_NETWORK_NAME" ,"YOUR_NETWORK_PASSWORD" ) -- A simple http client conn = nil conn=net.createConnection(net.TCP,

0)

conn:on( "receive" , function (conn, payload) end) conn:connect( 80,"maker.ifttt.com" ) conn:on( "connection" , function (conn, payload) conn:send( "POST /trigger/post_tweet/with/key/YOUR_API_KEY HTTP/1.1\r\nHost: maker.ifttt.com\r\nConnection: keep-alive\r conn:close() print('Posted Tweet' )

Limitação: o Twiter não permite o envio de tweets repetidos.

Exemplo: código LUA ‒ versão 2 Lembre-se dos mesmo requisitos da versão 1

-- Rui Santos -- Complete project details at http://randomnerdtutorials.com wifi.setmode(wifi.STATION) wifi.sta.config( "YOUR_NETWORK_NAME" ,"YOUR_NETWORK_PASSWORD" )

Twitter

15

ESP8266 do Rui, em português

-- A simple http client conn = nil conn=net.createConnection(net.TCP,

0)

conn:on( "receive" , function (conn, payload) end) conn:connect( 80,"maker.ifttt.com" ) conn:on( "connection" , function (conn, payload) conn:send( "POST /trigger/post_tweet/with/key/YOUR_API_KEY HTTP/1.1\r\n" .. "Host: maker.ifttt.com\r\nConnection: close\r\nAccept: */*\r\nContent-Type: application/json\r\n"  .. "Content-Length:

17\r\n\r\n{\"value1\":true}\r\n" ) end)

conn:close() print('Posted Tweet' )

O parãmetro

value1

está sendo enviado com valor

IFTTT suporta até três parâmeteros:

Twitter

value1

,

value2

True

e

.

value3

. Eles servem customizar tweets e torná-los únicos.

16

ESP8266 do Rui, em português

Ligando LED por página web ESP8266 funciona como servidor web com controle sobre seus pinos GPIO.

Esquema 

Código do

init.lua

Não esquecer de editar as credenciais, logo no início.

Servidor web

17

ESP8266 do Rui, em português

wifi.setmode(wifi.STATION) wifi.sta.config( "YOUR_NETWORK_NAME" ,"YOUR_NETWORK_PASSWORD" ) print(wifi.sta.getip()) led1 = 3 led2 = 4 gpio.mode(led1, gpio.OUTPUT) gpio.mode(led2, gpio.OUTPUT) srv=net.createServer(net.TCP) srv:listen( 80,function (conn)  

conn:on("receive" , function (client,request) local buf = ""; local _, _, method, path, vars = string .find(request, "([A-Z]+) (.+)?(.+) HTTP" ); if(method == nil)then _, _, method, path = string.find(request, "([A-Z]+) (.+) HTTP" ); end local _GET = {} if (vars ~= nil)then for k, v in string.gmatch(vars, "(%w+)=(%w+)&*" ) do _GET[k] = v end end buf = buf.. "

ESP8266 Web Server

" ; buf = buf.. "

GPIO0 ON OFFGPIO2 ON OFF
 

client:send(buf);

 

client:close(); collectgarbage (); end)

end)

Acesso Durante a inicialização o endereço IP é informado no console.

Para mais informações, assista a vídeo no Youtube.

Servidor web

18

ESP8266 do Rui, em português

Comunicando dois ESP8266 O servidor é um ponto-de-acesso; o cliente é estação. Neste exemplo eles estabelecem uma comunicação sem fio o cliente diz "Olá!".

Esquema para comunicação serial

Código LUA do servidor Observar

SSID=test

e

Password=12345678

.

-- Rui Santos -- Complete project details at http://randomnerdtutorials.com -- ESP8266 Server

Cliente-servidor

19

ESP8266 do Rui, em português

print("ESP8266 Server" ) wifi.setmode(wifi.STATIONAP); wifi.ap.config({ssid= "test",pwd="12345678" }); print("Server IP Address:" ,wifi.ap.getip()) sv = net.createServer(net.TCP) sv:listen( 80, function (conn)  

conn:on("receive" , function (conn, receivedData) print("Received Data: "  .. receivedData) end) conn:on( "sent", function (conn) collectgarbage () end)

end)

O servidor fica continuamente esperando por conexões. Quando alguma é estabelecida com sucesso, ele recebe mensagem e a imprime no console de comunicação serial.

Código LUA do cliente -- Rui Santos -- Complete project details at http://randomnerdtutorials.com -- ESP8266 Client print("ESP8266 Client" ) wifi.sta.disconnect() wifi.setmode(wifi.STATION) wifi.sta.config( "test","12345678" ) -- connecting to server wifi.sta.connect() print("Looking for a connection" ) tmr.alarm( 1, 2000, 1, function () if(wifi.sta.getip()~= nil) then  

tmr.stop(1) print("Connected!" ) print("Client IP Address:" ,wifi.sta.getip())

 

cl=net.createConnection(net.TCP, 0)

 

cl:connect( 80,"192.168.4.1" )

 

tmr.alarm(2, 5000, 1, function () cl:send( "Hello World!" ) end) else print("Connecting..." ) end

end)

O cliente fica continuamente procurando pelo ponto-de-acesso. Quando o localiza, estabelece conexão e passa a enviar "Hello world!"   como mensagem a cada 5 segundos.

Demonstração

Cliente-servidor

20

ESP8266 do Rui, em português

À esquerda, a janela de output  do ESPlorer. À direita, um terminal de comunicação serial estabelecida com o PuTTY.

Cliente-servidor

21

ESP8266 do Rui, em português

Home Automation Server É um servidor de automação residencial feito especialmente para o ESP8266, pelo Random Nerd Tutorials, fonte deste conteúdo. É provável que o autor do software de serviço seja o prórpio Rui Santos! O sistema permite controlar os pinos GPIO de um módulo ESP8266 a partir de qualquer lugar do mundo, através da Internet.

Registro É gratuito e necessário. 1. Acesse app.homeautomationserver.com/register 2. Preencha todos os detalhes do cadastro e os submeta 3. Confirme: no e-mail, clique o link de confirmação

Contas criadas ainda com a versão antiga do serviço continuam a vigorar. Você pode resetar a senha, caso prefira.

Adição de dispositivo Logo que você entra no sistema...

Home Automation Server

22

ESP8266 do Rui, em português

Se é a primeira vez para aquele dispositivo, você precisará habilitá-lo ao servidor com um código auto-gerado:

Siga as instruções que aparecem após o clique no botão cinza: 1. Grave o firmware NodeMCU no ESP8266 2. Carregue nele o código que foi auto-gerado Para o teste, é sugerido que você experimente a seguinte montagem:

Home Automation Server

23

ESP8266 do Rui, em português

Teste

Home Automation Server

24

ESP8266 do Rui, em português

Note que há uma limitação no sistema: Os pinos GPIO do ESP8266 serão atualizados a cada 20 segundos. Respeite o limite de chamadas à API, para não sobrecarregar o servidor.

Home Automation Server

25

ESP8266 do Rui, em português

Coisas que você pode estar comprando ESP8266 (ESP-01) V090, o que tem dois LEDs próximo à antena

Protoboard Arduino Ou programador FTDI

Comprando hardware

26

ESP8266 do Rui, em português

Ou adaptador conversor USB to TTL CH340 , talvez a opção mais barata

Comprando hardware

27

ESP8266 do Rui, em português

Módulo relé 3.3 V Palavras-chave para sites como eBay: ESP8266, FT232RL

Comprando hardware

28

ESP8266 do Rui, em português

Mais fontes de aprendizado Algumas delas, gratuitas, já estão de alguma forma presentes aqui no livro.

Grátis Getting Started With The ESPlorer IDE, por Rui Santos

Pago Home Automation Using ESP8266 , por Rui Santos

Arduino e outros dispositivos Sempre conteúdos gratuitos e muito seletos. 21 Arduino Modules You Can Buy For Less Than $2 , por Rui Santos 5 Ways to Power Up your Arduino, por Rui Santos Arduino Starter Kit Manual, por Earthshine Electronics  A Complete Beginners Guide to the Arduino

Mais fontes

29