/* * qwen_kernels.h - Math kernels for Qwen3-ASR inference * * Low-level math operations. All operate on float32 tensors in row-major order. * Adapted from voxtral-realtime project. */ #ifndef QWEN_KERNELS_H #define QWEN_KERNELS_H #include #include /* ======================================================================== * Basic Operations * ======================================================================== */ void qwen_add_inplace(float *a, const float *b, int n); void qwen_mul_inplace(float *a, const float *b, int n); void qwen_scale(float *x, float s, int n); void qwen_copy(float *dst, const float *src, int n); /* ======================================================================== * Matrix Operations * ======================================================================== */ /* C = A @ B^T: A[M,K], B[N,K], C[M,N] */ void qwen_matmul_t(float *C, const float *A, const float *B, int M, int K, int N); /* y = x @ W^T + b: x[seq,in], W[out,in], b[out], y[seq,out] */ void qwen_linear(float *y, const float *x, const float *W, const float *b, int seq_len, int in_dim, int out_dim); void qwen_linear_nobias(float *y, const float *x, const float *W, int seq_len, int in_dim, int out_dim); /* bf16 weight variants */ void qwen_bf16_to_f32_buf(float *dst, const uint16_t *src, size_t n); void qwen_linear_nobias_bf16(float *y, const float *x, const uint16_t *W_bf16, int seq_len, int in_dim, int out_dim); /* Small-sequence BF16 path: compute two projections with one threaded dispatch. */ void qwen_linear_nobias_bf16_pair(float *a, float *b, const float *x, const uint16_t *Wa_bf16, const uint16_t *Wb_bf16, int seq_len, int in_dim, int a_dim, int b_dim); /* Small-sequence BF16 path: compute Q/K/V matvecs with one threaded dispatch. */ void qwen_linear_nobias_bf16_qkv(float *q, float *k, float *v, const float *x, const uint16_t *Wq_bf16, const uint16_t *Wk_bf16, const uint16_t *Wv_bf16, int seq_len, int in_dim, int q_dim, int kv_dim); /* Dot product using the best available local SIMD implementation. */ float qwen_dot_f32(const float *a, const float *b, int n); /* ======================================================================== * 2D Convolution (for audio encoder conv stem) * ======================================================================== */ /* * 2D Convolution: out = conv2d(in, weight, bias) * in: [C_in, H, W] * weight: [C_out, C_in, kH, kW] * bias: [C_out] (can be NULL) * out: [C_out, H_out, W_out] * H_out = (H + 2*padding - kH) / stride + 1 * W_out = (W + 2*padding - kW) / stride + 1 */ void qwen_conv2d(float *out, const float *in, const float *weight, const float *bias, int c_in, int c_out, int h_in, int w_in, int kh, int kw, int stride, int padding); /* ======================================================================== * Normalization * ======================================================================== */ /* LayerNorm with bias: out = (x - mean) / sqrt(var + eps) * weight + bias */ void qwen_layer_norm(float *out, const float *x, const float *weight, const float *bias, int seq_len, int hidden, float eps); /* RMS Normalization: out = x / rms(x) * weight */ void qwen_rms_norm(float *out, const float *x, const float *weight, int seq_len, int hidden, float eps); /* Per-head RMS Normalization for Q/K norms in decoder * x: [seq, n_heads, head_dim], weight: [head_dim] * Normalizes each head independently */ void qwen_rms_norm_per_head(float *x, const float *weight, int seq_len, int n_heads, int head_dim, float eps); /* ======================================================================== * Activation Functions * ======================================================================== */ void qwen_silu(float *x, int n); void qwen_gelu(float *x, int n); void qwen_softmax(float *x, int rows, int cols); /* gate = SiLU(gate) * up */ void qwen_silu_mul_inplace(float *gate, const float *up, int n); /* out[seq,inter] = SiLU(gate_up[seq,2*inter][:,even]) * gate_up[:,odd] */ void qwen_swiglu_multiply(float *out, const float *gate_up, int seq_len, int intermediate); /* ======================================================================== * Attention Operations * ======================================================================== */ /* * Bidirectional windowed attention (encoder). * Q, K, V: [seq, n_heads * head_dim] * out: [seq, n_heads * head_dim] * window_starts: array of window start positions * window_starts[n_windows] = seq (sentinel) * All heads have same dimensions (no GQA in encoder). */ void qwen_bidirectional_attention(float *out, const float *Q, const float *K, const float *V, int seq, int n_heads, int head_dim, float scale, const int *window_starts, int n_windows); /* * Causal attention with GQA (decoder). * Q: [seq_q, n_heads * head_dim] * K: [seq_k, n_kv_heads * head_dim] * V: [seq_k, n_kv_heads * head_dim] * q_offset: global position of first query (for causal mask) */ void qwen_causal_attention(float *out, const float *Q, const float *K, const float *V, int seq_q, int seq_k, int n_heads, int n_kv_heads, int head_dim, float scale, int q_offset); /* * Bidirectional GQA attention over a packed/ragged batch. * * Q: [total_seq, n_heads * head_dim] * K,V: [total_seq, n_kv_heads * head_dim] * offsets: [batch + 1], token spans for each sequence. * * Attention is block-diagonal: tokens only attend within their own * offsets[b]..offsets[b+1] span. */ void qwen_bidirectional_gqa_attention_packed(float *out, const float *Q, const float *K, const float *V, const int *offsets, int batch, int n_heads, int n_kv_heads, int head_dim, float scale); /* Optional reusable scratch for the BLAS-tiled packed attention path. */ size_t qwen_bidirectional_gqa_attention_packed_scratch_bytes( const int *offsets, int batch); void qwen_bidirectional_gqa_attention_packed_with_scratch( float *out, const float *Q, const float *K, const float *V, const int *offsets, int batch, int n_heads, int n_kv_heads, int head_dim, float scale, float *scratch, size_t scratch_bytes); /* ======================================================================== * Position Embeddings * ======================================================================== */ /* * Sinusoidal position embeddings (encoder). * pe: output [n_pos, d_model] * First half = sin, second half = cos. */ void qwen_sinusoidal_pe(float *pe, int n_pos, int d_model); /* * NeoX-style RoPE: compute cos/sin for positions. * cos_out, sin_out: [seq, head_dim] * cos[d] and cos[half+d] are the same (duplicated for full head_dim). */ void qwen_compute_rope_neox(float *cos_out, float *sin_out, const int *positions, int seq, int head_dim, float theta); /* * Apply NeoX-style RoPE to Q or K. * x: [seq, n_heads * head_dim] (in-place) * cos_vals, sin_vals: [seq, head_dim] */ void qwen_apply_rope_neox(float *x, const float *cos_vals, const float *sin_vals, int seq, int n_heads, int head_dim); /* Streaming argmax: finds argmax(W_bf16 @ x) without materializing full logits. * Returns the index of the row with highest dot product. */ int qwen_argmax_matvec_bf16(const float *x, const uint16_t *W_bf16, int in_dim, int out_dim); /* ======================================================================== * Threading * ======================================================================== */ /* Set number of threads for parallel operations (default: 1). * Creates a persistent thread pool. Call before inference. */ void qwen_set_threads(int n); /* Get number of available CPU cores */ int qwen_get_num_cpus(void); /* Global verbose flag */ extern int qwen_verbose; #endif /* QWEN_KERNELS_H */