From 53b78d8df75d81d0af8146ee66347d1c41135a96 Mon Sep 17 00:00:00 2001 From: Eugene Lozovoy Date: Sat, 21 Sep 2024 11:24:02 +0300 Subject: [PATCH] update readme --- README.md | 90 +++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 67 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index e69a3a2..4a64137 100644 --- a/README.md +++ b/README.md @@ -1,32 +1,76 @@ -# [TSConf](http://forum.tslabs.info/viewforum.php?f=20&sid=137db6b31f9fb533b908742c2b18284e) for MiSTer Platform +# TSConf for MiST FPGA computer -This is the port of TSConf (an improvement to the [ZX-Evolution](https://www.facebook.com/zxatmevolution/) ZX spectrum clone) to MiSTer. +This is the port of TSConf (advanced ZX Spectrum-compatible platform) to [MiST](https://github.com/mist-devel/mist-board). + +## Features of this port +- VDAC 1 +- RTC +- ZiFi (WiFi) +- Tape in/out via UART_RX/UART_TX pins +- MIDI output via UART_TX pin +- TurboSound FM (2x YM2203) +- General Sound 2MB +- SAA1099 +- Covox +- SounDrive +- 2x Kempston/Sinclair/Cursor joystick +- Kempston mouse + +## TSConf features +- High compatibility with original Pentagon-128 clone +- Advanced video features: + - Pixel resolutions 360x288, 320x240, 320x200, 256x192 + - Up to 720x288 Hi-res pixel resolution + - Hardware scrolled graphic planes + - 256 and 16 indexed colors per pixel + - Programmable color RAM with RGB555 color space and 256 cells + - 512 and 256 bytes per line addressing + - Text mode with loadable font and hardware vertical scroll + - Up to 256 graphic screens +- Hardware engine for Tiles and Sprites graphics + - Up to 85 sprites per line + - Sprites sized from 8x8 to 64x64 pixels + - Up to 3 sprite planes + - Up to 2 tile planes with 8x8 pixels tiles + - Up to 16 palettes for sprites per line + - Up to 4 palettes for tiles per line for each tile plane +- Z80 Memory addressing enhancements: + - Programmable RAM page for any 16kB window +- Z80 acceleration features + - Selectable CPU clock 14MHz, 7MHz and 3,5MHz + - 512 bytes of zero-wait RAM for 14MHz + - On-the-fly programmable maskable interrupt position + - Separate IM2 vectors for different interrupt sources +- Advanced hardware features + - DRAM-to-Device, Device-to-DRAM and DRAM-to-DRAM DMA Controller + +See details in the official git repository: [link](https://github.com/tslabs/zx-evo/blob/master/pentevo/docs/TSconf/tsconf_en.md) -## Features of the port -* Scandoubler with HQ2x and Scanlines. -* RTC. -* Configurable CMOS settings through OSD. -* Supports both secondary SD and image on primary SD. -* Kempston Joystick. -* Kempston Mouse. -* Turbosound FM (dual YM2203) -* General Sound 512KB-2MB -* SAA1099 ## Installation -place RBF into root of primary SD card. And then you have 3 options: -1) Format secondary SD card with FAT32 and unpack content of SDCard.zip to it. -2) Create TSConf.vhd image (non-MBR!) with FAT32 format and unpack SDCard.zip to it. Then place TSConf.vhd to root of primary SD card. -3) same as 2, but name the file boot.vhd and place it into TSConf folder on primary SD card. +Place TSConf.ROM, TSConf.R01 and RBF file from [release](release/) folder into root of SD card. -Put some TAP, SNA, SCL, TRD, SPG files to secondary SD card (or to TSConf.vhd image) as well. +Also you need to place TSConf.VHD file with Wild Commander and your games and demos. [There is](release/) example VHD to start with. \ +As alternative to VHD you can just unzip Wild Commander into root of your FAT32-formatted SD card. -By default, if everything is done right, Wild Commander will be loaded where you can choose the games to start. +By default, if everything is done right, Wild Commander will be loaded where you can choose software to start. -## VHD files -You can make several VHD files and put them into TSConf folder on primary SD card and then choose from OSD. -### Note -Although original CMOS setting page can be launched (CTRL+F11), the settings made there won't have effect. You need to use OSD for CMOS settings. +## Usage +Original TSConf F12 key (reset) is transferred to F11. \ +To enter BASIC press Shift+F11. \ +To enter TS-BIOS Setup Utility press Ctrl+F11. By default these setting are volatile and lost after MiST reset. To save them - open OSD menu (with F12 key) and tap "Save NVRAM settings". -Original TSConf F12 key (reset) is transferred to F11. + +## Software +- Wild Commander: https://forum.tslabs.info/viewtopic.php?f=26&t=143 +- ZiFi: http://zifi.vtrd.in/ +- Demos and games: https://prods.tslabs.info/ + + +## Credits +- TSConf official git repository - [link](https://github.com/tslabs/zx-evo/tree/master) +- TSConf official forum - [link](http://forum.tslabs.info/viewforum.php?f=20&sid=137db6b31f9fb533b908742c2b18284e) +- Original TSConf port for MiSTer (on base of which this port was created) - [link](https://github.com/MiSTer-devel/TSConf_MiSTer) +- T80 - Z80 HDL implementation +- JT12 - Yamaha OPN HDL implementation - [link](https://github.com/jotego/jt12)