Skip to content

Latest commit

 

History

History
85 lines (57 loc) · 4.77 KB

README.md

File metadata and controls

85 lines (57 loc) · 4.77 KB
Raw

IBM PC/XT for MiSTer FPGA

PCXT port for MiSTer by @spark2k06.

Discussion and evolution of the core in the following misterfpga forum section:

https://misterfpga.org/viewforum.php?f=40

Description

The purpose of this core is to implement a PCXT as reliable as possible. For this purpose, the MCL86 core from @MicroCoreLabs and KFPC-XT from @kitune-san are used.

The Graphics Gremlin project from TubeTimeUS (@schlae) has also been integrated in this first stage.

JTOPL by Jose Tejada (@jotego) was integrated for AdLib sound.

JT89 by Jose Tejada (@jotego) was integrated for Tandy sound.

Key features

  • 8088 CPU with these speed settings: 4.77 MHz, 7.16 MHz, 9.54 MHz cycle accurate, and PC/AT 286 at 3.5MHz equivalent (max. speed)
  • BIOS selectable (Tandy 1000 / PCXT)
  • Support for IBM Tandy 1000
  • Support for IBM PCXT 5160 and clones (CGA graphics)
  • Main memory 640Kb + 384Kb UMB memory
  • Simulated Composite Video, F11 -> Swap Video Output with RGB for Tandy model
  • Simultaneous video Hercules Graphics Card, F11 -> Swap Video Output with CGA for PCXT model
  • Enable/Disable of CGA and Hercules I/O ports (Only with PCXT model)
  • 1st Graphics Card selection from System & BIOS (Only with PCXT model)
  • EMS memory up to 2Mb
  • XTIDE support
  • Tandy graphics with 128Kb of shared RAM + CGA graphics
  • Audio: Adlib, Tandy, speaker
  • Joystick support
  • Mouse support into COM1 serial port, this works like any Microsoft mouse... you just need a driver to configure it, like CTMOUSE 1.9 (available into hdd folder)
  • 2nd SD card support

Quick Start

  • Copy the contents of games/PCTXT to your Mister SD Card and uncompress hd_image.zip. It contains a freedos image ( http://www.freedos.org/ )
  • Select the core from Computers/PCXT.
  • Press WinKey + F12 on your keyboard.
  • Model: IBM PCXT.
  • CPU Speed: PC/AT 3.5MHz (Max speed)
  • FDD & HDD -> HDD Image: FreeDOS_HD.img
  • BIOS -> PCXT BIOS: pcxt_micro8088.rom
  • Choose Reset & apply model.

ROM Instructions

ROMs should be provided initially from the BIOS section of the OSD menu, then it is only necessary to indicate the computer model and reset, on subsequent boot of the core, it is no longer necessary to provide them, unless we want to use others. Original and copyrighted ROMs can be generated on the fly using the python scripts available in the SW folder of this repository:

  • make_rom_with_ibm5160.py: A valid ROM is created for the PCXT model (pcxt.rom) based on the original IBM 5160 ROM, requires the XTIDE BIOS at address EC00h to work with HD images.
  • make_rom_with_jukost.py: A valid ROM is created for the PCXT model (pcxt.rom) based on the original Juko ST ROM, and with the XTIDE BIOS embedded at address F000h.
  • make_rom_with_tandy.py: A valid ROM is created for the Tandy model (tandy.rom) based on the original Tandy 1000 ROM, requires the XTIDE BIOS at address EC00h to work with HD images.

From the same BIOS section of the OSD it is possible to specify an XTIDE ROM of up to 16Kb to work at address EC00h. It is also provided in this repository.

Other Open Source ROMs are available in the same folder:

  • pcxt_pcxt31.rom: This ROM already has the XTIDE BIOS embedded at address F000h. (Source Code)
  • pcxt_micro8088.rom: This ROM already has the XTIDE BIOS embedded at address F000h. (Source Code)
  • ide_xtl.rom: This ROM corresponds to the XTIDE BIOS, it must be maintained for some scripts to work, it can also be upgraded to a newer version. (Source Code)

Note: Not all ROMs work with MDA video: (IBM5160, Yuko ST and pcxt31 works)

Other BIOSes

Mounting the FDD image

The floppy disk image size must be compatible with the BIOS, for example:

  • On IBM 5160 or Tandy 1000 only 360Kb images work well.
  • On Micro8088 only 720Kb and 1.44Mb images work properly.
  • Other BIOS may not be compatible, such as OpenXT by Ja'akov Miles and Jon Petroski.

It is possible to use images smaller than the size supported by the BIOS, but only pre-formatted images, as it will not be possible to format them from MS-Dos.

Developers

Any contribution and pull request, please carry it out on the prerelease branch. Periodically they will be reviewed, moved and merged into the main branch, together with the corresponding release.

Thank you!