2 * exynos-rng.c - Random Number Generator driver for the Exynos
4 * Copyright (c) 2017 Krzysztof Kozlowski <krzk@kernel.org>
6 * Loosely based on old driver from drivers/char/hw_random/exynos-rng.c:
7 * Copyright (C) 2012 Samsung Electronics
8 * Jonghwa Lee <jonghwa3.lee@samsung.com>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation;
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
20 #include <linux/clk.h>
21 #include <linux/crypto.h>
22 #include <linux/err.h>
24 #include <linux/module.h>
25 #include <linux/mutex.h>
26 #include <linux/of_device.h>
27 #include <linux/platform_device.h>
29 #include <crypto/internal/rng.h>
31 #define EXYNOS_RNG_CONTROL 0x0
32 #define EXYNOS_RNG_STATUS 0x10
34 #define EXYNOS_RNG_SEED_CONF 0x14
35 #define EXYNOS_RNG_GEN_PRNG BIT(1)
37 #define EXYNOS_RNG_SEED_BASE 0x140
38 #define EXYNOS_RNG_SEED(n) (EXYNOS_RNG_SEED_BASE + (n * 0x4))
39 #define EXYNOS_RNG_OUT_BASE 0x160
40 #define EXYNOS_RNG_OUT(n) (EXYNOS_RNG_OUT_BASE + (n * 0x4))
42 /* EXYNOS_RNG_CONTROL bit fields */
43 #define EXYNOS_RNG_CONTROL_START 0x18
44 /* EXYNOS_RNG_STATUS bit fields */
45 #define EXYNOS_RNG_STATUS_SEED_SETTING_DONE BIT(1)
46 #define EXYNOS_RNG_STATUS_RNG_DONE BIT(5)
48 /* Five seed and output registers, each 4 bytes */
49 #define EXYNOS_RNG_SEED_REGS 5
50 #define EXYNOS_RNG_SEED_SIZE (EXYNOS_RNG_SEED_REGS * 4)
52 enum exynos_prng_type {
53 EXYNOS_PRNG_UNKNOWN = 0,
59 * Driver re-seeds itself with generated random numbers to hinder
60 * backtracking of the original seed.
62 * Time for next re-seed in ms.
64 #define EXYNOS_RNG_RESEED_TIME 1000
65 #define EXYNOS_RNG_RESEED_BYTES 65536
68 * In polling mode, do not wait infinitely for the engine to finish the work.
70 #define EXYNOS_RNG_WAIT_RETRIES 100
72 /* Context for crypto */
73 struct exynos_rng_ctx {
74 struct exynos_rng_dev *rng;
77 /* Device associated memory */
78 struct exynos_rng_dev {
80 enum exynos_prng_type type;
84 /* Generated numbers stored for seeding during resume */
85 u8 seed_save[EXYNOS_RNG_SEED_SIZE];
86 unsigned int seed_save_len;
87 /* Time of last seeding in jiffies */
88 unsigned long last_seeding;
89 /* Bytes generated since last seeding */
90 unsigned long bytes_seeding;
93 static struct exynos_rng_dev *exynos_rng_dev;
95 static u32 exynos_rng_readl(struct exynos_rng_dev *rng, u32 offset)
97 return readl_relaxed(rng->mem + offset);
100 static void exynos_rng_writel(struct exynos_rng_dev *rng, u32 val, u32 offset)
102 writel_relaxed(val, rng->mem + offset);
105 static int exynos_rng_set_seed(struct exynos_rng_dev *rng,
106 const u8 *seed, unsigned int slen)
111 /* Round seed length because loop iterates over full register size */
112 slen = ALIGN_DOWN(slen, 4);
114 if (slen < EXYNOS_RNG_SEED_SIZE)
117 for (i = 0; i < slen ; i += 4) {
118 unsigned int seed_reg = (i / 4) % EXYNOS_RNG_SEED_REGS;
121 val |= seed[i + 1] << 16;
122 val |= seed[i + 2] << 8;
123 val |= seed[i + 3] << 0;
125 exynos_rng_writel(rng, val, EXYNOS_RNG_SEED(seed_reg));
128 val = exynos_rng_readl(rng, EXYNOS_RNG_STATUS);
129 if (!(val & EXYNOS_RNG_STATUS_SEED_SETTING_DONE)) {
130 dev_warn(rng->dev, "Seed setting not finished\n");
134 rng->last_seeding = jiffies;
135 rng->bytes_seeding = 0;
141 * Start the engine and poll for finish. Then read from output registers
142 * filling the 'dst' buffer up to 'dlen' bytes or up to size of generated
143 * random data (EXYNOS_RNG_SEED_SIZE).
145 * On success: return 0 and store number of read bytes under 'read' address.
146 * On error: return -ERRNO.
148 static int exynos_rng_get_random(struct exynos_rng_dev *rng,
149 u8 *dst, unsigned int dlen,
152 int retry = EXYNOS_RNG_WAIT_RETRIES;
154 if (rng->type == EXYNOS_PRNG_EXYNOS4) {
155 exynos_rng_writel(rng, EXYNOS_RNG_CONTROL_START,
157 } else if (rng->type == EXYNOS_PRNG_EXYNOS5) {
158 exynos_rng_writel(rng, EXYNOS_RNG_GEN_PRNG,
159 EXYNOS_RNG_SEED_CONF);
162 while (!(exynos_rng_readl(rng,
163 EXYNOS_RNG_STATUS) & EXYNOS_RNG_STATUS_RNG_DONE) && --retry)
169 /* Clear status bit */
170 exynos_rng_writel(rng, EXYNOS_RNG_STATUS_RNG_DONE,
172 *read = min_t(size_t, dlen, EXYNOS_RNG_SEED_SIZE);
173 memcpy_fromio(dst, rng->mem + EXYNOS_RNG_OUT_BASE, *read);
174 rng->bytes_seeding += *read;
179 /* Re-seed itself from time to time */
180 static void exynos_rng_reseed(struct exynos_rng_dev *rng)
182 unsigned long next_seeding = rng->last_seeding + \
183 msecs_to_jiffies(EXYNOS_RNG_RESEED_TIME);
184 unsigned long now = jiffies;
185 unsigned int read = 0;
186 u8 seed[EXYNOS_RNG_SEED_SIZE];
188 if (time_before(now, next_seeding) &&
189 rng->bytes_seeding < EXYNOS_RNG_RESEED_BYTES)
192 if (exynos_rng_get_random(rng, seed, sizeof(seed), &read))
195 exynos_rng_set_seed(rng, seed, read);
197 /* Let others do some of their job. */
198 mutex_unlock(&rng->lock);
199 mutex_lock(&rng->lock);
202 static int exynos_rng_generate(struct crypto_rng *tfm,
203 const u8 *src, unsigned int slen,
204 u8 *dst, unsigned int dlen)
206 struct exynos_rng_ctx *ctx = crypto_rng_ctx(tfm);
207 struct exynos_rng_dev *rng = ctx->rng;
208 unsigned int read = 0;
211 ret = clk_prepare_enable(rng->clk);
215 mutex_lock(&rng->lock);
217 ret = exynos_rng_get_random(rng, dst, dlen, &read);
224 exynos_rng_reseed(rng);
226 mutex_unlock(&rng->lock);
228 clk_disable_unprepare(rng->clk);
233 static int exynos_rng_seed(struct crypto_rng *tfm, const u8 *seed,
236 struct exynos_rng_ctx *ctx = crypto_rng_ctx(tfm);
237 struct exynos_rng_dev *rng = ctx->rng;
240 ret = clk_prepare_enable(rng->clk);
244 mutex_lock(&rng->lock);
245 ret = exynos_rng_set_seed(ctx->rng, seed, slen);
246 mutex_unlock(&rng->lock);
248 clk_disable_unprepare(rng->clk);
253 static int exynos_rng_kcapi_init(struct crypto_tfm *tfm)
255 struct exynos_rng_ctx *ctx = crypto_tfm_ctx(tfm);
257 ctx->rng = exynos_rng_dev;
262 static struct rng_alg exynos_rng_alg = {
263 .generate = exynos_rng_generate,
264 .seed = exynos_rng_seed,
265 .seedsize = EXYNOS_RNG_SEED_SIZE,
267 .cra_name = "stdrng",
268 .cra_driver_name = "exynos_rng",
270 .cra_ctxsize = sizeof(struct exynos_rng_ctx),
271 .cra_module = THIS_MODULE,
272 .cra_init = exynos_rng_kcapi_init,
276 static int exynos_rng_probe(struct platform_device *pdev)
278 struct exynos_rng_dev *rng;
279 struct resource *res;
285 rng = devm_kzalloc(&pdev->dev, sizeof(*rng), GFP_KERNEL);
289 rng->type = (enum exynos_prng_type)of_device_get_match_data(&pdev->dev);
291 mutex_init(&rng->lock);
293 rng->dev = &pdev->dev;
294 rng->clk = devm_clk_get(&pdev->dev, "secss");
295 if (IS_ERR(rng->clk)) {
296 dev_err(&pdev->dev, "Couldn't get clock.\n");
297 return PTR_ERR(rng->clk);
300 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
301 rng->mem = devm_ioremap_resource(&pdev->dev, res);
302 if (IS_ERR(rng->mem))
303 return PTR_ERR(rng->mem);
305 platform_set_drvdata(pdev, rng);
307 exynos_rng_dev = rng;
309 ret = crypto_register_rng(&exynos_rng_alg);
312 "Couldn't register rng crypto alg: %d\n", ret);
313 exynos_rng_dev = NULL;
319 static int exynos_rng_remove(struct platform_device *pdev)
321 crypto_unregister_rng(&exynos_rng_alg);
323 exynos_rng_dev = NULL;
328 static int __maybe_unused exynos_rng_suspend(struct device *dev)
330 struct platform_device *pdev = to_platform_device(dev);
331 struct exynos_rng_dev *rng = platform_get_drvdata(pdev);
334 /* If we were never seeded then after resume it will be the same */
335 if (!rng->last_seeding)
338 rng->seed_save_len = 0;
339 ret = clk_prepare_enable(rng->clk);
343 mutex_lock(&rng->lock);
345 /* Get new random numbers and store them for seeding on resume. */
346 exynos_rng_get_random(rng, rng->seed_save, sizeof(rng->seed_save),
347 &(rng->seed_save_len));
349 mutex_unlock(&rng->lock);
351 dev_dbg(rng->dev, "Stored %u bytes for seeding on system resume\n",
354 clk_disable_unprepare(rng->clk);
359 static int __maybe_unused exynos_rng_resume(struct device *dev)
361 struct platform_device *pdev = to_platform_device(dev);
362 struct exynos_rng_dev *rng = platform_get_drvdata(pdev);
365 /* Never seeded so nothing to do */
366 if (!rng->last_seeding)
369 ret = clk_prepare_enable(rng->clk);
373 mutex_lock(&rng->lock);
375 ret = exynos_rng_set_seed(rng, rng->seed_save, rng->seed_save_len);
377 mutex_unlock(&rng->lock);
379 clk_disable_unprepare(rng->clk);
384 static SIMPLE_DEV_PM_OPS(exynos_rng_pm_ops, exynos_rng_suspend,
387 static const struct of_device_id exynos_rng_dt_match[] = {
389 .compatible = "samsung,exynos4-rng",
390 .data = (const void *)EXYNOS_PRNG_EXYNOS4,
392 .compatible = "samsung,exynos5250-prng",
393 .data = (const void *)EXYNOS_PRNG_EXYNOS5,
397 MODULE_DEVICE_TABLE(of, exynos_rng_dt_match);
399 static struct platform_driver exynos_rng_driver = {
401 .name = "exynos-rng",
402 .pm = &exynos_rng_pm_ops,
403 .of_match_table = exynos_rng_dt_match,
405 .probe = exynos_rng_probe,
406 .remove = exynos_rng_remove,
409 module_platform_driver(exynos_rng_driver);
411 MODULE_DESCRIPTION("Exynos H/W Random Number Generator driver");
412 MODULE_AUTHOR("Krzysztof Kozlowski <krzk@kernel.org>");
413 MODULE_LICENSE("GPL");