audio_class.c 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608
  1. /**
  2. **************************************************************************
  3. * @file audio_class.c
  4. * @version v2.0.6
  5. * @date 2021-12-31
  6. * @brief usb audio class type
  7. **************************************************************************
  8. * Copyright notice & Disclaimer
  9. *
  10. * The software Board Support Package (BSP) that is made available to
  11. * download from Artery official website is the copyrighted work of Artery.
  12. * Artery authorizes customers to use, copy, and distribute the BSP
  13. * software and its related documentation for the purpose of design and
  14. * development in conjunction with Artery microcontrollers. Use of the
  15. * software is governed by this copyright notice and the following disclaimer.
  16. *
  17. * THIS SOFTWARE IS PROVIDED ON "AS IS" BASIS WITHOUT WARRANTIES,
  18. * GUARANTEES OR REPRESENTATIONS OF ANY KIND. ARTERY EXPRESSLY DISCLAIMS,
  19. * TO THE FULLEST EXTENT PERMITTED BY LAW, ALL EXPRESS, IMPLIED OR
  20. * STATUTORY OR OTHER WARRANTIES, GUARANTEES OR REPRESENTATIONS,
  21. * INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
  22. * FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
  23. *
  24. **************************************************************************
  25. */
  26. #include "usbd_core.h"
  27. #include "audio_class.h"
  28. #include "audio_desc.h"
  29. #include "audio_codec.h"
  30. /** @addtogroup AT32F403A_407_middlewares_usbd_class
  31. * @{
  32. */
  33. /** @defgroup USB_audio_class
  34. * @brief usb device class audio demo
  35. * @{
  36. */
  37. /** @defgroup USB_audio_class_private_functions
  38. * @{
  39. */
  40. usb_sts_type class_init_handler(void *udev);
  41. usb_sts_type class_clear_handler(void *udev);
  42. usb_sts_type class_setup_handler(void *udev, usb_setup_type *setup);
  43. usb_sts_type class_ept0_tx_handler(void *udev);
  44. usb_sts_type class_ept0_rx_handler(void *udev);
  45. usb_sts_type class_in_handler(void *udev, uint8_t ept_num);
  46. usb_sts_type class_out_handler(void *udev, uint8_t ept_num);
  47. usb_sts_type class_sof_handler(void *udev);
  48. usb_sts_type class_event_handler(void *udev, usbd_event_type event);
  49. void audio_req_get_cur(void *udev, usb_setup_type *setup);
  50. void audio_req_set_cur(void *udev, usb_setup_type *setup);
  51. void audio_req_get_min(void *udev, usb_setup_type *setup);
  52. void audio_req_get_max(void *udev, usb_setup_type *setup);
  53. void audio_req_get_res(void *udev, usb_setup_type *setup);
  54. void audio_get_interface(void *udev, usb_setup_type *setup);
  55. void audio_set_interface(void *udev, usb_setup_type *setup);
  56. usb_audio_type audio_struct = {0, 0, 0, 0, 0, 0x1400, 0, 0, 0, {0x0000, 0x1400, 0x33}, {0x0000, 0x1400, 0x33}};
  57. /* usb device class handler */
  58. usbd_class_handler audio_class_handler =
  59. {
  60. class_init_handler,
  61. class_clear_handler,
  62. class_setup_handler,
  63. class_ept0_tx_handler,
  64. class_ept0_rx_handler,
  65. class_in_handler,
  66. class_out_handler,
  67. class_sof_handler,
  68. class_event_handler,
  69. };
  70. /**
  71. * @brief initialize usb custom hid endpoint
  72. * @param udev: usb device core handler type
  73. * @retval status of usb_sts_type
  74. */
  75. usb_sts_type class_init_handler(void *udev)
  76. {
  77. usb_sts_type status = USB_OK;
  78. usbd_core_type *pudev = (usbd_core_type *)udev;
  79. /* enable microphone in endpoint double buffer mode */
  80. usbd_ept_dbuffer_enable(pudev, USBD_AUDIO_MIC_IN_EPT);
  81. /* open microphone in endpoint */
  82. usbd_ept_open(pudev, USBD_AUDIO_MIC_IN_EPT, EPT_ISO_TYPE, AUDIO_MIC_IN_MAXPACKET_SIZE);
  83. /* enable speaker out endpoint double buffer mode */
  84. usbd_ept_dbuffer_enable(pudev, USBD_AUDIO_SPK_OUT_EPT);
  85. /* open speaker out endpoint */
  86. usbd_ept_open(pudev, USBD_AUDIO_SPK_OUT_EPT, EPT_ISO_TYPE, AUDIO_SPK_OUT_MAXPACKET_SIZE);
  87. /* enable speaker feedback endpoint double buffer mode */
  88. usbd_ept_dbuffer_enable(pudev, USBD_AUDIO_FEEDBACK_EPT);
  89. /* open speaker feedback endpoint */
  90. usbd_ept_open(pudev, USBD_AUDIO_FEEDBACK_EPT, EPT_ISO_TYPE, AUDIO_FEEDBACK_MAXPACKET_SIZE);
  91. /* start receive speaker out data */
  92. usbd_ept_recv(pudev, USBD_AUDIO_SPK_OUT_EPT, audio_struct.audio_spk_data, AUDIO_SPK_OUT_MAXPACKET_SIZE);
  93. return status;
  94. }
  95. /**
  96. * @brief clear endpoint or other state
  97. * @param udev: usb device core handler type
  98. * @retval status of usb_sts_type
  99. */
  100. usb_sts_type class_clear_handler(void *udev)
  101. {
  102. usb_sts_type status = USB_OK;
  103. usbd_core_type *pudev = (usbd_core_type *)udev;
  104. /* close in endpoint */
  105. usbd_ept_close(pudev, USBD_AUDIO_MIC_IN_EPT);
  106. /* close in endpoint */
  107. usbd_ept_close(pudev, USBD_AUDIO_FEEDBACK_EPT);
  108. /* close out endpoint */
  109. usbd_ept_close(pudev, USBD_AUDIO_SPK_OUT_EPT);
  110. return status;
  111. }
  112. /**
  113. * @brief usb device class setup request handler
  114. * @param udev: usb device core handler type
  115. * @param setup: setup packet
  116. * @retval status of usb_sts_type
  117. */
  118. usb_sts_type class_setup_handler(void *udev, usb_setup_type *setup)
  119. {
  120. usb_sts_type status = USB_OK;
  121. usbd_core_type *pudev = (usbd_core_type *)udev;
  122. uint16_t len;
  123. switch(setup->bmRequestType & USB_REQ_TYPE_RESERVED)
  124. {
  125. /* class request */
  126. case USB_REQ_TYPE_CLASS:
  127. switch(setup->bRequest)
  128. {
  129. case AUDIO_REQ_GET_CUR:
  130. audio_req_get_cur(pudev, setup);
  131. break;
  132. case AUDIO_REQ_SET_CUR:
  133. audio_req_set_cur(pudev, setup);
  134. break;
  135. case AUDIO_REQ_GET_MIN:
  136. audio_req_get_min(pudev, setup);
  137. break;
  138. case AUDIO_REQ_GET_MAX:
  139. audio_req_get_max(pudev, setup);
  140. break;
  141. case AUDIO_REQ_GET_RES:
  142. audio_req_get_res(pudev, setup);
  143. break;
  144. default:
  145. usbd_ctrl_unsupport(pudev);
  146. break;
  147. }
  148. break;
  149. /* standard request */
  150. case USB_REQ_TYPE_STANDARD:
  151. switch(setup->bRequest)
  152. {
  153. case USB_STD_REQ_GET_DESCRIPTOR:
  154. if((setup->wValue >> 8) == AUDIO_DESCRIPTOR_TYPE)
  155. {
  156. len = MIN(AUDIO_DESCRIPTOR_SIZE, setup->wLength);
  157. usbd_ctrl_send(pudev, g_usbd_configuration+18, len);
  158. }
  159. else
  160. {
  161. usbd_ctrl_unsupport(pudev);
  162. }
  163. break;
  164. case USB_STD_REQ_GET_INTERFACE:
  165. audio_get_interface(udev, setup);
  166. break;
  167. case USB_STD_REQ_SET_INTERFACE:
  168. audio_set_interface(udev, setup);
  169. usbd_ctrl_send_status(pudev);
  170. break;
  171. default:
  172. break;
  173. }
  174. break;
  175. default:
  176. usbd_ctrl_unsupport(pudev);
  177. break;
  178. }
  179. return status;
  180. }
  181. /**
  182. * @brief usb device endpoint 0 in status stage complete
  183. * @param udev: usb device core handler type
  184. * @retval status of usb_sts_type
  185. */
  186. usb_sts_type class_ept0_tx_handler(void *udev)
  187. {
  188. usb_sts_type status = USB_OK;
  189. /* ...user code... */
  190. return status;
  191. }
  192. /**
  193. * @brief usb device endpoint 0 out status stage complete
  194. * @param udev: usb device core handler type
  195. * @retval status of usb_sts_type
  196. */
  197. usb_sts_type class_ept0_rx_handler(void *udev)
  198. {
  199. usb_sts_type status = USB_OK;
  200. usbd_core_type *pudev = (usbd_core_type *)udev;
  201. uint32_t recv_len = usbd_get_recv_len(pudev, 0);
  202. /* ...user code... */
  203. if( audio_struct.audio_cmd == AUDIO_REQ_SET_CUR)
  204. {
  205. /* class process */
  206. switch(audio_struct.request_no)
  207. {
  208. case AUDIO_VOLUME_CONTROL:
  209. if(audio_struct.interface == AUDIO_SPK_FEATURE_UNIT_ID)
  210. {
  211. audio_struct.spk_volume = (uint16_t)(audio_struct.g_audio_cur[0] |
  212. (audio_struct.g_audio_cur[1] << 8));
  213. /* set volume */
  214. audio_codec_set_spk_volume(audio_struct.spk_volume*100/audio_struct.spk_volume_limits[1]);
  215. }
  216. else
  217. {
  218. audio_struct.mic_volume = (uint16_t)(audio_struct.g_audio_cur[0] |
  219. (audio_struct.g_audio_cur[1] << 8));
  220. audio_codec_set_mic_volume(audio_struct.mic_volume*256/audio_struct.mic_volume_limits[1]);
  221. }
  222. break;
  223. case AUDIO_MUTE_CONTROL:
  224. if(audio_struct.interface == AUDIO_SPK_FEATURE_UNIT_ID)
  225. {
  226. audio_struct.spk_mute = audio_struct.g_audio_cur[0];
  227. audio_codec_set_spk_mute(audio_struct.spk_mute);
  228. }
  229. else
  230. {
  231. audio_struct.mic_mute = audio_struct.g_audio_cur[0];
  232. audio_codec_set_mic_mute(audio_struct.mic_mute);
  233. }
  234. break;
  235. case AUDIO_FREQ_SET_CONTROL:
  236. if(audio_struct.enpd == USBD_AUDIO_MIC_IN_EPT)
  237. {
  238. audio_struct.mic_freq = (audio_struct.g_audio_cur[0] |
  239. (audio_struct.g_audio_cur[1] << 8) |
  240. (audio_struct.g_audio_cur[2] << 16));
  241. audio_codec_set_mic_freq(audio_struct.mic_freq);
  242. }
  243. else
  244. {
  245. audio_struct.spk_freq = (audio_struct.g_audio_cur[0] |
  246. (audio_struct.g_audio_cur[1] << 8) |
  247. (audio_struct.g_audio_cur[2] << 16));
  248. audio_codec_set_spk_freq(audio_struct.spk_freq);
  249. }
  250. break;
  251. default:
  252. break;
  253. }
  254. }
  255. return status;
  256. }
  257. /**
  258. * @brief usb device transmision complete handler
  259. * @param udev: usb device core handler type
  260. * @param ept_num: endpoint number
  261. * @retval status of usb_sts_type
  262. */
  263. usb_sts_type class_in_handler(void *udev, uint8_t ept_num)
  264. {
  265. usb_sts_type status = USB_OK;
  266. uint32_t len = 0;
  267. /* ...user code...
  268. trans next packet data
  269. */
  270. if((ept_num & 0x7F) == (USBD_AUDIO_MIC_IN_EPT & 0x7F))
  271. {
  272. len = audio_codec_mic_get_data(audio_struct.audio_mic_data);
  273. usbd_ept_send(udev, USBD_AUDIO_MIC_IN_EPT, audio_struct.audio_mic_data, len);
  274. }
  275. else if((ept_num & 0x7F) == (USBD_AUDIO_FEEDBACK_EPT & 0x7F))
  276. {
  277. len = audio_codec_spk_feedback(audio_struct.audio_feed_back);
  278. usbd_ept_send(udev, USBD_AUDIO_FEEDBACK_EPT, audio_struct.audio_feed_back, len);
  279. }
  280. return status;
  281. }
  282. /**
  283. * @brief usb device endpoint receive data
  284. * @param udev: usb device core handler type
  285. * @param ept_num: endpoint number
  286. * @retval status of usb_sts_type
  287. */
  288. usb_sts_type class_out_handler(void *udev, uint8_t ept_num)
  289. {
  290. usb_sts_type status = USB_OK;
  291. usbd_core_type *pudev = (usbd_core_type *)udev;
  292. uint16_t g_rxlen;
  293. /* get endpoint receive data length */
  294. g_rxlen = usbd_get_recv_len(pudev, ept_num);
  295. if((ept_num & 0x7F) == (USBD_AUDIO_SPK_OUT_EPT & 0x7F))
  296. {
  297. /* speaker data*/
  298. audio_codec_spk_fifo_write(audio_struct.audio_spk_data, g_rxlen);
  299. /* get next data */
  300. usbd_ept_recv(pudev, USBD_AUDIO_SPK_OUT_EPT, audio_struct.audio_spk_data, AUDIO_SPK_OUT_MAXPACKET_SIZE);
  301. }
  302. return status;
  303. }
  304. /**
  305. * @brief usb device sof handler
  306. * @param udev: usb device core handler type
  307. * @retval status of usb_sts_type
  308. */
  309. usb_sts_type class_sof_handler(void *udev)
  310. {
  311. usb_sts_type status = USB_OK;
  312. /* ...user code... */
  313. return status;
  314. }
  315. /**
  316. * @brief usb device event handler
  317. * @param udev: usb device core handler type
  318. * @param event: usb device event
  319. * @retval status of usb_sts_type
  320. */
  321. usb_sts_type class_event_handler(void *udev, usbd_event_type event)
  322. {
  323. usb_sts_type status = USB_OK;
  324. switch(event)
  325. {
  326. case USBD_RESET_EVENT:
  327. /* ...user code... */
  328. break;
  329. case USBD_SUSPEND_EVENT:
  330. audio_struct.spk_alt_setting = 0;
  331. audio_codec_spk_alt_setting(audio_struct.spk_alt_setting);
  332. audio_struct.mic_alt_setting = 0;
  333. audio_codec_mic_alt_setting(audio_struct.spk_alt_setting);
  334. /* ...user code... */
  335. break;
  336. case USBD_WAKEUP_EVENT:
  337. /* ...user code... */
  338. break;
  339. default:
  340. break;
  341. }
  342. return status;
  343. }
  344. /**
  345. * @brief usb audio request get cur
  346. * @param udev: usb device core handler type
  347. * @param setup: setup class
  348. * @retval none
  349. */
  350. void audio_req_get_cur(void *udev, usb_setup_type *setup)
  351. {
  352. usbd_core_type *pudev = (usbd_core_type *)udev;
  353. if(HBYTE(setup->wIndex) == AUDIO_SPK_FEATURE_UNIT_ID)
  354. {
  355. if(HBYTE(setup->wValue) == AUDIO_MUTE_CONTROL)
  356. {
  357. audio_struct.g_audio_cur[0] = audio_struct.spk_mute;
  358. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  359. }
  360. else
  361. {
  362. *((uint16_t *)audio_struct.g_audio_cur) = audio_struct.spk_volume;
  363. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  364. }
  365. }
  366. else
  367. {
  368. if(HBYTE(setup->wValue) == AUDIO_MUTE_CONTROL)
  369. {
  370. audio_struct.g_audio_cur[0] = audio_struct.mic_mute;
  371. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  372. }
  373. else
  374. {
  375. *((uint16_t *)audio_struct.g_audio_cur) = audio_struct.mic_volume;
  376. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  377. }
  378. }
  379. }
  380. /**
  381. * @brief usb audio request set cur
  382. * @param udev: usb device core handler type
  383. * @param setup: setup class
  384. * @retval none
  385. */
  386. void audio_req_set_cur(void *udev, usb_setup_type *setup)
  387. {
  388. usbd_core_type *pudev = (usbd_core_type *)udev;
  389. if(setup->wLength > 0)
  390. {
  391. usbd_ctrl_recv(pudev, audio_struct.g_audio_cur, setup->wLength);
  392. audio_struct.audio_cmd = AUDIO_REQ_SET_CUR;
  393. audio_struct.audio_cmd_len = setup->wLength;
  394. switch(setup->bmRequestType & AUDIO_REQ_CONTROL_MASK)
  395. {
  396. case AUDIO_REQ_CONTROL_INTERFACE:
  397. audio_struct.interface = HBYTE(setup->wIndex);
  398. if(HBYTE(setup->wValue) == AUDIO_MUTE_CONTROL)
  399. {
  400. audio_struct.request_no = AUDIO_MUTE_CONTROL;
  401. }
  402. else
  403. {
  404. audio_struct.request_no = AUDIO_VOLUME_CONTROL;
  405. }
  406. break;
  407. case AUDIO_REQ_CONTROL_ENDPOINT:
  408. audio_struct.enpd = setup->wIndex;
  409. audio_struct.request_no = AUDIO_FREQ_SET_CONTROL;
  410. break;
  411. default:
  412. break;
  413. }
  414. }
  415. }
  416. /**
  417. * @brief usb audio request get min
  418. * @param udev: usb device core handler type
  419. * @param setup: setup class
  420. * @retval none
  421. */
  422. void audio_req_get_min(void *udev, usb_setup_type *setup)
  423. {
  424. usbd_core_type *pudev = (usbd_core_type *)udev;
  425. if(HBYTE(setup->wIndex) == AUDIO_SPK_FEATURE_UNIT_ID)
  426. {
  427. *((uint16_t *)audio_struct.g_audio_cur) = audio_struct.spk_volume_limits[0];
  428. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  429. }
  430. else
  431. {
  432. *((uint16_t *)audio_struct.g_audio_cur) = audio_struct.mic_volume_limits[0];
  433. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  434. }
  435. }
  436. /**
  437. * @brief usb audio request get max
  438. * @param udev: usb device core handler type
  439. * @param setup: setup class
  440. * @retval none
  441. */
  442. void audio_req_get_max(void *udev, usb_setup_type *setup)
  443. {
  444. usbd_core_type *pudev = (usbd_core_type *)udev;
  445. if(HBYTE(setup->wIndex) == AUDIO_SPK_FEATURE_UNIT_ID)
  446. {
  447. *((uint16_t *)audio_struct.g_audio_cur) = audio_struct.spk_volume_limits[1];
  448. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  449. }
  450. else
  451. {
  452. *((uint16_t *)audio_struct.g_audio_cur) = audio_struct.mic_volume_limits[1];
  453. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  454. }
  455. }
  456. /**
  457. * @brief usb audio request get res
  458. * @param udev: usb device core handler type
  459. * @param setup: setup class
  460. * @retval none
  461. */
  462. void audio_req_get_res(void *udev, usb_setup_type *setup)
  463. {
  464. usbd_core_type *pudev = (usbd_core_type *)udev;
  465. if(HBYTE(setup->wIndex) == AUDIO_SPK_FEATURE_UNIT_ID)
  466. {
  467. *((uint16_t *)audio_struct.g_audio_cur) = audio_struct.spk_volume_limits[2];
  468. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  469. }
  470. else
  471. {
  472. *((uint16_t *)audio_struct.g_audio_cur) = audio_struct.mic_volume_limits[2];
  473. usbd_ctrl_send(pudev, audio_struct.g_audio_cur, setup->wLength);
  474. }
  475. }
  476. /**
  477. * @brief usb audio set interface
  478. * @param udev: usb device core handler type
  479. * @param setup: setup class
  480. * @retval none
  481. */
  482. void audio_set_interface(void *udev, usb_setup_type *setup)
  483. {
  484. uint32_t len;
  485. usbd_core_type *pudev = (usbd_core_type *)udev;
  486. if(LBYTE(setup->wIndex) == AUDIO_SPK_INTERFACE_NUMBER)
  487. {
  488. audio_struct.spk_alt_setting = setup->wValue;
  489. audio_codec_spk_alt_setting(audio_struct.spk_alt_setting);
  490. if(audio_struct.spk_alt_setting )
  491. {
  492. int len = audio_codec_spk_feedback(audio_struct.audio_feed_back);
  493. usbd_ept_recv(pudev, USBD_AUDIO_SPK_OUT_EPT, audio_struct.audio_spk_data, AUDIO_SPK_OUT_MAXPACKET_SIZE);
  494. usbd_ept_send(pudev, USBD_AUDIO_FEEDBACK_EPT, audio_struct.audio_feed_back, len);
  495. }
  496. }
  497. else if(LBYTE(setup->wIndex) == AUDIO_MIC_INTERFACE_NUMBER)
  498. {
  499. audio_struct.mic_alt_setting = setup->wValue;
  500. audio_codec_mic_alt_setting(audio_struct.mic_alt_setting);
  501. if(audio_struct.mic_alt_setting)
  502. {
  503. len = audio_codec_mic_get_data(audio_struct.audio_mic_data);
  504. usbd_ept_send(pudev, USBD_AUDIO_MIC_IN_EPT, audio_struct.audio_mic_data, len);
  505. }
  506. }
  507. }
  508. /**
  509. * @brief usb audio get interface
  510. * @param udev: usb device core handler type
  511. * @param setup: setup class
  512. * @retval none
  513. */
  514. void audio_get_interface(void *udev, usb_setup_type *setup)
  515. {
  516. if(LBYTE(setup->wIndex) == AUDIO_SPK_INTERFACE_NUMBER)
  517. {
  518. usbd_ctrl_send((usbd_core_type *)udev, (uint8_t *)&audio_struct.spk_alt_setting, 1);
  519. }
  520. else if(LBYTE(setup->wIndex) == AUDIO_MIC_INTERFACE_NUMBER)
  521. {
  522. usbd_ctrl_send((usbd_core_type *)udev, (uint8_t *)&audio_struct.mic_alt_setting, 1);
  523. }
  524. }
  525. /**
  526. * @}
  527. */
  528. /**
  529. * @}
  530. */
  531. /**
  532. * @}
  533. */