#include "packed_matmul_cpu.h" #if defined(__x86_64__) || defined(_M_X64) #include #if defined(_MSC_VER) #include #else #include #endif #include #include #include #include #include #include #if defined(_MSC_VER) #define ORBITQUANT_TARGET_AVX2 #define ORBITQUANT_NOINLINE __declspec(noinline) #else #define ORBITQUANT_TARGET_AVX2 __attribute__((target("avx2,fma,f16c"))) #define ORBITQUANT_NOINLINE __attribute__((noinline)) #endif namespace orbitquant::cpu { namespace { ORBITQUANT_TARGET_AVX2 inline float horizontal_sum(__m256 value) { const __m128 halves = _mm_add_ps(_mm256_castps256_ps128(value), _mm256_extractf128_ps(value, 1)); const __m128 pairs = _mm_hadd_ps(halves, halves); return _mm_cvtss_f32(_mm_hadd_ps(pairs, pairs)); } ORBITQUANT_TARGET_AVX2 inline __m256 load_float8( void const *data, std::int64_t offset) { return _mm256_loadu_ps(static_cast(data) + offset); } ORBITQUANT_TARGET_AVX2 inline __m256 load_half8( void const *data, std::int64_t offset) { const auto *source = static_cast(data) + offset; const __m128i packed = _mm_loadu_si128(reinterpret_cast<__m128i const *>(source)); return _mm256_cvtph_ps(packed); } ORBITQUANT_TARGET_AVX2 inline __m256 load_bfloat8( void const *data, std::int64_t offset) { const auto *source = static_cast(data) + offset; const __m128i packed = _mm_loadu_si128(reinterpret_cast<__m128i const *>(source)); const __m256i widened = _mm256_cvtepu16_epi32(packed); return _mm256_castsi256_ps(_mm256_slli_epi32(widened, 16)); } template inline void store_value(void *data, std::int64_t offset, float value) { static_cast(data)[offset] = scalar_t(value); } template <> inline void store_value(void *data, std::int64_t offset, float value) { static_cast(data)[offset] = value; } template < typename scalar_t, __m256 (*load8)(void const *, std::int64_t), int row_tile> ORBITQUANT_TARGET_AVX2 inline void packed_matmul_avx2_w4_rows( PackedMatmulArgs const &args, std::uint8_t const *packed_row, std::int64_t out_col, std::int64_t row_start) { __m256 accumulators[row_tile]; #pragma clang loop unroll(full) for (int row = 0; row < row_tile; ++row) { accumulators[row] = _mm256_setzero_ps(); } const __m256 centroid_lut_low = _mm256_loadu_ps(args.centroids); const __m256 centroid_lut_high = _mm256_loadu_ps(args.centroids + 8); const __m128i nibble_mask = _mm_set1_epi8(15); const __m256i low_table_limit = _mm256_set1_epi32(7); std::int64_t k = 0; for (; k + 8 <= args.in_features; k += 8) { const std::int64_t byte_offset = k / 2; std::int32_t packed; std::memcpy(&packed, packed_row + byte_offset, sizeof(packed)); const __m128i bytes = _mm_cvtsi32_si128(packed); const __m128i low = _mm_and_si128(bytes, nibble_mask); const __m128i high = _mm_and_si128( _mm_srli_epi16(bytes, 4), nibble_mask); const __m256i indices = _mm256_cvtepu8_epi32(_mm_unpacklo_epi8(low, high)); const __m256 low_weights = _mm256_permutevar8x32_ps(centroid_lut_low, indices); const __m256 high_weights = _mm256_permutevar8x32_ps(centroid_lut_high, indices); const __m256 weight = _mm256_blendv_ps( low_weights, high_weights, _mm256_castsi256_ps(_mm256_cmpgt_epi32(indices, low_table_limit))); #pragma clang loop unroll(full) for (int row = 0; row < row_tile; ++row) { const std::int64_t input_offset = (row_start + row) * args.in_features + k; accumulators[row] = _mm256_fmadd_ps( load8(args.x, input_offset), weight, accumulators[row]); } } const float row_norm = args.row_norms[out_col]; #pragma clang loop unroll(full) for (int row = 0; row < row_tile; ++row) { const std::int64_t input_row_offset = (row_start + row) * args.in_features; float accumulator = horizontal_sum(accumulators[row]); for (std::int64_t tail = k; tail < args.in_features; ++tail) { const std::uint8_t packed = packed_row[tail / 2]; const std::uint8_t index = (tail & 1) == 0 ? packed & 15u : (packed >> 4) & 15u; if constexpr (std::is_same_v) { accumulator += static_cast(args.x)[input_row_offset + tail] * args.centroids[index]; } else { accumulator += static_cast( static_cast( args.x)[input_row_offset + tail]) * args.centroids[index]; } } accumulator *= row_norm; if (args.has_bias) { accumulator += args.bias[out_col]; } store_value( args.out, (row_start + row) * args.out_features + out_col, accumulator); } } template inline std::uint32_t unpack_index_generic( std::uint8_t const *packed_row, std::int64_t value_index) { const std::int64_t bit_start = value_index * Bits; const std::int64_t byte_index = bit_start >> 3; const unsigned bit_offset = static_cast(bit_start & 7); std::uint32_t raw = packed_row[byte_index]; if (bit_offset + static_cast(Bits) > 8) { raw |= static_cast(packed_row[byte_index + 1]) << 8; } return (raw >> bit_offset) & ((1u << Bits) - 1u); } // Each decoder turns 8 consecutive packed indices into 8 fp32 centroid // values. Rows are byte-aligned because dispatch requires in_features % 4 == 0. struct W2Avx2Decoder { static constexpr int kBits = 2; struct Tables { __m256 lut; }; ORBITQUANT_TARGET_AVX2 static inline Tables load_tables( float const *centroids) { const __m128 lut4 = _mm_loadu_ps(centroids); return Tables{_mm256_set_m128(lut4, lut4)}; } ORBITQUANT_TARGET_AVX2 static inline __m256 decode( std::uint8_t const *packed_row, std::int64_t k, Tables const &tables) { std::uint16_t packed_bits; std::memcpy(&packed_bits, packed_row + (k >> 2), sizeof(packed_bits)); const __m128i bytes = _mm_cvtsi32_si128(packed_bits); const __m128i replicated = _mm_shuffle_epi8( bytes, _mm_setr_epi8(0, 0, 0, 0, 1, 1, 1, 1, -1, -1, -1, -1, -1, -1, -1, -1)); const __m256i widened = _mm256_cvtepu8_epi32(replicated); const __m256i shifts = _mm256_setr_epi32(0, 2, 4, 6, 0, 2, 4, 6); const __m256i indices = _mm256_and_si256( _mm256_srlv_epi32(widened, shifts), _mm256_set1_epi32(3)); return _mm256_permutevar8x32_ps(tables.lut, indices); } }; struct W6Avx2Decoder { static constexpr int kBits = 6; struct Tables { float const *centroids; }; ORBITQUANT_TARGET_AVX2 static inline Tables load_tables( float const *centroids) { return Tables{centroids}; } ORBITQUANT_TARGET_AVX2 static inline __m256 decode( std::uint8_t const *packed_row, std::int64_t k, Tables const &tables) { std::uint64_t raw_bits = 0; std::memcpy(&raw_bits, packed_row + (k * 6 >> 3), 6); const __m128i raw = _mm_cvtsi64_si128(static_cast(raw_bits)); const __m128i windows = _mm_shuffle_epi8( raw, _mm_setr_epi8(0, 1, 0, 1, 1, 2, 2, 3, 3, 4, 3, 4, 4, 5, 5, 6)); const __m256i widened = _mm256_cvtepu16_epi32(windows); const __m256i shifts = _mm256_setr_epi32(0, 6, 4, 2, 0, 6, 4, 2); const __m256i indices = _mm256_and_si256( _mm256_srlv_epi32(widened, shifts), _mm256_set1_epi32(63)); return _mm256_i32gather_ps(tables.centroids, indices, 4); } }; template < typename scalar_t, __m256 (*load8)(void const *, std::int64_t), typename decoder_t, int row_tile> ORBITQUANT_TARGET_AVX2 inline void packed_matmul_avx2_lowbit_rows( PackedMatmulArgs const &args, std::uint8_t const *packed_row, std::int64_t out_col, std::int64_t row_start) { __m256 accumulators[row_tile]; #pragma clang loop unroll(full) for (int row = 0; row < row_tile; ++row) { accumulators[row] = _mm256_setzero_ps(); } const typename decoder_t::Tables tables = decoder_t::load_tables(args.centroids); std::int64_t k = 0; for (; k + 8 <= args.in_features; k += 8) { const __m256 weight = decoder_t::decode(packed_row, k, tables); #pragma clang loop unroll(full) for (int row = 0; row < row_tile; ++row) { const std::int64_t input_offset = (row_start + row) * args.in_features + k; accumulators[row] = _mm256_fmadd_ps( load8(args.x, input_offset), weight, accumulators[row]); } } const float row_norm = args.row_norms[out_col]; #pragma clang loop unroll(full) for (int row = 0; row < row_tile; ++row) { const std::int64_t input_row_offset = (row_start + row) * args.in_features; float accumulator = horizontal_sum(accumulators[row]); for (std::int64_t tail = k; tail < args.in_features; ++tail) { const std::uint32_t index = unpack_index_generic(packed_row, tail); if constexpr (std::is_same_v) { accumulator += static_cast(args.x)[input_row_offset + tail] * args.centroids[index]; } else { accumulator += static_cast( static_cast( args.x)[input_row_offset + tail]) * args.centroids[index]; } } accumulator *= row_norm; if (args.has_bias) { accumulator += args.bias[out_col]; } store_value( args.out, (row_start + row) * args.out_features + out_col, accumulator); } } template ORBITQUANT_TARGET_AVX2 inline void packed_matmul_avx2_buffered_rows( PackedMatmulArgs const &args, float const *decoded_row, std::int64_t out_col, std::int64_t row_start) { __m256 accumulators[row_tile]; #pragma clang loop unroll(full) for (int row = 0; row < row_tile; ++row) { accumulators[row] = _mm256_setzero_ps(); } std::int64_t k = 0; for (; k + 8 <= args.in_features; k += 8) { const __m256 weight = _mm256_loadu_ps(decoded_row + k); #pragma clang loop unroll(full) for (int row = 0; row < row_tile; ++row) { const std::int64_t input_offset = (row_start + row) * args.in_features + k; accumulators[row] = _mm256_fmadd_ps( load8(args.x, input_offset), weight, accumulators[row]); } } const float row_norm = args.row_norms[out_col]; #pragma clang loop unroll(full) for (int row = 0; row < row_tile; ++row) { const std::int64_t input_row_offset = (row_start + row) * args.in_features; float accumulator = horizontal_sum(accumulators[row]); for (std::int64_t tail = k; tail < args.in_features; ++tail) { if constexpr (std::is_same_v) { accumulator += static_cast(args.x)[input_row_offset + tail] * decoded_row[tail]; } else { accumulator += static_cast( static_cast( args.x)[input_row_offset + tail]) * decoded_row[tail]; } } accumulator *= row_norm; if (args.has_bias) { accumulator += args.bias[out_col]; } store_value( args.out, (row_start + row) * args.out_features + out_col, accumulator); } } template < typename scalar_t, __m256 (*load8)(void const *, std::int64_t), typename decoder_t> ORBITQUANT_TARGET_AVX2 ORBITQUANT_NOINLINE void packed_matmul_avx2_lowbit_typed( PackedMatmulArgs const &args, std::int64_t out_start, std::int64_t out_end) { constexpr int kPrimaryRowTile = 8; const std::int64_t packed_row_bytes = args.in_features * decoder_t::kBits / 8; // Two or more row tiles amortize the packed decode: expand the column once // into a per-thread scratch row and stream plain FMA tiles from it. const bool use_decoded_buffer = args.rows >= 16; thread_local std::vector decoded_row_storage; if (use_decoded_buffer && decoded_row_storage.size() < static_cast(args.in_features)) { decoded_row_storage.resize(static_cast(args.in_features)); } for (std::int64_t out_col = out_start; out_col < out_end; ++out_col) { const auto *packed_row = args.packed_weight_indices + out_col * packed_row_bytes; if (use_decoded_buffer) { float *decoded_row = decoded_row_storage.data(); const typename decoder_t::Tables tables = decoder_t::load_tables(args.centroids); std::int64_t k = 0; for (; k + 8 <= args.in_features; k += 8) { _mm256_storeu_ps(decoded_row + k, decoder_t::decode(packed_row, k, tables)); } for (; k < args.in_features; ++k) { decoded_row[k] = args.centroids[unpack_index_generic(packed_row, k)]; } std::int64_t row = 0; for (; row + kPrimaryRowTile <= args.rows; row += kPrimaryRowTile) { packed_matmul_avx2_buffered_rows( args, decoded_row, out_col, row); } if (row + 4 <= args.rows) { packed_matmul_avx2_buffered_rows( args, decoded_row, out_col, row); row += 4; } switch (args.rows - row) { case 3: packed_matmul_avx2_buffered_rows( args, decoded_row, out_col, row); break; case 2: packed_matmul_avx2_buffered_rows( args, decoded_row, out_col, row); break; case 1: packed_matmul_avx2_buffered_rows( args, decoded_row, out_col, row); break; default: break; } continue; } std::int64_t row = 0; for (; row + kPrimaryRowTile <= args.rows; row += kPrimaryRowTile) { packed_matmul_avx2_lowbit_rows( args, packed_row, out_col, row); } if (row + 4 <= args.rows) { packed_matmul_avx2_lowbit_rows( args, packed_row, out_col, row); row += 4; } switch (args.rows - row) { case 3: packed_matmul_avx2_lowbit_rows( args, packed_row, out_col, row); break; case 2: packed_matmul_avx2_lowbit_rows( args, packed_row, out_col, row); break; case 1: packed_matmul_avx2_lowbit_rows( args, packed_row, out_col, row); break; default: break; } } } template void packed_matmul_avx2_lowbit_dispatch( PackedMatmulArgs const &args, std::int64_t out_start, std::int64_t out_end) { switch (args.scalar_kind) { case ScalarKind::Float32: packed_matmul_avx2_lowbit_typed( args, out_start, out_end); return; case ScalarKind::Float16: packed_matmul_avx2_lowbit_typed( args, out_start, out_end); return; case ScalarKind::BFloat16: packed_matmul_avx2_lowbit_typed( args, out_start, out_end); return; } } template bool use_verified_amd_cezanne_row_tile(PackedMatmulArgs const &args) { if constexpr (!std::is_same_v) { return false; } const bool tuned_dimension = args.in_features == 1536 || args.in_features == 1920 || args.in_features == 3072; if (args.rows < 16 || !tuned_dimension) { return false; } static const bool verified_cpu = [] { unsigned int eax = 0; unsigned int ebx = 0; unsigned int ecx = 0; unsigned int edx = 0; #if defined(_MSC_VER) int registers[4]{}; __cpuid(registers, 0); eax = static_cast(registers[0]); ebx = static_cast(registers[1]); ecx = static_cast(registers[2]); edx = static_cast(registers[3]); if (ebx != 0x68747541u || edx != 0x69746e65u || ecx != 0x444d4163u) { return false; } __cpuid(registers, 1); eax = static_cast(registers[0]); #else // CPUID vendor registers spell "AuthenticAMD" in EBX, EDX, ECX order. if (!__get_cpuid(0, &eax, &ebx, &ecx, &edx) || ebx != 0x68747541u || edx != 0x69746e65u || ecx != 0x444d4163u || !__get_cpuid(1, &eax, &ebx, &ecx, &edx)) { return false; } #endif const unsigned int base_family = (eax >> 8) & 0xfu; const unsigned int family = base_family == 0xfu ? base_family + ((eax >> 20) & 0xffu) : base_family; // The 16-row tile was measured on Zen 3 (Ryzen 5 5600G); apply it to the // whole AVX2-only Zen 3 family (19h without AVX-512) instead of pinning // the one benchmarked model. return family == 0x19u && !packed_matmul_x86_avx512_available(); }(); return verified_cpu; } template < typename scalar_t, __m256 (*load8)(void const *, std::int64_t), int primary_row_tile> ORBITQUANT_TARGET_AVX2 ORBITQUANT_NOINLINE void packed_matmul_avx2_w4_typed( PackedMatmulArgs const &args, std::int64_t out_start, std::int64_t out_end) { static_assert(primary_row_tile == 8 || primary_row_tile == 16); const std::int64_t packed_row_bytes = args.in_features / 2; for (std::int64_t out_col = out_start; out_col < out_end; ++out_col) { const auto *packed_row = args.packed_weight_indices + out_col * packed_row_bytes; std::int64_t row = 0; for (; row + primary_row_tile <= args.rows; row += primary_row_tile) { packed_matmul_avx2_w4_rows( args, packed_row, out_col, row); } if (row + 8 <= args.rows) { packed_matmul_avx2_w4_rows( args, packed_row, out_col, row); row += 8; } if (row + 4 <= args.rows) { packed_matmul_avx2_w4_rows( args, packed_row, out_col, row); row += 4; } switch (args.rows - row) { case 3: packed_matmul_avx2_w4_rows( args, packed_row, out_col, row); break; case 2: packed_matmul_avx2_w4_rows( args, packed_row, out_col, row); break; case 1: packed_matmul_avx2_w4_rows( args, packed_row, out_col, row); break; default: break; } } } } // namespace void packed_matmul_x86_avx2_range( PackedMatmulArgs const &args, std::int64_t out_start, std::int64_t out_end) { if (!packed_matmul_x86_avx2_available()) { packed_matmul_scalar_range(args, out_start, out_end); return; } if (args.bits == 2 && args.in_features % 4 == 0) { packed_matmul_avx2_lowbit_dispatch(args, out_start, out_end); return; } if (args.bits == 6 && args.in_features % 4 == 0) { packed_matmul_avx2_lowbit_dispatch(args, out_start, out_end); return; } if (args.bits != 4 || args.in_features % 2 != 0) { packed_matmul_scalar_range(args, out_start, out_end); return; } switch (args.scalar_kind) { case ScalarKind::Float32: packed_matmul_avx2_w4_typed( args, out_start, out_end); return; case ScalarKind::Float16: packed_matmul_avx2_w4_typed( args, out_start, out_end); return; case ScalarKind::BFloat16: if (use_verified_amd_cezanne_row_tile(args)) { packed_matmul_avx2_w4_typed( args, out_start, out_end); } else { packed_matmul_avx2_w4_typed( args, out_start, out_end); } return; } } } // namespace orbitquant::cpu #else namespace orbitquant::cpu { void packed_matmul_x86_avx2_range( PackedMatmulArgs const &args, std::int64_t out_start, std::int64_t out_end) { packed_matmul_scalar_range(args, out_start, out_end); } } // namespace orbitquant::cpu #endif