// SPDX-License-Identifier: GPL-2.0-or-later
/*
* Copyright ( c ) 2015 , Daniel Thompson
*/
#include <linux/clk.h>
#include <linux/clk-provider.h>
#include <linux/delay.h>
#include <linux/hw_random.h>
#include <linux/io.h>
#include <linux/iopoll.h>
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/of_address.h>
#include <linux/platform_device.h>
#include <linux/pm_runtime.h>
#include <linux/reset.h>
#include <linux/slab.h>
#define RNG_CR 0 x00
#define RNG_CR_RNGEN BIT(2 )
#define RNG_CR_CED BIT(5 )
#define RNG_CR_CONFIG1 GENMASK(11 , 8 )
#define RNG_CR_NISTC BIT(12 )
#define RNG_CR_CONFIG2 GENMASK(15 , 13 )
#define RNG_CR_CLKDIV_SHIFT 16
#define RNG_CR_CLKDIV GENMASK(19 , 16 )
#define RNG_CR_CONFIG3 GENMASK(25 , 20 )
#define RNG_CR_CONDRST BIT(30 )
#define RNG_CR_CONFLOCK BIT(31 )
#define RNG_CR_ENTROPY_SRC_MASK (RNG_CR_CONFIG1 | RNG_CR_NISTC | RNG_CR_CONFIG2 | RNG_CR_CONFIG3)
#define RNG_CR_CONFIG_MASK (RNG_CR_ENTROPY_SRC_MASK | RNG_CR_CED | RNG_CR_CLKDIV)
#define RNG_SR 0 x04
#define RNG_SR_DRDY BIT(0 )
#define RNG_SR_CECS BIT(1 )
#define RNG_SR_SECS BIT(2 )
#define RNG_SR_CEIS BIT(5 )
#define RNG_SR_SEIS BIT(6 )
#define RNG_DR 0 x08
#define RNG_NSCR 0 x0C
#define RNG_NSCR_MASK GENMASK(17 , 0 )
#define RNG_HTCR 0 x10
#define RNG_NB_RECOVER_TRIES 3
struct stm32_rng_data {
uint max_clock_rate;
uint nb_clock;
u32 cr;
u32 nscr;
u32 htcr;
bool has_cond_reset;
};
/**
* struct stm32_rng_config - RNG configuration data
*
* @ cr : RNG configuration . 0 means default hardware RNG configuration
* @ nscr : Noise sources control configuration .
* @ htcr : Health tests configuration .
*/
struct stm32_rng_config {
u32 cr;
u32 nscr;
u32 htcr;
};
struct stm32_rng_private {
struct hwrng rng;
struct device *dev;
void __iomem *base;
struct clk_bulk_data *clk_bulk;
struct reset_control *rst;
struct stm32_rng_config pm_conf;
const struct stm32_rng_data *data;
bool ced;
bool lock_conf;
};
/*
* Extracts from the STM32 RNG specification when RNG supports CONDRST .
*
* When a noise source ( or seed ) error occurs , the RNG stops generating
* random numbers and sets to “ 1 ” both SEIS and SECS bits to indicate
* that a seed error occurred . ( . . . )
*
* 1 . Software reset by writing CONDRST at 1 and at 0 ( see bitfield
* description for details ) . This step is needed only if SECS is set .
* Indeed , when SEIS is set and SECS is cleared it means RNG performed
* the reset automatically ( auto - reset ) .
* 2 . If SECS was set in step 1 ( no auto - reset ) wait for CONDRST
* to be cleared in the RNG_CR register , then confirm that SEIS is
* cleared in the RNG_SR register . Otherwise just clear SEIS bit in
* the RNG_SR register .
* 3 . If SECS was set in step 1 ( no auto - reset ) wait for SECS to be
* cleared by RNG . The random number generation is now back to normal .
*/
static int stm32_rng_conceal_seed_error_cond_reset(struct stm32_rng_private *priv)
{
struct device *dev = priv->dev;
u32 sr = readl_relaxed(priv->base + RNG_SR);
u32 cr = readl_relaxed(priv->base + RNG_CR);
int err;
if (sr & RNG_SR_SECS) {
/* Conceal by resetting the subsystem (step 1.) */
writel_relaxed(cr | RNG_CR_CONDRST, priv->base + RNG_CR);
writel_relaxed(cr & ~RNG_CR_CONDRST, priv->base + RNG_CR);
} else {
/* RNG auto-reset (step 2.) */
writel_relaxed(sr & ~RNG_SR_SEIS, priv->base + RNG_SR);
goto end;
}
err = readl_relaxed_poll_timeout_atomic(priv->base + RNG_CR, cr, !(cr & RNG_CR_CONDRST), 10 ,
100000 );
if (err) {
dev_err(dev, "%s: timeout %x\n" , __func__, sr);
return err;
}
/* Check SEIS is cleared (step 2.) */
if (readl_relaxed(priv->base + RNG_SR) & RNG_SR_SEIS)
return -EINVAL;
err = readl_relaxed_poll_timeout_atomic(priv->base + RNG_SR, sr, !(sr & RNG_SR_SECS), 10 ,
100000 );
if (err) {
dev_err(dev, "%s: timeout %x\n" , __func__, sr);
return err;
}
end:
return 0 ;
}
/*
* Extracts from the STM32 RNG specification , when CONDRST is not supported
*
* When a noise source ( or seed ) error occurs , the RNG stops generating
* random numbers and sets to “ 1 ” both SEIS and SECS bits to indicate
* that a seed error occurred . ( . . . )
*
* The following sequence shall be used to fully recover from a seed
* error after the RNG initialization :
* 1 . Clear the SEIS bit by writing it to “ 0 ” .
* 2 . Read out 12 words from the RNG_DR register , and discard each of
* them in order to clean the pipeline .
* 3 . Confirm that SEIS is still cleared . Random number generation is
* back to normal .
*/
static int stm32_rng_conceal_seed_error_sw_reset(struct stm32_rng_private *priv)
{
unsigned int i = 0 ;
u32 sr = readl_relaxed(priv->base + RNG_SR);
writel_relaxed(sr & ~RNG_SR_SEIS, priv->base + RNG_SR);
for (i = 12 ; i != 0 ; i--)
(void )readl_relaxed(priv->base + RNG_DR);
if (readl_relaxed(priv->base + RNG_SR) & RNG_SR_SEIS)
return -EINVAL;
return 0 ;
}
static int stm32_rng_conceal_seed_error(struct hwrng *rng)
{
struct stm32_rng_private *priv = container_of(rng, struct stm32_rng_private, rng);
dev_dbg(priv->dev, "Concealing seed error\n" );
if (priv->data->has_cond_reset)
return stm32_rng_conceal_seed_error_cond_reset(priv);
else
return stm32_rng_conceal_seed_error_sw_reset(priv);
};
static int stm32_rng_read(struct hwrng *rng, void *data, size_t max, bool wait)
{
struct stm32_rng_private *priv = container_of(rng, struct stm32_rng_private, rng);
unsigned int i = 0 ;
int retval = 0 , err = 0 ;
u32 sr;
retval = pm_runtime_resume_and_get(priv->dev);
if (retval)
return retval;
if (readl_relaxed(priv->base + RNG_SR) & RNG_SR_SEIS)
stm32_rng_conceal_seed_error(rng);
while (max >= sizeof (u32)) {
sr = readl_relaxed(priv->base + RNG_SR);
/*
* Manage timeout which is based on timer and take
* care of initial delay time when enabling the RNG .
*/
if (!sr && wait) {
err = readl_relaxed_poll_timeout_atomic(priv->base
+ RNG_SR,
sr, sr,
10 , 50000 );
if (err) {
dev_err(priv->dev, "%s: timeout %x!\n" , __func__, sr);
break ;
}
} else if (!sr) {
/* The FIFO is being filled up */
break ;
}
if (sr != RNG_SR_DRDY) {
if (sr & RNG_SR_SEIS) {
err = stm32_rng_conceal_seed_error(rng);
i++;
if (err && i > RNG_NB_RECOVER_TRIES) {
dev_err(priv->dev, "Couldn't recover from seed error\n" );
retval = -ENOTRECOVERABLE;
goto exit_rpm;
}
continue ;
}
if (WARN_ONCE((sr & RNG_SR_CEIS), "RNG clock too slow - %x\n" , sr))
writel_relaxed(0 , priv->base + RNG_SR);
}
/* Late seed error case: DR being 0 is an error status */
*(u32 *)data = readl_relaxed(priv->base + RNG_DR);
if (!*(u32 *)data) {
err = stm32_rng_conceal_seed_error(rng);
i++;
if (err && i > RNG_NB_RECOVER_TRIES) {
dev_err(priv->dev, "Couldn't recover from seed error" );
retval = -ENOTRECOVERABLE;
goto exit_rpm;
}
continue ;
}
i = 0 ;
retval += sizeof (u32);
data += sizeof (u32);
max -= sizeof (u32);
}
exit_rpm:
pm_runtime_put_sync_autosuspend(priv->dev);
return retval || !wait ? retval : -EIO;
}
static uint stm32_rng_clock_freq_restrain(struct hwrng *rng)
{
struct stm32_rng_private *priv =
container_of(rng, struct stm32_rng_private, rng);
unsigned long clock_rate = 0 ;
uint clock_div = 0 ;
clock_rate = clk_get_rate(priv->clk_bulk[0 ].clk);
/*
* Get the exponent to apply on the CLKDIV field in RNG_CR register
* No need to handle the case when clock - div > 0 xF as it is physically
* impossible
*/
while ((clock_rate >> clock_div) > priv->data->max_clock_rate)
clock_div++;
pr_debug("RNG clk rate : %lu\n" , clk_get_rate(priv->clk_bulk[0 ].clk) >> clock_div);
return clock_div;
}
static int stm32_rng_init(struct hwrng *rng)
{
struct stm32_rng_private *priv =
container_of(rng, struct stm32_rng_private, rng);
int err;
u32 reg;
err = clk_bulk_prepare_enable(priv->data->nb_clock, priv->clk_bulk);
if (err)
return err;
/* clear error indicators */
writel_relaxed(0 , priv->base + RNG_SR);
reg = readl_relaxed(priv->base + RNG_CR);
/*
* Keep default RNG configuration if none was specified .
* 0 is an invalid value as it disables all entropy sources .
*/
if (priv->data->has_cond_reset && priv->data->cr) {
uint clock_div = stm32_rng_clock_freq_restrain(rng);
reg &= ~RNG_CR_CONFIG_MASK;
reg |= RNG_CR_CONDRST | (priv->data->cr & RNG_CR_ENTROPY_SRC_MASK) |
(clock_div << RNG_CR_CLKDIV_SHIFT);
if (priv->ced)
reg &= ~RNG_CR_CED;
else
reg |= RNG_CR_CED;
writel_relaxed(reg, priv->base + RNG_CR);
/* Health tests and noise control registers */
writel_relaxed(priv->data->htcr, priv->base + RNG_HTCR);
writel_relaxed(priv->data->nscr & RNG_NSCR_MASK, priv->base + RNG_NSCR);
reg &= ~RNG_CR_CONDRST;
reg |= RNG_CR_RNGEN;
if (priv->lock_conf)
reg |= RNG_CR_CONFLOCK;
writel_relaxed(reg, priv->base + RNG_CR);
err = readl_relaxed_poll_timeout_atomic(priv->base + RNG_CR, reg,
(!(reg & RNG_CR_CONDRST)),
10 , 50000 );
if (err) {
clk_bulk_disable_unprepare(priv->data->nb_clock, priv->clk_bulk);
dev_err(priv->dev, "%s: timeout %x!\n" , __func__, reg);
return -EINVAL;
}
} else {
/* Handle all RNG versions by checking if conditional reset should be set */
if (priv->data->has_cond_reset)
reg |= RNG_CR_CONDRST;
if (priv->ced)
reg &= ~RNG_CR_CED;
else
reg |= RNG_CR_CED;
writel_relaxed(reg, priv->base + RNG_CR);
if (priv->data->has_cond_reset)
reg &= ~RNG_CR_CONDRST;
reg |= RNG_CR_RNGEN;
writel_relaxed(reg, priv->base + RNG_CR);
}
err = readl_relaxed_poll_timeout_atomic(priv->base + RNG_SR, reg,
reg & RNG_SR_DRDY,
10 , 100000 );
if (err || (reg & ~RNG_SR_DRDY)) {
clk_bulk_disable_unprepare(priv->data->nb_clock, priv->clk_bulk);
dev_err(priv->dev, "%s: timeout:%x SR: %x!\n" , __func__, err, reg);
return -EINVAL;
}
clk_bulk_disable_unprepare(priv->data->nb_clock, priv->clk_bulk);
return 0 ;
}
static void stm32_rng_remove(struct platform_device *ofdev)
{
pm_runtime_disable(&ofdev->dev);
}
static int __maybe_unused stm32_rng_runtime_suspend(struct device *dev)
{
struct stm32_rng_private *priv = dev_get_drvdata(dev);
u32 reg;
reg = readl_relaxed(priv->base + RNG_CR);
reg &= ~RNG_CR_RNGEN;
writel_relaxed(reg, priv->base + RNG_CR);
clk_bulk_disable_unprepare(priv->data->nb_clock, priv->clk_bulk);
return 0 ;
}
static int __maybe_unused stm32_rng_suspend(struct device *dev)
{
struct stm32_rng_private *priv = dev_get_drvdata(dev);
int err;
err = clk_bulk_prepare_enable(priv->data->nb_clock, priv->clk_bulk);
if (err)
return err;
if (priv->data->has_cond_reset) {
priv->pm_conf.nscr = readl_relaxed(priv->base + RNG_NSCR);
priv->pm_conf.htcr = readl_relaxed(priv->base + RNG_HTCR);
}
/* Do not save that RNG is enabled as it will be handled at resume */
priv->pm_conf.cr = readl_relaxed(priv->base + RNG_CR) & ~RNG_CR_RNGEN;
writel_relaxed(priv->pm_conf.cr, priv->base + RNG_CR);
clk_bulk_disable_unprepare(priv->data->nb_clock, priv->clk_bulk);
return 0 ;
}
static int __maybe_unused stm32_rng_runtime_resume(struct device *dev)
{
struct stm32_rng_private *priv = dev_get_drvdata(dev);
int err;
u32 reg;
err = clk_bulk_prepare_enable(priv->data->nb_clock, priv->clk_bulk);
if (err)
return err;
/* Clean error indications */
writel_relaxed(0 , priv->base + RNG_SR);
reg = readl_relaxed(priv->base + RNG_CR);
reg |= RNG_CR_RNGEN;
writel_relaxed(reg, priv->base + RNG_CR);
return 0 ;
}
static int __maybe_unused stm32_rng_resume(struct device *dev)
{
struct stm32_rng_private *priv = dev_get_drvdata(dev);
int err;
u32 reg;
err = clk_bulk_prepare_enable(priv->data->nb_clock, priv->clk_bulk);
if (err)
return err;
/* Clean error indications */
writel_relaxed(0 , priv->base + RNG_SR);
if (priv->data->has_cond_reset) {
/*
* Correct configuration in bits [ 29 : 4 ] must be set in the same
* access that set RNG_CR_CONDRST bit . Else config setting is
* not taken into account . CONFIGLOCK bit must also be unset but
* it is not handled at the moment .
*/
writel_relaxed(priv->pm_conf.cr | RNG_CR_CONDRST, priv->base + RNG_CR);
writel_relaxed(priv->pm_conf.nscr, priv->base + RNG_NSCR);
writel_relaxed(priv->pm_conf.htcr, priv->base + RNG_HTCR);
reg = readl_relaxed(priv->base + RNG_CR);
reg |= RNG_CR_RNGEN;
reg &= ~RNG_CR_CONDRST;
writel_relaxed(reg, priv->base + RNG_CR);
err = readl_relaxed_poll_timeout_atomic(priv->base + RNG_CR, reg,
reg & ~RNG_CR_CONDRST, 10 , 100000 );
if (err) {
clk_bulk_disable_unprepare(priv->data->nb_clock, priv->clk_bulk);
dev_err(priv->dev, "%s: timeout:%x CR: %x!\n" , __func__, err, reg);
return -EINVAL;
}
} else {
reg = priv->pm_conf.cr;
reg |= RNG_CR_RNGEN;
writel_relaxed(reg, priv->base + RNG_CR);
}
clk_bulk_disable_unprepare(priv->data->nb_clock, priv->clk_bulk);
return 0 ;
}
static const struct dev_pm_ops __maybe_unused stm32_rng_pm_ops = {
SET_RUNTIME_PM_OPS(stm32_rng_runtime_suspend,
stm32_rng_runtime_resume, NULL)
SET_SYSTEM_SLEEP_PM_OPS(stm32_rng_suspend,
stm32_rng_resume)
};
static const struct stm32_rng_data stm32mp25_rng_data = {
.has_cond_reset = true ,
.max_clock_rate = 48000000 ,
.nb_clock = 2 ,
.cr = 0 x00F00D00,
.nscr = 0 x2B5BB,
.htcr = 0 x969D,
};
static const struct stm32_rng_data stm32mp13_rng_data = {
.has_cond_reset = true ,
.max_clock_rate = 48000000 ,
.nb_clock = 1 ,
.cr = 0 x00F00D00,
.nscr = 0 x2B5BB,
.htcr = 0 x969D,
};
static const struct stm32_rng_data stm32_rng_data = {
.has_cond_reset = false ,
.max_clock_rate = 48000000 ,
.nb_clock = 1 ,
};
static const struct of_device_id stm32_rng_match[] = {
{
.compatible = "st,stm32mp25-rng" ,
.data = &stm32mp25_rng_data,
},
{
.compatible = "st,stm32mp13-rng" ,
.data = &stm32mp13_rng_data,
},
{
.compatible = "st,stm32-rng" ,
.data = &stm32_rng_data,
},
{},
};
MODULE_DEVICE_TABLE(of, stm32_rng_match);
static int stm32_rng_probe(struct platform_device *ofdev)
{
struct device *dev = &ofdev->dev;
struct device_node *np = ofdev->dev.of_node;
struct stm32_rng_private *priv;
struct resource *res;
int ret;
priv = devm_kzalloc(dev, sizeof (*priv), GFP_KERNEL);
if (!priv)
return -ENOMEM;
priv->base = devm_platform_get_and_ioremap_resource(ofdev, 0 , &res);
if (IS_ERR(priv->base))
return PTR_ERR(priv->base);
priv->rst = devm_reset_control_get(&ofdev->dev, NULL);
if (!IS_ERR(priv->rst)) {
reset_control_assert(priv->rst);
udelay(2 );
reset_control_deassert(priv->rst);
}
priv->ced = of_property_read_bool(np, "clock-error-detect" );
priv->lock_conf = of_property_read_bool(np, "st,rng-lock-conf" );
priv->dev = dev;
priv->data = of_device_get_match_data(dev);
if (!priv->data)
return -ENODEV;
dev_set_drvdata(dev, priv);
priv->rng.name = dev_driver_string(dev);
priv->rng.init = stm32_rng_init;
priv->rng.read = stm32_rng_read;
priv->rng.quality = 900 ;
if (!priv->data->nb_clock || priv->data->nb_clock > 2 )
return -EINVAL;
ret = devm_clk_bulk_get_all(dev, &priv->clk_bulk);
if (ret != priv->data->nb_clock)
return dev_err_probe(dev, -EINVAL, "Failed to get clocks: %d\n" , ret);
if (priv->data->nb_clock == 2 ) {
const char *id = priv->clk_bulk[1 ].id;
struct clk *clk = priv->clk_bulk[1 ].clk;
if (!priv->clk_bulk[0 ].id || !priv->clk_bulk[1 ].id)
return dev_err_probe(dev, -EINVAL, "Missing clock name\n" );
if (strcmp(priv->clk_bulk[0 ].id, "core" )) {
priv->clk_bulk[1 ].id = priv->clk_bulk[0 ].id;
priv->clk_bulk[1 ].clk = priv->clk_bulk[0 ].clk;
priv->clk_bulk[0 ].id = id;
priv->clk_bulk[0 ].clk = clk;
}
}
pm_runtime_set_autosuspend_delay(dev, 100 );
pm_runtime_use_autosuspend(dev);
pm_runtime_enable(dev);
return devm_hwrng_register(dev, &priv->rng);
}
static struct platform_driver stm32_rng_driver = {
.driver = {
.name = "stm32-rng" ,
.pm = pm_ptr(&stm32_rng_pm_ops),
.of_match_table = stm32_rng_match,
},
.probe = stm32_rng_probe,
.remove = stm32_rng_remove,
};
module_platform_driver(stm32_rng_driver);
MODULE_LICENSE("GPL" );
MODULE_AUTHOR("Daniel Thompson <daniel.thompson@linaro.org>" );
MODULE_DESCRIPTION("STMicroelectronics STM32 RNG device driver" );
Messung V0.5 in Prozent C=97 H=94 G=95
¤ Dauer der Verarbeitung: 0.13 Sekunden
(vorverarbeitet am 2026-09-28)
¤
*© Formatika GbR, Deutschland