testRxChannel()

bool fl::validation::testRxChannel	(	fl::shared_ptr< fl::RxChannel >	rx_channel,
		int	pin_tx,
		int	pin_rx,
		u32	hz,
		size_t	buffer_size )

Test RX channel with manual GPIO toggle pattern.

Parameters

rx_channel	RX channel to test
pin_tx	GPIO pin to toggle
pin_rx	GPIO pin for RX
hz	Sampling frequency in Hz
buffer_size	Size of RX buffer in symbols

Returns

true if test passes, false otherwise

Note

Generates 10 fast toggles (100μs pulses = 5kHz square wave)

Uses fl::pin API for platform-independent pin control

Definition at line 16 of file rx_test.cpp.hpp.

                                     {
 
    FL_WARN("[RX TEST] Testing RX channel with manual GPIO toggle on PIN " << pin_tx);
 
    // Configure PIN_TX as output using fl::pin functions (temporarily take ownership from FastLED)
    fl::pinMode(pin_tx, fl::PinMode::Output);
    fl::digitalWrite(pin_tx, fl::PinValue::Low);  // Start LOW
 
    // Toggle parameters (generous timing works across all platforms)
    const int num_toggles = 16;
    const int toggle_delay_us = 1000;        // 1ms per toggle
    const u32 signal_range_max_ns = 2000000; // 2ms idle threshold
 
    // Initialize RX channel with signal range for fast GPIO toggles
    fl::RxChannelConfig rx_config(pin_rx);
    rx_config.edge_capacity = buffer_size;
    rx_config.hz = hz;
    rx_config.signal_range_min_ns = 100;    // min=100ns
    rx_config.signal_range_max_ns = signal_range_max_ns;
    rx_config.start_low = true;
 
    if (!rx_channel->begin(rx_config)) {
        FL_ERROR("[RX TEST]: Failed to begin RX channel");
        fl::pinMode(pin_tx, fl::PinMode::Input);  // Release pin
        return false;
    }
 
    fl::delayMicroseconds(50);  // Let RX stabilize
 
    // Generate toggle pattern: HIGH -> LOW -> HIGH -> LOW ...
    for (int i = 0; i < num_toggles; i++) {
        fl::digitalWrite(pin_tx, fl::PinValue::High);
        fl::delayMicroseconds(toggle_delay_us);
 
        fl::digitalWrite(pin_tx, fl::PinValue::Low);
        fl::delayMicroseconds(toggle_delay_us);
    }
 
    // Wait for RX to finish capturing (timeout = total toggle time + headroom)
    u32 timeout_ms = 100;  // 10 toggles * 200μs = 2ms, use 100ms for safety
    fl::RxWaitResult wait_result = rx_channel->wait(timeout_ms);
 
    // Release PIN_TX for FastLED use using fl::pin functions
    fl::pinMode(pin_tx, fl::PinMode::Input);
 
    // Check if we successfully captured data
    if (wait_result != fl::RxWaitResult::SUCCESS) {
        FL_ERROR("[RX TEST]: RX channel wait failed (result: " << (static_cast<int>(wait_result)) << ")");
        FL_ERROR("[RX TEST]: RX may not be working - check PIN_RX (" << pin_rx << ") and RMT peripheral");
        FL_ERROR("[RX TEST]: If using non-RMT TX, ensure physical jumper from PIN " << pin_tx << " to PIN " << pin_rx);
        return false;
    }
 
    // Verify actual edge capture (wait() can succeed on timeout with 0 edges)
    fl::FixedVector<fl::EdgeTime, 4> check_edges;
    check_edges.resize(4);
    size_t edge_count = rx_channel->getRawEdgeTimes(check_edges, 0);
    if (edge_count == 0) {
        FL_ERROR("[RX TEST]: wait() succeeded but 0 edges captured - DMA trigger may be misconfigured");
        FL_ERROR("[RX TEST]: Check DMAMUX source number for PIN_RX (" << pin_rx << ")");
        return false;
    }
 
    FL_WARN("[RX TEST] ✓ RX channel captured " << edge_count << " edges from " << num_toggles << " toggles");
    FL_WARN("[RX TEST] ✓ RX channel is functioning correctly");
 
    return true;
}

References fl::delayMicroseconds(), fl::digitalWrite(), fl::RxChannelConfig::edge_capacity, FL_ERROR, fl::FL_NO_EXCEPT, FL_WARN, fl::High, fl::RxChannelConfig::hz, fl::Input, fl::Low, fl::Output, fl::pinMode(), fl::FixedVector< T, N >::resize(), fl::RxChannelConfig::signal_range_max_ns, fl::RxChannelConfig::signal_range_min_ns, fl::RxChannelConfig::start_low, and fl::SUCCESS.

Here is the call graph for this function: