sdio.c 35 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412
  1. /*
  2. * Copyright (c) 2006-2023, RT-Thread Development Team
  3. *
  4. * SPDX-License-Identifier: Apache-2.0
  5. *
  6. * Change Logs:
  7. * Date Author Notes
  8. * 2012-01-13 weety first version
  9. */
  10. #include <drivers/mmcsd_core.h>
  11. #include <drivers/sdio.h>
  12. #include <drivers/sd.h>
  13. #define DBG_TAG "SDIO"
  14. #ifdef RT_SDIO_DEBUG
  15. #define DBG_LVL DBG_LOG
  16. #else
  17. #define DBG_LVL DBG_INFO
  18. #endif /* RT_SDIO_DEBUG */
  19. #include <rtdbg.h>
  20. #ifndef RT_SDIO_STACK_SIZE
  21. #define RT_SDIO_STACK_SIZE 512
  22. #endif
  23. #ifndef RT_SDIO_THREAD_PRIORITY
  24. #define RT_SDIO_THREAD_PRIORITY 0x40
  25. #endif
  26. static rt_list_t sdio_cards = RT_LIST_OBJECT_INIT(sdio_cards);
  27. static rt_list_t sdio_drivers = RT_LIST_OBJECT_INIT(sdio_drivers);
  28. struct sdio_card
  29. {
  30. struct rt_mmcsd_card *card;
  31. rt_list_t list;
  32. };
  33. struct sdio_driver
  34. {
  35. struct rt_sdio_driver *drv;
  36. rt_list_t list;
  37. };
  38. #define MIN(a, b) (a < b ? a : b)
  39. static const rt_uint8_t speed_value[16] =
  40. {
  41. 0, 10, 12, 13, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 70, 80
  42. };
  43. static const rt_uint32_t speed_unit[8] =
  44. {
  45. 10000, 100000, 1000000, 10000000, 0, 0, 0, 0
  46. };
  47. rt_inline rt_int32_t sdio_match_card(struct rt_mmcsd_card *card,
  48. const struct rt_sdio_device_id *id);
  49. rt_int32_t sdio_io_send_op_cond(struct rt_mmcsd_host *host,
  50. rt_uint32_t ocr,
  51. rt_uint32_t *cmd5_resp)
  52. {
  53. struct rt_mmcsd_cmd cmd;
  54. rt_int32_t i, err = 0;
  55. RT_ASSERT(host != RT_NULL);
  56. rt_memset(&cmd, 0, sizeof(struct rt_mmcsd_cmd));
  57. cmd.cmd_code = SD_IO_SEND_OP_COND;
  58. cmd.arg = ocr;
  59. cmd.flags = RESP_SPI_R4 | RESP_R4 | CMD_BCR;
  60. for (i = 100; i; i--)
  61. {
  62. err = mmcsd_send_cmd(host, &cmd, 0);
  63. if (err)
  64. break;
  65. /* if we're just probing, do a single pass */
  66. if (ocr == 0)
  67. break;
  68. /* otherwise wait until reset completes */
  69. if (controller_is_spi(host))
  70. {
  71. /*
  72. * Both R1_SPI_IDLE and MMC_CARD_BUSY indicate
  73. * an initialized card under SPI, but some cards
  74. * (Marvell's) only behave when looking at this
  75. * one.
  76. */
  77. if (cmd.resp[1] & CARD_BUSY)
  78. break;
  79. }
  80. else
  81. {
  82. if (cmd.resp[0] & CARD_BUSY)
  83. break;
  84. }
  85. err = -RT_ETIMEOUT;
  86. rt_thread_mdelay(10);
  87. }
  88. if (cmd5_resp)
  89. *cmd5_resp = cmd.resp[controller_is_spi(host) ? 1 : 0];
  90. return err;
  91. }
  92. rt_int32_t sdio_io_rw_direct(struct rt_mmcsd_card *card,
  93. rt_int32_t rw,
  94. rt_uint32_t fn,
  95. rt_uint32_t reg_addr,
  96. rt_uint8_t *pdata,
  97. rt_uint8_t raw)
  98. {
  99. struct rt_mmcsd_cmd cmd;
  100. rt_int32_t err;
  101. RT_ASSERT(card != RT_NULL);
  102. RT_ASSERT(fn <= SDIO_MAX_FUNCTIONS);
  103. RT_ASSERT(pdata != RT_NULL);
  104. if (reg_addr & ~SDIO_ARG_CMD53_REG_MASK)
  105. return -RT_ERROR;
  106. rt_memset(&cmd, 0, sizeof(struct rt_mmcsd_cmd));
  107. cmd.cmd_code = SD_IO_RW_DIRECT;
  108. cmd.arg = rw ? SDIO_ARG_CMD52_WRITE : SDIO_ARG_CMD52_READ;
  109. cmd.arg |= fn << SDIO_ARG_CMD52_FUNC_SHIFT;
  110. cmd.arg |= raw ? SDIO_ARG_CMD52_RAW_FLAG : 0x00000000;
  111. cmd.arg |= reg_addr << SDIO_ARG_CMD52_REG_SHIFT;
  112. cmd.arg |= *pdata;
  113. cmd.flags = RESP_SPI_R5 | RESP_R5 | CMD_AC;
  114. err = mmcsd_send_cmd(card->host, &cmd, 0);
  115. if (err)
  116. return err;
  117. if (!controller_is_spi(card->host))
  118. {
  119. if (cmd.resp[0] & R5_ERROR)
  120. return -RT_EIO;
  121. if (cmd.resp[0] & R5_FUNCTION_NUMBER)
  122. return -RT_ERROR;
  123. if (cmd.resp[0] & R5_OUT_OF_RANGE)
  124. return -RT_ERROR;
  125. }
  126. if (!rw || raw)
  127. {
  128. if (controller_is_spi(card->host))
  129. *pdata = (cmd.resp[0] >> 8) & 0xFF;
  130. else
  131. *pdata = cmd.resp[0] & 0xFF;
  132. }
  133. return 0;
  134. }
  135. rt_int32_t sdio_io_rw_extended(struct rt_mmcsd_card *card,
  136. rt_int32_t rw,
  137. rt_uint32_t fn,
  138. rt_uint32_t addr,
  139. rt_int32_t op_code,
  140. rt_uint8_t *buf,
  141. rt_uint32_t blocks,
  142. rt_uint32_t blksize)
  143. {
  144. struct rt_mmcsd_req req;
  145. struct rt_mmcsd_cmd cmd;
  146. struct rt_mmcsd_data data;
  147. RT_ASSERT(card != RT_NULL);
  148. RT_ASSERT(fn <= SDIO_MAX_FUNCTIONS);
  149. RT_ASSERT(blocks != 1 || blksize <= 512);
  150. RT_ASSERT(blocks != 0);
  151. RT_ASSERT(blksize != 0);
  152. if (addr & ~SDIO_ARG_CMD53_REG_MASK)
  153. return -RT_ERROR;
  154. rt_memset(&req, 0, sizeof(struct rt_mmcsd_req));
  155. rt_memset(&cmd, 0, sizeof(struct rt_mmcsd_cmd));
  156. rt_memset(&data, 0, sizeof(struct rt_mmcsd_data));
  157. req.cmd = &cmd;
  158. req.data = &data;
  159. cmd.cmd_code = SD_IO_RW_EXTENDED;
  160. cmd.arg = rw ? SDIO_ARG_CMD53_WRITE : SDIO_ARG_CMD53_READ;
  161. cmd.arg |= fn << SDIO_ARG_CMD53_FUNC_SHIFT;
  162. cmd.arg |= op_code ? SDIO_ARG_CMD53_INCREMENT : 0x00000000;
  163. cmd.arg |= addr << SDIO_ARG_CMD53_REG_SHIFT;
  164. if (blocks == 1 && blksize <= 512)
  165. cmd.arg |= (blksize == 512) ? 0 : blksize; /* byte mode */
  166. else
  167. cmd.arg |= SDIO_ARG_CMD53_BLOCK_MODE | blocks; /* block mode */
  168. cmd.flags = RESP_SPI_R5 | RESP_R5 | CMD_ADTC;
  169. data.blksize = blksize;
  170. data.blks = blocks;
  171. data.flags = rw ? DATA_DIR_WRITE : DATA_DIR_READ;
  172. data.buf = (rt_uint32_t *)buf;
  173. mmcsd_set_data_timeout(&data, card);
  174. mmcsd_send_request(card->host, &req);
  175. if (cmd.err)
  176. return cmd.err;
  177. if (data.err)
  178. return data.err;
  179. if (!controller_is_spi(card->host))
  180. {
  181. if (cmd.resp[0] & R5_ERROR)
  182. return -RT_EIO;
  183. if (cmd.resp[0] & R5_FUNCTION_NUMBER)
  184. return -RT_ERROR;
  185. if (cmd.resp[0] & R5_OUT_OF_RANGE)
  186. return -RT_ERROR;
  187. }
  188. return 0;
  189. }
  190. rt_inline rt_uint32_t sdio_max_block_size(struct rt_sdio_function *func)
  191. {
  192. rt_uint32_t size = MIN(func->card->host->max_seg_size,
  193. func->card->host->max_blk_size);
  194. size = MIN(size, func->max_blk_size);
  195. return MIN(size, 512u); /* maximum size for byte mode */
  196. }
  197. rt_int32_t sdio_io_rw_extended_block(struct rt_sdio_function *func,
  198. rt_int32_t rw,
  199. rt_uint32_t addr,
  200. rt_int32_t op_code,
  201. rt_uint8_t *buf,
  202. rt_uint32_t len)
  203. {
  204. rt_int32_t ret;
  205. rt_uint32_t left_size;
  206. rt_uint32_t max_blks, blks;
  207. RT_ASSERT(func != RT_NULL);
  208. RT_ASSERT(func->card != RT_NULL);
  209. left_size = len;
  210. /* Do the bulk of the transfer using block mode (if supported). */
  211. if (func->card->cccr.multi_block && (len > sdio_max_block_size(func)))
  212. {
  213. max_blks = MIN(func->card->host->max_blk_count,
  214. func->card->host->max_seg_size / func->cur_blk_size);
  215. max_blks = MIN(max_blks, 511u);
  216. while (left_size > func->cur_blk_size)
  217. {
  218. blks = left_size / func->cur_blk_size;
  219. if (blks > max_blks)
  220. blks = max_blks;
  221. len = blks * func->cur_blk_size;
  222. ret = sdio_io_rw_extended(func->card, rw, func->num,
  223. addr, op_code, buf, blks, func->cur_blk_size);
  224. if (ret)
  225. return ret;
  226. left_size -= len;
  227. buf += len;
  228. if (op_code)
  229. addr += len;
  230. }
  231. }
  232. while (left_size > 0)
  233. {
  234. len = MIN(left_size, sdio_max_block_size(func));
  235. ret = sdio_io_rw_extended(func->card, rw, func->num,
  236. addr, op_code, buf, 1, len);
  237. if (ret)
  238. return ret;
  239. left_size -= len;
  240. buf += len;
  241. if (op_code)
  242. addr += len;
  243. }
  244. return 0;
  245. }
  246. rt_uint8_t sdio_io_readb(struct rt_sdio_function *func,
  247. rt_uint32_t reg,
  248. rt_int32_t *err)
  249. {
  250. rt_uint8_t data = 0;
  251. rt_int32_t ret;
  252. ret = sdio_io_rw_direct(func->card, 0, func->num, reg, &data, 0);
  253. if (err)
  254. {
  255. *err = ret;
  256. }
  257. return data;
  258. }
  259. rt_int32_t sdio_io_writeb(struct rt_sdio_function *func,
  260. rt_uint32_t reg,
  261. rt_uint8_t data)
  262. {
  263. return sdio_io_rw_direct(func->card, 1, func->num, reg, &data, 0);
  264. }
  265. rt_uint16_t sdio_io_readw(struct rt_sdio_function *func,
  266. rt_uint32_t addr,
  267. rt_int32_t *err)
  268. {
  269. rt_int32_t ret;
  270. rt_uint32_t dmabuf;
  271. if (err)
  272. *err = 0;
  273. ret = sdio_io_rw_extended_block(func, 0, addr, 1, (rt_uint8_t *)&dmabuf, 2);
  274. if (ret)
  275. {
  276. if (err)
  277. *err = ret;
  278. }
  279. return (rt_uint16_t)dmabuf;
  280. }
  281. rt_int32_t sdio_io_writew(struct rt_sdio_function *func,
  282. rt_uint16_t data,
  283. rt_uint32_t addr)
  284. {
  285. rt_uint32_t dmabuf = data;
  286. return sdio_io_rw_extended_block(func, 1, addr, 1, (rt_uint8_t *)&dmabuf, 2);
  287. }
  288. rt_uint32_t sdio_io_readl(struct rt_sdio_function *func,
  289. rt_uint32_t addr,
  290. rt_int32_t *err)
  291. {
  292. rt_int32_t ret;
  293. rt_uint32_t dmabuf;
  294. if (err)
  295. *err = 0;
  296. ret = sdio_io_rw_extended_block(func, 0, addr, 1, (rt_uint8_t *)&dmabuf, 4);
  297. if (ret)
  298. {
  299. if (err)
  300. *err = ret;
  301. }
  302. return dmabuf;
  303. }
  304. rt_int32_t sdio_io_writel(struct rt_sdio_function *func,
  305. rt_uint32_t data,
  306. rt_uint32_t addr)
  307. {
  308. rt_uint32_t dmabuf = data;
  309. return sdio_io_rw_extended_block(func, 1, addr, 1, (rt_uint8_t *)&dmabuf, 4);
  310. }
  311. rt_int32_t sdio_io_read_multi_fifo_b(struct rt_sdio_function *func,
  312. rt_uint32_t addr,
  313. rt_uint8_t *buf,
  314. rt_uint32_t len)
  315. {
  316. return sdio_io_rw_extended_block(func, 0, addr, 0, buf, len);
  317. }
  318. rt_int32_t sdio_io_write_multi_fifo_b(struct rt_sdio_function *func,
  319. rt_uint32_t addr,
  320. rt_uint8_t *buf,
  321. rt_uint32_t len)
  322. {
  323. return sdio_io_rw_extended_block(func, 1, addr, 0, buf, len);
  324. }
  325. rt_int32_t sdio_io_read_multi_incr_b(struct rt_sdio_function *func,
  326. rt_uint32_t addr,
  327. rt_uint8_t *buf,
  328. rt_uint32_t len)
  329. {
  330. return sdio_io_rw_extended_block(func, 0, addr, 1, buf, len);
  331. }
  332. rt_int32_t sdio_io_write_multi_incr_b(struct rt_sdio_function *func,
  333. rt_uint32_t addr,
  334. rt_uint8_t *buf,
  335. rt_uint32_t len)
  336. {
  337. return sdio_io_rw_extended_block(func, 1, addr, 1, buf, len);
  338. }
  339. static rt_int32_t sdio_read_cccr(struct rt_mmcsd_card *card)
  340. {
  341. rt_int32_t ret;
  342. rt_int32_t cccr_version;
  343. rt_uint8_t data;
  344. rt_memset(&card->cccr, 0, sizeof(struct rt_sdio_cccr));
  345. data = sdio_io_readb(card->sdio_function[0], SDIO_REG_CCCR_CCCR_REV, &ret);
  346. if (ret)
  347. goto out;
  348. cccr_version = data & 0x0f;
  349. if (cccr_version > SDIO_CCCR_REV_3_00)
  350. {
  351. LOG_E("unrecognised CCCR structure version %d", cccr_version);
  352. return -RT_ERROR;
  353. }
  354. card->cccr.sdio_version = (data & 0xf0) >> 4;
  355. data = sdio_io_readb(card->sdio_function[0], SDIO_REG_CCCR_CARD_CAPS, &ret);
  356. if (ret)
  357. goto out;
  358. if (data & SDIO_CCCR_CAP_SMB)
  359. card->cccr.multi_block = 1;
  360. if (data & SDIO_CCCR_CAP_LSC)
  361. card->cccr.low_speed = 1;
  362. if (data & SDIO_CCCR_CAP_4BLS)
  363. card->cccr.low_speed_4 = 1;
  364. if (data & SDIO_CCCR_CAP_4BLS)
  365. card->cccr.bus_width = 1;
  366. if (cccr_version >= SDIO_CCCR_REV_1_10)
  367. {
  368. data = sdio_io_readb(card->sdio_function[0], SDIO_REG_CCCR_POWER_CTRL, &ret);
  369. if (ret)
  370. goto out;
  371. if (data & SDIO_POWER_SMPC)
  372. card->cccr.power_ctrl = 1;
  373. }
  374. if (cccr_version >= SDIO_CCCR_REV_1_20)
  375. {
  376. data = sdio_io_readb(card->sdio_function[0], SDIO_REG_CCCR_SPEED, &ret);
  377. if (ret)
  378. goto out;
  379. if (data & SDIO_SPEED_SHS)
  380. card->cccr.high_speed = 1;
  381. }
  382. out:
  383. return ret;
  384. }
  385. static rt_int32_t cistpl_funce_func0(struct rt_mmcsd_card *card,
  386. const rt_uint8_t *buf,
  387. rt_uint32_t size)
  388. {
  389. if (size < 0x04 || buf[0] != 0)
  390. return -RT_ERROR;
  391. /* TPLFE_FN0_BLK_SIZE */
  392. card->cis.func0_blk_size = buf[1] | (buf[2] << 8);
  393. /* TPLFE_MAX_TRAN_SPEED */
  394. card->cis.max_tran_speed = speed_value[(buf[3] >> 3) & 15] *
  395. speed_unit[buf[3] & 7];
  396. return 0;
  397. }
  398. static rt_int32_t cistpl_funce_func(struct rt_sdio_function *func,
  399. const rt_uint8_t *buf,
  400. rt_uint32_t size)
  401. {
  402. rt_uint32_t version;
  403. rt_uint32_t min_size;
  404. version = func->card->cccr.sdio_version;
  405. min_size = (version == SDIO_SDIO_REV_1_00) ? 28 : 42;
  406. if (size < min_size || buf[0] != 1)
  407. return -RT_ERROR;
  408. /* TPLFE_MAX_BLK_SIZE */
  409. func->max_blk_size = buf[12] | (buf[13] << 8);
  410. /* TPLFE_ENABLE_TIMEOUT_VAL, present in ver 1.1 and above */
  411. if (version > SDIO_SDIO_REV_1_00)
  412. func->enable_timeout_val = (buf[28] | (buf[29] << 8)) * 10;
  413. else
  414. func->enable_timeout_val = 1000; /* 1000ms */
  415. return 0;
  416. }
  417. static rt_int32_t sdio_read_cis(struct rt_sdio_function *func)
  418. {
  419. rt_int32_t ret;
  420. struct rt_sdio_function_tuple *curr, **prev;
  421. rt_uint32_t i, cisptr = 0;
  422. rt_uint8_t data;
  423. rt_uint8_t tpl_code, tpl_link;
  424. struct rt_mmcsd_card *card = func->card;
  425. struct rt_sdio_function *func0 = card->sdio_function[0];
  426. RT_ASSERT(func0 != RT_NULL);
  427. for (i = 0; i < 3; i++)
  428. {
  429. data = sdio_io_readb(func0,
  430. SDIO_REG_FBR_BASE(func->num) + SDIO_REG_FBR_CIS + i, &ret);
  431. if (ret)
  432. return ret;
  433. cisptr |= data << (i * 8);
  434. }
  435. prev = &func->tuples;
  436. do {
  437. tpl_code = sdio_io_readb(func0, cisptr++, &ret);
  438. if (ret)
  439. break;
  440. tpl_link = sdio_io_readb(func0, cisptr++, &ret);
  441. if (ret)
  442. break;
  443. if ((tpl_code == CISTPL_END) || (tpl_link == 0xff))
  444. break;
  445. if (tpl_code == CISTPL_NULL)
  446. continue;
  447. curr = rt_malloc(sizeof(struct rt_sdio_function_tuple) + tpl_link);
  448. if (!curr)
  449. return -RT_ENOMEM;
  450. curr->data = (rt_uint8_t *)curr + sizeof(struct rt_sdio_function_tuple);
  451. for (i = 0; i < tpl_link; i++)
  452. {
  453. curr->data[i] = sdio_io_readb(func0, cisptr + i, &ret);
  454. if (ret)
  455. break;
  456. }
  457. if (ret)
  458. {
  459. rt_free(curr);
  460. break;
  461. }
  462. switch (tpl_code)
  463. {
  464. case CISTPL_MANFID:
  465. if (tpl_link < 4)
  466. {
  467. LOG_D("bad CISTPL_MANFID length");
  468. }
  469. else
  470. {
  471. if (func->num != 0)
  472. {
  473. func->manufacturer = curr->data[0];
  474. func->manufacturer |= curr->data[1] << 8;
  475. func->product = curr->data[2];
  476. func->product |= curr->data[3] << 8;
  477. }
  478. else
  479. {
  480. card->cis.manufacturer = curr->data[0];
  481. card->cis.manufacturer |= curr->data[1] << 8;
  482. card->cis.product = curr->data[2];
  483. card->cis.product |= curr->data[3] << 8;
  484. }
  485. }
  486. rt_free(curr);
  487. break;
  488. case CISTPL_FUNCE:
  489. if (func->num != 0)
  490. ret = cistpl_funce_func(func, curr->data, tpl_link);
  491. else
  492. ret = cistpl_funce_func0(card, curr->data, tpl_link);
  493. if (ret)
  494. {
  495. LOG_D("bad CISTPL_FUNCE size %u "
  496. "type %u", tpl_link, curr->data[0]);
  497. }
  498. break;
  499. case CISTPL_VERS_1:
  500. if (tpl_link < 2)
  501. {
  502. LOG_D("CISTPL_VERS_1 too short");
  503. }
  504. break;
  505. default:
  506. /* this tuple is unknown to the core */
  507. curr->next = RT_NULL;
  508. curr->code = tpl_code;
  509. curr->size = tpl_link;
  510. *prev = curr;
  511. prev = &curr->next;
  512. LOG_D( "function %d, CIS tuple code %#x, length %d",
  513. func->num, tpl_code, tpl_link);
  514. break;
  515. }
  516. cisptr += tpl_link;
  517. } while (1);
  518. /*
  519. * Link in all unknown tuples found in the common CIS so that
  520. * drivers don't have to go digging in two places.
  521. */
  522. if (func->num != 0)
  523. *prev = func0->tuples;
  524. return ret;
  525. }
  526. void sdio_free_cis(struct rt_sdio_function *func)
  527. {
  528. struct rt_sdio_function_tuple *tuple, *tmp;
  529. struct rt_mmcsd_card *card = func->card;
  530. tuple = func->tuples;
  531. while (tuple && ((tuple != card->sdio_function[0]->tuples) || (!func->num)))
  532. {
  533. tmp = tuple;
  534. tuple = tuple->next;
  535. rt_free(tmp);
  536. }
  537. func->tuples = RT_NULL;
  538. }
  539. static rt_int32_t sdio_read_fbr(struct rt_sdio_function *func)
  540. {
  541. rt_int32_t ret;
  542. rt_uint8_t data;
  543. struct rt_sdio_function *func0 = func->card->sdio_function[0];
  544. data = sdio_io_readb(func0,
  545. SDIO_REG_FBR_BASE(func->num) + SDIO_REG_FBR_STD_FUNC_IF, &ret);
  546. if (ret)
  547. goto err;
  548. data &= 0x0f;
  549. if (data == 0x0f)
  550. {
  551. data = sdio_io_readb(func0,
  552. SDIO_REG_FBR_BASE(func->num) + SDIO_REG_FBR_STD_IF_EXT, &ret);
  553. if (ret)
  554. goto err;
  555. }
  556. func->func_code = data;
  557. err:
  558. return ret;
  559. }
  560. static rt_int32_t sdio_initialize_function(struct rt_mmcsd_card *card,
  561. rt_uint32_t func_num)
  562. {
  563. rt_int32_t ret;
  564. struct rt_sdio_function *func;
  565. RT_ASSERT(func_num <= SDIO_MAX_FUNCTIONS);
  566. func = rt_malloc(sizeof(struct rt_sdio_function));
  567. if (!func)
  568. {
  569. LOG_E("malloc rt_sdio_function failed");
  570. ret = -RT_ENOMEM;
  571. goto err;
  572. }
  573. rt_memset(func, 0, sizeof(struct rt_sdio_function));
  574. func->card = card;
  575. func->num = func_num;
  576. ret = sdio_read_fbr(func);
  577. if (ret)
  578. goto err1;
  579. ret = sdio_read_cis(func);
  580. if (ret)
  581. goto err1;
  582. /*
  583. * product/manufacturer id is optional for function CIS, so
  584. * copy it from the card structure as needed.
  585. */
  586. if (func->product == 0)
  587. {
  588. func->manufacturer = card->cis.manufacturer;
  589. func->product = card->cis.product;
  590. }
  591. card->sdio_function[func_num] = func;
  592. return 0;
  593. err1:
  594. sdio_free_cis(func);
  595. rt_free(func);
  596. card->sdio_function[func_num] = RT_NULL;
  597. err:
  598. return ret;
  599. }
  600. static rt_int32_t sdio_set_highspeed(struct rt_mmcsd_card *card)
  601. {
  602. rt_int32_t ret;
  603. rt_uint8_t speed;
  604. if (!(card->host->flags & MMCSD_SUP_HIGHSPEED))
  605. return 0;
  606. if (!card->cccr.high_speed)
  607. return 0;
  608. speed = sdio_io_readb(card->sdio_function[0], SDIO_REG_CCCR_SPEED, &ret);
  609. if (ret)
  610. return ret;
  611. speed |= SDIO_SPEED_EHS;
  612. ret = sdio_io_writeb(card->sdio_function[0], SDIO_REG_CCCR_SPEED, speed);
  613. if (ret)
  614. return ret;
  615. card->flags |= CARD_FLAG_HIGHSPEED;
  616. return 0;
  617. }
  618. static rt_int32_t sdio_set_bus_wide(struct rt_mmcsd_card *card)
  619. {
  620. rt_int32_t ret;
  621. rt_uint8_t busif;
  622. if (!(card->host->flags & MMCSD_BUSWIDTH_4))
  623. return 0;
  624. if (card->cccr.low_speed && !card->cccr.bus_width)
  625. return 0;
  626. busif = sdio_io_readb(card->sdio_function[0], SDIO_REG_CCCR_BUS_IF, &ret);
  627. if (ret)
  628. return ret;
  629. busif |= SDIO_BUS_WIDTH_4BIT;
  630. ret = sdio_io_writeb(card->sdio_function[0], SDIO_REG_CCCR_BUS_IF, busif);
  631. if (ret)
  632. return ret;
  633. mmcsd_set_bus_width(card->host, MMCSD_BUS_WIDTH_4);
  634. return 0;
  635. }
  636. static rt_int32_t sdio_register_card(struct rt_mmcsd_card *card)
  637. {
  638. struct sdio_card *sc;
  639. struct sdio_driver *sd;
  640. rt_list_t *l;
  641. sc = rt_malloc(sizeof(struct sdio_card));
  642. if (sc == RT_NULL)
  643. {
  644. LOG_E("malloc sdio card failed");
  645. return -RT_ENOMEM;
  646. }
  647. sc->card = card;
  648. rt_list_insert_after(&sdio_cards, &sc->list);
  649. if (rt_list_isempty(&sdio_drivers))
  650. {
  651. goto out;
  652. }
  653. for (l = (&sdio_drivers)->next; l != &sdio_drivers; l = l->next)
  654. {
  655. sd = (struct sdio_driver *)rt_list_entry(l, struct sdio_driver, list);
  656. if (sdio_match_card(card, sd->drv->id))
  657. {
  658. sd->drv->probe(card);
  659. }
  660. }
  661. out:
  662. return 0;
  663. }
  664. static rt_int32_t sdio_init_card(struct rt_mmcsd_host *host, rt_uint32_t ocr)
  665. {
  666. rt_int32_t err = 0;
  667. rt_int32_t i, function_num;
  668. rt_uint32_t cmd5_resp;
  669. struct rt_mmcsd_card *card;
  670. err = sdio_io_send_op_cond(host, ocr, &cmd5_resp);
  671. if (err)
  672. goto err;
  673. if (controller_is_spi(host))
  674. {
  675. err = mmcsd_spi_use_crc(host, host->spi_use_crc);
  676. if (err)
  677. goto err;
  678. }
  679. function_num = (cmd5_resp & 0x70000000) >> 28;
  680. card = rt_malloc(sizeof(struct rt_mmcsd_card));
  681. if (!card)
  682. {
  683. LOG_E("malloc card failed");
  684. err = -RT_ENOMEM;
  685. goto err;
  686. }
  687. rt_memset(card, 0, sizeof(struct rt_mmcsd_card));
  688. card->card_type = CARD_TYPE_SDIO;
  689. card->sdio_function_num = function_num;
  690. card->host = host;
  691. host->card = card;
  692. card->sdio_function[0] = rt_malloc(sizeof(struct rt_sdio_function));
  693. if (!card->sdio_function[0])
  694. {
  695. LOG_E("malloc sdio_func0 failed");
  696. err = -RT_ENOMEM;
  697. goto err1;
  698. }
  699. rt_memset(card->sdio_function[0], 0, sizeof(struct rt_sdio_function));
  700. card->sdio_function[0]->card = card;
  701. card->sdio_function[0]->num = 0;
  702. if (!controller_is_spi(host))
  703. {
  704. err = mmcsd_get_card_addr(host, &card->rca);
  705. if (err)
  706. goto err2;
  707. mmcsd_set_bus_mode(host, MMCSD_BUSMODE_PUSHPULL);
  708. }
  709. if (!controller_is_spi(host))
  710. {
  711. err = mmcsd_select_card(card);
  712. if (err)
  713. goto err2;
  714. }
  715. err = sdio_read_cccr(card);
  716. if (err)
  717. goto err2;
  718. err = sdio_read_cis(card->sdio_function[0]);
  719. if (err)
  720. goto err2;
  721. err = sdio_set_highspeed(card);
  722. if (err)
  723. goto err2;
  724. if (card->flags & CARD_FLAG_HIGHSPEED)
  725. {
  726. mmcsd_set_clock(host, card->host->freq_max > 50000000 ? 50000000 : card->host->freq_max);
  727. }
  728. else
  729. {
  730. mmcsd_set_clock(host, card->cis.max_tran_speed);
  731. }
  732. err = sdio_set_bus_wide(card);
  733. if (err)
  734. goto err2;
  735. for (i = 1; i < function_num + 1; i++)
  736. {
  737. err = sdio_initialize_function(card, i);
  738. if (err)
  739. goto err3;
  740. }
  741. /* register sdio card */
  742. err = sdio_register_card(card);
  743. if (err)
  744. {
  745. goto err3;
  746. }
  747. return 0;
  748. err3:
  749. if (host->card)
  750. {
  751. for (i = 1; i < host->card->sdio_function_num + 1; i++)
  752. {
  753. if (host->card->sdio_function[i])
  754. {
  755. sdio_free_cis(host->card->sdio_function[i]);
  756. rt_free(host->card->sdio_function[i]);
  757. host->card->sdio_function[i] = RT_NULL;
  758. }
  759. }
  760. }
  761. err2:
  762. if (host->card && host->card->sdio_function[0])
  763. {
  764. sdio_free_cis(host->card->sdio_function[0]);
  765. rt_free(host->card->sdio_function[0]);
  766. host->card->sdio_function[0] = RT_NULL;
  767. }
  768. err1:
  769. if (host->card)
  770. {
  771. rt_free(host->card);
  772. }
  773. err:
  774. LOG_E("error %d while initialising SDIO card", err);
  775. return err;
  776. }
  777. rt_int32_t init_sdio(struct rt_mmcsd_host *host, rt_uint32_t ocr)
  778. {
  779. rt_int32_t err;
  780. rt_uint32_t current_ocr;
  781. RT_ASSERT(host != RT_NULL);
  782. if (ocr & 0x7F)
  783. {
  784. LOG_W("Card ocr below the defined voltage rang.");
  785. ocr &= ~0x7F;
  786. }
  787. if (ocr & VDD_165_195)
  788. {
  789. LOG_W("Can't support the low voltage SDIO card.");
  790. ocr &= ~VDD_165_195;
  791. }
  792. current_ocr = mmcsd_select_voltage(host, ocr);
  793. if (!current_ocr)
  794. {
  795. err = -RT_ERROR;
  796. goto err;
  797. }
  798. err = sdio_init_card(host, current_ocr);
  799. if (err)
  800. goto remove_card;
  801. return 0;
  802. remove_card:
  803. rt_free(host->card);
  804. host->card = RT_NULL;
  805. err:
  806. LOG_E("init SDIO card failed");
  807. return err;
  808. }
  809. static void sdio_irq_thread(void *param)
  810. {
  811. rt_int32_t i, ret;
  812. rt_uint8_t pending;
  813. struct rt_mmcsd_card *card;
  814. struct rt_mmcsd_host *host = (struct rt_mmcsd_host *)param;
  815. RT_ASSERT(host != RT_NULL);
  816. card = host->card;
  817. RT_ASSERT(card != RT_NULL);
  818. while (1)
  819. {
  820. if (rt_sem_take(host->sdio_irq_sem, RT_WAITING_FOREVER) == RT_EOK)
  821. {
  822. mmcsd_host_lock(host);
  823. pending = sdio_io_readb(host->card->sdio_function[0],
  824. SDIO_REG_CCCR_INT_PEND, &ret);
  825. if (ret)
  826. {
  827. mmcsd_dbg("error %d reading SDIO_REG_CCCR_INT_PEND\n", ret);
  828. goto out;
  829. }
  830. for (i = 1; i <= 7; i++)
  831. {
  832. if (pending & (1 << i))
  833. {
  834. struct rt_sdio_function *func = card->sdio_function[i];
  835. if (!func)
  836. {
  837. mmcsd_dbg("pending IRQ for "
  838. "non-existant function %d\n", func->num);
  839. goto out;
  840. }
  841. else if (func->irq_handler)
  842. {
  843. func->irq_handler(func);
  844. }
  845. else
  846. {
  847. mmcsd_dbg("pending IRQ with no register handler\n");
  848. goto out;
  849. }
  850. }
  851. }
  852. out:
  853. mmcsd_host_unlock(host);
  854. if (host->flags & MMCSD_SUP_SDIO_IRQ)
  855. host->ops->enable_sdio_irq(host, 1);
  856. continue;
  857. }
  858. }
  859. }
  860. static rt_int32_t sdio_irq_thread_create(struct rt_mmcsd_card *card)
  861. {
  862. struct rt_mmcsd_host *host = card->host;
  863. /* init semaphore and create sdio irq processing thread */
  864. if (!host->sdio_irq_num)
  865. {
  866. host->sdio_irq_num++;
  867. host->sdio_irq_sem = rt_sem_create("sdio_irq", 0, RT_IPC_FLAG_FIFO);
  868. RT_ASSERT(host->sdio_irq_sem != RT_NULL);
  869. host->sdio_irq_thread = rt_thread_create("sdio_irq", sdio_irq_thread, host,
  870. RT_SDIO_STACK_SIZE, RT_SDIO_THREAD_PRIORITY, 20);
  871. if (host->sdio_irq_thread != RT_NULL)
  872. {
  873. rt_thread_startup(host->sdio_irq_thread);
  874. }
  875. }
  876. return 0;
  877. }
  878. static rt_int32_t sdio_irq_thread_delete(struct rt_mmcsd_card *card)
  879. {
  880. struct rt_mmcsd_host *host = card->host;
  881. RT_ASSERT(host->sdio_irq_num > 0);
  882. host->sdio_irq_num--;
  883. if (!host->sdio_irq_num)
  884. {
  885. if (host->flags & MMCSD_SUP_SDIO_IRQ)
  886. host->ops->enable_sdio_irq(host, 0);
  887. rt_sem_delete(host->sdio_irq_sem);
  888. host->sdio_irq_sem = RT_NULL;
  889. rt_thread_delete(host->sdio_irq_thread);
  890. host->sdio_irq_thread = RT_NULL;
  891. }
  892. return 0;
  893. }
  894. rt_int32_t sdio_attach_irq(struct rt_sdio_function *func,
  895. rt_sdio_irq_handler_t *handler)
  896. {
  897. rt_int32_t ret;
  898. rt_uint8_t reg;
  899. struct rt_sdio_function *func0;
  900. RT_ASSERT(func != RT_NULL);
  901. RT_ASSERT(func->card != RT_NULL);
  902. func0 = func->card->sdio_function[0];
  903. mmcsd_dbg("SDIO: enabling IRQ for function %d\n", func->num);
  904. if (func->irq_handler)
  905. {
  906. mmcsd_dbg("SDIO: IRQ for already in use.\n");
  907. return -RT_EBUSY;
  908. }
  909. reg = sdio_io_readb(func0, SDIO_REG_CCCR_INT_EN, &ret);
  910. if (ret)
  911. return ret;
  912. reg |= 1 << func->num;
  913. reg |= 1; /* Master interrupt enable */
  914. ret = sdio_io_writeb(func0, SDIO_REG_CCCR_INT_EN, reg);
  915. if (ret)
  916. return ret;
  917. func->irq_handler = handler;
  918. ret = sdio_irq_thread_create(func->card);
  919. if (ret)
  920. func->irq_handler = RT_NULL;
  921. return ret;
  922. }
  923. rt_int32_t sdio_detach_irq(struct rt_sdio_function *func)
  924. {
  925. rt_int32_t ret;
  926. rt_uint8_t reg;
  927. struct rt_sdio_function *func0;
  928. RT_ASSERT(func != RT_NULL);
  929. RT_ASSERT(func->card != RT_NULL);
  930. func0 = func->card->sdio_function[0];
  931. mmcsd_dbg("SDIO: disabling IRQ for function %d\n", func->num);
  932. if (func->irq_handler)
  933. {
  934. func->irq_handler = RT_NULL;
  935. sdio_irq_thread_delete(func->card);
  936. }
  937. reg = sdio_io_readb(func0, SDIO_REG_CCCR_INT_EN, &ret);
  938. if (ret)
  939. return ret;
  940. reg &= ~(1 << func->num);
  941. /* Disable master interrupt with the last function interrupt */
  942. if (!(reg & 0xFE))
  943. reg = 0;
  944. ret = sdio_io_writeb(func0, SDIO_REG_CCCR_INT_EN, reg);
  945. if (ret)
  946. return ret;
  947. return 0;
  948. }
  949. void sdio_irq_wakeup(struct rt_mmcsd_host *host)
  950. {
  951. if (host->flags & MMCSD_SUP_SDIO_IRQ)
  952. host->ops->enable_sdio_irq(host, 0);
  953. if (host->sdio_irq_sem)
  954. rt_sem_release(host->sdio_irq_sem);
  955. }
  956. rt_int32_t sdio_enable_func(struct rt_sdio_function *func)
  957. {
  958. rt_int32_t ret;
  959. rt_uint8_t reg;
  960. rt_uint32_t timeout;
  961. struct rt_sdio_function *func0;
  962. RT_ASSERT(func != RT_NULL);
  963. RT_ASSERT(func->card != RT_NULL);
  964. func0 = func->card->sdio_function[0];
  965. mmcsd_dbg("SDIO: enabling function %d\n", func->num);
  966. reg = sdio_io_readb(func0, SDIO_REG_CCCR_IO_EN, &ret);
  967. if (ret)
  968. goto err;
  969. reg |= 1 << func->num;
  970. ret = sdio_io_writeb(func0, SDIO_REG_CCCR_IO_EN, reg);
  971. if (ret)
  972. goto err;
  973. timeout = rt_tick_get() + func->enable_timeout_val * RT_TICK_PER_SECOND / 1000;
  974. while (1)
  975. {
  976. reg = sdio_io_readb(func0, SDIO_REG_CCCR_IO_RDY, &ret);
  977. if (ret)
  978. goto err;
  979. if (reg & (1 << func->num))
  980. break;
  981. ret = -RT_ETIMEOUT;
  982. if (rt_tick_get() > timeout)
  983. goto err;
  984. }
  985. mmcsd_dbg("SDIO: enabled function successfull\n");
  986. return 0;
  987. err:
  988. mmcsd_dbg("SDIO: failed to enable function %d\n", func->num);
  989. return ret;
  990. }
  991. rt_int32_t sdio_disable_func(struct rt_sdio_function *func)
  992. {
  993. rt_int32_t ret;
  994. rt_uint8_t reg;
  995. struct rt_sdio_function *func0;
  996. RT_ASSERT(func != RT_NULL);
  997. RT_ASSERT(func->card != RT_NULL);
  998. func0 = func->card->sdio_function[0];
  999. mmcsd_dbg("SDIO: disabling function %d\n", func->num);
  1000. reg = sdio_io_readb(func0, SDIO_REG_CCCR_IO_EN, &ret);
  1001. if (ret)
  1002. goto err;
  1003. reg &= ~(1 << func->num);
  1004. ret = sdio_io_writeb(func0, SDIO_REG_CCCR_IO_EN, reg);
  1005. if (ret)
  1006. goto err;
  1007. mmcsd_dbg("SDIO: disabled function successfull\n");
  1008. return 0;
  1009. err:
  1010. mmcsd_dbg("SDIO: failed to disable function %d\n", func->num);
  1011. return -RT_EIO;
  1012. }
  1013. void sdio_set_drvdata(struct rt_sdio_function *func, void *data)
  1014. {
  1015. func->priv = data;
  1016. }
  1017. void* sdio_get_drvdata(struct rt_sdio_function *func)
  1018. {
  1019. return func->priv;
  1020. }
  1021. rt_int32_t sdio_set_block_size(struct rt_sdio_function *func,
  1022. rt_uint32_t blksize)
  1023. {
  1024. rt_int32_t ret;
  1025. struct rt_sdio_function *func0 = func->card->sdio_function[0];
  1026. if (blksize > func->card->host->max_blk_size)
  1027. return -RT_ERROR;
  1028. if (blksize == 0)
  1029. {
  1030. blksize = MIN(func->max_blk_size, func->card->host->max_blk_size);
  1031. blksize = MIN(blksize, 512u);
  1032. }
  1033. ret = sdio_io_writeb(func0, SDIO_REG_FBR_BASE(func->num) + SDIO_REG_FBR_BLKSIZE,
  1034. blksize & 0xff);
  1035. if (ret)
  1036. return ret;
  1037. ret = sdio_io_writeb(func0, SDIO_REG_FBR_BASE(func->num) + SDIO_REG_FBR_BLKSIZE + 1,
  1038. (blksize >> 8) & 0xff);
  1039. if (ret)
  1040. return ret;
  1041. func->cur_blk_size = blksize;
  1042. return 0;
  1043. }
  1044. rt_inline rt_int32_t sdio_match_card(struct rt_mmcsd_card *card,
  1045. const struct rt_sdio_device_id *id)
  1046. {
  1047. rt_uint8_t num = 1;
  1048. if ((id->manufacturer != SDIO_ANY_MAN_ID) &&
  1049. (id->manufacturer != card->cis.manufacturer))
  1050. return 0;
  1051. while (num <= card->sdio_function_num)
  1052. {
  1053. if ((id->product != SDIO_ANY_PROD_ID) &&
  1054. (id->product == card->sdio_function[num]->product))
  1055. return 1;
  1056. num++;
  1057. }
  1058. return 0;
  1059. }
  1060. static struct rt_mmcsd_card *sdio_match_driver(struct rt_sdio_device_id *id)
  1061. {
  1062. rt_list_t *l;
  1063. struct sdio_card *sc;
  1064. struct rt_mmcsd_card *card;
  1065. for (l = (&sdio_cards)->next; l != &sdio_cards; l = l->next)
  1066. {
  1067. sc = (struct sdio_card *)rt_list_entry(l, struct sdio_card, list);
  1068. card = sc->card;
  1069. if (sdio_match_card(card, id))
  1070. {
  1071. return card;
  1072. }
  1073. }
  1074. return RT_NULL;
  1075. }
  1076. rt_int32_t sdio_register_driver(struct rt_sdio_driver *driver)
  1077. {
  1078. struct sdio_driver *sd;
  1079. struct rt_mmcsd_card *card;
  1080. sd = rt_malloc(sizeof(struct sdio_driver));
  1081. if (sd == RT_NULL)
  1082. {
  1083. LOG_E("malloc sdio driver failed");
  1084. return -RT_ENOMEM;
  1085. }
  1086. sd->drv = driver;
  1087. rt_list_insert_after(&sdio_drivers, &sd->list);
  1088. if (!rt_list_isempty(&sdio_cards))
  1089. {
  1090. card = sdio_match_driver(driver->id);
  1091. if (card != RT_NULL)
  1092. {
  1093. return driver->probe(card);
  1094. }
  1095. }
  1096. return -RT_EEMPTY;
  1097. }
  1098. rt_int32_t sdio_unregister_driver(struct rt_sdio_driver *driver)
  1099. {
  1100. rt_list_t *l;
  1101. struct sdio_driver *sd = RT_NULL;
  1102. struct rt_mmcsd_card *card;
  1103. for (l = (&sdio_drivers)->next; l != &sdio_drivers; l = l->next)
  1104. {
  1105. sd = (struct sdio_driver *)rt_list_entry(l, struct sdio_driver, list);
  1106. if (sd->drv != driver)
  1107. {
  1108. sd = RT_NULL;
  1109. }
  1110. }
  1111. if (sd == RT_NULL)
  1112. {
  1113. LOG_E("SDIO driver %s not register", driver->name);
  1114. return -RT_ERROR;
  1115. }
  1116. if (!rt_list_isempty(&sdio_cards))
  1117. {
  1118. card = sdio_match_driver(driver->id);
  1119. if (card != RT_NULL)
  1120. {
  1121. driver->remove(card);
  1122. rt_list_remove(&sd->list);
  1123. rt_free(sd);
  1124. }
  1125. }
  1126. return 0;
  1127. }
  1128. void rt_sdio_init(void)
  1129. {
  1130. }