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%\ELT73AS22" & cd /d "%USERPROFILE%\ELT73AS22"

2. Clone e entre no repositório do laboratório:

git clone https://github.com/ELT73A-S22-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%\ELT73AS22\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).

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
LAB00TPL0016-Mar-202630-Mar-2026Apresentação da Disciplina; Materiais utilizados na disciplina;
LAB01TPL0123-Mar-202630-Mar-2026Git, GitHub e VS Code;
LAB02TPL0230-Mar-202606-Apr-2026PlatformIO, Wokwi e Docker;
LAB03TPL0306-Apr-202613-Apr-2026Logs no ESP32 e ambientes de build (debug vs release);
LAB04TPL0413-Apr-202620-Apr-2026Wi-Fi e MQTT no ESP32;
LAB05TPL0527-Apr-202604-May-2026DHT22, temporizador e MQTT com Node-RED;
LAB06TPL0604-May-202611-May-2026SSD1306, MQTT nos dois sentidos e dashboard;
LAB07TPL0711-May-202618-May-2026ADC, PWM, modos de operação e controle ON/OFF;
LAB08TPL0818-May-202625-May-2026Node-RED e SQLite: gravar, consultar e manter;
LAB09TPL0925-May-202601-Jun-2026Migração do Arduino para o ESP-IDF;
LAB10TPL1001-Jun-202608-Jun-2026Testes, simulação e CI/CD do firmware;
LAB11TPL1108-Jun-202615-Jun-2026Assembly do ESP32: ver, ler e medir;
LAB12TPL1208-Jun-202615-Jun-2026depuração com GDB no Wokwi for VS Code;

TarefaTemplateInícioFimConteúdo
LAB00TPL0016-Mar-202630-Mar-2026Apresentação da Disciplina; Materiais utilizados na disciplina;
LAB01TPL0123-Mar-202630-Mar-2026Git, GitHub e VS Code;
LAB02TPL0230-Mar-202606-Apr-2026PlatformIO, Wokwi e Docker;
LAB03TPL0306-Apr-202613-Apr-2026Logs no ESP32 e ambientes de build (debug vs release);
LAB04TPL0413-Apr-202620-Apr-2026Wi-Fi e MQTT no ESP32;
LAB05TPL0527-Apr-202604-May-2026DHT22, temporizador e MQTT com Node-RED;
LAB06TPL0604-May-202611-May-2026SSD1306, MQTT nos dois sentidos e dashboard;
LAB07TPL0711-May-202618-May-2026ADC, PWM, modos de operação e controle ON/OFF;
LAB08TPL0818-May-202625-May-2026Node-RED e SQLite: gravar, consultar e manter;
LAB09TPL0925-May-202601-Jun-2026Migração do Arduino para o ESP-IDF;
LAB10TPL1001-Jun-202608-Jun-2026Testes, simulação e CI/CD do firmware;
LAB11TPL1108-Jun-202615-Jun-2026Assembly do ESP32: ver, ler e medir;
LAB12TPL1208-Jun-202615-Jun-2026depuração com GDB no Wokwi for VS Code;

Teste Slidev 16/9​