cc65/include/accelerator.h

/*****************************************************************************/
/*                                                                           */
/*                               accelerator.h                               */
/*                                                                           */
/*                      Accelerator specific definitions                     */
/*                                                                           */
/*                                                                           */
/*                                                                           */
/* (C) 2018 Marco van den Heuvel                                             */
/* EMail:        blackystardust68@yahoo.com                                  */
/*                                                                           */
/*                                                                           */
/* This software is provided 'as-is', without any expressed or implied       */
/* warranty.  In no event will the authors be held liable for any damages    */
/* arising from the use of this software.                                    */
/*                                                                           */
/* Permission is granted to anyone to use this software for any purpose,     */
/* including commercial applications, and to alter it and redistribute it    */
/* freely, subject to the following restrictions:                            */
/*                                                                           */
/* 1. The origin of this software must not be misrepresented; you must not   */
/*    claim that you wrote the original software. If you use this software   */
/*    in a product, an acknowledgment in the product documentation would be  */
/*    appreciated but is not required.                                       */
/* 2. Altered source versions must be plainly marked as such, and must not   */
/*    be misrepresented as being the original software.                      */
/* 3. This notice may not be removed or altered from any source              */
/*    distribution.                                                          */
/*                                                                           */
/*****************************************************************************/



#ifndef _ACCELERATOR_H
#define _ACCELERATOR_H

/*****************/
/* Speed defines */
/*****************/

#define SPEED_SLOW   0x00
#define SPEED_FAST   0xFF

#define SPEED_1X   SPEED_SLOW
#define SPEED_2X    2 - 1        /* C64 Chameleon, C64DTV, C128, PET 65816, Apple2 Fast Chip, Apple2 TransWarp, Apple2 Zip Chip */
#define SPEED_3X    3 - 1        /* C64 Chameleon, C65, PET 65816, Apple2 Booster, Apple 2 Fast Chip, Apple2 Titan, Apple2 TransWarp, Apple2 Zip Chip */
#define SPEED_4X    4 - 1        /* C64 Chameleon, C64 TurboMaster, C64 TurboProcess, PET 65816, Apple2 Fast Chip, Apple2 Zip Chip */
#define SPEED_5X    5 - 1        /* C64 Chameleon, PET 65816, Apple2 Fast Chip */
#define SPEED_6X    6 - 1        /* C64 Chameleon, PET 65816, Apple2 Fast Chip */
#define SPEED_7X    7 - 1        /* PET 65816, Apple2 Fast Chip */
#define SPEED_8X    8 - 1        /* C64 Flash8, PET 65816, Apple 2 Fast Chip */
#define SPEED_10X  10 - 1        /* PET 65816, Apple2 Fast Chip */
#define SPEED_12X  12 - 1        /* Apple2 Fast Chip */
#define SPEED_16X  16 - 1        /* Apple2 Fast Chip */
#define SPEED_20X  20 - 1        /* C64/C128 SuperCPU */

/***********************************/
/* Accelerator function prototypes */
/***********************************/

/* C64/C128 SuperCPU cartridge */

unsigned char __fastcall__ set_scpu_speed (unsigned char speed);

/* Set the speed of the SuperCPU cartridge, using SPEED_SLOW will switch to
 * 1 Mhz mode, SPEED_20X or SPEED_FAST will switch to 20 Mhz mode.
 *
 * Note that any value lower than SPEED_20X will switch to 1 Mhz mode, and
 * any value higher or equal to SPEED_20X will switch to 20 Mhz mode.
 *
 * This function will return the actual speed the CPU is at after trying
 * to set the requested speed, if this is not the speed that was requested
 * then possibly the hardware speed switch prevented any software speed
 * switching.
 *
 * This function does not check for the presence of the SuperCPU cartridge,
 * make sure you use 'detect_scpu();' before using.
 */

unsigned char get_scpu_speed (void);

/* Get the speed of the SuperCPU cartridge.
 *
 * Possible return values:
 * SPEED_1X    :  1 Mhz mode
 * SPEED_20X   : 20 Mhz mode
 *
 * This function does not check for the presence of the SuperCPU cartridge,
 * make sure you use 'detect_scpu();' before using.
 */

unsigned char detect_scpu (void);

/* Check for the presence of the SuperCPU cartridge.
 *
 * Possible return values:
 * 0x00  : SuperCPU cartridge not present
 * 0x01  : SuperCPU cartridge present
 */


/* C64DTV */

unsigned char __fastcall__ set_c64dtv_speed (unsigned char speed);

/* Set the speed of the C64DTV, using SPEED_SLOW will switch to
 * slow mode, SPEED_2X or SPEED_FAST will switch to fast mode.
 *
 * Note that any value higher or equal to SPEED_2X will switch to fast mode.
 *
 * This function will return the actual speed the CPU is at after trying
 * to set the requested speed, to my knowledge the switch should not fail.
 *
 * This function does not check for the presence of the C64DTV,
 * make sure you use 'detect_c64dtv();' before using.
 */

unsigned char get_c64dtv_speed (void);

/* Get the speed of the C64DTV.
 *
 * Possible return values:
 * SPEED_1X    : slow mode
 * SPEED_2X    : fast mode
 *
 * This function does not check for the presence of the C64DTV,
 * make sure you use 'detect_c64dtv();' before using.
 */

unsigned char detect_c64dtv (void);

/* Check for the presence of the C64DTV.
 *
 * Possible return values:
 * 0x00  : C64DTV not present
 * 0x01  : C64DTV present
 */


/* C128 8502 CPU */

unsigned char __fastcall__ set_c128_speed (unsigned char speed);

