regmap.c 31 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321
  1. /*
  2. * Register map access API
  3. *
  4. * Copyright 2011 Wolfson Microelectronics plc
  5. *
  6. * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
  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. #include <linux/device.h>
  13. #include <linux/slab.h>
  14. #include <linux/export.h>
  15. #include <linux/mutex.h>
  16. #include <linux/err.h>
  17. #include <linux/rbtree.h>
  18. #define CREATE_TRACE_POINTS
  19. #include <trace/events/regmap.h>
  20. #include "internal.h"
  21. static int _regmap_update_bits(struct regmap *map, unsigned int reg,
  22. unsigned int mask, unsigned int val,
  23. bool *change);
  24. bool regmap_writeable(struct regmap *map, unsigned int reg)
  25. {
  26. if (map->max_register && reg > map->max_register)
  27. return false;
  28. if (map->writeable_reg)
  29. return map->writeable_reg(map->dev, reg);
  30. return true;
  31. }
  32. bool regmap_readable(struct regmap *map, unsigned int reg)
  33. {
  34. if (map->max_register && reg > map->max_register)
  35. return false;
  36. if (map->format.format_write)
  37. return false;
  38. if (map->readable_reg)
  39. return map->readable_reg(map->dev, reg);
  40. return true;
  41. }
  42. bool regmap_volatile(struct regmap *map, unsigned int reg)
  43. {
  44. if (!regmap_readable(map, reg))
  45. return false;
  46. if (map->volatile_reg)
  47. return map->volatile_reg(map->dev, reg);
  48. return true;
  49. }
  50. bool regmap_precious(struct regmap *map, unsigned int reg)
  51. {
  52. if (!regmap_readable(map, reg))
  53. return false;
  54. if (map->precious_reg)
  55. return map->precious_reg(map->dev, reg);
  56. return false;
  57. }
  58. static bool regmap_volatile_range(struct regmap *map, unsigned int reg,
  59. unsigned int num)
  60. {
  61. unsigned int i;
  62. for (i = 0; i < num; i++)
  63. if (!regmap_volatile(map, reg + i))
  64. return false;
  65. return true;
  66. }
  67. static void regmap_format_2_6_write(struct regmap *map,
  68. unsigned int reg, unsigned int val)
  69. {
  70. u8 *out = map->work_buf;
  71. *out = (reg << 6) | val;
  72. }
  73. static void regmap_format_4_12_write(struct regmap *map,
  74. unsigned int reg, unsigned int val)
  75. {
  76. __be16 *out = map->work_buf;
  77. *out = cpu_to_be16((reg << 12) | val);
  78. }
  79. static void regmap_format_7_9_write(struct regmap *map,
  80. unsigned int reg, unsigned int val)
  81. {
  82. __be16 *out = map->work_buf;
  83. *out = cpu_to_be16((reg << 9) | val);
  84. }
  85. static void regmap_format_10_14_write(struct regmap *map,
  86. unsigned int reg, unsigned int val)
  87. {
  88. u8 *out = map->work_buf;
  89. out[2] = val;
  90. out[1] = (val >> 8) | (reg << 6);
  91. out[0] = reg >> 2;
  92. }
  93. static void regmap_format_8(void *buf, unsigned int val, unsigned int shift)
  94. {
  95. u8 *b = buf;
  96. b[0] = val << shift;
  97. }
  98. static void regmap_format_16(void *buf, unsigned int val, unsigned int shift)
  99. {
  100. __be16 *b = buf;
  101. b[0] = cpu_to_be16(val << shift);
  102. }
  103. static void regmap_format_24(void *buf, unsigned int val, unsigned int shift)
  104. {
  105. u8 *b = buf;
  106. val <<= shift;
  107. b[0] = val >> 16;
  108. b[1] = val >> 8;
  109. b[2] = val;
  110. }
  111. static void regmap_format_32(void *buf, unsigned int val, unsigned int shift)
  112. {
  113. __be32 *b = buf;
  114. b[0] = cpu_to_be32(val << shift);
  115. }
  116. static unsigned int regmap_parse_8(void *buf)
  117. {
  118. u8 *b = buf;
  119. return b[0];
  120. }
  121. static unsigned int regmap_parse_16(void *buf)
  122. {
  123. __be16 *b = buf;
  124. b[0] = be16_to_cpu(b[0]);
  125. return b[0];
  126. }
  127. static unsigned int regmap_parse_24(void *buf)
  128. {
  129. u8 *b = buf;
  130. unsigned int ret = b[2];
  131. ret |= ((unsigned int)b[1]) << 8;
  132. ret |= ((unsigned int)b[0]) << 16;
  133. return ret;
  134. }
  135. static unsigned int regmap_parse_32(void *buf)
  136. {
  137. __be32 *b = buf;
  138. b[0] = be32_to_cpu(b[0]);
  139. return b[0];
  140. }
  141. static void regmap_lock_mutex(struct regmap *map)
  142. {
  143. mutex_lock(&map->mutex);
  144. }
  145. static void regmap_unlock_mutex(struct regmap *map)
  146. {
  147. mutex_unlock(&map->mutex);
  148. }
  149. static void regmap_lock_spinlock(struct regmap *map)
  150. {
  151. spin_lock(&map->spinlock);
  152. }
  153. static void regmap_unlock_spinlock(struct regmap *map)
  154. {
  155. spin_unlock(&map->spinlock);
  156. }
  157. static void dev_get_regmap_release(struct device *dev, void *res)
  158. {
  159. /*
  160. * We don't actually have anything to do here; the goal here
  161. * is not to manage the regmap but to provide a simple way to
  162. * get the regmap back given a struct device.
  163. */
  164. }
  165. static bool _regmap_range_add(struct regmap *map,
  166. struct regmap_range_node *data)
  167. {
  168. struct rb_root *root = &map->range_tree;
  169. struct rb_node **new = &(root->rb_node), *parent = NULL;
  170. while (*new) {
  171. struct regmap_range_node *this =
  172. container_of(*new, struct regmap_range_node, node);
  173. parent = *new;
  174. if (data->range_max < this->range_min)
  175. new = &((*new)->rb_left);
  176. else if (data->range_min > this->range_max)
  177. new = &((*new)->rb_right);
  178. else
  179. return false;
  180. }
  181. rb_link_node(&data->node, parent, new);
  182. rb_insert_color(&data->node, root);
  183. return true;
  184. }
  185. static struct regmap_range_node *_regmap_range_lookup(struct regmap *map,
  186. unsigned int reg)
  187. {
  188. struct rb_node *node = map->range_tree.rb_node;
  189. while (node) {
  190. struct regmap_range_node *this =
  191. container_of(node, struct regmap_range_node, node);
  192. if (reg < this->range_min)
  193. node = node->rb_left;
  194. else if (reg > this->range_max)
  195. node = node->rb_right;
  196. else
  197. return this;
  198. }
  199. return NULL;
  200. }
  201. static void regmap_range_exit(struct regmap *map)
  202. {
  203. struct rb_node *next;
  204. struct regmap_range_node *range_node;
  205. next = rb_first(&map->range_tree);
  206. while (next) {
  207. range_node = rb_entry(next, struct regmap_range_node, node);
  208. next = rb_next(&range_node->node);
  209. rb_erase(&range_node->node, &map->range_tree);
  210. kfree(range_node);
  211. }
  212. kfree(map->selector_work_buf);
  213. }
  214. /**
  215. * regmap_init(): Initialise register map
  216. *
  217. * @dev: Device that will be interacted with
  218. * @bus: Bus-specific callbacks to use with device
  219. * @bus_context: Data passed to bus-specific callbacks
  220. * @config: Configuration for register map
  221. *
  222. * The return value will be an ERR_PTR() on error or a valid pointer to
  223. * a struct regmap. This function should generally not be called
  224. * directly, it should be called by bus-specific init functions.
  225. */
  226. struct regmap *regmap_init(struct device *dev,
  227. const struct regmap_bus *bus,
  228. void *bus_context,
  229. const struct regmap_config *config)
  230. {
  231. struct regmap *map, **m;
  232. int ret = -EINVAL;
  233. int i, j;
  234. if (!bus || !config)
  235. goto err;
  236. map = kzalloc(sizeof(*map), GFP_KERNEL);
  237. if (map == NULL) {
  238. ret = -ENOMEM;
  239. goto err;
  240. }
  241. if (bus->fast_io) {
  242. spin_lock_init(&map->spinlock);
  243. map->lock = regmap_lock_spinlock;
  244. map->unlock = regmap_unlock_spinlock;
  245. } else {
  246. mutex_init(&map->mutex);
  247. map->lock = regmap_lock_mutex;
  248. map->unlock = regmap_unlock_mutex;
  249. }
  250. map->format.reg_bytes = DIV_ROUND_UP(config->reg_bits, 8);
  251. map->format.pad_bytes = config->pad_bits / 8;
  252. map->format.val_bytes = DIV_ROUND_UP(config->val_bits, 8);
  253. map->format.buf_size = DIV_ROUND_UP(config->reg_bits +
  254. config->val_bits + config->pad_bits, 8);
  255. map->reg_shift = config->pad_bits % 8;
  256. if (config->reg_stride)
  257. map->reg_stride = config->reg_stride;
  258. else
  259. map->reg_stride = 1;
  260. map->use_single_rw = config->use_single_rw;
  261. map->dev = dev;
  262. map->bus = bus;
  263. map->bus_context = bus_context;
  264. map->max_register = config->max_register;
  265. map->writeable_reg = config->writeable_reg;
  266. map->readable_reg = config->readable_reg;
  267. map->volatile_reg = config->volatile_reg;
  268. map->precious_reg = config->precious_reg;
  269. map->cache_type = config->cache_type;
  270. map->name = config->name;
  271. if (config->read_flag_mask || config->write_flag_mask) {
  272. map->read_flag_mask = config->read_flag_mask;
  273. map->write_flag_mask = config->write_flag_mask;
  274. } else {
  275. map->read_flag_mask = bus->read_flag_mask;
  276. }
  277. switch (config->reg_bits + map->reg_shift) {
  278. case 2:
  279. switch (config->val_bits) {
  280. case 6:
  281. map->format.format_write = regmap_format_2_6_write;
  282. break;
  283. default:
  284. goto err_map;
  285. }
  286. break;
  287. case 4:
  288. switch (config->val_bits) {
  289. case 12:
  290. map->format.format_write = regmap_format_4_12_write;
  291. break;
  292. default:
  293. goto err_map;
  294. }
  295. break;
  296. case 7:
  297. switch (config->val_bits) {
  298. case 9:
  299. map->format.format_write = regmap_format_7_9_write;
  300. break;
  301. default:
  302. goto err_map;
  303. }
  304. break;
  305. case 10:
  306. switch (config->val_bits) {
  307. case 14:
  308. map->format.format_write = regmap_format_10_14_write;
  309. break;
  310. default:
  311. goto err_map;
  312. }
  313. break;
  314. case 8:
  315. map->format.format_reg = regmap_format_8;
  316. break;
  317. case 16:
  318. map->format.format_reg = regmap_format_16;
  319. break;
  320. case 32:
  321. map->format.format_reg = regmap_format_32;
  322. break;
  323. default:
  324. goto err_map;
  325. }
  326. switch (config->val_bits) {
  327. case 8:
  328. map->format.format_val = regmap_format_8;
  329. map->format.parse_val = regmap_parse_8;
  330. break;
  331. case 16:
  332. map->format.format_val = regmap_format_16;
  333. map->format.parse_val = regmap_parse_16;
  334. break;
  335. case 24:
  336. map->format.format_val = regmap_format_24;
  337. map->format.parse_val = regmap_parse_24;
  338. break;
  339. case 32:
  340. map->format.format_val = regmap_format_32;
  341. map->format.parse_val = regmap_parse_32;
  342. break;
  343. }
  344. if (map->format.format_write)
  345. map->use_single_rw = true;
  346. if (!map->format.format_write &&
  347. !(map->format.format_reg && map->format.format_val))
  348. goto err_map;
  349. map->work_buf = kzalloc(map->format.buf_size, GFP_KERNEL);
  350. if (map->work_buf == NULL) {
  351. ret = -ENOMEM;
  352. goto err_map;
  353. }
  354. map->range_tree = RB_ROOT;
  355. for (i = 0; i < config->n_ranges; i++) {
  356. const struct regmap_range_cfg *range_cfg = &config->ranges[i];
  357. struct regmap_range_node *new;
  358. /* Sanity check */
  359. if (range_cfg->range_max < range_cfg->range_min ||
  360. range_cfg->range_max > map->max_register ||
  361. range_cfg->selector_reg > map->max_register ||
  362. range_cfg->window_len == 0)
  363. goto err_range;
  364. /* Make sure, that this register range has no selector
  365. or data window within its boundary */
  366. for (j = 0; j < config->n_ranges; j++) {
  367. unsigned sel_reg = config->ranges[j].selector_reg;
  368. unsigned win_min = config->ranges[j].window_start;
  369. unsigned win_max = win_min +
  370. config->ranges[j].window_len - 1;
  371. if (range_cfg->range_min <= sel_reg &&
  372. sel_reg <= range_cfg->range_max) {
  373. goto err_range;
  374. }
  375. if (!(win_max < range_cfg->range_min ||
  376. win_min > range_cfg->range_max)) {
  377. goto err_range;
  378. }
  379. }
  380. new = kzalloc(sizeof(*new), GFP_KERNEL);
  381. if (new == NULL) {
  382. ret = -ENOMEM;
  383. goto err_range;
  384. }
  385. new->range_min = range_cfg->range_min;
  386. new->range_max = range_cfg->range_max;
  387. new->selector_reg = range_cfg->selector_reg;
  388. new->selector_mask = range_cfg->selector_mask;
  389. new->selector_shift = range_cfg->selector_shift;
  390. new->window_start = range_cfg->window_start;
  391. new->window_len = range_cfg->window_len;
  392. if (_regmap_range_add(map, new) == false) {
  393. kfree(new);
  394. goto err_range;
  395. }
  396. if (map->selector_work_buf == NULL) {
  397. map->selector_work_buf =
  398. kzalloc(map->format.buf_size, GFP_KERNEL);
  399. if (map->selector_work_buf == NULL) {
  400. ret = -ENOMEM;
  401. goto err_range;
  402. }
  403. }
  404. }
  405. ret = regcache_init(map, config);
  406. if (ret < 0)
  407. goto err_range;
  408. regmap_debugfs_init(map, config->name);
  409. /* Add a devres resource for dev_get_regmap() */
  410. m = devres_alloc(dev_get_regmap_release, sizeof(*m), GFP_KERNEL);
  411. if (!m) {
  412. ret = -ENOMEM;
  413. goto err_debugfs;
  414. }
  415. *m = map;
  416. devres_add(dev, m);
  417. return map;
  418. err_debugfs:
  419. regmap_debugfs_exit(map);
  420. regcache_exit(map);
  421. err_range:
  422. regmap_range_exit(map);
  423. kfree(map->work_buf);
  424. err_map:
  425. kfree(map);
  426. err:
  427. return ERR_PTR(ret);
  428. }
  429. EXPORT_SYMBOL_GPL(regmap_init);
  430. static void devm_regmap_release(struct device *dev, void *res)
  431. {
  432. regmap_exit(*(struct regmap **)res);
  433. }
  434. /**
  435. * devm_regmap_init(): Initialise managed register map
  436. *
  437. * @dev: Device that will be interacted with
  438. * @bus: Bus-specific callbacks to use with device
  439. * @bus_context: Data passed to bus-specific callbacks
  440. * @config: Configuration for register map
  441. *
  442. * The return value will be an ERR_PTR() on error or a valid pointer
  443. * to a struct regmap. This function should generally not be called
  444. * directly, it should be called by bus-specific init functions. The
  445. * map will be automatically freed by the device management code.
  446. */
  447. struct regmap *devm_regmap_init(struct device *dev,
  448. const struct regmap_bus *bus,
  449. void *bus_context,
  450. const struct regmap_config *config)
  451. {
  452. struct regmap **ptr, *regmap;
  453. ptr = devres_alloc(devm_regmap_release, sizeof(*ptr), GFP_KERNEL);
  454. if (!ptr)
  455. return ERR_PTR(-ENOMEM);
  456. regmap = regmap_init(dev, bus, bus_context, config);
  457. if (!IS_ERR(regmap)) {
  458. *ptr = regmap;
  459. devres_add(dev, ptr);
  460. } else {
  461. devres_free(ptr);
  462. }
  463. return regmap;
  464. }
  465. EXPORT_SYMBOL_GPL(devm_regmap_init);
  466. /**
  467. * regmap_reinit_cache(): Reinitialise the current register cache
  468. *
  469. * @map: Register map to operate on.
  470. * @config: New configuration. Only the cache data will be used.
  471. *
  472. * Discard any existing register cache for the map and initialize a
  473. * new cache. This can be used to restore the cache to defaults or to
  474. * update the cache configuration to reflect runtime discovery of the
  475. * hardware.
  476. */
  477. int regmap_reinit_cache(struct regmap *map, const struct regmap_config *config)
  478. {
  479. int ret;
  480. map->lock(map);
  481. regcache_exit(map);
  482. regmap_debugfs_exit(map);
  483. map->max_register = config->max_register;
  484. map->writeable_reg = config->writeable_reg;
  485. map->readable_reg = config->readable_reg;
  486. map->volatile_reg = config->volatile_reg;
  487. map->precious_reg = config->precious_reg;
  488. map->cache_type = config->cache_type;
  489. regmap_debugfs_init(map, config->name);
  490. map->cache_bypass = false;
  491. map->cache_only = false;
  492. ret = regcache_init(map, config);
  493. map->unlock(map);
  494. return ret;
  495. }
  496. EXPORT_SYMBOL_GPL(regmap_reinit_cache);
  497. /**
  498. * regmap_exit(): Free a previously allocated register map
  499. */
  500. void regmap_exit(struct regmap *map)
  501. {
  502. regcache_exit(map);
  503. regmap_debugfs_exit(map);
  504. regmap_range_exit(map);
  505. if (map->bus->free_context)
  506. map->bus->free_context(map->bus_context);
  507. kfree(map->work_buf);
  508. kfree(map);
  509. }
  510. EXPORT_SYMBOL_GPL(regmap_exit);
  511. static int dev_get_regmap_match(struct device *dev, void *res, void *data)
  512. {
  513. struct regmap **r = res;
  514. if (!r || !*r) {
  515. WARN_ON(!r || !*r);
  516. return 0;
  517. }
  518. /* If the user didn't specify a name match any */
  519. if (data)
  520. return (*r)->name == data;
  521. else
  522. return 1;
  523. }
  524. /**
  525. * dev_get_regmap(): Obtain the regmap (if any) for a device
  526. *
  527. * @dev: Device to retrieve the map for
  528. * @name: Optional name for the register map, usually NULL.
  529. *
  530. * Returns the regmap for the device if one is present, or NULL. If
  531. * name is specified then it must match the name specified when
  532. * registering the device, if it is NULL then the first regmap found
  533. * will be used. Devices with multiple register maps are very rare,
  534. * generic code should normally not need to specify a name.
  535. */
  536. struct regmap *dev_get_regmap(struct device *dev, const char *name)
  537. {
  538. struct regmap **r = devres_find(dev, dev_get_regmap_release,
  539. dev_get_regmap_match, (void *)name);
  540. if (!r)
  541. return NULL;
  542. return *r;
  543. }
  544. EXPORT_SYMBOL_GPL(dev_get_regmap);
  545. static int _regmap_select_page(struct regmap *map, unsigned int *reg,
  546. unsigned int val_num)
  547. {
  548. struct regmap_range_node *range;
  549. void *orig_work_buf;
  550. unsigned int win_offset;
  551. unsigned int win_page;
  552. bool page_chg;
  553. int ret;
  554. range = _regmap_range_lookup(map, *reg);
  555. if (range) {
  556. win_offset = (*reg - range->range_min) % range->window_len;
  557. win_page = (*reg - range->range_min) / range->window_len;
  558. if (val_num > 1) {
  559. /* Bulk write shouldn't cross range boundary */
  560. if (*reg + val_num - 1 > range->range_max)
  561. return -EINVAL;
  562. /* ... or single page boundary */
  563. if (val_num > range->window_len - win_offset)
  564. return -EINVAL;
  565. }
  566. /* It is possible to have selector register inside data window.
  567. In that case, selector register is located on every page and
  568. it needs no page switching, when accessed alone. */
  569. if (val_num > 1 ||
  570. range->window_start + win_offset != range->selector_reg) {
  571. /* Use separate work_buf during page switching */
  572. orig_work_buf = map->work_buf;
  573. map->work_buf = map->selector_work_buf;
  574. ret = _regmap_update_bits(map, range->selector_reg,
  575. range->selector_mask,
  576. win_page << range->selector_shift,
  577. &page_chg);
  578. if (ret < 0)
  579. return ret;
  580. map->work_buf = orig_work_buf;
  581. }
  582. *reg = range->window_start + win_offset;
  583. }
  584. return 0;
  585. }
  586. static int _regmap_raw_write(struct regmap *map, unsigned int reg,
  587. const void *val, size_t val_len)
  588. {
  589. u8 *u8 = map->work_buf;
  590. void *buf;
  591. int ret = -ENOTSUPP;
  592. size_t len;
  593. int i;
  594. /* Check for unwritable registers before we start */
  595. if (map->writeable_reg)
  596. for (i = 0; i < val_len / map->format.val_bytes; i++)
  597. if (!map->writeable_reg(map->dev,
  598. reg + (i * map->reg_stride)))
  599. return -EINVAL;
  600. if (!map->cache_bypass && map->format.parse_val) {
  601. unsigned int ival;
  602. int val_bytes = map->format.val_bytes;
  603. for (i = 0; i < val_len / val_bytes; i++) {
  604. memcpy(map->work_buf, val + (i * val_bytes), val_bytes);
  605. ival = map->format.parse_val(map->work_buf);
  606. ret = regcache_write(map, reg + (i * map->reg_stride),
  607. ival);
  608. if (ret) {
  609. dev_err(map->dev,
  610. "Error in caching of register: %u ret: %d\n",
  611. reg + i, ret);
  612. return ret;
  613. }
  614. }
  615. if (map->cache_only) {
  616. map->cache_dirty = true;
  617. return 0;
  618. }
  619. }
  620. ret = _regmap_select_page(map, &reg, val_len / map->format.val_bytes);
  621. if (ret < 0)
  622. return ret;
  623. map->format.format_reg(map->work_buf, reg, map->reg_shift);
  624. u8[0] |= map->write_flag_mask;
  625. trace_regmap_hw_write_start(map->dev, reg,
  626. val_len / map->format.val_bytes);
  627. /* If we're doing a single register write we can probably just
  628. * send the work_buf directly, otherwise try to do a gather
  629. * write.
  630. */
  631. if (val == (map->work_buf + map->format.pad_bytes +
  632. map->format.reg_bytes))
  633. ret = map->bus->write(map->bus_context, map->work_buf,
  634. map->format.reg_bytes +
  635. map->format.pad_bytes +
  636. val_len);
  637. else if (map->bus->gather_write)
  638. ret = map->bus->gather_write(map->bus_context, map->work_buf,
  639. map->format.reg_bytes +
  640. map->format.pad_bytes,
  641. val, val_len);
  642. /* If that didn't work fall back on linearising by hand. */
  643. if (ret == -ENOTSUPP) {
  644. len = map->format.reg_bytes + map->format.pad_bytes + val_len;
  645. buf = kzalloc(len, GFP_KERNEL);
  646. if (!buf)
  647. return -ENOMEM;
  648. memcpy(buf, map->work_buf, map->format.reg_bytes);
  649. memcpy(buf + map->format.reg_bytes + map->format.pad_bytes,
  650. val, val_len);
  651. ret = map->bus->write(map->bus_context, buf, len);
  652. kfree(buf);
  653. }
  654. trace_regmap_hw_write_done(map->dev, reg,
  655. val_len / map->format.val_bytes);
  656. return ret;
  657. }
  658. int _regmap_write(struct regmap *map, unsigned int reg,
  659. unsigned int val)
  660. {
  661. int ret;
  662. BUG_ON(!map->format.format_write && !map->format.format_val);
  663. if (!map->cache_bypass && map->format.format_write) {
  664. ret = regcache_write(map, reg, val);
  665. if (ret != 0)
  666. return ret;
  667. if (map->cache_only) {
  668. map->cache_dirty = true;
  669. return 0;
  670. }
  671. }
  672. trace_regmap_reg_write(map->dev, reg, val);
  673. if (map->format.format_write) {
  674. ret = _regmap_select_page(map, &reg, 1);
  675. if (ret < 0)
  676. return ret;
  677. map->format.format_write(map, reg, val);
  678. trace_regmap_hw_write_start(map->dev, reg, 1);
  679. ret = map->bus->write(map->bus_context, map->work_buf,
  680. map->format.buf_size);
  681. trace_regmap_hw_write_done(map->dev, reg, 1);
  682. return ret;
  683. } else {
  684. map->format.format_val(map->work_buf + map->format.reg_bytes
  685. + map->format.pad_bytes, val, 0);
  686. return _regmap_raw_write(map, reg,
  687. map->work_buf +
  688. map->format.reg_bytes +
  689. map->format.pad_bytes,
  690. map->format.val_bytes);
  691. }
  692. }
  693. /**
  694. * regmap_write(): Write a value to a single register
  695. *
  696. * @map: Register map to write to
  697. * @reg: Register to write to
  698. * @val: Value to be written
  699. *
  700. * A value of zero will be returned on success, a negative errno will
  701. * be returned in error cases.
  702. */
  703. int regmap_write(struct regmap *map, unsigned int reg, unsigned int val)
  704. {
  705. int ret;
  706. if (reg % map->reg_stride)
  707. return -EINVAL;
  708. map->lock(map);
  709. ret = _regmap_write(map, reg, val);
  710. map->unlock(map);
  711. return ret;
  712. }
  713. EXPORT_SYMBOL_GPL(regmap_write);
  714. /**
  715. * regmap_raw_write(): Write raw values to one or more registers
  716. *
  717. * @map: Register map to write to
  718. * @reg: Initial register to write to
  719. * @val: Block of data to be written, laid out for direct transmission to the
  720. * device
  721. * @val_len: Length of data pointed to by val.
  722. *
  723. * This function is intended to be used for things like firmware
  724. * download where a large block of data needs to be transferred to the
  725. * device. No formatting will be done on the data provided.
  726. *
  727. * A value of zero will be returned on success, a negative errno will
  728. * be returned in error cases.
  729. */
  730. int regmap_raw_write(struct regmap *map, unsigned int reg,
  731. const void *val, size_t val_len)
  732. {
  733. int ret;
  734. if (val_len % map->format.val_bytes)
  735. return -EINVAL;
  736. if (reg % map->reg_stride)
  737. return -EINVAL;
  738. map->lock(map);
  739. ret = _regmap_raw_write(map, reg, val, val_len);
  740. map->unlock(map);
  741. return ret;
  742. }
  743. EXPORT_SYMBOL_GPL(regmap_raw_write);
  744. /*
  745. * regmap_bulk_write(): Write multiple registers to the device
  746. *
  747. * @map: Register map to write to
  748. * @reg: First register to be write from
  749. * @val: Block of data to be written, in native register size for device
  750. * @val_count: Number of registers to write
  751. *
  752. * This function is intended to be used for writing a large block of
  753. * data to be device either in single transfer or multiple transfer.
  754. *
  755. * A value of zero will be returned on success, a negative errno will
  756. * be returned in error cases.
  757. */
  758. int regmap_bulk_write(struct regmap *map, unsigned int reg, const void *val,
  759. size_t val_count)
  760. {
  761. int ret = 0, i;
  762. size_t val_bytes = map->format.val_bytes;
  763. void *wval;
  764. if (!map->format.parse_val)
  765. return -EINVAL;
  766. if (reg % map->reg_stride)
  767. return -EINVAL;
  768. map->lock(map);
  769. /* No formatting is require if val_byte is 1 */
  770. if (val_bytes == 1) {
  771. wval = (void *)val;
  772. } else {
  773. wval = kmemdup(val, val_count * val_bytes, GFP_KERNEL);
  774. if (!wval) {
  775. ret = -ENOMEM;
  776. dev_err(map->dev, "Error in memory allocation\n");
  777. goto out;
  778. }
  779. for (i = 0; i < val_count * val_bytes; i += val_bytes)
  780. map->format.parse_val(wval + i);
  781. }
  782. /*
  783. * Some devices does not support bulk write, for
  784. * them we have a series of single write operations.
  785. */
  786. if (map->use_single_rw) {
  787. for (i = 0; i < val_count; i++) {
  788. ret = regmap_raw_write(map,
  789. reg + (i * map->reg_stride),
  790. val + (i * val_bytes),
  791. val_bytes);
  792. if (ret != 0)
  793. return ret;
  794. }
  795. } else {
  796. ret = _regmap_raw_write(map, reg, wval, val_bytes * val_count);
  797. }
  798. if (val_bytes != 1)
  799. kfree(wval);
  800. out:
  801. map->unlock(map);
  802. return ret;
  803. }
  804. EXPORT_SYMBOL_GPL(regmap_bulk_write);
  805. static int _regmap_raw_read(struct regmap *map, unsigned int reg, void *val,
  806. unsigned int val_len)
  807. {
  808. u8 *u8 = map->work_buf;
  809. int ret;
  810. ret = _regmap_select_page(map, &reg, val_len / map->format.val_bytes);
  811. if (ret < 0)
  812. return ret;
  813. map->format.format_reg(map->work_buf, reg, map->reg_shift);
  814. /*
  815. * Some buses or devices flag reads by setting the high bits in the
  816. * register addresss; since it's always the high bits for all
  817. * current formats we can do this here rather than in
  818. * formatting. This may break if we get interesting formats.
  819. */
  820. u8[0] |= map->read_flag_mask;
  821. trace_regmap_hw_read_start(map->dev, reg,
  822. val_len / map->format.val_bytes);
  823. ret = map->bus->read(map->bus_context, map->work_buf,
  824. map->format.reg_bytes + map->format.pad_bytes,
  825. val, val_len);
  826. trace_regmap_hw_read_done(map->dev, reg,
  827. val_len / map->format.val_bytes);
  828. return ret;
  829. }
  830. static int _regmap_read(struct regmap *map, unsigned int reg,
  831. unsigned int *val)
  832. {
  833. int ret;
  834. if (!map->cache_bypass) {
  835. ret = regcache_read(map, reg, val);
  836. if (ret == 0)
  837. return 0;
  838. }
  839. if (!map->format.parse_val)
  840. return -EINVAL;
  841. if (map->cache_only)
  842. return -EBUSY;
  843. ret = _regmap_raw_read(map, reg, map->work_buf, map->format.val_bytes);
  844. if (ret == 0) {
  845. *val = map->format.parse_val(map->work_buf);
  846. trace_regmap_reg_read(map->dev, reg, *val);
  847. }
  848. if (ret == 0 && !map->cache_bypass)
  849. regcache_write(map, reg, *val);
  850. return ret;
  851. }
  852. /**
  853. * regmap_read(): Read a value from a single register
  854. *
  855. * @map: Register map to write to
  856. * @reg: Register to be read from
  857. * @val: Pointer to store read value
  858. *
  859. * A value of zero will be returned on success, a negative errno will
  860. * be returned in error cases.
  861. */
  862. int regmap_read(struct regmap *map, unsigned int reg, unsigned int *val)
  863. {
  864. int ret;
  865. if (reg % map->reg_stride)
  866. return -EINVAL;
  867. map->lock(map);
  868. ret = _regmap_read(map, reg, val);
  869. map->unlock(map);
  870. return ret;
  871. }
  872. EXPORT_SYMBOL_GPL(regmap_read);
  873. /**
  874. * regmap_raw_read(): Read raw data from the device
  875. *
  876. * @map: Register map to write to
  877. * @reg: First register to be read from
  878. * @val: Pointer to store read value
  879. * @val_len: Size of data to read
  880. *
  881. * A value of zero will be returned on success, a negative errno will
  882. * be returned in error cases.
  883. */
  884. int regmap_raw_read(struct regmap *map, unsigned int reg, void *val,
  885. size_t val_len)
  886. {
  887. size_t val_bytes = map->format.val_bytes;
  888. size_t val_count = val_len / val_bytes;
  889. unsigned int v;
  890. int ret, i;
  891. if (val_len % map->format.val_bytes)
  892. return -EINVAL;
  893. if (reg % map->reg_stride)
  894. return -EINVAL;
  895. map->lock(map);
  896. if (regmap_volatile_range(map, reg, val_count) || map->cache_bypass ||
  897. map->cache_type == REGCACHE_NONE) {
  898. /* Physical block read if there's no cache involved */
  899. ret = _regmap_raw_read(map, reg, val, val_len);
  900. } else {
  901. /* Otherwise go word by word for the cache; should be low
  902. * cost as we expect to hit the cache.
  903. */
  904. for (i = 0; i < val_count; i++) {
  905. ret = _regmap_read(map, reg + (i * map->reg_stride),
  906. &v);
  907. if (ret != 0)
  908. goto out;
  909. map->format.format_val(val + (i * val_bytes), v, 0);
  910. }
  911. }
  912. out:
  913. map->unlock(map);
  914. return ret;
  915. }
  916. EXPORT_SYMBOL_GPL(regmap_raw_read);
  917. /**
  918. * regmap_bulk_read(): Read multiple registers from the device
  919. *
  920. * @map: Register map to write to
  921. * @reg: First register to be read from
  922. * @val: Pointer to store read value, in native register size for device
  923. * @val_count: Number of registers to read
  924. *
  925. * A value of zero will be returned on success, a negative errno will
  926. * be returned in error cases.
  927. */
  928. int regmap_bulk_read(struct regmap *map, unsigned int reg, void *val,
  929. size_t val_count)
  930. {
  931. int ret, i;
  932. size_t val_bytes = map->format.val_bytes;
  933. bool vol = regmap_volatile_range(map, reg, val_count);
  934. if (!map->format.parse_val)
  935. return -EINVAL;
  936. if (reg % map->reg_stride)
  937. return -EINVAL;
  938. if (vol || map->cache_type == REGCACHE_NONE) {
  939. /*
  940. * Some devices does not support bulk read, for
  941. * them we have a series of single read operations.
  942. */
  943. if (map->use_single_rw) {
  944. for (i = 0; i < val_count; i++) {
  945. ret = regmap_raw_read(map,
  946. reg + (i * map->reg_stride),
  947. val + (i * val_bytes),
  948. val_bytes);
  949. if (ret != 0)
  950. return ret;
  951. }
  952. } else {
  953. ret = regmap_raw_read(map, reg, val,
  954. val_bytes * val_count);
  955. if (ret != 0)
  956. return ret;
  957. }
  958. for (i = 0; i < val_count * val_bytes; i += val_bytes)
  959. map->format.parse_val(val + i);
  960. } else {
  961. for (i = 0; i < val_count; i++) {
  962. unsigned int ival;
  963. ret = regmap_read(map, reg + (i * map->reg_stride),
  964. &ival);
  965. if (ret != 0)
  966. return ret;
  967. memcpy(val + (i * val_bytes), &ival, val_bytes);
  968. }
  969. }
  970. return 0;
  971. }
  972. EXPORT_SYMBOL_GPL(regmap_bulk_read);
  973. static int _regmap_update_bits(struct regmap *map, unsigned int reg,
  974. unsigned int mask, unsigned int val,
  975. bool *change)
  976. {
  977. int ret;
  978. unsigned int tmp, orig;
  979. ret = _regmap_read(map, reg, &orig);
  980. if (ret != 0)
  981. return ret;
  982. tmp = orig & ~mask;
  983. tmp |= val & mask;
  984. if (tmp != orig) {
  985. ret = _regmap_write(map, reg, tmp);
  986. *change = true;
  987. } else {
  988. *change = false;
  989. }
  990. return ret;
  991. }
  992. /**
  993. * regmap_update_bits: Perform a read/modify/write cycle on the register map
  994. *
  995. * @map: Register map to update
  996. * @reg: Register to update
  997. * @mask: Bitmask to change
  998. * @val: New value for bitmask
  999. *
  1000. * Returns zero for success, a negative number on error.
  1001. */
  1002. int regmap_update_bits(struct regmap *map, unsigned int reg,
  1003. unsigned int mask, unsigned int val)
  1004. {
  1005. bool change;
  1006. int ret;
  1007. map->lock(map);
  1008. ret = _regmap_update_bits(map, reg, mask, val, &change);
  1009. map->unlock(map);
  1010. return ret;
  1011. }
  1012. EXPORT_SYMBOL_GPL(regmap_update_bits);
  1013. /**
  1014. * regmap_update_bits_check: Perform a read/modify/write cycle on the
  1015. * register map and report if updated
  1016. *
  1017. * @map: Register map to update
  1018. * @reg: Register to update
  1019. * @mask: Bitmask to change
  1020. * @val: New value for bitmask
  1021. * @change: Boolean indicating if a write was done
  1022. *
  1023. * Returns zero for success, a negative number on error.
  1024. */
  1025. int regmap_update_bits_check(struct regmap *map, unsigned int reg,
  1026. unsigned int mask, unsigned int val,
  1027. bool *change)
  1028. {
  1029. int ret;
  1030. map->lock(map);
  1031. ret = _regmap_update_bits(map, reg, mask, val, change);
  1032. map->unlock(map);
  1033. return ret;
  1034. }
  1035. EXPORT_SYMBOL_GPL(regmap_update_bits_check);
  1036. /**
  1037. * regmap_register_patch: Register and apply register updates to be applied
  1038. * on device initialistion
  1039. *
  1040. * @map: Register map to apply updates to.
  1041. * @regs: Values to update.
  1042. * @num_regs: Number of entries in regs.
  1043. *
  1044. * Register a set of register updates to be applied to the device
  1045. * whenever the device registers are synchronised with the cache and
  1046. * apply them immediately. Typically this is used to apply
  1047. * corrections to be applied to the device defaults on startup, such
  1048. * as the updates some vendors provide to undocumented registers.
  1049. */
  1050. int regmap_register_patch(struct regmap *map, const struct reg_default *regs,
  1051. int num_regs)
  1052. {
  1053. int i, ret;
  1054. bool bypass;
  1055. /* If needed the implementation can be extended to support this */
  1056. if (map->patch)
  1057. return -EBUSY;
  1058. map->lock(map);
  1059. bypass = map->cache_bypass;
  1060. map->cache_bypass = true;
  1061. /* Write out first; it's useful to apply even if we fail later. */
  1062. for (i = 0; i < num_regs; i++) {
  1063. ret = _regmap_write(map, regs[i].reg, regs[i].def);
  1064. if (ret != 0) {
  1065. dev_err(map->dev, "Failed to write %x = %x: %d\n",
  1066. regs[i].reg, regs[i].def, ret);
  1067. goto out;
  1068. }
  1069. }
  1070. map->patch = kcalloc(num_regs, sizeof(struct reg_default), GFP_KERNEL);
  1071. if (map->patch != NULL) {
  1072. memcpy(map->patch, regs,
  1073. num_regs * sizeof(struct reg_default));
  1074. map->patch_regs = num_regs;
  1075. } else {
  1076. ret = -ENOMEM;
  1077. }
  1078. out:
  1079. map->cache_bypass = bypass;
  1080. map->unlock(map);
  1081. return ret;
  1082. }
  1083. EXPORT_SYMBOL_GPL(regmap_register_patch);
  1084. /*
  1085. * regmap_get_val_bytes(): Report the size of a register value
  1086. *
  1087. * Report the size of a register value, mainly intended to for use by
  1088. * generic infrastructure built on top of regmap.
  1089. */
  1090. int regmap_get_val_bytes(struct regmap *map)
  1091. {
  1092. if (map->format.format_write)
  1093. return -EINVAL;
  1094. return map->format.val_bytes;
  1095. }
  1096. EXPORT_SYMBOL_GPL(regmap_get_val_bytes);
  1097. static int __init regmap_initcall(void)
  1098. {
  1099. regmap_debugfs_initcall();
  1100. return 0;
  1101. }
  1102. postcore_initcall(regmap_initcall);