soc.h 40 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184
  1. /*
  2. * linux/sound/soc.h -- ALSA SoC Layer
  3. *
  4. * Author: Liam Girdwood
  5. * Created: Aug 11th 2005
  6. * Copyright: Wolfson Microelectronics. PLC.
  7. *
  8. * This program is free software; you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License version 2 as
  10. * published by the Free Software Foundation.
  11. */
  12. #ifndef __LINUX_SND_SOC_H
  13. #define __LINUX_SND_SOC_H
  14. #include <linux/platform_device.h>
  15. #include <linux/types.h>
  16. #include <linux/notifier.h>
  17. #include <linux/workqueue.h>
  18. #include <linux/interrupt.h>
  19. #include <linux/kernel.h>
  20. #include <linux/regmap.h>
  21. #include <linux/log2.h>
  22. #include <sound/core.h>
  23. #include <sound/pcm.h>
  24. #include <sound/compress_driver.h>
  25. #include <sound/control.h>
  26. #include <sound/ac97_codec.h>
  27. /*
  28. * Convenience kcontrol builders
  29. */
  30. #define SOC_DOUBLE_VALUE(xreg, shift_left, shift_right, xmax, xinvert, xautodisable) \
  31. ((unsigned long)&(struct soc_mixer_control) \
  32. {.reg = xreg, .rreg = xreg, .shift = shift_left, \
  33. .rshift = shift_right, .max = xmax, .platform_max = xmax, \
  34. .invert = xinvert, .autodisable = xautodisable})
  35. #define SOC_SINGLE_VALUE(xreg, xshift, xmax, xinvert, xautodisable) \
  36. SOC_DOUBLE_VALUE(xreg, xshift, xshift, xmax, xinvert, xautodisable)
  37. #define SOC_SINGLE_VALUE_EXT(xreg, xmax, xinvert) \
  38. ((unsigned long)&(struct soc_mixer_control) \
  39. {.reg = xreg, .max = xmax, .platform_max = xmax, .invert = xinvert})
  40. #define SOC_DOUBLE_R_VALUE(xlreg, xrreg, xshift, xmax, xinvert) \
  41. ((unsigned long)&(struct soc_mixer_control) \
  42. {.reg = xlreg, .rreg = xrreg, .shift = xshift, .rshift = xshift, \
  43. .max = xmax, .platform_max = xmax, .invert = xinvert})
  44. #define SOC_DOUBLE_R_RANGE_VALUE(xlreg, xrreg, xshift, xmin, xmax, xinvert) \
  45. ((unsigned long)&(struct soc_mixer_control) \
  46. {.reg = xlreg, .rreg = xrreg, .shift = xshift, .rshift = xshift, \
  47. .min = xmin, .max = xmax, .platform_max = xmax, .invert = xinvert})
  48. #define SOC_SINGLE(xname, reg, shift, max, invert) \
  49. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
  50. .info = snd_soc_info_volsw, .get = snd_soc_get_volsw,\
  51. .put = snd_soc_put_volsw, \
  52. .private_value = SOC_SINGLE_VALUE(reg, shift, max, invert, 0) }
  53. #define SOC_SINGLE_RANGE(xname, xreg, xshift, xmin, xmax, xinvert) \
  54. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\
  55. .info = snd_soc_info_volsw_range, .get = snd_soc_get_volsw_range, \
  56. .put = snd_soc_put_volsw_range, \
  57. .private_value = (unsigned long)&(struct soc_mixer_control) \
  58. {.reg = xreg, .rreg = xreg, .shift = xshift, \
  59. .rshift = xshift, .min = xmin, .max = xmax, \
  60. .platform_max = xmax, .invert = xinvert} }
  61. #define SOC_SINGLE_TLV(xname, reg, shift, max, invert, tlv_array) \
  62. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
  63. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
  64. SNDRV_CTL_ELEM_ACCESS_READWRITE,\
  65. .tlv.p = (tlv_array), \
  66. .info = snd_soc_info_volsw, .get = snd_soc_get_volsw,\
  67. .put = snd_soc_put_volsw, \
  68. .private_value = SOC_SINGLE_VALUE(reg, shift, max, invert, 0) }
  69. #define SOC_SINGLE_SX_TLV(xname, xreg, xshift, xmin, xmax, tlv_array) \
  70. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
  71. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
  72. SNDRV_CTL_ELEM_ACCESS_READWRITE, \
  73. .tlv.p = (tlv_array),\
  74. .info = snd_soc_info_volsw, \
  75. .get = snd_soc_get_volsw_sx,\
  76. .put = snd_soc_put_volsw_sx, \
  77. .private_value = (unsigned long)&(struct soc_mixer_control) \
  78. {.reg = xreg, .rreg = xreg, \
  79. .shift = xshift, .rshift = xshift, \
  80. .max = xmax, .min = xmin} }
  81. #define SOC_SINGLE_RANGE_TLV(xname, xreg, xshift, xmin, xmax, xinvert, tlv_array) \
  82. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\
  83. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
  84. SNDRV_CTL_ELEM_ACCESS_READWRITE,\
  85. .tlv.p = (tlv_array), \
  86. .info = snd_soc_info_volsw_range, \
  87. .get = snd_soc_get_volsw_range, .put = snd_soc_put_volsw_range, \
  88. .private_value = (unsigned long)&(struct soc_mixer_control) \
  89. {.reg = xreg, .rreg = xreg, .shift = xshift, \
  90. .rshift = xshift, .min = xmin, .max = xmax, \
  91. .platform_max = xmax, .invert = xinvert} }
  92. #define SOC_DOUBLE(xname, reg, shift_left, shift_right, max, invert) \
  93. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\
  94. .info = snd_soc_info_volsw, .get = snd_soc_get_volsw, \
  95. .put = snd_soc_put_volsw, \
  96. .private_value = SOC_DOUBLE_VALUE(reg, shift_left, shift_right, \
  97. max, invert, 0) }
  98. #define SOC_DOUBLE_R(xname, reg_left, reg_right, xshift, xmax, xinvert) \
  99. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname), \
  100. .info = snd_soc_info_volsw, \
  101. .get = snd_soc_get_volsw, .put = snd_soc_put_volsw, \
  102. .private_value = SOC_DOUBLE_R_VALUE(reg_left, reg_right, xshift, \
  103. xmax, xinvert) }
  104. #define SOC_DOUBLE_R_RANGE(xname, reg_left, reg_right, xshift, xmin, \
  105. xmax, xinvert) \
  106. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\
  107. .info = snd_soc_info_volsw_range, \
  108. .get = snd_soc_get_volsw_range, .put = snd_soc_put_volsw_range, \
  109. .private_value = SOC_DOUBLE_R_RANGE_VALUE(reg_left, reg_right, \
  110. xshift, xmin, xmax, xinvert) }
  111. #define SOC_DOUBLE_TLV(xname, reg, shift_left, shift_right, max, invert, tlv_array) \
  112. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\
  113. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
  114. SNDRV_CTL_ELEM_ACCESS_READWRITE,\
  115. .tlv.p = (tlv_array), \
  116. .info = snd_soc_info_volsw, .get = snd_soc_get_volsw, \
  117. .put = snd_soc_put_volsw, \
  118. .private_value = SOC_DOUBLE_VALUE(reg, shift_left, shift_right, \
  119. max, invert, 0) }
  120. #define SOC_DOUBLE_R_TLV(xname, reg_left, reg_right, xshift, xmax, xinvert, tlv_array) \
  121. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\
  122. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
  123. SNDRV_CTL_ELEM_ACCESS_READWRITE,\
  124. .tlv.p = (tlv_array), \
  125. .info = snd_soc_info_volsw, \
  126. .get = snd_soc_get_volsw, .put = snd_soc_put_volsw, \
  127. .private_value = SOC_DOUBLE_R_VALUE(reg_left, reg_right, xshift, \
  128. xmax, xinvert) }
  129. #define SOC_DOUBLE_R_RANGE_TLV(xname, reg_left, reg_right, xshift, xmin, \
  130. xmax, xinvert, tlv_array) \
  131. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\
  132. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
  133. SNDRV_CTL_ELEM_ACCESS_READWRITE,\
  134. .tlv.p = (tlv_array), \
  135. .info = snd_soc_info_volsw_range, \
  136. .get = snd_soc_get_volsw_range, .put = snd_soc_put_volsw_range, \
  137. .private_value = SOC_DOUBLE_R_RANGE_VALUE(reg_left, reg_right, \
  138. xshift, xmin, xmax, xinvert) }
  139. #define SOC_DOUBLE_R_SX_TLV(xname, xreg, xrreg, xshift, xmin, xmax, tlv_array) \
  140. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname), \
  141. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
  142. SNDRV_CTL_ELEM_ACCESS_READWRITE, \
  143. .tlv.p = (tlv_array), \
  144. .info = snd_soc_info_volsw, \
  145. .get = snd_soc_get_volsw_sx, \
  146. .put = snd_soc_put_volsw_sx, \
  147. .private_value = (unsigned long)&(struct soc_mixer_control) \
  148. {.reg = xreg, .rreg = xrreg, \
  149. .shift = xshift, .rshift = xshift, \
  150. .max = xmax, .min = xmin} }
  151. #define SOC_DOUBLE_S8_TLV(xname, xreg, xmin, xmax, tlv_array) \
  152. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname), \
  153. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
  154. SNDRV_CTL_ELEM_ACCESS_READWRITE, \
  155. .tlv.p = (tlv_array), \
  156. .info = snd_soc_info_volsw_s8, .get = snd_soc_get_volsw_s8, \
  157. .put = snd_soc_put_volsw_s8, \
  158. .private_value = (unsigned long)&(struct soc_mixer_control) \
  159. {.reg = xreg, .min = xmin, .max = xmax, \
  160. .platform_max = xmax} }
  161. #define SOC_ENUM_DOUBLE(xreg, xshift_l, xshift_r, xmax, xtexts) \
  162. { .reg = xreg, .shift_l = xshift_l, .shift_r = xshift_r, \
  163. .max = xmax, .texts = xtexts, \
  164. .mask = xmax ? roundup_pow_of_two(xmax) - 1 : 0}
  165. #define SOC_ENUM_SINGLE(xreg, xshift, xmax, xtexts) \
  166. SOC_ENUM_DOUBLE(xreg, xshift, xshift, xmax, xtexts)
  167. #define SOC_ENUM_SINGLE_EXT(xmax, xtexts) \
  168. { .max = xmax, .texts = xtexts }
  169. #define SOC_VALUE_ENUM_DOUBLE(xreg, xshift_l, xshift_r, xmask, xmax, xtexts, xvalues) \
  170. { .reg = xreg, .shift_l = xshift_l, .shift_r = xshift_r, \
  171. .mask = xmask, .max = xmax, .texts = xtexts, .values = xvalues}
  172. #define SOC_VALUE_ENUM_SINGLE(xreg, xshift, xmask, xmax, xtexts, xvalues) \
  173. SOC_VALUE_ENUM_DOUBLE(xreg, xshift, xshift, xmask, xmax, xtexts, xvalues)
  174. #define SOC_ENUM(xname, xenum) \
  175. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname,\
  176. .info = snd_soc_info_enum_double, \
  177. .get = snd_soc_get_enum_double, .put = snd_soc_put_enum_double, \
  178. .private_value = (unsigned long)&xenum }
  179. #define SOC_VALUE_ENUM(xname, xenum) \
  180. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname,\
  181. .info = snd_soc_info_enum_double, \
  182. .get = snd_soc_get_value_enum_double, \
  183. .put = snd_soc_put_value_enum_double, \
  184. .private_value = (unsigned long)&xenum }
  185. #define SOC_SINGLE_EXT(xname, xreg, xshift, xmax, xinvert,\
  186. xhandler_get, xhandler_put) \
  187. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
  188. .info = snd_soc_info_volsw, \
  189. .get = xhandler_get, .put = xhandler_put, \
  190. .private_value = SOC_SINGLE_VALUE(xreg, xshift, xmax, xinvert, 0) }
  191. #define SOC_DOUBLE_EXT(xname, reg, shift_left, shift_right, max, invert,\
  192. xhandler_get, xhandler_put) \
  193. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\
  194. .info = snd_soc_info_volsw, \
  195. .get = xhandler_get, .put = xhandler_put, \
  196. .private_value = \
  197. SOC_DOUBLE_VALUE(reg, shift_left, shift_right, max, invert, 0) }
  198. #define SOC_SINGLE_EXT_TLV(xname, xreg, xshift, xmax, xinvert,\
  199. xhandler_get, xhandler_put, tlv_array) \
  200. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
  201. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ |\
  202. SNDRV_CTL_ELEM_ACCESS_READWRITE,\
  203. .tlv.p = (tlv_array), \
  204. .info = snd_soc_info_volsw, \
  205. .get = xhandler_get, .put = xhandler_put, \
  206. .private_value = SOC_SINGLE_VALUE(xreg, xshift, xmax, xinvert, 0) }
  207. #define SOC_DOUBLE_EXT_TLV(xname, xreg, shift_left, shift_right, xmax, xinvert,\
  208. xhandler_get, xhandler_put, tlv_array) \
  209. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname), \
  210. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
  211. SNDRV_CTL_ELEM_ACCESS_READWRITE, \
  212. .tlv.p = (tlv_array), \
  213. .info = snd_soc_info_volsw, \
  214. .get = xhandler_get, .put = xhandler_put, \
  215. .private_value = SOC_DOUBLE_VALUE(xreg, shift_left, shift_right, \
  216. xmax, xinvert, 0) }
  217. #define SOC_DOUBLE_R_EXT_TLV(xname, reg_left, reg_right, xshift, xmax, xinvert,\
  218. xhandler_get, xhandler_put, tlv_array) \
  219. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname), \
  220. .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ | \
  221. SNDRV_CTL_ELEM_ACCESS_READWRITE, \
  222. .tlv.p = (tlv_array), \
  223. .info = snd_soc_info_volsw, \
  224. .get = xhandler_get, .put = xhandler_put, \
  225. .private_value = SOC_DOUBLE_R_VALUE(reg_left, reg_right, xshift, \
  226. xmax, xinvert) }
  227. #define SOC_SINGLE_BOOL_EXT(xname, xdata, xhandler_get, xhandler_put) \
  228. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
  229. .info = snd_soc_info_bool_ext, \
  230. .get = xhandler_get, .put = xhandler_put, \
  231. .private_value = xdata }
  232. #define SOC_ENUM_EXT(xname, xenum, xhandler_get, xhandler_put) \
  233. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
  234. .info = snd_soc_info_enum_double, \
  235. .get = xhandler_get, .put = xhandler_put, \
  236. .private_value = (unsigned long)&xenum }
  237. #define SND_SOC_BYTES(xname, xbase, xregs) \
  238. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
  239. .info = snd_soc_bytes_info, .get = snd_soc_bytes_get, \
  240. .put = snd_soc_bytes_put, .private_value = \
  241. ((unsigned long)&(struct soc_bytes) \
  242. {.base = xbase, .num_regs = xregs }) }
  243. #define SND_SOC_BYTES_MASK(xname, xbase, xregs, xmask) \
  244. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \
  245. .info = snd_soc_bytes_info, .get = snd_soc_bytes_get, \
  246. .put = snd_soc_bytes_put, .private_value = \
  247. ((unsigned long)&(struct soc_bytes) \
  248. {.base = xbase, .num_regs = xregs, \
  249. .mask = xmask }) }
  250. #define SOC_SINGLE_XR_SX(xname, xregbase, xregcount, xnbits, \
  251. xmin, xmax, xinvert) \
  252. { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname), \
  253. .info = snd_soc_info_xr_sx, .get = snd_soc_get_xr_sx, \
  254. .put = snd_soc_put_xr_sx, \
  255. .private_value = (unsigned long)&(struct soc_mreg_control) \
  256. {.regbase = xregbase, .regcount = xregcount, .nbits = xnbits, \
  257. .invert = xinvert, .min = xmin, .max = xmax} }
  258. #define SOC_SINGLE_STROBE(xname, xreg, xshift, xinvert) \
  259. SOC_SINGLE_EXT(xname, xreg, xshift, 1, xinvert, \
  260. snd_soc_get_strobe, snd_soc_put_strobe)
  261. /*
  262. * Simplified versions of above macros, declaring a struct and calculating
  263. * ARRAY_SIZE internally
  264. */
  265. #define SOC_ENUM_DOUBLE_DECL(name, xreg, xshift_l, xshift_r, xtexts) \
  266. struct soc_enum name = SOC_ENUM_DOUBLE(xreg, xshift_l, xshift_r, \
  267. ARRAY_SIZE(xtexts), xtexts)
  268. #define SOC_ENUM_SINGLE_DECL(name, xreg, xshift, xtexts) \
  269. SOC_ENUM_DOUBLE_DECL(name, xreg, xshift, xshift, xtexts)
  270. #define SOC_ENUM_SINGLE_EXT_DECL(name, xtexts) \
  271. struct soc_enum name = SOC_ENUM_SINGLE_EXT(ARRAY_SIZE(xtexts), xtexts)
  272. #define SOC_VALUE_ENUM_DOUBLE_DECL(name, xreg, xshift_l, xshift_r, xmask, xtexts, xvalues) \
  273. struct soc_enum name = SOC_VALUE_ENUM_DOUBLE(xreg, xshift_l, xshift_r, xmask, \
  274. ARRAY_SIZE(xtexts), xtexts, xvalues)
  275. #define SOC_VALUE_ENUM_SINGLE_DECL(name, xreg, xshift, xmask, xtexts, xvalues) \
  276. SOC_VALUE_ENUM_DOUBLE_DECL(name, xreg, xshift, xshift, xmask, xtexts, xvalues)
  277. /*
  278. * Component probe and remove ordering levels for components with runtime
  279. * dependencies.
  280. */
  281. #define SND_SOC_COMP_ORDER_FIRST -2
  282. #define SND_SOC_COMP_ORDER_EARLY -1
  283. #define SND_SOC_COMP_ORDER_NORMAL 0
  284. #define SND_SOC_COMP_ORDER_LATE 1
  285. #define SND_SOC_COMP_ORDER_LAST 2
  286. /*
  287. * Bias levels
  288. *
  289. * @ON: Bias is fully on for audio playback and capture operations.
  290. * @PREPARE: Prepare for audio operations. Called before DAPM switching for
  291. * stream start and stop operations.
  292. * @STANDBY: Low power standby state when no playback/capture operations are
  293. * in progress. NOTE: The transition time between STANDBY and ON
  294. * should be as fast as possible and no longer than 10ms.
  295. * @OFF: Power Off. No restrictions on transition times.
  296. */
  297. enum snd_soc_bias_level {
  298. SND_SOC_BIAS_OFF = 0,
  299. SND_SOC_BIAS_STANDBY = 1,
  300. SND_SOC_BIAS_PREPARE = 2,
  301. SND_SOC_BIAS_ON = 3,
  302. };
  303. struct device_node;
  304. struct snd_jack;
  305. struct snd_soc_card;
  306. struct snd_soc_pcm_stream;
  307. struct snd_soc_ops;
  308. struct snd_soc_pcm_runtime;
  309. struct snd_soc_dai;
  310. struct snd_soc_dai_driver;
  311. struct snd_soc_platform;
  312. struct snd_soc_dai_link;
  313. struct snd_soc_platform_driver;
  314. struct snd_soc_codec;
  315. struct snd_soc_codec_driver;
  316. struct snd_soc_component;
  317. struct snd_soc_component_driver;
  318. struct soc_enum;
  319. struct snd_soc_jack;
  320. struct snd_soc_jack_zone;
  321. struct snd_soc_jack_pin;
  322. struct snd_soc_cache_ops;
  323. #include <sound/soc-dapm.h>
  324. #include <sound/soc-dpcm.h>
  325. #ifdef CONFIG_GPIOLIB
  326. struct snd_soc_jack_gpio;
  327. #endif
  328. typedef int (*hw_write_t)(void *,const char* ,int);
  329. extern struct snd_ac97_bus_ops *soc_ac97_ops;
  330. enum snd_soc_control_type {
  331. SND_SOC_I2C = 1,
  332. SND_SOC_SPI,
  333. SND_SOC_REGMAP,
  334. };
  335. enum snd_soc_compress_type {
  336. SND_SOC_FLAT_COMPRESSION = 1,
  337. };
  338. enum snd_soc_pcm_subclass {
  339. SND_SOC_PCM_CLASS_PCM = 0,
  340. SND_SOC_PCM_CLASS_BE = 1,
  341. };
  342. enum snd_soc_card_subclass {
  343. SND_SOC_CARD_CLASS_INIT = 0,
  344. SND_SOC_CARD_CLASS_RUNTIME = 1,
  345. };
  346. int snd_soc_codec_set_sysclk(struct snd_soc_codec *codec, int clk_id,
  347. int source, unsigned int freq, int dir);
  348. int snd_soc_codec_set_pll(struct snd_soc_codec *codec, int pll_id, int source,
  349. unsigned int freq_in, unsigned int freq_out);
  350. int snd_soc_register_card(struct snd_soc_card *card);
  351. int snd_soc_unregister_card(struct snd_soc_card *card);
  352. int snd_soc_suspend(struct device *dev);
  353. int snd_soc_resume(struct device *dev);
  354. int snd_soc_poweroff(struct device *dev);
  355. int snd_soc_register_platform(struct device *dev,
  356. const struct snd_soc_platform_driver *platform_drv);
  357. void snd_soc_unregister_platform(struct device *dev);
  358. int snd_soc_add_platform(struct device *dev, struct snd_soc_platform *platform,
  359. const struct snd_soc_platform_driver *platform_drv);
  360. void snd_soc_remove_platform(struct snd_soc_platform *platform);
  361. struct snd_soc_platform *snd_soc_lookup_platform(struct device *dev);
  362. int snd_soc_register_codec(struct device *dev,
  363. const struct snd_soc_codec_driver *codec_drv,
  364. struct snd_soc_dai_driver *dai_drv, int num_dai);
  365. void snd_soc_unregister_codec(struct device *dev);
  366. int snd_soc_register_component(struct device *dev,
  367. const struct snd_soc_component_driver *cmpnt_drv,
  368. struct snd_soc_dai_driver *dai_drv, int num_dai);
  369. void snd_soc_unregister_component(struct device *dev);
  370. int snd_soc_codec_volatile_register(struct snd_soc_codec *codec,
  371. unsigned int reg);
  372. int snd_soc_codec_readable_register(struct snd_soc_codec *codec,
  373. unsigned int reg);
  374. int snd_soc_codec_writable_register(struct snd_soc_codec *codec,
  375. unsigned int reg);
  376. int snd_soc_codec_set_cache_io(struct snd_soc_codec *codec,
  377. int addr_bits, int data_bits,
  378. enum snd_soc_control_type control);
  379. int snd_soc_cache_sync(struct snd_soc_codec *codec);
  380. int snd_soc_cache_init(struct snd_soc_codec *codec);
  381. int snd_soc_cache_exit(struct snd_soc_codec *codec);
  382. int snd_soc_cache_write(struct snd_soc_codec *codec,
  383. unsigned int reg, unsigned int value);
  384. int snd_soc_cache_read(struct snd_soc_codec *codec,
  385. unsigned int reg, unsigned int *value);
  386. int snd_soc_platform_read(struct snd_soc_platform *platform,
  387. unsigned int reg);
  388. int snd_soc_platform_write(struct snd_soc_platform *platform,
  389. unsigned int reg, unsigned int val);
  390. int soc_new_pcm(struct snd_soc_pcm_runtime *rtd, int num);
  391. int soc_new_compress(struct snd_soc_pcm_runtime *rtd, int num);
  392. struct snd_pcm_substream *snd_soc_get_dai_substream(struct snd_soc_card *card,
  393. const char *dai_link, int stream);
  394. struct snd_soc_pcm_runtime *snd_soc_get_pcm_runtime(struct snd_soc_card *card,
  395. const char *dai_link);
  396. /* Utility functions to get clock rates from various things */
  397. int snd_soc_calc_frame_size(int sample_size, int channels, int tdm_slots);
  398. int snd_soc_params_to_frame_size(struct snd_pcm_hw_params *params);
  399. int snd_soc_calc_bclk(int fs, int sample_size, int channels, int tdm_slots);
  400. int snd_soc_params_to_bclk(struct snd_pcm_hw_params *parms);
  401. /* set runtime hw params */
  402. int snd_soc_set_runtime_hwparams(struct snd_pcm_substream *substream,
  403. const struct snd_pcm_hardware *hw);
  404. int snd_soc_platform_trigger(struct snd_pcm_substream *substream,
  405. int cmd, struct snd_soc_platform *platform);
  406. /* Jack reporting */
  407. int snd_soc_jack_new(struct snd_soc_codec *codec, const char *id, int type,
  408. struct snd_soc_jack *jack);
  409. void snd_soc_jack_report(struct snd_soc_jack *jack, int status, int mask);
  410. int snd_soc_jack_add_pins(struct snd_soc_jack *jack, int count,
  411. struct snd_soc_jack_pin *pins);
  412. void snd_soc_jack_notifier_register(struct snd_soc_jack *jack,
  413. struct notifier_block *nb);
  414. void snd_soc_jack_notifier_unregister(struct snd_soc_jack *jack,
  415. struct notifier_block *nb);
  416. int snd_soc_jack_add_zones(struct snd_soc_jack *jack, int count,
  417. struct snd_soc_jack_zone *zones);
  418. int snd_soc_jack_get_type(struct snd_soc_jack *jack, int micbias_voltage);
  419. #ifdef CONFIG_GPIOLIB
  420. int snd_soc_jack_add_gpios(struct snd_soc_jack *jack, int count,
  421. struct snd_soc_jack_gpio *gpios);
  422. void snd_soc_jack_free_gpios(struct snd_soc_jack *jack, int count,
  423. struct snd_soc_jack_gpio *gpios);
  424. #endif
  425. /* codec register bit access */
  426. int snd_soc_update_bits(struct snd_soc_codec *codec, unsigned short reg,
  427. unsigned int mask, unsigned int value);
  428. int snd_soc_update_bits_locked(struct snd_soc_codec *codec,
  429. unsigned short reg, unsigned int mask,
  430. unsigned int value);
  431. int snd_soc_test_bits(struct snd_soc_codec *codec, unsigned short reg,
  432. unsigned int mask, unsigned int value);
  433. int snd_soc_new_ac97_codec(struct snd_soc_codec *codec,
  434. struct snd_ac97_bus_ops *ops, int num);
  435. void snd_soc_free_ac97_codec(struct snd_soc_codec *codec);
  436. int snd_soc_set_ac97_ops(struct snd_ac97_bus_ops *ops);
  437. int snd_soc_set_ac97_ops_of_reset(struct snd_ac97_bus_ops *ops,
  438. struct platform_device *pdev);
  439. /*
  440. *Controls
  441. */
  442. struct snd_kcontrol *snd_soc_cnew(const struct snd_kcontrol_new *_template,
  443. void *data, const char *long_name,
  444. const char *prefix);
  445. struct snd_kcontrol *snd_soc_card_get_kcontrol(struct snd_soc_card *soc_card,
  446. const char *name);
  447. int snd_soc_add_codec_controls(struct snd_soc_codec *codec,
  448. const struct snd_kcontrol_new *controls, int num_controls);
  449. int snd_soc_add_platform_controls(struct snd_soc_platform *platform,
  450. const struct snd_kcontrol_new *controls, int num_controls);
  451. int snd_soc_add_card_controls(struct snd_soc_card *soc_card,
  452. const struct snd_kcontrol_new *controls, int num_controls);
  453. int snd_soc_add_dai_controls(struct snd_soc_dai *dai,
  454. const struct snd_kcontrol_new *controls, int num_controls);
  455. int snd_soc_info_enum_double(struct snd_kcontrol *kcontrol,
  456. struct snd_ctl_elem_info *uinfo);
  457. int snd_soc_get_enum_double(struct snd_kcontrol *kcontrol,
  458. struct snd_ctl_elem_value *ucontrol);
  459. int snd_soc_put_enum_double(struct snd_kcontrol *kcontrol,
  460. struct snd_ctl_elem_value *ucontrol);
  461. int snd_soc_get_value_enum_double(struct snd_kcontrol *kcontrol,
  462. struct snd_ctl_elem_value *ucontrol);
  463. int snd_soc_put_value_enum_double(struct snd_kcontrol *kcontrol,
  464. struct snd_ctl_elem_value *ucontrol);
  465. int snd_soc_info_volsw(struct snd_kcontrol *kcontrol,
  466. struct snd_ctl_elem_info *uinfo);
  467. #define snd_soc_info_bool_ext snd_ctl_boolean_mono_info
  468. int snd_soc_get_volsw(struct snd_kcontrol *kcontrol,
  469. struct snd_ctl_elem_value *ucontrol);
  470. int snd_soc_put_volsw(struct snd_kcontrol *kcontrol,
  471. struct snd_ctl_elem_value *ucontrol);
  472. #define snd_soc_get_volsw_2r snd_soc_get_volsw
  473. #define snd_soc_put_volsw_2r snd_soc_put_volsw
  474. int snd_soc_get_volsw_sx(struct snd_kcontrol *kcontrol,
  475. struct snd_ctl_elem_value *ucontrol);
  476. int snd_soc_put_volsw_sx(struct snd_kcontrol *kcontrol,
  477. struct snd_ctl_elem_value *ucontrol);
  478. int snd_soc_info_volsw_s8(struct snd_kcontrol *kcontrol,
  479. struct snd_ctl_elem_info *uinfo);
  480. int snd_soc_get_volsw_s8(struct snd_kcontrol *kcontrol,
  481. struct snd_ctl_elem_value *ucontrol);
  482. int snd_soc_put_volsw_s8(struct snd_kcontrol *kcontrol,
  483. struct snd_ctl_elem_value *ucontrol);
  484. int snd_soc_info_volsw_range(struct snd_kcontrol *kcontrol,
  485. struct snd_ctl_elem_info *uinfo);
  486. int snd_soc_put_volsw_range(struct snd_kcontrol *kcontrol,
  487. struct snd_ctl_elem_value *ucontrol);
  488. int snd_soc_get_volsw_range(struct snd_kcontrol *kcontrol,
  489. struct snd_ctl_elem_value *ucontrol);
  490. int snd_soc_limit_volume(struct snd_soc_codec *codec,
  491. const char *name, int max);
  492. int snd_soc_bytes_info(struct snd_kcontrol *kcontrol,
  493. struct snd_ctl_elem_info *uinfo);
  494. int snd_soc_bytes_get(struct snd_kcontrol *kcontrol,
  495. struct snd_ctl_elem_value *ucontrol);
  496. int snd_soc_bytes_put(struct snd_kcontrol *kcontrol,
  497. struct snd_ctl_elem_value *ucontrol);
  498. int snd_soc_info_xr_sx(struct snd_kcontrol *kcontrol,
  499. struct snd_ctl_elem_info *uinfo);
  500. int snd_soc_get_xr_sx(struct snd_kcontrol *kcontrol,
  501. struct snd_ctl_elem_value *ucontrol);
  502. int snd_soc_put_xr_sx(struct snd_kcontrol *kcontrol,
  503. struct snd_ctl_elem_value *ucontrol);
  504. int snd_soc_get_strobe(struct snd_kcontrol *kcontrol,
  505. struct snd_ctl_elem_value *ucontrol);
  506. int snd_soc_put_strobe(struct snd_kcontrol *kcontrol,
  507. struct snd_ctl_elem_value *ucontrol);
  508. /**
  509. * struct snd_soc_jack_pin - Describes a pin to update based on jack detection
  510. *
  511. * @pin: name of the pin to update
  512. * @mask: bits to check for in reported jack status
  513. * @invert: if non-zero then pin is enabled when status is not reported
  514. */
  515. struct snd_soc_jack_pin {
  516. struct list_head list;
  517. const char *pin;
  518. int mask;
  519. bool invert;
  520. };
  521. /**
  522. * struct snd_soc_jack_zone - Describes voltage zones of jack detection
  523. *
  524. * @min_mv: start voltage in mv
  525. * @max_mv: end voltage in mv
  526. * @jack_type: type of jack that is expected for this voltage
  527. * @debounce_time: debounce_time for jack, codec driver should wait for this
  528. * duration before reading the adc for voltages
  529. * @:list: list container
  530. */
  531. struct snd_soc_jack_zone {
  532. unsigned int min_mv;
  533. unsigned int max_mv;
  534. unsigned int jack_type;
  535. unsigned int debounce_time;
  536. struct list_head list;
  537. };
  538. /**
  539. * struct snd_soc_jack_gpio - Describes a gpio pin for jack detection
  540. *
  541. * @gpio: gpio number
  542. * @name: gpio name
  543. * @report: value to report when jack detected
  544. * @invert: report presence in low state
  545. * @debouce_time: debouce time in ms
  546. * @wake: enable as wake source
  547. * @jack_status_check: callback function which overrides the detection
  548. * to provide more complex checks (eg, reading an
  549. * ADC).
  550. */
  551. #ifdef CONFIG_GPIOLIB
  552. struct snd_soc_jack_gpio {
  553. unsigned int gpio;
  554. const char *name;
  555. int report;
  556. int invert;
  557. int debounce_time;
  558. bool wake;
  559. struct snd_soc_jack *jack;
  560. struct delayed_work work;
  561. int (*jack_status_check)(void);
  562. };
  563. #endif
  564. struct snd_soc_jack {
  565. struct mutex mutex;
  566. struct snd_jack *jack;
  567. struct snd_soc_codec *codec;
  568. struct list_head pins;
  569. int status;
  570. struct blocking_notifier_head notifier;
  571. struct list_head jack_zones;
  572. };
  573. /* SoC PCM stream information */
  574. struct snd_soc_pcm_stream {
  575. const char *stream_name;
  576. u64 formats; /* SNDRV_PCM_FMTBIT_* */
  577. unsigned int rates; /* SNDRV_PCM_RATE_* */
  578. unsigned int rate_min; /* min rate */
  579. unsigned int rate_max; /* max rate */
  580. unsigned int channels_min; /* min channels */
  581. unsigned int channels_max; /* max channels */
  582. unsigned int sig_bits; /* number of bits of content */
  583. };
  584. /* SoC audio ops */
  585. struct snd_soc_ops {
  586. int (*startup)(struct snd_pcm_substream *);
  587. void (*shutdown)(struct snd_pcm_substream *);
  588. int (*hw_params)(struct snd_pcm_substream *, struct snd_pcm_hw_params *);
  589. int (*hw_free)(struct snd_pcm_substream *);
  590. int (*prepare)(struct snd_pcm_substream *);
  591. int (*trigger)(struct snd_pcm_substream *, int);
  592. };
  593. struct snd_soc_compr_ops {
  594. int (*startup)(struct snd_compr_stream *);
  595. void (*shutdown)(struct snd_compr_stream *);
  596. int (*set_params)(struct snd_compr_stream *);
  597. int (*trigger)(struct snd_compr_stream *);
  598. };
  599. /* SoC cache ops */
  600. struct snd_soc_cache_ops {
  601. const char *name;
  602. enum snd_soc_compress_type id;
  603. int (*init)(struct snd_soc_codec *codec);
  604. int (*exit)(struct snd_soc_codec *codec);
  605. int (*read)(struct snd_soc_codec *codec, unsigned int reg,
  606. unsigned int *value);
  607. int (*write)(struct snd_soc_codec *codec, unsigned int reg,
  608. unsigned int value);
  609. int (*sync)(struct snd_soc_codec *codec);
  610. };
  611. /* SoC Audio Codec device */
  612. struct snd_soc_codec {
  613. const char *name;
  614. const char *name_prefix;
  615. int id;
  616. struct device *dev;
  617. const struct snd_soc_codec_driver *driver;
  618. struct mutex mutex;
  619. struct snd_soc_card *card;
  620. struct list_head list;
  621. struct list_head card_list;
  622. int num_dai;
  623. enum snd_soc_compress_type compress_type;
  624. int (*volatile_register)(struct snd_soc_codec *, unsigned int);
  625. int (*readable_register)(struct snd_soc_codec *, unsigned int);
  626. int (*writable_register)(struct snd_soc_codec *, unsigned int);
  627. /* runtime */
  628. struct snd_ac97 *ac97; /* for ad-hoc ac97 devices */
  629. unsigned int active;
  630. unsigned int cache_bypass:1; /* Suppress access to the cache */
  631. unsigned int suspended:1; /* Codec is in suspend PM state */
  632. unsigned int probed:1; /* Codec has been probed */
  633. unsigned int ac97_registered:1; /* Codec has been AC97 registered */
  634. unsigned int ac97_created:1; /* Codec has been created by SoC */
  635. unsigned int cache_init:1; /* codec cache has been initialized */
  636. unsigned int using_regmap:1; /* using regmap access */
  637. u32 cache_only; /* Suppress writes to hardware */
  638. u32 cache_sync; /* Cache needs to be synced to hardware */
  639. /* codec IO */
  640. void *control_data; /* codec control (i2c/3wire) data */
  641. hw_write_t hw_write;
  642. unsigned int (*hw_read)(struct snd_soc_codec *, unsigned int);
  643. unsigned int (*read)(struct snd_soc_codec *, unsigned int);
  644. int (*write)(struct snd_soc_codec *, unsigned int, unsigned int);
  645. void *reg_cache;
  646. const struct snd_soc_cache_ops *cache_ops;
  647. struct mutex cache_rw_mutex;
  648. int val_bytes;
  649. /* dapm */
  650. struct snd_soc_dapm_context dapm;
  651. unsigned int ignore_pmdown_time:1; /* pmdown_time is ignored at stop */
  652. #ifdef CONFIG_DEBUG_FS
  653. struct dentry *debugfs_codec_root;
  654. struct dentry *debugfs_reg;
  655. #endif
  656. };
  657. /* codec driver */
  658. struct snd_soc_codec_driver {
  659. /* driver ops */
  660. int (*probe)(struct snd_soc_codec *);
  661. int (*remove)(struct snd_soc_codec *);
  662. int (*suspend)(struct snd_soc_codec *);
  663. int (*resume)(struct snd_soc_codec *);
  664. /* Default control and setup, added after probe() is run */
  665. const struct snd_kcontrol_new *controls;
  666. int num_controls;
  667. const struct snd_soc_dapm_widget *dapm_widgets;
  668. int num_dapm_widgets;
  669. const struct snd_soc_dapm_route *dapm_routes;
  670. int num_dapm_routes;
  671. /* codec wide operations */
  672. int (*set_sysclk)(struct snd_soc_codec *codec,
  673. int clk_id, int source, unsigned int freq, int dir);
  674. int (*set_pll)(struct snd_soc_codec *codec, int pll_id, int source,
  675. unsigned int freq_in, unsigned int freq_out);
  676. /* codec IO */
  677. unsigned int (*read)(struct snd_soc_codec *, unsigned int);
  678. int (*write)(struct snd_soc_codec *, unsigned int, unsigned int);
  679. int (*display_register)(struct snd_soc_codec *, char *,
  680. size_t, unsigned int);
  681. int (*volatile_register)(struct snd_soc_codec *, unsigned int);
  682. int (*readable_register)(struct snd_soc_codec *, unsigned int);
  683. int (*writable_register)(struct snd_soc_codec *, unsigned int);
  684. unsigned int reg_cache_size;
  685. short reg_cache_step;
  686. short reg_word_size;
  687. const void *reg_cache_default;
  688. enum snd_soc_compress_type compress_type;
  689. /* codec bias level */
  690. int (*set_bias_level)(struct snd_soc_codec *,
  691. enum snd_soc_bias_level level);
  692. bool idle_bias_off;
  693. void (*seq_notifier)(struct snd_soc_dapm_context *,
  694. enum snd_soc_dapm_type, int);
  695. /* codec stream completion event */
  696. int (*stream_event)(struct snd_soc_dapm_context *dapm, int event);
  697. bool ignore_pmdown_time; /* Doesn't benefit from pmdown delay */
  698. /* probe ordering - for components with runtime dependencies */
  699. int probe_order;
  700. int remove_order;
  701. };
  702. /* SoC platform interface */
  703. struct snd_soc_platform_driver {
  704. int (*probe)(struct snd_soc_platform *);
  705. int (*remove)(struct snd_soc_platform *);
  706. int (*suspend)(struct snd_soc_dai *dai);
  707. int (*resume)(struct snd_soc_dai *dai);
  708. /* pcm creation and destruction */
  709. int (*pcm_new)(struct snd_soc_pcm_runtime *);
  710. void (*pcm_free)(struct snd_pcm *);
  711. /* Default control and setup, added after probe() is run */
  712. const struct snd_kcontrol_new *controls;
  713. int num_controls;
  714. const struct snd_soc_dapm_widget *dapm_widgets;
  715. int num_dapm_widgets;
  716. const struct snd_soc_dapm_route *dapm_routes;
  717. int num_dapm_routes;
  718. /*
  719. * For platform caused delay reporting.
  720. * Optional.
  721. */
  722. snd_pcm_sframes_t (*delay)(struct snd_pcm_substream *,
  723. struct snd_soc_dai *);
  724. /* platform stream pcm ops */
  725. const struct snd_pcm_ops *ops;
  726. /* platform stream compress ops */
  727. const struct snd_compr_ops *compr_ops;
  728. /* platform stream completion event */
  729. int (*stream_event)(struct snd_soc_dapm_context *dapm, int event);
  730. /* probe ordering - for components with runtime dependencies */
  731. int probe_order;
  732. int remove_order;
  733. /* platform IO - used for platform DAPM */
  734. unsigned int (*read)(struct snd_soc_platform *, unsigned int);
  735. int (*write)(struct snd_soc_platform *, unsigned int, unsigned int);
  736. int (*bespoke_trigger)(struct snd_pcm_substream *, int);
  737. };
  738. struct snd_soc_platform {
  739. const char *name;
  740. int id;
  741. struct device *dev;
  742. const struct snd_soc_platform_driver *driver;
  743. struct mutex mutex;
  744. unsigned int suspended:1; /* platform is suspended */
  745. unsigned int probed:1;
  746. struct snd_soc_card *card;
  747. struct list_head list;
  748. struct list_head card_list;
  749. struct snd_soc_dapm_context dapm;
  750. #ifdef CONFIG_DEBUG_FS
  751. struct dentry *debugfs_platform_root;
  752. #endif
  753. };
  754. struct snd_soc_component_driver {
  755. const char *name;
  756. };
  757. struct snd_soc_component {
  758. const char *name;
  759. int id;
  760. int num_dai;
  761. struct device *dev;
  762. struct list_head list;
  763. const struct snd_soc_component_driver *driver;
  764. };
  765. struct snd_soc_dai_link {
  766. /* config - must be set by machine driver */
  767. const char *name; /* Codec name */
  768. const char *stream_name; /* Stream name */
  769. /*
  770. * You MAY specify the link's CPU-side device, either by device name,
  771. * or by DT/OF node, but not both. If this information is omitted,
  772. * the CPU-side DAI is matched using .cpu_dai_name only, which hence
  773. * must be globally unique. These fields are currently typically used
  774. * only for codec to codec links, or systems using device tree.
  775. */
  776. const char *cpu_name;
  777. const struct device_node *cpu_of_node;
  778. /*
  779. * You MAY specify the DAI name of the CPU DAI. If this information is
  780. * omitted, the CPU-side DAI is matched using .cpu_name/.cpu_of_node
  781. * only, which only works well when that device exposes a single DAI.
  782. */
  783. const char *cpu_dai_name;
  784. /*
  785. * You MUST specify the link's codec, either by device name, or by
  786. * DT/OF node, but not both.
  787. */
  788. const char *codec_name;
  789. const struct device_node *codec_of_node;
  790. /* You MUST specify the DAI name within the codec */
  791. const char *codec_dai_name;
  792. /*
  793. * You MAY specify the link's platform/PCM/DMA driver, either by
  794. * device name, or by DT/OF node, but not both. Some forms of link
  795. * do not need a platform.
  796. */
  797. const char *platform_name;
  798. const struct device_node *platform_of_node;
  799. int be_id; /* optional ID for machine driver BE identification */
  800. const struct snd_soc_pcm_stream *params;
  801. unsigned int dai_fmt; /* format to set on init */
  802. enum snd_soc_dpcm_trigger trigger[2]; /* trigger type for DPCM */
  803. /* Keep DAI active over suspend */
  804. unsigned int ignore_suspend:1;
  805. /* Symmetry requirements */
  806. unsigned int symmetric_rates:1;
  807. /* Do not create a PCM for this DAI link (Backend link) */
  808. unsigned int no_pcm:1;
  809. /* This DAI link can route to other DAI links at runtime (Frontend)*/
  810. unsigned int dynamic:1;
  811. /* pmdown_time is ignored at stop */
  812. unsigned int ignore_pmdown_time:1;
  813. /* codec/machine specific init - e.g. add machine controls */
  814. int (*init)(struct snd_soc_pcm_runtime *rtd);
  815. /* optional hw_params re-writing for BE and FE sync */
  816. int (*be_hw_params_fixup)(struct snd_soc_pcm_runtime *rtd,
  817. struct snd_pcm_hw_params *params);
  818. /* machine stream operations */
  819. const struct snd_soc_ops *ops;
  820. const struct snd_soc_compr_ops *compr_ops;
  821. /* For unidirectional dai links */
  822. bool playback_only;
  823. bool capture_only;
  824. };
  825. struct snd_soc_codec_conf {
  826. const char *dev_name;
  827. /*
  828. * optional map of kcontrol, widget and path name prefixes that are
  829. * associated per device
  830. */
  831. const char *name_prefix;
  832. /*
  833. * set this to the desired compression type if you want to
  834. * override the one supplied in codec->driver->compress_type
  835. */
  836. enum snd_soc_compress_type compress_type;
  837. };
  838. struct snd_soc_aux_dev {
  839. const char *name; /* Codec name */
  840. const char *codec_name; /* for multi-codec */
  841. /* codec/machine specific init - e.g. add machine controls */
  842. int (*init)(struct snd_soc_dapm_context *dapm);
  843. };
  844. /* SoC card */
  845. struct snd_soc_card {
  846. const char *name;
  847. const char *long_name;
  848. const char *driver_name;
  849. struct device *dev;
  850. struct snd_card *snd_card;
  851. struct module *owner;
  852. struct list_head list;
  853. struct mutex mutex;
  854. struct mutex dapm_mutex;
  855. bool instantiated;
  856. int (*probe)(struct snd_soc_card *card);
  857. int (*late_probe)(struct snd_soc_card *card);
  858. int (*remove)(struct snd_soc_card *card);
  859. /* the pre and post PM functions are used to do any PM work before and
  860. * after the codec and DAI's do any PM work. */
  861. int (*suspend_pre)(struct snd_soc_card *card);
  862. int (*suspend_post)(struct snd_soc_card *card);
  863. int (*resume_pre)(struct snd_soc_card *card);
  864. int (*resume_post)(struct snd_soc_card *card);
  865. /* callbacks */
  866. int (*set_bias_level)(struct snd_soc_card *,
  867. struct snd_soc_dapm_context *dapm,
  868. enum snd_soc_bias_level level);
  869. int (*set_bias_level_post)(struct snd_soc_card *,
  870. struct snd_soc_dapm_context *dapm,
  871. enum snd_soc_bias_level level);
  872. long pmdown_time;
  873. /* CPU <--> Codec DAI links */
  874. struct snd_soc_dai_link *dai_link;
  875. int num_links;
  876. struct snd_soc_pcm_runtime *rtd;
  877. int num_rtd;
  878. /* optional codec specific configuration */
  879. struct snd_soc_codec_conf *codec_conf;
  880. int num_configs;
  881. /*
  882. * optional auxiliary devices such as amplifiers or codecs with DAI
  883. * link unused
  884. */
  885. struct snd_soc_aux_dev *aux_dev;
  886. int num_aux_devs;
  887. struct snd_soc_pcm_runtime *rtd_aux;
  888. int num_aux_rtd;
  889. const struct snd_kcontrol_new *controls;
  890. int num_controls;
  891. /*
  892. * Card-specific routes and widgets.
  893. */
  894. const struct snd_soc_dapm_widget *dapm_widgets;
  895. int num_dapm_widgets;
  896. const struct snd_soc_dapm_route *dapm_routes;
  897. int num_dapm_routes;
  898. bool fully_routed;
  899. struct work_struct deferred_resume_work;
  900. /* lists of probed devices belonging to this card */
  901. struct list_head codec_dev_list;
  902. struct list_head platform_dev_list;
  903. struct list_head dai_dev_list;
  904. struct list_head widgets;
  905. struct list_head paths;
  906. struct list_head dapm_list;
  907. struct list_head dapm_dirty;
  908. /* Generic DAPM context for the card */
  909. struct snd_soc_dapm_context dapm;
  910. struct snd_soc_dapm_stats dapm_stats;
  911. struct snd_soc_dapm_update *update;
  912. #ifdef CONFIG_DEBUG_FS
  913. struct dentry *debugfs_card_root;
  914. struct dentry *debugfs_pop_time;
  915. #endif
  916. u32 pop_time;
  917. void *drvdata;
  918. };
  919. /* SoC machine DAI configuration, glues a codec and cpu DAI together */
  920. struct snd_soc_pcm_runtime {
  921. struct device *dev;
  922. struct snd_soc_card *card;
  923. struct snd_soc_dai_link *dai_link;
  924. struct mutex pcm_mutex;
  925. enum snd_soc_pcm_subclass pcm_subclass;
  926. struct snd_pcm_ops ops;
  927. unsigned int dev_registered:1;
  928. /* Dynamic PCM BE runtime data */
  929. struct snd_soc_dpcm_runtime dpcm[2];
  930. long pmdown_time;
  931. unsigned char pop_wait:1;
  932. /* runtime devices */
  933. struct snd_pcm *pcm;
  934. struct snd_compr *compr;
  935. struct snd_soc_codec *codec;
  936. struct snd_soc_platform *platform;
  937. struct snd_soc_dai *codec_dai;
  938. struct snd_soc_dai *cpu_dai;
  939. struct delayed_work delayed_work;
  940. #ifdef CONFIG_DEBUG_FS
  941. struct dentry *debugfs_dpcm_root;
  942. struct dentry *debugfs_dpcm_state;
  943. #endif
  944. };
  945. /* mixer control */
  946. struct soc_mixer_control {
  947. int min, max, platform_max;
  948. unsigned int reg, rreg, shift, rshift;
  949. unsigned int invert:1;
  950. unsigned int autodisable:1;
  951. };
  952. struct soc_bytes {
  953. int base;
  954. int num_regs;
  955. u32 mask;
  956. };
  957. /* multi register control */
  958. struct soc_mreg_control {
  959. long min, max;
  960. unsigned int regbase, regcount, nbits, invert;
  961. };
  962. /* enumerated kcontrol */
  963. struct soc_enum {
  964. unsigned short reg;
  965. unsigned short reg2;
  966. unsigned char shift_l;
  967. unsigned char shift_r;
  968. unsigned int max;
  969. unsigned int mask;
  970. const char * const *texts;
  971. const unsigned int *values;
  972. };
  973. /* codec IO */
  974. unsigned int snd_soc_read(struct snd_soc_codec *codec, unsigned int reg);
  975. unsigned int snd_soc_write(struct snd_soc_codec *codec,
  976. unsigned int reg, unsigned int val);
  977. /* device driver data */
  978. static inline void snd_soc_card_set_drvdata(struct snd_soc_card *card,
  979. void *data)
  980. {
  981. card->drvdata = data;
  982. }
  983. static inline void *snd_soc_card_get_drvdata(struct snd_soc_card *card)
  984. {
  985. return card->drvdata;
  986. }
  987. static inline void snd_soc_codec_set_drvdata(struct snd_soc_codec *codec,
  988. void *data)
  989. {
  990. dev_set_drvdata(codec->dev, data);
  991. }
  992. static inline void *snd_soc_codec_get_drvdata(struct snd_soc_codec *codec)
  993. {
  994. return dev_get_drvdata(codec->dev);
  995. }
  996. static inline void snd_soc_platform_set_drvdata(struct snd_soc_platform *platform,
  997. void *data)
  998. {
  999. dev_set_drvdata(platform->dev, data);
  1000. }
  1001. static inline void *snd_soc_platform_get_drvdata(struct snd_soc_platform *platform)
  1002. {
  1003. return dev_get_drvdata(platform->dev);
  1004. }
  1005. static inline void snd_soc_pcm_set_drvdata(struct snd_soc_pcm_runtime *rtd,
  1006. void *data)
  1007. {
  1008. dev_set_drvdata(rtd->dev, data);
  1009. }
  1010. static inline void *snd_soc_pcm_get_drvdata(struct snd_soc_pcm_runtime *rtd)
  1011. {
  1012. return dev_get_drvdata(rtd->dev);
  1013. }
  1014. static inline void snd_soc_initialize_card_lists(struct snd_soc_card *card)
  1015. {
  1016. INIT_LIST_HEAD(&card->dai_dev_list);
  1017. INIT_LIST_HEAD(&card->codec_dev_list);
  1018. INIT_LIST_HEAD(&card->platform_dev_list);
  1019. INIT_LIST_HEAD(&card->widgets);
  1020. INIT_LIST_HEAD(&card->paths);
  1021. INIT_LIST_HEAD(&card->dapm_list);
  1022. }
  1023. static inline bool snd_soc_volsw_is_stereo(struct soc_mixer_control *mc)
  1024. {
  1025. if (mc->reg == mc->rreg && mc->shift == mc->rshift)
  1026. return 0;
  1027. /*
  1028. * mc->reg == mc->rreg && mc->shift != mc->rshift, or
  1029. * mc->reg != mc->rreg means that the control is
  1030. * stereo (bits in one register or in two registers)
  1031. */
  1032. return 1;
  1033. }
  1034. int snd_soc_util_init(void);
  1035. void snd_soc_util_exit(void);
  1036. int snd_soc_of_parse_card_name(struct snd_soc_card *card,
  1037. const char *propname);
  1038. int snd_soc_of_parse_audio_routing(struct snd_soc_card *card,
  1039. const char *propname);
  1040. unsigned int snd_soc_of_parse_daifmt(struct device_node *np,
  1041. const char *prefix);
  1042. #include <sound/soc-dai.h>
  1043. #ifdef CONFIG_DEBUG_FS
  1044. extern struct dentry *snd_soc_debugfs_root;
  1045. #endif
  1046. extern const struct dev_pm_ops snd_soc_pm_ops;
  1047. #endif