PBL-Grupo6

Este repositório contém toda a aplicação relacionada ao projeto de PBL (Projeto Baseado em Problemas) do 6º Grupo, do 5º período do primeiro semestre de 2024 da Faculdade Engenheiro Salvador Arena.

Índice

1. Visão Geral do Projeto e Objetivos
2. Funcionalidades da Interface Web
3. Estrutura do Repositório
4. Como Usar
   • Requisitos
   1. Clonando o Repositório
   2. Configurando o Docker
   3. Subindo os Contêineres
   4. Configurando o Postman
   5. Provisionando os Recursos do Fiware
   6. Configurando o Sketch e a Arduino IDE
   7. Compilando Para o ESP32
   8. Configurando o Hotspot
5. Contribuições
6. Licença

Visão Geral do Projeto e Objetivos

Este é um projeto integrado que utiliza um sistema de controle e monitoramento de IoT para estufas de secagem de motores elétricos, a fim de assegurar os valores de temperatura e realizar um monitoramento em tempo real, otimizando o processo de fabricação e resultando em alta qualidade dos produtos. Por meio deste programa, é possível realizar a consulta e apuração dos dados de temperatura captados pelos sistemas de controle IoT apresentados em gráficos.

O objetivo do projeto é obter os dados de um kit de temperatura por meio da tensão de saída, que é lida pela porta analógica do ESP32. O ESP32 envia as informações via Wi-Fi para o Fiware, que se comunica com uma interface ASP.NET MVC, onde é possível gerir os dispositivos e acompanhar as informações via dashboard.

Funcionalidades da Interface Web

O programa desktop possui em sua tela inicial um sistema de exibição que apresenta um gráfico com os últimos 100 valores captados pelo sistema de controle IoT. Ao efetuar login no sistema, é possível registrar novos aparelhos conectados ao programa. Também conta com um sistema de gerenciamento de usuários e aparelhos, acessível e controlado apenas por usuários administradores.

Estrutura do Repositório

• Docker/: Configurações e scripts para configurar o ambiente Docker.
• Postman/: Coleções e ambientes para testes com Postman.
• Sketch/: Códigos e exemplos de sketch para o projeto.
• MVC/: Códigos da interface web.

Como Usar

Requisitos

Para executar o sistema, você precisará de:

• Docker e Docker Compose instalados em uma máquina ARM64/V8.
• Postman para realizar testes de API.
• Arduino IDE para programar o ESP32.
• Bibliotecas Arduino: PubSubClient e WiFiManager.

1 Clonando o Repositório

git clone https://github.com/FESA-EC5-S1-2024/PBL-Testes.git

2 Configurando o Docker

Edite o arquivo .env com as seguintes configurações:

• MONGO_USER: Usuário do MongoDB que será criado.
• MONGO_PWD: Senha do usuário do MongoDB.
• MSSQL_PWD: Senha do SQL Server (o usuário padrão é sa).
• Portas externas de cada componente do Fiware podem ser alteradas conforme necessário.

Para mais detalhes, você pode clicar no elemento Docker/ do tópico Estrutura do Repositório ou navegar até a respectiva pasta.

3 Subindo os Contêineres

docker-compose up -d

4 Configurando o Postman

Para o Postman, você pode clicar no elemento Postman/ do tópico Estrutura do Repositório ou navegar até a respectiva pasta. Dentro você encontrará a documentação específica deste elemento, a collection e os environment. O environment tem as portas padrão (as mesmas definidas no arquivo .env do Docker. Se alterar essas portas, também precisará atualizá-las).

• A propriedade host é onde o Fiware está rodando (servidor) e deve ser definida, pois vem zerada.

5 Provisionando os Recursos do Fiware

Após definir as variáveis no environment, devemos provisionar alguns recursos para que o ESP32 se comunique e interaja com o Fiware.

• Provisioning a Service Group for MQTT (tópico 2 na parte do "IOT AGENT MQTT").
• Provisioning a Temperature Sensor (tópico 3, também no "IOT AGENT MQTT").
• Subscribe Temperature (tópico 2 na parte do "STH-COMET").

Os outros itens são exemplos de requests que podemos fazer para os serviços do Fiware.

6 Configurando o Sketch e a Arduino IDE

Baixe e instale as seguintes bibliotecas na Arduino IDE:

• PubSubClient (versão testada v2.8)
• WiFiManager (versão testada v2.0.17)

Navegue até sketch/include e edite o arquivo config.hpp.

• Altere a definição de BROKER_MQTT para o endereço do seu broker MQTT.

7 Compilando Para o ESP32

Para compilar o código para a placa ESP32, estamos usando as seguintes configurações:

• Board: DOIT ESP32 DEVKIT V1.
• Upload Speed: 115200.
• Flash Frequency: 80MHz.
• Programador: Esptool.

8 Configurando o Hotspot

Depois de configurar o servidor para onde as informações serão enviadas, compilar o código para o ESP32 e montar o circuito disponível na documentação específica do ESP32 (clique no elemento Sketch/ do tópico Estrutura do Repositório ou navegue até a respectiva pasta).

Depois de ter feito tudo isso, com um celular ou computador, conecte-se na rede PBL-Grupo6 (caso não tenha mudado o nome). Dentro dessa rede, clique para fazer o login na rede. Com isso, deve aparecer uma interface. Dentro dessa interface, selecione a rede para a qual o ESP32 vai enviar as informações, escreva o SSID e a senha, e depois é só esperar que o ESP32 se conecte e comece a enviar as informações.

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.

Licença

Este projeto é licenciado sob a BSD 3-Clause License.