MSX Turbo Changer v2.1 for CIEL/WX/FX/WSX/TR/OCM By Daniel Jorge Caetano (daniel@caetano.eng.br) HomePage: http://www.amusementfactory.com.br "MSX Turbo Changer" is a program developed by Amusement Factory. (c)1999-2018 Amusement Factory Software. þþþ 1.0 WARNING! THIS SOFTWARE IS FREEWARE AND IS DISTRIBUTED AS IS WITH ANY TYPE OF WARRATIES. USE IT AT YOUR OWN RISK! NEITHER FUDEBA SOFTWARE ANSWER FOR ANY TYPE OF DAMAGE MADE ON YOUR COMPUTER BY THIS SOFTWARE. We don't think that this program can damage your system. We are only warning you, because this is a early alpha code and is far from being ready to use. This program 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 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but, as said before, 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 this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. þþþ 2.0 What is MSX Turbo Changer? Formerly known as Fudeba Turbo Changer, this program was created to fulfill the need for a "turbo" utility that was able to switch turbo state on any MSX computer with a simple command. Actually it supports all known MSX computers with soft-operated turbo (see below for more info); I'll try to update this software as new machines are built. If this program does not work for your machine, please e-mail me at: daniel@caetano.eng.br so I can fix it. If possible, send me info about your hardware. I really hope this program meets your needs. þþþ 3.0 Original Files Files on the original ZIP (or PMA) archive are: TURBO.COM The executable of turbo for MSX-DOS. TURBO.HLP The Help file for MSX-DOS2 Help. TURBO.MAC The sjASMPlus Source code for Turbo. TURBOCORE.MAC The core turbo operations source. TURBO.TXT This text file. þþþ 4.0 System Requirements and Supported Systems These are the requirements: - Any MSX with turbo. - MSX-DOS. Actually, the supported systems are: - ASCII One Chip MSX - CIEL MSX 2.0 Turbo - CIEL MSX 2+ Turbo - Panasonic MSX Turbo R GT - Panasonic MSX Turbo R ST - Panasonic MSX FS A1 WSX - Panasonic MSX FS A1 WX - Panasonic MSX FS A1 FX - Zemmix Neo - Zemmix Neo BR þþþ 5.0 Features - Support CIEL, WSX, WX, FX, Turbo R and OCM turbos. - Support Turbo R R800 ROM and DRAM modes - Support OCM slow and fast VDP Blitter modes - Quiet Mode (fast!) - Reverse mode - Backward compatible with A&L Software Turbo.Com þþþ 6.0 Installation Just decompress the PMA file on any directory in the PATH and copy TURBO.HLP to your HELP directory, if you use MSX-DOS2. þþþ 7.0 Command Line Parameters The program usage is very simple. You just need to type at MSX-DOS prompt: TURBO [options] Where [options] may be: Q Quiet Mode (do not show messages) ON Turn Turbo On OF Turn Turbo Off S Display turbo Status R ROM mode for R800 (use together with ON) V VDP slow mode OCM turbo (use together with ON) (nothing) Reverse turbo Mode ? Show options help H show options help. Some examples: 1) You are on a Turbo R and want to change to R800 ROM mode, so you will use: TURBO R ON 2) Same as above, but you do not want messages: TURBO R ON Q 3) Now you want to change to R800 DRAM mode: TURBO ON 4) Same above, but without messages: TURBO ON Q 5) You do not know what is the state of the turbo, but wants to change it: TURBO 6) Same as above, but without the messages: TURBO Q 7) You do not know what is the state and want to change it, but if the actual state is Z80 mode, you want to change to R800 ROM mode, and not DRAM mode: TURBO R 8) Using a CIEL computer, you want to change turbo state, but you do not know whats the actual state: TURBO 9) Using a CIEL computer, you want to turn turbo on, without messages: TURBO ON Q 10) You want to turn turbo off on CIEL (or change to Z80 mode on turbo R): TURBO OF PS: The program seeks only for the required letters on the parameter, so, if you write TURBO OFFTOPIC QUIT, the program will read it as TURBO OF Q. Also, the R or V parameters on CIEL and WX computers are simply ignored. PS2: There is no order on typing the parameters, you can use TURBO ON Q or TURBO Q ON and everything will be OK. Also, the program is case insensive, so you can use TURBO Q or TURBO q without any problems. PS3: If you use this program on a computer without turbo (or with a unknown turbo type) it will answer you that it doesn't know the turbo type of your machine. When using on batchs, always use the Q option, so the program use will be transparent to the user. þþþ 8.0 Technical Info This program uses the BIOS entries from both Turbo R and CIEL computers to change the turbo state. You can look how the program do it reading the source code ( TURBO.MAC ) that is distributed together with the program and this file. For Panasonic WSX, WX and FX machines and OCM and Zemmix machines the direct access to turbo mode using I/O ports is used. TURBO.MAC is a simple ASM program (in the sjASMPlus format) fully commented that uses TURBOCORE.MAC modules to detect and change turbo mode. Basically it gets the command line parameters, and use TURBOCORE which, in turn, detect which MSX type you are using and then use the right turbo routine to perform the action described by the command line options. It's very simple. þþþ 9.0 How contact us? You can view more information on Amusement Factory Software page: http://www.amusementfactory.com.br There you will find the "Projects > MSX Programs" section. Every new public version of MSX Turbo Changer will be available there. If you just want to contact the authors, you can send e-mails for us. If you have some idea on improvements or bug reports, please send an e-mail to Daniel J. Caetano, at the address: daniel@caetano.eng.br þþþ 10.0 Special Thanks We wish to give special thanks to some people that really help on the work... Their names, in alphabetical order, are: - Ademir Carchano (ademir@carchano.com.br) By design and build my actual MSX computer not telling me WHERE in the BIOS was the CIEL turbo routine. - Adriano Camargo Rodrigues da Cunha (adrcunha@dcc.unicamp.br) By introduce me to MSX programming again create the "Fudeba" name beta-testing. adding support to Panasonic WSX, WX and FX computers. - Edison Antonio Pires de Moraes By writing the "MSX Top Secret" (and Top Secret II) book. - Fabio Belavenuto By providing information on OCM / Zemmix Neo turbo mode. - Fabio Ricardo Schmidlin By suggesting the support for OCM/Zemmix Neo. suggesting the use of sjASMPlus. - Giovanni dos Reis Nunes By beta-testing. - Leonard Oliveira (leonard.oliveira@apis.com.br) By beta-testing on Turbo R. - Luciano Sturaro (sturaro@dglnet.com.br) By discovering a glitch on version 0.9 that lock up MSXDOS1 suggested the ? and H options beta-testing. - Pablo Vasques Bravo-Villalba By providing information on OCM / Zemmix Neo turbo mode. - Ricardo Bittencourt Vidigal Leitao (ricardo@lsi.usp.br) By the VERY USEFULL BrMSX some pieces of GNU Public License from MUST. - Werner Kai (roderkai@televideonet.com.br) By beta-testing. þþþ 11.0 History Legend: - Removed + Added = Changed * Improved/Updated * May 16, 2018 - version 2.1 = Properly split MSX Turbo Changer in two parts. * May 14, 2018 - version 2.01 = Started to split source file in two parts, to make easier to import it as support code for other programs. * January 14, 2017 - version 2.0 * Rewrote entire application in a modular way. + Implemented STATUS command line option. = Updated help and text file * January 11, 2017 - version 2.0b, internal beta release + Support for OCM / Zemmix Neo machines. = New application name. = Updated help and text file * December 13, 2004 - version 1.1 + Added support for Panasonic WX, WSX and FX machines by Adriano Cunha = Updated help and text file * October 02, 1999 - version 1.0, first public release = Complete name changed (previous was only Turbo Changer) * Some improvements on the "interface"... q-: * Improved some routines so the program become smaller (1Kb now). + Added the HLP option + Added the Install section on this readme. * September 25, 1999 - version 0.92, internal beta release + Added ? and H options for HELP. * September 25, 1999 - version 0.91, internal beta release * Improved the BIOS call so it cannot harm MSXDOS1 systems. * September 25, 1999 - version 0.9, internal beta release + Initial Release.