/* Set the speed of the C128 8502 CPU, using SPEED_SLOW will switch to
 * 1 Mhz (slow) mode, SPEED_2X or SPEED_FAST will switch to 2Mhz (fast) mode.
 *
 * Note that any value higher or equal to SPEED_2X will switch to fast mode.
 *
 * This function will return the actual speed the CPU is at after trying
 * to set the requested speed, to my knowledge the switching should not fail.
 *
 * This function does not check if the C128 CPU is the current CPU, make sure
 * you use 'detect_c128();' before using.
 */

unsigned char get_c128_speed (void);

/* Get the speed of the C128 8502 CPU.
 *
 * Possible return values:
 * SPEED_SLOW  : Slow mode
 * SPEED_2X    : Fast mode
 *
 * This function does not check if the C128 CPU is the current CPU, make sure
 * you use 'detect_c128();' before using.
 */

unsigned char detect_c128 (void);

/* Check if the C128 CPU is the current CPU.
 *
 * Possible return values:
 * 0x00  : C128 CPU is not the current CPU
 * 0x01  : C128 CPU is the current CPU
 */


/* C64 Chameleon cartridge */

unsigned char __fastcall__ set_chameleon_speed (unsigned char speed);

/* Set the speed of the C64 Chameleon cartridge, the following inputs
 * are accepted: 
 * SPEED_SLOW : 1 Mhz mode
 * SPEED_1X   : 1 Mhz mode
 * SPEED_2X   : 2 Mhz mode
 * SPEED_3X   : 3 Mhz mode
 * SPEED_4X   : 4 Mhz mode
 * SPEED_5X   : 5 Mhz mode
 * SPEED_6X   : 6 Mhz mode
 * SPEED_FAST : Maximum speed mode
 *
 * Note that any value higher or equal to SPEED_7X will switch to maximum
 * speed mode.
 *
 * This function will return the actual speed the CPU is at after trying
 * to set the requested speed, to my knowledge the switching should not fail.
 *
 * This function does not check for the presence of the C64 Chameleon cartridge,
 * make sure you use 'detect_chameleon();' before using.
 */

unsigned char get_chameleon_speed (void);

;/* Get the speed of the C64 Chameleon cartridge.
; *
; * Possible return values:
; * SPEED_SLOW  : Slow mode
; * SPEED_2X    : 2Mhz mode
; * SPEED_3X    : 3Mhz mode
; * SPEED_4X    : 4Mhz mode
; * SPEED_5X    : 5Mhz mode
; * SPEED_6X    : 6Mhz mode
; * SPEED_FAST  : Maximum speed mode
; *
; * This function does not check for the presence of the C64 Chameleon cartridge,
; * make sure you use 'detect_chameleon();' before using.
; */

unsigned char detect_chameleon (void);

/* Check for the presence of the C64 Chameleon cartridge.
 *
 * Possible return values:
 * 0x00  : C64 Chameleon cartridge not present
 * 0x01  : C64 Chameleon cartridge present
 */


/* C65/C64DX in C64 mode */

unsigned char __fastcall__ set_c65_speed (unsigned char speed);

/* Set the speed of the C65/C64DX CPU, using SPEED_SLOW will switch to
 * 1 Mhz mode, SPEED_3X or SPEED_FAST will switch to 3.5 Mhz (fast) mode.
 *
 * Note that any value higher or equal to SPEED_3X will switch to fast mode.
 *
 * This function will return the actual speed the CPU is at after trying
 * to set the requested speed, to my knowledge the switching should not fail.
 *
 * This function does not check for the presence of a C65/C64DX in C64 mode,
 * make sure you use 'detect_c65();' before using.
 */

unsigned char get_c65_speed (void);

/* Get the speed of the C65/C64DX CPU.
 *
 * Possible return values:
 * SPEED_SLOW  : Slow mode
 * SPEED_3X    : Fast mode
 *
 * This function does not check for the presence of a C65/C64DX in C64 mode,
 * make sure you use 'detect_c65();' before using.
 */

unsigned char detect_c65 (void);

/* Check for the presence of a C65/C64DX in C64 mode.
 *
 * Possible return values:
 * 0x00  : C65/C64DX in C64 mode not present
 * 0x01  : C65/C64DX in C64 mode present
 */


/* C64 Turbo Master cartridge */

unsigned char __fastcall__ set_turbomaster_speed (unsigned char speed);

/* Set the speed of the Turbo Master cartridge, using SPEED_SLOW will switch to
 * 1 Mhz mode, SPEED_4X or SPEED_FAST will switch to 4 Mhz mode.
 *
 * Note that any value higher or equal to SPEED_4X will switch to 4 Mhz mode,
 * any value lower than SPEED_4X will switch to 1 Mhz mode.
 *
 * This function will return the actual speed the CPU is at after trying
 * to set the requested speed, if the speed is different it might indicate
 * that the hardware switch has locked the speed.
 *
 * This function does not check for the presence of a Turbo Master cartridge,
 * make sure you use 'detect_turbomaster();' before using.
 */

unsigned char get_turbomaster_speed (void);

/* Get the speed of the Turbo Master cartridge.
 *
 * Possible return values:
 * SPEED_SLOW  : 1 Mhz mode
 * SPEED_4X    : 4 Mhz mode
 *
 * This function does not check for the presence of a Turbo Master cartridge,
 * make sure you use 'detect_turbomaster();' before using.
 */

unsigned char detect_turbomaster (void);

/* Check for the presence of a C64 Turbo Master cartridge.
 *
 * Possible return values:
 * 0x00  : C64 Turbo Master cartridge not present
 * 0x01  : C64 Turbo Master cartridge present
 */

/* End of accelerator.h */
#endif