soundwire.c 27 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * Copyright (c) 2015-2020, The Linux Foundation. All rights reserved.
  4. */
  5. #include <linux/kernel.h>
  6. #include <linux/module.h>
  7. #include <linux/errno.h>
  8. #include <linux/slab.h>
  9. #include <linux/init.h>
  10. #include <linux/types.h>
  11. #include <linux/of_device.h>
  12. #include <linux/completion.h>
  13. #include <linux/idr.h>
  14. #include <linux/pm_runtime.h>
  15. #include <soc/soundwire.h>
  16. struct boardinfo {
  17. struct list_head list;
  18. struct swr_boardinfo board_info;
  19. };
  20. static LIST_HEAD(board_list);
  21. static LIST_HEAD(swr_master_list);
  22. static DEFINE_MUTEX(board_lock);
  23. static DEFINE_IDR(master_idr);
  24. static DEFINE_MUTEX(swr_lock);
  25. static struct device_type swr_dev_type;
  26. #define SOUNDWIRE_NAME_SIZE 32
  27. static void swr_master_put(struct swr_master *master)
  28. {
  29. if (master)
  30. put_device(&master->dev);
  31. }
  32. static struct swr_master *swr_master_get(struct swr_master *master)
  33. {
  34. if (!master || !get_device(&master->dev))
  35. return NULL;
  36. return master;
  37. }
  38. static void swr_dev_release(struct device *dev)
  39. {
  40. struct swr_device *swr_dev = to_swr_device(dev);
  41. struct swr_master *master;
  42. if (!swr_dev)
  43. return;
  44. master = swr_dev->master;
  45. if (!master)
  46. return;
  47. mutex_lock(&master->mlock);
  48. list_del_init(&swr_dev->dev_list);
  49. mutex_unlock(&master->mlock);
  50. swr_master_put(swr_dev->master);
  51. kfree(swr_dev);
  52. }
  53. /**
  54. * swr_remove_device - remove a soundwire device
  55. * @swr_dev: soundwire device to remove
  56. *
  57. * Remove a soundwire device. Go through the soundwire
  58. * device list that master has and remove swr_dev from
  59. * it.
  60. */
  61. void swr_remove_device(struct swr_device *swr_dev)
  62. {
  63. struct swr_device *swr_dev_loop, *safe;
  64. /*
  65. * master still has reference to all nodes and deletes
  66. * at platform_unregister, so need to init the deleted
  67. * entry
  68. */
  69. list_for_each_entry_safe(swr_dev_loop, safe,
  70. &swr_dev->master->devices,
  71. dev_list) {
  72. if (swr_dev == swr_dev_loop)
  73. list_del_init(&swr_dev_loop->dev_list);
  74. }
  75. }
  76. EXPORT_SYMBOL(swr_remove_device);
  77. /**
  78. * swr_new_device - instantiate a new soundwire device
  79. * @master: Controller to which device is connected
  80. * @info: Describes the soundwire device
  81. * Context: can sleep
  82. *
  83. * Create a soundwire device. Binding is handled through driver model
  84. * probe/remove methods. A driver may be bound to this device when
  85. * the function gets returned.
  86. *
  87. * Returns a soundwire new device or NULL
  88. */
  89. struct swr_device *swr_new_device(struct swr_master *master,
  90. struct swr_boardinfo const *info)
  91. {
  92. int result;
  93. struct swr_device *swr;
  94. if (!master || !swr_master_get(master)) {
  95. pr_err("%s: master is NULL\n", __func__);
  96. return NULL;
  97. }
  98. swr = kzalloc(sizeof(*swr), GFP_KERNEL);
  99. if (!swr) {
  100. put_device(&master->dev);
  101. return NULL;
  102. }
  103. swr->master = master;
  104. swr->addr = info->addr;
  105. strlcpy(swr->name, info->name, sizeof(swr->name));
  106. swr->dev.type = &swr_dev_type;
  107. swr->dev.parent = &master->dev;
  108. swr->dev.bus = &soundwire_type;
  109. swr->dev.release = swr_dev_release;
  110. swr->dev.of_node = info->of_node;
  111. mutex_lock(&master->mlock);
  112. list_add_tail(&swr->dev_list, &master->devices);
  113. mutex_unlock(&master->mlock);
  114. dev_set_name(&swr->dev, "%s.%lx", swr->name, swr->addr);
  115. result = device_register(&swr->dev);
  116. if (result) {
  117. dev_err(&master->dev, "device [%s] register failed err %d\n",
  118. swr->name, result);
  119. goto err_out;
  120. }
  121. dev_dbg(&master->dev, "Device [%s] registered with bus id %s\n",
  122. swr->name, dev_name(&swr->dev));
  123. return swr;
  124. err_out:
  125. dev_dbg(&master->dev, "Failed to register swr device %s at 0x%lx %d\n",
  126. swr->name, swr->addr, result);
  127. swr_master_put(master);
  128. list_del_init(&swr->dev_list);
  129. kfree(swr);
  130. return NULL;
  131. }
  132. EXPORT_SYMBOL(swr_new_device);
  133. /**
  134. * of_register_swr_devices - register child devices on to the soundwire bus
  135. * @master: pointer to soundwire master device
  136. *
  137. * Registers a soundwire device for each child node of master node which has
  138. * a "swr-devid" property
  139. *
  140. */
  141. int of_register_swr_devices(struct swr_master *master)
  142. {
  143. struct swr_device *swr;
  144. struct device_node *node;
  145. if (!master->dev.of_node)
  146. return -EINVAL;
  147. for_each_available_child_of_node(master->dev.of_node, node) {
  148. struct swr_boardinfo info = {};
  149. u64 addr;
  150. dev_dbg(&master->dev, "of_swr:register %s\n", node->full_name);
  151. if (of_modalias_node(node, info.name, sizeof(info.name)) < 0) {
  152. dev_err(&master->dev, "of_swr:modalias failure %s\n",
  153. node->full_name);
  154. continue;
  155. }
  156. if (of_property_read_u64(node, "reg", &addr)) {
  157. dev_err(&master->dev, "of_swr:invalid reg %s\n",
  158. node->full_name);
  159. continue;
  160. }
  161. info.addr = addr;
  162. info.of_node = of_node_get(node);
  163. swr = swr_new_device(master, &info);
  164. if (!swr) {
  165. dev_err(&master->dev, "of_swr: Register failed %s\n",
  166. node->full_name);
  167. of_node_put(node);
  168. continue;
  169. }
  170. }
  171. return 0;
  172. }
  173. EXPORT_SYMBOL(of_register_swr_devices);
  174. /**
  175. * swr_port_response - response from master to free the completed transaction
  176. * @mstr: pointer to soundwire master device
  177. * @tid: transaction id that indicates transaction to be freed.
  178. *
  179. * Master calls this function to free the compeleted transaction memory
  180. */
  181. void swr_port_response(struct swr_master *mstr, u8 tid)
  182. {
  183. struct swr_params *txn;
  184. txn = mstr->port_txn[tid];
  185. if (txn == NULL) {
  186. dev_err(&mstr->dev, "%s: transaction is already NULL\n",
  187. __func__);
  188. return;
  189. }
  190. mstr->port_txn[tid] = NULL;
  191. kfree(txn);
  192. }
  193. EXPORT_SYMBOL(swr_port_response);
  194. /**
  195. * swr_remove_from_group - remove soundwire slave devices from group
  196. * @dev: pointer to the soundwire slave device
  197. * dev_num: device number of the soundwire slave device
  198. *
  199. * Returns error code for failure and 0 for success
  200. */
  201. int swr_remove_from_group(struct swr_device *dev, u8 dev_num)
  202. {
  203. struct swr_master *master;
  204. if (!dev)
  205. return -ENODEV;
  206. master = dev->master;
  207. if (!master)
  208. return -EINVAL;
  209. if (!dev->group_id)
  210. return 0;
  211. if (master->gr_sid != dev_num)
  212. return 0;
  213. if (master->remove_from_group && master->remove_from_group(master))
  214. dev_dbg(&master->dev, "%s: falling back to GROUP_NONE\n",
  215. __func__);
  216. return 0;
  217. }
  218. EXPORT_SYMBOL(swr_remove_from_group);
  219. /**
  220. * swr_slvdev_datapath_control - Enables/Disables soundwire slave device
  221. * data path
  222. * @dev: pointer to soundwire slave device
  223. * @dev_num: device number of the soundwire slave device
  224. *
  225. * Returns error code for failure and 0 for success
  226. */
  227. int swr_slvdev_datapath_control(struct swr_device *dev, u8 dev_num,
  228. bool enable)
  229. {
  230. struct swr_master *master;
  231. int ret = 0;
  232. if (!dev)
  233. return -ENODEV;
  234. master = dev->master;
  235. if (!master)
  236. return -EINVAL;
  237. if (dev->group_id) {
  238. /* Broadcast */
  239. if (master->gr_sid != dev_num) {
  240. if (!master->gr_sid)
  241. master->gr_sid = dev_num;
  242. else
  243. return 0;
  244. }
  245. }
  246. if (master->slvdev_datapath_control)
  247. ret = master->slvdev_datapath_control(master, enable);
  248. return ret;
  249. }
  250. EXPORT_SYMBOL(swr_slvdev_datapath_control);
  251. /**
  252. * swr_connect_port - enable soundwire slave port(s)
  253. * @dev: pointer to soundwire slave device
  254. * @port_id: logical port id(s) of soundwire slave device
  255. * @num_port: number of slave device ports need to be enabled
  256. * @ch_mask: channels for each port that needs to be enabled
  257. * @ch_rate: rate at which each port/channels operate
  258. * @num_ch: number of channels for each port
  259. *
  260. * soundwire slave device call swr_connect_port API to enable all/some of
  261. * its ports and corresponding channels and channel rate. This API will
  262. * call master connect_port callback function to calculate frame structure
  263. * and enable master and slave ports
  264. */
  265. int swr_connect_port(struct swr_device *dev, u8 *port_id, u8 num_port,
  266. u8 *ch_mask, u32 *ch_rate, u8 *num_ch, u8 *port_type)
  267. {
  268. u8 i = 0;
  269. int ret = 0;
  270. struct swr_params *txn = NULL;
  271. struct swr_params **temp_txn = NULL;
  272. struct swr_master *master = dev->master;
  273. if (!master) {
  274. pr_err("%s: Master is NULL\n", __func__);
  275. return -EINVAL;
  276. }
  277. if (num_port > SWR_MAX_DEV_PORT_NUM) {
  278. dev_err(&master->dev, "%s: num_port %d exceeds max port %d\n",
  279. __func__, num_port, SWR_MAX_DEV_PORT_NUM);
  280. return -EINVAL;
  281. }
  282. /*
  283. * create "txn" to accommodate ports enablement of
  284. * different slave devices calling swr_connect_port at the
  285. * same time. Once master process the txn data, it calls
  286. * swr_port_response() to free the transaction. Maximum
  287. * of 256 transactions can be allocated.
  288. */
  289. txn = kzalloc(sizeof(struct swr_params), GFP_KERNEL);
  290. if (!txn)
  291. return -ENOMEM;
  292. mutex_lock(&master->mlock);
  293. for (i = 0; i < master->last_tid; i++) {
  294. if (master->port_txn[i] == NULL)
  295. break;
  296. }
  297. if (i >= master->last_tid) {
  298. if (master->last_tid == 255) {
  299. mutex_unlock(&master->mlock);
  300. kfree(txn);
  301. dev_err(&master->dev, "%s Max tid reached\n",
  302. __func__);
  303. return -ENOMEM;
  304. }
  305. temp_txn = krealloc(master->port_txn,
  306. (i + 1) * sizeof(struct swr_params *),
  307. GFP_KERNEL);
  308. if (!temp_txn) {
  309. mutex_unlock(&master->mlock);
  310. kfree(txn);
  311. dev_err(&master->dev, "%s Not able to allocate\n"
  312. "master port transaction memory\n",
  313. __func__);
  314. return -ENOMEM;
  315. }
  316. master->port_txn = temp_txn;
  317. master->last_tid++;
  318. }
  319. master->port_txn[i] = txn;
  320. mutex_unlock(&master->mlock);
  321. txn->tid = i;
  322. txn->dev_num = dev->dev_num;
  323. txn->num_port = num_port;
  324. for (i = 0; i < num_port; i++) {
  325. txn->port_id[i] = port_id[i];
  326. txn->num_ch[i] = num_ch[i];
  327. txn->ch_rate[i] = ch_rate[i];
  328. txn->ch_en[i] = ch_mask[i];
  329. txn->port_type[i] = port_type[i];
  330. }
  331. ret = master->connect_port(master, txn);
  332. return ret;
  333. }
  334. EXPORT_SYMBOL(swr_connect_port);
  335. /**
  336. * swr_disconnect_port - disable soundwire slave port(s)
  337. * @dev: pointer to soundwire slave device
  338. * @port_id: logical port id(s) of soundwire slave device
  339. * @num_port: number of slave device ports need to be disabled
  340. *
  341. * soundwire slave device call swr_disconnect_port API to disable all/some of
  342. * its ports. This API will call master disconnect_port callback function to
  343. * disable master and slave port and (re)configure frame structure
  344. */
  345. int swr_disconnect_port(struct swr_device *dev, u8 *port_id, u8 num_port,
  346. u8 *ch_mask, u8 *port_type)
  347. {
  348. u8 i = 0;
  349. int ret;
  350. struct swr_params *txn = NULL;
  351. struct swr_params **temp_txn = NULL;
  352. struct swr_master *master = dev->master;
  353. if (!master) {
  354. pr_err("%s: Master is NULL\n", __func__);
  355. return -EINVAL;
  356. }
  357. if (num_port > SWR_MAX_DEV_PORT_NUM) {
  358. dev_err(&master->dev, "%s: num_port %d exceeds max port %d\n",
  359. __func__, num_port, SWR_MAX_DEV_PORT_NUM);
  360. return -EINVAL;
  361. }
  362. txn = kzalloc(sizeof(struct swr_params), GFP_KERNEL);
  363. if (!txn)
  364. return -ENOMEM;
  365. mutex_lock(&master->mlock);
  366. for (i = 0; i < master->last_tid; i++) {
  367. if (master->port_txn[i] == NULL)
  368. break;
  369. }
  370. if (i >= master->last_tid) {
  371. if (master->last_tid == 255) {
  372. mutex_unlock(&master->mlock);
  373. kfree(txn);
  374. dev_err(&master->dev, "%s Max tid reached\n",
  375. __func__);
  376. return -ENOMEM;
  377. }
  378. temp_txn = krealloc(master->port_txn,
  379. (i + 1) * sizeof(struct swr_params *),
  380. GFP_KERNEL);
  381. if (!temp_txn) {
  382. mutex_unlock(&master->mlock);
  383. kfree(txn);
  384. dev_err(&master->dev, "%s Not able to allocate\n"
  385. "master port transaction memory\n",
  386. __func__);
  387. return -ENOMEM;
  388. }
  389. master->port_txn = temp_txn;
  390. master->last_tid++;
  391. }
  392. master->port_txn[i] = txn;
  393. mutex_unlock(&master->mlock);
  394. txn->tid = i;
  395. txn->dev_num = dev->dev_num;
  396. txn->num_port = num_port;
  397. for (i = 0; i < num_port; i++) {
  398. txn->port_id[i] = port_id[i];
  399. txn->ch_en[i] = ch_mask[i];
  400. txn->port_type[i] = port_type[i];
  401. }
  402. ret = master->disconnect_port(master, txn);
  403. return ret;
  404. }
  405. EXPORT_SYMBOL(swr_disconnect_port);
  406. /**
  407. * swr_get_logical_dev_num - Get soundwire slave logical device number
  408. * @dev: pointer to soundwire slave device
  409. * @dev_id: physical device id of soundwire slave device
  410. * @dev_num: pointer to logical device num of soundwire slave device
  411. *
  412. * This API will get the logical device number of soundwire slave device
  413. */
  414. int swr_get_logical_dev_num(struct swr_device *dev, u64 dev_id,
  415. u8 *dev_num)
  416. {
  417. int ret = 0;
  418. struct swr_master *master = dev->master;
  419. if (!master) {
  420. pr_err("%s: Master is NULL\n", __func__);
  421. return -EINVAL;
  422. }
  423. mutex_lock(&master->mlock);
  424. ret = master->get_logical_dev_num(master, dev_id, dev_num);
  425. mutex_unlock(&master->mlock);
  426. return ret;
  427. }
  428. EXPORT_SYMBOL(swr_get_logical_dev_num);
  429. /**
  430. * swr_init_port_params - soundwire slave port params set
  431. * @dev: pointer to soundwire slave device
  432. * @num_ports: number of slave ports
  433. * @pp: port params for all ports for all usecases
  434. *
  435. * This API will set soundwire port params from slave
  436. */
  437. int swr_init_port_params(struct swr_device *dev,
  438. u32 num_ports, struct swr_dev_frame_config *pp)
  439. {
  440. int ret = 0;
  441. struct swr_master *master = dev->master;
  442. if (!master) {
  443. pr_err("%s: Master is NULL\n", __func__);
  444. return -EINVAL;
  445. }
  446. mutex_lock(&master->mlock);
  447. ret = master->init_port_params(master, dev->dev_num,
  448. num_ports, pp);
  449. mutex_unlock(&master->mlock);
  450. return ret;
  451. }
  452. EXPORT_SYMBOL(swr_init_port_params);
  453. /**
  454. * swr_device_wakeup_vote - Wakeup master and slave devices from clock stop
  455. * @dev: pointer to soundwire slave device
  456. *
  457. * This API will wake up soundwire master and slave device(s) from
  458. * clock stop.
  459. */
  460. int swr_device_wakeup_vote(struct swr_device *dev)
  461. {
  462. int ret = 0;
  463. struct swr_master *master = dev->master;
  464. if (!master) {
  465. pr_err("%s: Master is NULL\n", __func__);
  466. return -EINVAL;
  467. }
  468. mutex_lock(&master->mlock);
  469. if (master->device_wakeup_vote)
  470. master->device_wakeup_vote(master);
  471. else
  472. ret = -EINVAL;
  473. mutex_unlock(&master->mlock);
  474. return ret;
  475. }
  476. EXPORT_SYMBOL(swr_device_wakeup_vote);
  477. /**
  478. * swr_device_wakeup_unvote - Unvote Wakeup so that master and slave
  479. * devices can go back to clock stop
  480. * @dev: pointer to soundwire slave device
  481. *
  482. * This API will remove vote for wakeup so that soundwire master and
  483. * slave device(s) can go back to clock stop.
  484. */
  485. int swr_device_wakeup_unvote(struct swr_device *dev)
  486. {
  487. int ret = 0;
  488. struct swr_master *master = dev->master;
  489. if (!master) {
  490. pr_err("%s: Master is NULL\n", __func__);
  491. return -EINVAL;
  492. }
  493. mutex_lock(&master->mlock);
  494. if (master->device_wakeup_unvote)
  495. master->device_wakeup_unvote(master);
  496. else
  497. ret = -EINVAL;
  498. mutex_unlock(&master->mlock);
  499. return ret;
  500. }
  501. EXPORT_SYMBOL(swr_device_wakeup_unvote);
  502. /**
  503. * swr_read - read soundwire slave device registers
  504. * @dev: pointer to soundwire slave device
  505. * @dev_num: logical device num of soundwire slave device
  506. * @reg_addr: base register address that needs to be read
  507. * @buf: pointer to store the values of registers from base address
  508. * @len: length of the buffer
  509. *
  510. * This API will read the value of the register address from
  511. * soundwire slave device
  512. */
  513. int swr_read(struct swr_device *dev, u8 dev_num, u16 reg_addr,
  514. void *buf, u32 len)
  515. {
  516. struct swr_master *master = dev->master;
  517. if (!master)
  518. return -EINVAL;
  519. return master->read(master, dev_num, reg_addr, buf, len);
  520. }
  521. EXPORT_SYMBOL(swr_read);
  522. /**
  523. * swr_bulk_write - write soundwire slave device registers
  524. * @dev: pointer to soundwire slave device
  525. * @dev_num: logical device num of soundwire slave device
  526. * @reg_addr: register address of soundwire slave device
  527. * @buf: contains value of register address
  528. * @len: indicates number of registers
  529. *
  530. * This API will write the value of the register address to
  531. * soundwire slave device
  532. */
  533. int swr_bulk_write(struct swr_device *dev, u8 dev_num, void *reg,
  534. const void *buf, size_t len)
  535. {
  536. struct swr_master *master;
  537. if (!dev || !dev->master)
  538. return -EINVAL;
  539. master = dev->master;
  540. if (dev->group_id) {
  541. if (master->gr_sid != dev_num) {
  542. if (!master->gr_sid)
  543. master->gr_sid = dev_num;
  544. else
  545. return 0;
  546. }
  547. dev_num = dev->group_id;
  548. }
  549. if (master->bulk_write)
  550. return master->bulk_write(master, dev_num, reg, buf, len);
  551. return -EOPNOTSUPP;
  552. }
  553. EXPORT_SYMBOL(swr_bulk_write);
  554. /**
  555. * swr_write - write soundwire slave device registers
  556. * @dev: pointer to soundwire slave device
  557. * @dev_num: logical device num of soundwire slave device
  558. * @reg_addr: register address of soundwire slave device
  559. * @buf: contains value of register address
  560. *
  561. * This API will write the value of the register address to
  562. * soundwire slave device
  563. */
  564. int swr_write(struct swr_device *dev, u8 dev_num, u16 reg_addr,
  565. const void *buf)
  566. {
  567. struct swr_master *master = dev->master;
  568. if (!master)
  569. return -EINVAL;
  570. if (dev->group_id) {
  571. if (master->gr_sid != dev_num) {
  572. if (!master->gr_sid)
  573. master->gr_sid = dev_num;
  574. else
  575. return 0;
  576. }
  577. dev_num = dev->group_id;
  578. }
  579. return master->write(master, dev_num, reg_addr, buf);
  580. }
  581. EXPORT_SYMBOL(swr_write);
  582. /**
  583. * swr_device_up - Function to bringup the soundwire slave device
  584. * @swr_dev: pointer to soundwire slave device
  585. * Context: can sleep
  586. *
  587. * This API will be called by soundwire master to bringup the slave
  588. * device.
  589. */
  590. int swr_device_up(struct swr_device *swr_dev)
  591. {
  592. struct device *dev;
  593. const struct swr_driver *sdrv;
  594. if (!swr_dev)
  595. return -EINVAL;
  596. dev = &swr_dev->dev;
  597. sdrv = to_swr_driver(dev->driver);
  598. if (!sdrv)
  599. return 0;
  600. if (sdrv->device_up)
  601. return sdrv->device_up(to_swr_device(dev));
  602. return -ENODEV;
  603. }
  604. EXPORT_SYMBOL(swr_device_up);
  605. /**
  606. * swr_device_down - Function to call soundwire slave device down
  607. * @swr_dev: pointer to soundwire slave device
  608. * Context: can sleep
  609. *
  610. * This API will be called by soundwire master to put slave device in
  611. * shutdown state.
  612. */
  613. int swr_device_down(struct swr_device *swr_dev)
  614. {
  615. struct device *dev;
  616. const struct swr_driver *sdrv;
  617. if (!swr_dev)
  618. return -EINVAL;
  619. dev = &swr_dev->dev;
  620. sdrv = to_swr_driver(dev->driver);
  621. if (!sdrv)
  622. return 0;
  623. if (sdrv->device_down)
  624. return sdrv->device_down(to_swr_device(dev));
  625. return -ENODEV;
  626. }
  627. EXPORT_SYMBOL(swr_device_down);
  628. /**
  629. * swr_reset_device - reset soundwire slave device
  630. * @swr_dev: pointer to soundwire slave device
  631. * Context: can sleep
  632. *
  633. * This API will be called by soundwire master to reset the slave
  634. * device when the slave device is not responding or in undefined
  635. * state
  636. */
  637. int swr_reset_device(struct swr_device *swr_dev)
  638. {
  639. struct device *dev;
  640. const struct swr_driver *sdrv;
  641. if (!swr_dev)
  642. return -EINVAL;
  643. dev = &swr_dev->dev;
  644. sdrv = to_swr_driver(dev->driver);
  645. if (!sdrv)
  646. return -EINVAL;
  647. if (sdrv->reset_device)
  648. return sdrv->reset_device(to_swr_device(dev));
  649. return -ENODEV;
  650. }
  651. EXPORT_SYMBOL(swr_reset_device);
  652. /**
  653. * swr_set_device_group - Assign group id to the slave devices
  654. * @swr_dev: pointer to soundwire slave device
  655. * @id: group id to be assigned to slave device
  656. * Context: can sleep
  657. *
  658. * This API will be called either from soundwire master or slave
  659. * device to assign group id.
  660. */
  661. int swr_set_device_group(struct swr_device *swr_dev, u8 id)
  662. {
  663. struct swr_master *master;
  664. if (!swr_dev)
  665. return -EINVAL;
  666. swr_dev->group_id = id;
  667. master = swr_dev->master;
  668. if (!id && master)
  669. master->gr_sid = 0;
  670. return 0;
  671. }
  672. EXPORT_SYMBOL(swr_set_device_group);
  673. static int swr_drv_probe(struct device *dev)
  674. {
  675. const struct swr_driver *sdrv = to_swr_driver(dev->driver);
  676. if (!sdrv)
  677. return -EINVAL;
  678. if (sdrv->probe)
  679. return sdrv->probe(to_swr_device(dev));
  680. return -ENODEV;
  681. }
  682. static int swr_drv_remove(struct device *dev)
  683. {
  684. const struct swr_driver *sdrv = to_swr_driver(dev->driver);
  685. if (!sdrv)
  686. return -EINVAL;
  687. if (sdrv->remove)
  688. return sdrv->remove(to_swr_device(dev));
  689. return -ENODEV;
  690. }
  691. static void swr_drv_shutdown(struct device *dev)
  692. {
  693. const struct swr_driver *sdrv = to_swr_driver(dev->driver);
  694. if (!sdrv)
  695. return;
  696. if (sdrv->shutdown)
  697. sdrv->shutdown(to_swr_device(dev));
  698. }
  699. /**
  700. * swr_driver_register - register a soundwire driver
  701. * @drv: the driver to register
  702. * Context: can sleep
  703. */
  704. int swr_driver_register(struct swr_driver *drv)
  705. {
  706. drv->driver.bus = &soundwire_type;
  707. if (drv->probe)
  708. drv->driver.probe = swr_drv_probe;
  709. if (drv->remove)
  710. drv->driver.remove = swr_drv_remove;
  711. if (drv->shutdown)
  712. drv->driver.shutdown = swr_drv_shutdown;
  713. return driver_register(&drv->driver);
  714. }
  715. EXPORT_SYMBOL(swr_driver_register);
  716. /**
  717. * swr_driver_unregister - unregister a soundwire driver
  718. * @drv: the driver to unregister
  719. */
  720. void swr_driver_unregister(struct swr_driver *drv)
  721. {
  722. if (drv)
  723. driver_unregister(&drv->driver);
  724. }
  725. EXPORT_SYMBOL(swr_driver_unregister);
  726. static void swr_match_ctrl_to_boardinfo(struct swr_master *master,
  727. struct swr_boardinfo *bi)
  728. {
  729. struct swr_device *swr;
  730. if (master->bus_num != bi->bus_num) {
  731. dev_dbg(&master->dev,
  732. "%s: master# %d and bi# %d does not match\n",
  733. __func__, master->bus_num, bi->bus_num);
  734. return;
  735. }
  736. swr = swr_new_device(master, bi);
  737. if (!swr)
  738. dev_err(&master->dev, "can't create new device for %s\n",
  739. bi->swr_slave->name);
  740. }
  741. /**
  742. * swr_master_add_boarddevices - Add devices registered by board info
  743. * @master: master to which these devices are to be added to.
  744. *
  745. * This API is called by master when it is up and running. If devices
  746. * on a master were registered before master, this will make sure that
  747. * they get probed when master is up.
  748. */
  749. void swr_master_add_boarddevices(struct swr_master *master)
  750. {
  751. struct boardinfo *bi;
  752. mutex_lock(&board_lock);
  753. list_add_tail(&master->list, &swr_master_list);
  754. list_for_each_entry(bi, &board_list, list)
  755. swr_match_ctrl_to_boardinfo(master, &bi->board_info);
  756. mutex_unlock(&board_lock);
  757. }
  758. EXPORT_SYMBOL(swr_master_add_boarddevices);
  759. struct swr_device *get_matching_swr_slave_device(struct device_node *np)
  760. {
  761. struct swr_device *swr = NULL;
  762. struct swr_master *master;
  763. bool found = false;
  764. mutex_lock(&board_lock);
  765. list_for_each_entry(master, &swr_master_list, list) {
  766. mutex_lock(&master->mlock);
  767. list_for_each_entry(swr, &master->devices, dev_list) {
  768. if (swr->dev.of_node == np) {
  769. found = true;
  770. mutex_unlock(&master->mlock);
  771. goto exit;
  772. }
  773. }
  774. mutex_unlock(&master->mlock);
  775. }
  776. exit:
  777. mutex_unlock(&board_lock);
  778. if (!found)
  779. return NULL;
  780. return swr;
  781. }
  782. EXPORT_SYMBOL(get_matching_swr_slave_device);
  783. static void swr_unregister_device(struct swr_device *swr)
  784. {
  785. if (swr)
  786. device_unregister(&swr->dev);
  787. }
  788. static void swr_master_release(struct device *dev)
  789. {
  790. /* kfree of master done at swrm_remove of device */
  791. }
  792. #define swr_master_attr_gr NULL
  793. static struct device_type swr_master_type = {
  794. .groups = swr_master_attr_gr,
  795. .release = swr_master_release,
  796. };
  797. static int __unregister(struct device *dev, void *null)
  798. {
  799. swr_unregister_device(to_swr_device(dev));
  800. return 0;
  801. }
  802. /**
  803. * swr_unregister_master - unregister soundwire master controller
  804. * @master: the master being unregistered
  805. *
  806. * This API is called by master controller driver to unregister
  807. * master controller that was registered by swr_register_master API.
  808. */
  809. void swr_unregister_master(struct swr_master *master)
  810. {
  811. int dummy;
  812. struct swr_master *m_ctrl;
  813. mutex_lock(&swr_lock);
  814. m_ctrl = idr_find(&master_idr, master->bus_num);
  815. mutex_unlock(&swr_lock);
  816. if (m_ctrl != master)
  817. return;
  818. mutex_lock(&board_lock);
  819. list_del(&master->list);
  820. mutex_unlock(&board_lock);
  821. /* free bus id */
  822. mutex_lock(&swr_lock);
  823. idr_remove(&master_idr, master->bus_num);
  824. mutex_unlock(&swr_lock);
  825. dummy = device_for_each_child(&master->dev, NULL, __unregister);
  826. device_unregister(&master->dev);
  827. }
  828. EXPORT_SYMBOL(swr_unregister_master);
  829. /**
  830. * swr_register_master - register soundwire master controller
  831. * @master: master to be registered
  832. *
  833. * This API will register master with the framework. master->bus_num
  834. * is the desired number with which soundwire framework registers the
  835. * master.
  836. */
  837. int swr_register_master(struct swr_master *master)
  838. {
  839. int id;
  840. int status = 0;
  841. mutex_lock(&swr_lock);
  842. id = of_alias_get_id(master->dev.of_node, "swr");
  843. if (id >= 0)
  844. master->bus_num = id;
  845. id = idr_alloc(&master_idr, master, master->bus_num,
  846. master->bus_num + 1, GFP_KERNEL);
  847. mutex_unlock(&swr_lock);
  848. if (id < 0)
  849. return id;
  850. master->bus_num = id;
  851. /* Can't register until driver model init */
  852. if (WARN_ON(!soundwire_type.p)) {
  853. status = -EAGAIN;
  854. goto done;
  855. }
  856. dev_set_name(&master->dev, "swr%u", master->bus_num);
  857. master->dev.bus = &soundwire_type;
  858. master->dev.type = &swr_master_type;
  859. mutex_init(&master->mlock);
  860. status = device_register(&master->dev);
  861. if (status < 0)
  862. goto done;
  863. INIT_LIST_HEAD(&master->devices);
  864. pr_debug("%s: SWR master registered successfully %s\n",
  865. __func__, dev_name(&master->dev));
  866. return 0;
  867. done:
  868. idr_remove(&master_idr, master->bus_num);
  869. return status;
  870. }
  871. EXPORT_SYMBOL(swr_register_master);
  872. #define swr_device_attr_gr NULL
  873. #define swr_device_uevent NULL
  874. static struct device_type swr_dev_type = {
  875. .groups = swr_device_attr_gr,
  876. .uevent = swr_device_uevent,
  877. .release = swr_dev_release,
  878. };
  879. static const struct swr_device_id *swr_match(const struct swr_device_id *id,
  880. const struct swr_device *swr_dev)
  881. {
  882. while (id->name[0]) {
  883. if (strcmp(swr_dev->name, id->name) == 0)
  884. return id;
  885. id++;
  886. }
  887. return NULL;
  888. }
  889. static int swr_device_match(struct device *dev, struct device_driver *driver)
  890. {
  891. struct swr_device *swr_dev;
  892. struct swr_driver *drv = to_swr_driver(driver);
  893. if (!drv)
  894. return -EINVAL;
  895. if (dev->type == &swr_dev_type) {
  896. swr_dev = to_swr_device(dev);
  897. if (!swr_dev)
  898. return -EINVAL;
  899. } else {
  900. return 0;
  901. }
  902. if (drv->id_table)
  903. return swr_match(drv->id_table, swr_dev) != NULL;
  904. if (driver->name)
  905. return strcmp(swr_dev->name, driver->name) == 0;
  906. return 0;
  907. }
  908. #ifdef CONFIG_PM_SLEEP
  909. static int swr_legacy_suspend(struct device *dev, pm_message_t mesg)
  910. {
  911. struct swr_device *swr_dev = NULL;
  912. struct swr_driver *driver;
  913. if (dev->type == &swr_dev_type)
  914. swr_dev = to_swr_device(dev);
  915. if (!swr_dev || !dev->driver)
  916. return 0;
  917. driver = to_swr_driver(dev->driver);
  918. if (!driver->suspend)
  919. return 0;
  920. return driver->suspend(swr_dev, mesg);
  921. }
  922. static int swr_legacy_resume(struct device *dev)
  923. {
  924. struct swr_device *swr_dev = NULL;
  925. struct swr_driver *driver;
  926. if (dev->type == &swr_dev_type)
  927. swr_dev = to_swr_device(dev);
  928. if (!swr_dev || !dev->driver)
  929. return 0;
  930. driver = to_swr_driver(dev->driver);
  931. if (!driver->resume)
  932. return 0;
  933. return driver->resume(swr_dev);
  934. }
  935. static int swr_pm_suspend(struct device *dev)
  936. {
  937. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  938. if (pm)
  939. return pm_generic_suspend(dev);
  940. else
  941. return swr_legacy_suspend(dev, PMSG_SUSPEND);
  942. }
  943. static int swr_pm_resume(struct device *dev)
  944. {
  945. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  946. if (pm)
  947. return pm_generic_resume(dev);
  948. else
  949. return swr_legacy_resume(dev);
  950. }
  951. #else
  952. #define swr_pm_suspend NULL
  953. #define swr_pm_resume NULL
  954. #endif /*CONFIG_PM_SLEEP*/
  955. static const struct dev_pm_ops soundwire_pm = {
  956. .suspend = swr_pm_suspend,
  957. .resume = swr_pm_resume,
  958. SET_RUNTIME_PM_OPS(
  959. pm_generic_suspend,
  960. pm_generic_resume,
  961. NULL
  962. )
  963. };
  964. struct device soundwire_dev = {
  965. .init_name = "soundwire",
  966. };
  967. struct bus_type soundwire_type = {
  968. .name = "soundwire",
  969. .match = swr_device_match,
  970. .pm = &soundwire_pm,
  971. };
  972. EXPORT_SYMBOL(soundwire_type);
  973. static void __exit soundwire_exit(void)
  974. {
  975. device_unregister(&soundwire_dev);
  976. bus_unregister(&soundwire_type);
  977. }
  978. static int __init soundwire_init(void)
  979. {
  980. int retval;
  981. retval = bus_register(&soundwire_type);
  982. if (!retval)
  983. retval = device_register(&soundwire_dev);
  984. if (retval)
  985. bus_unregister(&soundwire_type);
  986. return retval;
  987. }
  988. module_init(soundwire_init);
  989. module_exit(soundwire_exit);
  990. MODULE_LICENSE("GPL v2");
  991. MODULE_DESCRIPTION("Soundwire module");
  992. MODULE_ALIAS("platform:soundwire");