             Fudeba Turbo Changer v1.1 for CIEL/WX/FX/WSX/TR
                        By Daniel Jorge Caetano
                         (daniel@caetano.eng.br)

                               HomePage:
                    http://www.caetano.eng.br/msxpage/


    "Fudeba Turbo Changer" is a program developed by Fudeba Software.
                      (c)1999-2004 Fudeba 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 Fudeba Turbo Changer?

	Fudeba Turbo Changer  comes from the  need of a Turbo Utility that
works on the same  way on any  MSX computer. With  it, you  can  change to 
turbo mode on any MSX machine without fear, and the turbo will be changed.
	Actualy it support all MSX computers with a turbo feature that can
be changed  by  software (see  below for  more info), and I'll  try to add
every new software turbo change function as I discover it. If your machine
has a  turbo and it  can be  changed by  software and  this program do not
change the turbo 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,
how change its turbo, etc.
	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 M80 Source code for Turbo.
	TURBO.TXT		This text file.



 4.0 System Requirements and Supported Systems

	These are the requirements:

	- Any MSX with turbo
	- MSX-DOS (sometime in the future I'll add a UZIX version...)

	Actually, the supported systems are:

	- 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


 5.0 Features

	- Support CIEL, WSX, WX, FX and Turbo R turbos
	- Support Turbo R R800 ROM and DRAM 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
	R		ROM mode for R800 (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  looks  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 parameter on CIEL computers is just 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  the
direct access to turbo mode using I/O ports is used.
	TURBO.MAC is a  simple ASM program (in the  M80/L80 format)  fully
comented (sorry, coments  in  portuguese only) and I think you'll find  no
problem on understanding it...
	Basically it gets  the command  line parameters, detect  which MSX
type are you  using, so it go to the right  turbo routine that acts on the
command line options. It's very simple.



 9.0 How contact us?

	You can view more  information on Fudeba Software HomePage, at the
Internet:

	http://www.caetano.eng.br/msxpage/

	There you will  find  the "Downloads" section. Enter  on it. Every
new public version of Fudeba Turbo Changer  will be available there. There
will be some mirror sites too.
	If you just want to contact the  authors, you can send e-mails for
us. If you have  some idea on the system  works, tips on  programming, bug
repots, etc, send an e-mail to Daniel J. Caetano, at the address:

	daniel@caetano.eng.br

	Please, send  your comments and  suggestions (and, of  course, bug
reports!)



 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
	     the 22nice version of M80/L80
	     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.
	- 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.
	- 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


 * 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.
