Pular para o conteúdo principal

Introdução

Projeto final​

O Projeto final tem os seguintes critérios de avaliação (Percentagem da nota):

  1. Conter um dispositivo de entrada e saída (Teclado, botão, sensor, OLED...) (10%);
  2. Utilizar um periférico dedicado ou rotina de interrupção (ADC, PWM, Timer...) (10%);
  3. Utilizar algum protocolo de comunicação (MQTT, OPCUA, ModBus...) (10%);
  4. Utilizar SQL via SQLite (5%);
  5. Simulação via Wokwi (5%);
  6. Ser feito em bancada, protótipo operacional (30%);
  7. Dashboard via Node-RED ou FUXA (15%);
  8. Documentação no GitHub (5%);
  9. Video de apresentação (10%);

Data limite de entrega: 17/12/2026

A partir dos requisitos a equipe tem liberdade para usar tantos componentes e técnicas quanto achar necessário.

Documente o projeto em um repositório no GitHub e elabore um video breve de apresentação;

Antes de começar

Confira o ambiente (faça a configuração uma vez por máquina; a verificação, a cada aula):

Verificação rápida das versões instaladas:

git -v & gh --version & code -v & py --version & pio --version & wokwi-cli -V & wsl --version & docker --version

Verificação rápida de autenticação e alias:

git config --get-regexp "^(user|alias)\." & gh auth status & code --list-extensions --profile "ESP32IO"

Adicionar o comando git conferir:

git config --global alias.conferir "!f() { r=$(pwd -W 2>/dev/null || pwd); echo raiz do repositorio: $r; test -z $GIT_PREFIX || echo ATENCAO: o terminal esta em $GIT_PREFIX, fora da raiz. Antes do git add, rode: cd /d $r; test $# -eq 0 && return; for a in $@; do if [ -e $a ]; then echo ok $a; else echo FALTA $a; fi; done; echo == mudancas desde o ultimo commit:; git status --short --ignored -- $@; }; f"

Configuração do ambiente de desenvolvimento​

O Git é a ferramenta de gerenciamento de código-fonte mais utilizada por desenvolvedores profissionais.

  • O Git é um sistema de controle de versão distribuído gratuito e de código aberto, projetado para lidar com tudo, desde projetos pequenos até muito grandes, com rapidez e eficiência.

    winget install --id Git.Git -e --source winget
  • Configurações do git:

    git config --list --show-origin

Clonar o repositório do grupo​

1. Crie e entre na pasta-mãe da disciplina:

mkdir "%USERPROFILE%\ELT85BN21" & cd /d "%USERPROFILE%\ELT85BN21"

2. Clone e entre no repositório do projeto final:

git clone https://github.com/ELT85B-N21-2026-2/projeto-grupo-a.git && cd projeto-grupo-a

3. Abra o conteúdo do repositório no perfil ESP32IO do VS Code e compile:

cd /d "%USERPROFILE%\ELT85BN21\projeto-grupo-a" && code . --profile "ESP32IO"

Repositório do Grupo A para Projeto Final:

  1. Copie o link do repositório acima.
  2. Abra a página de envio da atividade no Moodle (botão abaixo).
  3. Clique em Adicionar envio.
  4. Cole o link no campo Texto online.
  5. Clique em Salvar mudanças.
  6. Confira se o status mudou para Enviado para avaliação.
Abrir envio no Moodle

Suba o stack do projeto:​

Antes de começar

Precisa do Docker Desktop aberto (com pelo menos 4 GB de memória) e do Python 3. Os comandos são para o Prompt de Comando (cmd) do Windows.

docker desktop start

Disciplina: ELT85B - IoT Industrial (--disciplina elt85b).

