0102-hwrng-starfive-Add-TRNG-driver-for-StarFive-SoC.patch 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457
  1. From 99a7ca1d1320288efc5b4532ce4ea637d622aa00 Mon Sep 17 00:00:00 2001
  2. From: Jia Jie Ho <[email protected]>
  3. Date: Tue, 17 Jan 2023 09:54:44 +0800
  4. Subject: [PATCH 102/122] hwrng: starfive - Add TRNG driver for StarFive SoC
  5. This adds driver support for the hardware random number generator in
  6. Starfive SoCs and adds StarFive TRNG entry to MAINTAINERS.
  7. Co-developed-by: Jenny Zhang <[email protected]>
  8. Signed-off-by: Jenny Zhang <[email protected]>
  9. Signed-off-by: Jia Jie Ho <[email protected]>
  10. ---
  11. MAINTAINERS | 6 +
  12. drivers/char/hw_random/Kconfig | 11 +
  13. drivers/char/hw_random/Makefile | 1 +
  14. drivers/char/hw_random/jh7110-trng.c | 393 +++++++++++++++++++++++++++
  15. 4 files changed, 411 insertions(+)
  16. create mode 100644 drivers/char/hw_random/jh7110-trng.c
  17. --- a/MAINTAINERS
  18. +++ b/MAINTAINERS
  19. @@ -19716,6 +19716,12 @@ F: Documentation/devicetree/bindings/pow
  20. F: drivers/soc/starfive/jh71xx_pmu.c
  21. F: include/dt-bindings/power/starfive,jh7110-pmu.h
  22. +STARFIVE TRNG DRIVER
  23. +M: Jia Jie Ho <[email protected]>
  24. +S: Supported
  25. +F: Documentation/devicetree/bindings/rng/starfive*
  26. +F: drivers/char/hw_random/starfive-trng.c
  27. +
  28. STATIC BRANCH/CALL
  29. M: Peter Zijlstra <[email protected]>
  30. M: Josh Poimboeuf <[email protected]>
  31. --- a/drivers/char/hw_random/Kconfig
  32. +++ b/drivers/char/hw_random/Kconfig
  33. @@ -549,6 +549,17 @@ config HW_RANDOM_CN10K
  34. To compile this driver as a module, choose M here.
  35. The module will be called cn10k_rng. If unsure, say Y.
  36. +config HW_RANDOM_JH7110
  37. + tristate "StarFive JH7110 Random Number Generator support"
  38. + depends on SOC_STARFIVE
  39. + depends on HW_RANDOM
  40. + help
  41. + This driver provides support for the True Random Number
  42. + Generator in StarFive JH7110 SoCs.
  43. +
  44. + To compile this driver as a module, choose M here.
  45. + The module will be called jh7110-trng.
  46. +
  47. endif # HW_RANDOM
  48. config UML_RANDOM
  49. --- a/drivers/char/hw_random/Makefile
  50. +++ b/drivers/char/hw_random/Makefile
  51. @@ -47,3 +47,4 @@ obj-$(CONFIG_HW_RANDOM_XIPHERA) += xiphe
  52. obj-$(CONFIG_HW_RANDOM_ARM_SMCCC_TRNG) += arm_smccc_trng.o
  53. obj-$(CONFIG_HW_RANDOM_CN10K) += cn10k-rng.o
  54. obj-$(CONFIG_HW_RANDOM_POLARFIRE_SOC) += mpfs-rng.o
  55. +obj-$(CONFIG_HW_RANDOM_JH7110) += jh7110-trng.o
  56. --- /dev/null
  57. +++ b/drivers/char/hw_random/jh7110-trng.c
  58. @@ -0,0 +1,393 @@
  59. +// SPDX-License-Identifier: GPL-2.0
  60. +/*
  61. + * TRNG driver for the StarFive JH7110 SoC
  62. + *
  63. + * Copyright (C) 2022 StarFive Technology Co.
  64. + */
  65. +
  66. +#include <linux/clk.h>
  67. +#include <linux/completion.h>
  68. +#include <linux/delay.h>
  69. +#include <linux/err.h>
  70. +#include <linux/hw_random.h>
  71. +#include <linux/interrupt.h>
  72. +#include <linux/io.h>
  73. +#include <linux/iopoll.h>
  74. +#include <linux/kernel.h>
  75. +#include <linux/module.h>
  76. +#include <linux/of.h>
  77. +#include <linux/platform_device.h>
  78. +#include <linux/pm_runtime.h>
  79. +#include <linux/random.h>
  80. +#include <linux/reset.h>
  81. +
  82. +/* trng register offset */
  83. +#define STARFIVE_CTRL 0x00
  84. +#define STARFIVE_STAT 0x04
  85. +#define STARFIVE_MODE 0x08
  86. +#define STARFIVE_SMODE 0x0C
  87. +#define STARFIVE_IE 0x10
  88. +#define STARFIVE_ISTAT 0x14
  89. +#define STARFIVE_RAND0 0x20
  90. +#define STARFIVE_RAND1 0x24
  91. +#define STARFIVE_RAND2 0x28
  92. +#define STARFIVE_RAND3 0x2C
  93. +#define STARFIVE_RAND4 0x30
  94. +#define STARFIVE_RAND5 0x34
  95. +#define STARFIVE_RAND6 0x38
  96. +#define STARFIVE_RAND7 0x3C
  97. +#define STARFIVE_AUTO_RQSTS 0x60
  98. +#define STARFIVE_AUTO_AGE 0x64
  99. +
  100. +/* CTRL CMD */
  101. +#define STARFIVE_CTRL_EXEC_NOP 0x0
  102. +#define STARFIVE_CTRL_GENE_RANDNUM 0x1
  103. +#define STARFIVE_CTRL_EXEC_RANDRESEED 0x2
  104. +
  105. +/* STAT */
  106. +#define STARFIVE_STAT_NONCE_MODE BIT(2)
  107. +#define STARFIVE_STAT_R256 BIT(3)
  108. +#define STARFIVE_STAT_MISSION_MODE BIT(8)
  109. +#define STARFIVE_STAT_SEEDED BIT(9)
  110. +#define STARFIVE_STAT_LAST_RESEED(x) ((x) << 16)
  111. +#define STARFIVE_STAT_SRVC_RQST BIT(27)
  112. +#define STARFIVE_STAT_RAND_GENERATING BIT(30)
  113. +#define STARFIVE_STAT_RAND_SEEDING BIT(31)
  114. +
  115. +/* MODE */
  116. +#define STARFIVE_MODE_R256 BIT(3)
  117. +
  118. +/* SMODE */
  119. +#define STARFIVE_SMODE_NONCE_MODE BIT(2)
  120. +#define STARFIVE_SMODE_MISSION_MODE BIT(8)
  121. +#define STARFIVE_SMODE_MAX_REJECTS(x) ((x) << 16)
  122. +
  123. +/* IE */
  124. +#define STARFIVE_IE_RAND_RDY_EN BIT(0)
  125. +#define STARFIVE_IE_SEED_DONE_EN BIT(1)
  126. +#define STARFIVE_IE_LFSR_LOCKUP_EN BIT(4)
  127. +#define STARFIVE_IE_GLBL_EN BIT(31)
  128. +
  129. +#define STARFIVE_IE_ALL (STARFIVE_IE_GLBL_EN | \
  130. + STARFIVE_IE_RAND_RDY_EN | \
  131. + STARFIVE_IE_SEED_DONE_EN | \
  132. + STARFIVE_IE_LFSR_LOCKUP_EN)
  133. +
  134. +/* ISTAT */
  135. +#define STARFIVE_ISTAT_RAND_RDY BIT(0)
  136. +#define STARFIVE_ISTAT_SEED_DONE BIT(1)
  137. +#define STARFIVE_ISTAT_LFSR_LOCKUP BIT(4)
  138. +
  139. +#define STARFIVE_RAND_LEN sizeof(u32)
  140. +
  141. +#define to_trng(p) container_of(p, struct starfive_trng, rng)
  142. +
  143. +enum reseed {
  144. + RANDOM_RESEED,
  145. + NONCE_RESEED,
  146. +};
  147. +
  148. +enum mode {
  149. + PRNG_128BIT,
  150. + PRNG_256BIT,
  151. +};
  152. +
  153. +struct starfive_trng {
  154. + struct device *dev;
  155. + void __iomem *base;
  156. + struct clk *hclk;
  157. + struct clk *ahb;
  158. + struct reset_control *rst;
  159. + struct hwrng rng;
  160. + struct completion random_done;
  161. + struct completion reseed_done;
  162. + u32 mode;
  163. + u32 mission;
  164. + u32 reseed;
  165. + /* protects against concurrent write to ctrl register */
  166. + spinlock_t write_lock;
  167. +};
  168. +
  169. +static u16 autoreq;
  170. +module_param(autoreq, ushort, 0);
  171. +MODULE_PARM_DESC(autoreq, "Auto-reseeding after random number requests by host reaches specified counter:\n"
  172. + " 0 - disable counter\n"
  173. + " other - reload value for internal counter");
  174. +
  175. +static u16 autoage;
  176. +module_param(autoage, ushort, 0);
  177. +MODULE_PARM_DESC(autoage, "Auto-reseeding after specified timer countdowns to 0:\n"
  178. + " 0 - disable timer\n"
  179. + " other - reload value for internal timer");
  180. +
  181. +static inline int starfive_trng_wait_idle(struct starfive_trng *trng)
  182. +{
  183. + u32 stat;
  184. +
  185. + return readl_relaxed_poll_timeout(trng->base + STARFIVE_STAT, stat,
  186. + !(stat & (STARFIVE_STAT_RAND_GENERATING |
  187. + STARFIVE_STAT_RAND_SEEDING)),
  188. + 10, 100000);
  189. +}
  190. +
  191. +static inline void starfive_trng_irq_mask_clear(struct starfive_trng *trng)
  192. +{
  193. + /* clear register: ISTAT */
  194. + u32 data = readl(trng->base + STARFIVE_ISTAT);
  195. +
  196. + writel(data, trng->base + STARFIVE_ISTAT);
  197. +}
  198. +
  199. +static int starfive_trng_cmd(struct starfive_trng *trng, u32 cmd, bool wait)
  200. +{
  201. + int wait_time = 1000;
  202. +
  203. + /* allow up to 40 us for wait == 0 */
  204. + if (!wait)
  205. + wait_time = 40;
  206. +
  207. + switch (cmd) {
  208. + case STARFIVE_CTRL_GENE_RANDNUM:
  209. + reinit_completion(&trng->random_done);
  210. + spin_lock_irq(&trng->write_lock);
  211. + writel(cmd, trng->base + STARFIVE_CTRL);
  212. + spin_unlock_irq(&trng->write_lock);
  213. + if (!wait_for_completion_timeout(&trng->random_done, usecs_to_jiffies(wait_time)))
  214. + return -ETIMEDOUT;
  215. + break;
  216. + case STARFIVE_CTRL_EXEC_RANDRESEED:
  217. + reinit_completion(&trng->reseed_done);
  218. + spin_lock_irq(&trng->write_lock);
  219. + writel(cmd, trng->base + STARFIVE_CTRL);
  220. + spin_unlock_irq(&trng->write_lock);
  221. + if (!wait_for_completion_timeout(&trng->reseed_done, usecs_to_jiffies(wait_time)))
  222. + return -ETIMEDOUT;
  223. + break;
  224. + default:
  225. + return -EINVAL;
  226. + }
  227. +
  228. + return 0;
  229. +}
  230. +
  231. +static int starfive_trng_init(struct hwrng *rng)
  232. +{
  233. + struct starfive_trng *trng = to_trng(rng);
  234. + u32 mode, intr = 0;
  235. +
  236. + /* setup Auto Request/Age register */
  237. + writel(autoage, trng->base + STARFIVE_AUTO_AGE);
  238. + writel(autoreq, trng->base + STARFIVE_AUTO_RQSTS);
  239. +
  240. + /* clear register: ISTAT */
  241. + starfive_trng_irq_mask_clear(trng);
  242. +
  243. + intr |= STARFIVE_IE_ALL;
  244. + writel(intr, trng->base + STARFIVE_IE);
  245. +
  246. + mode = readl(trng->base + STARFIVE_MODE);
  247. +
  248. + switch (trng->mode) {
  249. + case PRNG_128BIT:
  250. + mode &= ~STARFIVE_MODE_R256;
  251. + break;
  252. + case PRNG_256BIT:
  253. + mode |= STARFIVE_MODE_R256;
  254. + break;
  255. + default:
  256. + mode |= STARFIVE_MODE_R256;
  257. + break;
  258. + }
  259. +
  260. + writel(mode, trng->base + STARFIVE_MODE);
  261. +
  262. + return starfive_trng_cmd(trng, STARFIVE_CTRL_EXEC_RANDRESEED, 1);
  263. +}
  264. +
  265. +static irqreturn_t starfive_trng_irq(int irq, void *priv)
  266. +{
  267. + u32 status;
  268. + struct starfive_trng *trng = (struct starfive_trng *)priv;
  269. +
  270. + status = readl(trng->base + STARFIVE_ISTAT);
  271. + if (status & STARFIVE_ISTAT_RAND_RDY) {
  272. + writel(STARFIVE_ISTAT_RAND_RDY, trng->base + STARFIVE_ISTAT);
  273. + complete(&trng->random_done);
  274. + }
  275. +
  276. + if (status & STARFIVE_ISTAT_SEED_DONE) {
  277. + writel(STARFIVE_ISTAT_SEED_DONE, trng->base + STARFIVE_ISTAT);
  278. + complete(&trng->reseed_done);
  279. + }
  280. +
  281. + if (status & STARFIVE_ISTAT_LFSR_LOCKUP) {
  282. + writel(STARFIVE_ISTAT_LFSR_LOCKUP, trng->base + STARFIVE_ISTAT);
  283. + /* SEU occurred, reseeding required*/
  284. + spin_lock(&trng->write_lock);
  285. + writel(STARFIVE_CTRL_EXEC_RANDRESEED, trng->base + STARFIVE_CTRL);
  286. + spin_unlock(&trng->write_lock);
  287. + }
  288. +
  289. + return IRQ_HANDLED;
  290. +}
  291. +
  292. +static void starfive_trng_cleanup(struct hwrng *rng)
  293. +{
  294. + struct starfive_trng *trng = to_trng(rng);
  295. +
  296. + writel(0, trng->base + STARFIVE_CTRL);
  297. +
  298. + reset_control_assert(trng->rst);
  299. + clk_disable_unprepare(trng->hclk);
  300. + clk_disable_unprepare(trng->ahb);
  301. +}
  302. +
  303. +static int starfive_trng_read(struct hwrng *rng, void *buf, size_t max, bool wait)
  304. +{
  305. + struct starfive_trng *trng = to_trng(rng);
  306. + int ret;
  307. +
  308. + pm_runtime_get_sync(trng->dev);
  309. +
  310. + if (trng->mode == PRNG_256BIT)
  311. + max = min_t(size_t, max, (STARFIVE_RAND_LEN * 8));
  312. + else
  313. + max = min_t(size_t, max, (STARFIVE_RAND_LEN * 4));
  314. +
  315. + if (wait) {
  316. + ret = starfive_trng_wait_idle(trng);
  317. + if (ret)
  318. + return -ETIMEDOUT;
  319. + }
  320. +
  321. + ret = starfive_trng_cmd(trng, STARFIVE_CTRL_GENE_RANDNUM, wait);
  322. + if (ret)
  323. + return ret;
  324. +
  325. + memcpy_fromio(buf, trng->base + STARFIVE_RAND0, max);
  326. +
  327. + pm_runtime_put_sync_autosuspend(trng->dev);
  328. +
  329. + return max;
  330. +}
  331. +
  332. +static int starfive_trng_probe(struct platform_device *pdev)
  333. +{
  334. + int ret;
  335. + int irq;
  336. + struct starfive_trng *trng;
  337. +
  338. + trng = devm_kzalloc(&pdev->dev, sizeof(*trng), GFP_KERNEL);
  339. + if (!trng)
  340. + return -ENOMEM;
  341. +
  342. + platform_set_drvdata(pdev, trng);
  343. + trng->dev = &pdev->dev;
  344. +
  345. + trng->base = devm_platform_ioremap_resource(pdev, 0);
  346. + if (IS_ERR(trng->base))
  347. + return dev_err_probe(&pdev->dev, PTR_ERR(trng->base),
  348. + "Error remapping memory for platform device.\n");
  349. +
  350. + irq = platform_get_irq(pdev, 0);
  351. + if (irq < 0)
  352. + return irq;
  353. +
  354. + init_completion(&trng->random_done);
  355. + init_completion(&trng->reseed_done);
  356. + spin_lock_init(&trng->write_lock);
  357. +
  358. + ret = devm_request_irq(&pdev->dev, irq, starfive_trng_irq, 0, pdev->name,
  359. + (void *)trng);
  360. + if (ret)
  361. + return dev_err_probe(&pdev->dev, irq,
  362. + "Failed to register interrupt handler\n");
  363. +
  364. + trng->hclk = devm_clk_get(&pdev->dev, "hclk");
  365. + if (IS_ERR(trng->hclk))
  366. + return dev_err_probe(&pdev->dev, PTR_ERR(trng->hclk),
  367. + "Error getting hardware reference clock\n");
  368. +
  369. + trng->ahb = devm_clk_get(&pdev->dev, "ahb");
  370. + if (IS_ERR(trng->ahb))
  371. + return dev_err_probe(&pdev->dev, PTR_ERR(trng->ahb),
  372. + "Error getting ahb reference clock\n");
  373. +
  374. + trng->rst = devm_reset_control_get_shared(&pdev->dev, NULL);
  375. + if (IS_ERR(trng->rst))
  376. + return dev_err_probe(&pdev->dev, PTR_ERR(trng->rst),
  377. + "Error getting hardware reset line\n");
  378. +
  379. + clk_prepare_enable(trng->hclk);
  380. + clk_prepare_enable(trng->ahb);
  381. + reset_control_deassert(trng->rst);
  382. +
  383. + trng->rng.name = dev_driver_string(&pdev->dev);
  384. + trng->rng.init = starfive_trng_init;
  385. + trng->rng.cleanup = starfive_trng_cleanup;
  386. + trng->rng.read = starfive_trng_read;
  387. +
  388. + trng->mode = PRNG_256BIT;
  389. + trng->mission = 1;
  390. + trng->reseed = RANDOM_RESEED;
  391. +
  392. + pm_runtime_use_autosuspend(&pdev->dev);
  393. + pm_runtime_set_autosuspend_delay(&pdev->dev, 100);
  394. + pm_runtime_enable(&pdev->dev);
  395. +
  396. + ret = devm_hwrng_register(&pdev->dev, &trng->rng);
  397. + if (ret) {
  398. + pm_runtime_disable(&pdev->dev);
  399. +
  400. + reset_control_assert(trng->rst);
  401. + clk_disable_unprepare(trng->ahb);
  402. + clk_disable_unprepare(trng->hclk);
  403. +
  404. + return dev_err_probe(&pdev->dev, ret, "Failed to register hwrng\n");
  405. + }
  406. +
  407. + return 0;
  408. +}
  409. +
  410. +static int __maybe_unused starfive_trng_suspend(struct device *dev)
  411. +{
  412. + struct starfive_trng *trng = dev_get_drvdata(dev);
  413. +
  414. + clk_disable_unprepare(trng->hclk);
  415. + clk_disable_unprepare(trng->ahb);
  416. +
  417. + return 0;
  418. +}
  419. +
  420. +static int __maybe_unused starfive_trng_resume(struct device *dev)
  421. +{
  422. + struct starfive_trng *trng = dev_get_drvdata(dev);
  423. +
  424. + clk_prepare_enable(trng->hclk);
  425. + clk_prepare_enable(trng->ahb);
  426. +
  427. + return 0;
  428. +}
  429. +
  430. +static DEFINE_SIMPLE_DEV_PM_OPS(starfive_trng_pm_ops, starfive_trng_suspend,
  431. + starfive_trng_resume);
  432. +
  433. +static const struct of_device_id trng_dt_ids[] __maybe_unused = {
  434. + { .compatible = "starfive,jh7110-trng" },
  435. + { }
  436. +};
  437. +MODULE_DEVICE_TABLE(of, trng_dt_ids);
  438. +
  439. +static struct platform_driver starfive_trng_driver = {
  440. + .probe = starfive_trng_probe,
  441. + .driver = {
  442. + .name = "jh7110-trng",
  443. + .pm = &starfive_trng_pm_ops,
  444. + .of_match_table = of_match_ptr(trng_dt_ids),
  445. + },
  446. +};
  447. +
  448. +module_platform_driver(starfive_trng_driver);
  449. +
  450. +MODULE_LICENSE("GPL");
  451. +MODULE_DESCRIPTION("StarFive True Random Number Generator");