Pular para o conteúdo principal

Introdução

Ambiente de desenvolvimento​

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

Configure o git​

Configure o nome de usuário para todos os repositórios locais ligados às suas transações de commit:

git config --global user.name "Your Name"

Configure o email de usuário para todos os repositórios locais ligados às suas transações de commit:

git config --global user.email "you@example.com"

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"

É recomendado verificar se a instalação do seu Git não está realizando nenhuma transformação entre LFs e CRLFs.

git config --global core.autocrlf false

Configure o git para usar o Visual Studio Code como editor padrão para tarefas como escrever mensagens de commit ou rebases interativos

git config --global core.editor "code --wait"

Habilite a coloração automática da saída da linha de comando do Git:

git config --global color.ui auto

Configura o Git para usar main como o nome do branch padrão sempre que você inicializar um novo repositório localmente:

git config --global init.defaultBranch main

Liste as configurações aplicadas:

git config --list --show-origin

Status do git, gh e code:​

Versão do git e configurações:

git --version && git config --list --show-origin

Versão do GitHub CLI e status de login:

gh --version && gh auth status

Versão do Visual Studio Code e extensões instaladas:

code -v && code --list-extensions --profile "ESP32IO"

Logout​

Para o git "esquecer" suas informações salvas:

git credential-manager erase && cmdkey /list | findstr "github" && gh auth logout

Clone o repositório inicial do LABXY (Exemplo)​

Escolha o Grupo e entre com o comando abaixo para criar o repositório no GitHub:

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 laboratório:

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

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

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

Repositório do Grupo A para Laboratório XY:

  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
Avaliação por commits

Cada cartão Ponto de commit é uma tarefa: faça-a, copie o comando do cartão e rode. A mensagem começa com o código (T1:, T2:…) — é como a correção identifica sua entrega. Um commit por tarefa; pode refazer (vale o mais recente); e não esqueça o git push. Detalhes em Como funciona a avaliação.

Estrutura do Laboratório XY​

Estrutura organizacional dos repositórios
ELT73A-S22-2026-2
├── Times
│ ├── Grupo-A
│ ├── ...
│ ├── Grupo-P # (Professor)
│ └── Grupo-N # (Notas)
└── Repositórios
├── lab00-template
├── lab00-grupo-a
├── ...
├── lab00-grupo-p # (Professor)
└── lab00-grupo-n # (Notas)

Como funciona a avaliação​

Nesta disciplina, você entrega cada tarefa fazendo um commit. Ao longo das aulas, os cartões "Ponto de commit" mostram exatamente o que salvar e quando.

Como é um "Ponto de commit"​

Quando você conclui uma tarefa, encontra um cartão como este (numeração e pontos são ilustrativos):

Ponto de commit · T1 (5 pts) #

exemplo — pisca o LED_BUILTIN

1. Conferir os arquivos
git conferir
2. Commit T1 e push
git add . && git commit -m "T1: exemplo — pisca o LED_BUILTIN" && git push
3. Conferir o commit e o envio
git status -sb && git log -1 --stat --oneline

