PacketSerial is an industrial-grade library that facilitates packet-based serial communication (COBS, SLIP) for Arduino and other embedded platforms.

Version 2.2 is a major optimization following SIL-2 compliance principles: Zero-Heap, Zero-STL, and Deterministic Performance.

Esta biblioteca ha sido rediseñada siguiendo principios de ingeniería para sistemas críticos y de grado industrial:

• Prohibición de Asignación Dinámica: No se utiliza malloc, free, new, delete ni contenedores de la STL.
• Zero-STL: No depende de las cabeceras estándar de C++ (<cstdint>, <algorithm>, etc.), utilizando cabeceras de C estándar (<stdint.h>, <stddef.h>) para máxima portabilidad en entornos freestanding.
• Buffers Estáticos: Toda la memoria para RX/TX debe ser provista por el usuario, garantizando un uso de RAM conocido en tiempo de compilación.

• Algoritmos Optimizados: Uso de etl::algorithm (find, copy, for_each) con búsqueda acelerada de marcadores para el procesamiento de datos.
• Multi-Subscriber mediante etl::delegate: Soporte para múltiples controladores de paquetes registrados simultáneamente.
• Manejo de Errores con etl::expected: Gestión de errores tipada y robusta en toda la API interna.

• Polimorfismo en Tiempo de Compilación: Uso de CRTP (Curiously Recurring Template Pattern) y static_assert para validación de contratos en tiempo de compilación.
• Zero-Copy: Uso extensivo de etl::span para vistas de datos sin copias innecesarias.

#include <PacketSerial.h>
#include <Codecs/COBS.h>
#include <etl/array.h>

using namespace PacketSerial2;

// These buffers are allocated in RAM (not stack, not heap)
etl::array<uint8_t, 128> rxStorage;
etl::array<uint8_t, 256> workBuffer;

// v2.2: Support for Lock Policies and Watchdog Heartbeat
PacketSerial<COBS, NoCRC, NoLock, NoWatchdog> ps(rxStorage, workBuffer);

void onPacket(etl::span<const uint8_t> packet) {
    // Process your data safe view
}

void setup() {
    Serial.begin(115200);
    ps.setPacketHandler(etl::make_delegate(onPacket));
}

void loop() {
    ps.update(Serial);
}

• C++17 compatible compiler.
• Embedded Template Library (ETL): Must be installed in your environment.

• Getting Started
• Industrial Robustness (CRC & Errors)
• Unit Testing
• Changelog

The library includes a PC-based unit test suite located in the tests/ directory. It uses a hardware-agnostic approach to verify logic integrity.

To run the tests:

cd tests
make

Note: Requires ETL to be installed in your system include path.

MIT License. See LICENSE.md for details.