View source for FDS disk format

The [[Famicom Disk System]] uses disks that are a modified version of Mitsumi Quick Disk hardware, with a custom data format stored on the disk.

Each side can hold more than 64KB of data.

For archive and emulation, dumps of these disks are often preserved using the [[FDS file format]] (.FDS).

== FDS Disk Side format ==

Each disk side must be structured into block as follows :

1, 2, 3, 4, 3, 4, ...., 3, 4

The 3, 4 pattern should be repeated once per file present on the disk.

Blocks type 1 and 2 represent information about the disk and how many files it has, and each block type 3 and 4 pair represents a single file.
See ''[[#Block format|Block format]]'' below.

=== Gaps ===

Physically on the disc, there are "gaps" of 0 recorded between blocks and before the start of the disc.
Length of the gaps are as follows:
* Before the start of the disc : At least 26150 bits, 28300 typical.
* Gap between blocks : At least 480 bits, 976 bits typical.

Gaps are teminated by a single '1' bit. In terms of bytes, it would be $80, as the data is stored in little endian format.

=== CRCs ===

At the end of each block, a 16-bit CRC is stored. On loading, the CRC is *not* calculated by the 6502 in the BIOS, but by the RAM adapter, which monitors disc transfers and calculates the CRC. It will automatically send an error code if both CRCs doesn't match.

=== True disc capacity ===

In the commonly used [[FDS file format]], its disk image size is limited to 65500 bytes, but does not contain CRCs or gaps.

The actual disk capacity is somewhat larger, and there are a few variant disk formats that may have even more capacity.

== Block format ==

=== Disk info block (block 1) ===

{| class="wikitable"
|-
! Offset !! Length (bytes) !! Description !! Details
|-
| $00 || 1 || Block code || Raw byte: $01
|-
| $01 || 14 || Disk verification || Literal ASCII string: <tt>*NINTENDO-HVC*</tt><br />Used by BIOS to verify legitimate disk image
|-
| $0F || 1 || Manufacturer code || See [[#Manufacturer_codes|Manufacturer codes]]
|-
| $10 || 3 || Game name || 3-letter ASCII code per game (e.g. ZEL for The Legend of Zelda)
|-
| $13 || 1 || Game type || $20 = <tt>" "</tt> &mdash; Normal disk<br />$45 = <tt>"E"</tt> &mdash; Event (e.g. Japanese national [http://ja.wikipedia.org/wiki/%E3%83%95%E3%82%A1%E3%83%9F%E3%83%AA%E3%83%BC%E3%82%B3%E3%83%B3%E3%83%94%E3%83%A5%E3%83%BC%E3%82%BF_%E3%83%87%E3%82%A3%E3%82%B9%E3%82%AF%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0#.E3.83.87.E3.82.A3.E3.82.B9.E3.82.AF.E3.83.95.E3.82.A1.E3.82.AF.E3.82.B9 DiskFax] tournaments)<br />$52 = <tt>"R"</tt> &mdash; Reduction in price via advertising
|-
| $14 || 1 || Game version/revision number || Starts at $00, increments per revision
|-
| $15 || 1 || Side number || $00 = Side A, $01 = Side B.  Single-sided disks use $00
|-
| $16 || 1 || Disk number || First disk is $00, second is $01, etc.
|-
| $17 || 1 || Disk type || $00 = FMC ("normal card"), $01 = FSC ("card with shutter").  May correlate with [http://famicomworld.com/workshop/articles/product-codes-fmc-and-fsc/ FMC and FSC product codes]
|-
| $18 || 1 || Unknown || Speculative: (Err.10) Possibly indicates disk #; usually $00<br />Speculative: $00 = yellow disk, $01 = blue or gold disk, $FE = white disk, $FF = blue disk
|-
| $19 || 1 || Boot read file code || Refers to the file code/file number to load upon boot/start-up
|-
| $1A || 5 || Unknown || Raw bytes: $FF $FF $FF $FF $FF
|-
| $1F || 3 || Manufacturing date || See [[#Date_format|Date format]]
|-
| $22 || 1 || Country code || $49 = Japan
|-
| $23 || 1 || Unknown || Raw byte: $61.  Speculative: Region code?
|-
| $24 || 1 || Unknown || Raw byte: $00.  Speculative: Location/site?
|-
| $25 || 2 || Unknown || Raw bytes: $00 $02
|-
| $27 || 5 || Unknown || Speculative: some kind of game information representation?
|-
| $2C || 3 || "Rewritten disk" date || See [[#Date_format|Date format]].  It's speculated this refers to the date the disk was formatted and rewritten by something like a [http://www.nintendolife.com/news/2014/03/weirdness_this_footage_of_the_famicom_disk_writer_kiosk_is_a_bit_awesome Disk Writer kiosk].<br />In the case of an original (non-copied) disk, this should be the same as [[#Manufacturing_date|Manufacturing date]]
|-
| $2F || 1 || Unknown ||
|-
| $30 || 1 || Unknown || Raw byte: $80
|-
| $31 || 2 || Disk Writer serial number ||
|-
| $33 || 1 || Unknown || Raw byte: $07
|-
| $34 || 1 || Disk rewrite count || Value stored in [[wikipedia:Binary-coded_decimal|BCD]] format.  $00 = Original (no copies).  Also see [[#Price|Price]]
|-
| $35 || 1 || Actual disk side || $00 = Side A, $01 = Side B
|-
| $36 || 1 || Unknown ||
|-
| $37 || 1 || Price || See [[#Price|Price]]
|-
| $38 || 2 || CRC || (Omitted from .FDS files)
|-
|}

The <tt>*NINTENDO-HVC*</tt> string, stored in ASCII, proves that this is a FDS disk. If the string doesn't match, the BIOS will refuse to read the disk further.

If the FDS is started with a disk whose side number and disk number aren't both $00, it will be prompted to insert the first disk side. However, some games make this number $00, even for the second disk to make it bootable too.

All files with IDs smaller or equals to the ''boot read file code'' will be loaded when the game is booting.

The FDS also has a trademark security system similar to [http://segaretro.org/TradeMark_Security_System what Sega used on some of its consoles]:

:The 224-byte text at PPU $2800-$28DF must match the data in the BIOS, starting at $ED37.

:This data contains an English licensing message stored in the SMB1/Zelda character encoding. The BIOS ensures that it is present in the nametable and displays it on the screen for several seconds after the boot files are loaded.

:Traditionally, the first file on a disk is a nametable type file loaded into $2800, which is named <code>KYODAKU-</code> (きょだく or [[wiktionary:許|許]][[wiktionary:諾|諾]] means approval). It must be one of the boot files, or the license message test will fail (error 20) before it proceeds to run the program.

:The license screen test and display can be bypassed by using a boot file to enable NMIs, which will interrupt the boot loading process early.<ref>[//forums.nesdev.com/viewtopic.php?p=194826#p194826 Forum post]: Skipping FDS license screen?</ref>

==== Date format ====

All bytes are stored in BCD format, in order of year, month, and day.  To accurately calculate they year, add 1925 to the BCD value.  For example, values of $63 $11 $28 would represent November ($11) 28th ($28), 1988 ($63 + 1925).  The "magic year" of 1925 comes from the Japanese [[wikipedia:Sh%C5%8Dwa_period|Shōwa period]], despite the era only lasting from 1925 until 1989.  Titles manufactured or updated later than 1989 are considered legitimate (e.g. $83 + 1925 = 2008).

==== Price ====

When the '''Disk rewrite count''' field is $00, the '''Price''' field represents the cost of a "new/original" disk.  In this situation, a value of $01 means 3400円 (3400 yen), and a value of $03 also means 3400円 but includes peripherals.  The example given by Enri in his Famicom Disk System documentation mentions the game [http://ja.wikipedia.org/wiki/%E3%81%A8%E3%81%B3%E3%81%A0%E3%81%9B%E5%A4%A7%E4%BD%9C%E6%88%A6 とびだせ大作戦 (Tobidase Daisakusen/3D Worldrunner)], where both sales of the game with and without the [http://homepage3.nifty.com/poco-pen/s-te.htm とびだせメガネ (Tobidase 3D glasses)] cost 3400円.  The reason for the delineation within the actual '''Price''' field is unknown.

When the '''Disk rewrite count''' field is $01, the '''Price''' field represents incurred costs of disk rewriting (such as that done by a Disk Writer kiosk).  A value of $00 means 500円 (which appears to be specific to Mario Brothers via an in-box advertisement promising that all disk rewrites would only cost 500円), while a value of $01 means 600円.

==== Manufacturer codes ====

The manufacturer codes are similar (quite possibly identical) to that known on the GameBoy.  There are some differences, however (for example, $A6).

{| class="wikitable"
|-
! Value !! Company (English) !! Company (Japanese)
|-
| $00 || <unlicensed> || <非公認>
|-
| $01 || Nintendo || 任天堂
|-
| $08 || Capcom || カプコン
|-
| $0A || Jaleco || ジャレコ
|-
| $18 || Hudson Soft || ハドソン
|-
| $49 || Irem || アイレム
|-
| $4A || Gakken || 学習研究社
|-
| $8B || BulletProof Software (BPS) || BPS
|-
| $99 || Pack-In-Video || パックインビデオ
|-
| $9B || Tecmo || テクモ
|-
| $9C || Imagineer || イマジニア
|-
| $A2 || Scorpion Soft || スコーピオンソフト
|-
| $A4 || Konami || コナミ
|-
| $A6 || Kawada Co., Ltd. || 河田
|-
| $A7 || Takara || タカラ
|-
| $A8 || Royal Industries || ロイヤル工業
|-
| $AC || Toei Animation || 東映動画
|-
| $AF || Namco || ナムコ
|-
| $B1 || ASCII Corporation || アスキー
|-
| $B2 || Bandai || バンダイ
|-
| $B3 || Soft Pro Inc. || ソフトプロ
|-
| $B6 || HAL Laboratory || HAL研究所
|-
| $BB || Sunsoft || サンソフト
|-
| $BC || Toshiba EMI || 東芝EMI
|-
| $C0 || Taito || タイトー
|-
| $C1 || Sunsoft / Ask Co., Ltd. || サンソフト アスク講談社
|-
| $C2 || Kemco || ケムコ
|-
| $C3 || Square || スクウェア
|-
| $C4 || Tokuma Shoten || 徳間書店
|-
| $C5 || Data East || データイースト
|-
| $C6 || Tonkin House/Tokyo Shoseki || トンキンハウス
|-
| $C7 || East Cube || イーストキューブ
|-
| $CA || Konami / Ultra / Palcom || コナミ
|-
| $CB || NTVIC / VAP || バップ
|-
| $CC || Use Co., Ltd. || ユース
|-
| $CE || Pony Canyon / FCI || ポニーキャニオン
|-
| $D1 || Sofel || ソフエル
|-
| $D2 || Bothtec, Inc. || ボーステック
|-
| $DB || Hiro Co., Ltd. || ヒロ
|-
| $E7 || Athena || アテナ
|-
| $EB || Atlus || アトラス
|-
|}

=== File amount block (block 2) ===

This block contains the total number of files recorded on disk.

 SIZE   CONTENTS
 1      $02
 1      File Amount

More files might exist on the disk, but the BIOS load routine will ignore them, those files are called "hidden" files.
Some games have a simple copy protection this way: They have their own loading routine similar to the one from the BIOS but hard-code the file amount to a higher number, which will allow for loading hidden files. This also allows the game to load faster because the BIOS will stop reading the disc after the last non-hidden file.

=== File header block  (block 3) ===

 SIZE     CONTENTS
 1        $03
 1        File Number  
 1        File Indicate Code (file identification code)  
          ID specified at disk-read function call
 8        File Name
 2        File Address (16-bit little endian)
          the destination address when loading
 2        File Size (16-bit little endian)
 1        Kind of File  
          0:Program (PRAM)  
          1:Character (CRAM)  
          2:Name table (VRAM)

The file Number must go in increasing order, first file is 0.
File IDs can be freely assigned, and this is the number which will decide which file is loaded from the disk (instead of the file number). An ID smaller than the boot number means the file is a boot file, and will be loaded on first start up.

File names are uppercase ASCII.

=== File data block (block 4) ===

 SIZE      CONTENTS
 1         $04
 --        disk data

== References ==
<References />