fl::spi::ParallelDevice Class Reference

Detailed Description

Parallel GPIO SPI device (1-32 pins driven from single data stream)

Uses lookup table (LUT) to map byte values to GPIO pin states. Single data stream drives all pins simultaneously. Backend: SpiIsr* (ISR-driven) or SpiBlock* (bit-bang)

Architecture:

• Single data stream (byte sequence)
• 256-entry LUT maps each byte value → GPIO pin states
• Each data byte controls multiple GPIO pins via SET/CLEAR masks
• ISR mode: Timer-driven interrupts (async, ~1.6MHz → 800kHz SPI)
• Bit-bang mode: Main thread inline (blocking, higher potential speed)

Example:

ParallelDevice::Config config;
config.clock_pin = 18;
config.gpio_pins = {0,1,2,3,4,5,6,7};  // 8 parallel outputs
config.mode = SpiParallelMode::AUTO;
ParallelDevice spi(config);
spi.begin();
 
uint8_t data[] = {0xFF, 0x00, 0xAA};  // Same to all 8 pins
auto tx = spi.write(data, sizeof(data));
tx.wait();

Definition at line 65 of file parallel_device.h.

#include <parallel_device.h>

Collaboration diagram for fl::spi::ParallelDevice:

Classes
struct	Config
	Configuration for parallel GPIO SPI. More...
struct	Impl

Public Member Functions
	ParallelDevice (const Config &config) FL_NO_EXCEPT
	Construct parallel device.
	ParallelDevice (const ParallelDevice &) FL_NO_EXCEPT=delete
	ParallelDevice (ParallelDevice &&) FL_NO_EXCEPT=delete
	~ParallelDevice () FL_NO_EXCEPT
	Destructor - releases hardware resources.
fl::optional< fl::task::Error >	begin () FL_NO_EXCEPT
	Initialize hardware and setup LUT.
void	configureLUT (const u32 *set_masks, const u32 *clear_masks) FL_NO_EXCEPT
	Configure custom LUT (advanced)
void	end () FL_NO_EXCEPT
	Shutdown hardware and release resources.
const Config &	getConfig () const FL_NO_EXCEPT
	Get current configuration.
bool	isBusy () const FL_NO_EXCEPT
	Check if transmission is in progress.
bool	isReady () const FL_NO_EXCEPT
	Check if device is initialized.
ParallelDevice &	operator= (const ParallelDevice &) FL_NO_EXCEPT=delete
ParallelDevice &	operator= (ParallelDevice &&) FL_NO_EXCEPT=delete
bool	waitComplete (u32 timeout_ms=(fl::numeric_limits< u32 >::max)()) FL_NO_EXCEPT
	Wait for pending transmission to complete.
Result< Transaction >	write (const u8 *data, size_t size) FL_NO_EXCEPT
	Write data (single stream drives all pins via LUT)

Private Attributes
fl::unique_ptr< Impl >	pImpl

---

The documentation for this class was generated from the following files:

• fl/channels/spi/parallel_device.h
• fl/channels/spi/parallel_device.cpp.hpp