Difference between revisions of "ZEsarUX:known bugs"

From SpecNext official Wiki
Jump to: navigation, search
(adding link to fork repository)
 
(32 intermediate revisions by the same user not shown)
Line 1: Line 1:
You may want also to check the official [https://raw.githubusercontent.com/GogiGoga/ZEsarUX/master/FAQ ZEsarUX FAQ] to see if you have a known issue which has solution (ZX Next is "TBBlue" type of machine).
+
You may want also to check the official [https://raw.githubusercontent.com/chernandezba/zesarux/master/src/FAQ ZEsarUX FAQ] to see if you have a known issue which has solution (ZX Next is "TBBlue" type of machine).
  
Official ZEsarUX 8.1:
+
Version 10.2:
* sprites rendering is at "4B type" level (no anchor/relative sprites or scaling) (5B init is correctly accepted but doesn't render the extra features)
+
* direct load of NEX file with entry bank 8+ is broken
* 4bpp sprites are not supported
+
* missing Nextreg $64 "video line offset" (core 3.1.5)
 +
* blending modes are not implemented
 +
* DMA: too many differences to list, but most crucial: slow "burst" functionality is missing, CONTINUE is not supported, legacy Z80 mode is not implemented, all transfers are "instant", dmaDebug.sna test does "reset" machine after ENABLE command (didn't look what exactly is broken about the last one)
 +
* ULA (bank 4/7, timex hires/hicol) scroll doesn't scroll per pixel on X-axis, but per 8px (char)
 +
* ULA (bank 4/7, timex hires/hicol) half-width scroll is not implemented
 +
* ULA (bank 4/7, timex hires/hicol) clipping on Y-axis scrolls too (should not)
 +
* relative sprites don't wrap correctly around 512x512 coordinate space in extreme cases (8x scale and some positions)
 
* sprites rendering is not one-scanline-buffer delayed and all changes in sprites affect current scanline
 
* sprites rendering is not one-scanline-buffer delayed and all changes in sprites affect current scanline
* Layer 2 displays shadow variant (NextReg $13) when the "shadow" mapping is enabled
+
* NextRegs $09 reads wrong values, NextReg $02 soft reset doesn't work same as HW
* Layer 2 modes 320x256x8bpp and 640x256x4bpp are not implemented
+
* audio has "clicks" and noise on many platforms, although YMMV
* Layer 2 extra memory mapping controlled by {{PortNo|$123B}} works only in core2.x way.
 
 
* modifications to NextRegs done in copper propagate to rendering usually only once per scanline, usually retroactively for full scanline when triggered in h-blank area (palette changes, X/Y offsets, etc)
 
* modifications to NextRegs done in copper propagate to rendering usually only once per scanline, usually retroactively for full scanline when triggered in h-blank area (palette changes, X/Y offsets, etc)
* palette read (NextReg $41 + $44 produces wrong results)
+
* when running without the full NextZXOS card image, the esxdos services are provided by the emulator itself, which does not implement all of them, and they don't always return the state described by the NextZXOS documentation
* tilemode gfx/map address read (NextReg $6E + $6F) does return original value without top bits set to zero
+
* missing all(?) features/changes of cores after version 3.1.5 (the emulator itself reports as core 3.1.11, but I haven't find any functionality related to the changes in real cores)
* DMA: too many differences to list, but most crucial: CONTINUE is not supported, slow "burst" functionality is not complete, legacy Z80 mode is not implemented
+
* Z80: EI instruction, FD and DD prefix don't inhibit accepting masked interrupt until next instruction is executed (or postpone interrupt request until some instruction which allows it, and then handle interrupt, even if /INT signal is gone)
* blending modes are not implemented
+
* Z80: extra IX/IY prefix is wrongly processed and with even number of prefixes the next instruction is using HL instead of IX/IY
* ULA scroll is not at new NextReg $26, $27 (but still shared with LoRes offset registers)
+
* Z80: (should not affect any ZX SW, just emulation accuracy) ccf/scf doesn't produce stable outcome in undocumented flags
* audio has "clicks" and noise on many platforms, although YMMV
+
 
* monochrome tilemode has not fully correct colours handling
+
Untested since 10.2 (may be already fixed, probably not):
 +
* ULA+tilemode does not support stencil mode, and transparency fallback color is not used in some edge cases (disabled ULA + clipped tiles)
 
* tilemode doesn't wrap in memory the same way as HW (when gfx/map address is toward end of Bank 5)
 
* tilemode doesn't wrap in memory the same way as HW (when gfx/map address is toward end of Bank 5)
 
* direct loading of NEX file doesn't init the machine in the same way as NEXLOAD from NextZXOS (it's close, but few things are different)
 
* direct loading of NEX file doesn't init the machine in the same way as NEXLOAD from NextZXOS (it's close, but few things are different)
* screen saver of NextZXOS will "crash" the emulated machine (not emulator itself)
+
* should be fixed, untested <del>in linux trying to open "Debug CPU" window will smash the stack and crash the emulator, you can work around it by using "-fno-stack-protector" during compilation to continue running even with damaged stack content.</del>
* when running without the full NextZXOS card image, the esxdos services are provided by the emulator itself, which does not implement all of them, and they don't always return the state described by the NextZXOS documentation
 
  
Already fixed in git (but present in 8.1. release):
+
Fixed since 10.2 final:
* altROM next register does not work correctly and core 3.1.3 does further change it
+
* <del>sprite rendering-priority (b6 in NextReg $15) is not implemented</del>
 +
* <del>Z80: (should not affect any ZX SW, just emulation accuracy) block instruction flags while repeating are incorrect</del>
  
 
Other Issues (not a bug):
 
Other Issues (not a bug):
 
* 28MHz mode requires quite powerful PC to emulate it smoothly, "lagging" emulator menu/etc is likely to happen in 28MHz mode and unfit for many development purposes.
 
* 28MHz mode requires quite powerful PC to emulate it smoothly, "lagging" emulator menu/etc is likely to happen in 28MHz mode and unfit for many development purposes.
 
+
* don't use "--enable-esxdos-handler" option together with running NextZXOS from full MMC card image - it will clash with the MMC functionality
----------------
 
 
 
Personal [https://github.com/ped7g/zesarux/ "ZESERUse" fork (branch "tbblue_small_fixes2")] of Ped7g:
 
* modifications to NextRegs done in copper propagate to rendering usually only once per scanline, usually retroactively for full scanline when triggered in h-blank area (palette changes, X/Y offsets, etc) - when compiled with extra flag "-DTBBLUE_DELAYED_COPPER_WAITS" it will delay copper instructions waiting for h-blank till next line (does produce better visual output in some cases, but makes the emulation less accurate in terms of timing)
 
* altROM/global memory map not updated to core 3.1.3 changes
 
* audio has "clicks" and noise on many platforms, although YMMV
 
* 28MHz mode requires quite powerful PC to emulate it smoothly, "lagging" emulator menu/etc is likely to happen in 28MHz mode - the fork is even more power hungry than official version
 
* blending modes are not working, missing core3.1.3 features completely, core3.0 is implemented code but broken in current version
 
* sprites rendering is not one-scanline-buffer delayed and all changes in sprites affect current scanline, calculation of pixel-bandwidth exhaustion is vastly incorrect
 
* tilemode doesn't wrap in memory the same way as HW (when gfx/map address is toward end of Bank 5)
 
* screen saver of NextZXOS will "crash" the emulated machine (not emulator itself)
 
* when running without the full NextZXOS card image, the esxdos services are provided by the emulator itself, which does not implement all of them, and they don't always return the state described by the NextZXOS documentation
 
* DMA should have two ports since core 3.1.3 and the legacy/next mode depends on port number, not nextreg $06
 
* missing Nextreg $8E Spectrum memory mapping (core 3.1.3)
 

Latest revision as of 19:13, 19 August 2024

You may want also to check the official ZEsarUX FAQ to see if you have a known issue which has solution (ZX Next is "TBBlue" type of machine).

Version 10.2:

  • direct load of NEX file with entry bank 8+ is broken
  • missing Nextreg $64 "video line offset" (core 3.1.5)
  • blending modes are not implemented
  • DMA: too many differences to list, but most crucial: slow "burst" functionality is missing, CONTINUE is not supported, legacy Z80 mode is not implemented, all transfers are "instant", dmaDebug.sna test does "reset" machine after ENABLE command (didn't look what exactly is broken about the last one)
  • ULA (bank 4/7, timex hires/hicol) scroll doesn't scroll per pixel on X-axis, but per 8px (char)
  • ULA (bank 4/7, timex hires/hicol) half-width scroll is not implemented
  • ULA (bank 4/7, timex hires/hicol) clipping on Y-axis scrolls too (should not)
  • relative sprites don't wrap correctly around 512x512 coordinate space in extreme cases (8x scale and some positions)
  • sprites rendering is not one-scanline-buffer delayed and all changes in sprites affect current scanline
  • NextRegs $09 reads wrong values, NextReg $02 soft reset doesn't work same as HW
  • audio has "clicks" and noise on many platforms, although YMMV
  • modifications to NextRegs done in copper propagate to rendering usually only once per scanline, usually retroactively for full scanline when triggered in h-blank area (palette changes, X/Y offsets, etc)
  • when running without the full NextZXOS card image, the esxdos services are provided by the emulator itself, which does not implement all of them, and they don't always return the state described by the NextZXOS documentation
  • missing all(?) features/changes of cores after version 3.1.5 (the emulator itself reports as core 3.1.11, but I haven't find any functionality related to the changes in real cores)
  • Z80: EI instruction, FD and DD prefix don't inhibit accepting masked interrupt until next instruction is executed (or postpone interrupt request until some instruction which allows it, and then handle interrupt, even if /INT signal is gone)
  • Z80: extra IX/IY prefix is wrongly processed and with even number of prefixes the next instruction is using HL instead of IX/IY
  • Z80: (should not affect any ZX SW, just emulation accuracy) ccf/scf doesn't produce stable outcome in undocumented flags

Untested since 10.2 (may be already fixed, probably not):

  • ULA+tilemode does not support stencil mode, and transparency fallback color is not used in some edge cases (disabled ULA + clipped tiles)
  • tilemode doesn't wrap in memory the same way as HW (when gfx/map address is toward end of Bank 5)
  • direct loading of NEX file doesn't init the machine in the same way as NEXLOAD from NextZXOS (it's close, but few things are different)
  • should be fixed, untested in linux trying to open "Debug CPU" window will smash the stack and crash the emulator, you can work around it by using "-fno-stack-protector" during compilation to continue running even with damaged stack content.

Fixed since 10.2 final:

  • sprite rendering-priority (b6 in NextReg $15) is not implemented
  • Z80: (should not affect any ZX SW, just emulation accuracy) block instruction flags while repeating are incorrect

Other Issues (not a bug):

  • 28MHz mode requires quite powerful PC to emulate it smoothly, "lagging" emulator menu/etc is likely to happen in 28MHz mode and unfit for many development purposes.
  • don't use "--enable-esxdos-handler" option together with running NextZXOS from full MMC card image - it will clash with the MMC functionality