/**
 * @fileoverview Implements the PCjs Floppy Drive Controller (FDC) component.
 * @author <a href="mailto:Jeff@pcjs.org">Jeff Parsons</a>
 * @version 1.0
 * @suppress {missingProperties}
 * Created 2012-Aug-09
 *
 * Copyright © 2012-2014 Jeff Parsons <Jeff@pcjs.org>
 *
 * This file is part of PCjs, which is part of the JavaScript Machines Project (aka JSMachines)
 * at <http://jsmachines.net/> and <http://pcjs.org/>.
 *
 * PCjs is free software: you can redistribute it and/or modify it under the terms of the
 * GNU General Public License as published by the Free Software Foundation, either version 3
 * of the License, or (at your option) any later version.
 *
 * PCjs is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
 * even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along with PCjs.  If not,
 * see <http://www.gnu.org/licenses/gpl.html>.
 *
 * You are required to include the above copyright notice in every source code file of every
 * copy or modified version of this work, and to display that copyright notice on every screen
 * that loads or runs any version of this software (see Computer.sCopyright).
 *
 * Some PCjs files also attempt to load external resource files, such as character-image files,
 * ROM files, and disk image files. Those external resource files are not considered part of the
 * PCjs program for purposes of the GNU General Public License, and the author does not claim
 * any copyright as to their contents.
 */

"use strict";

if (typeof module !== 'undefined') {
    var str         = require("../../shared/lib/strlib");
    var web         = require("../../shared/lib/weblib");
    var DiskAPI     = require("../../shared/lib/diskapi");
    var Component   = require("../../shared/lib/component");
    var ChipSet     = require("./chipset");
    var Disk        = require("./disk");
    var Computer    = require("./computer");
    var State       = require("./state");
}

/*
 * FDC Terms (see FDC.TERMS)
 *
 *      C       Cylinder Number         the current or selected cylinder number
 *
 *      D       Data                    the data pattern to be written to a sector
 *
 *      DS      Drive Select            the selected driver number encoded the same as bits 0 and 1 of the Digital Output
 *                                      Register (DOR); eg, DS0, DS1, DS2, or DS3
 *
 *      DTL     Data Length             when N is 00, DTL is the data length to be read from or written to a sector
 *
 *      EOT     End Of Track            the final sector number on a cylinder
 *
 *      GPL     Gap Length              the length of gap 3 (spacing between sectors excluding the VCO synchronous field)
 *
 *      H       Head Address            the head number, either 0 or 1, as specified in the ID field
 *
 *      HD      Head                    the selected head number, 0 or 1 (H = HD in all command words)
 *
 *      HLT     Head Load Time          the head load time in the selected drive (2 to 256 milliseconds in 2-millisecond
 *                                      increments for the 1.2M-byte drive and 4 to 512 milliseconds in 4 millisecond increments
 *                                      for the 320K-byte drive)
 *
 *      HUT     Head Unload Time        the head unload time after a read or write operation (0 to 240 milliseconds in
 *                                      16-millisecond increments for the 1.2M-byte drive and 0 to 480 milliseconds in
 *                                      32-millisecond increments for the 320K-byte drive)
 *
 *      MF      FM or MFM Mode          0 selects FM mode and 1 selects MFM (MFM is selected only if it is implemented)
 *
 *      MT      Multitrack              1 selects multitrack operation (both HD0 and HD1 will be read or written)
 *
 *      N       Number                  the number of data bytes written in a sector
 *
 *      NCN     New Cylinder Number     the new cylinder number for a Seek operation
 *
 *      ND      Non-Data Mode           indicates an operation in the non-data mode
 *
 *      PCN     Present Cylinder Number the cylinder number at the completion of a Sense Interrupt Status command
 *                                      (present position of the head)
 *
 *      R       Record                  the sector number to be read or written
 *
 *      SC      Sectors Per Cylinder    the number of sectors per cylinder
 *
 *      SK      Skip                    this stands for skip deleted-data address mark
 *
 *      SRT     Stepping Rate           this 4 bit byte indicates the stepping rate for the diskette drive as follows:
 *                                      1.2M-Byte Diskette Drive: 1111=1ms, 1110=2ms, 1101=3ms
 *                                      320K-Byte Diskette Drive: 1111=2ms, 1110=4ms, 1101=6ms
 *
 *      STP     STP Scan Test           if STP is 1, the data in contiguous sectors is compared with the data sent
 *                                      by the processor during a scan operation; if STP is 2, then alternate sections
 *                                      are read and compared
 */

/**
 * FDC(parmsFDC)
 *
 * The FDC component simulates an NEC PD765A, and has one component-specific property:
 *
 *      autoMount: one or more JSON-encoded objects, each containing 'name' and 'path' properties
 *
 * Regarding early diskette drives: the IBM PC Model 5150 originally shipped with single-sided drives,
 * and therefore supported only 160Kb diskettes.  That's the only diskette format PC-DOS 1.00 supported, too.
 *
 * At some point, 5150's started shipping with double-sided drives, but I'm not sure whether the ROMs changed;
 * they probably did NOT change, because the original ROM BIOS already supported drives with multiple heads.
 * However, what the ROM BIOS did NOT do was provide any indication of drive type, which as far as I can tell,
 * meant you had to simply read/write/format tracks with the second head and check for errors.
 *
 * Presumably at the same time double-sided drives started shipping, PC-DOS 1.10 shipped, which added
 * support for 320Kb diskettes.  And the FORMAT command changed as well, defaulting to a double-sided format
 * operation UNLESS you specified "FORMAT /1".  If I run PC-DOS 1.10 and try to simulate a single-sided drive
 * (by setting drive.nHeads = 1 in initDrive), FORMAT will balk with "Track 0 bad - disk unusable".  I have to
 * wonder if everyone with single-sided drives who upgraded to PC-DOS 1.10 also got that error, forcing them
 * to always specify "FORMAT /1", or if I'm doing something wrong wrt single-sided drive simulation.
 *
 * I've noticed that if I turn FDC messages on ("m fdc on"), and then run "FORMAT B:/1", the command still
 * tries to format head 1/track 0, followed by head 0/track 0, and then the FDC is reset, and the format operation
 * proceeds with only head 0 for all tracks 0 through 39.  FORMAT successfully creates a 160Kb single-sided diskette,
 * but why it also tries to initially format track 0 using the second head remains a bit of a mystery.
 *
 * @constructor
 * @extends Component
 * @param {Object} parmsFDC
 */
function FDC(parmsFDC) {
    /*
     * TODO: Indicate the type of diskette image being loaded (this might help folks understand what's going
     * on when they try to load a diskette image that's larger than what the selected operating system supports).
     */
    Component.call(this, "FDC", parmsFDC, FDC);

    this['dmaRead'] = this.dmaRead;
    this['dmaWrite'] = this.dmaWrite;
    this['dmaFormat'] = this.dmaFormat;

    this.pAutoMount = null;
    if (parmsFDC['autoMount']) {
        this.pAutoMount = parmsFDC['autoMount'];
        if (typeof this.pAutoMount == "string") {
            try {
                /*
                 * The most likely source of any exception will be right here, where we're parsing
                 * the JSON-encoded diskette data.
                 */
                this.pAutoMount = eval("(" + parmsFDC['autoMount'] + ")");
            } catch (e) {
                Component.error("FDC auto-mount error: " + e.message + " (" + parmsFDC['autoMount'] + ")");
                this.pAutoMount = null;
            }
        }
    }

    /*
     * The following array keeps track of every disk image we've ever mounted.  Each entry in the
     * array is another array whose elements are:
     *
     *      [0]: name of disk
     *      [1]: path of disk
     *      [2]: array of deltas, uninitialized until the disk is unmounted and/or all state is saved
     *
     * See functions addDiskHistory() and updateDiskHistory().
     */
    this.aDiskHistory = [];

    /*
     * The remainder of FDC initialization now takes place in our initBus() handler, largely because we
     * want initController() to have access to the ChipSet component, so that it can query switches and/or CMOS
     * settings that determine the number of drives and their characteristics (eg, 40-track vs. 80-track),
     * which it can then pass on to initDrive().
     */
}

Component.subclass(Component, FDC);

FDC.DEFAULT_DRIVE_NAME = "Floppy Drive";

if (DEBUG) {
    FDC.TERMS = {
        C:   "C",       // Cylinder Number
        D:   "D",       // Data (eg, pattern to be written to a sector)
        H:   "H",       // Head Address
        R:   "R",       // Record (ie, sector number to be read or written)
        N:   "N",       // Number (ie, number of data bytes to write)
        DS:  "DS",      // Drive Select
        SC:  "SC",      // Sectors per Cylinder
        DTL: "DTL",     // Data Length
        EOT: "EOT",     // End of Track
        GPL: "GPL",     // Gap Length
        HLT: "HLT",     // Head Load Time
        NCN: "NCN",     // New Cylinder Number
        PCN: "PCN",     // Present Cylinder Number
        SRT: "SRT",     // Stepping Rate
        ST0: "ST0",     // Status Register 0
        ST1: "ST1",     // Status Register 1
        ST2: "ST2",     // Status Register 2
        ST3: "ST3"      // Status Register 3
    }
} else {
    FDC.TERMS = {};
}

/*
 * FDC Digital Output Register (DOR) (0x3F2, write-only)
 *
 * NOTE: Reportedly, a drive's MOTOR had to be ON before the drive could be selected; however, outFDCOutput() no
 * longer verifies that.  Also, motor start time for original drives was 500ms, but we make no attempt to simulate that.
 *
 * On the MODEL_5170 "PC AT Fixed Disk and Diskette Drive Adapter", this port is called the Digital Output Register
 * or DOR.  It uses the same bit definitions as the original FDC Output Register, except that only two diskette drives
 * are supported, hence bit 1 is always 0 (ie, FDC.REG_OUTPUT.DS2 and FDC.REG_OUTPUT.DS3 are not supported) and bits
 * 6 and 7 are unused (FDC.REG_OUTPUT.MOTOR_D2 and FDC.REG_OUTPUT.MOTOR_D3 are not supported).
 */
FDC.REG_OUTPUT = {};
FDC.REG_OUTPUT.PORT         = 0x3F2;
FDC.REG_OUTPUT.DS           = 0x03;     // drive select bits
FDC.REG_OUTPUT.DS0          = 0x00;
FDC.REG_OUTPUT.DS1          = 0x01;
FDC.REG_OUTPUT.DS2          = 0x02;     // reserved on the MODEL_5170
FDC.REG_OUTPUT.DS3          = 0x03;     // reserved on the MODEL_5170
FDC.REG_OUTPUT.ENABLE       = 0x04;     // clearing this bit resets the FDC
FDC.REG_OUTPUT.INT_ENABLE   = 0x08;     // enables both FDC and DMA (Channel 2) interrupt requests (IRQ 6)
FDC.REG_OUTPUT.MOTOR_D0     = 0x10;
FDC.REG_OUTPUT.MOTOR_D1     = 0x20;
FDC.REG_OUTPUT.MOTOR_D2     = 0x40;     // reserved on the MODEL_5170
FDC.REG_OUTPUT.MOTOR_D3     = 0x80;     // reserved on the MODEL_5170

/*
 * FDC Main Status Register (0x3F4, read-only)
 *
 * On the MODEL_5170 "PC AT Fixed Disk and Diskette Drive Adapter", bits 2 and 3 are reserved, since that adapter
 * supported a maximum of two diskette drives.
 */
FDC.REG_STATUS = {};
FDC.REG_STATUS.PORT         = 0x3F4;
FDC.REG_STATUS.BUSY_A       = 0x01;
FDC.REG_STATUS.BUSY_B       = 0x02;
FDC.REG_STATUS.BUSY_C       = 0x04;     // reserved on the MODEL_5170
FDC.REG_STATUS.BUSY_D       = 0x08;     // reserved on the MODEL_5170
FDC.REG_STATUS.BUSY         = 0x10;     // a read or write command is in progress
FDC.REG_STATUS.NON_DMA      = 0x20;     // FDC is in non-DMA mode
FDC.REG_STATUS.READ_DATA    = 0x40;     // transfer is from FDC Data Register to processor (if clear, then transfer is from processor to the FDC Data Register)
FDC.REG_STATUS.RQM          = 0x80;     // indicates FDC Data Register is ready to send or receive data to or from the processor (Request for Master)

/*
 * FDC Data Register (0x3F5, read-write)
 */
FDC.REG_DATA = {};
FDC.REG_DATA.PORT           = 0x3F5;

/*
 * FDC "Fixed Disk" Register (0x3F6, write-only)
 *
 * Since this register's functions are all specific to the Hard Disk Controller, see the HDC component for details.
 * The fact that this HDC register is in the middle of the FDC I/O port range is an oddity of the "HFCOMBO" controller.
 */

