lp8788-buck.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * TI LP8788 MFD - buck regulator driver
  4. *
  5. * Copyright 2012 Texas Instruments
  6. *
  7. * Author: Milo(Woogyom) Kim <milo.kim@ti.com>
  8. */
  9. #include <linux/module.h>
  10. #include <linux/slab.h>
  11. #include <linux/err.h>
  12. #include <linux/platform_device.h>
  13. #include <linux/regulator/driver.h>
  14. #include <linux/mfd/lp8788.h>
  15. #include <linux/gpio.h>
  16. /* register address */
  17. #define LP8788_EN_BUCK 0x0C
  18. #define LP8788_BUCK_DVS_SEL 0x1D
  19. #define LP8788_BUCK1_VOUT0 0x1E
  20. #define LP8788_BUCK1_VOUT1 0x1F
  21. #define LP8788_BUCK1_VOUT2 0x20
  22. #define LP8788_BUCK1_VOUT3 0x21
  23. #define LP8788_BUCK2_VOUT0 0x22
  24. #define LP8788_BUCK2_VOUT1 0x23
  25. #define LP8788_BUCK2_VOUT2 0x24
  26. #define LP8788_BUCK2_VOUT3 0x25
  27. #define LP8788_BUCK3_VOUT 0x26
  28. #define LP8788_BUCK4_VOUT 0x27
  29. #define LP8788_BUCK1_TIMESTEP 0x28
  30. #define LP8788_BUCK_PWM 0x2D
  31. /* mask/shift bits */
  32. #define LP8788_EN_BUCK1_M BIT(0) /* Addr 0Ch */
  33. #define LP8788_EN_BUCK2_M BIT(1)
  34. #define LP8788_EN_BUCK3_M BIT(2)
  35. #define LP8788_EN_BUCK4_M BIT(3)
  36. #define LP8788_BUCK1_DVS_SEL_M 0x04 /* Addr 1Dh */
  37. #define LP8788_BUCK1_DVS_M 0x03
  38. #define LP8788_BUCK1_DVS_S 0
  39. #define LP8788_BUCK2_DVS_SEL_M 0x40
  40. #define LP8788_BUCK2_DVS_M 0x30
  41. #define LP8788_BUCK2_DVS_S 4
  42. #define LP8788_BUCK1_DVS_I2C BIT(2)
  43. #define LP8788_BUCK2_DVS_I2C BIT(6)
  44. #define LP8788_BUCK1_DVS_PIN (0 << 2)
  45. #define LP8788_BUCK2_DVS_PIN (0 << 6)
  46. #define LP8788_VOUT_M 0x1F /* Addr 1Eh ~ 27h */
  47. #define LP8788_STARTUP_TIME_M 0xF8 /* Addr 28h ~ 2Bh */
  48. #define LP8788_STARTUP_TIME_S 3
  49. #define LP8788_FPWM_BUCK1_M BIT(0) /* Addr 2Dh */
  50. #define LP8788_FPWM_BUCK1_S 0
  51. #define LP8788_FPWM_BUCK2_M BIT(1)
  52. #define LP8788_FPWM_BUCK2_S 1
  53. #define LP8788_FPWM_BUCK3_M BIT(2)
  54. #define LP8788_FPWM_BUCK3_S 2
  55. #define LP8788_FPWM_BUCK4_M BIT(3)
  56. #define LP8788_FPWM_BUCK4_S 3
  57. #define INVALID_ADDR 0xFF
  58. #define LP8788_FORCE_PWM 1
  59. #define LP8788_AUTO_PWM 0
  60. #define PIN_LOW 0
  61. #define PIN_HIGH 1
  62. #define ENABLE_TIME_USEC 32
  63. #define BUCK_FPWM_MASK(x) (1 << (x))
  64. #define BUCK_FPWM_SHIFT(x) (x)
  65. enum lp8788_dvs_state {
  66. DVS_LOW = GPIOF_OUT_INIT_LOW,
  67. DVS_HIGH = GPIOF_OUT_INIT_HIGH,
  68. };
  69. enum lp8788_dvs_mode {
  70. REGISTER,
  71. EXTPIN,
  72. };
  73. enum lp8788_buck_id {
  74. BUCK1,
  75. BUCK2,
  76. BUCK3,
  77. BUCK4,
  78. };
  79. struct lp8788_buck {
  80. struct lp8788 *lp;
  81. struct regulator_dev *regulator;
  82. void *dvs;
  83. };
  84. /* BUCK 1 ~ 4 voltage ranges */
  85. static const struct linear_range buck_volt_ranges[] = {
  86. REGULATOR_LINEAR_RANGE(500000, 0, 0, 0),
  87. REGULATOR_LINEAR_RANGE(800000, 1, 25, 50000),
  88. };
  89. static void lp8788_buck1_set_dvs(struct lp8788_buck *buck)
  90. {
  91. struct lp8788_buck1_dvs *dvs = (struct lp8788_buck1_dvs *)buck->dvs;
  92. enum lp8788_dvs_state pinstate;
  93. if (!dvs)
  94. return;
  95. pinstate = dvs->vsel == DVS_SEL_V0 ? DVS_LOW : DVS_HIGH;
  96. if (gpio_is_valid(dvs->gpio))
  97. gpio_set_value(dvs->gpio, pinstate);
  98. }
  99. static void lp8788_buck2_set_dvs(struct lp8788_buck *buck)
  100. {
  101. struct lp8788_buck2_dvs *dvs = (struct lp8788_buck2_dvs *)buck->dvs;
  102. enum lp8788_dvs_state pin1, pin2;
  103. if (!dvs)
  104. return;
  105. switch (dvs->vsel) {
  106. case DVS_SEL_V0:
  107. pin1 = DVS_LOW;
  108. pin2 = DVS_LOW;
  109. break;
  110. case DVS_SEL_V1:
  111. pin1 = DVS_HIGH;
  112. pin2 = DVS_LOW;
  113. break;
  114. case DVS_SEL_V2:
  115. pin1 = DVS_LOW;
  116. pin2 = DVS_HIGH;
  117. break;
  118. case DVS_SEL_V3:
  119. pin1 = DVS_HIGH;
  120. pin2 = DVS_HIGH;
  121. break;
  122. default:
  123. return;
  124. }
  125. if (gpio_is_valid(dvs->gpio[0]))
  126. gpio_set_value(dvs->gpio[0], pin1);
  127. if (gpio_is_valid(dvs->gpio[1]))
  128. gpio_set_value(dvs->gpio[1], pin2);
  129. }
  130. static void lp8788_set_dvs(struct lp8788_buck *buck, enum lp8788_buck_id id)
  131. {
  132. switch (id) {
  133. case BUCK1:
  134. lp8788_buck1_set_dvs(buck);
  135. break;
  136. case BUCK2:
  137. lp8788_buck2_set_dvs(buck);
  138. break;
  139. default:
  140. break;
  141. }
  142. }
  143. static enum lp8788_dvs_mode
  144. lp8788_get_buck_dvs_ctrl_mode(struct lp8788_buck *buck, enum lp8788_buck_id id)
  145. {
  146. u8 val, mask;
  147. switch (id) {
  148. case BUCK1:
  149. mask = LP8788_BUCK1_DVS_SEL_M;
  150. break;
  151. case BUCK2:
  152. mask = LP8788_BUCK2_DVS_SEL_M;
  153. break;
  154. default:
  155. return REGISTER;
  156. }
  157. lp8788_read_byte(buck->lp, LP8788_BUCK_DVS_SEL, &val);
  158. return val & mask ? REGISTER : EXTPIN;
  159. }
  160. static bool lp8788_is_valid_buck_addr(u8 addr)
  161. {
  162. switch (addr) {
  163. case LP8788_BUCK1_VOUT0:
  164. case LP8788_BUCK1_VOUT1:
  165. case LP8788_BUCK1_VOUT2:
  166. case LP8788_BUCK1_VOUT3:
  167. case LP8788_BUCK2_VOUT0:
  168. case LP8788_BUCK2_VOUT1:
  169. case LP8788_BUCK2_VOUT2:
  170. case LP8788_BUCK2_VOUT3:
  171. return true;
  172. default:
  173. return false;
  174. }
  175. }
  176. static u8 lp8788_select_buck_vout_addr(struct lp8788_buck *buck,
  177. enum lp8788_buck_id id)
  178. {
  179. enum lp8788_dvs_mode mode = lp8788_get_buck_dvs_ctrl_mode(buck, id);
  180. struct lp8788_buck1_dvs *b1_dvs;
  181. struct lp8788_buck2_dvs *b2_dvs;
  182. u8 val, idx, addr;
  183. int pin1, pin2;
  184. switch (id) {
  185. case BUCK1:
  186. if (mode == EXTPIN) {
  187. b1_dvs = (struct lp8788_buck1_dvs *)buck->dvs;
  188. if (!b1_dvs)
  189. goto err;
  190. idx = gpio_get_value(b1_dvs->gpio) ? 1 : 0;
  191. } else {
  192. lp8788_read_byte(buck->lp, LP8788_BUCK_DVS_SEL, &val);
  193. idx = (val & LP8788_BUCK1_DVS_M) >> LP8788_BUCK1_DVS_S;
  194. }
  195. addr = LP8788_BUCK1_VOUT0 + idx;
  196. break;
  197. case BUCK2:
  198. if (mode == EXTPIN) {
  199. b2_dvs = (struct lp8788_buck2_dvs *)buck->dvs;
  200. if (!b2_dvs)
  201. goto err;
  202. pin1 = gpio_get_value(b2_dvs->gpio[0]);
  203. pin2 = gpio_get_value(b2_dvs->gpio[1]);
  204. if (pin1 == PIN_LOW && pin2 == PIN_LOW)
  205. idx = 0;
  206. else if (pin1 == PIN_LOW && pin2 == PIN_HIGH)
  207. idx = 2;
  208. else if (pin1 == PIN_HIGH && pin2 == PIN_LOW)
  209. idx = 1;
  210. else
  211. idx = 3;
  212. } else {
  213. lp8788_read_byte(buck->lp, LP8788_BUCK_DVS_SEL, &val);
  214. idx = (val & LP8788_BUCK2_DVS_M) >> LP8788_BUCK2_DVS_S;
  215. }
  216. addr = LP8788_BUCK2_VOUT0 + idx;
  217. break;
  218. default:
  219. goto err;
  220. }
  221. return addr;
  222. err:
  223. return INVALID_ADDR;
  224. }
  225. static int lp8788_buck12_set_voltage_sel(struct regulator_dev *rdev,
  226. unsigned selector)
  227. {
  228. struct lp8788_buck *buck = rdev_get_drvdata(rdev);
  229. enum lp8788_buck_id id = rdev_get_id(rdev);
  230. u8 addr;
  231. if (buck->dvs)
  232. lp8788_set_dvs(buck, id);
  233. addr = lp8788_select_buck_vout_addr(buck, id);
  234. if (!lp8788_is_valid_buck_addr(addr))
  235. return -EINVAL;
  236. return lp8788_update_bits(buck->lp, addr, LP8788_VOUT_M, selector);
  237. }
  238. static int lp8788_buck12_get_voltage_sel(struct regulator_dev *rdev)
  239. {
  240. struct lp8788_buck *buck = rdev_get_drvdata(rdev);
  241. enum lp8788_buck_id id = rdev_get_id(rdev);
  242. int ret;
  243. u8 val, addr;
  244. addr = lp8788_select_buck_vout_addr(buck, id);
  245. if (!lp8788_is_valid_buck_addr(addr))
  246. return -EINVAL;
  247. ret = lp8788_read_byte(buck->lp, addr, &val);
  248. if (ret)
  249. return ret;
  250. return val & LP8788_VOUT_M;
  251. }
  252. static int lp8788_buck_enable_time(struct regulator_dev *rdev)
  253. {
  254. struct lp8788_buck *buck = rdev_get_drvdata(rdev);
  255. enum lp8788_buck_id id = rdev_get_id(rdev);
  256. u8 val, addr = LP8788_BUCK1_TIMESTEP + id;
  257. if (lp8788_read_byte(buck->lp, addr, &val))
  258. return -EINVAL;
  259. val = (val & LP8788_STARTUP_TIME_M) >> LP8788_STARTUP_TIME_S;
  260. return ENABLE_TIME_USEC * val;
  261. }
  262. static int lp8788_buck_set_mode(struct regulator_dev *rdev, unsigned int mode)
  263. {
  264. struct lp8788_buck *buck = rdev_get_drvdata(rdev);
  265. enum lp8788_buck_id id = rdev_get_id(rdev);
  266. u8 mask, val;
  267. mask = BUCK_FPWM_MASK(id);
  268. switch (mode) {
  269. case REGULATOR_MODE_FAST:
  270. val = LP8788_FORCE_PWM << BUCK_FPWM_SHIFT(id);
  271. break;
  272. case REGULATOR_MODE_NORMAL:
  273. val = LP8788_AUTO_PWM << BUCK_FPWM_SHIFT(id);
  274. break;
  275. default:
  276. return -EINVAL;
  277. }
  278. return lp8788_update_bits(buck->lp, LP8788_BUCK_PWM, mask, val);
  279. }
  280. static unsigned int lp8788_buck_get_mode(struct regulator_dev *rdev)
  281. {
  282. struct lp8788_buck *buck = rdev_get_drvdata(rdev);
  283. enum lp8788_buck_id id = rdev_get_id(rdev);
  284. u8 val;
  285. int ret;
  286. ret = lp8788_read_byte(buck->lp, LP8788_BUCK_PWM, &val);
  287. if (ret)
  288. return ret;
  289. return val & BUCK_FPWM_MASK(id) ?
  290. REGULATOR_MODE_FAST : REGULATOR_MODE_NORMAL;
  291. }
  292. static const struct regulator_ops lp8788_buck12_ops = {
  293. .list_voltage = regulator_list_voltage_linear_range,
  294. .map_voltage = regulator_map_voltage_linear_range,
  295. .set_voltage_sel = lp8788_buck12_set_voltage_sel,
  296. .get_voltage_sel = lp8788_buck12_get_voltage_sel,
  297. .enable = regulator_enable_regmap,
  298. .disable = regulator_disable_regmap,
  299. .is_enabled = regulator_is_enabled_regmap,
  300. .enable_time = lp8788_buck_enable_time,
  301. .set_mode = lp8788_buck_set_mode,
  302. .get_mode = lp8788_buck_get_mode,
  303. };
  304. static const struct regulator_ops lp8788_buck34_ops = {
  305. .list_voltage = regulator_list_voltage_linear_range,
  306. .map_voltage = regulator_map_voltage_linear_range,
  307. .set_voltage_sel = regulator_set_voltage_sel_regmap,
  308. .get_voltage_sel = regulator_get_voltage_sel_regmap,
  309. .enable = regulator_enable_regmap,
  310. .disable = regulator_disable_regmap,
  311. .is_enabled = regulator_is_enabled_regmap,
  312. .enable_time = lp8788_buck_enable_time,
  313. .set_mode = lp8788_buck_set_mode,
  314. .get_mode = lp8788_buck_get_mode,
  315. };
  316. static const struct regulator_desc lp8788_buck_desc[] = {
  317. {
  318. .name = "buck1",
  319. .id = BUCK1,
  320. .ops = &lp8788_buck12_ops,
  321. .n_voltages = 26,
  322. .linear_ranges = buck_volt_ranges,
  323. .n_linear_ranges = ARRAY_SIZE(buck_volt_ranges),
  324. .type = REGULATOR_VOLTAGE,
  325. .owner = THIS_MODULE,
  326. .enable_reg = LP8788_EN_BUCK,
  327. .enable_mask = LP8788_EN_BUCK1_M,
  328. },
  329. {
  330. .name = "buck2",
  331. .id = BUCK2,
  332. .ops = &lp8788_buck12_ops,
  333. .n_voltages = 26,
  334. .linear_ranges = buck_volt_ranges,
  335. .n_linear_ranges = ARRAY_SIZE(buck_volt_ranges),
  336. .type = REGULATOR_VOLTAGE,
  337. .owner = THIS_MODULE,
  338. .enable_reg = LP8788_EN_BUCK,
  339. .enable_mask = LP8788_EN_BUCK2_M,
  340. },
  341. {
  342. .name = "buck3",
  343. .id = BUCK3,
  344. .ops = &lp8788_buck34_ops,
  345. .n_voltages = 26,
  346. .linear_ranges = buck_volt_ranges,
  347. .n_linear_ranges = ARRAY_SIZE(buck_volt_ranges),
  348. .type = REGULATOR_VOLTAGE,
  349. .owner = THIS_MODULE,
  350. .vsel_reg = LP8788_BUCK3_VOUT,
  351. .vsel_mask = LP8788_VOUT_M,
  352. .enable_reg = LP8788_EN_BUCK,
  353. .enable_mask = LP8788_EN_BUCK3_M,
  354. },
  355. {
  356. .name = "buck4",
  357. .id = BUCK4,
  358. .ops = &lp8788_buck34_ops,
  359. .n_voltages = 26,
  360. .linear_ranges = buck_volt_ranges,
  361. .n_linear_ranges = ARRAY_SIZE(buck_volt_ranges),
  362. .type = REGULATOR_VOLTAGE,
  363. .owner = THIS_MODULE,
  364. .vsel_reg = LP8788_BUCK4_VOUT,
  365. .vsel_mask = LP8788_VOUT_M,
  366. .enable_reg = LP8788_EN_BUCK,
  367. .enable_mask = LP8788_EN_BUCK4_M,
  368. },
  369. };
  370. static int lp8788_dvs_gpio_request(struct platform_device *pdev,
  371. struct lp8788_buck *buck,
  372. enum lp8788_buck_id id)
  373. {
  374. struct lp8788_platform_data *pdata = buck->lp->pdata;
  375. char *b1_name = "LP8788_B1_DVS";
  376. char *b2_name[] = { "LP8788_B2_DVS1", "LP8788_B2_DVS2" };
  377. int i, gpio, ret;
  378. switch (id) {
  379. case BUCK1:
  380. gpio = pdata->buck1_dvs->gpio;
  381. ret = devm_gpio_request_one(&pdev->dev, gpio, DVS_LOW,
  382. b1_name);
  383. if (ret)
  384. return ret;
  385. buck->dvs = pdata->buck1_dvs;
  386. break;
  387. case BUCK2:
  388. for (i = 0; i < LP8788_NUM_BUCK2_DVS; i++) {
  389. gpio = pdata->buck2_dvs->gpio[i];
  390. ret = devm_gpio_request_one(&pdev->dev, gpio,
  391. DVS_LOW, b2_name[i]);
  392. if (ret)
  393. return ret;
  394. }
  395. buck->dvs = pdata->buck2_dvs;
  396. break;
  397. default:
  398. break;
  399. }
  400. return 0;
  401. }
  402. static int lp8788_init_dvs(struct platform_device *pdev,
  403. struct lp8788_buck *buck, enum lp8788_buck_id id)
  404. {
  405. struct lp8788_platform_data *pdata = buck->lp->pdata;
  406. u8 mask[] = { LP8788_BUCK1_DVS_SEL_M, LP8788_BUCK2_DVS_SEL_M };
  407. u8 val[] = { LP8788_BUCK1_DVS_PIN, LP8788_BUCK2_DVS_PIN };
  408. u8 default_dvs_mode[] = { LP8788_BUCK1_DVS_I2C, LP8788_BUCK2_DVS_I2C };
  409. /* no dvs for buck3, 4 */
  410. if (id > BUCK2)
  411. return 0;
  412. /* no dvs platform data, then dvs will be selected by I2C registers */
  413. if (!pdata)
  414. goto set_default_dvs_mode;
  415. if ((id == BUCK1 && !pdata->buck1_dvs) ||
  416. (id == BUCK2 && !pdata->buck2_dvs))
  417. goto set_default_dvs_mode;
  418. if (lp8788_dvs_gpio_request(pdev, buck, id))
  419. goto set_default_dvs_mode;
  420. return lp8788_update_bits(buck->lp, LP8788_BUCK_DVS_SEL, mask[id],
  421. val[id]);
  422. set_default_dvs_mode:
  423. return lp8788_update_bits(buck->lp, LP8788_BUCK_DVS_SEL, mask[id],
  424. default_dvs_mode[id]);
  425. }
  426. static int lp8788_buck_probe(struct platform_device *pdev)
  427. {
  428. struct lp8788 *lp = dev_get_drvdata(pdev->dev.parent);
  429. int id = pdev->id;
  430. struct lp8788_buck *buck;
  431. struct regulator_config cfg = { };
  432. struct regulator_dev *rdev;
  433. int ret;
  434. if (id >= LP8788_NUM_BUCKS)
  435. return -EINVAL;
  436. buck = devm_kzalloc(&pdev->dev, sizeof(struct lp8788_buck), GFP_KERNEL);
  437. if (!buck)
  438. return -ENOMEM;
  439. buck->lp = lp;
  440. ret = lp8788_init_dvs(pdev, buck, id);
  441. if (ret)
  442. return ret;
  443. cfg.dev = pdev->dev.parent;
  444. cfg.init_data = lp->pdata ? lp->pdata->buck_data[id] : NULL;
  445. cfg.driver_data = buck;
  446. cfg.regmap = lp->regmap;
  447. rdev = devm_regulator_register(&pdev->dev, &lp8788_buck_desc[id], &cfg);
  448. if (IS_ERR(rdev)) {
  449. ret = PTR_ERR(rdev);
  450. dev_err(&pdev->dev, "BUCK%d regulator register err = %d\n",
  451. id + 1, ret);
  452. return ret;
  453. }
  454. buck->regulator = rdev;
  455. platform_set_drvdata(pdev, buck);
  456. return 0;
  457. }
  458. static struct platform_driver lp8788_buck_driver = {
  459. .probe = lp8788_buck_probe,
  460. .driver = {
  461. .name = LP8788_DEV_BUCK,
  462. },
  463. };
  464. static int __init lp8788_buck_init(void)
  465. {
  466. return platform_driver_register(&lp8788_buck_driver);
  467. }
  468. subsys_initcall(lp8788_buck_init);
  469. static void __exit lp8788_buck_exit(void)
  470. {
  471. platform_driver_unregister(&lp8788_buck_driver);
  472. }
  473. module_exit(lp8788_buck_exit);
  474. MODULE_DESCRIPTION("TI LP8788 BUCK Driver");
  475. MODULE_AUTHOR("Milo Kim");
  476. MODULE_LICENSE("GPL");
  477. MODULE_ALIAS("platform:lp8788-buck");