2 * OMAP hardware spinlock driver
4 * Copyright (C) 2010 Texas Instruments Incorporated - http://www.ti.com
6 * Contact: Simon Que <sque@ti.com>
7 * Hari Kanigeri <h-kanigeri2@ti.com>
8 * Ohad Ben-Cohen <ohad@wizery.com>
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public License
12 * version 2 as published by the Free Software Foundation.
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * General Public License for more details.
20 #include <linux/kernel.h>
21 #include <linux/module.h>
22 #include <linux/device.h>
23 #include <linux/delay.h>
25 #include <linux/bitops.h>
26 #include <linux/pm_runtime.h>
27 #include <linux/slab.h>
28 #include <linux/spinlock.h>
29 #include <linux/hwspinlock.h>
30 #include <linux/platform_device.h>
32 #include "hwspinlock_internal.h"
34 /* Spinlock register offsets */
35 #define SYSSTATUS_OFFSET 0x0014
36 #define LOCK_BASE_OFFSET 0x0800
38 #define SPINLOCK_NUMLOCKS_BIT_OFFSET (24)
40 /* Possible values of SPINLOCK_LOCK_REG */
41 #define SPINLOCK_NOTTAKEN (0) /* free */
42 #define SPINLOCK_TAKEN (1) /* locked */
44 #define to_omap_hwspinlock(lock) \
45 container_of(lock, struct omap_hwspinlock, lock)
47 struct omap_hwspinlock {
48 struct hwspinlock lock;
52 struct omap_hwspinlock_state {
53 int num_locks; /* Total number of locks in system */
54 void __iomem *io_base; /* Mapped base address */
55 struct omap_hwspinlock lock[0]; /* Array of 'num_locks' locks */
58 static int omap_hwspinlock_trylock(struct hwspinlock *lock)
60 struct omap_hwspinlock *omap_lock = to_omap_hwspinlock(lock);
62 /* attempt to acquire the lock by reading its value */
63 return (SPINLOCK_NOTTAKEN == readl(omap_lock->addr));
66 static void omap_hwspinlock_unlock(struct hwspinlock *lock)
68 struct omap_hwspinlock *omap_lock = to_omap_hwspinlock(lock);
70 /* release the lock by writing 0 to it */
71 writel(SPINLOCK_NOTTAKEN, omap_lock->addr);
75 * relax the OMAP interconnect while spinning on it.
77 * The specs recommended that the retry delay time will be
78 * just over half of the time that a requester would be
79 * expected to hold the lock.
81 * The number below is taken from an hardware specs example,
82 * obviously it is somewhat arbitrary.
84 static void omap_hwspinlock_relax(struct hwspinlock *lock)
89 static const struct hwspinlock_ops omap_hwspinlock_ops = {
90 .trylock = omap_hwspinlock_trylock,
91 .unlock = omap_hwspinlock_unlock,
92 .relax = omap_hwspinlock_relax,
95 static int __devinit omap_hwspinlock_probe(struct platform_device *pdev)
97 struct omap_hwspinlock *omap_lock;
98 struct omap_hwspinlock_state *state;
100 void __iomem *io_base;
103 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
107 io_base = ioremap(res->start, resource_size(res));
111 /* Determine number of locks */
112 i = readl(io_base + SYSSTATUS_OFFSET);
113 i >>= SPINLOCK_NUMLOCKS_BIT_OFFSET;
115 /* one of the four lsb's must be set, and nothing else */
116 if (hweight_long(i & 0xf) != 1 || i > 8) {
121 i *= 32; /* actual number of locks in this device */
123 state = kzalloc(sizeof(*state) + i * sizeof(*omap_lock), GFP_KERNEL);
129 state->num_locks = i;
130 state->io_base = io_base;
132 platform_set_drvdata(pdev, state);
135 * runtime PM will make sure the clock of this module is
136 * enabled iff at least one lock is requested
138 pm_runtime_enable(&pdev->dev);
140 for (i = 0; i < state->num_locks; i++) {
141 omap_lock = &state->lock[i];
143 omap_lock->lock.dev = &pdev->dev;
144 omap_lock->lock.id = i;
145 omap_lock->lock.ops = &omap_hwspinlock_ops;
146 omap_lock->addr = io_base + LOCK_BASE_OFFSET + sizeof(u32) * i;
148 ret = hwspin_lock_register(&omap_lock->lock);
157 hwspin_lock_unregister(i);
158 pm_runtime_disable(&pdev->dev);
165 static int omap_hwspinlock_remove(struct platform_device *pdev)
167 struct omap_hwspinlock_state *state = platform_get_drvdata(pdev);
168 struct hwspinlock *lock;
171 for (i = 0; i < state->num_locks; i++) {
172 lock = hwspin_lock_unregister(i);
173 /* this shouldn't happen at this point. if it does, at least
174 * don't continue with the remove */
176 dev_err(&pdev->dev, "%s: failed on %d\n", __func__, i);
181 pm_runtime_disable(&pdev->dev);
182 iounmap(state->io_base);
188 static struct platform_driver omap_hwspinlock_driver = {
189 .probe = omap_hwspinlock_probe,
190 .remove = omap_hwspinlock_remove,
192 .name = "omap_hwspinlock",
193 .owner = THIS_MODULE,
197 static int __init omap_hwspinlock_init(void)
199 return platform_driver_register(&omap_hwspinlock_driver);
201 /* board init code might need to reserve hwspinlocks for predefined purposes */
202 postcore_initcall(omap_hwspinlock_init);
204 static void __exit omap_hwspinlock_exit(void)
206 platform_driver_unregister(&omap_hwspinlock_driver);
208 module_exit(omap_hwspinlock_exit);
210 MODULE_LICENSE("GPL v2");
211 MODULE_DESCRIPTION("Hardware spinlock driver for OMAP");
212 MODULE_AUTHOR("Simon Que <sque@ti.com>");
213 MODULE_AUTHOR("Hari Kanigeri <h-kanigeri2@ti.com>");
214 MODULE_AUTHOR("Ohad Ben-Cohen <ohad@wizery.com>");