/*
 * FDC Digital Input Register (0x3F7, read-only, MODEL_5170 only)
 *
 * Bit 7 indicates a diskette change (the MODEL_5170 introduced change-line support).  Bits 0-6 are for the selected
 * hard disk drive, so this port must be shared with the HDC; bits 0-6 are valid for 50 microseconds after a write to
 * the Drive Head Register.
 */
FDC.REG_INPUT = {};
FDC.REG_INPUT.PORT          = 0x3F7;
FDC.REG_INPUT.DS0           = 0x01;     // Drive Select 0
FDC.REG_INPUT.DS1           = 0x02;     // Drive Select 1
FDC.REG_INPUT.HS0           = 0x04;     // Head Select 0
FDC.REG_INPUT.HS1           = 0x08;     // Head Select 1
FDC.REG_INPUT.HS2           = 0x10;     // Head Select 2
FDC.REG_INPUT.HS3           = 0x20;     // Head Select 3
FDC.REG_INPUT.WRITE_GATE    = 0x40;     // Write Gate
FDC.REG_INPUT.DISK_CHANGE   = 0x80;     // Diskette Change

/*
 * FDC Diskette Control Register (0x3F7, write-only, MODEL_5170 only)
 *
 * Only bits 0-1 are used; bits 2-7 are reserved.
 */
FDC.REG_CONTROL = {};
FDC.REG_CONTROL.PORT        = 0x3F7;
FDC.REG_CONTROL.RATE500K    = 0x00;     // 500,000 bps
FDC.REG_CONTROL.RATE300K    = 0x02;     // 300,000 bps
FDC.REG_CONTROL.RATE250K    = 0x01;     // 250,000 bps
FDC.REG_CONTROL.RATEUNUSED  = 0x03;

/*
 * FDC Commands
 *
 * NOTE: FDC command bytes need to be masked with FDC.REG_DATA.CMD.MASK before comparing to the values below, since a
 * number of commands use the following additional bits as follows:
 *
 *      SK (0x20): Skip Deleted Data Address Mark
 *      MF (0x40): Modified Frequency Modulation (as opposed to FM or Frequency Modulation)
 *      MT (0x80): multi-track operation (ie, data processed under both head 0 and head 1)
 *
 * We don't support MT (Multi-Track) operations at this time, and the MF and SK designations cannot be supported as long
 * as our diskette images contain only the original data bytes without any formatting information.
 */
FDC.REG_DATA.CMD = {};
FDC.REG_DATA.CMD.READ_TRACK     = 0x02;
FDC.REG_DATA.CMD.SPECIFY        = 0x03;
FDC.REG_DATA.CMD.SENSE_DRIVE    = 0x04;
FDC.REG_DATA.CMD.WRITE_DATA     = 0x05;
FDC.REG_DATA.CMD.READ_DATA      = 0x06;
FDC.REG_DATA.CMD.RECALIBRATE    = 0x07;
FDC.REG_DATA.CMD.SENSE_INT      = 0x08;     // this command is used to clear the FDC interrupt following the clearing/setting of FDC.REG_OUTPUT.ENABLE
FDC.REG_DATA.CMD.WRITE_DEL_DATA = 0x09;
FDC.REG_DATA.CMD.READ_ID        = 0x0A;
FDC.REG_DATA.CMD.READ_DEL_DATA  = 0x0C;
FDC.REG_DATA.CMD.FORMAT_TRACK   = 0x0D;
FDC.REG_DATA.CMD.SEEK           = 0x0F;
FDC.REG_DATA.CMD.SCAN_EQUAL     = 0x11;
FDC.REG_DATA.CMD.SCAN_LO_EQUAL  = 0x19;
FDC.REG_DATA.CMD.SCAN_HI_EQUAL  = 0x1D;
FDC.REG_DATA.CMD.MASK           = 0x1F;
FDC.REG_DATA.CMD.SK             = 0x20;     // SK (Skip Deleted Data Address Mark)
FDC.REG_DATA.CMD.MF             = 0x40;     // MF (Modified Frequency Modulation)
FDC.REG_DATA.CMD.MT             = 0x80;     // MT (Multi-Track; ie, data under both heads will be processed)

/*
 * FDC status/error results, generally assigned according to the corresponding ST0, ST1, ST2 or ST3 status bit.
 *
 * TODO: Determine when EQUIP_CHECK is *really* set; "77 step pulses" sounds suspiciously like a typo.
 */
FDC.REG_DATA.RES = {};
FDC.REG_DATA.RES.NONE         = 0x00000000; // ST0 (IC): Normal termination of command (NT)
FDC.REG_DATA.RES.NOT_READY    = 0x00000008; // ST0 (NR): When the FDD is in the not-ready state and a read or write command is issued, this flag is set; if a read or write command is issued to side 1 of a single sided drive, then this flag is set
FDC.REG_DATA.RES.EQUIP_CHECK  = 0x00000010; // ST0 (EC): If a fault signal is received from the FDD, or if the track 0 signal fails to occur after 77 step pulses (recalibrate command), then this flag is set
FDC.REG_DATA.RES.SEEK_END     = 0x00000020; // ST0 (SE): When the FDC completes the Seek command, this flag is set to 1 (high)
FDC.REG_DATA.RES.INCOMPLETE   = 0x00000040; // ST0 (IC): Abnormal termination of command (AT); execution of command was started, but was not successfully completed
FDC.REG_DATA.RES.RESET        = 0x000000C0; // ST0 (IC): Abnormal termination because during command execution the ready signal from the drive changed state
FDC.REG_DATA.RES.INVALID      = 0x00000080; // ST0 (IC): Invalid command issue (IC); command which was issued was never started
FDC.REG_DATA.RES.ST0          = 0x000000FF;
FDC.REG_DATA.RES.NO_ID_MARK   = 0x00000100; // ST1 (MA): If the FDC cannot detect the ID Address Mark, this flag is set; at the same time, the MD (Missing Address Mark in Data Field) of Status Register 2 is set
FDC.REG_DATA.RES.NOT_WRITABLE = 0x00000200; // ST1 (NW): During Execution of a Write Data, Write Deleted Data, or Format a Cylinder command, if the FDC detects a write protect signal from the FDD, then this flag is set
FDC.REG_DATA.RES.NO_DATA      = 0x00000400; // ST1 (ND): FDC cannot find specified sector (or specified ID if READ_ID command)
FDC.REG_DATA.RES.DMA_OVERRUN  = 0x00001000; // ST1 (OR): If the FDC is not serviced by the main systems during data transfers within a certain time interval, this flag is set
FDC.REG_DATA.RES.CRC_ERROR    = 0x00002000; // ST1 (DE): When the FDC detects a CRC error in either the ID field or the data field, this flag is set
FDC.REG_DATA.RES.END_OF_CYL   = 0x00008000; // ST1 (EN): When the FDC tries to access a sector beyond the final sector of a cylinder, this flag is set
FDC.REG_DATA.RES.ST1          = 0x0000FF00;
FDC.REG_DATA.RES.NO_DATA_MARK = 0x00010000; // ST2 (MD): When data is read from the medium, if the FDC cannot find a Data Address Mark or Deleted Data Address Mark, then this flag is set
FDC.REG_DATA.RES.BAD_CYL      = 0x00020000; // ST2 (BC): This bit is related to the ND bit, and when the contents of C on the medium are different from that stored in the ID Register, and the content of C is FF, then this flag is set
FDC.REG_DATA.RES.SCAN_FAILED  = 0x00040000; // ST2 (SN): During execution of the Scan command, if the FDC cannot find a sector on the cylinder which meets the condition, then this flag is set
FDC.REG_DATA.RES.SCAN_EQUAL   = 0x00080000; // ST2 (SH): During execution of the Scan command, if the condition of "equal" is satisfied, this flag is set
FDC.REG_DATA.RES.WRONG_CYL    = 0x00100000; // ST2 (WC): This bit is related to the ND bit, and when the contents of C on the medium are different from that stored in the ID Register, this flag is set
FDC.REG_DATA.RES.DATA_FIELD   = 0x00200000; // ST2 (DD): If the FDC detects a CRC error in the data, then this flag is set
FDC.REG_DATA.RES.STRL_MARK    = 0x00400000; // ST2 (CM): During execution of the Read Data or Scan command, if the FDC encounters a sector which contains a Deleted Data Address Mark, this flag is set
FDC.REG_DATA.RES.ST2          = 0x00FF0000;
FDC.REG_DATA.RES.DRIVE        = 0x03000000; // ST3 (Ux): Status of the "Drive Select" signals from the diskette drive
FDC.REG_DATA.RES.HEAD         = 0x04000000; // ST3 (HD): Status of the "Side Select" signal from the diskette drive
FDC.REG_DATA.RES.TWOSIDE      = 0x08000000; // ST3 (TS): Status of the "Two Side" signal from the diskette drive
FDC.REG_DATA.RES.TRACK0       = 0x10000000; // ST3 (T0): Status of the "Track 0" signal from the diskette drive
FDC.REG_DATA.RES.READY        = 0x20000000; // ST3 (RY): Status of the "Ready" signal from the diskette drive
FDC.REG_DATA.RES.WRITEPROT    = 0x40000000; // ST3 (WP): Status of the "Write Protect" signal from the diskette drive
FDC.REG_DATA.RES.FAULT        = 0x80000000; // ST3 (FT): Status of the "Fault" signal from the diskette drive
FDC.REG_DATA.RES.ST3          = 0xFF000000;

/*
 * FDC Command Sequences
 *
 * For each command, cbReq indicates the total number of bytes in the command request sequence,
 * including the first (command) byte; cbRes indicates total number of bytes in the response sequence.
 */
if (DEBUG) {
    FDC.CMDS = {
        SPECIFY:      "SPECIFY",
        SENSE_DRIVE:  "SENSE DRIVE",
        WRITE_DATA:   "WRITE DATA",
        READ_DATA:    "READ DATA",
        RECALIBRATE:  "RECALIBRATE",
        SENSE_INT:    "SENSE INTERRUPT",
        READ_ID:      "READ ID",
        FORMAT:       "FORMAT",
        SEEK:         "SEEK"
    }
} else {
    FDC.CMDS = {};
}

FDC.aCmdInfo = {
    0x03: {cbReq: 3, cbRes: 0, name: FDC.CMDS.SPECIFY},
    0x04: {cbReq: 2, cbRes: 1, name: FDC.CMDS.SENSE_DRIVE},
    0x05: {cbReq: 9, cbRes: 7, name: FDC.CMDS.WRITE_DATA},
    0x06: {cbReq: 9, cbRes: 7, name: FDC.CMDS.READ_DATA},
    0x07: {cbReq: 2, cbRes: 0, name: FDC.CMDS.RECALIBRATE},
    0x08: {cbReq: 1, cbRes: 2, name: FDC.CMDS.SENSE_INT},
    0x0A: {cbReq: 2, cbRes: 7, name: FDC.CMDS.READ_ID},
    0x0D: {cbReq: 6, cbRes: 7, name: FDC.CMDS.FORMAT},
    0x0F: {cbReq: 3, cbRes: 0, name: FDC.CMDS.SEEK}
};

/*
 * FDC BIOS interrupts, functions, and other parameters
 */
FDC.BIOS = {
    INT_DISKETTE:   0x13
};

/**
 * setBinding(sHTMLClass, sHTMLType, sBinding, control)
 *
 * @this {FDC}
 * @param {string|null} sHTMLClass is the class of the HTML control (eg, "input", "output")
 * @param {string|null} sHTMLType is the type of the HTML control (eg, "button", "list", "text", "submit", "textarea", "canvas")
 * @param {string} sBinding is the value of the 'binding' parameter stored in the HTML control's "data-value" attribute (eg, "listDisks")
 * @param {Object} control is the HTML control DOM object (eg, HTMLButtonElement)
 * @return {boolean} true if binding was successful, false if unrecognized binding request
 */
