wave3.hpp

Go to the documentation of this file.

 
#pragma once
 
#include "fl/channels/wave3.h"
#include "fl/channels/detail/bit_spread_lut.hpp"
#include "fl/stl/compiler_control.h"
#include "fl/stl/isr/memcpy.h"
 
FL_OPTIMIZATION_LEVEL_O3_BEGIN
 
namespace fl {
 
namespace detail {
 
// ============================================================================
// Byte to Wave3Byte Conversion (Force Inline Helper)
// ============================================================================

FASTLED_FORCE_INLINE FL_IRAM FL_OPTIMIZE_FUNCTION
void wave3_convert_byte_to_wave3byte(u8 byte_value,
                                      const Wave3BitExpansionLut& lut,
                                      Wave3Byte* output) {
    // High nibble → 12 bits, low nibble → 12 bits, total 24 bits = 3 bytes
    u16 high_pattern = lut.lut[(byte_value >> 4) & 0xF];
    u16 low_pattern = lut.lut[byte_value & 0xF];
 
    // Pack 24 bits into 3 bytes (MSB first):
    // Byte 0: bits [23..16] = high_pattern[11..4]
    // Byte 1: bits [15..8]  = high_pattern[3..0] | low_pattern[11..8]
    // Byte 2: bits [7..0]   = low_pattern[7..0]
    output->data[0] = (u8)(high_pattern >> 4);
    output->data[1] = (u8)(((high_pattern & 0xF) << 4) | ((low_pattern >> 8) & 0xF));
    output->data[2] = (u8)(low_pattern & 0xFF);
}
 
// ============================================================================
// 2-Lane Transposition (Force Inline)
// ============================================================================

FASTLED_FORCE_INLINE FL_IRAM FL_OPTIMIZE_FUNCTION
void wave3_transpose_2(const Wave3Byte lane_waves[2],
                       u8 output[2 * sizeof(Wave3Byte)]) {
    // Wave3 produces 3 symbols per LED byte (one byte per symbol for each lane).
    // For 2 lanes: interleave bits from both lanes into 2 bytes per symbol.
    // Each symbol byte has 8 bits. With 2 lanes we produce 2 bytes per symbol
    // using the same bit-spreading as wave8_transpose_2.
 
    for (int symbol_idx = 0; symbol_idx < 3; symbol_idx++) {
        u8 l0 = lane_waves[0].data[symbol_idx];
        u8 l1 = lane_waves[1].data[symbol_idx];
 
        // Interleave bits: for each bit position, lane0 goes to odd bits, lane1 to even bits
        u16 interleaved = 0;
        for (int bit = 0; bit < 8; bit++) {
            u16 b0 = (l0 >> bit) & 1;
            u16 b1 = (l1 >> bit) & 1;
            interleaved |= (b1 << (bit * 2));       // even positions
            interleaved |= (b0 << (bit * 2 + 1));   // odd positions
        }
 
        output[symbol_idx * 2] = (u8)(interleaved >> 8);
        output[symbol_idx * 2 + 1] = (u8)(interleaved & 0xFF);
    }
}
 
// ============================================================================
// 4-Lane Transposition (Force Inline)
// ============================================================================

FASTLED_FORCE_INLINE FL_IRAM FL_OPTIMIZE_FUNCTION
void wave3_transpose_4(const Wave3Byte lane_waves[4],
                       u8 output[4 * sizeof(Wave3Byte)]) {
    for (int symbol_idx = 0; symbol_idx < 3; symbol_idx++) {
        u8 l0 = lane_waves[0].data[symbol_idx];
        u8 l1 = lane_waves[1].data[symbol_idx];
        u8 l2 = lane_waves[2].data[symbol_idx];
        u8 l3 = lane_waves[3].data[symbol_idx];
 
        // 4 output bytes per symbol (2 pulses per byte × 4 lanes)
        // Same bit layout as wave8_transpose_4
        output[symbol_idx * 4 + 0] =
            ((l3 >> 7) & 1) << 7 |
            ((l2 >> 7) & 1) << 6 |
            ((l1 >> 7) & 1) << 5 |
            ((l0 >> 7) & 1) << 4 |
            ((l3 >> 6) & 1) << 3 |
            ((l2 >> 6) & 1) << 2 |
            ((l1 >> 6) & 1) << 1 |
            ((l0 >> 6) & 1);
 
        output[symbol_idx * 4 + 1] =
            ((l3 >> 5) & 1) << 7 |
            ((l2 >> 5) & 1) << 6 |
            ((l1 >> 5) & 1) << 5 |
            ((l0 >> 5) & 1) << 4 |
            ((l3 >> 4) & 1) << 3 |
            ((l2 >> 4) & 1) << 2 |
            ((l1 >> 4) & 1) << 1 |
            ((l0 >> 4) & 1);
 
        output[symbol_idx * 4 + 2] =
            ((l3 >> 3) & 1) << 7 |
            ((l2 >> 3) & 1) << 6 |
            ((l1 >> 3) & 1) << 5 |
            ((l0 >> 3) & 1) << 4 |
            ((l3 >> 2) & 1) << 3 |
            ((l2 >> 2) & 1) << 2 |
            ((l1 >> 2) & 1) << 1 |
            ((l0 >> 2) & 1);
 
        output[symbol_idx * 4 + 3] =
            ((l3 >> 1) & 1) << 7 |
            ((l2 >> 1) & 1) << 6 |
            ((l1 >> 1) & 1) << 5 |
            ((l0 >> 1) & 1) << 4 |
            ((l3 >> 0) & 1) << 3 |
            ((l2 >> 0) & 1) << 2 |
            ((l1 >> 0) & 1) << 1 |
            ((l0 >> 0) & 1);
    }
}
 
// ============================================================================
// 8-Lane Transposition (Force Inline)
// ============================================================================

FASTLED_FORCE_INLINE FL_IRAM FL_OPTIMIZE_FUNCTION
void wave3_transpose_8(const Wave3Byte lane_waves[8],
                       u8 output[8 * sizeof(Wave3Byte)]) {
    for (int symbol_idx = 0; symbol_idx < 3; symbol_idx++) {
        u8 l[8];
        for (int lane = 0; lane < 8; lane++) {
            l[lane] = lane_waves[lane].data[symbol_idx];
        }
        spread_transpose8_symbol(l, output + symbol_idx * 8);
    }
}
 
// ============================================================================
// 16-Lane Transposition (Force Inline)
// ============================================================================

FASTLED_FORCE_INLINE FL_IRAM FL_OPTIMIZE_FUNCTION
void wave3_transpose_16(const Wave3Byte lane_waves[16],
                        u8 output[16 * sizeof(Wave3Byte)]) {
    for (int symbol_idx = 0; symbol_idx < 3; symbol_idx++) {
        u8 l[16];
        for (int lane = 0; lane < 16; lane++) {
            l[lane] = lane_waves[lane].data[symbol_idx];
        }
        spread_transpose16_symbol(l, output + symbol_idx * 16);
    }
}
 
} // namespace detail
 
// ============================================================================
// Public wave3() Function (Force Inline)
// ============================================================================

FASTLED_FORCE_INLINE FL_IRAM FL_OPTIMIZE_FUNCTION
void wave3(u8 lane,
           const Wave3BitExpansionLut& lut,
           u8 (&FL_RESTRICT_PARAM output)[sizeof(Wave3Byte)]) {
    Wave3Byte wave3_output;
    detail::wave3_convert_byte_to_wave3byte(lane, lut, &wave3_output);
    output[0] = wave3_output.data[0];
    output[1] = wave3_output.data[1];
    output[2] = wave3_output.data[2];
}
 
} // namespace fl
 
FL_OPTIMIZATION_LEVEL_O3_END