# Olá, seja bem vindo

Nesse portal você vai encontrar toda documentação e caminhos necessários para que você possa aprender e desenvolver seus projetos utilizando nosso DevKit ESP32-C3 LoRaWAN. Nele, você vai encontrar: * Características * Hardware * Pinout * Requisitos para desenvolvimento * Comandos AT para comunicação com módulo LoRaWAN * Exemplos para Arduino e ESP-IDF * Material de Apoio * Projeto e Artigos * E nosso FAQ de Perguntas e Respostas # Características Características do DevKit LoRaWAN

* ESP32-C3 - Arquitetura RISC-V * Módulo LoRaWAN da SmartModular, já homologado na Anatel * Conector para antena externa * Led RGB * Botão multi uso * GPIO's para uso geral * Alimentação, Programação e Debug via USB * Barra de alimentação 3v3, 5v e GND * 4 Conectividades disponíveis * WiFi * Bluetooth * LoRa P2P * LoRaWAN ### Dimensões físicas da placa * Comprimento: 73mm * Largura: 28mm * Altura: 11mm ### Consumo teórico(deep-sleep) * ESP32-C3: 5uA * SmartModular: 5uA * SPX3819 LDO(regulador de tensão): 90uA **Total: 100uA** {% hint style="warning" %} Em breve traremos um conteúdo mais detalhado sobre o consumo de energia baseado em contextos de projetos reais. {% endhint %} # Hardware Hardware {% content-ref url="/pages/bHU9spQHP8IAkzyypB18" %} [ESP32-C3](/hardware/esp32-c3) {% endcontent-ref %} {% content-ref url="/pages/wgVPW8WgLMlE1dhFsWTP" %} [SMW SX1262M0](/hardware/smw-sx1262m0) {% endcontent-ref %} # DevKit Visão geral sobre o Devkit ESP32-C3 LoRawan {% hint style="info" %} **Em desenvolvimento** {% endhint %} ### Circuito eletrônico

DevKit ESP32-C3 LoRaWAN - Circuito eletrônico

# SMW SX1262M0 Visão geral sobre o módulo SMW SX1262M0 da Smart Modular O módulo Long-Range (LoRa®) é uma tecnologia sem fio capaz de transmitir e receber informação ponto-a-ponto por longas distancias com baixo consumo de energia usado em muitas redes de Internet das Coisas (IoT) em todo o mundo. A tecnologia LoRa® permite uma variedade de aplicações inteligentes IoT destinados a resolver desafios como gerenciamento de energia, controle de recursos naturais, controle de poluição, eficiência de infraestrutura, prevenção de desastres e muito mais, opera através de comandos AT enviados na porta serial (9600 bps).

### Principais Recursos e Benefícios * Modulação LoRa® * Frequência de operação. Faixas: 902~~907.4MHz e 915.2~~927.8MHz * 170 dB máximo link budget (SX1262) * Nível de Saída RF de +22 dBm * Baixa corrente RX de 4.6 mA * Taxa de bits programável até 62,5 kbps (LoRa®) * 128Kbytes de Memória Flash, 36Kbytes de SRAM * Corrente em repouso < 5µA * Arm Cortex M0 + núcleo até 64MHz * Rejeição de co-canal de 19 dB no modo LoRa® * 2 portas seriais * 6 GPIOs * Alta sensibilidade de até -148 dBm * 88 dB de bloqueio de imunidade a 1 MHz offset * Detecção Automática de Atividade de Canal com AFC ultra-rápido {% hint style="info" %} Fonte e Referência\ \ {% endhint %} # ESP32-C3 Visão geral sobre o módulo ESP32-C3 da Espressif

{% hint style="info" %} Confira mais detalhes no ESP32-C3 no site oficial da Espressif
{% endhint %} {% hint style="info" %} Confira no documento em anexo, o datasheet referente ao ESP32-C3 \ {% endhint %} # Pinout Mapeamento dos pinos ### Mapeamento gerais