FDC.prototype.setBinding = function(sHTMLClass, sHTMLType, sBinding, control)
{
    switch (sBinding) {
        case "listDisks":
            this.bindings[sBinding] = control;
            /*
             * Add the special path of "?" to the list, which will prompt the user for a URL.
             */
            var controlOption = window.document.createElement("option");
            controlOption['value'] = "?";
            controlOption.innerHTML = "User-defined URL...";
            control.appendChild(controlOption);
            /*
             * Now add an 'onchange' handler.
             */
            control.onchange = function(fdc, controlDisks) {
                return function onChangeListDisks() {
                    var controlDesc = fdc.bindings["descDisk"];
                    if (controlDesc) {
                        var controlOption = controlDisks.options[controlDisks.selectedIndex];
                        if (controlOption) {
                            var dataValue = {};
                            var sValue = controlOption.getAttribute("data-value");
                            if (sValue) {
                                try {
                                    dataValue = eval("({" + sValue + "})");
                                } catch (e) {
                                    Component.error("FDC option error: " + (e.message || e));
                                }
                            }
                            var sDesc = dataValue['desc'];
                            if (sDesc === undefined) sDesc = "";
                            var sHRef = dataValue['href'];
                            if (sHRef !== undefined) sDesc = "<a href=\"" + sHRef + "\" target=\"_blank\">" + sDesc + "</a>";
                            controlDesc.innerHTML = sDesc;
                        }
                    }
                };
            }(this, control);
            return true;

        case "descDisk":
        case "listDrives":
            this.bindings[sBinding] = control;
            /*
             * I tried going with onclick instead of onchange, so that if you wanted to confirm what's
             * loaded in a particular drive, you could click the drive control without having to change it.
             * However, that doesn't seem to work for all browsers, so I've reverted to onchange.
             */
            control.onchange = function(fdc, controlDrives) {
                return function onChangeListDrives() {
                    var iDrive = parseInt(controlDrives.value, 10);
                    if (!isNaN(iDrive)) fdc.displayDiskette(iDrive);
                };
            }(this, control);
            return true;

        case "loadDrive":
            this.bindings[sBinding] = control;
            control.onclick = function(fdc) {
                return function onClickLoadDrive() {
                    var iDrive;
                    var controlDisks = fdc.bindings["listDisks"];
                    var controlDrives = fdc.bindings["listDrives"];
                    if (controlDisks && controlDrives && !isNaN(iDrive = parseInt(controlDrives.value, 10)) && iDrive >= 0 && iDrive < fdc.aDrives.length) {
                        var sDiskettePath = controlDisks.value;
                        if (!sDiskettePath) {
                            fdc.unloadDrive(iDrive);
                            return;
                        }
                        var sDisketteName = controlDisks.options[controlDisks.selectedIndex].text;

                        /*
                         * If the special path of "?" is selected, then we want to prompt the user for a URL.  Oh, and
                         * make sure we pass an empty string as the 2nd parameter to prompt(), so that IE won't display
                         * "undefined" -- because after all, undefined and "undefined" are EXACTLY the same thing, right?
                         *
                         * TODO: This is literally all I've done to support external disk images. There's probably more
                         * I should do, like dynamically updating "listDisks" to include new entries, and adding new entries
                         * to the save/restore data.
                         */
                        if (sDiskettePath == "?") {
                            sDiskettePath = window.prompt("Enter the URL of a disk image to load.", "");
                            if (!sDiskettePath)
                                return;
                            sDisketteName = str.getBaseName(sDiskettePath);
                            fdc.println("Attempting to load " + sDiskettePath + " as \"" + sDisketteName + "\"");
                        }

                        while (fdc.loadDiskette(iDrive, sDisketteName, sDiskettePath, false)) {
                            if (!window.confirm("Click OK to reload the original disk.\n(WARNING: All disk changes will be discarded)")) {
                                return;
                            }
                            /*
                             * So here's the story: loadDiskette() returned true, which it does ONLY if the specified disk is already
                             * mounted, AND the user clicked OK to reload the original disk image.  So we must toss any history we have
                             * for the disk, unload it, and then loop back around to loadDiskette().
                             *
                             * loadDiskette() should NEVER return true the second time, since no disk is loaded. In other words, this
                             * isn't really a loop so much as a one-time retry operation.
                             */
                            fdc.removeDiskHistory(sDisketteName, sDiskettePath);
                            fdc.unloadDrive(iDrive, false, true);
                        }
                        return;
                    }
                    fdc.notice("Nothing to load");
                };
            }(this);
            return true;

        default:
            break;
    }
    return false;
};

/**
 * initBus(cmp, bus, cpu, dbg)
 *
 * @this {FDC}
 * @param {Computer} cmp
 * @param {Bus} bus
 * @param {X86CPU} cpu
 * @param {Debugger} dbg
 */
FDC.prototype.initBus = function(cmp, bus, cpu, dbg)
{
    this.bus = bus;
    this.cpu = cpu;
    this.dbg = dbg;
    this.cmp = cmp;

    this.chipset = cmp.getComponentByType("ChipSet");

    /*
     * If we didn't need auto-mount support, we could defer controller initialization until we received a powerUp() notification,
     * at which point reset() would call initController(), or restore() would restore the controller; in that case, all we'd need
     * to do here is call setReady().
     */
    this.initController();

    bus.addPortInputTable(this, FDC.aPortInput);
    bus.addPortOutputTable(this, FDC.aPortOutput);
    if (DEBUGGER) {
        if (dbg) dbg.messageInit(FDC);
        cpu.addIntNotify(FDC.BIOS.INT_DISKETTE, this, this.intBIOSDiskette);
    }

    if (!this.autoMount()) this.setReady();
};

/**
 * powerUp(data, fRepower)
 *
 * @this {FDC}
 * @param {Object|null} data
 * @param {boolean} [fRepower]
 * @return {boolean} true if successful, false if failure
 */
FDC.prototype.powerUp = function(data, fRepower)
{
    if (!fRepower) {
        if (!data || !this.restore) {
            this.reset();
            if (this.cmp.fReload) {
                /*
                 * If the computer's fReload flag is set, we're required to toss all currently
                 * loaded disks and remount all disks specified in the auto-mount configuration.
                 */
                this.unloadAllDrives(true);
                this.autoMount(true);
            }
        } else {
            if (!this.restore(data)) return false;
        }
        /*
         * Populate the HTML controls to match the actual (well, um, specified) number of floppy drives.
         */
        var controlDrives;
        if ((controlDrives = this.bindings['listDrives'])) {
            while (controlDrives.firstChild) {
                controlDrives.removeChild(controlDrives.firstChild);
            }
            controlDrives.innerHTML = "";
            for (var iDrive = 0; iDrive < this.nDrives; iDrive++) {
                var controlOption = window.document.createElement("option");
                controlOption['value'] = iDrive;
                /*
                 * TODO: This conversion of drive number to drive letter, starting with A:, is very simplistic
                 * and will NOT match the drive mappings that DOS ultimately uses.  We'll need to spiff this up at
                 * some point.
                 */
                controlOption.innerHTML = String.fromCharCode(0x41 + iDrive) + ":";
                controlDrives.appendChild(controlOption);
            }
            if (this.nDrives > 0) {
                controlDrives.value = "0";
                this.displayDiskette(0);
            }
        }
    }
    return true;
};

/**
 * powerDown(fSave)
 *
 * @this {FDC}
 * @param {boolean} fSave
 * @return {Object|boolean}
 */
FDC.prototype.powerDown = function(fSave)
{
    return fSave && this.save? this.save() : true;
};

/**
 * reset()
 *
 * NOTE: initController() establishes the maximum possible number of drives, but it's not until
 * we interrogate the current SW1 settings that we will have an ACTUAL number of drives (nDrives),
 * at which point we can also update the contents of the "listDrives" HTML control, if any.
 *
 * @this {FDC}
 */
FDC.prototype.reset = function()
{
    /*
     * NOTE: The controller is also initialized by the constructor, to assist with auto-mount support,
     * so think about whether we can skip powerUp initialization.
     */
    this.initController();
};

/**
 * save()
 *
 * This implements save support for the FDC component.
 *
 * @this {FDC}
 * @return {Object}
 */
FDC.prototype.save = function()
{
    var state = new State(this);
    state.set(0, this.saveController());
    return state.data();
};

/**
 * restore(data)
 *
 * This implements restore support for the FDC component.
 *
 * @this {FDC}
 * @param {Object} data
 * @return {boolean} true if successful, false if failure
 */
FDC.prototype.restore = function(data)
{
    return this.initController(data[0]);
};

/**
 * initController(data)
 *
 * @this {FDC}
 * @param {Array} [data]
 * @return {boolean} true if successful, false if failure
 */
FDC.prototype.initController = function(data)
{
    var i = 0, iDrive;
    var fSuccess = true;

    if (data === undefined) {
        data = [0, 0, FDC.REG_STATUS.RQM, new Array(9), 0, 0, 0, []];
    }

    /*
     * Selected drive (from regOutput), which can only be selected if its motor is on (see regOutput).
     */
    this.iDrive = data[i++];
    i++;                        // unused slot (if reused, bias by +4, since it was formerly a unit #)

    /*
     * Defaults to FDC.REG_STATUS.RQM set (ready for command) and FDC.REG_STATUS.READ_DATA clear (data direction
     * is from processor to the FDC Data Register).
     */
    this.regStatus = data[i++];

    /*
     * There can be up to 9 command bytes, and 7 result bytes, so 9 data registers are sufficient for communicating
     * in both directions (hence, the new Array(9) default above).
     */
    this.regDataArray = data[i++];

    /*
     * Determines the next data byte to be received.
     */
    this.regDataIndex = data[i++];

    /*
     * Determines the next data byte to be sent (internally, we use regDataIndex to read data bytes, up to this total).
     */
    this.regDataTotal = data[i++];
    this.regOutput = data[i++];
    var dataDrives = data[i++];

    /*
     * Initialize the disk history (if available) before initializing the drives, so that any disk deltas can be
     * applied to disk images that are already loaded.
     */
    var aDiskHistory = data[i++];
    if (aDiskHistory != null) this.aDiskHistory = aDiskHistory;

    if (this.aDrives === undefined) {
        this.nDrives = 4;                       // default to the maximum number of drives
        if (this.chipset) this.nDrives = this.chipset.getSWFloppyDrives();
        /*
         * I would prefer to allocate only nDrives, but as discussed in the handling of the FDC.REG_DATA.CMD.SENSE_INT
         * command, we're faced with situations where the controller must respond to any drive in the range 0-3, regardless
         * how many drives are actually installed.  We still rely upon nDrives to determine the number of drives displayed
         * to the user, however.
         */
        this.aDrives = new Array(4);
    }

    for (iDrive = 0; iDrive < this.aDrives.length; iDrive++) {
        var drive = this.aDrives[iDrive];
        if (drive === undefined) {
            /*
             * The first time each drive is initialized, we query its capacity (based on switches or CMOS) and set
             * the drive's physical limits accordingly (ie, max tracks, max heads, and max sectors/track).
             */
            drive = this.aDrives[iDrive] = {};
            var nKb = (this.chipset? this.chipset.getSWFloppyDriveSize(iDrive) : 0);
            switch(nKb) {
            case 160:
            case 180:
                drive.nHeads = 1;       // required for single-sided drives only (all others default to double-sided)
                /* falls through */
            case 320:
            case 360:
            default:                    // drives that don't have a recognized capacity default to 360
                drive.nCylinders = 40;
                drive.nSectors = 9;     // drives capable of writing 8 sectors/track can also write 9 sectors/track
                break;
            case 720:
                drive.nCylinders = 80;
                drive.nSectors = 9;
                break;
            case 1200:
                drive.nCylinders = 80;
                drive.nSectors = 15;
                break;
            case 1440:
                drive.nCylinders = 80;
                drive.nSectors = 18;
                break;
            }
        }
        if (!this.initDrive(drive, iDrive, dataDrives[iDrive])) {
            fSuccess = false;
        }
    }

    /*
     * regInput and regControl (port 0x3F7) were not present on controllers prior to MODEL_5170, which is why
     * we don't include initializers for them in the default data array; we could eliminate them on older models,
     * but we don't have access to the model info right now, and there's no real cost to always including them
     * in the FDC state.
     *
     * The bigger compatibility question is whether to always include hooks for them (see aPortInput and aPortOutput).
     */
    this.regInput = data[i++] || 0;                             // TODO: Determine if we should default to FDC.REG_INPUT.DISK_CHANGE instead of 0
    this.regControl = data[i] || FDC.REG_CONTROL.RATE500K;      // default to maximum data rate

    if (DEBUG) this.messageDebugger("FDC initialized for " + this.aDrives.length + " drive(s)");
    return fSuccess;
};

/**
 * saveController()
 *
 * @this {FDC}
 * @return {Array}
 */
FDC.prototype.saveController = function()
{
    var i = 0;
    var data = [];
    data[i++] = this.iDrive;
    data[i++] = 0;
    data[i++] = this.regStatus;
    data[i++] = this.regDataArray;
    data[i++] = this.regDataIndex;
    data[i++] = this.regDataTotal;
    data[i++] = this.regOutput;
    data[i++] = this.saveDrives();
    data[i++] = this.saveDeltas();
    data[i++] = this.regInput;
    data[i] = this.regControl;
    return data;
};

/**
 * initDrive(drive, iDrive, data)
 *
 * TODO: Consider a separate Drive class that both FDC and HDC can use, since there's a lot of commonality
 * between the drive objects created by both controllers.  This will clean up overall drive management and allow
 * us to factor out some common Drive methods (eg, advanceSector()).
 *
 * @this {FDC}
 * @param {Object} drive
 * @param {number} iDrive
 * @param {Array|undefined} data
 * @return {boolean} true if successful, false if failure
 */
