MSXMotherBoard.hh

Go to the documentation of this file.

#ifndef MSXMOTHERBOARD_HH
#define MSXMOTHERBOARD_HH

#include "EmuTime.hh"
#include "VideoSourceSetting.hh"
#include "hash_map.hh"
#include "serialize_meta.hh"
#include "xxhash.hh"
#include "openmsx.hh"
#include "RecordedCommand.hh"
#include <cassert>
#include <memory>
#include <string_view>
#include <vector>

namespace openmsx {

class AddRemoveUpdate;
class BooleanSetting;
class CartridgeSlotManager;
class CassettePortInterface;
class CliComm;
class CommandController;
class Debugger;
class DeviceInfo;
class EventDelay;
class ExtCmd;
class FastForwardHelper;
class HardwareConfig;
class InfoCommand;
class JoyPortDebuggable;
class JoystickPortIf;
class LedStatus;
class ListExtCmd;
class LoadMachineCmd;
class MachineNameInfo;
class MachineTypeInfo;
class MSXCliComm;
class MSXCommandController;
class MSXCPU;
class MSXCPUInterface;
class MSXDevice;
class MSXDeviceSwitch;
class MSXEventDistributor;
class MSXMapperIO;
class MSXMixer;
class PanasonicMemory;
class PluggingController;
class Reactor;
class RealTime;
class RemoveExtCmd;
class RenShaTurbo;
class ResetCmd;
class ReverseManager;
class SettingObserver;
class Scheduler;
class StateChangeDistributor;

class MSXMotherBoard final
{
public:
        MSXMotherBoard(const MSXMotherBoard&) = delete;
        MSXMotherBoard& operator=(const MSXMotherBoard&) = delete;

        explicit MSXMotherBoard(Reactor& reactor);
        ~MSXMotherBoard();

        std::string_view getMachineID()   const { return machineID; }
        std::string_view getMachineName() const { return machineName; }

        bool execute();

        void fastForward(EmuTime::param time, bool fast);

        void exitCPULoopAsync();
        void exitCPULoopSync();

        void pause();
        void unpause();

        void powerUp();

        void doReset();
        void activate(bool active);
        bool isActive() const { return active; }
        bool isFastForwarding() const { return fastForwarding; }

        byte readIRQVector();

        const HardwareConfig* getMachineConfig() const { return machineConfig; }
        void setMachineConfig(HardwareConfig* machineConfig);
        std::string getMachineType() const;
        bool isTurboR() const;

        std::string loadMachine(const std::string& machine);

        using Extensions = std::vector<std::unique_ptr<HardwareConfig>>;
        const Extensions& getExtensions() const { return extensions; }
        HardwareConfig* findExtension(std::string_view extensionName);
        std::string loadExtension(std::string_view extensionName, std::string slotname);
        std::string insertExtension(std::string_view name,
                                    std::unique_ptr<HardwareConfig> extension);
        void removeExtension(const HardwareConfig& extension);

        // The following classes are unique per MSX machine
        CliComm& getMSXCliComm();
        MSXCommandController& getMSXCommandController() { return *msxCommandController; }
        Scheduler& getScheduler() { return *scheduler; }
        MSXEventDistributor& getMSXEventDistributor() { return *msxEventDistributor; }
        StateChangeDistributor& getStateChangeDistributor() { return *stateChangeDistributor; }
        CartridgeSlotManager& getSlotManager() { return *slotManager; }
        RealTime& getRealTime() { return *realTime; }
        Debugger& getDebugger() { return *debugger; }
        MSXMixer& getMSXMixer() { return *msxMixer; }
        PluggingController& getPluggingController();
        MSXCPU& getCPU();
        MSXCPUInterface& getCPUInterface();
        PanasonicMemory& getPanasonicMemory();
        MSXDeviceSwitch& getDeviceSwitch();
        CassettePortInterface& getCassettePort();
        JoystickPortIf& getJoystickPort(unsigned port);
        RenShaTurbo& getRenShaTurbo();
        LedStatus& getLedStatus();
        ReverseManager& getReverseManager() { return *reverseManager; }
        Reactor& getReactor() { return reactor; }
        VideoSourceSetting& getVideoSource() { return videoSourceSetting; }

        // convenience methods
        CommandController& getCommandController();
        InfoCommand& getMachineInfoCommand();

        EmuTime::param getCurrentTime();

        void addDevice(MSXDevice& device);
        void removeDevice(MSXDevice& device);

        MSXDevice* findDevice(std::string_view name);

