bus.c 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847
  1. /*
  2. * linux/arch/arm/common/amba.c
  3. *
  4. * Copyright (C) 2003 Deep Blue Solutions Ltd, All Rights Reserved.
  5. *
  6. * This program is free software; you can redistribute it and/or modify
  7. * it under the terms of the GNU General Public License version 2 as
  8. * published by the Free Software Foundation.
  9. */
  10. #include <linux/module.h>
  11. #include <linux/init.h>
  12. #include <linux/device.h>
  13. #include <linux/string.h>
  14. #include <linux/slab.h>
  15. #include <linux/io.h>
  16. #include <linux/pm.h>
  17. #include <linux/pm_runtime.h>
  18. #include <linux/amba/bus.h>
  19. #include <asm/irq.h>
  20. #include <asm/sizes.h>
  21. #define to_amba_driver(d) container_of(d, struct amba_driver, drv)
  22. static const struct amba_id *
  23. amba_lookup(const struct amba_id *table, struct amba_device *dev)
  24. {
  25. int ret = 0;
  26. while (table->mask) {
  27. ret = (dev->periphid & table->mask) == table->id;
  28. if (ret)
  29. break;
  30. table++;
  31. }
  32. return ret ? table : NULL;
  33. }
  34. static int amba_match(struct device *dev, struct device_driver *drv)
  35. {
  36. struct amba_device *pcdev = to_amba_device(dev);
  37. struct amba_driver *pcdrv = to_amba_driver(drv);
  38. return amba_lookup(pcdrv->id_table, pcdev) != NULL;
  39. }
  40. #ifdef CONFIG_HOTPLUG
  41. static int amba_uevent(struct device *dev, struct kobj_uevent_env *env)
  42. {
  43. struct amba_device *pcdev = to_amba_device(dev);
  44. int retval = 0;
  45. retval = add_uevent_var(env, "AMBA_ID=%08x", pcdev->periphid);
  46. return retval;
  47. }
  48. #else
  49. #define amba_uevent NULL
  50. #endif
  51. #define amba_attr_func(name,fmt,arg...) \
  52. static ssize_t name##_show(struct device *_dev, \
  53. struct device_attribute *attr, char *buf) \
  54. { \
  55. struct amba_device *dev = to_amba_device(_dev); \
  56. return sprintf(buf, fmt, arg); \
  57. }
  58. #define amba_attr(name,fmt,arg...) \
  59. amba_attr_func(name,fmt,arg) \
  60. static DEVICE_ATTR(name, S_IRUGO, name##_show, NULL)
  61. amba_attr_func(id, "%08x\n", dev->periphid);
  62. amba_attr(irq0, "%u\n", dev->irq[0]);
  63. amba_attr(irq1, "%u\n", dev->irq[1]);
  64. amba_attr_func(resource, "\t%016llx\t%016llx\t%016lx\n",
  65. (unsigned long long)dev->res.start, (unsigned long long)dev->res.end,
  66. dev->res.flags);
  67. static struct device_attribute amba_dev_attrs[] = {
  68. __ATTR_RO(id),
  69. __ATTR_RO(resource),
  70. __ATTR_NULL,
  71. };
  72. #ifdef CONFIG_PM_SLEEP
  73. static int amba_legacy_suspend(struct device *dev, pm_message_t mesg)
  74. {
  75. struct amba_driver *adrv = to_amba_driver(dev->driver);
  76. struct amba_device *adev = to_amba_device(dev);
  77. int ret = 0;
  78. if (dev->driver && adrv->suspend)
  79. ret = adrv->suspend(adev, mesg);
  80. return ret;
  81. }
  82. static int amba_legacy_resume(struct device *dev)
  83. {
  84. struct amba_driver *adrv = to_amba_driver(dev->driver);
  85. struct amba_device *adev = to_amba_device(dev);
  86. int ret = 0;
  87. if (dev->driver && adrv->resume)
  88. ret = adrv->resume(adev);
  89. return ret;
  90. }
  91. static int amba_pm_prepare(struct device *dev)
  92. {
  93. struct device_driver *drv = dev->driver;
  94. int ret = 0;
  95. if (drv && drv->pm && drv->pm->prepare)
  96. ret = drv->pm->prepare(dev);
  97. return ret;
  98. }
  99. static void amba_pm_complete(struct device *dev)
  100. {
  101. struct device_driver *drv = dev->driver;
  102. if (drv && drv->pm && drv->pm->complete)
  103. drv->pm->complete(dev);
  104. }
  105. #else /* !CONFIG_PM_SLEEP */
  106. #define amba_pm_prepare NULL
  107. #define amba_pm_complete NULL
  108. #endif /* !CONFIG_PM_SLEEP */
  109. #ifdef CONFIG_SUSPEND
  110. static int amba_pm_suspend(struct device *dev)
  111. {
  112. struct device_driver *drv = dev->driver;
  113. int ret = 0;
  114. if (!drv)
  115. return 0;
  116. if (drv->pm) {
  117. if (drv->pm->suspend)
  118. ret = drv->pm->suspend(dev);
  119. } else {
  120. ret = amba_legacy_suspend(dev, PMSG_SUSPEND);
  121. }
  122. return ret;
  123. }
  124. static int amba_pm_suspend_noirq(struct device *dev)
  125. {
  126. struct device_driver *drv = dev->driver;
  127. int ret = 0;
  128. if (!drv)
  129. return 0;
  130. if (drv->pm) {
  131. if (drv->pm->suspend_noirq)
  132. ret = drv->pm->suspend_noirq(dev);
  133. }
  134. return ret;
  135. }
  136. static int amba_pm_resume(struct device *dev)
  137. {
  138. struct device_driver *drv = dev->driver;
  139. int ret = 0;
  140. if (!drv)
  141. return 0;
  142. if (drv->pm) {
  143. if (drv->pm->resume)
  144. ret = drv->pm->resume(dev);
  145. } else {
  146. ret = amba_legacy_resume(dev);
  147. }
  148. return ret;
  149. }
  150. static int amba_pm_resume_noirq(struct device *dev)
  151. {
  152. struct device_driver *drv = dev->driver;
  153. int ret = 0;
  154. if (!drv)
  155. return 0;
  156. if (drv->pm) {
  157. if (drv->pm->resume_noirq)
  158. ret = drv->pm->resume_noirq(dev);
  159. }
  160. return ret;
  161. }
  162. #else /* !CONFIG_SUSPEND */
  163. #define amba_pm_suspend NULL
  164. #define amba_pm_resume NULL
  165. #define amba_pm_suspend_noirq NULL
  166. #define amba_pm_resume_noirq NULL
  167. #endif /* !CONFIG_SUSPEND */
  168. #ifdef CONFIG_HIBERNATE_CALLBACKS
  169. static int amba_pm_freeze(struct device *dev)
  170. {
  171. struct device_driver *drv = dev->driver;
  172. int ret = 0;
  173. if (!drv)
  174. return 0;
  175. if (drv->pm) {
  176. if (drv->pm->freeze)
  177. ret = drv->pm->freeze(dev);
  178. } else {
  179. ret = amba_legacy_suspend(dev, PMSG_FREEZE);
  180. }
  181. return ret;
  182. }
  183. static int amba_pm_freeze_noirq(struct device *dev)
  184. {
  185. struct device_driver *drv = dev->driver;
  186. int ret = 0;
  187. if (!drv)
  188. return 0;
  189. if (drv->pm) {
  190. if (drv->pm->freeze_noirq)
  191. ret = drv->pm->freeze_noirq(dev);
  192. }
  193. return ret;
  194. }
  195. static int amba_pm_thaw(struct device *dev)
  196. {
  197. struct device_driver *drv = dev->driver;
  198. int ret = 0;
  199. if (!drv)
  200. return 0;
  201. if (drv->pm) {
  202. if (drv->pm->thaw)
  203. ret = drv->pm->thaw(dev);
  204. } else {
  205. ret = amba_legacy_resume(dev);
  206. }
  207. return ret;
  208. }
  209. static int amba_pm_thaw_noirq(struct device *dev)
  210. {
  211. struct device_driver *drv = dev->driver;
  212. int ret = 0;
  213. if (!drv)
  214. return 0;
  215. if (drv->pm) {
  216. if (drv->pm->thaw_noirq)
  217. ret = drv->pm->thaw_noirq(dev);
  218. }
  219. return ret;
  220. }
  221. static int amba_pm_poweroff(struct device *dev)
  222. {
  223. struct device_driver *drv = dev->driver;
  224. int ret = 0;
  225. if (!drv)
  226. return 0;
  227. if (drv->pm) {
  228. if (drv->pm->poweroff)
  229. ret = drv->pm->poweroff(dev);
  230. } else {
  231. ret = amba_legacy_suspend(dev, PMSG_HIBERNATE);
  232. }
  233. return ret;
  234. }
  235. static int amba_pm_poweroff_noirq(struct device *dev)
  236. {
  237. struct device_driver *drv = dev->driver;
  238. int ret = 0;
  239. if (!drv)
  240. return 0;
  241. if (drv->pm) {
  242. if (drv->pm->poweroff_noirq)
  243. ret = drv->pm->poweroff_noirq(dev);
  244. }
  245. return ret;
  246. }
  247. static int amba_pm_restore(struct device *dev)
  248. {
  249. struct device_driver *drv = dev->driver;
  250. int ret = 0;
  251. if (!drv)
  252. return 0;
  253. if (drv->pm) {
  254. if (drv->pm->restore)
  255. ret = drv->pm->restore(dev);
  256. } else {
  257. ret = amba_legacy_resume(dev);
  258. }
  259. return ret;
  260. }
  261. static int amba_pm_restore_noirq(struct device *dev)
  262. {
  263. struct device_driver *drv = dev->driver;
  264. int ret = 0;
  265. if (!drv)
  266. return 0;
  267. if (drv->pm) {
  268. if (drv->pm->restore_noirq)
  269. ret = drv->pm->restore_noirq(dev);
  270. }
  271. return ret;
  272. }
  273. #else /* !CONFIG_HIBERNATE_CALLBACKS */
  274. #define amba_pm_freeze NULL
  275. #define amba_pm_thaw NULL
  276. #define amba_pm_poweroff NULL
  277. #define amba_pm_restore NULL
  278. #define amba_pm_freeze_noirq NULL
  279. #define amba_pm_thaw_noirq NULL
  280. #define amba_pm_poweroff_noirq NULL
  281. #define amba_pm_restore_noirq NULL
  282. #endif /* !CONFIG_HIBERNATE_CALLBACKS */
  283. #ifdef CONFIG_PM_RUNTIME
  284. /*
  285. * Hooks to provide runtime PM of the pclk (bus clock). It is safe to
  286. * enable/disable the bus clock at runtime PM suspend/resume as this
  287. * does not result in loss of context. However, disabling vcore power
  288. * would do, so we leave that to the driver.
  289. */
  290. static int amba_pm_runtime_suspend(struct device *dev)
  291. {
  292. struct amba_device *pcdev = to_amba_device(dev);
  293. int ret = pm_generic_runtime_suspend(dev);
  294. if (ret == 0 && dev->driver)
  295. clk_disable(pcdev->pclk);
  296. return ret;
  297. }
  298. static int amba_pm_runtime_resume(struct device *dev)
  299. {
  300. struct amba_device *pcdev = to_amba_device(dev);
  301. int ret;
  302. if (dev->driver) {
  303. ret = clk_enable(pcdev->pclk);
  304. /* Failure is probably fatal to the system, but... */
  305. if (ret)
  306. return ret;
  307. }
  308. return pm_generic_runtime_resume(dev);
  309. }
  310. #endif
  311. #ifdef CONFIG_PM
  312. static const struct dev_pm_ops amba_pm = {
  313. .prepare = amba_pm_prepare,
  314. .complete = amba_pm_complete,
  315. .suspend = amba_pm_suspend,
  316. .resume = amba_pm_resume,
  317. .freeze = amba_pm_freeze,
  318. .thaw = amba_pm_thaw,
  319. .poweroff = amba_pm_poweroff,
  320. .restore = amba_pm_restore,
  321. .suspend_noirq = amba_pm_suspend_noirq,
  322. .resume_noirq = amba_pm_resume_noirq,
  323. .freeze_noirq = amba_pm_freeze_noirq,
  324. .thaw_noirq = amba_pm_thaw_noirq,
  325. .poweroff_noirq = amba_pm_poweroff_noirq,
  326. .restore_noirq = amba_pm_restore_noirq,
  327. SET_RUNTIME_PM_OPS(
  328. amba_pm_runtime_suspend,
  329. amba_pm_runtime_resume,
  330. pm_generic_runtime_idle
  331. )
  332. };
  333. #define AMBA_PM (&amba_pm)
  334. #else /* !CONFIG_PM */
  335. #define AMBA_PM NULL
  336. #endif /* !CONFIG_PM */
  337. /*
  338. * Primecells are part of the Advanced Microcontroller Bus Architecture,
  339. * so we call the bus "amba".
  340. */
  341. struct bus_type amba_bustype = {
  342. .name = "amba",
  343. .dev_attrs = amba_dev_attrs,
  344. .match = amba_match,
  345. .uevent = amba_uevent,
  346. .pm = AMBA_PM,
  347. };
  348. static int __init amba_init(void)
  349. {
  350. return bus_register(&amba_bustype);
  351. }
  352. postcore_initcall(amba_init);
  353. static int amba_get_enable_pclk(struct amba_device *pcdev)
  354. {
  355. struct clk *pclk = clk_get(&pcdev->dev, "apb_pclk");
  356. int ret;
  357. pcdev->pclk = pclk;
  358. if (IS_ERR(pclk))
  359. return PTR_ERR(pclk);
  360. ret = clk_prepare(pclk);
  361. if (ret) {
  362. clk_put(pclk);
  363. return ret;
  364. }
  365. ret = clk_enable(pclk);
  366. if (ret) {
  367. clk_unprepare(pclk);
  368. clk_put(pclk);
  369. }
  370. return ret;
  371. }
  372. static void amba_put_disable_pclk(struct amba_device *pcdev)
  373. {
  374. struct clk *pclk = pcdev->pclk;
  375. clk_disable(pclk);
  376. clk_unprepare(pclk);
  377. clk_put(pclk);
  378. }
  379. static int amba_get_enable_vcore(struct amba_device *pcdev)
  380. {
  381. struct regulator *vcore = regulator_get(&pcdev->dev, "vcore");
  382. int ret;
  383. pcdev->vcore = vcore;
  384. if (IS_ERR(vcore)) {
  385. /* It is OK not to supply a vcore regulator */
  386. if (PTR_ERR(vcore) == -ENODEV)
  387. return 0;
  388. return PTR_ERR(vcore);
  389. }
  390. ret = regulator_enable(vcore);
  391. if (ret) {
  392. regulator_put(vcore);
  393. pcdev->vcore = ERR_PTR(-ENODEV);
  394. }
  395. return ret;
  396. }
  397. static void amba_put_disable_vcore(struct amba_device *pcdev)
  398. {
  399. struct regulator *vcore = pcdev->vcore;
  400. if (!IS_ERR(vcore)) {
  401. regulator_disable(vcore);
  402. regulator_put(vcore);
  403. }
  404. }
  405. /*
  406. * These are the device model conversion veneers; they convert the
  407. * device model structures to our more specific structures.
  408. */
  409. static int amba_probe(struct device *dev)
  410. {
  411. struct amba_device *pcdev = to_amba_device(dev);
  412. struct amba_driver *pcdrv = to_amba_driver(dev->driver);
  413. const struct amba_id *id = amba_lookup(pcdrv->id_table, pcdev);
  414. int ret;
  415. do {
  416. ret = amba_get_enable_vcore(pcdev);
  417. if (ret)
  418. break;
  419. ret = amba_get_enable_pclk(pcdev);
  420. if (ret)
  421. break;
  422. pm_runtime_get_noresume(dev);
  423. pm_runtime_set_active(dev);
  424. pm_runtime_enable(dev);
  425. ret = pcdrv->probe(pcdev, id);
  426. if (ret == 0)
  427. break;
  428. pm_runtime_disable(dev);
  429. pm_runtime_set_suspended(dev);
  430. pm_runtime_put_noidle(dev);
  431. amba_put_disable_pclk(pcdev);
  432. amba_put_disable_vcore(pcdev);
  433. } while (0);
  434. return ret;
  435. }
  436. static int amba_remove(struct device *dev)
  437. {
  438. struct amba_device *pcdev = to_amba_device(dev);
  439. struct amba_driver *drv = to_amba_driver(dev->driver);
  440. int ret;
  441. pm_runtime_get_sync(dev);
  442. ret = drv->remove(pcdev);
  443. pm_runtime_put_noidle(dev);
  444. /* Undo the runtime PM settings in amba_probe() */
  445. pm_runtime_disable(dev);
  446. pm_runtime_set_suspended(dev);
  447. pm_runtime_put_noidle(dev);
  448. amba_put_disable_pclk(pcdev);
  449. amba_put_disable_vcore(pcdev);
  450. return ret;
  451. }
  452. static void amba_shutdown(struct device *dev)
  453. {
  454. struct amba_driver *drv = to_amba_driver(dev->driver);
  455. drv->shutdown(to_amba_device(dev));
  456. }
  457. /**
  458. * amba_driver_register - register an AMBA device driver
  459. * @drv: amba device driver structure
  460. *
  461. * Register an AMBA device driver with the Linux device model
  462. * core. If devices pre-exist, the drivers probe function will
  463. * be called.
  464. */
  465. int amba_driver_register(struct amba_driver *drv)
  466. {
  467. drv->drv.bus = &amba_bustype;
  468. #define SETFN(fn) if (drv->fn) drv->drv.fn = amba_##fn
  469. SETFN(probe);
  470. SETFN(remove);
  471. SETFN(shutdown);
  472. return driver_register(&drv->drv);
  473. }
  474. /**
  475. * amba_driver_unregister - remove an AMBA device driver
  476. * @drv: AMBA device driver structure to remove
  477. *
  478. * Unregister an AMBA device driver from the Linux device
  479. * model. The device model will call the drivers remove function
  480. * for each device the device driver is currently handling.
  481. */
  482. void amba_driver_unregister(struct amba_driver *drv)
  483. {
  484. driver_unregister(&drv->drv);
  485. }
  486. static void amba_device_release(struct device *dev)
  487. {
  488. struct amba_device *d = to_amba_device(dev);
  489. if (d->res.parent)
  490. release_resource(&d->res);
  491. kfree(d);
  492. }
  493. /**
  494. * amba_device_register - register an AMBA device
  495. * @dev: AMBA device to register
  496. * @parent: parent memory resource
  497. *
  498. * Setup the AMBA device, reading the cell ID if present.
  499. * Claim the resource, and register the AMBA device with
  500. * the Linux device manager.
  501. */
  502. int amba_device_register(struct amba_device *dev, struct resource *parent)
  503. {
  504. u32 size;
  505. void __iomem *tmp;
  506. int i, ret;
  507. device_initialize(&dev->dev);
  508. /*
  509. * Copy from device_add
  510. */
  511. if (dev->dev.init_name) {
  512. dev_set_name(&dev->dev, "%s", dev->dev.init_name);
  513. dev->dev.init_name = NULL;
  514. }
  515. dev->dev.release = amba_device_release;
  516. dev->dev.bus = &amba_bustype;
  517. dev->dev.dma_mask = &dev->dma_mask;
  518. dev->res.name = dev_name(&dev->dev);
  519. if (!dev->dev.coherent_dma_mask && dev->dma_mask)
  520. dev_warn(&dev->dev, "coherent dma mask is unset\n");
  521. ret = request_resource(parent, &dev->res);
  522. if (ret)
  523. goto err_out;
  524. /* Hard-coded primecell ID instead of plug-n-play */
  525. if (dev->periphid != 0)
  526. goto skip_probe;
  527. /*
  528. * Dynamically calculate the size of the resource
  529. * and use this for iomap
  530. */
  531. size = resource_size(&dev->res);
  532. tmp = ioremap(dev->res.start, size);
  533. if (!tmp) {
  534. ret = -ENOMEM;
  535. goto err_release;
  536. }
  537. ret = amba_get_enable_pclk(dev);
  538. if (ret == 0) {
  539. u32 pid, cid;
  540. /*
  541. * Read pid and cid based on size of resource
  542. * they are located at end of region
  543. */
  544. for (pid = 0, i = 0; i < 4; i++)
  545. pid |= (readl(tmp + size - 0x20 + 4 * i) & 255) <<
  546. (i * 8);
  547. for (cid = 0, i = 0; i < 4; i++)
  548. cid |= (readl(tmp + size - 0x10 + 4 * i) & 255) <<
  549. (i * 8);
  550. amba_put_disable_pclk(dev);
  551. if (cid == AMBA_CID)
  552. dev->periphid = pid;
  553. if (!dev->periphid)
  554. ret = -ENODEV;
  555. }
  556. iounmap(tmp);
  557. if (ret)
  558. goto err_release;
  559. skip_probe:
  560. ret = device_add(&dev->dev);
  561. if (ret)
  562. goto err_release;
  563. if (dev->irq[0] != NO_IRQ)
  564. ret = device_create_file(&dev->dev, &dev_attr_irq0);
  565. if (ret == 0 && dev->irq[1] != NO_IRQ)
  566. ret = device_create_file(&dev->dev, &dev_attr_irq1);
  567. if (ret == 0)
  568. return ret;
  569. device_unregister(&dev->dev);
  570. err_release:
  571. release_resource(&dev->res);
  572. err_out:
  573. return ret;
  574. }
  575. /**
  576. * amba_device_unregister - unregister an AMBA device
  577. * @dev: AMBA device to remove
  578. *
  579. * Remove the specified AMBA device from the Linux device
  580. * manager. All files associated with this object will be
  581. * destroyed, and device drivers notified that the device has
  582. * been removed. The AMBA device's resources including
  583. * the amba_device structure will be freed once all
  584. * references to it have been dropped.
  585. */
  586. void amba_device_unregister(struct amba_device *dev)
  587. {
  588. device_unregister(&dev->dev);
  589. }
  590. struct find_data {
  591. struct amba_device *dev;
  592. struct device *parent;
  593. const char *busid;
  594. unsigned int id;
  595. unsigned int mask;
  596. };
  597. static int amba_find_match(struct device *dev, void *data)
  598. {
  599. struct find_data *d = data;
  600. struct amba_device *pcdev = to_amba_device(dev);
  601. int r;
  602. r = (pcdev->periphid & d->mask) == d->id;
  603. if (d->parent)
  604. r &= d->parent == dev->parent;
  605. if (d->busid)
  606. r &= strcmp(dev_name(dev), d->busid) == 0;
  607. if (r) {
  608. get_device(dev);
  609. d->dev = pcdev;
  610. }
  611. return r;
  612. }
  613. /**
  614. * amba_find_device - locate an AMBA device given a bus id
  615. * @busid: bus id for device (or NULL)
  616. * @parent: parent device (or NULL)
  617. * @id: peripheral ID (or 0)
  618. * @mask: peripheral ID mask (or 0)
  619. *
  620. * Return the AMBA device corresponding to the supplied parameters.
  621. * If no device matches, returns NULL.
  622. *
  623. * NOTE: When a valid device is found, its refcount is
  624. * incremented, and must be decremented before the returned
  625. * reference.
  626. */
  627. struct amba_device *
  628. amba_find_device(const char *busid, struct device *parent, unsigned int id,
  629. unsigned int mask)
  630. {
  631. struct find_data data;
  632. data.dev = NULL;
  633. data.parent = parent;
  634. data.busid = busid;
  635. data.id = id;
  636. data.mask = mask;
  637. bus_for_each_dev(&amba_bustype, NULL, &data, amba_find_match);
  638. return data.dev;
  639. }
  640. /**
  641. * amba_request_regions - request all mem regions associated with device
  642. * @dev: amba_device structure for device
  643. * @name: name, or NULL to use driver name
  644. */
  645. int amba_request_regions(struct amba_device *dev, const char *name)
  646. {
  647. int ret = 0;
  648. u32 size;
  649. if (!name)
  650. name = dev->dev.driver->name;
  651. size = resource_size(&dev->res);
  652. if (!request_mem_region(dev->res.start, size, name))
  653. ret = -EBUSY;
  654. return ret;
  655. }
  656. /**
  657. * amba_release_regions - release mem regions associated with device
  658. * @dev: amba_device structure for device
  659. *
  660. * Release regions claimed by a successful call to amba_request_regions.
  661. */
  662. void amba_release_regions(struct amba_device *dev)
  663. {
  664. u32 size;
  665. size = resource_size(&dev->res);
  666. release_mem_region(dev->res.start, size);
  667. }
  668. EXPORT_SYMBOL(amba_driver_register);
  669. EXPORT_SYMBOL(amba_driver_unregister);
  670. EXPORT_SYMBOL(amba_device_register);
  671. EXPORT_SYMBOL(amba_device_unregister);
  672. EXPORT_SYMBOL(amba_find_device);
  673. EXPORT_SYMBOL(amba_request_regions);
  674. EXPORT_SYMBOL(amba_release_regions);