Skip to content

Fix i2_s ARM CPU kernel: correct 128/32 weight-group layout (fixes #585)#586

Open
EUPHEMEME wants to merge 1 commit into
microsoft:mainfrom
EUPHEMEME:fix/i2s-arm-weight-layout
Open

Fix i2_s ARM CPU kernel: correct 128/32 weight-group layout (fixes #585)#586
EUPHEMEME wants to merge 1 commit into
microsoft:mainfrom
EUPHEMEME:fix/i2s-arm-weight-layout

Conversation

@EUPHEMEME

Copy link
Copy Markdown

Fixes #585.

What

The i2_s ternary CPU dot-product kernel unpacked weights with a 64-weight / 16-byte group layout, but the gguf packs them in the 128-weight / 32-byte layout (the one dequantize_row_i2_s uses). It read every weight matrix in scrambled order → wrong-but-finite output → garbage generation on all ARM CPU inference. On Apple Silicon the default Metal backend hides it (it dequantizes weights, so uses the correct layout); force CPU with -ngl 0 and it reproduces, exactly like Jetson / ARM-Linux.

Fix

Replace the ARM branch of the ggml_vec_dot_i2_i8_s dispatcher with a correct 128/32-layout NEON decode (dotprod path + scalar fallback). The x86/AVX path is unchanged.

Validation

  • First divergent op vs. the Metal reference was [3] MUL_MAT "Qcur-0" (first ternary matmul, layer 0). With the fix, the full CPU forward pass is bit-identical to the Metal/dequant path, modulo the expected int8-vs-f16 activation-quantization difference (~0.3–1% per element).
  • BitNet-b1.58-2B-4T on a Jetson Orin Nano (aarch64, clang 14 / gcc 11) goes from !!!! to coherent English.

See #585 for the full op-by-op trace and the in-kernel proof (the NEON arithmetic is correct; only the unpack layout was wrong).

Follow-up (not in this PR): the unused _1xN / _Nx1 / _1x4_32W ARM sub-kernels and the ARM branch of quantize_i2_s still assume the 64/16 layout — dead on the inference read path for this model, but worth aligning.

The ARM CPU i2_s dot-product path decoded weights with a 64-weight / 16-byte
group layout (QK_I2_S=64), but the gguf packs i2_s weights in the 128-weight /
32-byte layout used by dequantize_row_i2_s. It therefore read every weight
matrix in scrambled order, producing wrong-but-finite output and garbage
generation on all ARM CPU inference (Jetson / ARM-Linux, and Apple Silicon with
-ngl 0; the default Metal path masks it).

Replace the ARM branch of the ggml_vec_dot_i2_i8_s dispatcher with a correct
128/32-layout NEON decode (dotprod + scalar fallback); the x86/AVX path is
unchanged. After the fix the CPU forward pass is bit-identical to the
Metal/dequant path (modulo the expected int8-vs-f16 activation difference) and
generation is coherent. Verified on a Jetson Orin Nano (aarch64).

Fixes microsoft#585

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@EUPHEMEME

Copy link
Copy Markdown
Author

@microsoft-github-policy-service agree

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

i2_s ARM CPU kernel uses wrong weight-group layout (64/16 vs 128/32) → garbage output on all ARM CPU inference

1 participant