FDC.prototype.initDrive = function(drive, iDrive, data)
{
    var i = 0;
    var fSuccess = true;

    drive.iDrive = iDrive;

    if (data === undefined) {
        /*
         * We set a default of two heads (MODEL_5150 PCs originally shipped with single-sided drives,
         * but the ROM BIOS appears to have always supported both drive types).
         */
        data = [FDC.REG_DATA.RES.RESET, true, 0, 2, 0];
    }

    if (typeof data[1] == "boolean") {
        /*
         * Note that when no data is provided (eg, when the controller is being reinitialized), we now take
         * care to preserve any drive defaults that initController() already obtained for us, falling back to
         * bare minimums only when all else fails.
         */
        data[1] = [
            FDC.DEFAULT_DRIVE_NAME, // a[0]
            drive.nCylinders || 40, // a[1]
            drive.nHeads || data[3],// a[2]
            drive.nSectors || 9,    // a[3]
            drive.cbSector || 512,  // a[4]
            data[1],                // a[5]
            drive.nDiskCylinders,   // a[6]
            drive.nDiskHeads,       // a[7]
            drive.nDiskSectors      // a[8]
        ];
    }

    /*
     * resCode used to be an FDC global, but in order to insulate FDC state from the operation of various functions
     * that operate on drive objects (eg, readByte and writeByte), I've made it a per-drive variable.  This choice,
     * similar to my choice for handling PCN, may be contrary to how the actual hardware works, but I prefer this
     * approach, as long as it doesn't expose any incompatibilities that any software actually cares about.
     */
    drive.resCode = data[i++];

    /*
     * Some additional drive properties/defaults that are largely for the Disk component's benefit.
     */
    var a = data[i++];
    drive.name = a[0];
    drive.nCylinders = a[1];          // cylinders
    drive.nHeads = a[2];              // heads/cylinders
    drive.nSectors = a[3];            // sectors/track
    drive.cbSector = a[4];            // bytes/sector
    drive.fRemovable = a[5];
    /*
     * If we have current media parameters, restore them; otherwise, default to the drive's physical parameters.
     */
    if (drive.nDiskCylinders = a[6]) {
        drive.nDiskHeads = a[7];
        drive.nDiskSectors = a[8];
    } else {
        drive.nDiskCylinders = drive.nCylinders;
        drive.nDiskHeads = drive.nHeads;
        drive.nDiskSectors = drive.nSectors;
    }

    /*
     * The next group of properties are set by various FDC command sequences.
     *
     * We initialize this.iDrive (above) and drive.bHead and drive.bCylinder (below) to zero, but leave the rest undefined,
     * awaiting their first FDC command.  We do this because the initial SENSE_INT command returns a PCN, which will also
     * be undefined unless we have at least zeroed both the current drive and the "present" cylinder on that drive.
     *
     * Alternatively, I could make PCN a global FDC variable.  That may be closer to how the actual hardware operates,
     * but I'm using per-drive variables so that the FDC component can be a good client to both the CPU and other components.
     *
     * COMPATIBILITY ALERT: The MODEL_5170 BIOS ("DSKETTE_SETUP") attempts to discern the drive type (double-density vs.
     * high-capacity) by "slapping" the heads around.  Literally (it uses a constant named "TRK_SLAP" equal to 48).
     * After seeking to "TRK_SLAP", the BIOS performs a series of seeks, looking for the precise point where the heads
     * return to track 0.
     *
     * Here's how it works: the BIOS seeks to track 48 (which is fine on an 80-track 1.2Mb high-capacity drive, but 9 tracks
     * too far on a 40-track 360Kb double-density drive), then seeks to track 10, and then seeks in single-track increments
     * up to 10 more times until the SENSE_DRIVE command returns ST3 with the TRACK0 bit set.
     *
     * This implies that SEEK isn't really seeking to a specified cylinder, but rather it is calculating a delta from
     * the previous cylinder to the specified cylinder, and stepping over that number of tracks.  Which means that SEEK
     * is updating a "logical" cylinder number, not the "physical" (actual) cylinder number.  Presumably a RECALIBRATE
     * command will bring the logical and physical values into sync, but once an out-of-bounds cylinder is requested, they
     * will be out of sync.
     *
     * To simulate this, bCylinder is now treated as the "physical" cylinder (since that's how it's ALWAYS been used here),
     * and bCylinderSeek will now track (pun intended) the "logical" cylinder that's programmed via SEEK commands.
     */
    drive.bHead = data[i++];
    drive.bCylinderSeek = data[i++];        // the data[] slot where we used to store drive.nHeads (or -1)
    drive.bCylinder = data[i++];
    if (drive.bCylinderSeek >= 100) {       // verify that the saved bCylinderSeek is valid, otherwise sync it with bCylinder
        drive.bCylinderSeek -= 100;
    } else {
        drive.bCylinderSeek -= drive.bCylinder;
    }
    drive.bSector = data[i++];
    drive.bSectorEnd = data[i++];           // aka EOT
    drive.nBytes = data[i++];

    /*
     * We no longer reinitialize drive.disk, in order to retain previously mounted diskette across resets.
     */

    /*
     * The next group of properties are managed by worker functions (eg, doRead()) to maintain state across DMA requests.
     */
    drive.ibSector = data[i++];             // location of the next byte to be accessed in the current sector
    drive.sector = null;

    if (!drive.disk) {
        drive.sDiskettePath = "";           // ensure this is initialized to a default that displayDiskette() can deal with
    }

    var deltas = data[i++];
    if (deltas === Computer.VERSION_102) {
        var sDisketteName = data[i++];
        var sDiskettePath = data[i];
        /*
         * If loadDiskette() must actually mount a *different* disk image at this late stage (ie, if it returns false),
         * then we must mark ourselves as "not ready" again, and add another "wait for ready" test in Computer before
         * finally powering the CPU.  Otherwise, go ahead and restore any deltas to the current image.
         */
        if (this.loadDiskette(iDrive, sDisketteName, sDiskettePath, true)) {
            if (drive.disk) {
                this.addDiskHistory(sDisketteName, sDiskettePath, drive.disk);
            }
        } else {
            this.setReady(false);
        }
    } else if (deltas !== undefined) {
        /*
         * If there's any data at all (ie, if this is a restore and not a reset), then it must be in the
         * pre-v1.02 save/restore format, so we'll restore as best we can, but be aware that if disk.restore()
         * notices that the currently mounted disk image differs from the disk image that these deltas belong to,
         * it will return false, and the restore operation will be aborted.
         */
        if (drive.disk && drive.disk.restore(deltas) < 0) {
            fSuccess = false;
        }
    }

    /*
     * TODO: If loadDiskette() returned true, then this can happen immediately.  Otherwise, loadDiskette()
     * will have merely "queued up" the load request and drive.disk won't be ready yet, so figure out how/when
     * we can properly restore drive.sector in that case.
     */
    if (fSuccess && drive.disk && drive.ibSector !== undefined) {
        drive.sector = drive.disk.seek(drive.bCylinder, drive.bHead, drive.bSector);
    }
    return fSuccess;
};

/**
 * saveDrives()
 *
 * @this {FDC}
 * @return {Array}
 */
FDC.prototype.saveDrives = function()
{
    var i = 0;
    var data = [];
    for (var iDrive = 0; iDrive < this.aDrives.length; iDrive++) {
        data[i++] = this.saveDrive(this.aDrives[iDrive]);
    }
    return data;
};

/**
 * saveDrive(drive)
 *
 * @this {FDC}
 * @return {Array}
 */
FDC.prototype.saveDrive = function(drive)
{
    var i = 0;
    var data = [];
    data[i++] = drive.resCode;
    data[i++] = [drive.name, drive.nCylinders, drive.nHeads, drive.nSectors, drive.cbSector, drive.fRemovable, drive.nDiskCylinders, drive.nDiskHeads, drive.nDiskSectors];
    data[i++] = drive.bHead;
    /*
     * We used to store drive.nHeads in the next slot, but now we store bCylinderSeek,
     * and we bias it by +100 so that initDrive() can distinguish it from older values.
     */
    data[i++] = drive.bCylinderSeek + 100;
    data[i++] = drive.bCylinder;
    data[i++] = drive.bSector;
    data[i++] = drive.bSectorEnd;
    data[i++] = drive.nBytes;
    data[i++] = drive.ibSector;
    /*
     * Now we deviate from the 1.01a save format: instead of next storing all the deltas for the
     * currently mounted disk (if any), we store only the name and path of the currently mounted disk
     * (if any).  Deltas for ALL disks, both currently mounted and previously mounted, are stored later.
     *
     *      data[i++] = drive.disk? drive.disk.save() : null;
     *
     * To indicate this deviation, we store neither a null nor a delta array, but Computer.VERSION_102;
     * if that value is not present, then the restore code will know it's dealing with a pre-v1.02 state.
     */
    data[i++] = Computer.VERSION_102;
    data[i++] = drive.sDisketteName;
    data[i] = drive.sDiskettePath;
    return data;
};

/**
 * saveDeltas()
 *
 * This returns an array of entries, one for each disk image we've ever mounted, including any deltas; ie:
 *
 *      [name, path, deltas]
 *
 * aDiskHistory contains exactly that, except that deltas may not be up-to-date for any currently mounted
 * disk image(s), so we call updateHistory() for all those disks, and then aDiskHistory is ready to be saved.
 *
 * @this {FDC}
 * @return {Array}
 */
FDC.prototype.saveDeltas = function()
{
    for (var iDrive = 0; iDrive < this.aDrives.length; iDrive++) {
        var drive = this.aDrives[iDrive];
        if (drive.disk) {
            this.updateDiskHistory(drive.sDisketteName, drive.sDiskettePath, drive.disk);
        }
    }
    return this.aDiskHistory;
};

/**
 * copyDrive(iDrive)
 *
 * @this {FDC}
 * @param {number} iDrive
 * @return {Object|undefined} drive (which may be undefined if the requested drive does not exist)
 */
FDC.prototype.copyDrive = function(iDrive)
{
    var driveNew;
    var driveOld = this.aDrives[iDrive];
    if (driveOld !== undefined) {
        driveNew = {};
        for (var p in driveOld) {
            driveNew[p] = driveOld[p];
        }
    }
    return driveNew;
};

/**
 * seekDrive(drive, iSector, nSectors)
 *
 * The FDC doesn't need this function, since all FDC requests from the CPU are handled by doCmd().  This function
 * is used by other components (eg, Debugger) to mimic an FDC request, using a drive object obtained from copyDrive(),
 * to avoid disturbing the internal state of the FDC's drive objects.
 *
 * Also note that in an actual FDC request, drive.nBytes is initialized to the size of a single sector; the extent
 * of the entire transfer is actually determined by a count that has been pre-loaded into the DMA controller.  The FDC
 * isn't even aware of the extent of the transfer, so in the case of a read request, all readByte() can do is return bytes
 * until the current track (or, in the case of a multi-track request, the current cylinder) has been exhausted.
 *
 * Since seekDrive() is for use with non-DMA requests, we use nBytes to specify the length of the entire transfer.
 *
 * @this {FDC}
 * @param {Object} drive
 * @param {number} iSector (a "logical" sector number, relative to the entire disk, NOT a physical sector number)
 * @param {number} nSectors
 * @return {boolean} true if successful, false if invalid position request
 */
FDC.prototype.seekDrive = function(drive, iSector, nSectors)
{
    if (drive.disk) {
        var aDiskInfo = drive.disk.info();
        var nCylinders = aDiskInfo[0];
        var nHeads = aDiskInfo[1];
        var nSectorsPerTrack = aDiskInfo[2];
        var nSectorsPerCylinder = nHeads * nSectorsPerTrack;
        var nSectorsPerDisk = nCylinders * nSectorsPerCylinder;
        if (iSector + nSectors <= nSectorsPerDisk) {
            drive.bCylinder = Math.floor(iSector / nSectorsPerCylinder);
            iSector %= nSectorsPerCylinder;
            drive.bHead = Math.floor(iSector / nSectorsPerTrack);
            drive.bSector = (iSector % nSectorsPerTrack) + 1;
            drive.nBytes = nSectors * aDiskInfo[3];
            /*
             * NOTE: We don't set bSectorEnd, as an FDC command would, but it's irrelevant, because we don't actually
             * do anything with bSectorEnd at this point.  Perhaps someday, when we faithfully honor/restrict requests
             * to a single track (or a single cylinder, in the case of multi-track requests).
             */
            drive.resCode = FDC.REG_DATA.RES.NONE;
            /*
             * At this point, we've finished simulating what an FDC.REG_DATA.CMD.READ_DATA command would have performed,
             * up through doRead().  Now it's the caller responsibility to call readByte(), just like the DMA Controller would.
             */
            return true;
        }
    }
    return false;
};

