Aulas e o jogo de aprendizado

Arquivos, CSV e JSON

Construa o computador de voo de um balão meteorológico: gravações seguras de arquivos, um sensor ao vivo registrado em CSV, configurações em JSON e um código que sobrevive a erros de disco.

O curso

Arquivos, CSV e JSON é um curso intermediário de Programação em sete aulas. Cada aula roda no Raspberry Pi Zero 2 W da galeria com um BME280 no I2C, o computador de voo do Skylark 3, um balão de alta altitude (um Zero voa porque pesa 11 gramas). O catálogo menciona um Pi 4; o único Pi da galeria com um BME280 é o Zero, então o curso roda nele. Cada passo é verificado de acordo com o que o Pi imprime.

  1. Lendo arquivos: with open, read, readlines e o \n escondido, um laço que pula linhas vazias e comentários, um interpretador de chave: valor que mantém os dois-pontos em 09:30, e os bytes por baixo com "rb".
  2. Escrevendo com segurança: "w", que apaga o arquivo, "a", que acrescenta, print(..., file=f), e um salvamento atômico com os.replace que preserva a última boa cópia mesmo com um apagão simulado.
  3. CSV de entrada e saída: um voo gravado lido com DictReader, pressão convertida em altitude (até 26 km, e a estratosfera esquentando), o BME280 ao vivo registrado com csv.writer, um cabeçalho escrito só uma vez, e vírgulas e aspas dentro dos valores.
  4. Config JSON: json.load, padrões preenchidos com dict e update, validação que relata todos os problemas de uma vez, salvamento atômico com indent e sort_keys, e o que o JSON muda no caminho (chaves numéricas voltam como strings).
  5. Caminhos e pastas: a pasta de trabalho /home/pi, pastas com data usando makedirs, nomes de log numerados que nunca sobrescrevem, pathlib e os.walk com tamanhos.
  6. Erros no disco: uma config faltando, uma config cortada no meio do salvamento e movida para .bad, FileExistsError e IsADirectoryError, linhas CSV ruins contadas com try, else e finally, e a família OSError por errno.
  7. Projeto: uma ferramenta de registro de sensor: a grande final.

O gran final

The project is the tool Skylark's team runs before launch, typed to in the Serial Monitor. It loads config.json over its defaults, makes its folder, and answers help, log N (N live readings into a new numbered CSV, one every interval_s seconds), list (each log with its rows and size) and summary (every log read back, bad rows skipped and counted, the result saved as summary.json atomically). The last step cools the BME280 to 2 C and the logger raises the alarm set in config.json. Then comes an honest datasheet note: a BME280 reads pressure only down to 300 hPa, about 9 km.

O que o motor do Pi faz de diferente

O Pi roda MicroPython 1.29 com uma biblioteca padrão no estilo do CPython:

  • Suas abas são escritas em /home/pi quando Rodar inicia. Os arquivos que um programa escreve duram até ele terminar; o próximo Rodar começa de novo das suas abas.
  • os, os.path, pathlib, glob, csv e json funcionam como no CPython. O modo de abertura "x" não existe, e a hora de modificação de um arquivo não muda quando você escreve nele.
  • Um literal de dict não consegue desempacotar outro dict ({**a, **b}), então os defaults são mesclados com dict(a) e update(b), que funciona em todo lugar.
  • O leitor de json aceita uma vírgula depois do último item, o que o CPython rejeita, e seus erros sempre dizem linha 1, coluna 1.
  • Um dict não mantém uma ordem própria, então as tabelas fazem loop com sorted(...) e DictWriter corrige a ordem das colunas com fieldnames.
  • str.zfill is missing; f"{n:03d}" pads numbers on both engines.