NeoGeo Development Wiki - User contributions [en]

Development tools

2025-06-17T23:13:26Z

Iq 132:

__NOTOC__
==68000==
{|class="wikitable"
!colspan=6 style="background-color:#ccc"|Assemblers
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| [http://john.ccac.rwth-aachen.de:8000/as/ AS] || Alfred Arnold, et al || Multi-target assembler || (multiple) || Provided as source code and binaries (Windows, DOS) ||  
|-
| [http://sun.hasenbraten.de/vasm/ vasm] || Volker Barthelmann, et al || Multi-target assembler || (multiple) || Provided as source code "official" binaries are for older versions ||  
|-
| JAS || Charles Doty, Paul Lee, Michael Hope || Modified version of AS || Windows || (base AS version unknown; binary is circa 1999/12/30) || [[File:JAS.zip]]
|-
| Maccer || Michael Hope || Pre-processor for AS-series assemblers || (multiple) || Provided as source code and Windows binary ||  
|-
| [http://gendev.spritesmind.net/page-macX.html MaccerX] || Kaneda || Updated version of Maccer || (multiple) || Provided as source code and Windows binary; added support for XGCC (gcc) and comments ||  
|-
| SNASM68K || S.N. Systems || 680x0 assembler || Windows ||   || [http://segaretro.org/SNASM68K SNASM68K at Sega Retro] (Modified version by Nemesis)
|-
!colspan=6 style="background-color:#ccc"|Compilers
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| NeoDev kit || Fabrice Martinez, Jeff Kurtz, et al || GCC compiler and library || (multiple) ||   || [[File:NeoDev001.zip]]
|-
!colspan=6 style="background-color:#ccc"|Disassemblers
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| IRA || Tim Ruehsen, ported by Antirad || Intelligent ReAssembler for M680x0 || (multiple) || PC port of an Amiga app; provided as source ("PC") and binary (Windows) || [[File:Ira.zip]]
|-
| unidasm || MAMEdev || Universal Disassembler || (multiple) || Included with the Windows MAME distribution; can be built from source ||  
|}

==Z80==
{|class="wikitable"
!colspan=6 style="background-color:#ccc"|Assemblers
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| [http://john.ccac.rwth-aachen.de:8000/as/ AS] || Alfred Arnold, et al || Multi-target assembler || (multiple) || Provided as source code and binaries (Windows, DOS) ||  
|-
| [http://sun.hasenbraten.de/vasm/ vasm] || Volker Barthelmann, et al || Multi-target assembler || (multiple) || Provided as source code "official" binaries are for older versions ||  
|-
| [https://github.com/vhelin/wla-dx WLA DX] || Ville Helin, et al || Multi-target assembler || (multiple) || Provided as source code || [http://www.niksula.cs.hut.fi/~tursas/wla/wladx_binaries_20040822.zip WLA-DX 9.2 Win32 binaries]
|-
| [http://www.nongnu.org/z80asm/ z80asm] || Bas Wijnen (and others?) || Z80 assembler || (multiple) || Provided as source code ||  
|-
!colspan=6 style="background-color:#ccc"|Compilers
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| ZCC || Ken Yap, et al || Z80 development package with C compiler || (multiple) || Provided as source code and binaries (Windows); circa January 1996 || [[File:zcc096.zip]]
|-
| [http://sdcc.sourceforge.net/ SDCC] || Sandeep Dutta, et al || "Small Device C Compiler" || (multiple) || Provided as source code and binaries (various platforms) || [http://sdcc.sourceforge.net/snap.php Snapshot Builds]
|-
| [http://www.z88dk.org/forum/ z88dk] || (many people) || z80 C cross compiler with assembler/linker || (multiple) || Provided as source code and binaries (Windows, Mac) || [http://nightly.z88dk.org/?C=M;O=D Nightly Builds] (Hit escape as soon as you see the links for "latest")
|-
!colspan=6 style="background-color:#ccc"|Disassemblers
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| DASM || Charles Doty || Z80 disassembler || DOS || Source code and binary included. || [[File:dasmz80.zip]]
|-
| [http://www.inkland.org.uk/dz80/ DZ80] || Inkland || Z80 disassembler || (multiple) || Provided as source code (command line version) and binaries (DOS command line, Windows GUI) ||  
|-
| unidasm || MAMEdev || Universal Disassembler || (multiple) || Included with the Windows MAME distribution; can be built from source ||  
|}

==Source Editors==
There are a lot of source code editors out there... Use whatever you're comfortable with (hopefully one with 68000 and Z80 syntax highlighting).

==Sound and Music==
{|class="wikitable"
|-
!colspan=6 style="background-color:#ccc"|Music Drivers and Tools
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| [[MVSTracker]] || Ivan Mackintosh || FM tracker || Windows || [http://www.archaic.fr/interviews/interview-jeff-kurtz-repond-a-nos-questions/3/ Z80 driver does not work on hardware] ||  
|-
| [http://gendev.spritesmind.net/page-mvst.html MVSTracker Suite] || Pascal Bosquet, Kaneda || Modified version of MVSTracker || Windows || supports Mega Drive as well. Neo-Geo driver still doesn't work on hardware. ||  
|-
!colspan=6 style="background-color:#ccc"|Sound Editors
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| [http://www.goldwave.com/release.php GoldWave] || GoldWave Inc. || commercial sound editor || Windows ||   ||  
|-
| [http://www.sonycreativesoftware.com/soundforgesoftware Sound Forge] || Sony || commercial sound editor || Windows, Mac ||   ||  
|-
| [http://audacity.sourceforge.net/ Audacity] || Audacity developers || open-source sound editor || (multiple) ||   ||  
|-
!colspan=6 style="background-color:#ccc"|Sound Encoders
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| [https://github.com/freem/adpcma ADPCM-A encoder] || freem || Command-line ADPCM-A encoder || (multiple) || Provided as source code and binary (Windows) ||  
|-
| [http://www.smspower.org/forums/11965-VGMLoggingWithOtherEmulators?start=200#66597 ADPCM-B encoder] || ValleyBell and Fred/FRONT || Command-line ADPCM-B encoder || (multiple) || Provided as source code and binary (Windows) || [[File:ADPCM_Encode.zip]]
|-
| [[Neo Sound Builder]] || Jeff Kurtz/Neobitz || GUI V ROM/PCM file creator || Windows || ADPCM-A only || [https://www.facebook.com/Neobitz/photos/a.462349983789893.110879.221161891242038/1093044660720419/?type=3 announcement post]
|}

==Graphics==
{|class="wikitable"
|-
!colspan=6 style="background-color:#ccc"|Graphics Viewers and Editors
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| [[YY-CHR]] || YY || multi-format tile editor || Windows || FIX files require plugin (YY-CHR.NET only, see below); Sprites need conversion (see tools below) || [http://www.romhacking.net/utils/119/ YY-CHR 0.99]
|-
| NGFX || blastar || Fix, Sprite, TITLE_*.SYS viewer/editor; LOGO_*.SYS viewer || Windows || WIP; not yet released. || [https://www.romhacking.net/download/utilities/1175/]
|-
| neospriteviewer || Matt Greer || S and C ROM tile viewer || Web ||   || [https://neospriteviewer.mattgreer.dev site]
|-
!colspan=6 style="background-color:#ccc"|Graphics Converters and Tools
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| [[DATLib]] graphics tools || HPMAN || Tools used to process and display graphics on Neo-Geo. || Windows || Animator, BuildChar, CharSplit, Framer || [https://www.dropbox.com/s/wqviye5xxzktr6y/DATlib_0.3.rar?dl=0 download]
|-
| [[NGGTool|NeoGeo Graphics ToolSuite]] || evo || Tool to convert between SNES/SFC and Neo-Geo graphics. || Windows || Fix conversion is botched (see page for details) || [http://furrtek.free.fr/noclass/neogeo/nggts.zip NGGTS]
|-
| Sprite graphics converter || IQ || Converts MVS graphics (.c*) to CD graphics (.SPR). || Windows ||   || [http://furrtek.free.fr/noclass/neogeo/gfxmvstocd.zip MVS to CD sprite converter]
|-
| [https://github.com/freem/NeoSpriteConv Neo-Geo Sprite Converter] || freem || Convert 4BPP SMS/GG/WSC graphics to Neo-Geo format. || (multiple) || Provided as source code and binary (Windows) Further work required for converting to Cart (split files by words (2 bytes)) and CD (byteswap file)-usable files. || [http://ajworld.net/neogeodev/utils/neosprconv.zip main download]
|-
| [https://github.com/Kannagi/Neoconvert Neoconvert] || Kannagi || Convert PNG to rom Cx with map, palette and HiColor. || Windows,Linux || || [https://github.com/Kannagi/Neoconvert download]
|-
| [https://github.com/Kannagi/Neoextract Neoextract] || Kannagi || extract rom Cx or s1 to bmp. || Windows,Linux || || [https://github.com/Kannagi/Neoextract download]
|
|-
| [https://github.com/city41/sromcrom sromcrom] || Matt Greer || Generate S and C ROMs from images, generates corresponding source code as well || cross platform || || [https://github.com/city41/sromcrom download]
|
|-
| [https://neo-source.com/index.php?topic=4180.msg37936 buildobj] || iq_132 || Compress / Decompress NeoGeo CD OBJ files || Windows || || [https://neo-source.com/index.php?topic=4180.msg37936 buildobj]
|}

==Other Tools==
{|class="wikitable"
|-
!Name !! Author(s) !! Description !! Platform(s) !! Notes !! Download
|-
| MemCardTool || Fabrice Martinez || Memory card manager || Windows ||   || [[File:memcardtool.zip]]
|-
| [https://github.com/freem/romwak ROMwak] || Jeff Kurtz, ported by freem || Binary image manipulation tool || (multiple) || Provided as source code and binary (Windows) ||  
|}

[[Category:Code]]

OBJ file

2025-06-17T20:58:24Z

Iq 132:

OBJ files contain the [[sprites]] graphics (equivalent to the [[C ROM]]s on [[:Category:cartridge systems|cartridge systems]]). Data is compressed however using a simple RLE compression removing runs with a value of 0x00000000. Once decompressed the format is described here: [[sprite graphics format]].

==RLE compression==

* First long word value is the compressed data length (/4-1).
* The system works by checking single long words at a time.
* When a zero value is found it is stored and the next value is checked. A fill of zero is created to match the value read unless it is zero.
* Decompressed data can be a maximum of 1MByte (the size of a sprite bank) in size or the data will overflow the Upload Zone at $eXXXXX and start writing data at $fXXXXX, causing the hardware to crash or hang.
* The compressed data is sector-aligned (2KB).
* CDZ units will overwrite the filenames for OBJ with SPR and force loading SPR files anyway.
** For compatibility, a SPR copy of the sprite data with a corresponding file name must be stored on the disc image along with the OBJ file.

===Example===

compressed:

0x00000007, 0x11111111, 0x00000000, 0x00000003, 0x22222222, 0x00000000, 0x00000000, 0x33333333, 0x44444444

decompressed:

0x11111111, 0x00000000, 0x00000000, 0x00000000, 0x00000000, 0x22222222, 0x00000000, 0x33333333, 0x44444444

This system will not compress data very well unless there are large areas of zero data within the decompressed sprite data. This is due to a single zero value being inflated by 100% to let the decompressor know it is not a run. To my current knowledge only Art of Fighting uses the OBJ format, however Alpha Mission II does have OBJ files included, but are not loaded.

For reference below is a 68000 code snippet from bios TOP-SP1 that handles decompresses.

<syntaxhighlight>
C0BC5A 203C 00E0 0000 MOVE.L #0xE00000,D0
C0BC60 D0AD 7EF4 ADD.L (0x7EF4,A5),D0
C0BC64 2240 MOVEA.L D0,A1 <---- Where to decompress data
C0BC66 206D 7EF8 MOVEA.L (0x7EF8,A5),A0
C0BC6A 7000 MOVEQ #0x0,D0
C0BC6C 2E18 MOVE.L (A0)+,D7 <---- Get Length
C0BC6E 6738 BEQ.S *+0x3A [0xC0BCA8]
C0BC70 22D8 MOVE.L (A0)+,(A1)+ <---- Move single long word
C0BC72 6712 BEQ.S *+0x14 [0xC0BC86] <---- Branch if zero.
C0BC74 51CF FFFA DBF D7,*-0x4 [0xC0BC70] <---- check data end
C0BC78 2009 MOVE.L A1,D0
C0BC7A 0480 00E0 0000 SUBI.L #0xE00000,D0
C0BC80 2B40 7EF4 MOVE.L D0,(0x7EF4,A5)
C0BC84 4E75 RTS

C0BC86 2C18 MOVE.L (A0)+,D6 <---- Get next value
C0BC88 51CE 0014 DBF D6,*+0x12 [0xC0BC9E] <---- Decompress if non zero
C0BC8C 51CF FFE2 DBF D7,*-0x1C [0xC0BC70] <---- Check data end
C0BC90 2009 MOVE.L A1,D0
C0BC92 0480 00E0 0000 SUBI.L #0xE00000,D0
C0BC98 2B40 7EF4 MOVE.L D0,(0x7EF4,A5)
C0BC9C 4E75 RTS

C0BC9E 22C0 MOVE.L D0,(A1)+ <---- Recreate zero run
C0BCA0 51CE FFFC DBF D6,*-0x2 [0xC0BC9E] <---- and Loop until complete
C0BCA4 51CF FFCA DBF D7,*-0x34 [0xC0BC70] <---- Check data end

C0BCA8 2009 MOVE.L A1,D0
C0BCAA 0480 00E0 0000 SUBI.L #0xE00000,D0
C0BCB0 2B40 7EF4 MOVE.L D0,(0x7EF4,A5)
C0BCB4 4E75 RTS
</syntaxhighlight>

[[Category:CD systems]]

Slot check security

2025-03-31T14:02:36Z

Iq 132:

[[File:S3warning.png|frame|Warning screen as shown by [[Sengoku 3]] when booting on MVS hardware with BIOS_MVS_FLAG set to 0 (AES mode).]]

Slot checking is a MVS security measure added in some games produced after 1998 due to the emergence of [[bootleg MVS boards]]. It displays a warning screen and locks the game up if some checks fail.

Someone who would want to bypass this check will typically search for the warning text string in the [[P ROM]] and references to it in the code. Such text can't be found because the checking routine uses a XORed version of the same text instead, certainly to confuse hackers.

=KOF 98=

If the game figures out it is being run for the first time on the system (thanks to [[backup RAM]] data), it forces a [[watchdog]] reset. If the system doesn't reset itself after a certain amount of time (due to the eventual absence of the watchdog circuit), the game displays the warning screen and locks up.

=Other games=

*The calendar data zone in the [[BIOS RAM locations|BIOS RAM]] is cleared, then [[READ_CALENDAR]] is called. If {{BR|BIOS_MONTH}} is greater than 13 (should be 12 ? Is that a bug ?), the check fails. This causes bootleg boards with no [[RTC]] to trigger the security.
*If {{BR|BIOS_MVS_FLAG}} is zero (BIOS in AES mode), and bit 7 of {{Reg|REG_STATUS_B}} is set (MVS hardware), the check fails. This causes bootleg boards using a copy of the AES system ROM or those that don't handle REG_STATUS_B reads to trigger the security.

Depending on the result of those checks, the value $8B55 (pass) or $9DBD (fail) is written to [[VRAM]] at $7FFF. This furthermore verifies that the board has full VRAM.

That VRAM value is then read back and added to $74AB (=$10000 if checks passed) to set the byte at $10FCEF (fail) or not.

A later version of this procedure also times the Z80 reply to command $01. $10FCEE = $FF if Z80 was too slow.

Todo: Add more details.

==Use by games==

As seen in MAME's source ([[https://github.com/mamedev/mame/blob/master/src/mame/drivers/neogeo.cpp neogeo.cpp]]), a few games are known to do this check:

*[[Nightmare in the Dark]]
- Can be disabled with RTS at $19978
*[[The King of Fighters 2000]]
*[[Sengoku 3]]: MVS SLOT CHECK Ver2.30 00/04/25
*[[Matrimelee]]
*[[Metal Slug 5]]

[[Sengoku 3]]: Checks M1 ROM too, displays "M1-ROM ERROR." if Z80 doesn't reply to command 1 in $7FFF iterations loop.

[[Category:Games]]

NEO-CMC

2025-01-03T05:42:07Z

Iq 132:

{{ChipInfo
|picture=crt_cmc.jpg
|pkg=QFP180
|manu=toshiba
|date=1999 ?
|gates=A lot
|used_on={{PCB|CHAFIO}}...
}}

[[File:brd_cmcnoref.jpg|thumb|"CMC50"]]

Late SNK custom chip used for protection, bankswitching and latching on [[CHAFIO]] [[CHA board]]s.

Descrambling/decryption infos can be found in [[https://github.com/mamedev/mame/blob/master/src/devices/bus/neogeo/prot_cmc.cpp MAME:prot_cmc.c]]

==Versions==
This chip is a TC190G series Toshiba ASIC developed between 1990 and 1994. Two versions of the chip are known to exist:

*TC190G06CF7'''042'''
*TC190G06CF7'''050'''

They contain the logic for:
*{{Chipname|NEO-ZMC2}}
*{{Chipname|NEO-273}}
*New scrambling system that interlaces M1 + (C* + S1) to decrypt all the graphics ROMs data in real time (042 version).
*New scrambling system that interlaces M1 + (C* + S1) to decrypt all the graphics ROMs data and Sound Driver ROM data in real time (050 version).

The first released NEO-MVS CHAFIO PCBs came out with the '''042''' version of NEO-CMC, on the following cartridges:
*[[Zupapa!]]
*[[The King of Fighters '99 - Millennium Battle]]
*[[Ganryu]]
*[[Garou - Mark of the Wolves]]
*[[Strikers 1945 Plus]]
*[[Prehistoric Isle 2]]
*[[Metal Slug 3]]
*[[Bang Bead]]
*[[Nightmare in the Dark]]
*[[Sengoku 3]]

On this version only the [[S ROM|S1]] and [[C ROM]]s are encrypted and M1 remains unencrypted. Almost one year later, SNK decided to add one more layer, this time also encrypting M1. This new NEO-CMC chip had the '''050''' reference and was found in the following cartridges:
*[[Jockey Grand Prix]]
*[[The King of Fighters 2000]]
*[[The King of Fighters 2001]]
*[[Metal Slug 4]]
*[[Rage of the Dragons]]
*[[The King of Fighters 2002]]
*[[Matrimelee]]
*[[Pochi and Nyaa]]
*[[Metal Slug 5]]
*[[SNK vs. Capcom - SVC Chaos]]
*[[Samurai Shodown V]]
*[[The King of Fighters 2003]]
*[[Samurai Shodown V Special]]

To this day, no one has produced a reproduction of these chips.

==Fix handling==

See [[fix bankswitching]].

==Encryption==

Todo.

=Pinout=
[[File:Neocmc_7050_7042_pinout.png|x600px]]

OpenOffice Draw file: [[File:Neocmc_7050_7042.odg]]

'''Signals:'''
CXe_D[0..15]: C odd data bus
CXo_D[0..15]: C even data bus
CX_A[0..21]: C1~8 address bus (NEO-MVS & NEO-AEG)
CX_A[0..'''22''']: C1~4 address bus ('''NEO-MVH only''')

Pin : 32 connects to Mitsumi (PST600D) reset generator to re-initialize the NEO-CMC in case of power failure.
Pins: 87 and 88 contains a RC circuit clock driver like in a 8085 with X1 and X2 pinouts
Pins: 89 and 92 are interconnected.
-----------------------------------------------
Pins: 62~69, 71~78, 80~84 are configured in:
'''NEO-MVS CHAFIO''' as '''CR31~CR24, CR23~CR16, CR15~CR11''' respectively
NEO-AEG CHAFIO as ''' NC~NC , NC~NC , NC~NC'''
-----------------------------------------------
Pins: 102, 103~106, 107~110, 112~113 are configured in:
'''NEO-MVS CHAFIO''' as '''CR10, CR9~CR6 , CR5~CR2 , CR1~CR0'''
NEO-AEG CHAFIO as '''NC ,GBD3~GBD0, GAD3~GAD0, DOTB~DOTA'''
-----------------------------------------------
Pin : 94 is configured in:
'''NEO-MVS CHAFIO''' as '''NC '''
NEO-AEG CHAFIO as '''12M'''
-----------------------------------------------
Pin :147 is configured in:
'''NEO-MVS CHAFIO''' (2003.07.24) as M1_CE
'''NEO-MVS CHAFIO''' (1999.06.14) as NC
NEO-AEG CHAFIO (2003.07.24) as M1_CE
NEO-AEG CHAFIO (1999.08.10) as NC
-----------------------------------------------
Pin :153 is configured in:
NEO-MVS (ALL) as '''VCC'''
NEO-AEG (ALL) as GND

'''Comparing MVH PCBs vs MVS & AES Cartridges'''
Pin :147 is configured in:
'''NEO-MVH MVOC (2003.11.03)''' as '''M1_CE''' (KOF2003 pcb)
'''NEO-MVH MVOBR (2003.08.04)''' as '''M1_CE''' (MSLUG5 pcb)
'''NEO-MVH MVOB (2003.07.09)''' as '''NC ''' (SVC pcb) - '''M1_CE (fixed by wirewrapps)'''
'''NEO-MVH MVO (2003.06.05)''' as '''NC ''' (SVC pcb)
NEO-MVS CHAFIO (2003.07.24) as M1_CE
NEO-MVS CHAFIO (1999.06.14) as NC
NEO-AEG CHAFIO (2003.07.24) as M1_CE
NEO-AEG CHAFIO (1999.08.10) as NC
-----------------------------------------------
Pin :152 is configured in:
'''NEO-MVH (MVOC)''' as '''VCC'''
'''NEO-MVH (MVO, MVOB, MVOBR)''' as '''GND'''
NEO-MVS (ALL) as GND
NEO-AEG (ALL) as GND
-----------------------------------------------
Pin :153 is configured in:
'''NEO-MVH (ALL)''' as '''VCC'''
NEO-MVS (ALL) as '''VCC'''
NEO-AEG (ALL) as GND
-----------------------------------------------
Pin :154 is configured in:
'''NEO-MVH (MVO, MVOB, MVOBR, MVOC)''' as '''C2C1_OE'''
NEO-MVS (ALL) as NC
NEO-AEG (ALL) as NC
-----------------------------------------------
Pin :155 is configured in:
'''NEO-MVH (MVO, MVOB, MVOBR, MVOC)''' as '''C4C3_OE'''
NEO-MVS (ALL) as NC
NEO-AEG (ALL) as NC
-----------------------------------------------
Pin :158 is configured in:
'''NEO-MVH (MVO, MVOB, MVOBR, MVOC)''' as '''NC'''
NEO-MVS (ALL) as C8C7_OE
NEO-AEG (ALL) as C8C7_OE
-----------------------------------------------
Pin :159 is configured in:
'''NEO-MVH (MVO, MVOB, MVOBR)''' as '''NC'''
'''NEO-MVH (MVOC)''' as '''C6C5_OE'''
NEO-MVS (ALL) as '''C6C5_OE'''
NEO-AEG (ALL) as '''C6C5_OE'''
-----------------------------------------------
Pin :160 is configured in:
'''NEO-MVH (MVO, MVOB, MVOBR)''' as '''NC'''
'''NEO-MVH (MVOC)''' as '''C4C3_OE'''
NEO-MVS (ALL) as '''C4C3_OE'''
NEO-AEG (ALL) as '''C4C3_OE'''
-----------------------------------------------
Pin :161 is configured in:
'''NEO-MVH (MVO, MVOB, MVOBR)''' as '''NC'''
'''NEO-MVH (MVOC)''' as '''C2C1_OE'''
NEO-MVS (ALL) as '''C2C1_OE'''
NEO-AEG (ALL) as '''C2C1_OE'''
-----------------------------------------------
Pin :189 is configured in:
'''NEO-MVH (MVO, MVOB, MVOBR, MVOC)''' as '''A22''' (128Mbit) (connected from CMC to the driver input and from output to C ROM's A22)
NEO-MVS (ALL) as NC
NEO-AEG (ALL) as NC
-----------------------------------------------
Pin :190 is connected from CMC to the driver input, but NC from it's output:
'''NEO-MVH (MVO, MVOB, MVOBR, MVOC)''' as A23 (256Mbit) ('''assumption''' it's prepared for big size C ROMs )
NEO-MVS (ALL) as NC
NEO-AEG (ALL) as NC
-----------------------------------------------
Pin :191 is connected from CMC to the driver input, but NC from it's output:
'''NEO-MVH (MVO, MVOB, MVOBR, MVOC)''' as A24 (512Mbit) ('''assumption''' it's prepared for big size C ROMs)
NEO-MVS (ALL) as NC
NEO-AEG (ALL) as NC

'''Final Notes'''
'''NOTE1:''' There are no pinout differences between NEO-CMC42 and NEO-CMC50 however, differences can be spotted between previous and later board releases with respect to some setup lines and pin 147. A substantial setup difference can be found comparing the boards of AES and MVS releases. The way the chip access and delivery the graphic data is different between them and both configurations are available inside the NEO-CMC that is configured by the setup of the board itself. So the NEO-CMC is '''interchangeable between boards''' between MVS, AES, and MVH embedded. See the releases at ([[CHAFIO]])

'''NOTE2:''' In case somebody wonders, it's impossible to downgrade or upgrade NEO-CMCs between different versions (from 42 to 50 and vice-versa). The reason is that it's impossible without preparing the game for that and the algorithm to do it is unknown.

'''NOTE3:''' In MVH with embedded CHAFIO the NEO-CMC50 (pin 147 as M1_CE) is native present on the follow releases: 2003.08.04 (MSLUG 5) and 2003.11.03 (KOF2003). However on releases 2003.06.05 and 2003.07.09, both from SVCChaos (set1 and set2), that pin is natively configured as NC, but artificially fixed on set2 by wirewraps.

'''NOTE4:''' In MVH release '''2003.11.03 (KOF2003) only''', there is one configuration change that not appear in any other board AES, MVS or MVH. '''The pin 152 is connected to VCC'''. This require further investigation to check what's being switched. Perhaps from 64mbits to 128Mbits?

'''NOTE5:''' In MVH (ALL) the pins:
189 is connected to through buffer driver to A22 (128Mbit),
190 and 191 are pre-connected to the buffer drivers and left as NCs from there.
The assumption here is that the CMC is ready for bigger C Roms (256Mbit and 512Mbit).
Question: Would be easy left them shorted to VCC or GND. Why make parallel tracks without necessity?).

[[Category:Chips]]

Vector table swap

2025-01-03T05:39:02Z

Iq 132:

The first $80 bytes of the [[68k memory map]] are swappable between the onboard [[System ROM]] and the cartridge's first [[P ROM]].

When the vector tables are swapped, $00~$7F point to $C00000~$C0007F, and $C00000~$C0007F point to the data in the P ROM (if any).

On startup or reset, the first $80 bytes are those found at $C00000~$C0007F, so that the system always starts by executing the initialisation routine.

Right before starting a game, the cart's ROM is swapped in as well as the [[S ROM]] and [[M1 ROM]].

Registers {{Reg|REG_SWPBIOS}} and {{Reg|REG_SWPROM}} are used for this.

Note: The mapping of the P ROM to $C00000-$C0007F when swapping vectors is not emulated in MAME as of version 0.273.

[[Category:Code]]

PRG file

2025-01-02T17:50:25Z

Iq 132:

PRG files are used as the {{Chipname|68k}} program (the equivalent of [[P ROM]]s on [[:Category:cartridge systems|cartridge systems]], but the content '''isn't byteswapped'''). Several games overcome the [[DRAM|2MiB]] limit by keeping a main PRG file loaded, and only swap the ones containing data like level maps, animation tables...

Note that '''[[Logo file|LOGO_*.PRG files]] are handled differently'''.

* Maximum file size: 1MiB (?)
* Type code: 0
* Loadable in: 68k program DRAM ($000000~$1FFFFF)
* Banks: 1 ($000000~$1FFFFF). Range $100000~$1FFFFF is also used for [[68k user RAM]], [[system ROM]] operations, CD buffers, ...

'''Pitfalls:''' loading files over the range $100000-$10ffff will wipe all of the 68K's work (main) RAM. This is '''NOT''' advisable.

[[Category:CD systems]]

Loading files

2025-01-02T17:45:40Z

Iq 132:

[[BIOS calls]] '''BIOSF_LOADFILE''' ($C00552) and '''BIOSF_LOADFILEX''' ($C00564) are used to load files from the CD.

The '''BIOSF_LOADFILE''' call displays a loading animation, while BIOSF_LOADFILEX (better name ?) doesn't.

Register A0 needs to point to a block indicating:
*The filename, ended by a 0 byte
*The bank number (8bit)
*An optional pad byte to align:
*Destination address (32bit)
*Zero-terminated

Example:

<syntaxhighlight>
file_list
dc.b 'FILE1.SPR', $00 ; file name
dc.b $02 ; bank
dc.b $00 ; padding
dc.l $00000000 ; destination
dc.b 'FILE2.SPR', $00 ; file name
dc.b $03 ; bank
dc.b $00 ; padding
dc.l $00000000 ; destination
dc.b $00 ; End of list
</syntaxhighlight>

The destination memory is automatically chosen according to the file's extension.

Rules:
*[[SPR file]]s have 1MiB banks. [[PCM file]]s have 512KiB banks. Other types aren't banked.
*[[FIX file]]s and [[PCM file]]s need to have their destination address multiplied by 2.

BIOS RAM adresses for currently loaded sectors, total sectors ?...

'''Pitfalls:''' Interrupts must be enabled for file loading to function.

[[Category:CD systems]]
[[Category:Code]]

==Samurai Shodown RPG Loading==

Once the bios has handled the initial IPL loading for this game all other loading is handled by the game itself and not the bios calls above. The IPL loads file 'EXT_SYS.PRG' to 0x132000 and all known future 'in game' loading is handled by code in this area. Why the games uses this instead of the bios is not currently known but it may be related to the bios not being able to handle the amount of files stored on the CD disc (3831) or to optimize loading of the many small files used by the game.

This code will need investigating to obtain a full understanding of why it is used over the bios. There may also be other bios routines not related to loading used here too.

ACN file

2025-01-02T17:31:30Z

Iq 132: Iq 132 moved page ACN file to ACM file: Misspelled title: Typo

#REDIRECT [[ACM file]]

ACM file

2025-01-02T17:31:30Z

Iq 132: Iq 132 moved page ACN file to ACM file: Misspelled title: Typo

ACM files contain [[PCM file]] data.

We assume this is a kind of onboard Archive file to save constantly loading the data from CD.

How this data is used is not yet fully known. We currently assume data is stored in the program ROM space and then moved to the correct place as needed. It is not known if this is handled by the bios or game at present.

The game 'Art of Fighting' is known to use this file type (PCMB.ACM is a 100% match for PCMB.PCM).

[[Category:CD systems]]

ACM file

2025-01-02T17:30:10Z

Iq 132:

Loading files

2024-11-17T04:10:08Z

Iq 132:

[[BIOS calls]] '''BIOSF_LOADFILE''' ($C00552) and '''BIOSF_LOADFILEX''' ($C00564) are used to load files from the CD.

The '''BIOSF_LOADFILE''' call displays a loading animation, while BIOSF_LOADFILEX (better name ?) doesn't.

Register A0 needs to point to a block indicating:
*The filename, ended by a 0 byte
*The bank number (8bit)
*An optional pad byte to align:
*Destination address (32bit)
*Zero-terminated

Example:

<syntaxhighlight>
file_list
dc.b 'FILE1.SPR', $00 ; file name
dc.b $02 ; bank
dc.b $00 ; padding
dc.l $00000000 ; destination
dc.b 'FILE2.SPR', $00 ; file name
dc.b $03 ; bank
dc.b $00 ; padding
dc.l $00000000 ; destination
dc.b $00 ; End of list
</syntaxhighlight>

The destination memory is automatically chosen according to the file's extension.

Rules:
*[[SPR file]]s have 1MiB banks. [[PCM file]]s have 512KiB banks. Other types aren't banked.
*[[FIX file]]s and [[PCM file]]s need to have their destination address multiplied by 2.

BIOS RAM adresses for currently loaded sectors, total sectors ?...

[[Category:CD systems]]
[[Category:Code]]

==Samurai Shodown RPG Loading==

Once the bios has handled the initial IPL loading for this game all other loading is handled by the game itself and not the bios calls above. The IPL loads file 'EXT_SYS.PRG' to 0x132000 and all known future 'in game' loading is handled by code in this area. Why the games uses this instead of the bios is not currently known but it may be related to the bios not being able to handle the amount of files stored on the CD disc (3831) or to optimize loading of the many small files used by the game.

This code will need investigating to obtain a full understanding of why it is used over the bios. There may also be other bios routines not related to loading used here too.

Logo file

2024-11-15T13:04:09Z

Iq 132:

[[File:cdzload.png|frame|CDZ default loading screen.]]

[[File:kof96load.png|frame|KOF 96 custom loading screen (LOGO_E.PRG).]]

LOGO files are optional files used to create custom CD loading screens.

The [[system ROM]] automatically loads one of the following files according to the console's [[nationality]] setting, if present in the CD's root:

* LOGO_E.PRG for European nationality.
* LOGO_U.PRG for US nationality.
* LOGO_J.PRG for Japanese nationality.

The files must not be larger than ?? bytes. (KOF '99 uses 16.3KB files)

=File format=

{|class="wikitable"
!Size
!Description
|-
|Word
|Flags
|-
|Longword
|Data type
|-
|Longword
|Data pointer
|-
|Longword
|Data type
|-
|Longword
|Data pointer
|-
|...
|
|-
|Longword
|0xFFFFFFFF terminator
|-
|?
|Data previously pointed to...
|}

The first word represents flags:

* Bit 0: If set, do not draw the default 'NOW LOADING please wait' graphic (see picture top right).
* Bit 1: If set, no progress bar is drawn.
* Bit 2: If set, no animation is drawn.

No other bits seem to be checked by the system ROM.

The rest of the file's contents are "data type - pointer" longword pairs. The type codes used must be sorted in an ascending order. The file is terminated with a $FFFFFFFF type code. The valid type codes are:

*1: Fix tiles
*2: Palette
*3: Tile map
*4: Animation map

The pointer values are absolute, starting from $120000.

==Fix tiles data format==

* Offset (longword). Example: $4000 = start at tile #512
* Size (longword). Example: $2000 = load 256 tiles
* Tile data...

Like the regular [[fix graphics format]], but byteswapped.

==Palette data format==

* Palette number (word).
* 16 words of [[palettes|color data]].

Note: The default progress bar seems to use palette 0, be careful not to overwrite it. Remember that fix tiles can only use the 16 first palettes.

==Map data format==

All values are words.

* Start fix map address ($7102 is good).
* Width in tiles.
* Height in tiles.
* Fix tilemap data as found in [[VRAM]]...

Note: Mapping is done from left to right, top to bottom.

==Animation map data format==

All values are words.

* Start fix map address ($7102 is good).
* Width in tiles.
* Height in tiles.
* Number of frames in animation.
* Animation speed (in frames).
* Fix tilemap data as found in [[VRAM]]...

==Using LOGO files for in-game loading==

By default the system ROM will always use the initial LOGO file during in game loading sequences. It is possible to change this by loading new data over the buffered LOGO file data at $120000. How this gets loaded is not yet confirmed but its suspected that games request the data to be loaded as it would any other data given there is not need for 'LOGO' to be in the file name in this situation. It may also be possible the system ROM looks out for data being loaded into this region before drawing.

The ability to change the default progress bar (handled by the system ROM) is also available. The system ROM places the start address of its code to handle progress bar drawing at $11C80C. This code is then always called via 'MOVEA.L 0x11C80C,A0', 'JSR(A0)'. To use a custom progress bar simply place the start address of your custom progress bar code at $11C80C. Current progress bar state is held at address $10F691. Your code should handle all elements of drawing the progress bar.

It appears games plant their custom progress bar code into the default LOGO file as well as any further files that get loaded to this range. Below is the routine used by Samurai Shodown IV as seen in file 'JL_ST1.PRG' once in RAM. The main game program code places 0x120086 to $11C80C

<syntaxhighlight>
120086 4EF9 0012 4AD0 JMP 0x124AD0
</syntaxhighlight>

<syntaxhighlight>
124AD0 4DF9 003C 0000 LEA 0x3C0000,A6
124AD6 41F9 0012 4B00 LEA 0x124B00,A0
124ADC 1239 0010 F691 MOVE.B 0x10F691,D1
124AE2 0241 00F0 ANDI.W #0xF0,D1
124AE6 D0C1 ADDA.W D1,A0
124AE8 203C 719B A200 MOVE.L #0x719BA200,D0
124AEE 7E0F MOVEQ #0xF,D7
124AF0 1018 MOVE.B (A0)+,D0
124AF2 2C80 MOVE.L D0,(A6)
124AF4 0680 0020 0000 ADDI.L #0x200000,D0
124AFA 51CF FFF4 DBF D7,*-0xA [0xC00422]
124AFE 4E75 RTS
</syntaxhighlight>

==Additional Notes==
Attempting to load a LOGO with an Animation speed of less than 5 can cause crashes. [Tested on a Japanese region top loader with Neo CD Loader installed]
[[Category:CD systems]]

CARD

2024-08-21T15:42:37Z

Iq 132:

=CARD ($C00468)=

The CARD [[system ROM]] call is used to perform operations on the [[memory card]].

'''Warning:''' register contents aren't preserved !

==Variables==

The following variables are used when calling CARD:

{| class="regdef"
| '''Address'''
| '''DEF name'''
| '''Size'''
| '''Set by'''
| '''Description'''
|-
|$10FDC4
|BIOS_CARD_COMMAND
|byte
|System ROM or game
|Command code to execute
|-
|$10FDC6
|BIOS_CARD_ANSWER
|byte
|System ROM
|Answer code (see below)
|-
|$10FDC8
|BIOS_CARD_START
|longword
|System ROM or game
|Pointer to data
|-
|$10FDCC
|BIOS_CARD_SIZE
|word
|System ROM or game
|Size of data
|-
|$10FDCE
|BIOS_CARD_FCB
|word
|System ROM or game
|Game [[NGH number]]
|-
|$10FDD0
|BIOS_CARD_SUB
|byte or word
|System ROM or game
|Game save sub-number
|}

The following temporary variables are used when calling CARD :

{| class="regdef"
| '''Address'''
| '''DEF name'''
| '''Size'''
| '''Description'''
|-
|$10FD04
|BIOS_CARD_DIRECTORY_START
|long word
|Start of directory
|-
|$10FD08
|BIOS_CARD_BLOCK_NUMBER
|word
|Number of blocks
|-
|$10FD0A
|BIOS_CARD_FAT_START
|long word
|Start of FAT
|-
|$10FD0E
|BIOS_CARD_FAT_SIZE
|word
|Size of FAT
|-
|$10FD10
|BIOS_CARD_DATA_START
|long word
|Start of data
|-
|$10FD14
|BIOS_CARD_TYPE
|word
|
* $0 : 8 bits card
* $01 : 16 bits card
* $80 : 16 bits wide weird card (todo)
|-
|$10FD16
|BIOS_CARD_SIZE
|word
|Size of the card
|}

==BIOS_CARD_ANSWER==

This variable contains the result of the operation. Bit 7 indicates an error.

* $00: Normal completion
* $80: No card inserted
* $81: Card isn't formatted
* $82: Requested data doesn't exist
* $83: FAT error
* $84: Card is full
* $85: Write disabled or ROM card

=Commands=

==$0: Format memory card==

Formats the memory card.

==$1: Data search==

Return the number of save files for the specified game.

'''Inputs''':

BIOS_CARD_FCB must contain the NGH number of the desired game.

'''Outputs''':

BIOS_CARD_SUB contains a 16 bit mask for all 16 available blocks for the game. If a bit is set, then the corresponding save block exists.

==$2: Load data==

Loads the specified save file in RAM.

'''Inputs''':

* BIOS_CARD_FCB must contain the NGH number of the desired game.
* BIOS_CARD_SUB must contain the game save number (16 max. per game).
* BIOS_CARD_START must be a pointer to which the save data will be loaded.
* BIOS_CARD_SIZE must contain the size of the save (usually 64 bytes).

==$3: Save data==

Save from RAM to the specified save file.

'''Inputs''':

* BIOS_CARD_FCB must contain the NGH number of the desired game.
* BIOS_CARD_SUB must contain the game save number (16 max. per game).
* BIOS_CARD_START must be a pointer from which the save data will be copied.
* BIOS_CARD_SIZE must contain the size of the save (usually 64 bytes).

==$4: Delete data==

Delete the specified file.

'''Inputs''':

* BIOS_CARD_FCB must contain the NGH number of the desired game.
* BIOS_CARD_SUB must contain the game save number (16 max. per game).

==$5: Read data title==

Read the data title of a save file.

'''Inputs''':

* BIOS_CARD_START must be a pointer to which the title string will be copied.
* BIOS_CARD_SIZE must contain the game save number ?

==$6: Save user name==

Set the user name of the memory card.

'''Inputs''':

BIOS_CARD_START must be a pointer to the user name's string (max. 16 bytes).

==$7: Load user name==

Loads the user name of the memory card.

'''Inputs''':

BIOS_CARD_START must be a pointer to which the user name's string will be copied.

[[Category:BIOS calls]]

CARD

2024-08-21T15:42:15Z

Iq 132: Undo revision 8362 by Iq 132 (talk)

=CARD ($C00468)=

The CARD [[system ROM]] call is used to perform opeartions on the [[memory card]].

'''Warning:''' register contents aren't preserved !

==Variables==

The following variables are used when calling CARD:

{| class="regdef"
| '''Address'''
| '''DEF name'''
| '''Size'''
| '''Set by'''
| '''Description'''
|-
|$10FDC4
|BIOS_CARD_COMMAND
|byte
|System ROM or game
|Command code to execute
|-
|$10FDC6
|BIOS_CARD_ANSWER
|byte
|System ROM
|Answer code (see below)
|-
|$10FDC8
|BIOS_CARD_START
|longword
|System ROM or game
|Pointer to data
|-
|$10FDCC
|BIOS_CARD_SIZE
|word
|System ROM or game
|Size of data
|-
|$10FDCE
|BIOS_CARD_FCB
|word
|System ROM or game
|Game [[NGH number]]
|-
|$10FDD0
|BIOS_CARD_SUB
|byte or word
|System ROM or game
|Game save sub-number
|}

The following temporary variables are used when calling CARD :

{| class="regdef"
| '''Address'''
| '''DEF name'''
| '''Size'''
| '''Description'''
|-
|$10FD04
|BIOS_CARD_DIRECTORY_START
|long word
|Start of directory
|-
|$10FD08
|BIOS_CARD_BLOCK_NUMBER
|word
|Number of blocks
|-
|$10FD0A
|BIOS_CARD_FAT_START
|long word
|Start of FAT
|-
|$10FD0E
|BIOS_CARD_FAT_SIZE
|word
|Size of FAT
|-
|$10FD10
|BIOS_CARD_DATA_START
|long word
|Start of data
|-
|$10FD14
|BIOS_CARD_TYPE
|word
|
* $0 : 8 bits card
* $01 : 16 bits card
* $80 : 16 bits wide weird card (todo)
|-
|$10FD16
|BIOS_CARD_SIZE
|word
|Size of the card
|}

==BIOS_CARD_ANSWER==

This variable contains the result of the operation. Bit 7 indicates an error.

* $00: Normal completion
* $80: No card inserted
* $81: Card isn't formatted
* $82: Requested data doesn't exist
* $83: FAT error
* $84: Card is full
* $85: Write disabled or ROM card

=Commands=

==$0: Format memory card==

Formats the memory card.

==$1: Data search==

Return the number of save files for the specified game.

'''Inputs''':

BIOS_CARD_FCB must contain the NGH number of the desired game.

'''Outputs''':

BIOS_CARD_SUB contains a 16 bit mask for all 16 available blocks for the game. If a bit is set, then the corresponding save block exists.

==$2: Load data==

Loads the specified save file in RAM.

'''Inputs''':

* BIOS_CARD_FCB must contain the NGH number of the desired game.
* BIOS_CARD_SUB must contain the game save number (16 max. per game).
* BIOS_CARD_START must be a pointer to which the save data will be loaded.
* BIOS_CARD_SIZE must contain the size of the save (usually 64 bytes).

==$3: Save data==

Save from RAM to the specified save file.

'''Inputs''':

* BIOS_CARD_FCB must contain the NGH number of the desired game.
* BIOS_CARD_SUB must contain the game save number (16 max. per game).
* BIOS_CARD_START must be a pointer from which the save data will be copied.
* BIOS_CARD_SIZE must contain the size of the save (usually 64 bytes).

==$4: Delete data==

Delete the specified file.

'''Inputs''':

* BIOS_CARD_FCB must contain the NGH number of the desired game.
* BIOS_CARD_SUB must contain the game save number (16 max. per game).

==$5: Read data title==

Read the data title of a save file.

'''Inputs''':

* BIOS_CARD_START must be a pointer to which the title string will be copied.
* BIOS_CARD_SIZE must contain the game save number ?

==$6: Save user name==

Set the user name of the memory card.

'''Inputs''':

BIOS_CARD_START must be a pointer to the user name's string (max. 16 bytes).

==$7: Load user name==

Loads the user name of the memory card.

'''Inputs''':

BIOS_CARD_START must be a pointer to which the user name's string will be copied.

[[Category:BIOS calls]]

CARD

2024-08-21T15:41:51Z

Iq 132:

=CARD ($C00468)=

The CARD [[system ROM]] call is used to perform operation on the [[memory card]].

'''Warning:''' register contents aren't preserved !

==Variables==

The following variables are used when calling CARD:

{| class="regdef"
| '''Address'''
| '''DEF name'''
| '''Size'''
| '''Set by'''
| '''Description'''
|-
|$10FDC4
|BIOS_CARD_COMMAND
|byte
|System ROM or game
|Command code to execute
|-
|$10FDC6
|BIOS_CARD_ANSWER
|byte
|System ROM
|Answer code (see below)
|-
|$10FDC8
|BIOS_CARD_START
|longword
|System ROM or game
|Pointer to data
|-
|$10FDCC
|BIOS_CARD_SIZE
|word
|System ROM or game
|Size of data
|-
|$10FDCE
|BIOS_CARD_FCB
|word
|System ROM or game
|Game [[NGH number]]
|-
|$10FDD0
|BIOS_CARD_SUB
|byte or word
|System ROM or game
|Game save sub-number
|}

The following temporary variables are used when calling CARD :

{| class="regdef"
| '''Address'''
| '''DEF name'''
| '''Size'''
| '''Description'''
|-
|$10FD04
|BIOS_CARD_DIRECTORY_START
|long word
|Start of directory
|-
|$10FD08
|BIOS_CARD_BLOCK_NUMBER
|word
|Number of blocks
|-
|$10FD0A
|BIOS_CARD_FAT_START
|long word
|Start of FAT
|-
|$10FD0E
|BIOS_CARD_FAT_SIZE
|word
|Size of FAT
|-
|$10FD10
|BIOS_CARD_DATA_START
|long word
|Start of data
|-
|$10FD14
|BIOS_CARD_TYPE
|word
|
* $0 : 8 bits card
* $01 : 16 bits card
* $80 : 16 bits wide weird card (todo)
|-
|$10FD16
|BIOS_CARD_SIZE
|word
|Size of the card
|}

==BIOS_CARD_ANSWER==

This variable contains the result of the operation. Bit 7 indicates an error.

* $00: Normal completion
* $80: No card inserted
* $81: Card isn't formatted
* $82: Requested data doesn't exist
* $83: FAT error
* $84: Card is full
* $85: Write disabled or ROM card

=Commands=

==$0: Format memory card==

Formats the memory card.

==$1: Data search==

Return the number of save files for the specified game.

'''Inputs''':

BIOS_CARD_FCB must contain the NGH number of the desired game.

'''Outputs''':

BIOS_CARD_SUB contains a 16 bit mask for all 16 available blocks for the game. If a bit is set, then the corresponding save block exists.

==$2: Load data==

Loads the specified save file in RAM.

'''Inputs''':

* BIOS_CARD_FCB must contain the NGH number of the desired game.
* BIOS_CARD_SUB must contain the game save number (16 max. per game).
* BIOS_CARD_START must be a pointer to which the save data will be loaded.
* BIOS_CARD_SIZE must contain the size of the save (usually 64 bytes).

==$3: Save data==

Save from RAM to the specified save file.

'''Inputs''':

* BIOS_CARD_FCB must contain the NGH number of the desired game.
* BIOS_CARD_SUB must contain the game save number (16 max. per game).
* BIOS_CARD_START must be a pointer from which the save data will be copied.
* BIOS_CARD_SIZE must contain the size of the save (usually 64 bytes).

==$4: Delete data==

Delete the specified file.

'''Inputs''':

* BIOS_CARD_FCB must contain the NGH number of the desired game.
* BIOS_CARD_SUB must contain the game save number (16 max. per game).

==$5: Read data title==

Read the data title of a save file.

'''Inputs''':

* BIOS_CARD_START must be a pointer to which the title string will be copied.
* BIOS_CARD_SIZE must contain the game save number ?

==$6: Save user name==

Set the user name of the memory card.

'''Inputs''':

BIOS_CARD_START must be a pointer to the user name's string (max. 16 bytes).

==$7: Load user name==

Loads the user name of the memory card.

'''Inputs''':

BIOS_CARD_START must be a pointer to which the user name's string will be copied.

[[Category:BIOS calls]]

BIOSF UPLOAD

2024-05-15T20:15:02Z

Iq 132:

The BIOSF_UPLOAD ($C00546) call copies data to the NeoGeo CD [[DRAM]].

The parameters are:

*{{BR|BIOS_UPSRC}} (longword): Data source address
*{{BR|BIOS_UPDEST}} (longword): Data destination address
*{{BR|BIOS_UPSIZE}} (longword): Data size
*{{BR|BIOS_UPZONE}} (byte): Zone/method, see below
*{{BR|BIOS_UPBANK}} (byte): DRAM bank

When the call returns, BIOS_UPDEST points to the end of the copied data, allowing multiple consecutive uploads without setting the destination address again.

=Banks=

Some DRAM zones have banks: SPR has 4 banks (each 1MiB), PCM has 2 banks (each 512KiB).

=Zones/methods=

==$00: Copy PRG words (DMA)==
Loads word copy DMA microcode.

==$01: Copy Fix graphics bytes (DMA)==
Loads byte copy DMA microcode. Dest = Dest + Size * 2.

==$02: Copy Sprite graphics words (DMA)==
Loads word copy DMA microcode. Copies over 1MiB are possible, the bank is incremented automatically.

==$03: Copy Z80 program bytes (DMA)==
Loads byte copy DMA microcode.

The destination address must be multiplied by 2 (8bit bus) ? Size doesn't have to be multiplied, but has to be an even number ?

==$04: Copy PCM bytes (CPU)==
Loads byte copy DMA microcode.

The destination address must be multiplied by 2 (8bit bus). Size doesn't have to be multiplied, but has to be an even number. Copies over 1MiB are possible, the bank is incremented automatically.

==$05: Install [[PAT file]]==
Notes:
*10F736.l=((Bank*$10000)+Dest)/256
*10F736+Address/2

==$06: Copy palette words (DMA)==
Loads word copy DMA microcode.

==$07: Copy compressed sprite graphics (CPU)==
The first longword's value indicates the size of the '''compressed''' data, BIOS_UPSIZE isn't used.
When a longword zero is copied, the following longword indicates how many zero longwords to insert.

This method allows compression of large transparent zones. Is it ever used by games ?

==$08: Copy PRG words (DMA)==
Same as method $00.

==$10: Copy PRG longwords (CPU)==
Size must be a multiple of 4.

==$11: Copy Fix graphics words (CPU)==
The destination address must be multiplied by 2 (8bit bus). Size doesn't have to be multiplied, but has to be an even number.

==$12: Copy Sprite graphics longwords (CPU)==
Size must be a multiple of 4.

==$13: Copy Z80 program bytes (CPU)==
The destination address must be multiplied by 2 (8bit bus). Size doesn't have to be multiplied, but has to be an even number.

==$14: Copy PCM bytes (CPU)==
The destination address must be multiplied by 2 (8bit bus). Size doesn't have to be multiplied, but has to be an even number. Copies over 1MiB are possible, the bank is incremented automatically.

Difference with $04 ?

==$15: Install PAT file==
Same as method $05.

==$16: Copy palette longwords (CPU)==
Size must be a multiple of 4.

==$17: Copy compressed sprite graphics (CPU)==
Same as method $07.

==$18: Copy PRG longwords (CPU)==
Same as method $10.

[[Category:BIOS calls]]

Emulators

2023-08-15T18:37:39Z

Iq 132: Alphabetize

{| align="center" class="regdef"
|
|'''Platform'''
|'''MVS/AES'''
|'''CD/CDZ'''
|'''Raster line rendering'''
|'''Debugger'''
|'''[[Shot factory]]'''
|'''[[Universe BIOS|UniBIOS]] support'''
|'''[[Debug DIPs]]'''
|'''Source available'''
|-
|[https://github.com/finalburnneo/FBNeo/releases/tag/latest '''FinalBurn Neo''']
|Windows/Various
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes (Enabled per game)
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|-
|[http://gngeo.berlios.de/?page=download '''GnGeo''']
|GP2X Linux
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes (needs to be activated)
|bgcolor="#DDD"|?
|bgcolor="#DDD"|?
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|?
|bgcolor="#8F8"|Yes
|-
| [https://github.com/dciabrin/gngeo '''GnGeo''' (ngdevkit fork)]
| Linux
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes? (needs to be activated?)
|bgcolor="#8F8"|Yes (gdb)
|bgcolor="#DDD"|?
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|?
|bgcolor="#8F8"|Yes
|-
|[http://cps2shock.emu-france.info/download.html '''Kawaks''']
|Windows
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|-
|[http://mamedev.org/release.html '''MAME''']
|Linux, Windows
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|-
|[http://pacifi3d.retrogames.com/neocdsdl/ '''NeoCD''']
|BeOS, Dreamcast, Linux, PS2, Windows
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|?
|bgcolor="#F88"|No
|bgcolor="#F88"|No
|/
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|-
|[http://nebula.emulatronia.com/descargas.php '''Nebula''']
|Windows
|bgcolor="#DDD"|No ?
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Conditional
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|/
|bgcolor="#8F8"|Yes (uneffective ?)
|bgcolor="#F88"|No
|-
|[http://caesar.logiqx.com/php/emulator.php?id=neoragex '''NeoRage X''']
|Windows
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#DDD"|No ?
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|?
|bgcolor="#DDD"|No?
|bgcolor="#DDD"|No?
|-
|[http://raine.1emulation.com/download/latest.html '''NeoRaine''']
|Mac, Windows
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes, command line
|bgcolor="#F88"|No
|/
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|-
|[http://www.xe-emulator.com/index.php?m=download '''XE''']
|Linux, Windows
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|Yes ?
|bgcolor="#DDD"|No ?
|bgcolor="#DDD"|?
|bgcolor="#DDD"|Yes ?
|bgcolor="#DDD"|?
|bgcolor="#F88"|No
|}

[[Category:Tools]]

Emulators

2023-08-15T18:35:45Z

Iq 132: Add FinalBurn Neo.

{| align="center" class="regdef"
|
|'''Platform'''
|'''MVS/AES'''
|'''CD/CDZ'''
|'''Raster line rendering'''
|'''Debugger'''
|'''[[Shot factory]]'''
|'''[[Universe BIOS|UniBIOS]] support'''
|'''[[Debug DIPs]]'''
|'''Source available'''
|-
|[https://github.com/finalburnneo/FBNeo/releases/tag/latest '''FinalBurn Neo''']
|Windows/Various
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes (When required)
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|-
|[http://cps2shock.emu-france.info/download.html '''Kawaks''']
|Windows
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|-
|[http://caesar.logiqx.com/php/emulator.php?id=neoragex '''NeoRage X''']
|Windows
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#DDD"|No ?
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|?
|bgcolor="#DDD"|No?
|bgcolor="#DDD"|No?
|-
|[http://gngeo.berlios.de/?page=download '''GnGeo''']
|GP2X Linux
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes (needs to be activated)
|bgcolor="#DDD"|?
|bgcolor="#DDD"|?
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|?
|bgcolor="#8F8"|Yes
|-
| [https://github.com/dciabrin/gngeo '''GnGeo''' (ngdevkit fork)]
| Linux
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes? (needs to be activated?)
|bgcolor="#8F8"|Yes (gdb)
|bgcolor="#DDD"|?
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|?
|bgcolor="#8F8"|Yes
|-
|[http://mamedev.org/release.html '''MAME''']
|Linux, Windows
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|-
|[http://pacifi3d.retrogames.com/neocdsdl/ '''NeoCD''']
|BeOS, Dreamcast, Linux, PS2, Windows
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|?
|bgcolor="#F88"|No
|bgcolor="#F88"|No
|/
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|-
|[http://nebula.emulatronia.com/descargas.php '''Nebula''']
|Windows
|bgcolor="#DDD"|No ?
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Conditional
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|/
|bgcolor="#8F8"|Yes (uneffective ?)
|bgcolor="#F88"|No
|-
|[http://raine.1emulation.com/download/latest.html '''NeoRaine''']
|Mac, Windows
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes, command line
|bgcolor="#F88"|No
|/
|bgcolor="#F88"|No
|bgcolor="#8F8"|Yes
|-
|[http://www.xe-emulator.com/index.php?m=download '''XE''']
|Linux, Windows
|bgcolor="#8F8"|Yes
|bgcolor="#8F8"|Yes
|bgcolor="#DDD"|Yes ?
|bgcolor="#DDD"|No ?
|bgcolor="#DDD"|?
|bgcolor="#DDD"|Yes ?
|bgcolor="#DDD"|?
|bgcolor="#F88"|No
|}

[[Category:Tools]]

PROGBK1

2023-08-15T18:28:58Z

Iq 132: V ROM 32MiB type

[[File:Progbk1_mvs.jpg|thumb]]

The only non-protected board that can bankswitch and use all [[V ROM]] space. Really common and very useful for homebrew stuff or converts.

Often used as the PROG board in [[Neo Print]] cartridges.

=P ROMs configuration=

[[File:Progbk1p.png|650px]]

==EP ROMs /OE==

{| class="wikitable"
|-
!J1
!J2
|-
|/ROMOE
|/PORTOE
|}

==P2 ROM /CE==

{| class="wikitable"
|-
!J3
!J4
!J5
|-
|A18
|/A18
|GND (default)
|}

==P2 ROM /OE==

{| class="wikitable"
|-
!J6
!J7
!JB1
|-
|/ROMOE
|/PORTOE (default)
|/PORTOE, banks 0 and 1
|}

==P1 ROM /OE==

{| class="wikitable"
|-
!J8
!J9
!J10
!JB2
|-
|/PORTOE
|/PORTOE AND /ROMOE
|/ROMOE (default)
|/PORTOE, banks 2 and 3
|}

==P1 ROM /CE==

{| class="wikitable"
|-
!J11
!J12
!J13
|-
|A18
|/A18
|GND (default)
|}

==P1 ROM size==

{| class="wikitable"
|-
!JB3
!JB4
!Nothing
|-
|A19/NC is /PORTADRS (P1 is 16Mbit)
|A19/NC is BANK0 (because reasons?)
|P1 is 8Mbit
|}

==P2 ROM size==

{| class="wikitable"
|-
!JB5
!JB6
|-
|A20//BYTE is VCC (P2 is 16Mbit or less)
|A20//BYTE is BANK1 (P2 is 32Mbit)
|}

The [[P ROM|P1 ROM]] can be 4Mbit, 8Mbit or 16Mbit (27C400/27C800/27C160).
* ROMs can be halved and mapped to 0x000000~0x0FFFFF or 0x200000~0x2FFFFF.
* If P1 is 4Mbit or 8Mbit, then P2 can contain a bankswitched ROM (same type as P1 plus 27C322). P1 appears in 0x000000~0x0FFFFF. P2 bank appears in 0x200000~0x2FFFFF.

[[Bankswitching]] is done with the LS74. It's not needed if the game isn't banked. Any write to an odd address in the [[68k memory map|0x200000~0x2FFFFF]] range will set the bank.

=V ROMs configuration=

[[File:Progbk1v.png]]

There is a maximum of 4 [[V ROM]]s which can be 8Mbit, 16Mbit or 32Mbit (27C800/27C160/27C322) for a maximum total size of 4 * 4MiB = 16MiB.

A 4Mbit ROM can also be used, but only if there's one and only if it's in the last used slot.

The size of the largest V ROM is selected with a pair of jumpers on 6 spots (3 possible choices).

{| class="wikitable"
|-
!Largest V ROM
!Jumper set
|-
|8Mbit (1MiB)
|JV1+JV2
|-
|16Mbit (2MiB)
|JV3+JV4
|-
|32Mbit (4MiB)
|JV5+JV6
|}

This pair of V ROM jumpers effectively choose a set of 2 of the [[PCM]] chip address outputs to input to the LS139, which will enable one out of the 4 V ROMs at a time.

The JV7 to JV14 jumpers need to be set according to the ROM types. If it's less than 32Mbit, the JV7/JV8/JV9/JV10 jumper needs to be set (ground). If it's 32Mbit, the JV11/JV12/JV13/JV14 needs to be set (A20). This is because 32Mbit chips have their /BYTE pin replaced by A20.

=Other=

The LS08 is used to AND the /PORTOEU and /PORTOEL signals to get /PORTOE.

* 4x 1/2/4MiB V ROMs
* 1/2MiB P1 ROM
* 1/2/4MiB P2 ROM
* 2x 512KiB EP1/EP2 ROM
* {{Chipname|PCM}} chip
* LS139, LS08, LS74A

[[Category:Cartridge boards]]

CHA256

2023-08-15T17:15:25Z

Iq 132: CHA doesn't have J14/J15/J16/J17 - it has R1/R2/R3/R4 - Verified w/CHA256 games via MVS Scans.

[[File:Cha256_mvs.jpg|thumb|256px]]

===C ROMs===

Up to 8 * 32Mbit ROMs (27C322) can be used for a maximum of 256Mbit. 27C800/27C160 can also be used depending on jumper configuration.

The size of largest ROM is selected using a pair of jumpers. The rest should be left unconnected.

{| class="wikitable"
|-
!Largest C ROM
!Jumper set
|-
|1MiB
|J5+J6
|-
|2MiB
|J7+J8
|-
|4MiB
|J9+J10
|}

These jumpers seem to apply only to those two ROMs, if the ROMs are not present, simply leave both jumpers unconnected.

{| class="wikitable"
|-
!C1/2 ROM type
!Jumper set
|-
|<4MiB
|R1
|-
|4MiB
|J11
|}

{| class="wikitable"
|-
!C3/4 ROM type
!Jumper set
|-
|<4MiB
|R2
|-
|4MiB
|J12
|}

{| class="wikitable"
|-
!C5/6 ROM type
!Jumper set
|-
|<4MiB
|R3
|-
|4MiB
|J13
|}

{| class="wikitable"
|-
!C7/8 ROM type
!Jumper set
|-
|<4MiB
|R4
|-
|4MiB
|J14
|}

A [[NEO-273]] and a LS74 are used to address C ROM. The LS74 provides the 2 most significant bits. The LS139 enables one of four pairs of C ROMs using 2 address inputs depending on which 2 jumpers are connected.

*Max 256Mbit C ROM (8x 32Mbit)

{| class="wikitable"
|-
!M1 ROM size
!Jumper set
|-
|64KiB
|J1+J4
|-
|128KiB
|J2+J3
|}

*[[NEO-273]]
*[[NEO-ZMC]]
*LS139,LS74

==AES version==

{| class="wikitable"
|-
!C ROM type
!Jumper set
|-
|<4MiB
|J15+J16+J17+J18
|-
|4MiB
|J11+J12+J13+J14
|}

{| class="wikitable"
|-
!EVEN delay
!Jumper set
|-
|1 gate
|J19
|-
|2 gates
|J20
|}

[[Category:Cartridge boards]]