2 * Bus driver for MIPS Common Device Memory Map (CDMM).
4 * Copyright (C) 2014-2015 Imagination Technologies Ltd.
6 * This file is subject to the terms and conditions of the GNU General Public
7 * License. See the file "COPYING" in the main directory of this archive
11 #include <linux/atomic.h>
12 #include <linux/err.h>
13 #include <linux/cpu.h>
14 #include <linux/cpumask.h>
16 #include <linux/platform_device.h>
17 #include <linux/slab.h>
18 #include <linux/smp.h>
20 #include <asm/hazards.h>
21 #include <asm/mipsregs.h>
23 /* Access control and status register fields */
24 #define CDMM_ACSR_DEVTYPE_SHIFT 24
25 #define CDMM_ACSR_DEVTYPE (255ul << CDMM_ACSR_DEVTYPE_SHIFT)
26 #define CDMM_ACSR_DEVSIZE_SHIFT 16
27 #define CDMM_ACSR_DEVSIZE (31ul << CDMM_ACSR_DEVSIZE_SHIFT)
28 #define CDMM_ACSR_DEVREV_SHIFT 12
29 #define CDMM_ACSR_DEVREV (15ul << CDMM_ACSR_DEVREV_SHIFT)
30 #define CDMM_ACSR_UW (1ul << 3)
31 #define CDMM_ACSR_UR (1ul << 2)
32 #define CDMM_ACSR_SW (1ul << 1)
33 #define CDMM_ACSR_SR (1ul << 0)
35 /* Each block of device registers is 64 bytes */
36 #define CDMM_DRB_SIZE 64
38 #define to_mips_cdmm_driver(d) container_of(d, struct mips_cdmm_driver, drv)
40 /* Default physical base address */
41 static phys_addr_t mips_cdmm_default_base
;
45 static const struct mips_cdmm_device_id
*
46 mips_cdmm_lookup(const struct mips_cdmm_device_id
*table
,
47 struct mips_cdmm_device
*dev
)
51 for (; table
->type
; ++table
) {
52 ret
= (dev
->type
== table
->type
);
57 return ret
? table
: NULL
;
60 static int mips_cdmm_match(struct device
*dev
, struct device_driver
*drv
)
62 struct mips_cdmm_device
*cdev
= to_mips_cdmm_device(dev
);
63 struct mips_cdmm_driver
*cdrv
= to_mips_cdmm_driver(drv
);
65 return mips_cdmm_lookup(cdrv
->id_table
, cdev
) != NULL
;
68 static int mips_cdmm_uevent(struct device
*dev
, struct kobj_uevent_env
*env
)
70 struct mips_cdmm_device
*cdev
= to_mips_cdmm_device(dev
);
73 retval
= add_uevent_var(env
, "CDMM_CPU=%u", cdev
->cpu
);
77 retval
= add_uevent_var(env
, "CDMM_TYPE=0x%02x", cdev
->type
);
81 retval
= add_uevent_var(env
, "CDMM_REV=%u", cdev
->rev
);
85 retval
= add_uevent_var(env
, "MODALIAS=mipscdmm:t%02X", cdev
->type
);
89 /* Device attributes */
91 #define CDMM_ATTR(name, fmt, arg...) \
92 static ssize_t name##_show(struct device *_dev, \
93 struct device_attribute *attr, char *buf) \
95 struct mips_cdmm_device *dev = to_mips_cdmm_device(_dev); \
96 return sprintf(buf, fmt, arg); \
98 static DEVICE_ATTR_RO(name);
100 CDMM_ATTR(cpu
, "%u\n", dev
->cpu
);
101 CDMM_ATTR(type
, "0x%02x\n", dev
->type
);
102 CDMM_ATTR(revision
, "%u\n", dev
->rev
);
103 CDMM_ATTR(modalias
, "mipscdmm:t%02X\n", dev
->type
);
104 CDMM_ATTR(resource
, "\t%016llx\t%016llx\t%016lx\n",
105 (unsigned long long)dev
->res
.start
,
106 (unsigned long long)dev
->res
.end
,
109 static struct attribute
*mips_cdmm_dev_attrs
[] = {
112 &dev_attr_revision
.attr
,
113 &dev_attr_modalias
.attr
,
114 &dev_attr_resource
.attr
,
117 ATTRIBUTE_GROUPS(mips_cdmm_dev
);
119 struct bus_type mips_cdmm_bustype
= {
121 .dev_groups
= mips_cdmm_dev_groups
,
122 .match
= mips_cdmm_match
,
123 .uevent
= mips_cdmm_uevent
,
125 EXPORT_SYMBOL_GPL(mips_cdmm_bustype
);
128 * Standard driver callback helpers.
130 * All the CDMM driver callbacks need to be executed on the appropriate CPU from
131 * workqueues. For the standard driver callbacks we need a work function
132 * (mips_cdmm_{void,int}_work()) to do the actual call from the right CPU, and a
133 * wrapper function (generated with BUILD_PERCPU_HELPER) to arrange for the work
134 * function to be called on that CPU.
138 * struct mips_cdmm_work_dev - Data for per-device call work.
139 * @fn: CDMM driver callback function to call for the device.
140 * @dev: CDMM device to pass to @fn.
142 struct mips_cdmm_work_dev
{
144 struct mips_cdmm_device
*dev
;
148 * mips_cdmm_void_work() - Call a void returning CDMM driver callback.
149 * @data: struct mips_cdmm_work_dev pointer.
151 * A work_on_cpu() callback function to call an arbitrary CDMM driver callback
152 * function which doesn't return a value.
154 static long mips_cdmm_void_work(void *data
)
156 struct mips_cdmm_work_dev
*work
= data
;
157 void (*fn
)(struct mips_cdmm_device
*) = work
->fn
;
164 * mips_cdmm_int_work() - Call an int returning CDMM driver callback.
165 * @data: struct mips_cdmm_work_dev pointer.
167 * A work_on_cpu() callback function to call an arbitrary CDMM driver callback
168 * function which returns an int.
170 static long mips_cdmm_int_work(void *data
)
172 struct mips_cdmm_work_dev
*work
= data
;
173 int (*fn
)(struct mips_cdmm_device
*) = work
->fn
;
175 return fn(work
->dev
);
178 #define _BUILD_RET_void
179 #define _BUILD_RET_int return
182 * BUILD_PERCPU_HELPER() - Helper to call a CDMM driver callback on right CPU.
183 * @_ret: Return type (void or int).
184 * @_name: Name of CDMM driver callback function.
186 * Generates a specific device callback function to call a CDMM driver callback
187 * function on the appropriate CPU for the device, and if applicable return the
190 #define BUILD_PERCPU_HELPER(_ret, _name) \
191 static _ret mips_cdmm_##_name(struct device *dev) \
193 struct mips_cdmm_device *cdev = to_mips_cdmm_device(dev); \
194 struct mips_cdmm_driver *cdrv = to_mips_cdmm_driver(dev->driver); \
195 struct mips_cdmm_work_dev work = { \
200 _BUILD_RET_##_ret work_on_cpu(cdev->cpu, \
201 mips_cdmm_##_ret##_work, &work); \
204 /* Driver callback functions */
205 BUILD_PERCPU_HELPER(int, probe
) /* int mips_cdmm_probe(struct device) */
206 BUILD_PERCPU_HELPER(int, remove
) /* int mips_cdmm_remove(struct device) */
207 BUILD_PERCPU_HELPER(void, shutdown
) /* void mips_cdmm_shutdown(struct device) */
210 /* Driver registration */
213 * mips_cdmm_driver_register() - Register a CDMM driver.
214 * @drv: CDMM driver information.
216 * Register a CDMM driver with the CDMM subsystem. The driver will be informed
217 * of matching devices which are discovered.
219 * Returns: 0 on success.
221 int mips_cdmm_driver_register(struct mips_cdmm_driver
*drv
)
223 drv
->drv
.bus
= &mips_cdmm_bustype
;
226 drv
->drv
.probe
= mips_cdmm_probe
;
228 drv
->drv
.remove
= mips_cdmm_remove
;
230 drv
->drv
.shutdown
= mips_cdmm_shutdown
;
232 return driver_register(&drv
->drv
);
234 EXPORT_SYMBOL_GPL(mips_cdmm_driver_register
);
237 * mips_cdmm_driver_unregister() - Unregister a CDMM driver.
238 * @drv: CDMM driver information.
240 * Unregister a CDMM driver from the CDMM subsystem.
242 void mips_cdmm_driver_unregister(struct mips_cdmm_driver
*drv
)
244 driver_unregister(&drv
->drv
);
246 EXPORT_SYMBOL_GPL(mips_cdmm_driver_unregister
);
249 /* CDMM initialisation and bus discovery */
252 * struct mips_cdmm_bus - Info about CDMM bus.
253 * @phys: Physical address at which it is mapped.
254 * @regs: Virtual address where registers can be accessed.
255 * @drbs: Total number of DRBs.
256 * @drbs_reserved: Number of DRBs reserved.
257 * @discovered: Whether the devices on the bus have been discovered yet.
258 * @offline: Whether the CDMM bus is going offline (or very early
259 * coming back online), in which case it should be
260 * reconfigured each time.
262 struct mips_cdmm_bus
{
266 unsigned int drbs_reserved
;
271 static struct mips_cdmm_bus mips_cdmm_boot_bus
;
272 static DEFINE_PER_CPU(struct mips_cdmm_bus
*, mips_cdmm_buses
);
273 static atomic_t mips_cdmm_next_id
= ATOMIC_INIT(-1);
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.
280 * The caller must prevent migration to another CPU, either by disabling
281 * pre-emption or by running from a pinned kernel thread.
283 * Returns: Pointer to CDMM bus information for the current CPU.
284 * May return ERR_PTR(-errno) in case of error, so check with
287 static struct mips_cdmm_bus
*mips_cdmm_get_bus(void)
289 struct mips_cdmm_bus
*bus
, **bus_p
;
294 return ERR_PTR(-ENODEV
);
296 cpu
= smp_processor_id();
297 /* Avoid early use of per-cpu primitives before initialised */
299 return &mips_cdmm_boot_bus
;
301 /* Get bus pointer */
302 bus_p
= per_cpu_ptr(&mips_cdmm_buses
, cpu
);
303 local_irq_save(flags
);
305 /* Attempt allocation if NULL */
306 if (unlikely(!bus
)) {
307 bus
= kzalloc(sizeof(*bus
), GFP_ATOMIC
);
309 bus
= ERR_PTR(-ENOMEM
);
313 local_irq_restore(flags
);
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.
323 static phys_addr_t
mips_cdmm_cur_base(void)
325 unsigned long cdmmbase
= read_c0_cdmmbase();
327 if (!(cdmmbase
& MIPS_CDMMBASE_EN
))
330 return (cdmmbase
>> MIPS_CDMMBASE_ADDR_SHIFT
)
331 << MIPS_CDMMBASE_ADDR_START
;
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
338 * platform specific, so this weak function can be overridden by platform
339 * code to pick a suitable value if none is configured by the bootloader.
341 phys_addr_t __weak
mips_cdmm_phys_base(void)
347 * mips_cdmm_setup() - Ensure the CDMM bus is initialised and usable.
348 * @bus: Pointer to bus information for current CPU.
349 * IS_ERR(bus) is checked, so no need for caller to check.
351 * The caller must prevent migration to another CPU, either by disabling
352 * pre-emption or by running from a pinned kernel thread.
354 * Returns 0 on success, -errno on failure.
356 static int mips_cdmm_setup(struct mips_cdmm_bus
*bus
)
358 unsigned long cdmmbase
, flags
;
364 local_irq_save(flags
);
365 /* Don't set up bus a second time unless marked offline */
367 /* If CDMM region is still set up, nothing to do */
368 if (bus
->phys
== mips_cdmm_cur_base())
371 * The CDMM region isn't set up as expected, so it needs
372 * reconfiguring, but then we can stop checking it.
374 bus
->offline
= false;
375 } else if (bus
->phys
> 1) {
379 /* If the CDMM region is already configured, inherit that setup */
381 bus
->phys
= mips_cdmm_cur_base();
382 /* Otherwise, ask platform code for suggestions */
384 bus
->phys
= mips_cdmm_phys_base();
385 /* Otherwise, copy what other CPUs have done */
387 bus
->phys
= mips_cdmm_default_base
;
388 /* Otherwise, complain once */
392 * If you hit this, either your bootloader needs to set up the
393 * CDMM on the boot CPU, or else you need to implement
394 * mips_cdmm_phys_base() for your platform (see asm/cdmm.h).
396 pr_err("cdmm%u: Failed to choose a physical base\n",
399 /* Already complained? */
400 if (bus
->phys
== 1) {
404 /* Record our success for other CPUs to copy */
405 mips_cdmm_default_base
= bus
->phys
;
407 pr_debug("cdmm%u: Enabling CDMM region at %pa\n",
408 smp_processor_id(), &bus
->phys
);
411 cdmmbase
= read_c0_cdmmbase();
412 cdmmbase
&= (1ul << MIPS_CDMMBASE_ADDR_SHIFT
) - 1;
413 cdmmbase
|= (bus
->phys
>> MIPS_CDMMBASE_ADDR_START
)
414 << MIPS_CDMMBASE_ADDR_SHIFT
;
415 cdmmbase
|= MIPS_CDMMBASE_EN
;
416 write_c0_cdmmbase(cdmmbase
);
419 bus
->regs
= (void __iomem
*)CKSEG1ADDR(bus
->phys
);
420 bus
->drbs
= 1 + ((cdmmbase
& MIPS_CDMMBASE_SIZE
) >>
421 MIPS_CDMMBASE_SIZE_SHIFT
);
422 bus
->drbs_reserved
= !!(cdmmbase
& MIPS_CDMMBASE_CI
);
425 local_irq_restore(flags
);
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
434 * specific device. This can be used to find a device very early in boot for
435 * example to configure an early FDC console device.
437 * The caller must prevent migration to another CPU, either by disabling
438 * pre-emption or by running from a pinned kernel thread.
440 * Returns: MMIO pointer to device memory. The caller can read the ACSR
441 * register to find more information about the device (such as the
442 * version number or the number of blocks).
443 * May return IOMEM_ERR_PTR(-errno) in case of error, so check with
446 void __iomem
*mips_cdmm_early_probe(unsigned int dev_type
)
448 struct mips_cdmm_bus
*bus
;
451 unsigned int drb
, type
, size
;
454 if (WARN_ON(!dev_type
))
455 return IOMEM_ERR_PTR(-ENODEV
);
457 bus
= mips_cdmm_get_bus();
458 err
= mips_cdmm_setup(bus
);
460 return IOMEM_ERR_PTR(err
);
462 /* Skip the first block if it's reserved for more registers */
463 drb
= bus
->drbs_reserved
;
466 /* Look for a specific device type */
467 for (; drb
< bus
->drbs
; drb
+= size
+ 1) {
468 acsr
= __raw_readl(cdmm
+ drb
* CDMM_DRB_SIZE
);
469 type
= (acsr
& CDMM_ACSR_DEVTYPE
) >> CDMM_ACSR_DEVTYPE_SHIFT
;
470 if (type
== dev_type
)
471 return cdmm
+ drb
* CDMM_DRB_SIZE
;
472 size
= (acsr
& CDMM_ACSR_DEVSIZE
) >> CDMM_ACSR_DEVSIZE_SHIFT
;
475 return IOMEM_ERR_PTR(-ENODEV
);
477 EXPORT_SYMBOL_GPL(mips_cdmm_early_probe
);
480 * mips_cdmm_release() - Release a removed CDMM device.
481 * @dev: Device object
483 * Clean up the struct mips_cdmm_device for an unused CDMM device. This is
484 * called automatically by the driver core when a device is removed.
486 static void mips_cdmm_release(struct device
*dev
)
488 struct mips_cdmm_device
*cdev
= to_mips_cdmm_device(dev
);
494 * mips_cdmm_bus_discover() - Discover the devices on the CDMM bus.
495 * @bus: CDMM bus information, must already be set up.
497 static void mips_cdmm_bus_discover(struct mips_cdmm_bus
*bus
)
501 unsigned int drb
, type
, size
, rev
;
502 struct mips_cdmm_device
*dev
;
503 unsigned int cpu
= smp_processor_id();
507 /* Skip the first block if it's reserved for more registers */
508 drb
= bus
->drbs_reserved
;
511 /* Discover devices */
512 bus
->discovered
= true;
513 pr_info("cdmm%u discovery (%u blocks)\n", cpu
, bus
->drbs
);
514 for (; drb
< bus
->drbs
; drb
+= size
+ 1) {
515 acsr
= __raw_readl(cdmm
+ drb
* CDMM_DRB_SIZE
);
516 type
= (acsr
& CDMM_ACSR_DEVTYPE
) >> CDMM_ACSR_DEVTYPE_SHIFT
;
517 size
= (acsr
& CDMM_ACSR_DEVSIZE
) >> CDMM_ACSR_DEVSIZE_SHIFT
;
518 rev
= (acsr
& CDMM_ACSR_DEVREV
) >> CDMM_ACSR_DEVREV_SHIFT
;
523 pr_info("cdmm%u-%u: @%u (%#x..%#x), type 0x%02x, rev %u\n",
524 cpu
, id
, drb
, drb
* CDMM_DRB_SIZE
,
525 (drb
+ size
+ 1) * CDMM_DRB_SIZE
- 1,
528 dev
= kzalloc(sizeof(*dev
), GFP_KERNEL
);
533 dev
->res
.start
= bus
->phys
+ drb
* CDMM_DRB_SIZE
;
534 dev
->res
.end
= bus
->phys
+
535 (drb
+ size
+ 1) * CDMM_DRB_SIZE
- 1;
536 dev
->res
.flags
= IORESOURCE_MEM
;
539 dev
->dev
.parent
= get_cpu_device(cpu
);
540 dev
->dev
.bus
= &mips_cdmm_bustype
;
541 dev
->dev
.id
= atomic_inc_return(&mips_cdmm_next_id
);
542 dev
->dev
.release
= mips_cdmm_release
;
544 dev_set_name(&dev
->dev
, "cdmm%u-%u", cpu
, id
);
546 ret
= device_register(&dev
->dev
);
548 put_device(&dev
->dev
);
556 * CPU hotplug and initialisation
558 * All the CDMM driver callbacks need to be executed on the appropriate CPU from
559 * workqueues. For the CPU callbacks, they need to be called for all devices on
560 * that CPU, so the work function calls bus_for_each_dev, using a helper
561 * (generated with BUILD_PERDEV_HELPER) to call the driver callback if the
562 * device's CPU matches.
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
570 * callback function for the device if the device's CPU matches that pointed to
571 * by the data argument.
573 * This is used for informing drivers for all devices on a given CPU of some
574 * event (such as the CPU going online/offline).
576 * It is expected to already be called from the appropriate CPU.
578 #define BUILD_PERDEV_HELPER(_name) \
579 static int mips_cdmm_##_name##_helper(struct device *dev, void *data) \
581 struct mips_cdmm_device *cdev = to_mips_cdmm_device(dev); \
582 struct mips_cdmm_driver *cdrv; \
583 unsigned int cpu = *(unsigned int *)data; \
585 if (cdev->cpu != cpu || !dev->driver) \
588 cdrv = to_mips_cdmm_driver(dev->driver); \
591 return cdrv->_name(cdev); \
594 /* bus_for_each_dev callback helper functions */
595 BUILD_PERDEV_HELPER(cpu_down
) /* int mips_cdmm_cpu_down_helper(...) */
596 BUILD_PERDEV_HELPER(cpu_up
) /* int mips_cdmm_cpu_up_helper(...) */
599 * mips_cdmm_cpu_down_prep() - Callback for CPUHP DOWN_PREP:
600 * Tear down the CDMM bus.
601 * @cpu: unsigned int CPU number.
603 * This function is executed on the hotplugged CPU and calls the CDMM
604 * driver cpu_down callback for all devices on that CPU.
606 static int mips_cdmm_cpu_down_prep(unsigned int cpu
)
608 struct mips_cdmm_bus
*bus
;
611 /* Inform all the devices on the bus */
612 ret
= bus_for_each_dev(&mips_cdmm_bustype
, NULL
, &cpu
,
613 mips_cdmm_cpu_down_helper
);
616 * While bus is offline, each use of it should reconfigure it just in
617 * case it is first use when coming back online again.
619 bus
= mips_cdmm_get_bus();
627 * mips_cdmm_cpu_online() - Callback for CPUHP ONLINE: Bring up the CDMM bus.
628 * @cpu: unsigned int CPU number.
630 * This work_on_cpu callback function is executed on a given CPU to discover
631 * CDMM devices on that CPU, or to call the CDMM driver cpu_up callback for all
632 * devices already discovered on that CPU.
634 * It is used as work_on_cpu callback function during
635 * initialisation. When CPUs are brought online the function is
636 * invoked directly on the hotplugged CPU.
638 static int mips_cdmm_cpu_online(unsigned int cpu
)
640 struct mips_cdmm_bus
*bus
;
643 bus
= mips_cdmm_get_bus();
644 ret
= mips_cdmm_setup(bus
);
648 /* Bus now set up, so we can drop the offline flag if still set */
649 bus
->offline
= false;
651 if (!bus
->discovered
)
652 mips_cdmm_bus_discover(bus
);
654 /* Inform all the devices on the bus */
655 ret
= bus_for_each_dev(&mips_cdmm_bustype
, NULL
, &cpu
,
656 mips_cdmm_cpu_up_helper
);
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.
667 static int __init
mips_cdmm_init(void)
671 /* Register the bus */
672 ret
= bus_register(&mips_cdmm_bustype
);
676 /* We want to be notified about new CPUs */
677 ret
= cpuhp_setup_state(CPUHP_AP_ONLINE_DYN
, "bus/cdmm:online",
678 mips_cdmm_cpu_online
, mips_cdmm_cpu_down_prep
);
680 pr_warn("cdmm: Failed to register CPU notifier\n");
684 subsys_initcall(mips_cdmm_init
);