cstdio.cpp.hpp

Go to the documentation of this file.

#include "fl/stl/cstdio.h"
 
#include "fl/stl/stdint.h"
#include "fl/stl/compiler_control.h"
#include "fl/stl/strstream.h"  // For sstream
 
// Platform-specific I/O function declarations
// Each platform provides implementations in their .cpp.hpp files
#include "platforms/io.h"
#include "fl/stl/noexcept.h"
 
// Forward declare delay to avoid Arduino conflict
namespace fl {
    void delayMicroseconds(u32 us) FL_NO_EXCEPT;
    namespace detail {
        void delay_impl(u32 ms, bool run_async) FL_NO_EXCEPT;
    }
}
 
// =============================================================================
// Global Log Level Storage and API
// =============================================================================
 
namespace fl {
 
// Default log level is DEBUG (all logging enabled)
static u8 gLogLevel = static_cast<u8>(LogLevel::FL_LOG_LEVEL_DEBUG);
 
u8 getLogLevel() FL_NO_EXCEPT {
    return gLogLevel;
}
 
void setLogLevel(u8 level) FL_NO_EXCEPT {
    gLogLevel = level;
}
 
} // namespace fl
 
namespace fl {
 
// =============================================================================
// Print Functions
// =============================================================================
 
#ifdef FASTLED_TESTING
// Static storage for injected handlers using lazy initialization to avoid global constructors
static print_handler_t& get_print_handler() FL_NO_EXCEPT {
    static print_handler_t handler;
    return handler;
}
 
static println_handler_t& get_println_handler() FL_NO_EXCEPT {
    static println_handler_t handler;
    return handler;
}
 
static available_handler_t& get_available_handler() FL_NO_EXCEPT {
    static available_handler_t handler;
    return handler;
}
 
static read_handler_t& get_read_handler() FL_NO_EXCEPT {
    static read_handler_t handler;
    return handler;
}
 
static flush_handler_t& get_flush_handler() FL_NO_EXCEPT {
    static flush_handler_t handler;
    return handler;
}
 
static write_bytes_handler_t& get_write_bytes_handler() FL_NO_EXCEPT {
    static write_bytes_handler_t handler;
    return handler;
}
#endif
 
void print(const char* str) FL_NO_EXCEPT {
    if (!str) return;
    // Check global log level - if NONE, suppress all output
    if (gLogLevel == static_cast<u8>(LogLevel::FL_LOG_LEVEL_NONE)) return;
 
#ifdef FASTLED_TESTING
    // Check for injected handler first
    if (get_print_handler()) {
        get_print_handler()(str);
        return;
    }
#endif
 
    // Delegate to platform implementation
    platforms::print(str);
}
 
void println(const char* str) FL_NO_EXCEPT {
    if (!str) return;
    // Check global log level - if NONE, suppress all output
    if (gLogLevel == static_cast<u8>(LogLevel::FL_LOG_LEVEL_NONE)) return;
 
#ifdef FASTLED_TESTING
    // Check for injected handler first
    if (get_println_handler()) {
        get_println_handler()(str);
        return;
    }
#endif
 
    // Delegate to platform implementation
    platforms::println(str);
}
 
int available() FL_NO_EXCEPT {
#ifdef FASTLED_TESTING
    // Check for injected handler first
    if (get_available_handler()) {
        return get_available_handler()();
    }
#endif
 
    // Delegate to platform implementation
    return platforms::available();
}
 
int peek() FL_NO_EXCEPT {
    return platforms::peek();
}
 
int read() FL_NO_EXCEPT {
#ifdef FASTLED_TESTING
    // Check for injected handler first
    if (get_read_handler()) {
        return get_read_handler()();
    }
#endif
 
    // Delegate to platform implementation
    return platforms::read();
}
 
bool readStringUntil(sstream& out, char delimiter, char skipChar, fl::optional<u32> timeoutMs) FL_NO_EXCEPT {
    // Follows Arduino Serial.readStringUntil() API - blocks until delimiter found
    u32 startTime = fl::millis();
 
    // Read characters until we find delimiter or timeout
    while (true) {
        // Check timeout (only if timeout is set)
        if (timeoutMs.has_value()) {
            if (fl::millis() - startTime >= timeoutMs.value()) {
                // Timeout occurred
                return false;
            }
        }
 
        // Try to read next character
        int c = read();
 
        // Handle -1 (no data available) like Arduino's timedRead():
        // Keep trying until timeout (or forever if no timeout set)
        if (c == -1) {
            // Brief 1us yield to prevent busy loop without the 1ms
            // minimum sleep that fl::delay(1) imposes on FreeRTOS
            // (vTaskDelay(1) = 1 tick = 1ms). The 1ms delay was too
            // slow for USB CDC multi-packet assembly (64-byte packets).
            fl::delayMicroseconds(1);
            continue;
        }
 
        // Found delimiter - complete
        if (c == delimiter) {
            break;
        }
 
        // Skip specified character (e.g., '\r' for cross-platform line endings)
        if (c == skipChar) {
            continue;
        }
 
        // Valid character - add to output stream
        out << static_cast<char>(c);
    }
 
    // Successfully read until delimiter
    return true;
}
 
fl::optional<fl::string> readLine(char delimiter, char skipChar, fl::optional<u32> timeoutMs) FL_NO_EXCEPT {
    // Try platform-native line reading first (e.g., Arduino's Serial.readStringUntil).
    // This is critical for USB CDC platforms (ESP32-C6/S3) where the native
    // implementation uses yield() (immediate context switch) instead of
    // delay(1) (1ms FreeRTOS sleep), enabling correct multi-packet assembly.
    char nativeBuf[512];
    int nativeLen = platforms::readLineNative(delimiter, nativeBuf, sizeof(nativeBuf));
    if (nativeLen >= 0) {
        fl::string result(nativeBuf, nativeLen);
        return fl::string(result.trim());
    }
 
    // Fallback: character-by-character reading for non-Arduino platforms
    sstream buffer;
    if (!readStringUntil(buffer, delimiter, skipChar, timeoutMs)) {
        return fl::nullopt;  // Timeout occurred
    }
 
    // Convert to string and trim whitespace (trim() returns a new fl::string)
    fl::string result = buffer.str();
    return fl::string(result.trim());
}
 
bool flush(u32 timeoutMs) FL_NO_EXCEPT {
#ifdef FASTLED_TESTING
    if (get_flush_handler()) {
        return get_flush_handler()(timeoutMs);
    }
#endif
    return platforms::flush(timeoutMs);
}
 
size_t write_bytes(const u8* buffer, size_t size) FL_NO_EXCEPT {
    if (!buffer || size == 0) return 0;
#ifdef FASTLED_TESTING
    if (get_write_bytes_handler()) {
        return get_write_bytes_handler()(buffer, size);
    }
#endif
    return platforms::write_bytes(buffer, size);
}
 
#if !FL_SERIAL_BEGIN_INLINE
void serial_begin(u32 baudRate) FL_NO_EXCEPT {
    platforms::begin(baudRate);
}
#endif
 
bool serial_ready() FL_NO_EXCEPT {
    return platforms::serial_ready();
}
 
// =============================================================================
// Timing Functions
// =============================================================================
// Note: fl::millis() is provided by fl/stl/chrono.h
// Note: fl::delay() is provided by fl/system/delay.h
 
#ifdef FASTLED_TESTING
 
// Inject function handlers for testing
void inject_print_handler(const print_handler_t& handler) FL_NO_EXCEPT {
    get_print_handler() = handler;
}
 
void inject_println_handler(const println_handler_t& handler) FL_NO_EXCEPT {
    get_println_handler() = handler;
}
 
void inject_available_handler(const available_handler_t& handler) FL_NO_EXCEPT {
    get_available_handler() = handler;
}
 
void inject_read_handler(const read_handler_t& handler) FL_NO_EXCEPT {
    get_read_handler() = handler;
}
 
void inject_flush_handler(const flush_handler_t& handler) FL_NO_EXCEPT {
    get_flush_handler() = handler;
}
 
void inject_write_bytes_handler(const write_bytes_handler_t& handler) FL_NO_EXCEPT {
    get_write_bytes_handler() = handler;
}
 
// Clear all injected handlers (restores default behavior)
void clear_io_handlers() FL_NO_EXCEPT {
    get_print_handler() = print_handler_t{};
    get_println_handler() = println_handler_t{};
    get_available_handler() = available_handler_t{};
    get_read_handler() = read_handler_t{};
    get_flush_handler() = flush_handler_t{};
    get_write_bytes_handler() = write_bytes_handler_t{};
}
 
// Clear individual handlers
void clear_print_handler() FL_NO_EXCEPT {
    get_print_handler() = print_handler_t{};
}
 
void clear_println_handler() FL_NO_EXCEPT {
    get_println_handler() = println_handler_t{};
}
 
void clear_available_handler() FL_NO_EXCEPT {
    get_available_handler() = available_handler_t{};
}
 
void clear_read_handler() FL_NO_EXCEPT {
    get_read_handler() = read_handler_t{};
}
 
void clear_flush_handler() FL_NO_EXCEPT {
    get_flush_handler() = flush_handler_t{};
}
 
void clear_write_bytes_handler() FL_NO_EXCEPT {
    get_write_bytes_handler() = write_bytes_handler_t{};
}
 
// Force early initialization of function-level statics to avoid
// static initialization order issues on macOS. The fl::function
// objects may allocate memory during construction, and if the first
// access happens during a memory allocation callback, we get recursion.
namespace cstdio_init {
    void init_io_handlers() FL_NO_EXCEPT {
        // Touch each handler to force initialization during static construction
        (void)get_print_handler();
        (void)get_println_handler();
        (void)get_available_handler();
        (void)get_read_handler();
        (void)get_flush_handler();
        (void)get_write_bytes_handler();
    }
}
 
FL_INIT(cstdio_init_wrapper, cstdio_init::init_io_handlers)
 
#endif // FASTLED_TESTING
 
} // namespace fl