// license:BSD-3-Clause // copyright-holders:Aaron Giles /*************************************************************************** devfind.c Device finding template helpers. ***************************************************************************/ #include "emu.h" #include "romload.h" //************************************************************************** // EXPLICIT TEMPLATE INSTANTIATIONS //************************************************************************** template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class object_finder_base; template class memory_region_finder; template class memory_region_finder; template class memory_bank_finder; template class memory_bank_finder; template class ioport_finder; template class ioport_finder; template class address_space_finder; template class address_space_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class region_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; template class shared_ptr_finder; //************************************************************************** // BASE FINDER CLASS //************************************************************************** constexpr char finder_base::DUMMY_TAG[]; //------------------------------------------------- // finder_base - constructor //------------------------------------------------- finder_base::finder_base(device_t &base, char const *tag) : m_next(base.register_auto_finder(*this)) , m_base(base) , m_tag(tag) , m_resolved(false) { } //------------------------------------------------- // ~finder_base - destructor //------------------------------------------------- finder_base::~finder_base() { } //------------------------------------------------- // set_tag - set tag //------------------------------------------------- void finder_base::set_tag(char const *tag) { assert(!m_resolved); m_base = m_base.get().mconfig().current_device(); m_tag = tag; } //------------------------------------------------- // find_memregion - find memory region //------------------------------------------------- void *finder_base::find_memregion(u8 width, size_t &length, bool required) const { // look up the region and return nullptr if not found memory_region *const region(m_base.get().memregion(m_tag)); if (!region) { length = 0; return nullptr; } // check the width and warn if not correct if (region->bytewidth() != width) { if (required) osd_printf_warning("Region '%s' found but is width %d, not %d as requested\n", m_tag, region->bitwidth(), width*8); length = 0; return nullptr; } // check the length and warn if other than specified size_t const length_found = region->bytes() / width; if (length != 0 && length != length_found) { if (required) osd_printf_warning("Region '%s' found but has %d bytes, not %ld as requested\n", m_tag, region->bytes(), long(length*width)); length = 0; return nullptr; } // return results length = length_found; return region->base(); } //------------------------------------------------- // validate_memregion - find memory region //------------------------------------------------- bool finder_base::validate_memregion(size_t bytes, bool required) const { // make sure we can resolve the full path to the region size_t bytes_found = 0; std::string const region_fulltag(m_base.get().subtag(m_tag)); // look for the region for (device_t const &dev : device_iterator(m_base.get().mconfig().root_device())) { for (romload::region const ®ion : romload::entries(dev.rom_region()).get_regions()) { if (dev.subtag(region.get_tag()) == region_fulltag) { bytes_found = region.get_length(); break; } } if (bytes_found != 0) break; } // check the length and warn if other than specified if ((bytes_found != 0) && (bytes != 0) && (bytes != bytes_found)) { osd_printf_warning("Region '%s' found but has %ld bytes, not %ld as requested\n", m_tag, long(bytes_found), long(bytes)); bytes_found = 0; } return report_missing(bytes_found != 0, "memory region", required); } //------------------------------------------------- // find_memshare - find memory share //------------------------------------------------- void *finder_base::find_memshare(u8 width, size_t &bytes, bool required) const { // look up the share and return nullptr if not found memory_share *const share(m_base.get().memshare(m_tag)); if (!share) return nullptr; // check the width and warn if not correct if (width != 0 && share->bitwidth() != width) { if (required) osd_printf_warning("Shared ptr '%s' found but is width %d, not %d as requested\n", m_tag, share->bitwidth(), width); return nullptr; } // return results bytes = share->bytes(); return share->ptr(); } //------------------------------------------------- // find_addrspace - find address space //------------------------------------------------- address_space *finder_base::find_addrspace(int spacenum, u8 width, bool required) const { // look up the device and return nullptr if not found device_t *const device(m_base.get().subdevice(m_tag)); if (device == nullptr) return nullptr; // check for memory interface and the specified space number const device_memory_interface *memory; if (!device->interface(memory)) { if (required) osd_printf_warning("Device '%s' found but lacks memory interface\n", m_tag); return nullptr; } if (!memory->has_space(spacenum)) { if (required) osd_printf_warning("Device '%s' found but lacks address space #%d\n", m_tag, spacenum); return nullptr; } // check data width address_space &space(memory->space(spacenum)); if (width != 0 && width != space.data_width()) { if (required) osd_printf_warning("Device '%s' found but address space #%d has the wrong data width (expected %d, found %d)\n", m_tag, spacenum, width, space.data_width()); return nullptr; } // return result return &space; } //------------------------------------------------- // validate_addrspace - find address space //------------------------------------------------- bool finder_base::validate_addrspace(int spacenum, u8 width, bool required) const { // look up the device and return false if not found device_t *const device(m_base.get().subdevice(m_tag)); if (device == nullptr) return report_missing(false, "address space", required); // check for memory interface and a configuration for the designated space const device_memory_interface *memory = nullptr; const address_space_config *config = nullptr; if (device->interface(memory)) { config = memory->space_config(spacenum); if (required) { if (config == nullptr) osd_printf_warning("Device '%s' found but lacks address space #%d\n", m_tag, spacenum); else if (width != 0 && width != config->data_width()) osd_printf_warning("Device '%s' found but space #%d has the wrong data width (expected %d, found %d)\n", m_tag, spacenum, width, config->data_width()); } } else if (required) osd_printf_warning("Device '%s' found but lacks memory interface\n", m_tag); // report result return report_missing(config != nullptr && (width == 0 || width == config->data_width()), "address space", required); } //------------------------------------------------- // report_missing - report missing objects and // return true if it's ok //------------------------------------------------- bool finder_base::report_missing(bool found, const char *objname, bool required) const { if (required && (DUMMY_TAG == m_tag)) { osd_printf_error("Tag not defined for required %s\n", objname); return false; } else if (found) { // just pass through in the found case return true; } else { // otherwise, report std::string const region_fulltag(m_base.get().subtag(m_tag)); if (required) osd_printf_error("Required %s '%s' not found\n", objname, region_fulltag.c_str()); else if (DUMMY_TAG != m_tag) osd_printf_verbose("Optional %s '%s' not found\n", objname, region_fulltag.c_str()); return !required; } } void finder_base::printf_warning(const char *format, ...) { va_list argptr; char buffer[1024]; // do the output va_start(argptr, format); vsnprintf(buffer, 1024, format, argptr); osd_printf_warning("%s", buffer); va_end(argptr); }