DevKit	ESP32-C3	Função/Descrição
0	0	GPIO0, ADC1_CH0, XTAL_32K_P
1	1	GPIO1, ADC1_CH1, XTAL_32K_N
2	2	GPIO2 2, ADC1_CH2, FSPIQ
3	3	GPIO3, ADC1_CH3
4	4	GPIO4, ADC1_CH4, FSPIHD, MTMS
5	5	GPIO5, ADC2_CH0, FSPIWP, MTDI
8	8	GPIO8 2, RGB LED
9	9	GPIO9
10	10	GPIO10, FSPICS0
18	18	GPIO18, USB_D-
19	19	GPIO19, USB_D+
RX	21	GPIO21, U0TXD
TX	20	GPIO20, U0RXD
LORA RX	6	GPIO06
LORA TX	7	GPIO07

### Mapeamento dos periféricos

Identificador	GPIO	Descrição
LORA RX	7	Pino RX de comunicação com TX do Módulo LoRa
LORA TX	6	Pino TX de comunicação com RX do Módulo LoRa
PUSH BUTTON 1	9	Pino de comunicação com o botão
LED RGB	8	Pino de Comunicação com o LED RGB
PUSH BUTTON 2	-	Reset
GND	GND	Ground
3v3	3v3	3.3V power supply
5v	5v	5V power supply

