HOWTO · Arduino

Impresión serie Arduino de múltiples variables

Uno puede mostrar los valores de las variables en el monitor serial usando la función Serial.print() y Serial.println().

En esta página

Para mostrar varios valores de variables en el Monitor Serie de Arduino, inicializa la comunicación serie con Serial.begin() y envía cada valor con Serial.print() o Serial.println(). Las llamadas sucesivas a Serial.print() siguen escribiendo en la línea actual; Serial.println() termina de escribir el valor con un salto de línea. Añade texto entre los valores para que el resultado sea más fácil de leer. Configura el Monitor Serie con la misma velocidad en baudios que se usa en Serial.begin().

El ejemplo completo muestra valores separados en una misma línea, precisión de punto flotante, valores en líneas distintas y un par que cambia. Una pequeña capa de compatibilidad para el entorno anfitrión permite ejecutar el mismo código fuente como C++ estándar: en una placa Arduino, el núcleo de la placa proporciona Serial y delay(); en una computadora, esa capa escribe en la salida estándar y ejecuta dos iteraciones de muestra. Al usar una placa, configura el Monitor Serie con la misma velocidad en baudios que Serial.begin().

Imprimir varios valores en una línea con Serial.print()

Serial.print() convierte un valor en texto y lo escribe sin añadir un salto de línea. Llámala sucesivamente para cada campo e imprime un separador entre ellos. El ejemplo usa una tabulación ("\t") entre una lectura de temperatura y otra de humedad, por lo que la salida contiene un carácter de tabulación, no los dos caracteres visibles barra invertida y t.

Para los valores de punto flotante, el segundo argumento opcional especifica cuántos dígitos mostrar después del separador decimal. Aquí, Serial.print(temperature, 2) solicita dos cifras decimales. Esto cambia el formato mostrado, no el valor almacenado en la variable. Una llamada final a Serial.println() termina la fila con un salto de línea. El argumento opcional de precisión se aplica al formato de punto flotante; los valores enteros se imprimen como números enteros.

Imprimir valores en líneas distintas con Serial.println()

Usa Serial.println(value) cuando quieras que cada valor empiece en su propia línea. Escribe el valor y, a continuación, un salto de línea, de modo que las llamadas sucesivas formen una lista vertical. En el programa, cada etiqueta permanece junto a su valor porque se imprime con Serial.print() y el valor correspondiente con Serial.println().

Abre el Monitor Serie a 9600 baudios para que coincida con Serial.begin(9600). Si el monitor usa una velocidad distinta, los caracteres recibidos pueden verse distorsionados aunque el programa envíe los valores previstos. Cada llamada a Serial.println() escribe su valor seguido de un salto de línea, por lo que la siguiente llamada empieza una nueva fila.

Combinar ambas funciones para dar formato a valores que cambian

Para mostrar lecturas repetidas, usa Serial.print() para el primer valor y un separador, y luego Serial.println() para el último valor de la fila. El bucle imprime un par que cambia, con una tabulación entre los valores y un salto de línea después de cada par. Incrementa el valor de humedad antes de la siguiente iteración; el segundo valor siempre es cinco unidades mayor. En una placa, el bucle se repite y hace una breve pausa entre filas. La capa de compatibilidad del entorno anfitrión ejecuta dos iteraciones para que se aprecie el cambio en la salida. Las secciones anteriores sobre valores en una misma línea y en líneas distintas se refieren a este único ejemplo completo, que mantiene juntas las declaraciones de variables y la configuración de la comunicación serie.

Al adaptar el programa, mantén un orden de campos y un delimitador coherentes si otro programa va a procesar las filas; cambiar cualquiera de los dos puede afectarlo. La capa de compatibilidad del entorno anfitrión solo demuestra el formato; no emula una placa ni el Monitor Serie.

Ejecuta este ejemplo. La capa de compatibilidad del entorno anfitrión escribe en la salida estándar; en una placa, el núcleo de Arduino proporciona las mismas llamadas a Serial y el loop() repetitivo. Las etiquetas visibles del código y de la salida de ejemplo, como “Temperature” y “Humidity”, permanecen en inglés porque los bloques se conservan sin cambios.

#ifndef ARDUINO
#include <iostream>
class HostSerial {
public:
  void begin(unsigned long) {}
  void print(const char* value) { std::cout << value; }
  void print(int value) { std::cout << value; }
  void print(double value, int digits = 2) {
    std::cout.setf(std::ios::fixed);
    std::cout.precision(digits);
    std::cout << value;
    std::cout.unsetf(std::ios::fixed);
  }
  void println(const char* value) { print(value); std::cout << '\n'; }
  void println(int value) { print(value); std::cout << '\n'; }
  void println(double value, int digits = 2) { print(value, digits); std::cout << '\n'; }
};
HostSerial Serial;
void delay(unsigned long) {}
#endif

int humidity = 40;

void setup() {
  Serial.begin(9600);
}

void loop() {
  float temperature = 23.456;

  Serial.print("Temperature: ");
  Serial.print(temperature, 2);
  Serial.print("\t");
  Serial.print("Humidity: ");
  Serial.println(humidity);

  Serial.print("Temperature on its own line: ");
  Serial.println(temperature, 2);
  Serial.print("Humidity on its own line: ");
  Serial.println(humidity);

  int first = humidity;
  int second = humidity + 5;
  Serial.print(first);
  Serial.print("\t");
  Serial.println(second);

  humidity++;
  delay(1000);
}

#ifndef ARDUINO
int main() {
  setup();
  loop();
  loop();
}
#endif
Temperature: 23.46	Humidity: 40
Temperature on its own line: 23.46
Humidity on its own line: 40
40	45
Temperature: 23.46	Humidity: 41
Temperature on its own line: 23.46
Humidity on its own line: 41
41	46