Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/FrancoMartino/cod-es/llms.txt

Use this file to discover all available pages before exploring further.

Para usar este módulo, definí INCLUIR_SERIE antes de incluir Cod-ES.h.

Activación

#define INCLUIR_SERIE
#include <Cod-ES.h>

Objeto Serie

El módulo expone una instancia global llamada Serie (de la clase SerieClass). No es necesario crear instancias adicionales.

Constantes de formato

Estas constantes se usan en métodos de impresión para especificar la base numérica de salida.
ConstanteEquivalente ArduinoDescripción
SERIE_BINARIOSERIAL_BINARYFormato binario (base 2)
SERIE_OCTALSERIAL_OCTALFormato octal (base 8)
SERIE_DECIMALSERIAL_DECIMALFormato decimal (base 10)
SERIE_HEXADECIMALSERIAL_HEXFormato hexadecimal (base 16)

Métodos

Iniciar y terminar

Serie.iniciar
void
Inicia la comunicación serie a la velocidad especificada. Equivalente a Serial.begin().Parámetro: baudRate — velocidad en baudios (ej: 9600, 115200).
Serie.terminar
void
Finaliza la comunicación serie y libera el pin. Equivalente a Serial.end().

Verificar disponibilidad

Serie.disponible
int
Retorna la cantidad de bytes disponibles para leer en el búfer de entrada. Retorna 0 si no hay datos. Equivalente a Serial.available().
Serie.disponibleParaEscritura
int
Retorna la cantidad de bytes libres en el búfer de salida. Equivalente a Serial.availableForWrite().

Imprimir y escribir

Serie.imprimir
void
Imprime un valor por el puerto serie sin salto de línea al final. Acepta cualquier tipo: int, float, String, char, etc. Equivalente a Serial.print().Parámetro: valor — el valor a imprimir.
Serie.imprimirEnNuevaLinea
void
Imprime un valor por el puerto serie con salto de línea al final. Equivalente a Serial.println().Parámetro: valor — el valor a imprimir.
Serie.escribir
void
Envía datos crudos (bytes) al puerto serie. Equivalente a Serial.write().Parámetro: valor — byte o buffer de bytes a enviar.
Serie.vaciar
void
Espera a que todos los datos del búfer de salida sean enviados. Equivalente a Serial.flush().

Leer datos

Serie.leer
int
Lee y consume el próximo byte disponible. Retorna -1 si no hay datos. Equivalente a Serial.read().
Serie.espiar
int
Lee el próximo byte sin consumirlo del búfer. Equivalente a Serial.peek().
Serie.leerEntero
int
Espera y lee un número entero desde el puerto serie. Equivalente a Serial.parseInt().
Serie.leerFlotante
float
Espera y lee un número con decimales desde el puerto serie. Equivalente a Serial.parseFloat().
Serie.leerCadena
String
Lee caracteres hasta que se agota el tiempo de espera y los retorna como un String. Equivalente a Serial.readString().
Serie.leerCadenaHastaEncontrar
String
Lee caracteres hasta encontrar el carácter terminador y los retorna como un String. Equivalente a Serial.readStringUntil().Parámetro: terminador — carácter char que actúa como fin de lectura (ej: '\n').
Serie.leerBytes
size_t
Lee hasta longitud bytes y los almacena en buffer. Retorna la cantidad de bytes leídos. Equivalente a Serial.readBytes().Parámetros: buffer — arreglo char[] donde se almacenan los datos; longitud — cantidad máxima de bytes a leer.
Serie.leerBytesHastaEncontrar
size_t
Lee bytes hasta encontrar el carácter terminador y los almacena en buffer. Retorna la cantidad de bytes leídos. Equivalente a Serial.readBytesUntil().Parámetros: terminador — carácter de fin de lectura; buffer — arreglo char[] de destino; longitud — tamaño máximo del buffer.

Configuración de tiempo

Serie.establecerTiempoDeEspera
void
Define el tiempo máximo de espera (en milisegundos) para las operaciones de lectura. Por defecto es 1000 ms. Equivalente a Serial.setTimeout().Parámetro: timeout — tiempo de espera en milisegundos.

Ejemplo completo

#define INCLUIR_SERIE
#include <Cod-ES.h>

inicio
  Serie.iniciar(9600); // Iniciar la comunicación a 9600 baudios
  Serie.establecerTiempoDeEspera(2000); // Tiempo de espera: 2 segundos
  Serie.imprimirEnNuevaLinea("Listo. Enviá un número:");
fin

bucle
  si (Serie.disponible() > 0) {
    entero valor = Serie.leerEntero(); // Leer un número entero
    Serie.imprimir("Recibí: ");
    Serie.imprimir(valor, SERIE_DECIMAL);
    Serie.imprimir(" | Hex: ");
    Serie.imprimir(valor, SERIE_HEXADECIMAL);
    Serie.imprimir(" | Bin: ");
    Serie.imprimirEnNuevaLinea(valor, SERIE_BINARIO);
  }
fin
Podés combinar INCLUIR_SERIE con otros módulos en el mismo programa. Simplemente agregá todos los #define necesarios antes de #include <Cod-ES.h>.

Build docs developers (and LLMs) love