soundwire.c 27 KB

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