2 * linux/drivers/mfd/mcp-core.c
4 * Copyright (C) 2001 Russell King
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License.
10 * Generic MCP (Multimedia Communications Port) layer. All MCP locking
11 * is solely held within this file.
13 #include <linux/module.h>
14 #include <linux/init.h>
15 #include <linux/errno.h>
16 #include <linux/smp.h>
17 #include <linux/device.h>
18 #include <linux/slab.h>
19 #include <linux/string.h>
22 #include <asm/system.h>
26 #define to_mcp(d) container_of(d, struct mcp, attached_device)
27 #define to_mcp_driver(d) container_of(d, struct mcp_driver, drv)
29 static int mcp_bus_match(struct device *dev, struct device_driver *drv)
34 static int mcp_bus_probe(struct device *dev)
36 struct mcp *mcp = to_mcp(dev);
37 struct mcp_driver *drv = to_mcp_driver(dev->driver);
39 return drv->probe(mcp);
42 static int mcp_bus_remove(struct device *dev)
44 struct mcp *mcp = to_mcp(dev);
45 struct mcp_driver *drv = to_mcp_driver(dev->driver);
51 static int mcp_bus_suspend(struct device *dev, pm_message_t state)
53 struct mcp *mcp = to_mcp(dev);
57 struct mcp_driver *drv = to_mcp_driver(dev->driver);
59 ret = drv->suspend(mcp, state);
64 static int mcp_bus_resume(struct device *dev)
66 struct mcp *mcp = to_mcp(dev);
70 struct mcp_driver *drv = to_mcp_driver(dev->driver);
72 ret = drv->resume(mcp);
77 static struct bus_type mcp_bus_type = {
79 .match = mcp_bus_match,
80 .suspend = mcp_bus_suspend,
81 .resume = mcp_bus_resume,
85 * mcp_set_telecom_divisor - set the telecom divisor
86 * @mcp: MCP interface structure
87 * @div: SIB clock divisor
89 * Set the telecom divisor on the MCP interface. The resulting
90 * sample rate is SIBCLOCK/div.
92 void mcp_set_telecom_divisor(struct mcp *mcp, unsigned int div)
94 spin_lock_irq(&mcp->lock);
95 mcp->ops->set_telecom_divisor(mcp, div);
96 spin_unlock_irq(&mcp->lock);
98 EXPORT_SYMBOL(mcp_set_telecom_divisor);
101 * mcp_set_audio_divisor - set the audio divisor
102 * @mcp: MCP interface structure
103 * @div: SIB clock divisor
105 * Set the audio divisor on the MCP interface.
107 void mcp_set_audio_divisor(struct mcp *mcp, unsigned int div)
109 spin_lock_irq(&mcp->lock);
110 mcp->ops->set_audio_divisor(mcp, div);
111 spin_unlock_irq(&mcp->lock);
113 EXPORT_SYMBOL(mcp_set_audio_divisor);
116 * mcp_reg_write - write a device register
117 * @mcp: MCP interface structure
118 * @reg: 4-bit register index
119 * @val: 16-bit data value
121 * Write a device register. The MCP interface must be enabled
122 * to prevent this function hanging.
124 void mcp_reg_write(struct mcp *mcp, unsigned int reg, unsigned int val)
128 spin_lock_irqsave(&mcp->lock, flags);
129 mcp->ops->reg_write(mcp, reg, val);
130 spin_unlock_irqrestore(&mcp->lock, flags);
132 EXPORT_SYMBOL(mcp_reg_write);
135 * mcp_reg_read - read a device register
136 * @mcp: MCP interface structure
137 * @reg: 4-bit register index
139 * Read a device register and return its value. The MCP interface
140 * must be enabled to prevent this function hanging.
142 unsigned int mcp_reg_read(struct mcp *mcp, unsigned int reg)
147 spin_lock_irqsave(&mcp->lock, flags);
148 val = mcp->ops->reg_read(mcp, reg);
149 spin_unlock_irqrestore(&mcp->lock, flags);
153 EXPORT_SYMBOL(mcp_reg_read);
156 * mcp_enable - enable the MCP interface
157 * @mcp: MCP interface to enable
159 * Enable the MCP interface. Each call to mcp_enable will need
160 * a corresponding call to mcp_disable to disable the interface.
162 void mcp_enable(struct mcp *mcp)
164 spin_lock_irq(&mcp->lock);
165 if (mcp->use_count++ == 0)
166 mcp->ops->enable(mcp);
167 spin_unlock_irq(&mcp->lock);
169 EXPORT_SYMBOL(mcp_enable);
172 * mcp_disable - disable the MCP interface
173 * @mcp: MCP interface to disable
175 * Disable the MCP interface. The MCP interface will only be
176 * disabled once the number of calls to mcp_enable matches the
177 * number of calls to mcp_disable.
179 void mcp_disable(struct mcp *mcp)
183 spin_lock_irqsave(&mcp->lock, flags);
184 if (--mcp->use_count == 0)
185 mcp->ops->disable(mcp);
186 spin_unlock_irqrestore(&mcp->lock, flags);
188 EXPORT_SYMBOL(mcp_disable);
190 static void mcp_release(struct device *dev)
192 struct mcp *mcp = container_of(dev, struct mcp, attached_device);
197 struct mcp *mcp_host_alloc(struct device *parent, size_t size)
201 mcp = kmalloc(sizeof(struct mcp) + size, GFP_KERNEL);
203 memset(mcp, 0, sizeof(struct mcp) + size);
204 spin_lock_init(&mcp->lock);
205 mcp->attached_device.parent = parent;
206 mcp->attached_device.bus = &mcp_bus_type;
207 mcp->attached_device.dma_mask = parent->dma_mask;
208 mcp->attached_device.release = mcp_release;
212 EXPORT_SYMBOL(mcp_host_alloc);
214 int mcp_host_register(struct mcp *mcp)
216 strcpy(mcp->attached_device.bus_id, "mcp0");
217 return device_register(&mcp->attached_device);
219 EXPORT_SYMBOL(mcp_host_register);
221 void mcp_host_unregister(struct mcp *mcp)
223 device_unregister(&mcp->attached_device);
225 EXPORT_SYMBOL(mcp_host_unregister);
227 int mcp_driver_register(struct mcp_driver *mcpdrv)
229 mcpdrv->drv.bus = &mcp_bus_type;
230 mcpdrv->drv.probe = mcp_bus_probe;
231 mcpdrv->drv.remove = mcp_bus_remove;
232 return driver_register(&mcpdrv->drv);
234 EXPORT_SYMBOL(mcp_driver_register);
236 void mcp_driver_unregister(struct mcp_driver *mcpdrv)
238 driver_unregister(&mcpdrv->drv);
240 EXPORT_SYMBOL(mcp_driver_unregister);
242 static int __init mcp_init(void)
244 return bus_register(&mcp_bus_type);
247 static void __exit mcp_exit(void)
249 bus_unregister(&mcp_bus_type);
252 module_init(mcp_init);
253 module_exit(mcp_exit);
255 MODULE_AUTHOR("Russell King <rmk@arm.linux.org.uk>");
256 MODULE_DESCRIPTION("Core multimedia communications port driver");
257 MODULE_LICENSE("GPL");