spi.h

Go to the documentation of this file.

#pragma once

 
 
#include "fl/stl/stdint.h"
#include "fl/stl/unique_ptr.h"
#include "fl/stl/span.h"
 
// SPI components
#include "fl/channels/spi/config.h"             // IWYU pragma: export
#include "fl/channels/spi/transaction.h"        // IWYU pragma: export
#include "fl/channels/spi/device.h"             // IWYU pragma: export
#include "fl/channels/spi/lane.h"               // IWYU pragma: export
#include "fl/channels/spi/write_result.h"       // IWYU pragma: export
#include "fl/channels/spi/multi_lane_device.h"  // IWYU pragma: export
// IWYU pragma: begin_keep
#include "platforms/shared/spi_types.h"  // ok platform headers
#include "fl/stl/noexcept.h"
// IWYU pragma: end_keep  // ok platform headers
 
namespace fl {
 
// ============================================================================
// Public API - Main SPI Device Class
// ============================================================================

class Spi {
public:
    Spi() FL_NO_EXCEPT : is_ok(false), error_code(SPIError::NOT_INITIALIZED) {}

    Spi(int clock_pin, fl::span<const int> data_pins,
        spi_output_mode_t output_mode = spi_output_mode_t::SPI_HW,
        u32 clock_speed_hz = 0xffffffff) FL_NO_EXCEPT;

    explicit Spi(const SpiConfig& config) FL_NO_EXCEPT;

    Spi(Spi&& other) FL_NO_EXCEPT;

    Spi& operator=(Spi&& other) FL_NO_EXCEPT;

    ~Spi() FL_NO_EXCEPT;

    bool ok() const FL_NO_EXCEPT { return is_ok; }

    SPIError error() const FL_NO_EXCEPT { return error_code; }

    explicit operator bool() const FL_NO_EXCEPT { return ok(); }

    template<typename... Spans>
    WriteResult write(Spans&&... lanes) FL_NO_EXCEPT {
        if (!device) {
            return WriteResult("SPI device not initialized");
        }
        return device->write(fl::forward<Spans>(lanes)...);
    }

    bool wait(u32 timeout_ms = 0xFFFFFFFF) FL_NO_EXCEPT;

    spi::MultiLaneDevice* get() FL_NO_EXCEPT { return device.get(); }
    const spi::MultiLaneDevice* get() const FL_NO_EXCEPT { return device.get(); }
 
private:
    fl::unique_ptr<spi::MultiLaneDevice> device;
    bool is_ok;
    SPIError error_code;
};
 
// ============================================================================
// Type Aliases
// ============================================================================
 
using SpiTransaction = spi::Transaction;
 
template<typename T = void>
using SpiResult = spi::Result<T>;
 
} // namespace fl