/**
 * autoMount(fRemount)
 *
 * @this {FDC}
 * @param {boolean} [fRemount] is true if we're remounting all auto-mounted diskettes
 * @return {boolean} true if one or more diskette images are being auto-mounted, false if none
 */
FDC.prototype.autoMount = function(fRemount)
{
    if (!fRemount) this.cAutoMount = 0;
    if (this.pAutoMount) {
        for (var sDrive in this.pAutoMount) {
            var pDriveConfig = this.pAutoMount[sDrive];
            if (pDriveConfig['name'] && pDriveConfig['path']) {
                /*
                 * WARNING: This conversion of drive letter to drive number, starting with A:, is very simplistic
                 * and is not guaranteed to match the drive mapping that DOS ultimately uses.
                 */
                var iDrive = sDrive.charCodeAt(0) - 0x41;
                if (iDrive >= 0 && iDrive < this.aDrives.length) {
                    if (!this.loadDiskette(iDrive, pDriveConfig['name'], pDriveConfig['path'], true) && fRemount)
                        this.setReady(false);
                    continue;
                }
            }
            this.notice("Unrecognized auto-mount specification for drive " + sDrive);
        }
    }
    return !!this.cAutoMount;
};

/**
 * loadDiskette(iDrive, sDisketteName, sDiskettePath, fAutoMount)
 *
 * NOTE: If sDiskettePath is already loaded in the drive, nothing needs to be done.
 *
 * @this {FDC}
 * @param {number} iDrive (pre-validated)
 * @param {string} sDisketteName
 * @param {string|null} sDiskettePath
 * @param {boolean} fAutoMount
 * @return {boolean} true if diskette (already) loaded, false if queued up (or busy)
 */
FDC.prototype.loadDiskette = function(iDrive, sDisketteName, sDiskettePath, fAutoMount)
{
    var drive = this.aDrives[iDrive];
    if (sDiskettePath && drive.sDiskettePath != sDiskettePath) {
        this.unloadDrive(iDrive, fAutoMount, true);
        if (drive.fBusy) {
            this.notice("Drive " + iDrive + " busy");
            return true;
        }
        drive.fBusy = true;
        if (fAutoMount) {
            drive.fAutoMount = true;
            this.cAutoMount++;
            this.messageDebugger("loading diskette '" + sDisketteName + "'");
        }
        var disk = new Disk(this, drive, DiskAPI.MODE.PRELOAD);
        disk.load(sDisketteName, sDiskettePath, this.doneLoadDiskette);
        return false;
    }
    return true;
};

/**
 * doneLoadDiskette(drive, disk, sDisketteName, sDiskettePath)
 *
 * @this {FDC}
 * @param {Object} drive
 * @param {Disk} disk is set if the disk was successfully loaded, null if not
 * @param {string} sDisketteName
 * @param {string} sDiskettePath
 */
FDC.prototype.doneLoadDiskette = function onFDCLoadNotify(drive, disk, sDisketteName, sDiskettePath)
{
    var aDiskInfo;

    drive.fBusy = false;

    if (disk) {
        /*
         * We shouldn't mount the diskette unless the drive is able to handle it; for example, FD360 (40-track)
         * drives cannot read FD1200 (80-track) diskettes.  However, I no longer require that the diskette's
         * sectors/track fall within the drive's standard maximum, because XDF diskettes use 19 physical sectors/track
         * on the first cylinder (1 more than the typical 18 sectors/track found on 1.44Mb diskettes) but declare
         * a larger logical size (23 512-byte sectors/track) to reflect the actual capacity of XDF tracks beyond the
         * first cylinder (ie, one 8Kb sector, one 2Kb sector, one 1Kb sector, and one 512-byte sector).
         */
        aDiskInfo = disk.info();
        if (disk && aDiskInfo[0] > drive.nCylinders || aDiskInfo[1] > drive.nHeads /* || aDiskInfo[2] > drive.nSectors */) {
            this.notice("Diskette \"" + sDisketteName + "\" too large for drive " + String.fromCharCode(0x41 + drive.iDrive));
            disk = null;
        }
    }

    if (disk) {
        drive.disk = disk;
        drive.sDisketteName = sDisketteName;
        drive.sDiskettePath = sDiskettePath;
        this.addDiskHistory(sDisketteName, sDiskettePath, disk);

        /*
         * Clearly, a successful mount implies a disk change, and I suppose that, technically, an *unsuccessful*
         * mount should imply the same, but what would the real-world analog be?  Inserting a piece of cardboard
         * instead of an actual diskette?  In any case, if we can do the user a favor by pretending (as far as the
         * disk change line is concerned) that an unsuccessful mount never happened, let's do it.
         *
         * Successful unmounts are a different story, however; those *do* trigger a change. See unloadDrive().
         */
        this.regInput |= FDC.REG_INPUT.DISK_CHANGE;

        /*
         * With the addition of notify(), users are now "alerted" whenever a diskette has finished loading;
         * notify() is selective about its output, using print() if a print window is open, alert() otherwise.
         *
         * WARNING: This conversion of drive number to drive letter, starting with A:, is very simplistic
         * and will not match the drive mappings that DOS ultimately uses (ie, for drives beyond B:).
         */
        this.notice("Mounted diskette \"" + sDisketteName + "\" in drive " + String.fromCharCode(0x41 + drive.iDrive), drive.fAutoMount);

        /*
         * Update the drive's current media parameters to match the disk's.
         */
        drive.nDiskCylinders = aDiskInfo[0];
        drive.nDiskHeads = aDiskInfo[1];
        drive.nDiskSectors = aDiskInfo[2];
    }

    if (drive.fAutoMount) {
        drive.fAutoMount = false;
        if (!--this.cAutoMount) this.setReady();
    }

    this.displayDiskette(drive.iDrive);
};

/**
 * displayDiskette(iDrive, fUpdateDrive)
 *
 * @this {FDC}
 * @param {number} iDrive (unvalidated)
 * @param {boolean} [fUpdateDrive] is true to update the drive list to match the specified drive (eg, the auto-mount case)
 */
FDC.prototype.displayDiskette = function(iDrive, fUpdateDrive)
{
    /*
     * First things first: validate iDrive.
     */
    if (iDrive >= 0 && iDrive < this.aDrives.length) {
        var drive = this.aDrives[iDrive];
        var controlDisks = this.bindings["listDisks"];
        var controlDrives = this.bindings["listDrives"];
        /*
         * Next, make sure controls for both drives and disks exist.
         */
        if (controlDisks && controlDrives) {
            /*
             * Next, make sure the drive whose disk we're updating is the currently selected drive.
             */
            var i;
            var iDriveSelected = parseInt(controlDrives.value, 10);
            if (!isNaN(iDriveSelected) && iDriveSelected == iDrive) {
                for (i = 0; i < controlDisks.options.length; i++) {
                    if (controlDisks.options[i].value == drive.sDiskettePath) {
                        if (controlDisks.selectedIndex != i) {
                            controlDisks.selectedIndex = i;
                        }
                        break;
                    }
                }
                if (i == controlDisks.options.length) controlDisks.selectedIndex = 0;
            }
            if (fUpdateDrive) {
                for (i = 0; i < controlDrives.options.length; i++) {
                    if (parseInt(controlDrives.options[i].value, 10) == drive.iDrive) {
                        if (controlDrives.selectedIndex != i) {
                            controlDrives.selectedIndex = i;
                        }
                        break;
                    }
                }
            }
        }
    }
};

/**
 * unloadDrive(iDrive, fAutoUnload, fQuiet)
 *
 * @this {FDC}
 * @param {number} iDrive (pre-validated)
 * @param {boolean} [fAutoUnload] is true if this unload is being forced as part of an automount and/or restored mount
 * @param {boolean} [fQuiet]
 */
FDC.prototype.unloadDrive = function(iDrive, fAutoUnload, fQuiet)
{
    var drive = this.aDrives[iDrive];
    if (drive.disk) {
        /*
         * Before we toss the disk's information, capture any deltas that may have occurred.
         */
        this.updateDiskHistory(drive.sDisketteName, drive.sDiskettePath, drive.disk);
        drive.sDisketteName = "";
        drive.sDiskettePath = "";
        drive.disk = null;

        this.regInput |= FDC.REG_INPUT.DISK_CHANGE;

        /*
         * WARNING: This conversion of drive number to drive letter, starting with A:, is very simplistic
         * and is not guaranteed to match the drive mapping that DOS ultimately uses.
         */
        if (!fQuiet) {
            this.notice("Drive " + String.fromCharCode(0x41 + iDrive) + " unloaded", fAutoUnload);
        }
        /*
         * Try to avoid any unnecessary hysteresis regarding the diskette display if this unload is merely
         * a prelude to another load.
         */
        if (!fAutoUnload && !fQuiet) {
            this.displayDiskette(iDrive);
        }
    }
};

/**
 * unloadAllDrives(fDiscard)
 *
 * @this {FDC}
 * @param {boolean} fDiscard to discard all disk history before unloading
 */
FDC.prototype.unloadAllDrives = function(fDiscard)
{
    if (fDiscard) {
        this.aDiskHistory = [];
    }
    for (var iDrive = 0; iDrive < this.aDrives.length; iDrive++) {
        this.unloadDrive(iDrive, true);
    }
};

/**
 * addDiskHistory(sDisketteName, sDiskettePath, disk)
 *
 * @this {FDC}
 * @param {string} sDisketteName
 * @param {string} sDiskettePath
 * @param {Disk} disk containing corresponding disk image
 */
FDC.prototype.addDiskHistory = function(sDisketteName, sDiskettePath, disk)
{
    var i;
    for (i = 0; i < this.aDiskHistory.length; i++) {
        if (this.aDiskHistory[i][1] == sDiskettePath) {
            var nChanges = disk.restore(this.aDiskHistory[i][2]);
            if (DEBUG) this.messageDebugger("disk '" + sDisketteName + "' restored from history (" + nChanges + " changes)");
            return;
        }
    }
    if (DEBUG) this.messageDebugger("disk '" + sDisketteName + "' added to history (" + sDiskettePath + ")");
    this.aDiskHistory[i] = [sDisketteName, sDiskettePath, []];
};

/**
 * removeDiskHistory(sDisketteName, sDiskettePath)
 *
 * @this {FDC}
 * @param {string} sDisketteName
 * @param {string} sDiskettePath
 */
FDC.prototype.removeDiskHistory = function(sDisketteName, sDiskettePath)
{
    var i;
    for (i = 0; i < this.aDiskHistory.length; i++) {
        if (this.aDiskHistory[i][1] == sDiskettePath) {
            this.aDiskHistory.splice(i, 1);
            if (DEBUG) this.messageDebugger("disk '" + sDisketteName + "' removed from history");
            return;
        }
    }
    if (DEBUG) this.messageDebugger("unable to remove disk '" + sDisketteName + "' from history (" + sDiskettePath + ")");
};

/**
 * updateDiskHistory(sDisketteName, sDiskettePath, disk)
 *
 * @this {FDC}
 * @param {string} sDisketteName
 * @param {string} sDiskettePath
 * @param {Disk} disk containing corresponding disk image, with possible deltas
 */
FDC.prototype.updateDiskHistory = function(sDisketteName, sDiskettePath, disk)
{
    var i;
    for (i = 0; i < this.aDiskHistory.length; i++) {
        if (this.aDiskHistory[i][1] == sDiskettePath) {
            this.aDiskHistory[i][2] = disk.save();
            if (DEBUG) this.messageDebugger("disk '" + sDisketteName + "' updated in history");
            return;
        }
    }
    /*
     * I used to report this as an error (at least in the DEBUG release), but it's no longer really
     * an error, because if we're trying to re-mount a clean copy of a disk, we toss its history, then
     * unload, and then reload/remount.  And since unloadDrive's normal behavior is to call updateDiskHistory()
     * before unloading, the fact that the disk is no longer listed here can't be treated as an error.
     */
    if (DEBUG) this.messageDebugger("unable to update disk '" + sDisketteName + "' in history (" + sDiskettePath + ")");
};

/**
 * outFDCOutput(port, bOut, addrFrom)
 *
 * @this {FDC}
 * @param {number} port (0x3F2, output only)
 * @param {number} bOut
 * @param {number} [addrFrom] (not defined whenever the Debugger tries to read the specified port)
 */
