mame/src/emu/emumem_heu.h
Olivier Galibert 639c9b85fc memory: Allow simplified versions of handlers [O. Galibert]
A standard memory handler has as a prototype (where uX = u8, u16, u32 or u64):
  uX device::read(address_space &space, offs_t offset, uX mem_mask);
  void device::write(address_space &space, offs_t offset, uX data, uX mem_mask);

We now allow simplified versions which are:
  uX device::read(offs_t offset, uX mem_mask);
  void device::write(offs_t offset, uX data, uX mem_mask);

  uX device::read(offs_t offset);
  void device::write(offs_t offset, uX data);

  uX device::read();
  void device::write(uX data);

Use them at will.  Also consider
(DECLARE_)(READ|WRITE)(8|16|32|64)_MEMBER on the way out, use the
explicit prototypes.

Same for lambdas in the memory map, the parameters are now optional
following the same combinations.
2018-08-02 21:08:47 +02:00

89 lines
3.9 KiB
C++

// license:BSD-3-Clause
// copyright-holders:Olivier Galibert
// handler_entry_read_units/handler_entry_write_units
// merges/splits an access among multiple handlers (unitmask support)
template<int Width, int AddrShift, int Endian> class handler_entry_read_units : public handler_entry_read<Width, AddrShift, Endian>
{
public:
using uX = typename emu::detail::handler_entry_size<Width>::uX;
using inh = handler_entry_read<Width, AddrShift, Endian>;
handler_entry_read_units(const memory_units_descriptor<Width, AddrShift, Endian> &descriptor, u8 ukey, address_space *space);
handler_entry_read_units(const memory_units_descriptor<Width, AddrShift, Endian> &descriptor, u8 ukey, const handler_entry_read_units *src);
~handler_entry_read_units();
uX read(offs_t offset, uX mem_mask) override;
std::string name() const override;
void enumerate_references(handler_entry::reflist &refs) const override;
private:
static constexpr u32 SUBUNIT_COUNT = 1 << Width;
struct subunit_info
{
handler_entry *m_handler; // the handler itself, the root to hide the templatization
uX m_amask; // access mask (for filtering access)
uX m_dmask; // data mask (for removal on collisions)
s8 m_ashift; // shift to apply to the address (positive = right)
u8 m_offset; // offset to add to the address post shift
u8 m_dshift; // data shift of the subunit
u8 m_width; // access width (0..3)
u8 m_endian; // endianness
};
subunit_info m_subunit_infos[SUBUNIT_COUNT]; // subunit information
uX m_unmap; // "unmapped" value to add to reads
u8 m_subunits; // number of subunits
void fill(const memory_units_descriptor<Width, AddrShift, Endian> &descriptor, const std::vector<typename memory_units_descriptor<Width, AddrShift, Endian>::entry> &entries);
static std::string m2r(uX mask);
};
template<int Width, int AddrShift, int Endian> class handler_entry_write_units : public handler_entry_write<Width, AddrShift, Endian>
{
public:
using uX = typename emu::detail::handler_entry_size<Width>::uX;
using inh = handler_entry_write<Width, AddrShift, Endian>;
handler_entry_write_units(const memory_units_descriptor<Width, AddrShift, Endian> &descriptor, u8 ukey, address_space *space);
handler_entry_write_units(const memory_units_descriptor<Width, AddrShift, Endian> &descriptor, u8 ukey, const handler_entry_write_units<Width, AddrShift, Endian> *src);
~handler_entry_write_units();
void write(offs_t offset, uX data, uX mem_mask) override;
std::string name() const override;
void enumerate_references(handler_entry::reflist &refs) const override;
private:
static constexpr u32 SUBUNIT_COUNT = 1 << Width;
struct subunit_info
{
handler_entry *m_handler; // the handler itself, the root to hide the templatization
uX m_amask; // access mask (for filtering access)
uX m_dmask; // data mask (for removal on collisions)
s8 m_ashift; // shift to apply to the address (positive = right)
u8 m_offset; // offset to add to the address post shift
u8 m_dshift; // data shift of the subunit
u8 m_width; // access width (0..3)
u8 m_endian; // endianness
};
subunit_info m_subunit_infos[SUBUNIT_COUNT]; // subunit information
u8 m_subunits; // number of subunits
void fill(const memory_units_descriptor<Width, AddrShift, Endian> &descriptor, const std::vector<typename memory_units_descriptor<Width, AddrShift, Endian>::entry> &entries);
static std::string m2r(uX mask);
};