AppleWin/source/Card.h

#pragma once

enum SS_CARDTYPE
{
	CT_Empty = 0,
	CT_Disk2,			// Apple Disk][
	CT_SSC,				// Apple Super Serial Card
	CT_MockingboardC,	// Soundcard
	CT_GenericPrinter,
	CT_GenericHDD,		// Hard disk
	CT_GenericClock,
	CT_MouseInterface,
	CT_Z80,
	CT_Phasor,			// Soundcard
	CT_Echo,			// Soundcard
	CT_SAM,				// Soundcard: Software Automated Mouth
	CT_80Col,			// 80 column card (1K)
	CT_Extended80Col,	// Extended 80-col card (64K)
	CT_RamWorksIII,		// RamWorksIII (up to 8MB)
	CT_Uthernet,
	CT_LanguageCard,	// Apple][ or ][+ in slot-0
	CT_LanguageCardIIe,	// Apple//e LC instance (not a card)
	CT_Saturn128K,		// Saturn 128K (but may be populated with less RAM, in multiples of 16K)
	CT_FourPlay,		// 4 port Atari 2600 style digital joystick card
	CT_SNESMAX,			// 2 port Nintendo NES/SNES controller serial interface card
	CT_VidHD,
	CT_Uthernet2,
	CT_MegaAudio,		// Soundcard
	CT_SDMusic,			// Soundcard
};

enum SLOTS { SLOT0=0, SLOT1, SLOT2, SLOT3, SLOT4, SLOT5, SLOT6, SLOT7, NUM_SLOTS, SLOT_AUX, GAME_IO_CONNECTOR };

class YamlSaveHelper;
class YamlLoadHelper;

class Card
{
public:
	Card(SS_CARDTYPE type, UINT slot) : m_type(type), m_slot(slot) {}
	virtual ~Card(void) {}

	virtual void InitializeIO(LPBYTE pCxRomPeripheral) = 0;
	virtual void Destroy() = 0;
	virtual void Reset(const bool powerCycle) = 0;
	virtual void Update(const ULONG nExecutedCycles) = 0;
	virtual void SaveSnapshot(YamlSaveHelper& yamlSaveHelper) = 0;
	virtual bool LoadSnapshot(YamlLoadHelper& yamlLoadHelper, UINT version) = 0;

	SS_CARDTYPE QueryType(void) { return m_type; }

	std::string GetCardName(void);
	static std::string GetCardName(const SS_CARDTYPE cardType);
	static SS_CARDTYPE GetCardType(const std::string & card);

	// static versions for non-Card cards
	static void ThrowErrorInvalidSlot(SS_CARDTYPE type, UINT slot);
	static void ThrowErrorInvalidVersion(SS_CARDTYPE type, UINT version);

protected:
	UINT m_slot;

	void ThrowErrorInvalidSlot();
	void ThrowErrorInvalidVersion(UINT version);

private:
	SS_CARDTYPE m_type;
};

//

class EmptyCard : public Card
{
public:
	EmptyCard(UINT slot) : Card(CT_Empty, slot) {}
	virtual ~EmptyCard(void) {}

	virtual void InitializeIO(LPBYTE pCxRomPeripheral) {}
	virtual void Destroy() {}
	virtual void Reset(const bool powerCycle) {}
	virtual void Update(const ULONG nExecutedCycles) {}
	virtual void SaveSnapshot(YamlSaveHelper& yamlSaveHelper) {}
	virtual bool LoadSnapshot(YamlLoadHelper& yamlLoadHelper, UINT version) { _ASSERT(0); return false; }
};

//

class DummyCard : public Card	// For cards that currently can't be instantiated (ie. don't exist as a class)
{
public:
	DummyCard(SS_CARDTYPE type, UINT slot) : Card(type, slot) {}
	virtual ~DummyCard(void) {}

	virtual void InitializeIO(LPBYTE pCxRomPeripheral);
	virtual void Destroy() {}
	virtual void Reset(const bool powerCycle) {}
	virtual void Update(const ULONG nExecutedCycles);
	virtual void SaveSnapshot(YamlSaveHelper& yamlSaveHelper);
	virtual bool LoadSnapshot(YamlLoadHelper& yamlLoadHelper, UINT version);
};