Só faça o commit se o passo 1 não mostrar ATENCAO (terminal fora da raiz do repositório). No passo 3, a primeira linha não pode ter [ahead (commit ainda não enviado).

Combined Example (Bash Command + Text Log Output)​

1. 1. Executar Comando de Inscrição:

Terminal 1 — escutar grupo-a
docker run --rm eclipse-mosquitto:2 mosquitto_sub -h broker.hivemq.com \
-t 'elt85b/lab06/grupo-a/#' -v | tee evidencias/t3-mqtt.txt

2. 2. Resultado Esporado em evidencias/t3-mqtt.txt:

evidencias/t3-mqtt.txt
elt85b/lab06/grupo-a/status online
elt85b/lab06/grupo-a/dht {"grupo":"a","seq":3,"t":24.5,"h":55.0,"uptime_ms":16288,"intervalo_s":5.0}
elt85b/lab06/grupo-a/oled {"linhas":["LAB06 grupo a","T: 24.5 C","UR: 55.0 %","seq 3 | 5 s","WiFi ok | MQTT ok"]}
elt85b/lab06/grupo-a/cmd/intervalo 10
elt85b/lab06/grupo-a/oled {"linhas":["LAB06 grupo a","T: 24.5 C","UR: 55.0 %","seq 3 | 10 s","WiFi ok | MQTT ok"]}
elt85b/lab06/grupo-a/dht {"grupo":"a","seq":4,"t":24.5,"h":55.0,"uptime_ms":26290,"intervalo_s":10.0}
elt85b/lab06/grupo-a/cmd/intervalo 1
elt85b/lab06/grupo-a/dht {"grupo":"a","seq":5,"t":24.5,"h":55.0,"uptime_ms":36290,"intervalo_s":10.0}

1. Script Paho-MQTT para elt85b - Grupo A:

mqtt_client_a.py
import paho.mqtt.client as mqtt

broker = "broker.hivemq.com"
topic = "elt85b/lab06/grupo-a/#"

def on_message(client, userdata, msg):
print(f"[{group.upper()}] {msg.topic}: {msg.payload.decode()}")

client = mqtt.Client(client_id="elt85b-grupo-a")
client.on_message = on_message
client.connect(broker, 1883)
client.subscribe(topic)
client.loop_forever()

Clique em Copiar no bloco de código do cartão e cole o comando no terminal, dentro da pasta do seu repositório. Feito isso, a tarefa está entregue.

Passo a passo​

  1. Faça a tarefa descrita logo antes do cartão.
  2. Copie o comando do cartão e rode no terminal. Ele é algo como:
    git add . && git commit -m "T1: ..." && git push
  3. Pronto — esse commit registra a tarefa T1. Siga para o próximo ponto.
A mensagem do commit é o que vale

A mensagem começa com o código da tarefa (T1:, T2:, …). É por ela que a correção automática identifica o que você entregou — não altere esse prefixo e use exatamente o que o cartão copia.

Regras que importam​

  • Um commit por tarefa, na ordem. Prefira commitar cada ponto separadamente.
  • Pode refazer: se melhorar uma tarefa, faça um novo commit com o mesmo código (T2: ...). Vale sempre o mais recente.
  • Não esqueça o git push — sem enviar, seu trabalho não chega para correção.
  • Uma tarefa sem commit correspondente vale zero.

Como a nota é calculada​

  • A cada push, uma correção automática avalia cada tarefa no estado do commit dela. Por isso tudo bem reescrever o mesmo arquivo entre as partes: cada Tn é avaliado no seu próprio ponto da história.
  • Cada tarefa verifica se o projeto compila e se cumpre os requisitos daquele ponto. A nota da tarefa é proporcional ao que passou.
  • A nota final é a soma dos pontos, normalizada de 0 a 10.

Dicas rápidas​

  • Compile/teste antes de commitar.
  • Use exatamente a mensagem do cartão (o botão de copiar já traz o código certo).
  • Fez os commits na ordem T1, T2, …? Ótimo — é assim que a numeração casa com a correção.

TarefaTemplateInícioFimConteúdo
LAB0020-08-202627-08-2026Apresentação da Disciplina; Formação dos grupos;
LAB0127-08-202603-09-2026Git, GitHub e VS Code;
LAB0203-09-202610-09-2026PlatformIO, Wokwi e Docker;
LAB0310-09-202617-09-2026logs no ESP32 e ambientes de build (debug × release);
LAB0417-09-202624-09-2026WiFi e MQTT no ESP32;
LAB0524-09-202601-10-2026DHT22, temporizador e MQTT com Node-RED;
LAB0601-10-202608-10-2026SSD1306, MQTT nos dois sentidos, SQLite e Dashboard;
LAB0708-10-202615-10-2026ADC, PWM, modos de operação e controle ON/OFF;
LAB0815-10-202622-10-2026Modbus, S7 e OPC-UA (conceitos iniciais);
LAB0922-10-202629-10-2026Modbus, S7 e OPC-UA a fundo: painel SCADA e controle pela rede;
LAB1029-10-202605-11-2026SCADA da câmara com FUXA;
LAB1129-10-202605-11-2026Testes, simulação e CI/CD do firmware;
LAB1229-10-202605-11-2026IA no desenvolvimento: agentes, MCP e revisão;
LAB1329-10-202605-11-2026Automação de processos com n8n: eventos, aprovações e agentes;

TarefaTemplateInícioFimConteúdo
LAB0020-08-202627-08-2026Apresentação da Disciplina; Formação dos grupos;
LAB0127-08-202603-09-2026Git, GitHub e VS Code;
LAB0203-09-202610-09-2026PlatformIO, Wokwi e Docker;
LAB0310-09-202617-09-2026logs no ESP32 e ambientes de build (debug × release);
LAB0417-09-202624-09-2026WiFi e MQTT no ESP32;
LAB0524-09-202601-10-2026DHT22, temporizador e MQTT com Node-RED;
LAB0601-10-202608-10-2026SSD1306, MQTT nos dois sentidos, SQLite e Dashboard;
LAB0708-10-202615-10-2026ADC, PWM, modos de operação e controle ON/OFF;
LAB0815-10-202622-10-2026Modbus, S7 e OPC-UA (conceitos iniciais);
LAB0922-10-202629-10-2026Modbus, S7 e OPC-UA a fundo: painel SCADA e controle pela rede;
LAB1029-10-202605-11-2026SCADA da câmara com FUXA;
LAB1129-10-202605-11-2026Testes, simulação e CI/CD do firmware;
LAB1229-10-202605-11-2026IA no desenvolvimento: agentes, MCP e revisão;
LAB1329-10-202605-11-2026Automação de processos com n8n: eventos, aprovações e agentes;

Teste Slidev 16/9​