FDC.prototype.outFDCOutput = function(port, bOut, addrFrom)
{
    this.messagePort(port, bOut, addrFrom, "OUTPUT");
    if (!(bOut & FDC.REG_OUTPUT.ENABLE)) {
        this.initController();
        /*
         * initController() resets, among other things, the selected drive (this.iDrive), so if we were
         * still updating this.iDrive below based on the "drive select" bits in regOutput, we would want
         * to make sure those bits now match what initController() set.  But since we no longer do that
         * (see below), this is no longer needed either.
         *
         *      bOut = (bOut & ~FDC.REG_OUTPUT.DS) | this.iDrive;
         */
    }
    else if (!(this.regOutput & FDC.REG_OUTPUT.ENABLE)) {
        /*
         * When FDC.REG_OUTPUT.ENABLE transitions from 0 to 1, generate an interrupt.
         */
        if (this.regOutput & FDC.REG_OUTPUT.INT_ENABLE) {
            if (this.chipset) this.chipset.setIRR(ChipSet.IRQ.FDC);
        }
    }
    /*
     * This no longer updates the internally selected drive (this.iDrive) based on regOutput, because (a) there seems
     * to be no point, as all drive-related commands include their own "drive select" bits, and (b) it breaks the
     * MODEL_5170 boot code.  Here's why:
     *
     * Unlike previous models, the MODEL_5170 BIOS probes all installed diskette drives to determine drive type;
     * ie, FD360 (40-track) or FD1200 (80-track).  So if there are two drives, the last selected drive will be drive 1.
     * Immediately before booting, the BIOS issues an INT 0x13/AH=0 reset, which writes regOutput two times: first
     * with FDC.REG_OUTPUT.ENABLE clear, and then with it set.  However, both times, it ALSO loads the last selected
     * drive number into regOutput's "drive select" bits.
     *
     * If we switched our selected drive to match regOutput, then the ST0 value we returned on an SENSE_INT command
     * following the regOutput reset operation would indicate drive 1 instead of drive 0.  But the BIOS requires
     * the ST0 result from the SENSE_INT command ALWAYS be 0xC0 (not 0xC1), so the controller must not be propagating
     * regOutput's "drive select" bits in the way I originally assumed.
     *
     *      var iDrive = bOut & FDC.REG_OUTPUT.DS;
     *      if (bOut & (FDC.REG_OUTPUT.MOTOR_D0 << iDrive)) this.iDrive = iDrive;
     */
    this.regOutput = bOut;
};

/**
 * inFDCStatus(port, addrFrom)
 *
 * @this {FDC}
 * @param {number} port (0x3F4, input only)
 * @param {number} [addrFrom] (not defined whenever the Debugger tries to read the specified port)
 * @return {number} simulated port value
 */
FDC.prototype.inFDCStatus = function(port, addrFrom)
{
    this.messagePort(port, null, addrFrom, "STATUS", this.regStatus);
    return this.regStatus;
};

/**
 * inFDCData(port, addrFrom)
 *
 * @this {FDC}
 * @param {number} port (0x3F5, input/output)
 * @param {number} [addrFrom] (not defined whenever the Debugger tries to read the specified port)
 * @return {number} simulated port value
 */
FDC.prototype.inFDCData = function(port, addrFrom)
{
    var bIn = 0;
    if (this.regDataIndex < this.regDataTotal) {
        bIn = this.regDataArray[this.regDataIndex];
    }
    /*
     * As per the discussion in doCmd(), once the first byte of the Result Phase has been read, the interrupt must be cleared.
     */
    if (this.regOutput & FDC.REG_OUTPUT.INT_ENABLE) {
        if (this.chipset) this.chipset.clearIRR(ChipSet.IRQ.FDC);
    }
    this.messagePort(port, null, addrFrom, "DATA[" + this.regDataIndex + "]", bIn);
    if (++this.regDataIndex >= this.regDataTotal) {
        this.regStatus &= ~(FDC.REG_STATUS.READ_DATA | FDC.REG_STATUS.BUSY);
        this.regDataIndex = this.regDataTotal = 0;
    }
    return bIn;
};

/**
 * outFDCData(port, bOut, addrFrom)
 *
 * @this {FDC}
 * @param {number} port (0x3F5, input/output)
 * @param {number} bOut
 * @param {number} [addrFrom] (not defined whenever the Debugger tries to read the specified port)
 */
FDC.prototype.outFDCData = function(port, bOut, addrFrom)
{
    this.messagePort(port, bOut, addrFrom, "DATA[" + this.regDataTotal + "]");

    if (this.regDataTotal < this.regDataArray.length) {
        this.regDataArray[this.regDataTotal++] = bOut;
    }
    var bCmd = this.regDataArray[0];
    var bCmdMasked = bCmd & FDC.REG_DATA.CMD.MASK;
    if (FDC.aCmdInfo[bCmdMasked] !== undefined) {
        if (this.regDataTotal >= FDC.aCmdInfo[bCmdMasked].cbReq) {
            this.doCmd();
        }
        return;
    }
    if (DEBUG) {
        this.messageDebugger("unsupported FDC command: " + str.toHexByte(bCmd));
        if (DEBUGGER) this.cpu.haltCPU();
    }
};

/**
 * inFDCInput(port, addrFrom)
 *
 * @this {FDC}
 * @param {number} port (0x3F7, input only, MODEL_5170 only)
 * @param {number} [addrFrom] (not defined whenever the Debugger tries to read the specified port)
 * @return {number} simulated port value
 */
FDC.prototype.inFDCInput = function(port, addrFrom)
{
    var bIn = this.regInput;
    /*
     * TODO: Determine when the DISK_CHANGE bit is *really* cleared (this is just a guess)
     */
    this.regInput &= ~FDC.REG_INPUT.DISK_CHANGE;
    this.messagePort(port, null, addrFrom, "INPUT", bIn);
    return bIn;
};

/**
 * outFDCControl(port, bOut, addrFrom)
 *
 * @this {FDC}
 * @param {number} port (0x3F7, output only, MODEL_5170 only)
 * @param {number} bOut
 * @param {number} [addrFrom] (not defined whenever the Debugger tries to read the specified port)
 */
FDC.prototype.outFDCControl = function(port, bOut, addrFrom)
{
    this.messagePort(port, bOut, addrFrom, "CONTROL");
    this.regControl  = bOut;
};

/**
 * doCmd()
 *
 * @this {FDC}
 */
FDC.prototype.doCmd = function()
{
    var fIRQ = false;
    this.regDataIndex = 0;
    var bCmd = this.popCmd();
    var drive, bDrive, bHead, c, h, r, n;

    /*
     * NOTE: We currently ignore the FDC.REG_DATA.CMD.SK, FDC.REG_DATA.CMD.MF and FDC.REG_DATA.CMD.MT bits of every command.
     * The only command bit of possible interest down the road might be the FDC.REG_DATA.CMD.MT (Multi-Track); the rest relate
     * to storage format details that we cannot emulate as long as our diskette images contain nothing more than sector
     * data without any formatting data.
     *
     * Similarly, we ignore parameters like SRT, HUT, HLT and the like, since our "motors" don't require physical delays;
     * however, if timing issues become compatibility issues, we'll have to revisit those delays.  In any case, the maximum
     * speed of the simulation will still be limited by various spin-loops in the ROM BIOS that wait prescribed times, so even
     * with infinitely fast hardware, the simulation will never run as fast as it theoretically could, unless we opt to identify
     * those spin-loops and either patch them or skip over them.
     */
    var bCmdMasked = bCmd & FDC.REG_DATA.CMD.MASK;

    switch (bCmdMasked) {
    case FDC.REG_DATA.CMD.SPECIFY:                      // 0x03
        this.popSRT();                                  // SRT and HUT (encodings?)
        this.popHLT();                                  // HLT and ND (encodings?)
        this.beginResult();
        /*
         * No results are provided by this command, and fIRQ should remain false
         */
        break;

    case FDC.REG_DATA.CMD.SENSE_DRIVE:                  // 0x04
        bDrive = this.popCmd(FDC.TERMS.DS);
        bHead = (bDrive >> 2) & 0x1;
        this.iDrive = (bDrive & 0x3);
        drive = this.aDrives[this.iDrive];
        this.beginResult();
        this.pushST3(drive);
        break;

    case FDC.REG_DATA.CMD.WRITE_DATA:                   // 0x05
    case FDC.REG_DATA.CMD.READ_DATA:                    // 0x06
        bDrive = this.popCmd(FDC.TERMS.DS);             // Drive Select
        bHead = (bDrive >> 2) & 0x1;                    // isolate HD (Head Select) bits
        this.iDrive = (bDrive & 0x3);                   // isolate DS (Drive Select, aka Unit Select) bits
        drive = this.aDrives[this.iDrive];
        drive.bHead = bHead;
        c = drive.bCylinder = this.popCmd(FDC.TERMS.C); // C
        h = this.popCmd(FDC.TERMS.H);                   // H
        /*
         * Controller docs say that H should always match HD, so I assert that, but what if someone
         * made a mistake and didn't program them identically -- what would happen?  Which should we honor?
         */
        Component.assert(h == bHead);
        r = drive.bSector = this.popCmd(FDC.TERMS.R);   // R
        n = this.popCmd(FDC.TERMS.N);                   // N
        drive.nBytes = 128 << n;                        // 0 => 128, 1 => 256, 2 => 512, 3 => 1024
        drive.bSectorEnd = this.popCmd(FDC.TERMS.EOT);  // EOT (final sector number on a cylinder)
        this.popCmd(FDC.TERMS.GPL);                     // GPL (spacing between sectors, excluding VCO Sync Field; 3)
        this.popCmd(FDC.TERMS.DTL);                     // DTL (when N is 0, DTL stands for the data length to read out or write into the sector)
        if (bCmdMasked == FDC.REG_DATA.CMD.READ_DATA)
            this.doRead(drive);
        else
            this.doWrite(drive);
        this.pushResults(drive, bCmd, bHead, c, h, r, n);
        fIRQ = true;
        break;

    case FDC.REG_DATA.CMD.RECALIBRATE:                  // 0x07
        bDrive = this.popCmd(FDC.TERMS.DS);
        this.iDrive = (bDrive & 0x3);
        drive = this.aDrives[this.iDrive];
        drive.bCylinder = drive.bCylinderSeek = 0;
        drive.resCode = FDC.REG_DATA.RES.SEEK_END | FDC.REG_DATA.RES.TRACK0;
        this.beginResult();                             // no results provided; this command is typically followed by FDC.REG_DATA.CMD.SENSE_INT
        fIRQ = true;
        break;

    case FDC.REG_DATA.CMD.SENSE_INT:                    // 0x08
        drive = this.aDrives[this.iDrive];
        drive.bHead = 0;                                // this command is documented as ALWAYS returning a head address of 0 in ST0; see pushST0()
        this.beginResult();
        this.pushST0(drive);
        this.pushResult(drive.bCylinder, FDC.TERMS.PCN);
        /*
         * For some strange reason, the "DISK_RESET" function in the MODEL_5170_REV3 BIOS resets the
         * adapter and then issues FOUR -- that's right, not ONE but FOUR -- SENSE INTERRUPT STATUS commands
         * in a row, and expects ST0 to contain a different drive number after each command (first 0, then 1,
         * then 2, and finally 3).  What makes this doubly weird is SENSE INTERRUPT STATUS (unlike SENSE
         * DRIVE STATUS) is a drive-agnostic command.
         *
         * Didn't the original PC AT "HFCOMBO" controller limit support to TWO diskette drives max?
         * And even if the PC AT supported other FDC controllers that DID support up to FOUR diskette drives,
         * why should "DISK_RESET" hard-code a 4-drive loop?
         *
         * Well, whatever.  All this head-scratching doesn't change the fact that I apparently have to
         * "auto-increment" the internal drive number (this.iDrive) after each SENSE INTERRUPT STATUS command.
         */
        this.iDrive = (this.iDrive + 1) & 0x3;
        /*
         * No interrupt is generated by this command, so fIRQ should remain false.
         */
        break;

    case FDC.REG_DATA.CMD.READ_ID:                      // 0x0A
        /*
         * This command is used by "SETUP_DBL" in the MODEL_5170_REV3 BIOS to determine if a double-density
         * (40-track) diskette has been inserted in a high-density (80-track) drive; ie, whether "double stepping"
         * is required, since only 40 of the 80 possible "steps" are valid for a double-density diskette.
         *
         * To start, we'll focus on making this work in the normal case (80-track diskette in 80-track drive).
         */
        bDrive = this.popCmd(FDC.TERMS.DS);
        bHead = (bDrive >> 2) & 0x1;
        this.iDrive = (bDrive & 0x3);
        drive = this.aDrives[this.iDrive];
        c = drive.bCylinder;
        h = drive.bHead = bHead;
        r = drive.bSector = 1;
        n = 0;
        drive.resCode = FDC.REG_DATA.RES.NONE;
        if (drive.disk && (drive.sector = drive.disk.seek(drive.bCylinder, drive.bHead, drive.bSector))) {
            n = drive.sector.length;
        } else {
            /*
             * TODO: Determine the appropriate response code(s) for the possible errors that can occur here.
             */
            drive.resCode = FDC.REG_DATA.RES.NO_DATA | FDC.REG_DATA.RES.INCOMPLETE;
        }
        this.pushResults(drive, bCmd, bHead, c, h, r, n);
        fIRQ = true;
        break;

    case FDC.REG_DATA.CMD.FORMAT_TRACK:                 // 0x0D
        bDrive = this.popCmd(FDC.TERMS.DS);
        bHead = (bDrive >> 2) & 0x1;
        this.iDrive = (bDrive & 0x3);
        drive = this.aDrives[this.iDrive];
        c = drive.bCylinder;
        h = drive.bHead = bHead;
        r = 1;
        n = this.popCmd(FDC.TERMS.N);                   // N
        drive.nBytes = 128 << n;                        // 0 => 128, 1 => 256, 2 => 512, 3 => 1024 (bytes/sector)
        drive.bSectorEnd = this.popCmd(FDC.TERMS.SC);   // SC (sectors/track)
        this.popCmd(FDC.TERMS.GPL);                     // GPL (spacing between sectors, excluding VCO Sync Field; 3)
        drive.bFiller = this.popCmd(FDC.TERMS.D);       // D (filler byte)
        this.doFormat(drive);
        this.pushResults(drive, bCmd, bHead, c, h, r, n);
        fIRQ = true;
        break;

    case FDC.REG_DATA.CMD.SEEK:                         // 0x0F
        bDrive = this.popCmd(FDC.TERMS.DS);
        bHead = (bDrive >> 2) & 0x1;
        this.iDrive = (bDrive & 0x3);
        drive = this.aDrives[this.iDrive];
        drive.bHead = bHead;
        /*
         * As discussed in initDrive(), we can no longer simply set bCylinder to the specified NCN;
         * instead, we must calculate the delta between bCylinderSeek and the NCN, and adjust bCylinder
         * by that amount.  Then we simply move the NCN into bCylinderSeek without any range checking.
         *
         * Since bCylinder is now expressly defined as the "physical" cylinder number, it must never
         * be allowed to exceed the physical boundaries of the drive (ie, never lower than 0, and never
         * greater than or equal to nCylinders).
         */
        c = this.popCmd(FDC.TERMS.NCN);
        drive.bCylinder += c - drive.bCylinderSeek;
        if (drive.bCylinder < 0) drive.bCylinder = 0;
        if (drive.bCylinder >= drive.nCylinders) drive.bCylinder = drive.nCylinders - 1;
        drive.bCylinderSeek = c;
        drive.resCode = FDC.REG_DATA.RES.SEEK_END;
        /*
         * TODO: To properly support ALL the ST3 result bits (not just TRACK0), we need a resCode
         * update() function that all FDC commands can use.  This code is merely sufficient to get us
         * through the "DSKETTE_SETUP" gauntlet in the MODEL_5170 BIOS.
         */
        if (drive.bCylinder == 0) {
            drive.resCode |= FDC.REG_DATA.RES.TRACK0;
        }
        this.beginResult();                             // like FDC.REG_DATA.CMD.RECALIBRATE, no results are provided
        fIRQ = true;
        break;

    default:
        if (DEBUG) {
            this.messageDebugger("FDC operation unsupported (command=0x: " + str.toHexByte(bCmd) + ")");
            if (DEBUGGER) this.cpu.haltCPU();
        }
        break;
    }

    if (this.regDataTotal > 0) this.regStatus |= (FDC.REG_STATUS.READ_DATA | FDC.REG_STATUS.BUSY);

    /*
     * After the Execution Phase (eg, DMA Terminal Count has occurred, or the EOT sector has been read/written),
     * an interrupt is supposed to occur, signaling the beginning of the Result Phase.  Once the first byte of the
     * result has been read, the interrupt is cleared (see inFDCData).
     *
     * TODO: Technically, interrupt request status should be cleared by the FDC.REG_DATA.CMD.SENSE_INT command; in fact,
     * if that command is issued and no interrupt was pending, then FDC.REG_DATA.RES.INVALID should be returned (via ST0).
     */
    if (this.regOutput & FDC.REG_OUTPUT.INT_ENABLE) {
        if (drive && !(drive.resCode & FDC.REG_DATA.RES.NOT_READY) && fIRQ) {
            if (this.chipset) this.chipset.setIRR(ChipSet.IRQ.FDC);
        }
    }
};

