Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Aligned columns on the serial monitor while keeping CSV on the SD card

Abierto Apto para principiantes
  • ¿Algo no está bien?
#8 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
76/100
Tipo de issue
Nueva funcionalidad
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
arduino, cpp
Área
embedded-iot

Línea de trabajo

Empieza en el código del logger, donde actualmente se envía el mismo String al archivo SD y a Serial; después inspecciona la interfaz Arduino Print y la condición existente para el eco serial. Añade el adaptador en ese punto del eco dejando sin cambios la escritura en el archivo, y verifica que los encabezados y los datos estén alineados en Serial mientras la tarjeta sigue recibiendo el CSV original.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

enhancement

Summary

Keep the SD card log as plain comma-separated values, but show the same lines on the serial monitor as aligned columns, so a person watching the logger can read them. Today the logger writes one String to both the file and Serial, which made alignment look hard. It is not: the alignment can be done on the byte stream on its way to Serial, with no change to the sensors, to getString(), or to what reaches the card.

Design

A small Print adapter sits in front of Serial. It passes bytes through, and at each comma pads the current field to a fixed column width. The file still receives the unmodified CSV.

class AlignedPrint : public Print {           // pads each comma-separated field to a column
    Print& _out; uint8_t _width, _col = 0;
  public:
    AlignedPrint(Print& out, uint8_t width = 24) : _out(out), _width(width) {}
    size_t write(uint8_t c) override {
        if (c == ',') { while (_col++ < _width) _out.write(' '); _col = 0; return 1; }
        if (c == '\n') { _col = 0; }
        else _col++;
        return _out.write(c);
    }
};

Use, in the logger, wherever a line is echoed today:

AlignedPrint monitor(Serial);
logFile.print(line);      // CSV to the card, unchanged
monitor.print(line);      // aligned columns on the serial monitor

The header line goes through the same adapter, so column names sit over their values provided the width covers the longest name (Pressure Atmos [mBar] is 21 characters, so a default of 24).

Cost

  • About twenty lines; a few hundred bytes of flash; two bytes of RAM.
  • The serial line is roughly twice as long as the CSV line: at 38400 baud a ten-field line takes ~60 ms instead of ~30 ms. Only the serial echo is affected; the SD path is untouched. It can sit behind the same condition that gates the serial echo now.
  • No coupling to the sensor libraries or to the NW-Device-Specification work; can land independently.

Choices made here

  • Fixed-width padding, not tab characters. Terminal tab stops are eight columns and a value such as 1013.25, already fills one, so tabs align unpredictably.
  • Left-aligned fields (pad after the value). Right-aligned numbers read slightly better but require holding each field back until its comma arrives: a ~24-byte buffer and about ten more lines. Start left-aligned; revisit if wanted.

Not in scope

Changing the CSV written to the card; changing any sensor library's getHeader()/getString() output.

🤖 Generated with Claude Code

Lenguaje dominante
C++
Estrellas
1
Forks
0
Sin PR fusionados en 30 d

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de NorthernWidget/Okapi_Library

Todos los issues de NorthernWidget/Okapi_Library

Issues similares

Más issues de C++

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.