What's new in this build
Build 121 of nx2 (9c55e70) is 23 changes merged from the fe-render branch, all of them for Fire Emblem: Fortune's Weave. The game now gets through NVN setup instead of tearing it down, renders its 3D scenes, sky, health gauges and movies, accepts text from the on-screen keyboard, and runs at its intended 30 fps instead of double speed.
Nothing needs configuring: every fix is on by default, and each one that can be turned back off has its environment variable listed below. None of this changes other games.
It boots at all
The game tore NVN down at boot with 2162-0001 for three reasons:
- The GPU characteristics did not report the class family flags. The Switch 2 SDK filters its class enumeration by the 2D, 3D, compute and inline-to-memory bits (bits 40–43 of the characteristics block) before it picks its context classes. All four are reported now.
VSMS_MAPPINGwas not implemented. The SDK asks for the{gpc, tpc}pair of every virtual SM and treats a pair left at its 0xc0c0 sentinel as failure. Every pair is filled in: one GPC, two SMs per TPC.gpu 41(create graphics device) returned id 0, which the game then used in later NvRm calls. Ids are handed out from 1 and freed withgpu 42.gpu 202now reports an empty gsv partition as min 0 / max 0 instead of(0, 0), which the SDK read as a one-byte partition at address 0.
The 3D scenes were black
Most of the game's graphics programs were rejected, and the ones that did compile read the wrong constants:
- A second texture descriptor buffer. The shaders sample from more than one constant buffer (bindings 4–7, 14 and 15 next to an earlier one), and the lowering rejected any binding that conflicted with the program's buffer, so most graphics programs failed. Such a binding is now read bindless — the handle is loaded with an unpredicated
MOVand passed as the first meta register ofTEX.B,TLD.BorSUST.B.TEXwith the handle in a register or a uniform register,TXQon any binding,TXQ.B,TXDwith any channel mask and.NODEP, andSUST.STRONG.GPU(fenced withMEMBAR.GLon both sides) also lower now. - Root tables were thrown away. Methods 0x504/0x508 write eight 256-byte root tables that shaders read as constant banks 24–31, and NVN2 keeps push constants in table 0 (bank 17 after the Ampere lowering). The blit-constants pass replaced those reads with render-target sizes, which flooded the 3D scenes red. The tables are kept, table 0 is streamed as bank 17 when the game has not bound one, and shaders that read bank 17 outside the pass's parameter block are left alone.
- A shader that reads only words the blit block would zero keeps its reads — the enemy health gauges read offset 0x40 of root table 0 and drew black.
FSELdropped its negate and absolute-value modifiers. The sky vertex shader builds its cube corners withFSEL R, -1.0forms, so every corner came out +1.0, the cube collapsed to a point and the sky was flat. IntegerSELis unchanged.FSET.BFwith a uniform register operand (0xc0a) was rejected; those battle-scene shaders left the screen white.- Instruction coverage, all forms the game uses:
IADD3/IADD3.Xwith third sources, negated sources, two carry-outs, two carry-ins and uniform operands;IMAD.X,IMAD.WIDEandIMAD.HIwith an addend and a carry-out;LEA,LEA.HIandLEA.HI.Xvariants;ISETP.EX;SHF/USHFwith a constant-buffer shift or UR16–UR27;IMNMXwith a negative immediate;I2F/F2I64-bit and truncating forms;FMNMX.NAN;MATCH.ALL;IDP.2A;STG/LDGdescriptor forms;REDUX.OR/REDUX.MIN;ATOMS.MIN/MAX/OR;BAR.SYNC.DEFER_BLOCKING. The native callee link check now counts only real register writes (and both halves ofIMAD.WIDE), so callees that compare or branch are no longer rejected.
The picture
- Resolution: it was rendering at 360p.
vi2 106was auto-stubbed and the game read the empty reply as mode 0, picking its 720p tier. It now reports mode 4 (1440p) docked and 2 (1080p, the screen) handheld, so the game renders at 720p and 540p and upscales to those.EDEN_VI2_MAX_RESOLUTION_MODEoverrides the mode. - Movies were black. The movie player maps each decoder output image (
gsv 426) and blits it into a texture of its own, but the pool memory is process memory that no GPU mapping covered, so the blit read zeros.gsv 426now maps a decoder image at its own address for the GPU unless a mapping already covers it,427,430and112drop the mapping after the last unmap, images the client reads on the GPU are written block-linear RGBA, and the GPU caches are invalidated after each frame. NV12 images and images read with961keep the pitch-linear layout. - Every frame was black from an HDR reply.
vi2 104(GetHdrStatus) returned a bare success, so the game's output format came from stale reply words, its tone-map constants came out NaN and every frame was black. Format 1 (SDR) is now reported for the default display. - A corner of wrongly decoded pixels. Present word 7 carries the size of the frame drawn into the image's top-left corner and word 6 its format (1 = RGBA8, 4 = RGB10A2). The game draws 1280x720 RGB10A2 frames into 3840x2160 images, which were shown whole as RGBA8. Presents are cropped to their frame size and RGB10A2 is honoured.
- Black screen from two address spaces. Each address space used to allocate its own SMMU range for the same memory outside the heap, and the caches key memory by device address — so the game drew into one alias while VI presented another. Those ranges are now shared per process and reference counted.
EDEN_NX2_PRIVATE_DEVICE_RANGES=1restores one range per address space.
Sound, speed and text
- It aborted at boot with 2153-1537. Switch 2 titles send audio renderer revision 16 with the 'REv' magic and use the voice crossfade fields; without them
GetWorkBufferSizefailed with 0xc0299. Revision 16 is accepted now (ported from the Eden NS2 tree, keeping Eglantine's lenient revision compare). - It ran at 60 fps instead of 30. Presents were always held to the next 60 Hz vblank, but present word 12 holds
(swap interval << 16) | refresh rateand the game asks for interval 2 after its boot logos. Presents are paced by their own interval (clamped to 1–4) and rate (60 if outside 30–240 Hz), and a change of that word is logged.EDEN_NX2_SWAP_INTERVAL=<n>forces an interval. - Load times were roughly doubled. The vi2 session is served on guest core 3, and the host sleep that paces presents held that core for most of every frame, so the loader got one RomFS read per frame — 33 ms apart instead of about 4 ms. The pause is now taken in the guest kernel, so the game's own threads on that core keep running.
- The on-screen keyboard returned only the first letter. The game opens it with library version 0x160012 and a 0x530-byte config; read with the Switch 1 layout, the byte taken as
use_utf8belonged toinitial_string_offset, so the name entry returned UTF-16 and the game kept one letter. The 0x160012 layout is decoded now (0x140010 is unchanged).
DLSS: a temporal upscale stand-in
The game's DLSS network cannot run — the HMMA lowering rejects it — so its 3D scenes stayed black, and the stand-in written for another title never matched it. The network's last pass reads the colour through cbuf0+0x328 and writes the output through cbuf0+0x348, and those are blitted now.
On top of that, the one-frame blit left 3D edges aliased and shaking: the game jitters its camera every frame for DLSS to accumulate. temporal_upscale.frag now places its input samples where the jitter put them, weights them by distance, and blends with the previous result reprojected along the motion vectors (Catmull-Rom), clipped to the 3x3 neighbourhood in YCoCg. The history is copied right after the result is drawn, so the game's own post-processing does not feed back into it. EDEN_NX2_TEMPORAL_UPSCALE=0 restores the plain blit.
Coming from build 117?
Build 117 was published from a merge that pulled the nx2-experimental line into nx2; nx2 no longer contains that merge, so this build does not have the experimental batch (task and mesh shaders, the AMD VRAM margins, the command-list snapshot, EDEN_NX2_NO_MESH). The two lines are built separately — an nx2-experimental build such as 122 has that batch plus the .nup fix, this build has the Fire Emblem work instead.
How it works, for the technically curious
- Three boot blockers, one per service:
nvhost_ctrl_gpuVSMS_MAPPINGfills one GPC with two SMs per TPC;nvhost_gpu41 hands out ids from 1 (freed by 42) and 202 replies{min: 0, max: 0}for an empty partition; the GPU characteristics block sets bits 40–43 (2D, 3D, compute, I2M). - Bindless fallback:
TEXS' fast path and the array-depth form now check the descriptor buffer instead of forcing it to 2, and the handle is materialised with an unpredicatedMOVinto the first meta register. Maxwell3Dkeeps 0x504/0x508's eight 256-byte root tables; the buffer cache streams table 0 as constant bank 17 when the game binds none, and the blit-constants pass only rewrites reads inside its own parameter block.vi2: 104 returns the u64 SDR output format, 106 returns mode 4/2 (docked/handheld), present word 12 drives pacing (EDEN_NX2_SWAP_INTERVALoverrides), words 6 and 7 drive format and crop, andPaceToVblanksleeps in the guest kernel instead of on the host thread that serves the session.gsv426 maps a decoder image at its own address for the GPU and replies with the address, the last byte's address and the image descriptor; 427/430/112 release it after the last unmap; the block-linear RGBA layout is chosen only for images the client reads on the GPU.nvhost_as_gpukeys non-heap device ranges by(ASID, CPU address, size)with a reference count, and drops a closed session's entries so a reused ASID cannot inherit them.- Audio: revision 16 is accepted with the
REvmagic and the crossfade fields kept, soGetWorkBufferSizereturns a real size. - swkbd: the 0x160012
keyboardConfig2layout moves the flags, lengths, string offsets and dictionary fields after the text prefix; 0x140010 keeps the old one. - DLSS stand-in:
kepler_computerecognises the last network pass by itscbuf0+0x328/0x348handle pair (after title 4's0x90/0xa0pair fails to fit), andtemporal_upscale.fragdoes the jittered sampling plus the YCoCg-clipped history blend.
Automatic build of nx2 at 9c55e70.
Windows: extract the zip and run eglantine.exe, or eden-cli.exe from a terminal.
Linux (AppImage): make it executable (chmod +x) and run it; it bundles its libraries and needs glibc 2.39 or newer (Ubuntu 24.04, Fedora 40, Debian 13, Arch).
Linux (tar.gz): extract it and run ./eglantine or ./eden-cli; it uses your system libraries, so Qt 6 and the usual libraries must be installed.
macOS: Apple Silicon and macOS 15 or newer. Unzip and move eglantine.app to Applications; eden-cli is inside it, in Contents/MacOS. The app is not notarized, so the first time right-click it and choose Open (or run xattr -dr com.apple.quarantine eglantine.app).
The -pgo builds are the same programs compiled with profile-guided optimization (clang plus Eden's profile); prefer them when your CPU supports it. The Windows PGO build is a MinGW build, so it carries its own DLLs and needs no Visual C++ redistributable.