/**
 * pushResults(drive, bCmd, bHead, c, h, r, n)
 *
 * @param {Object} drive
 * @param {number} bCmd
 * @param {number} bHead
 * @param {number} c
 * @param {number} h
 * @param {number} r
 * @param {number} n
 */
FDC.prototype.pushResults = function(drive, bCmd, bHead, c, h, r, n)
{
    this.beginResult();
    this.pushST0(drive);
    this.pushST1(drive);
    this.pushST2(drive);
    /*
     * NOTE: I used to set the following C/H/R/N results using the values that advanceSector() had "advanced"
     * them to, which seemed logical but was technically incorrect.  For non-multi-track reads, they should match
     * the programmed C/H/R/N values, except when EOT has been reached, in which case C = C + 1 and R = 1.
     *
     * For multi-track, the LSB of H should be complemented whenever EOT has been reached, which I "informally"
     * detect by testing if the drive's current bCylinder and/or bHead positions advanced to a new cylinder or head,
     * and apparently, C should never be advanced if H was initially 0.
     *
     * I don't do strict EOT comparisons here or elsewhere, because it allows the controller to work with a wider
     * range of disks (eg, "fake" XDF disk images that contain 23 512-byte sectors/track).
     */
    var i = 0;
    if (c != drive.bCylinder || h != drive.bHead) {
        i = r = 1;
    }
    if (bCmd & FDC.REG_DATA.CMD.MT) {
        h ^= i;
        if (!bHead) i = 0;
    }
    c += i;
    this.pushResult(c, FDC.TERMS.C);                // formerly drive.bCylinder
    this.pushResult(h, FDC.TERMS.H);                // formerly drive.bHead
    this.pushResult(r, FDC.TERMS.R);                // formerly drive.bSector
    this.pushResult(n, FDC.TERMS.N);
};

/**
 * popCmd(name)
 *
 * @this {FDC}
 * @param {string|undefined} [name]
 * @return {number}
 */
FDC.prototype.popCmd = function(name)
{
    Component.assert((!this.regDataIndex || name !== undefined) && this.regDataIndex < this.regDataTotal);
    var bCmd = this.regDataArray[this.regDataIndex];
    if (DEBUG && DEBUGGER && this.dbg && this.dbg.messageEnabled(FDC.MESSAGE_FDC)) {
        var bCmdMasked = bCmd & FDC.REG_DATA.CMD.MASK;
        if (!name && !this.regDataIndex && FDC.aCmdInfo[bCmdMasked]) name = FDC.aCmdInfo[bCmdMasked].name;
        this.dbg.message("FDC.CMD[" + (name || this.regDataIndex) + "]: 0x" + str.toHexByte(bCmd));
    }
    this.regDataIndex++;
    return bCmd;
};

/**
 * popHLT()
 *
 * NOTE: This byte is actually a combination of HLT (Head Load Time) and ND (Non-DMA Mode)
 *
 * @this {FDC}
 */
FDC.prototype.popHLT = function()
{
    this.popCmd(FDC.TERMS.HLT);
 // this.nHLT = this.popCmd(FDC.TERMS.HLT);
};

/**
 * popSRT()
 *
 * NOTE: This byte is actually a combination of SRT (Step Rate Time) and HUT (Head Unload Time)
 *
 * @this {FDC}
 */
FDC.prototype.popSRT = function()
{
    this.popCmd(FDC.TERMS.SRT);
 // this.nSRT = this.popCmd(FDC.TERMS.SRT);
};

/**
 * beginResult()
 *
 * @this {FDC}
 */
FDC.prototype.beginResult = function()
{
    this.regDataIndex = this.regDataTotal = 0;
};

/**
 * pushResult(bResult, name)
 *
 * @this {FDC}
 * @param {number} bResult
 * @param {string|undefined} [name]
 */
FDC.prototype.pushResult = function(bResult, name)
{
    if (DEBUG) this.messageDebugger("FDC.RES[" + (name || this.regDataTotal) + "]: 0x" + str.toHexByte(bResult), FDC.MESSAGE_FDC);
    this.regDataArray[this.regDataTotal++] = bResult;
};

/**
 * pushST0(drive)
 *
 * @this {FDC}
 * @param {Object} drive
 */
FDC.prototype.pushST0 = function(drive)
{
    this.pushResult(drive.iDrive | (drive.bHead << 2) | (drive.resCode & FDC.REG_DATA.RES.ST0), FDC.TERMS.ST0);
};

/**
 * pushST1(drive)
 *
 * @this {FDC}
 * @param {Object} drive
 */
FDC.prototype.pushST1 = function(drive)
{
    this.pushResult((drive.resCode & FDC.REG_DATA.RES.ST1) >>> 8, FDC.TERMS.ST1);
};

/**
 * pushST2(drive)
 *
 * @this {FDC}
 * @param {Object} drive
 */
FDC.prototype.pushST2 = function(drive)
{
    this.pushResult((drive.resCode & FDC.REG_DATA.RES.ST2) >>> 16, FDC.TERMS.ST2);
};

/**
 * pushST3(drive)
 *
 * @this {FDC}
 * @param {Object} drive
 */
FDC.prototype.pushST3 = function(drive)
{
    this.pushResult((drive.resCode & FDC.REG_DATA.RES.ST3) >>> 24, FDC.TERMS.ST3);
};

/**
 * dmaRead(drive, b, done)
 *
 * @this {FDC}
 * @param {Object} drive
 * @param {number} b
 * @param {function(number,boolean)} done
 */
FDC.prototype.dmaRead = function(drive, b, done)
{
    if (b === undefined || b < 0) {
        this.readByte(drive, done);
        return;
    }
    /*
     * The DMA controller should be ASKING for data, not GIVING us data; this suggests an internal DMA miscommunication
     */
    if (DEBUG) this.messageDebugger("dmaRead(): invalid DMA acknowledgement");
    done(-1, false);
};

/**
 * dmaWrite(drive, b)
 *
 * @this {FDC}
 * @param {Object} drive
 * @param {number} b
 * @return {number}
 */
FDC.prototype.dmaWrite = function(drive, b)
{
    if (b !== undefined && b >= 0)
        return this.writeByte(drive, b);
    /*
     * The DMA controller should be GIVING us data, not ASKING for data; this suggests an internal DMA miscommunication
     */
    if (DEBUG) this.messageDebugger("dmaWrite(): invalid DMA acknowledgement");
    return -1;
};

/**
 * dmaFormat(drive, b)
 *
 * @this {FDC}
 * @param {Object} drive
 * @param {number} b
 * @returns {number}
 */
FDC.prototype.dmaFormat = function(drive, b)
{
    if (b !== undefined && b >= 0)
        return this.writeFormat(drive, b);
    /*
     * The DMA controller should be GIVING us data, not ASKING for data; this suggests an internal DMA miscommunication
     */
    if (DEBUG) this.messageDebugger("dmaFormat(): invalid DMA acknowledgement");
    return -1;
};

/**
 * doRead(drive)
 *
 * @this {FDC}
 * @param {Object} drive
 */
FDC.prototype.doRead = function(drive)
{
    /*
     * With only NOT_READY and INCOMPLETE set, an empty drive causes DOS to report "General Failure";
     * with the addition of NO_DATA, DOS reports "Sector not found".  The traditional "Drive not ready"
     * error message is not triggered by anything we return here, but simply by BIOS commands timing out.
     */
    drive.resCode = FDC.REG_DATA.RES.NOT_READY | FDC.REG_DATA.RES.INCOMPLETE;

    if (DEBUG) this.messageDebugger("FDC.doRead(" + drive.bCylinder + ":" + drive.bHead + ":" + drive.bSector + ":" + drive.nBytes + ")");

    if (drive.disk) {
        drive.sector = null;
        drive.resCode = FDC.REG_DATA.RES.NONE;
        if (this.chipset) {
            this.chipset.connectDMA(ChipSet.DMA_FDC, this, 'dmaRead', drive);
            this.chipset.requestDMA(ChipSet.DMA_FDC);
        }
    }
};

/**
 * doWrite(drive)
 *
 * @this {FDC}
 * @param {Object} drive
 */