# Requisitos Requisitos Para trabalhar com o DevKit LoRaWAN você vai precisar de: 1. DevKit 2. Cabo USB 3. Ambiente de programação * Arduino Core * Arduino IDE * VSCode + Platformio * ESP-IDF * VSCode * Eclipse * VSCode + Platformio 4. Conhecimento em programação {% hint style="warning" %} Observação {% endhint %} Caso você queira utilizar a conectividade LoRaWAN, você precisará obrigatoriamente de um Gateway LoRaWAN ou um plano de dados ativo da Rede ATC(American Tower) contratado previamente através de uma Operadora. Operadoras que comercializam conectividade no mercado: * KORE Wireless * NLT * TCTec * Algar Telecom # Comandos AT Compilado geral sobre os principais comandos AT de comunicação com o Módulo LoRa Segue em anexo a documentação de comandos AT completa que a Smart Modular disponibiliza. {% file src="/files/zMd1wC6rIoPf9C2TGNbK" %} SMART Modular Technologies - LoRa® AT Command Manual {% endfile %} {% content-ref url="/pages/34O66iQi33uNu5f8SRlm" %} [Exemplos](/comandos-at/exemplos) {% endcontent-ref %} # Exemplos Exemplos de comandos AT. Os exemplos mostrados abaixo, visam criar uma familiaridade do módulo juntamente com os principais comandos envolvidos durante uma operação na Rede LoRaWAN. ### 1 - Testando a comunicação com o módulo: Comando: ``` AT ``` Saída: ``` OK ``` ### 2 - Reiniciando o módulo: Comando: ``` ATZ ``` Saída: ``` MCU: TYPE-A ATtention command interface OTAA Mode enabled DevEui= E4:A0:32:9B:C0:0C:15:F5 JoinEui= 01:01:01:01:01:01:01:01 AppKey= 2B:7E:15:16:28:AE:D2:A6:AB:F7:15:88:09:CF:4F:3C ``` ### 3 - Restaurando o módulo para configurações de fábrica: Comando: ``` AT+DEFLT ``` Saída ``` E7:D8:3F:61:15:93:63:19OTAA Mode enabled DevEui= E4:A0:32:9B:C0:0C:15:F5 JoinEui= 01:01:01:01:01:01:01:01 AppKey= 2B:7E:15:16:28:AE:D2:A6:AB:F7:15:88:09:CF:4F:3C OK ``` ### 4 - Configurações iniciais do módulo: #### 4.1 - Definindo uma nova chave de segurança(App Key): Comando: ``` AT+APPKEY=2B:7E:15:16:28:AE:D2:A6:AB:F7:15:88:09:CF:4F:3C ``` Saída: ``` OK ``` ### 5 - Realizando JOIN na rede LoRaWAN #### 5.1 - Modo OTAA Comando: ``` AT+JOIN ``` Saída: ``` OK JOINED ``` {% hint style="info" %} Por padrão, o módulo LoRa já vem configurado em modo OTAA. {% endhint %} #### 5.2 Modo ABP * Trocando o modo de autenticação para ABP Comando: ``` AT+NJM=0 ``` Saída: ``` ABP Mode enabled DevEui= 00:05:16:80:00:11:55:5C DevAdd= 01F9B4E4 NwkSKey= 2B:7E:15:16:28:AE:D2:A6:AB:F7:15:88:09:CF:4F:3C AppSKey= 2B:7E:15:16:28:AE:D2:A6:AB:F7:15:88:09:CF:4F:3C OK ``` * Salvar as configurações Comando: ``` AT+SAVE ``` Saída: ``` OK ``` {% hint style="warning" %} Quando o dispositivo entra modo ABP, não é preciso efetuar o JOIN na rede. Caso você execute o comando **AT+JOIN**, perceberá que receberá o retorno **AT\_ERROR**. {% endhint %} Para finalizar, reinicie o módulo. ### 6 - Envio de Uplinks #### 6.1 - Payload plain text Comando: ``` AT+SEND=1:Hello ``` Saída: ``` OK ``` #### 6.2 - Payload binária Comando: ``` AT+SENDB=1:01 ``` Saída: ``` OK ``` ### 7 - Envio de Uplinks Confirmados #### 7.1 - Configurando Mensagem Confirmada Comando: ``` AT+CFM=1 ``` Saída: ``` OK ``` #### 7.2 - Enviando Uplink Comando: ``` AT+SENDB=1:01 ``` Saída: ``` OK Network Server "ack" an uplink data confirmed message transmission ``` ### 8 - Recebimento de Downlinks #### 8.1 - Sem Downlinks para serem recebidos: Comando: ``` AT+RECVB ``` Saída: ``` 0: OK ``` #### 9.1 - Com Downlinks para serem recebidos: Comando: ``` AT+RECVB ``` Saída: ``` 6:0102 OK ``` ### 10 - Dispositivo em Classe C: #### 10.1 - Alterando a classe do módulo para Class C: Comando: ``` AT+CLASS=C ``` Saída: ``` switch to class C done OK ``` #### 10.2 - Salvando as configurações: Comando: ``` AT+SAVE ``` Saída: ``` OK ``` #### 10.3 - Reiniciando o módulo Comando: ``` ATZ ``` #### 10.4 - Efetuando o Join na Rede: Comando: ``` AT+JOIN ``` Saída: ``` OK JOINED switch to class C done ``` ### 11 - Salvando configurações na memória do módulo Comando: ``` AT+SAVE ``` Saída: ``` OK ``` # Arduino Core Exemplos de utilização do DevKit com IDE do Arduino {% hint style="info" %} Em Desenvolvimento {% endhint %} 1. [Blink](/exemplos/arduino-core/blink) 2. [Serial Bridge](/exemplos/arduino-core/serial-bridge) 3. [Efetuando Join na Rede LoRaWAN - ABP](/exemplos/arduino-core/efetuando-join-abp) 4. [Efetuando Join na Rede LoRaWAN - OTAA](/exemplos/arduino-core/efetuando-join-otaa) 5. [Envio de Uplink na Rede LoRaWAN - ABP](/exemplos/arduino-core/envio-de-uplink-abp) 6. [Envio de Uplink na Rede LoRaWAN - OTAA](/exemplos/arduino-core/envio-de-uplink-otaa) 7. [Recebimento de Downlink da Rede LoRaWAN](/exemplos/arduino-core/recebimento-de-downlink) 8. [Enviando uplinks para TagoIO utilizando protocolo MQTT](/exemplos/arduino-core/tagoio-mqtt) 9. [Enviando uplinks para TagoIO utilizando protocolo HTTP](/exemplos/arduino-core/tagoio-http) # Blink Esse exemplo irá pegar o Led RGB conectado na GPIO8 e realizará um blink usando a própria biblioteca nativa que o Arduino Core/ESP-IDF disponibiliza. ### Dependências \- ### Exemplo {% embed url="" %} # Serial Bridge Esse exemplo irá montar uma ponte serial entre seu ESP32 e o Módulo LoRaWAN para que você possa abrir o monitor serial e enviar comandos AT diretamente. ### Dependências * [Software Serial](https://www.arduino.cc/reference/en/libraries/espsoftwareserial/) {% hint style="info" %} Ambas bibliotecas podem ser baixadas dentro da própria IDE através do gerenciador de bibliotecas. {% endhint %} ### Exemplo {% embed url="" %} # Efetuando JOIN - ABP Esse exemplo irá efetuar uma simples tentativa de JOIN na Rede LoRaWAN utilizando o método de autenticação ABP. ### Dependências * [SMW\_SX1262M0](https://github.com/RoboCore/RoboCore_SMW-SX1262M0) * [Software Serial](https://www.arduino.cc/reference/en/libraries/espsoftwareserial/) {% hint style="info" %} Ambas bibliotecas podem ser baixadas dentro da própria IDE através do gerenciador de bibliotecas. {% endhint %} ### Exemplo {% embed url="" %} # Efetuando JOIN - OTAA Esse exemplo irá efetuar uma simples tentativa de JOIN na Rede LoRaWAN utilizando o método de autenticação OTAA. ### Dependências * [SMW\_SX1262M0](https://github.com/RoboCore/RoboCore_SMW-SX1262M0) * [Software Serial](https://www.arduino.cc/reference/en/libraries/espsoftwareserial/) {% hint style="info" %} Ambas bibliotecas podem ser baixadas dentro da própria IDE através do gerenciador de bibliotecas. {% endhint %} ### Exemplo {% embed url="" %} # Envio de Uplink - ABP Esse exemplo irá efetuar o JOIN na Rede LoRaWAN utilizando autenticação ABP, e obtendo êxito, irá publicar uma mensagem a cada 15 segundos. Durante a tentativa de JOIN, o Led RGB piscará na cor vermelho. Caso obtenha êxito, o led piscará na cor azul. Com o sucesso da conexão, os Uplinks começarão a ser enviados, e durante este processo, o Led RGB piscará na cor Verde, sinalizando o início e o fim do envio. ### Dependências * [SMW\_SX1262M0](https://github.com/RoboCore/RoboCore_SMW-SX1262M0) * [Software Serial](https://www.arduino.cc/reference/en/libraries/espsoftwareserial/) {% hint style="info" %} Ambas bibliotecas podem ser baixadas dentro da própria IDE através do gerenciador de bibliotecas. {% endhint %} ### Exemplo {% embed url="" %} # Envio de Uplink - OTAA Esse exemplo irá efetuar o JOIN na Rede LoRaWAN utilizando autenticação OTAA, e obtendo êxito, irá publicar uma mensagem a cada 15 segundos. Durante a tentativa de JOIN, o Led RGB piscará na cor vermelho. Caso obtenha êxito, o led piscará na cor azul. Com o sucesso da conexão, os Uplinks começarão a ser enviados, e durante este processo, o Led RGB piscará na cor Verde, sinalizando o início e o fim do envio. ### Dependências * [SMW\_SX1262M0](https://github.com/RoboCore/RoboCore_SMW-SX1262M0) * [Software Serial](https://www.arduino.cc/reference/en/libraries/espsoftwareserial/) {% hint style="info" %} Ambas bibliotecas podem ser baixadas dentro da própria IDE através do gerenciador de bibliotecas. {% endhint %} ### Exemplo {% embed url="" %} # Recebimento de Downlink Esse exemplo irá efetuar o JOIN na Rede LoRaWAN, e obtendo êxito, irá publicar uma mensagem a cada 15 segundos e caso tenha um Downlink para ser recebido, será mostrado no monitor serial a payload juntamente com a porta. Durante a tentativa de JOIN, o Led RGB piscará na cor vermelho. Caso obtenha êxito, o led piscará na cor azul. Com o sucesso da conexão, os Uplinks começarão a ser enviados, e durante este processo, o Led RGB piscará na cor Verde, sinalizando o início e o fim do envio. Assim que o Uplink for enviado e tiver Downlinks para serem recebidos da Rede LoRaWAN, o Led RGB piscará na cor Azul, sinalizando o inicio e o final do recebimento da mensagem. ### Dependências * [SMW\_SX1262M0](https://github.com/RoboCore/RoboCore_SMW-SX1262M0) * [Software Serial](https://www.arduino.cc/reference/en/libraries/espsoftwareserial/) {% hint style="info" %} Ambas bibliotecas podem ser baixadas dentro da própria IDE através do gerenciador de bibliotecas. {% endhint %} ### Exemplo {% embed url="" %} # TagoIO + MQTT Neste exemplo, será enviado um Uplink a cada 10 segundos contendo temperatura, umidade e nível de bateria como payload para a Plataforma IoT TagoIO através do protocolo MQTT. ### Dependências * [PubSubClient](https://github.com/knolleary/pubsubclient) * [Arduino JSON](https://arduinojson.org/) {% hint style="info" %} Ambas bibliotecas podem ser baixadas dentro da própria IDE através do gerenciador de bibliotecas. {% endhint %} ### Exemplo {% embed url="" %} # TagoIO + HTTP Neste exemplo, será enviado um Uplink a cada 10 segundos contendo temperatura, umidade e nível de bateria como payload para a Plataforma IoT TagoIO através do protocolo HTTP. ### Dependências * [Arduino JSON](https://arduinojson.org/) {% hint style="info" %} Ambas bibliotecas podem ser baixadas dentro da própria IDE através do gerenciador de bibliotecas. {% endhint %} ### Exemplo {% embed url="" %} # ESP-IDF Exemplos de utilização do DevKit com ESP-IDF {% hint style="info" %} Em Desenvolvimento {% endhint %} 1. [Blink](/exemplos/esp-idf/blink) 2. [Teste de comunicação com o módulo LoRaWAN](/exemplos/esp-idf/teste-de-comunicacao) 3. [Efetuando Join na Rede LoRaWAN](/exemplos/esp-idf/efetuando-join-otaa) # Blink Esse exemplo irá pegar o Led RGB conectado na GPIO8 e realizará um blink usando a própria biblioteca nativa que o Arduino Core/ESP-IDF disponibiliza. {% embed url="" %} # Teste de comunicação Esse exemplo visa testar a comunicação do ESP32-C3 com o Módulo LoRaWAN através da comunicação serial. No exemplo é utilizado uma biblioteca chamada [**Modem**](https://github.com/TeschRenan/modem) que nosso querido amigo [Renan Tesch](https://github.com/TeschRenan) desenvolveu com o objetivo de abstrair a comunicação com Comandos AT. Além do teste de comunicação, também será mostrado no monitor serial o DeviceEUI seguido da Application Key do módulo. {% embed url="" %} {% embed url="" %} # Efetuando JOIN - OTAA Esse exemplo irá efetuar uma simples tentativa de JOIN na Rede LoRaWAN utilizando o método de autenticação OTAA. {% embed url="" %} # Material de Apoio ## 1 - Webinar: Desenvolvimento rápido de dispositivos IoT LoRaWAN® Esse Webinar faz uma breve apresentação da Empresa Smart Modular seguido de uma apresentação sobre o módulo LoRa/LoRaWAN desenvolvido pela empresa, e depois traz a abordagem no-code implementada nos módulos como também uma demonstração prática de utilização do produto. {% embed url="" %} ## 2 - Cartilha LoRa/LoRaWAN da Khomp "Esta cartilha tem o intuito instruir de forma simples e didática informações básicas referentes às tecnologias LoRa e LoRaWAN para facilitar o entendimento do escopo do processo de comunicação, fatores importantes para levar em consideração ao montar sua rede, nomes e expressões utilizados, entre outras informações." {% file src="/files/wdDYNjtKKvCg2ZJy7LG1" %} Cartilha LoRa/LoRaWAN da Khomp {% endfile %} ## 3 - Khomp Hour | Webinar IoT: Desmistificando o LoRa™ e LoRaWAN® - Componentes e Aplicações {% embed url="" %} ## 4 - Ebook: LoRa - LoRa LoRaWAN and IoT for beginners Ebook desenvolvido pela Université Savoie Mont Blanc, esse material trás um conteúdo amplo e muito completo sobre a modulação LoRa juntamente com o protocolo LoRaWAN. Ebook indicado para quem está iniciando com a tecnologia. {% file src="/files/ggR0g3OVzhwl33P8zc3V" %} LoRa - LoRa LoRaWAN and IoT for beginners {% endfile %} Link: ## 5 - Ebook: LoRaWAN for advanced users Ebook desenvolvido pela Université Savoie Mont Blanc, esse material trás um conteúdo mais avançado sobre o protocolo LoRaWAN. {% file src="/files/86dKvnxf2hP4cHBFYZr3" %} LoRaWAN for advanced users {% endfile %} Link: # Projetos Lista de projetos relacionados com o DevKit ESP32-C3 LoRaWAN ### 1 - Contador de pulsos LoRaWAN(ESP-IDF) - by Pedro Bertoleti

