serial.cpp.hpp

Go to the documentation of this file.

// Arduino-compatible Serial API implementation
 
#pragma once
 
#include "fl/system/serial.h"
#include "fl/stl/cstdio.h"
#include "fl/stl/charconv.h"
#include "fl/stl/cstring.h"
#include "fl/stl/chrono.h"
#include "fl/stl/noexcept.h"
 
namespace fl {
 
// ============================================================================
// SerialPort Implementation
// ============================================================================
 
void SerialPort::end() FL_NO_EXCEPT {
    // Most platforms don't need explicit end() call
    // Serial is always available for debugging
}
 
int SerialPort::available() FL_NO_EXCEPT {
    return fl::available();
}
 
int SerialPort::read() FL_NO_EXCEPT {
    return fl::read();
}
 
int SerialPort::peek() FL_NO_EXCEPT {
    return fl::peek();
}
 
size_t SerialPort::write(u8 byte) FL_NO_EXCEPT {
    char str[2] = {static_cast<char>(byte), '\0'};
    fl::print(str);
    return 1;
}
 
size_t SerialPort::write(const u8* buffer, size_t size) FL_NO_EXCEPT {
    return fl::write_bytes(buffer, size);
}
 
size_t SerialPort::print(const char* str) FL_NO_EXCEPT {
    if (!str) {
        return 0;
    }
 
    fl::print(str);
    return fl::strlen(str);
}
 
size_t SerialPort::print(int value) FL_NO_EXCEPT {
    char buffer[12];  // Enough for "-2147483648" + null
    fl::itoa(value, buffer, 10);  // Base 10
    return print(buffer);
}
 
size_t SerialPort::print(long value) FL_NO_EXCEPT {
    char buffer[21];  // Enough for 64-bit values
    fl::itoa64(value, buffer, 10);  // Base 10
    return print(buffer);
}
 
// Template implementation for unsigned multi-byte integers
// Handles both u32 and unsigned long, avoiding duplicate overloads on platforms where they're the same type
template<typename T>
inline typename fl::enable_if<fl::is_multi_byte_integer<T>::value &&
                          !fl::is_signed<T>::value,
                          size_t>::type
SerialPort::print(T value) FL_NO_EXCEPT {
    char buffer[21];  // Enough for 64-bit values
 
    // Use utoa64 for all types - it handles both 32-bit and 64-bit values
    // This avoids needing C++17 constexpr if
    fl::utoa64(static_cast<fl::u64>(value), buffer, 10);
 
    return print(buffer);
}
 
size_t SerialPort::println(const char* str) FL_NO_EXCEPT {
    if (!str) {
        return println();
    }
 
    fl::println(str);
    return fl::strlen(str) + 1;  // +1 for newline
}
 
size_t SerialPort::println() FL_NO_EXCEPT {
    fl::println("");
    return 1;  // Just the newline
}
 
size_t SerialPort::println(int value) FL_NO_EXCEPT {
    char buffer[12];
    fl::itoa(value, buffer, 10);
    return println(buffer);
}
 
size_t SerialPort::println(long value) FL_NO_EXCEPT {
    char buffer[21];
    fl::itoa64(value, buffer, 10);
    return println(buffer);
}
 
// Template implementation for unsigned multi-byte integers
// Handles both u32 and unsigned long, avoiding duplicate overloads on platforms where they're the same type
template<typename T>
inline typename fl::enable_if<fl::is_multi_byte_integer<T>::value &&
                          !fl::is_signed<T>::value,
                          size_t>::type
SerialPort::println(T value) FL_NO_EXCEPT {
    char buffer[21];  // Enough for 64-bit values
 
    // Use utoa64 for all types - it handles both 32-bit and 64-bit values
    // This avoids needing C++17 constexpr if
    fl::utoa64(static_cast<fl::u64>(value), buffer, 10);
 
    return println(buffer);
}
 
// Note: printf() is now implemented as an inline template in serial.h
 
bool SerialPort::flush(u32 timeoutMs) FL_NO_EXCEPT {
    return fl::flush(timeoutMs);
}
 
SerialPort::operator bool() const FL_NO_EXCEPT {
    return fl::serial_ready();
}
 
void SerialPort::setTimeout(u32 timeoutMs) FL_NO_EXCEPT {
    mTimeoutMs = timeoutMs;
}
 
fl::string SerialPort::readString() FL_NO_EXCEPT {
    fl::string result;
    u32 startTime = fl::millis();
 
    while (fl::millis() - startTime < mTimeoutMs) {
        if (available() > 0) {
            int c = read();
            if (c != -1) {
                result += static_cast<char>(c);
                startTime = fl::millis();  // Reset timeout on successful read
            }
        }
    }
 
    return result;
}
 
fl::string SerialPort::readStringUntil(char delimiter) FL_NO_EXCEPT {
    fl::string result;
    u32 startTime = fl::millis();
 
    while (fl::millis() - startTime < mTimeoutMs) {
        if (available() > 0) {
            int c = read();
            if (c == -1) {
                continue;  // No data
            }
            if (c == delimiter) {
                break;  // Found delimiter, stop reading
            }
            result += static_cast<char>(c);
            startTime = fl::millis();  // Reset timeout on successful read
        }
    }
 
    return result;
}
 
size_t SerialPort::readBytes(u8* buffer, size_t length) FL_NO_EXCEPT {
    if (!buffer || length == 0) {
        return 0;
    }
 
    size_t count = 0;
    u32 startTime = fl::millis();
 
    while (count < length && (fl::millis() - startTime < mTimeoutMs)) {
        if (available() > 0) {
            int c = read();
            if (c != -1) {
                buffer[count++] = static_cast<u8>(c);
                startTime = fl::millis();  // Reset timeout on successful read
            }
        }
    }
 
    return count;
}
 
size_t SerialPort::readBytesUntil(char delimiter, u8* buffer, size_t length) FL_NO_EXCEPT {
    if (!buffer || length == 0) {
        return 0;
    }
 
    size_t count = 0;
    u32 startTime = fl::millis();
 
    while (count < length && (fl::millis() - startTime < mTimeoutMs)) {
        if (available() > 0) {
            int c = read();
            if (c == -1) {
                continue;  // No data
            }
            if (c == delimiter) {
                break;  // Found delimiter, stop reading
            }
            buffer[count++] = static_cast<u8>(c);
            startTime = fl::millis();  // Reset timeout on successful read
        }
    }
 
    return count;
}
 
long SerialPort::parseInt() FL_NO_EXCEPT {
    bool negative = false;
    long value = 0;
    bool foundDigit = false;
    u32 startTime = fl::millis();
 
    // Skip non-numeric characters
    while (fl::millis() - startTime < mTimeoutMs) {
        if (available() > 0) {
            int c = peek();
            if (c == -1) {
                continue;
            }
 
            // Check for sign
            if (c == '-') {
                negative = true;
                read();  // Consume the sign
                break;
            } else if (c == '+') {
                read();  // Consume the sign
                break;
            } else if (c >= '0' && c <= '9') {
                break;  // Found a digit
            } else {
                read();  // Skip non-numeric character
                startTime = fl::millis();  // Reset timeout
            }
        }
    }
 
    // Parse digits
    startTime = fl::millis();
    while (fl::millis() - startTime < mTimeoutMs) {
        if (available() > 0) {
            int c = peek();
            if (c == -1) {
                continue;
            }
 
            if (c >= '0' && c <= '9') {
                value = value * 10 + (c - '0');
                read();  // Consume the digit
                foundDigit = true;
                startTime = fl::millis();  // Reset timeout
            } else {
                break;  // Non-digit, stop parsing
            }
        }
    }
 
    return foundDigit ? (negative ? -value : value) : 0;
}
 
float SerialPort::parseFloat() FL_NO_EXCEPT {
    bool negative = false;
    long intPart = 0;
    long fracPart = 0;
    int fracDigits = 0;
    bool foundDigit = false;
    bool inFraction = false;
    u32 startTime = fl::millis();
 
    // Skip non-numeric characters
    while (fl::millis() - startTime < mTimeoutMs) {
        if (available() > 0) {
            int c = peek();
            if (c == -1) {
                continue;
            }
 
            // Check for sign
            if (c == '-') {
                negative = true;
                read();  // Consume the sign
                break;
            } else if (c == '+') {
                read();  // Consume the sign
                break;
            } else if (c >= '0' && c <= '9') {
                break;  // Found a digit
            } else if (c == '.') {
                break;  // Found decimal point
            } else {
                read();  // Skip non-numeric character
                startTime = fl::millis();  // Reset timeout
            }
        }
    }
 
    // Parse digits (integer and fractional parts)
    startTime = fl::millis();
    while (fl::millis() - startTime < mTimeoutMs) {
        if (available() > 0) {
            int c = peek();
            if (c == -1) {
                continue;
            }
 
            if (c == '.' && !inFraction) {
                inFraction = true;
                read();  // Consume decimal point
                foundDigit = true;  // Decimal point counts as finding a number
                startTime = fl::millis();  // Reset timeout
            } else if (c >= '0' && c <= '9') {
                if (inFraction) {
                    fracPart = fracPart * 10 + (c - '0');
                    fracDigits++;
                } else {
                    intPart = intPart * 10 + (c - '0');
                }
                read();  // Consume the digit
                foundDigit = true;
                startTime = fl::millis();  // Reset timeout
            } else {
                break;  // Non-digit, stop parsing
            }
        }
    }
 
    if (!foundDigit) {
        return 0.0f;
    }
 
    // Calculate float value
    float value = static_cast<float>(intPart);
    if (fracDigits > 0) {
        float divisor = 1.0f;
        for (int i = 0; i < fracDigits; i++) {
            divisor *= 10.0f;
        }
        value += static_cast<float>(fracPart) / divisor;
    }
 
    return negative ? -value : value;
}
 
// ============================================================================
// Global Serial object
// ============================================================================
 
// Note: FL_MAYBE_UNUSED on extern declaration (in header) is enough
// Don't use it on definition or linker won't export the symbol
// FL_LINT_ALLOW_GLOBAL(public API surface — `fl::fl_serial` is the FastLED-side serial-port global, referenced by name from user code and from the platform serial glue. Same source-compat rationale as `fl::cout` / `fl::cin`.)
SerialPort fl_serial;
 
} // namespace fl