2  * Bus driver for MIPS Common Device Memory Map (CDMM).
19 #include <asm/cdmm.h>
120 	.name		= "cdmm",
130  * All the CDMM driver callbacks need to be executed on the appropriate CPU from
139  * @fn:		CDMM driver callback function to call for the device.
140  * @dev:	CDMM device to pass to @fn.
148  * mips_cdmm_void_work() - Call a void returning CDMM driver callback.
151  * A work_on_cpu() callback function to call an arbitrary CDMM driver callback
164  * mips_cdmm_int_work() - Call an int returning CDMM driver callback.
167  * A work_on_cpu() callback function to call an arbitrary CDMM driver callback
182  * BUILD_PERCPU_HELPER() - Helper to call a CDMM driver callback on right CPU.
184  * @_name:	Name of CDMM driver callback function.
186  * Generates a specific device callback function to call a CDMM driver callback
213  * mips_cdmm_driver_register() - Register a CDMM driver.  in BUILD_PERCPU_HELPER()
214  * @drv:	CDMM driver information.  in BUILD_PERCPU_HELPER()
216  * Register a CDMM driver with the CDMM subsystem. The driver will be informed  in BUILD_PERCPU_HELPER()
237  * mips_cdmm_driver_unregister() - Unregister a CDMM driver.
238  * @drv:	CDMM driver information.
240  * Unregister a CDMM driver from the CDMM subsystem.
249 /* CDMM initialisation and bus discovery */
252  * struct mips_cdmm_bus - Info about CDMM bus.
258  * @offline:		Whether the CDMM bus is going offline (or very early
276  * mips_cdmm_get_bus() - Get the per-CPU CDMM bus information.
278  * Get information about the per-CPU CDMM bus, if the bus is present.
283  * Returns:	Pointer to CDMM bus information for the current CPU.
318  * mips_cdmm_cur_base() - Find current physical base address of CDMM region.
320  * Returns:	Physical base address of CDMM region according to cdmmbase CP0
321  *		register, or 0 if the CDMM region is disabled.
335  * mips_cdmm_phys_base() - Choose a physical base address for CDMM region.
337  * Picking a suitable physical address at which to map the CDMM region is
347  * mips_cdmm_setup() - Ensure the CDMM bus is initialised and usable.
367 		/* If CDMM region is still set up, nothing to do */  in mips_cdmm_setup()
371 		 * The CDMM region isn't set up as expected, so it needs  in mips_cdmm_setup()
379 	/* If the CDMM region is already configured, inherit that setup */  in mips_cdmm_setup()
393 		 * CDMM on the boot CPU, or else you need to implement  in mips_cdmm_setup()
394 		 * mips_cdmm_phys_base() for your platform (see asm/cdmm.h).  in mips_cdmm_setup()
396 		pr_err("cdmm%u: Failed to choose a physical base\n",  in mips_cdmm_setup()
407 	pr_debug("cdmm%u: Enabling CDMM region at %pa\n",  in mips_cdmm_setup()
410 	/* Enable CDMM */  in mips_cdmm_setup()
430  * mips_cdmm_early_probe() - Minimally probe for a specific device on CDMM.
431  * @dev_type:	CDMM type code to look for.
433  * Minimally configure the in-CPU Common Device Memory Map (CDMM) and look for a
449 	void __iomem *cdmm;  in mips_cdmm_early_probe()  local
464 	cdmm = bus->regs;  in mips_cdmm_early_probe()
468 		acsr = __raw_readl(cdmm + drb * CDMM_DRB_SIZE);  in mips_cdmm_early_probe()
471 			return cdmm + drb * CDMM_DRB_SIZE;  in mips_cdmm_early_probe()
480  * mips_cdmm_release() - Release a removed CDMM device.
483  * Clean up the struct mips_cdmm_device for an unused CDMM device. This is
494  * mips_cdmm_bus_discover() - Discover the devices on the CDMM bus.
495  * @bus:	CDMM bus information, must already be set up.
499 	void __iomem *cdmm;  in mips_cdmm_bus_discover()  local
509 	cdmm = bus->regs;  in mips_cdmm_bus_discover()
513 	pr_info("cdmm%u discovery (%u blocks)\n", cpu, bus->drbs);  in mips_cdmm_bus_discover()
515 		acsr = __raw_readl(cdmm + drb * CDMM_DRB_SIZE);  in mips_cdmm_bus_discover()
523 		pr_info("cdmm%u-%u: @%u (%#x..%#x), type 0x%02x, rev %u\n",  in mips_cdmm_bus_discover()
544 		dev_set_name(&dev->dev, "cdmm%u-%u", cpu, id);  in mips_cdmm_bus_discover()
558  * All the CDMM driver callbacks need to be executed on the appropriate CPU from
566  * BUILD_PERDEV_HELPER() - Helper to call a CDMM driver callback if CPU matches.
567  * @_name:	Name of CDMM driver callback function.
569  * Generates a bus_for_each_dev callback function to call a specific CDMM driver
600  *			       Tear down the CDMM bus.  in BUILD_PERDEV_HELPER()
603  * This function is executed on the hotplugged CPU and calls the CDMM  in BUILD_PERDEV_HELPER()
627  * mips_cdmm_cpu_online() - Callback for CPUHP ONLINE: Bring up the CDMM bus.
631  * CDMM devices on that CPU, or to call the CDMM driver cpu_up callback for all
662  * mips_cdmm_init() - Initialise CDMM bus.
664  * Initialise CDMM bus, discover CDMM devices for online CPUs, and arrange for
665  * hotplug notifications so the CDMM drivers can be kept up to date.
677 	ret = cpuhp_setup_state(CPUHP_AP_ONLINE_DYN, "bus/cdmm:online",  in mips_cdmm_init()
680 		pr_warn("cdmm: Failed to register CPU notifier\n");  in mips_cdmm_init()