FDC.prototype.doWrite = function(drive)
{
    drive.resCode = FDC.REG_DATA.RES.NOT_READY | FDC.REG_DATA.RES.INCOMPLETE;

    if (DEBUG) this.messageDebugger("FDC.doWrite(" + drive.bCylinder + ":" + drive.bHead + ":" + drive.bSector + ":" + drive.nBytes + ")");

    if (drive.disk) {
        if (drive.disk.fWriteProtected) {
            drive.resCode = FDC.REG_DATA.RES.NOT_WRITABLE | FDC.REG_DATA.RES.INCOMPLETE;
            return;
        }
        drive.sector = null;
        drive.resCode = FDC.REG_DATA.RES.NONE;
        if (this.chipset) {
            this.chipset.connectDMA(ChipSet.DMA_FDC, this, 'dmaWrite', drive);
            this.chipset.requestDMA(ChipSet.DMA_FDC);
        }
    }
};

/**
 * doFormat(drive)
 *
 * drive is initialized by doCmd() to the following extent:
 *
 *      drive.bHead (ignored)
 *      drive.nBytes (bytes/sector)
 *      drive.bSectorEnd (sectors/track)
 *      drive.bFiller (fill byte)
 *
 * and we expect the DMA controller to provide C, H, R and N (ie, 4 bytes) for each sector to be formatted.
 *
 * @this {FDC}
 * @param {Object} drive
 */
FDC.prototype.doFormat = function(drive)
{
    drive.resCode = FDC.REG_DATA.RES.NOT_READY | FDC.REG_DATA.RES.INCOMPLETE;

    if (drive.disk) {
        drive.sector = null;
        drive.resCode = FDC.REG_DATA.RES.NONE;
        if (this.chipset) {
            drive.cbFormat = 0;
            drive.abFormat = new Array(4);
            drive.bFormatting = true;
            drive.cSectorsFormatted = 0;
            this.chipset.connectDMA(ChipSet.DMA_FDC, this, 'dmaFormat', drive);
            this.chipset.requestDMA(ChipSet.DMA_FDC);
            drive.bFormatting = false;
        }
    }
};

/**
 * readByte(drive)
 *
 * The following drive properties must have been setup prior to our first call:
 *
 *      drive.bHead
 *      drive.bCylinder
 *      drive.bSector
 *      drive.sector (initialized to null)
 *
 * On the first readByte() request, since drive.sector will be null, we ask the Disk object to look
 * up the first sector of the request.  We then ask the Disk for bytes from that sector until the sector
 * is exhausted, and then we look up the next sector and continue the process.
 *
 * NOTE: Since the FDC isn't aware of the extent of the transfer, all readByte() can do is return bytes
 * until the current track (or, in the case of a multi-track request, the current cylinder) has been exhausted.
 *
 * TODO: Research the requirements, if any, for multi-track I/O and determine what else needs to be done.
 *
 * @this {FDC}
 * @param {Object} drive
 * @param {function(number,boolean)} done (number is next available byte from drive, or -1 if no more bytes available)
 */
FDC.prototype.readByte = function(drive, done)
{
    var b = -1;
    if (!drive.resCode && drive.disk) {
        do {
            if (drive.sector) {
                if ((b = drive.disk.read(drive.sector, drive.ibSector++)) >= 0)
                    break;
            }
            /*
             * Locate the next sector, and then try reading again.
             */
            drive.sector = drive.disk.seek(drive.bCylinder, drive.bHead, drive.bSector);
            if (!drive.sector) {
                drive.resCode = FDC.REG_DATA.RES.NO_DATA | FDC.REG_DATA.RES.INCOMPLETE;
                break;
            }
            drive.ibSector = 0;
            /*
             * We "pre-advance" bSector et al now, instead of waiting to advance it right before the seek().
             * This allows the initial call to readByte() to perform a seek without triggering an unwanted advance.
             */
            this.advanceSector(drive);
        } while (true);
    }
    done(b, false);
};

/**
 * writeByte(drive, b)
 *
 * The following drive properties must have been setup prior to our first call:
 *
 *      drive.bHead
 *      drive.bCylinder
 *      drive.bSector
 *      drive.sector (initialized to null)
 *
 * On the first writeByte() request, since drive.sector will be null, we ask the Disk object to look
 * up the first sector of the request.  We then send the Disk bytes for that sector until the sector
 * is full, and then we look up the next sector and continue the process.
 *
 * NOTE: Since the FDC isn't aware of the extent of the transfer, all writeByte() can do is accept bytes
 * until the current track (or, in the case of a multi-track request, the current cylinder) has been exhausted.
 *
 * TODO: Research the requirements, if any, for multi-track I/O and determine what else needs to be done.
 *
 * @this {FDC}
 * @param {Object} drive
 * @param {number} b containing next byte to write
 * @return {number} (b unchanged; return -1 if command should be terminated)
 */
FDC.prototype.writeByte = function(drive, b)
{
    if (drive.resCode || !drive.disk) return -1;
    do {
        if (drive.sector) {
            if (drive.disk.write(drive.sector, drive.ibSector++, b))
                break;
        }
        /*
         * Locate the next sector, and then try writing again.
         */
        drive.sector = drive.disk.seek(drive.bCylinder, drive.bHead, drive.bSector);
        if (!drive.sector) {
            /*
             * TODO: Determine whether this should be FDC.REG_DATA.RES.CRC_ERROR or FDC.REG_DATA.RES.DATA_FIELD
             */
            drive.resCode = FDC.REG_DATA.RES.CRC_ERROR | FDC.REG_DATA.RES.INCOMPLETE;
            b = -1;
            break;
        }
        drive.ibSector = 0;
        /*
         * We "pre-advance" bSector et al now, instead of waiting to advance it right before the seek().
         * This allows the initial call to writeByte() to perform a seek without triggering an unwanted advance.
         */
        this.advanceSector(drive);
    } while (true);
    return b;
};

/**
 * advanceSector(drive)
 *
 * This increments the sector number; when the sector number reaches drive.nDiskSectors on the current track, we
 * increment drive.bHead and reset drive.bSector, and when drive.bHead reaches drive.nDiskHeads, we reset drive.bHead
 * and increment drive.bCylinder.
 *
 * @this {FDC}
 * @param {Object} drive
 */
FDC.prototype.advanceSector = function(drive)
{
    Component.assert(drive.bCylinder < drive.nDiskCylinders);
    drive.bSector++;
    var bSectorStart = 1;
    if (drive.bSector >= drive.nDiskSectors + bSectorStart) {
        drive.bSector = bSectorStart;
        drive.bHead++;
        if (drive.bHead >= drive.nDiskHeads) {
            drive.bHead = 0;
            drive.bCylinder++;
        }
    }
};

/**
 * writeFormat(drive, b)
 *
 * @this {FDC}
 * @param {Object} drive
 * @param {number} b containing a format command byte
 * @return {number} (b if successful, -1 if command should be terminated)
 */
FDC.prototype.writeFormat = function(drive, b)
{
    if (drive.resCode) return -1;
    drive.abFormat[drive.cbFormat++] = b;
    if (drive.cbFormat == drive.abFormat.length) {
        drive.bCylinder = drive.abFormat[0];    // C
        drive.bHead = drive.abFormat[1];        // H
        drive.bSector = drive.abFormat[2];      // R
        drive.nBytes = 128 << drive.abFormat[3];// N (0 => 128, 1 => 256, 2 => 512, 3 => 1024)
        drive.cbFormat = 0;
        if (DEBUG) this.messageDebugger("writeFormat(head=" + str.toHexByte(drive.bHead) + ",cyl=" + str.toHexByte(drive.bCylinder) + ",sec=" + str.toHexByte(drive.bSector) + ",len=" + str.toHexWord(drive.nBytes) + ")");
        for (var i = 0; i < drive.nBytes; i++) {
            if (this.writeByte(drive, drive.bFiller) < 0) {
                return -1;
            }
        }
        drive.cSectorsFormatted++;
    }
    if (drive.cSectorsFormatted >= drive.bSectorEnd) b = -1;
    return b;
};

/**
 * intBIOSDiskette(addr)
 *
 * NOTE: This function tries to differentiate FDC requests from HDC requests, by whether the INT 0x13 drive number
 * in DL is < 0x80; however, not all INT 0x13 functions required a drive number in DL, and not all callers supplied one.
 *
 * INT 0x13 Quick Reference:
 *
 *      AH
 *      ----
 *      0x00    Reset
 *      0x01    Get status (from last operation)
 *      0x02    Read sectors
 *      0x03    Write sectors
 *      0x04    Verify sectors
 *      0x05    Format track
 *
 * For Read, Write, Verify and Format commands:
 *
 *      DL      drive number (0-3 allowed, value checked)
 *      DH      head number (0-1 allowed, not value checked)
 *      CH      track number (0-39 allowed, not value checked [which is good, because high-density diskettes go up to 80 tracks])
 *      CL      sector number (1-8 allowed, not value checked [which is good, because support for 9-sector tracks was later added])
 *      AL      number of sectors (max of 8, not value checked)
 *      ES:BX   sector buffer
 *
 * @this {FDC}
 * @param {number} addr
 * @return {boolean} true to proceed with the INT 0x13 software interrupt, false to skip
 */
FDC.prototype.intBIOSDiskette = function(addr)
{
    if (DEBUGGER) {
        var DL = this.cpu.regDX & 0xff;
        if (this.dbg && this.dbg.messageEnabled(FDC.MESSAGE_FDC | FDC.MESSAGE_INT) && DL < 0x80) {
            this.dbg.messageInt(FDC.BIOS.INT_DISKETTE, addr);
            this.cpu.addIntReturn(addr, function(fdc, nCycles) {
                return function onBIOSDisketteReturn(nLevel) {
                    fdc.dbg.messageIntReturn(FDC.BIOS.INT_DISKETTE, nLevel, fdc.cpu.getCycles() - nCycles);
                };
            }(this, this.cpu.getCycles()));
        }
    }
    return true;
};

/**
 * messageDebugger(sMessage, bitsMessage)
 *
 * This is a combination of the Debugger's messageEnabled(MESSAGE_FDC) and message() functions, for convenience.
 *
 * @this {FDC}
 * @param {string} sMessage is any caller-defined message string
 * @param {number} [bitsMessage] is one or more Debugger MESSAGE_* category flag(s)
 */
FDC.prototype.messageDebugger = function(sMessage, bitsMessage)
{
    if (DEBUGGER && this.dbg) {
        if (bitsMessage == null) bitsMessage = FDC.MESSAGE_FDC;
        if (this.dbg.messageEnabled(bitsMessage)) this.dbg.message(sMessage);
    }
};

/**
 * messagePort(port, bOut, addrFrom, name, bIn)
 *
 * This is an internal version of the Debugger's messagePort() function, for convenience.
 *
 * @this {FDC}
 * @param {number} port
 * @param {number|null} bOut if an output operation
 * @param {number|null} [addrFrom]
 * @param {string|null} [name] of the port, if any
 * @param {number} [bIn] is the input value, if known, on an input operation
 */
FDC.prototype.messagePort = function(port, bOut, addrFrom, name, bIn)
{
    if (DEBUGGER && this.dbg) this.dbg.messagePort(this, port, bOut, addrFrom, name, FDC.MESSAGE_FDC, bIn);
};

/*
 * Port input notification table
 *
 * TODO: Even though port 0x3F7 was not present on controllers prior to MODEL_5170, I'm taking the easy
 * way out and always emulating it.  So, consider an FDC parameter to disable that feature for stricter compatibility.
 */
FDC.aPortInput = {
    0x3F4: FDC.prototype.inFDCStatus,
    0x3F5: FDC.prototype.inFDCData,
    0x3F7: FDC.prototype.inFDCInput
};

/*
 * Port output notification table
 *
 * TODO: Even though port 0x3F7 was not present on controllers prior to MODEL_5170, I'm taking the easy
 * way out and always emulating it.  So, consider an FDC parameter to disable that feature for stricter compatibility.
 */
FDC.aPortOutput = {
    0x3F2: FDC.prototype.outFDCOutput,
    0x3F5: FDC.prototype.outFDCData,
    0x3F7: FDC.prototype.outFDCControl
};

/**
 * FDC.init()
 *
 * This function operates on every element (e) of class "fdc", and initializes
 * all the necessary HTML to construct the FDC module(s) as spec'ed.
 *
 * Note that each element (e) of class "fdc" is expected to have a "data-value"
 * attribute containing the same JSON-encoded parameters that the FDC constructor expects.
 */
FDC.init = function() {
    var aeFDC = Component.getElementsByClass(window.document, PCJSCLASS, "fdc");
    for (var iFDC = 0; iFDC < aeFDC.length; iFDC++) {
        var eFDC = aeFDC[iFDC];
        var parmsFDC = Component.getComponentParms(eFDC);
        var fdc = new FDC(parmsFDC);
        Component.bindComponentControls(fdc, eFDC, PCJSCLASS);
    }
};

/*
 * Initialize every Floppy Drive Controller (FDC) module on the page.
 */
web.onInit(FDC.init);

if (typeof APP_PCJS !== 'undefined') APP_PCJS.FDC = FDC;

if (typeof module !== 'undefined') module.exports = FDC;