Contador de pulsos LoRaWAN - by Pedro Bertoleti — Contador de pulsos LoRaWAN (ESP-IDF)

O objetivo do projeto é efetuar a medição de água, gás ou energia através da leitura de pulsos originadas por 2 entrada de sensores, onde pode-se monitorar até dois equipamentos. * Hardware * DevKit ESP32-C3 LoRaWAN * Software * ESP-IDF 4.4 * VSCode ✔️ Autor: [Pedro Bertoleti](https://www.linkedin.com/in/ACoAAAUqiAcBR1sYIHs4qyP7lksr92iTnz19ng0) {% embed url="" %} ### 2- Contador de pulsos LoRaWAN(Zephyr) - by Pedro Bertoleti

O objetivo do projeto é efetuar a medição de água, gás ou energia através da leitura de pulso originada por 1 entrada de sensor, onde pode-se monitorar um determinado equipamento. * Hardware * DevKit ESP32-C3 LoRaWAN * Software * Zephyr * VSCode ✔️ Autor: [Pedro Bertoleti](https://www.linkedin.com/in/ACoAAAUqiAcBR1sYIHs4qyP7lksr92iTnz19ng0) {% embed url="" %} {% hint style="success" %} **Em desenvolvimento** {% endhint %} # Artigos Lista de artigos relacionados com o DevKit ESP32-C3 LoRaWAN {% hint style="info" %} **Em desenvolvimento** {% endhint %} # FAQ Perguntas e Respostas sobre o DevKit LoRaWAN

1 - O DevKit já vem com conectividade LoRaWAN ativa?

Não. Você precisa contratar previamente um plano de dados através de uma operadora que comercializa a conectividade. **Operadoras disponíveis:** * KORE Wireless * NLT * TCTec * Algar Telecom

2 - Se eu contratar o plano de alguma operadora citada acima, terei cobertura na minha cidade?

Depende. Hoje a American Tower tem cobertura em \~286 cidades, cobrindo boa parte do PIB Brasileiro. Se você tem dúvida a respeito da cobertura, o portal IoT Labs disponibiliza um Mapa e uma Tabela com todas as cidades que estão cobertas pela conectividade. [Confira aqui se a sua cidade possui cobertura LoRaWAN](https://iot-labs.io/rede-neutra-iot-lorawan-da-american-tower/#cobertura)

# Nossos canais Segue abaixo nossas redes sociais para quem deseja acompanhar nosso trabalho. ### Douglas Zuqueto * [Github](https://github.com/douglaszuqueto) * [LinkedIn](https://devkit-lorawan.douglaszuqueto.com/nossos-canais/www.linkedin.com/in/douglaszuqueto) * [Instagram](https://www.instagram.com/douglas_iot/) ### JVtech / João * [LinkedIn JVTech](https://www.linkedin.com/company/jvtech/about/) * [LinkedIn João](https://www.linkedin.com/in/jo%C3%A3o-alvares-07b881129/) * [Instagram](https://www.instagram.com/jvtech.br/) * [Site](https://jvtech.net.br/)