Configuração do projeto final (--lab projeto): --sem-gitea--sem-microbin

  • Conta: projeto-a (usuário, tópicos MQTT projeto-a/#)
  • Gerador (%IOT_GEN%): %USERPROFILE%\ELT85BN21\projeto-grupo-a\docker\gen_iot_aluno.py
  • Pasta do LAB IoT (%IOT_DIR%): %USERPROFILE%\ELT85BN21\projeto-grupo-a\docker\projeto-a

1. Crie os atalhos (valem só nesta janela do cmd; abriu outra, rode de novo):

set "IOT_REPO=%USERPROFILE%\ELT85BN21\projeto-grupo-a"
set "IOT_GEN=%IOT_REPO%\docker\gen_iot_aluno.py"
set "IOT_DIR=%IOT_REPO%\docker\projeto-a"

2. Gere o LAB IoT do grupo em docker\projeto-a:

py "%IOT_GEN%" --disciplina elt85b --lab projeto --grupo a --sem-gitea --sem-microbin --saida "%IOT_DIR%"

3. Suba os containers (a primeira vez demora):

cd /d "%IOT_DIR%" && docker compose up -d --build

4. Listar e exibir o status dos containers:

docker compose ps

5. Veja suas credenciais:

cd /d "%IOT_DIR%" && chcp 65001 >nul && type credenciais.txt

6. Abra o portal:

start http://localhost/

7. Ao terminar, pare os containers de todos os projetos Docker Compose em execução (funciona em qualquer janela do cmd, sem os atalhos; os dados ficam; para voltar, use o passo 3 ou Subir de novo):

for /f "delims=" %i in ('docker compose ls -q') do docker compose -p %i down

Em um arquivo .cmd/.bat, troque %i por %%i. Para parar só este LAB IoT:

cd /d "%IOT_DIR%" && docker compose down

Se quiser, feche também o Docker Desktop para liberar a memória:

docker desktop stop
Endereços
Operações com Docker

Subir de novo (depois de reiniciar o PC ou de um down):

cd /d "%IOT_DIR%" && docker compose up -d

Parar (os dados ficam):

cd /d "%IOT_DIR%" && docker compose down

Reiniciar tudo:

cd /d "%IOT_DIR%" && docker compose restart

Ver erros do Node-RED (Ctrl+C para sair):

cd /d "%IOT_DIR%" && docker compose logs -f projeto-a-nodered

Mudou alguma opção? Gere de novo na mesma pasta e recrie (o Node-RED e o MQTT só leem login e senhas ao iniciar, por isso o restart):

py "%IOT_GEN%" --disciplina elt85b --lab projeto --grupo a --sem-gitea --sem-microbin --saida "%IOT_DIR%" && cd /d "%IOT_DIR%" && docker compose up -d --build --remove-orphans && docker compose restart projeto-a-nodered mosquitto

Atualizar as imagens:

cd /d "%IOT_DIR%" && docker compose pull && docker compose build --pull && docker compose up -d
Apagar tudo

Remove containers e volumes (Gitea, ntfy, MicroBin, MQTT). Os fluxos em data/ e as telas em fuxa/ ficam na pasta.

cd /d "%IOT_DIR%" && docker compose down -v

Para limpar também os fluxos e as telas, veja Limpar (voltar ao original).

Limpar (voltar ao original)

Tudo o que se faz no Node-RED (fluxos, credenciais dos nós, nós instalados pela paleta, bancos sqlite, projetos) fica em docker\projeto-a\data\projeto-a. O login e a senha ficam fora dela e não mudam com a limpeza. Os nós que já vêm na imagem (dashboard, modbus, opcua...) continuam lá.

Node-RED inteiro (como recém-gerado): apaga a pasta e o gerador a recria.

cd /d "%IOT_DIR%" && docker compose stop projeto-a-nodered && rmdir /s /q "data\projeto-a" && py "%IOT_GEN%" --disciplina elt85b --lab projeto --grupo a --sem-gitea --sem-microbin --saida "%IOT_DIR%" && cd /d "%IOT_DIR%" && docker compose up -d projeto-a-nodered

Só os fluxos (mantém os nós instalados e os bancos):

cd /d "%IOT_DIR%" && docker compose stop projeto-a-nodered && (del /q "data\projeto-a\flows.json" "data\projeto-a\flows_cred.json" "data\projeto-a\.flows*.backup" 2>nul & docker compose start projeto-a-nodered)

Só os nós instalados pela paleta (Manage palette):

cd /d "%IOT_DIR%" && docker compose stop projeto-a-nodered && (rmdir /s /q "data\projeto-a\node_modules" 2>nul & del /q "data\projeto-a\package.json" "data\projeto-a\package-lock.json" "data\projeto-a\.config.nodes.json" 2>nul & docker compose start projeto-a-nodered)

Voltar ao último commit do repositório do projeto: desfaz o que mudou em data\projeto-a desde então.

cd /d "%IOT_DIR%" && docker compose stop projeto-a-nodered && git checkout -- "data\projeto-a" && git clean -fdq "data\projeto-a" && docker compose start projeto-a-nodered

Guardar um ponto de partida e voltar a ele quando quiser (o nodered-limpo.zip fica na pasta do LAB IoT):

cd /d "%IOT_DIR%" && docker compose stop projeto-a-nodered && tar -a -cf nodered-limpo.zip "data\projeto-a" && docker compose start projeto-a-nodered

Restaurar:

cd /d "%IOT_DIR%" && docker compose stop projeto-a-nodered && rmdir /s /q "data\projeto-a" && tar -xf nodered-limpo.zip && docker compose start projeto-a-nodered

FUXA (telas e conexões; o login do grupo é recriado pelo gerador):

cd /d "%IOT_DIR%" && docker compose stop projeto-a-fuxa && rmdir /s /q "fuxa\projeto-a" && py "%IOT_GEN%" --disciplina elt85b --lab projeto --grupo a --sem-gitea --sem-microbin --saida "%IOT_DIR%" && cd /d "%IOT_DIR%" && docker compose up -d projeto-a-fuxa
Zerar o LAB IoT inteiro

Apaga containers, volumes, data\ e fuxa\. O .segredos.json fica: a senha continua a mesma.

cd /d "%IOT_DIR%" && docker compose down -v --remove-orphans && (rmdir /s /q data & rmdir /s /q fuxa) 2>nul

Gerar e subir de novo:

py "%IOT_GEN%" --disciplina elt85b --lab projeto --grupo a --sem-gitea --sem-microbin --saida "%IOT_DIR%" && cd /d "%IOT_DIR%" && docker compose up -d --build

Depois de limpar, o git status mostra os arquivos apagados: faça um commit (ex.: git commit -am "limpeza") ou deixe como está.