1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * ST Random Number Generator Driver ST's Platforms
4 *
5 * Author: Pankaj Dev: <pankaj.dev@st.com>
6 * Lee Jones <lee.jones@linaro.org>
7 *
8 * Copyright (C) 2015 STMicroelectronics (R&D) Limited
9 */
10
11 #include <linux/clk.h>
12 #include <linux/delay.h>
13 #include <linux/hw_random.h>
14 #include <linux/io.h>
15 #include <linux/module.h>
16 #include <linux/of.h>
17 #include <linux/platform_device.h>
18 #include <linux/slab.h>
19
20 /* Registers */
21 #define ST_RNG_STATUS_REG 0x20
22 #define ST_RNG_DATA_REG 0x24
23
24 /* Registers fields */
25 #define ST_RNG_STATUS_BAD_SEQUENCE BIT(0)
26 #define ST_RNG_STATUS_BAD_ALTERNANCE BIT(1)
27 #define ST_RNG_STATUS_FIFO_FULL BIT(5)
28
29 #define ST_RNG_SAMPLE_SIZE 2 /* 2 Byte (16bit) samples */
30 #define ST_RNG_FIFO_DEPTH 4
31 #define ST_RNG_FIFO_SIZE (ST_RNG_FIFO_DEPTH * ST_RNG_SAMPLE_SIZE)
32
33 /*
34 * Samples are documented to be available every 0.667us, so in theory
35 * the 4 sample deep FIFO should take 2.668us to fill. However, during
36 * thorough testing, it became apparent that filling the FIFO actually
37 * takes closer to 12us. We then multiply by 2 in order to account for
38 * the lack of udelay()'s reliability, suggested by Russell King.
39 */
40 #define ST_RNG_FILL_FIFO_TIMEOUT (12 * 2)
41
42 struct st_rng_data {
43 void __iomem *base;
44 struct clk *clk;
45 struct hwrng ops;
46 };
47
st_rng_read(struct hwrng * rng,void * data,size_t max,bool wait)48 static int st_rng_read(struct hwrng *rng, void *data, size_t max, bool wait)
49 {
50 struct st_rng_data *ddata = (struct st_rng_data *)rng->priv;
51 u32 status;
52 int i;
53
54 /* Wait until FIFO is full - max 4uS*/
55 for (i = 0; i < ST_RNG_FILL_FIFO_TIMEOUT; i++) {
56 status = readl_relaxed(ddata->base + ST_RNG_STATUS_REG);
57 if (status & ST_RNG_STATUS_FIFO_FULL)
58 break;
59 udelay(1);
60 }
61
62 if (i == ST_RNG_FILL_FIFO_TIMEOUT)
63 return 0;
64
65 for (i = 0; i < ST_RNG_FIFO_SIZE && i < max; i += 2)
66 *(u16 *)(data + i) =
67 readl_relaxed(ddata->base + ST_RNG_DATA_REG);
68
69 return i; /* No of bytes read */
70 }
71
st_rng_probe(struct platform_device * pdev)72 static int st_rng_probe(struct platform_device *pdev)
73 {
74 struct st_rng_data *ddata;
75 struct resource *res;
76 struct clk *clk;
77 void __iomem *base;
78 int ret;
79
80 ddata = devm_kzalloc(&pdev->dev, sizeof(*ddata), GFP_KERNEL);
81 if (!ddata)
82 return -ENOMEM;
83
84 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
85 base = devm_ioremap_resource(&pdev->dev, res);
86 if (IS_ERR(base))
87 return PTR_ERR(base);
88
89 clk = devm_clk_get(&pdev->dev, NULL);
90 if (IS_ERR(clk))
91 return PTR_ERR(clk);
92
93 ret = clk_prepare_enable(clk);
94 if (ret)
95 return ret;
96
97 ddata->ops.priv = (unsigned long)ddata;
98 ddata->ops.read = st_rng_read;
99 ddata->ops.name = pdev->name;
100 ddata->base = base;
101 ddata->clk = clk;
102
103 dev_set_drvdata(&pdev->dev, ddata);
104
105 ret = devm_hwrng_register(&pdev->dev, &ddata->ops);
106 if (ret) {
107 dev_err(&pdev->dev, "Failed to register HW RNG\n");
108 clk_disable_unprepare(clk);
109 return ret;
110 }
111
112 dev_info(&pdev->dev, "Successfully registered HW RNG\n");
113
114 return 0;
115 }
116
st_rng_remove(struct platform_device * pdev)117 static int st_rng_remove(struct platform_device *pdev)
118 {
119 struct st_rng_data *ddata = dev_get_drvdata(&pdev->dev);
120
121 clk_disable_unprepare(ddata->clk);
122
123 return 0;
124 }
125
126 static const struct of_device_id st_rng_match[] = {
127 { .compatible = "st,rng" },
128 {},
129 };
130 MODULE_DEVICE_TABLE(of, st_rng_match);
131
132 static struct platform_driver st_rng_driver = {
133 .driver = {
134 .name = "st-hwrandom",
135 .of_match_table = of_match_ptr(st_rng_match),
136 },
137 .probe = st_rng_probe,
138 .remove = st_rng_remove
139 };
140
141 module_platform_driver(st_rng_driver);
142
143 MODULE_AUTHOR("Pankaj Dev <pankaj.dev@st.com>");
144 MODULE_LICENSE("GPL v2");
145
