CoCo3_MiSTer/changes.txt

1.	Added support for cassette save.  To use: A) You have to have a file [anyname.cas]
	which is larger than needed.  B) Select the file through the UI Menu 'Save 
	Cassette'.  C)Set 'Cass Rwd=0 / Rec=1' to 1. D) Issue your 'CSAVE "NAME"'
	E) When done, set 'Cass Rwd=0 / Rec=1' to 0 to complete the write.  The file can 
	now be loaded or copied.  Note a dummy file of a specific size can be created in
	the MiSTer SSH shell in the /media/fat/games/coco3 with the command:
	'truncate -s 65536 tapefileame.cas'. [Note do NOT use over 65536 file length]
2.	Fixed serial interrupt [6551] to not be functional on slot 3 [carts].
3.	Modification of sys_top.v to override use of USER_IO for HDMI - so it can be used
	for logic analyzer debug.  This will only occur when `define	Config_Debug is 
	enabled in config.v.
4.	Fixed MUGS of powerup issue occurring on some MiSTer units.
5.	Fixed incorrect application of GIME_IRQ on legacy interrupts.  Fixed race condition
	on reading IRQ status vs clearing the interrupt.
6.	Improved Castle of Tharoggad.  App now loads but locks as the graphics animate.  This
	change improved mmu usage through to CARTS.
7.	Builds now keep track of multiple builds in the same date.  It shows as V240512-001 in
	the menus.  Its also exposed to BASIC and a boot.vhd which can be enabled to autorun is
	supplied in the archive to show how it works.
8.	Additionally, on the boot.vhd disk, is a program which demonstrated how to load a font -
	IBMFONT.BAS. Run it and it maps a font much like the IBM font to the 80 column format.
	Also, a file called TESTRTC.BAS pulls the MiSTer RTC values exposed in BASIC to display
	a clock.
9.	Large improvement in the Timer function.  Code closer emulates COCO3 Timer. Fixes
	Sliphead cart.
10.	In the 20231023 release the wd1773 instances were reduced to 1 for the FDC and one for
	the FDC.  This saved space but introduced a bug when using multiple drives at the same
	time - like a copy command.  This change was removed and the copy command works again.

To Do...
1.	Add Speech / Music cart
2.	Fix Castle of Tharoggad 




1.  Changed PIA 2 addressing to align with real CoCo3 hardware and end at FF2F.
2.  Re-arranged MiSTer drive LUNs to support future auto-boot from SDC drive 0.
3.  Added 'Auto Run' feature. You must use slot 2 [SDC]. Take your floppy or HD
    and copy it to a file name of 'boot.vhd'. This will be auto mounted to drive 0
    on the SDC. In the menu, find a new item Auto Run:. It can be set to No, DOS or
    AUTO.BAS. Choosing dos causes the 'DOS' command to be executed on power up. Setting
    the option to 'AUTO.BAS' will cause a 'RUN"AUTO' command to be executed upon powerup.
    Save your settings to cause the changes to be remembered. The Auto Run system re-arms
    upon using the 'Cold Boot' menu item.
4.	Fixed MiSTer / CoCo3 interface preventing the joysticks ever reaching the
	max value of 63. Specifically '>' was changed to '>=' the DTOA values.
	This fixes DonPan and is verified in Diagnostics 2.0.
5.	HiRES[3] is used to enable some of the higher resolution graphics modes
	Gary Becker designed into CoCo3FPGA, and while these are not fully 
	supported, the control signals such as HiRES[3] at $FF98 bit 6 affectt
	the graphics engine.  For some reason Color File II manipulates this bit
	and was causing it not to work.  This change requires the SG6 extensions
	to be enabled to set HiRES[3].  So specifically in the Video Settings 
	insure CoCo3 LC is set to Yes.  Color File II now works properly.

To Do...
1.	Add support for cassette save.
2.	Add Speech / Music cart
3.	Fix Castle of Tharoggod 

FYI - If you plan on playing with the build process - there is a new compile time feature
in config.v called CoCo3_Select_GIMEX_RAST.  It is inactive and I suggest you leave
it as its is a upcoming change which is not ready.


1.	Changed PIA 2 addressing to align with real CoCo3 hardware and end at FF2F.
2.	Removal of 16 bit sound extentions as they overlap speach / sound cart.  This is
	accompanied by a rework of the sound mixing to be more correct.
3.	Re-arranged MiSTer drive LUNs to support future auto-boot from SDC drive 0
4.	Added 'Auto Run' feature.  You must use slot 2 [SDC].  Take your floopy or HD
	and copy it to a file name of 'boot.vhd'.  This will be auto mounted to drive 0
	on the SDC.  In the menu, find a new item Auto Run:.  It can be set to No, DOS or
	AUTO.BAS.  Choosing dos causes the 'DOS' command to be executed on power up.  Setting
	the option to 'AUTO.BAS' will cause a 'RUN"AUTO' command to be executed upon powerup.
	Save your settings to cause the changes to be remembered.  The Auto Run system re-arms
	upon using the 'Cold Boot' menu item.


To Do...
1.	Add Speech / Music cart
2.	Fix Color File II
3.	Fic Castle of Tharoggad 



1.	For cycle accurate 6809, changed PH2 to cpu_cycle_ena. (Improve timing of control register writes)
2.	Changed PIA(s) addressing to allow complete mirror through FF00-FF3F 
3.	Corrected usage of SG6 enable (SW5 in orig code) which allows the usage of SG6.  Formerly it was used to 
    enable artifacts.  That is no longer true.  For most compatibility it has be relabeled 'CoCo3 LC',
	and it default setting is Yes which is fully compatible with the CoCo3. [setting no allows SG6 mode].
	For some OS9 software this must be set to 'Yes' which is the default.
4.	Added 'Artifact Type' menu in 'Video Settings' menu.  Settings are 'MESS', 'Simple', and 'NONE'.  'MESS'
	is the default and has improved fidelity over 'Simple' which was previously implemented in connection 
	with SW5 [see above].  Again, the default should be used.  The artifact emulation can be turned off
	by setting the option to 'NONE'.  The 'Artifact Color Set' choice is only valid for 'MESS' and 'Simple'
	artifact settings.



To Do...
1.	Change PIA 2 addressing to align with real CoCo3 hardware and end at FF2F.
2.	Fix Color File II
3.	Fic Castle of Tharoggad 



CTF = Compile Time Feature...

1.	Interrupt system restored to previous code - improved compadibility.
2.	Changed to cycle accurate 6809 (Greg Miller) at speeds up to 9.56Mhz. [CTF]
3.	Recoded sdc and fdc to only have one instance of the wd1773.
4.	Re-added software disable in sdc [Ext 'g'].
5.	Recoded Cartridge bank switching to only exist when MiSTer slot 3 is selected. [removed soft multipak select]
6.	Moved CoCo Hardware RS-232 from always existing to only existing in multipak slot 1.
7.	Changed ADRS (SDS sig) decoding to = FF40-FF5f per hardware.
8.	Fixed coding problem in os9 driver llcocosdc to work with MPI properly. [CTF]
9.	Set default disk size to constant $555555 to fix os9 redirect problem. [CTF]
10	Disabled GART [GIMEX hardware DMA] to prevent OS9 from detecting GIMEX. [CTF]
11	Corrected missing begin statement in master timing loop.
12.	Fixed Donkey King DAPD issue in Tom Mix program [DPAD now moved joysticks to limits under dpad
13. Fixed incorrect addressing of FE00-FEFF for CARTs which gets PITFALL and RAMPAGE working
14.	Updated MiSTer framework