Repository navigation
Fix Turing (TU106/TU104/TU116) WindowServer dragging micro-stutter & 256MB BAR1 budget drops - #179
Open
Golopmoui3 wants to merge 1 commit into
Open
Golopmoui3 wants to merge 1 commit into
Golopmoui3 wants to merge 1 commit into
Conversation
…s & rules - Add turing-bar1-stutter-optimization rule to nullmoth-rules.json with optimized Metal driver knobs - Patch NVRMFB 256MB vramGrant budget limit check at offset 0x21ea3 to prevent surface dropping and black frames - Patch NVAccel aggressive 100ms surface eviction (0x251e0) and sticky VM mapping churn (0x23f1c) - Integrate automatic patcher and AuxKC rebuild in nullmoth-setup.sh - Provide standalone diagnostic tool tools/apply-turing-fix.sh with --check and --revert - Add full technical documentation in docs/TURING_OPTIMIZATION.md and unit tests
Golopmoui3
added a commit
to Golopmoui3/Golopmoui3
that referenced
this pull request
Nov 15, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Overview
This PR resolves the severe WindowServer dragging micro-stutter, surface drops, and black window rectangles observed on NVIDIA Turing GPUs (RTX 2060 SUPER / TU106, RTX 2070 / TU104, GTX 1660 / TU116) running on macOS Sequoia / Sonoma with 256MB small BAR1 apertures.
Root Causes & Fixes
NVRMFB 256MB VRAM Grant Budget Ceiling (
vramGrantat offset0x21ea3):kIOReturnNoMemoryand dropping surfaces into black boxes.0x0f 0x8e 0x6d 0x01 0x00 0x00->0xe9 0x6e 0x01 0x00 0x00 0x90,jle->jmp) to let system memory handle allocations smoothly without rejection.NVAccel Inactivity Surface Eviction (
gSurfGpuOnat offset0x251e0):gSurfGpuOnset to0.NVAccel Sticky VM Mapping Churn (
gVmStickyat offset0x23f1c):gVmStickyset to0.Metal Driver Configuration (
nullmoth-rules.json):turing-bar1-stutter-optimizationrule to configurenvrm610.confwith:NVMTL_VRAM_HEADROOM_MB=48(avoids BAR1 starvation).NVMTL_NO_SURFACE_PAGEOFF=0(keeps active desktop surfaces responsive).NVMTL_NO_BUFREUSE=1), private image pooling (NVMTL_IMAGE_POOL=0,NVMTL_PRIVATE_POOL=0), and buffer grace periods on small BAR1 apertures.NVMTL_GSUB_HOSTPTR_LIFT=1,NVMTL_CMD_POOL_MAX_CHUNKS=256,NVMTL_SURFACE_DEFER_FREE_MS=0.Installer & Standalone Utilities:
mac/Resources/nullmoth-setup.sh.tools/apply-turing-fix.sh(with--checkand--revert).tests/test_turing_stutter_rules.pyand technical breakdowndocs/TURING_OPTIMIZATION.md.Hardware Verification
10de:1f06, Turing TU106)