        template<typename T, typename ... Args>
        std::shared_ptr<T> getSharedStuff(std::string_view name, Args&& ...args)
        {
                auto& weak = sharedStuffMap[name];
                auto shared = std::static_pointer_cast<T>(weak.lock());
                if (shared) return shared;

                shared = std::make_shared<T>(std::forward<Args>(args)...);
                weak = shared;
                return shared;
        }

        MSXMapperIO& createMapperIO();
        MSXMapperIO& getMapperIO() const
        {
                assert(mapperIOCounter);
                return *mapperIO;
        }
        void destroyMapperIO();

        std::string getUserName(const std::string& hwName);
        void freeUserName(const std::string& hwName, const std::string& userName);

        template<typename Archive>
        void serialize(Archive& ar, unsigned version);

private:
        void powerDown();
        void deleteMachine();

        Reactor& reactor;
        std::string machineID;
        std::string machineName;

        std::vector<MSXDevice*> availableDevices; // no ownership, no order

        hash_map<std::string_view, std::weak_ptr<void>,      XXHasher> sharedStuffMap;
        hash_map<std::string, std::vector<std::string>, XXHasher> userNames;

        std::unique_ptr<MSXMapperIO> mapperIO;
        unsigned mapperIOCounter;

        // These two should normally be the same, only during savestate loading
        // machineConfig will already be filled in, but machineConfig2 not yet.
        // This is important when an exception happens during loading of
        // machineConfig2 (otherwise machineConfig2 gets deleted twice).
        // See also HardwareConfig::serialize() and setMachineConfig()
        std::unique_ptr<HardwareConfig> machineConfig2;
        HardwareConfig* machineConfig;

        Extensions extensions; // order matters: later extension might depend on earlier ones

        // order of unique_ptr's is important!
        std::unique_ptr<AddRemoveUpdate> addRemoveUpdate;
        std::unique_ptr<MSXCliComm> msxCliComm;
        std::unique_ptr<MSXEventDistributor> msxEventDistributor;
        std::unique_ptr<StateChangeDistributor> stateChangeDistributor;
        std::unique_ptr<MSXCommandController> msxCommandController;
        std::unique_ptr<Scheduler> scheduler;
        std::unique_ptr<EventDelay> eventDelay;
        std::unique_ptr<RealTime> realTime;
        std::unique_ptr<Debugger> debugger;
        std::unique_ptr<MSXMixer> msxMixer;
        std::unique_ptr<PluggingController> pluggingController;
        std::unique_ptr<MSXCPU> msxCpu;
        std::unique_ptr<MSXCPUInterface> msxCpuInterface;
        std::unique_ptr<PanasonicMemory> panasonicMemory;
        std::unique_ptr<MSXDeviceSwitch> deviceSwitch;
        std::unique_ptr<CassettePortInterface> cassettePort;
        std::unique_ptr<JoystickPortIf> joystickPort[2];
        std::unique_ptr<JoyPortDebuggable> joyPortDebuggable;
        std::unique_ptr<RenShaTurbo> renShaTurbo;
        std::unique_ptr<LedStatus> ledStatus;
        VideoSourceSetting videoSourceSetting;

        std::unique_ptr<CartridgeSlotManager> slotManager;
        std::unique_ptr<ReverseManager> reverseManager;
        std::unique_ptr<ResetCmd>     resetCommand;
        std::unique_ptr<LoadMachineCmd> loadMachineCommand;
        std::unique_ptr<ListExtCmd>   listExtCommand;
        std::unique_ptr<ExtCmd>       extCommand;
        std::unique_ptr<RemoveExtCmd> removeExtCommand;
        std::unique_ptr<MachineNameInfo> machineNameInfo;
        std::unique_ptr<MachineTypeInfo> machineTypeInfo;
        std::unique_ptr<DeviceInfo>   deviceInfo;
        friend class DeviceInfo;

        std::unique_ptr<FastForwardHelper> fastForwardHelper;

        std::unique_ptr<SettingObserver> settingObserver;
        friend class SettingObserver;
        BooleanSetting& powerSetting;

        bool powered;
        bool active;
        bool fastForwarding;
};
SERIALIZE_CLASS_VERSION(MSXMotherBoard, 4);

class ExtCmd final : public RecordedCommand
{
public:
        ExtCmd(MSXMotherBoard& motherBoard, std::string commandName);
        void execute(span<const TclObject> tokens, TclObject& result,
                     EmuTime::param time) override;
        std::string help(const std::vector<std::string>& tokens) const override;
        void tabCompletion(std::vector<std::string>& tokens) const override;
private:
        MSXMotherBoard& motherBoard;
        std::string commandName;
};

} // namespace openmsx

#endif