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"

É 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%ELT73A" & cd /d "%USERPROFILE%ELT73A"

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 :

code . --profile "ESP32IO"

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

ELT73A-S22-2026-2/labxy-grupo-a
  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

git add . && git commit -m "T1: exemplo — pisca o LED_BUILTIN" && git push

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-2026Ambiente de desenvolvimento VS Code; Uso do git e GitHub;
LAB02TPL0230-Mar-202606-Apr-2026Configuração do Ambiente ESP32 (Parte 02);
LAB03TPL0306-Apr-202613-Apr-2026Arquitetura de microcontroladores; Pinos de propósito geral (GPIO);
LAB04TPL0413-Apr-202620-Apr-2026Interrupções via GPIO e Temporizadores (Timers);
LAB05TPL0527-Apr-202604-May-2026Módulo PWM; Conversor ADC;
LAB06TPL0604-May-202611-May-2026Uso do STM32CubeMonitor; Visualização de variáveis;
LAB07TPL0711-May-202618-May-2026ADC com DMA; Uso do STM32CubeMonitor; Manipulação de variáveis;
LAB08TPL0818-May-202625-May-2026Uso do STM32CubeMonitor; MQTT, IoT;
LAB09TPL0925-May-202601-Jun-2026Uso do STM32CubeMonitor; SQLite;
LAB10TPL1001-Jun-202608-Jun-2026Introdução ao uso do PlatformIO;
LAB11TPL1108-Jun-202615-Jun-2026Introdução ao Display OLED SSD1306;
TarefaTemplateInícioFimConteúdo
LAB00TPL0016-Mar-202630-Mar-2026Apresentação da Disciplina; Materiais utilizados na disciplina;
LAB01TPL0123-Mar-202630-Mar-2026Ambiente de desenvolvimento VS Code; Uso do git e GitHub;
LAB02TPL0230-Mar-202606-Apr-2026Configuração do Ambiente ESP32 (Parte 02);
LAB03TPL0306-Apr-202613-Apr-2026Arquitetura de microcontroladores; Pinos de propósito geral (GPIO);
LAB04TPL0413-Apr-202620-Apr-2026Interrupções via GPIO e Temporizadores (Timers);
LAB05TPL0527-Apr-202604-May-2026Módulo PWM; Conversor ADC;
LAB06TPL0604-May-202611-May-2026Uso do STM32CubeMonitor; Visualização de variáveis;
LAB07TPL0711-May-202618-May-2026ADC com DMA; Uso do STM32CubeMonitor; Manipulação de variáveis;
LAB08TPL0818-May-202625-May-2026Uso do STM32CubeMonitor; MQTT, IoT;
LAB09TPL0925-May-202601-Jun-2026Uso do STM32CubeMonitor; SQLite;
LAB10TPL1001-Jun-202608-Jun-2026Introdução ao uso do PlatformIO;
LAB11TPL1108-Jun-202615-Jun-2026Introdução ao Display OLED SSD1306;

Teste Slidev 16/9​

Última atualização em por Adriano Ruseler