Quelle ti-aemif.c
Sprache: C
// SPDX-License-Identifier: GPL-2.0-only
/*
* TI AEMIF driver
*
* Copyright ( C ) 2010 - 2013 Texas Instruments Incorporated . http : //www.ti.com/
*
* Authors :
* Murali Karicheri < m - karicheri2 @ ti . com >
* Ivan Khoronzhuk < ivan . khoronzhuk @ ti . com >
*/
#include <linux/clk.h>
#include <linux/err.h>
#include <linux/io.h>
#include <linux/kernel.h>
#include <linux/memory/ti-aemif.h>
#include <linux/module.h>
#include <linux/mutex.h>
#include <linux/of.h>
#include <linux/of_platform.h>
#include <linux/platform_device.h>
#define TA_SHIFT 2
#define RHOLD_SHIFT 4
#define RSTROBE_SHIFT 7
#define RSETUP_SHIFT 13
#define WHOLD_SHIFT 17
#define WSTROBE_SHIFT 20
#define WSETUP_SHIFT 26
#define EW_SHIFT 30
#define SSTROBE_SHIFT 31
#define TA(x) ((x) << TA_SHIFT)
#define RHOLD(x) ((x) << RHOLD_SHIFT)
#define RSTROBE(x) ((x) << RSTROBE_SHIFT)
#define RSETUP(x) ((x) << RSETUP_SHIFT)
#define WHOLD(x) ((x) << WHOLD_SHIFT)
#define WSTROBE(x) ((x) << WSTROBE_SHIFT)
#define WSETUP(x) ((x) << WSETUP_SHIFT)
#define EW(x) ((x) << EW_SHIFT)
#define SSTROBE(x) ((x) << SSTROBE_SHIFT)
#define ASIZE_MAX 0 x1
#define TA_MAX 0 x3
#define RHOLD_MAX 0 x7
#define RSTROBE_MAX 0 x3f
#define RSETUP_MAX 0 xf
#define WHOLD_MAX 0 x7
#define WSTROBE_MAX 0 x3f
#define WSETUP_MAX 0 xf
#define EW_MAX 0 x1
#define SSTROBE_MAX 0 x1
#define NUM_CS 4
#define TA_VAL(x) (((x) & TA(TA_MAX)) >> TA_SHIFT)
#define RHOLD_VAL(x) (((x) & RHOLD(RHOLD_MAX)) >> RHOLD_SHIFT)
#define RSTROBE_VAL(x) (((x) & RSTROBE(RSTROBE_MAX)) >> RSTROBE_SHIFT)
#define RSETUP_VAL(x) (((x) & RSETUP(RSETUP_MAX)) >> RSETUP_SHIFT)
#define WHOLD_VAL(x) (((x) & WHOLD(WHOLD_MAX)) >> WHOLD_SHIFT)
#define WSTROBE_VAL(x) (((x) & WSTROBE(WSTROBE_MAX)) >> WSTROBE_SHIFT)
#define WSETUP_VAL(x) (((x) & WSETUP(WSETUP_MAX)) >> WSETUP_SHIFT)
#define EW_VAL(x) (((x) & EW(EW_MAX)) >> EW_SHIFT)
#define SSTROBE_VAL(x) (((x) & SSTROBE(SSTROBE_MAX)) >> SSTROBE_SHIFT)
#define NRCSR_OFFSET 0 x00
#define AWCCR_OFFSET 0 x04
#define A1CR_OFFSET 0 x10
#define ACR_ASIZE_MASK 0 x3
#define ACR_EW_MASK BIT(30 )
#define ACR_SSTROBE_MASK BIT(31 )
#define ASIZE_16BIT 1
#define TIMINGS_MASK (TA(TA_MAX) | \
RHOLD(RHOLD_MAX) | \
RSTROBE(RSTROBE_MAX) | \
RSETUP(RSETUP_MAX) | \
WHOLD(WHOLD_MAX) | \
WSTROBE(WSTROBE_MAX) | \
WSETUP(WSETUP_MAX))
#define CONFIG_MASK (EW(EW_MAX) | SSTROBE(SSTROBE_MAX) | ASIZE_MAX)
/**
* struct aemif_cs_data : structure to hold CS parameters
* @ timings : timings configuration
* @ cs : chip - select number
* @ enable_ss : enable / disable select strobe mode
* @ enable_ew : enable / disable extended wait mode
* @ asize : width of the asynchronous device ' s data bus
*/
struct aemif_cs_data {
struct aemif_cs_timings timings;
u8 cs;
u8 enable_ss;
u8 enable_ew;
u8 asize;
};
/**
* struct aemif_device : structure to hold device data
* @ base : base address of AEMIF registers
* @ clk : source clock
* @ clk_rate : clock ' s rate in kHz
* @ num_cs : number of assigned chip - selects
* @ cs_offset : start number of cs nodes
* @ cs_data : array of chip - select settings
* @ config_cs_lock : lock used to access CS configuration
*/
struct aemif_device {
void __iomem *base;
struct clk *clk;
unsigned long clk_rate;
u8 num_cs;
int cs_offset;
struct aemif_cs_data cs_data[NUM_CS];
struct mutex config_cs_lock;
};
/**
* aemif_check_cs_timings ( ) - Check the validity of a CS timing configuration .
* @ timings : timings configuration
*
* @ return : 0 if the timing configuration is valid , negative error number otherwise .
*/
int aemif_check_cs_timings(struct aemif_cs_timings *timings)
{
if (timings->ta > TA_MAX)
return -EINVAL;
if (timings->rhold > RHOLD_MAX)
return -EINVAL;
if (timings->rstrobe > RSTROBE_MAX)
return -EINVAL;
if (timings->rsetup > RSETUP_MAX)
return -EINVAL;
if (timings->whold > WHOLD_MAX)
return -EINVAL;
if (timings->wstrobe > WSTROBE_MAX)
return -EINVAL;
if (timings->wsetup > WSETUP_MAX)
return -EINVAL;
return 0 ;
}
EXPORT_SYMBOL_GPL(aemif_check_cs_timings);
/**
* aemif_set_cs_timings ( ) - Set the timing configuration of a given chip select .
* @ aemif : aemif device to configure
* @ cs : index of the chip select to configure
* @ timings : timings configuration to set
*
* @ return : 0 on success , else negative errno .
*/
int aemif_set_cs_timings(struct aemif_device *aemif, u8 cs,
struct aemif_cs_timings *timings)
{
unsigned int offset;
u32 val, set;
int ret;
if (!timings || !aemif)
return -EINVAL;
if (cs > aemif->num_cs)
return -EINVAL;
ret = aemif_check_cs_timings(timings);
if (ret)
return ret;
set = TA(timings->ta) | RHOLD(timings->rhold) | RSTROBE(timings->rstrobe) |
RSETUP(timings->rsetup) | WHOLD(timings->whold) |
WSTROBE(timings->wstrobe) | WSETUP(timings->wsetup);
offset = A1CR_OFFSET + cs * 4 ;
mutex_lock(&aemif->config_cs_lock);
val = readl(aemif->base + offset);
val &= ~TIMINGS_MASK;
val |= set;
writel(val, aemif->base + offset);
mutex_unlock(&aemif->config_cs_lock);
return 0 ;
}
EXPORT_SYMBOL_GPL(aemif_set_cs_timings);
/**
* aemif_calc_rate - calculate timing data .
* @ pdev : platform device to calculate for
* @ wanted : The cycle time needed in nanoseconds .
* @ clk : The input clock rate in kHz .
*
* @ return : the calculated timing value minus 1 for easy
* programming into AEMIF timing registers .
*/
static u32 aemif_calc_rate(struct platform_device *pdev, int wanted, unsigned long clk)
{
int result;
result = DIV_ROUND_UP((wanted * clk), NSEC_PER_MSEC) - 1 ;
dev_dbg(&pdev->dev, "%s: result %d from %ld, %d\n" , __func__, result,
clk, wanted);
/* It is generally OK to have a more relaxed timing than requested... */
if (result < 0 )
result = 0 ;
return result;
}
/**
* aemif_config_abus - configure async bus parameters
* @ pdev : platform device to configure for
* @ csnum : aemif chip select number
*
* This function programs the given timing values ( in real clock ) into the
* AEMIF registers taking the AEMIF clock into account .
*
* This function does not use any locking while programming the AEMIF
* because it is expected that there is only one user of a given
* chip - select .
*
* Returns 0 on success , else negative errno .
*/
static int aemif_config_abus(struct platform_device *pdev, int csnum)
{
struct aemif_device *aemif = platform_get_drvdata(pdev);
struct aemif_cs_data *data = &aemif->cs_data[csnum];
unsigned offset;
u32 set, val;
offset = A1CR_OFFSET + (data->cs - aemif->cs_offset) * 4 ;
set = (data->asize & ACR_ASIZE_MASK);
if (data->enable_ew)
set |= ACR_EW_MASK;
if (data->enable_ss)
set |= ACR_SSTROBE_MASK;
mutex_lock(&aemif->config_cs_lock);
val = readl(aemif->base + offset);
val &= ~CONFIG_MASK;
val |= set;
writel(val, aemif->base + offset);
mutex_unlock(&aemif->config_cs_lock);
return aemif_set_cs_timings(aemif, data->cs - aemif->cs_offset, &data->timings);
}
/**
* aemif_get_hw_params - function to read hw register values
* @ pdev : platform device to read for
* @ csnum : aemif chip select number
*
* This function reads the defaults from the registers and update
* the timing values . Required for get / set commands and also for
* the case when driver needs to use defaults in hardware .
*/
static void aemif_get_hw_params(struct platform_device *pdev, int csnum)
{
struct aemif_device *aemif = platform_get_drvdata(pdev);
struct aemif_cs_data *data = &aemif->cs_data[csnum];
u32 val, offset;
offset = A1CR_OFFSET + (data->cs - aemif->cs_offset) * 4 ;
val = readl(aemif->base + offset);
data->timings.ta = TA_VAL(val);
data->timings.rhold = RHOLD_VAL(val);
data->timings.rstrobe = RSTROBE_VAL(val);
data->timings.rsetup = RSETUP_VAL(val);
data->timings.whold = WHOLD_VAL(val);
data->timings.wstrobe = WSTROBE_VAL(val);
data->timings.wsetup = WSETUP_VAL(val);
data->enable_ew = EW_VAL(val);
data->enable_ss = SSTROBE_VAL(val);
data->asize = val & ASIZE_MAX;
}
/**
* of_aemif_parse_abus_config - parse CS configuration from DT
* @ pdev : platform device to parse for
* @ np : device node ptr
*
* This function update the emif async bus configuration based on the values
* configured in a cs device binding node .
*/
static int of_aemif_parse_abus_config(struct platform_device *pdev,
struct device_node *np)
{
struct aemif_device *aemif = platform_get_drvdata(pdev);
unsigned long clk_rate = aemif->clk_rate;
struct aemif_cs_data *data;
u32 cs;
u32 val;
if (of_property_read_u32(np, "ti,cs-chipselect" , &cs)) {
dev_dbg(&pdev->dev, "cs property is required" );
return -EINVAL;
}
if (cs - aemif->cs_offset >= NUM_CS || cs < aemif->cs_offset) {
dev_dbg(&pdev->dev, "cs number is incorrect %d" , cs);
return -EINVAL;
}
if (aemif->num_cs >= NUM_CS) {
dev_dbg(&pdev->dev, "cs count is more than %d" , NUM_CS);
return -EINVAL;
}
data = &aemif->cs_data[aemif->num_cs];
data->cs = cs;
/* read the current value in the hw register */
aemif_get_hw_params(pdev, aemif->num_cs++);
/* override the values from device node */
if (!of_property_read_u32(np, "ti,cs-min-turnaround-ns" , &val))
data->timings.ta = aemif_calc_rate(pdev, val, clk_rate);
if (!of_property_read_u32(np, "ti,cs-read-hold-ns" , &val))
data->timings.rhold = aemif_calc_rate(pdev, val, clk_rate);
if (!of_property_read_u32(np, "ti,cs-read-strobe-ns" , &val))
data->timings.rstrobe = aemif_calc_rate(pdev, val, clk_rate);
if (!of_property_read_u32(np, "ti,cs-read-setup-ns" , &val))
data->timings.rsetup = aemif_calc_rate(pdev, val, clk_rate);
if (!of_property_read_u32(np, "ti,cs-write-hold-ns" , &val))
data->timings.whold = aemif_calc_rate(pdev, val, clk_rate);
if (!of_property_read_u32(np, "ti,cs-write-strobe-ns" , &val))
data->timings.wstrobe = aemif_calc_rate(pdev, val, clk_rate);
if (!of_property_read_u32(np, "ti,cs-write-setup-ns" , &val))
data->timings.wsetup = aemif_calc_rate(pdev, val, clk_rate);
if (!of_property_read_u32(np, "ti,cs-bus-width" , &val))
if (val == 16 )
data->asize = 1 ;
data->enable_ew = of_property_read_bool(np, "ti,cs-extended-wait-mode" );
data->enable_ss = of_property_read_bool(np, "ti,cs-select-strobe-mode" );
return aemif_check_cs_timings(&data->timings);
}
static const struct of_device_id aemif_of_match[] = {
{ .compatible = "ti,davinci-aemif" , },
{ .compatible = "ti,da850-aemif" , },
{},
};
MODULE_DEVICE_TABLE(of, aemif_of_match);
static int aemif_probe(struct platform_device *pdev)
{
int i;
int ret = -ENODEV;
struct device *dev = &pdev->dev;
struct device_node *np = dev->of_node;
struct aemif_device *aemif;
aemif = devm_kzalloc(dev, sizeof (*aemif), GFP_KERNEL);
if (!aemif)
return -ENOMEM;
platform_set_drvdata(pdev, aemif);
aemif->clk = devm_clk_get_enabled(dev, NULL);
if (IS_ERR(aemif->clk))
return dev_err_probe(dev, PTR_ERR(aemif->clk),
"cannot get clock 'aemif'\n" );
aemif->clk_rate = clk_get_rate(aemif->clk) / MSEC_PER_SEC;
if (np && of_device_is_compatible(np, "ti,da850-aemif" ))
aemif->cs_offset = 2 ;
aemif->base = devm_platform_ioremap_resource(pdev, 0 );
if (IS_ERR(aemif->base))
return PTR_ERR(aemif->base);
mutex_init(&aemif->config_cs_lock);
if (np) {
/*
* For every controller device node , there is a cs device node
* that describe the bus configuration parameters . This
* functions iterate over these nodes and update the cs data
* array .
*/
for_each_available_child_of_node_scoped(np, child_np) {
ret = of_aemif_parse_abus_config(pdev, child_np);
if (ret < 0 )
return ret;
}
}
for (i = 0 ; i < aemif->num_cs; i++) {
ret = aemif_config_abus(pdev, i);
if (ret < 0 ) {
dev_err(dev, "Error configuring chip select %d\n" ,
aemif->cs_data[i].cs);
return ret;
}
}
/*
* Create a child devices explicitly from here to guarantee that the
* child will be probed after the AEMIF timing parameters are set .
*/
if (np) {
for_each_available_child_of_node_scoped(np, child_np) {
ret = of_platform_populate(child_np, NULL, NULL, dev);
if (ret < 0 )
return ret;
}
}
return 0 ;
}
static struct platform_driver aemif_driver = {
.probe = aemif_probe,
.driver = {
.name = "ti-aemif" ,
.of_match_table = of_match_ptr(aemif_of_match),
},
};
module_platform_driver(aemif_driver);
MODULE_AUTHOR("Murali Karicheri <m-karicheri2@ti.com>" );
MODULE_AUTHOR("Ivan Khoronzhuk <ivan.khoronzhuk@ti.com>" );
MODULE_DESCRIPTION("Texas Instruments AEMIF driver" );
MODULE_LICENSE("GPL v2" );
MODULE_ALIAS("platform:" KBUILD_MODNAME);
Messung V0.5 in Prozent C=97 H=99 G=97
¤ Dauer der Verarbeitung: 0.18 Sekunden
(vorverarbeitet am 2026-09-29)
¤
*© Formatika GbR, Deutschland
2026-10-10
Neuigkeiten
Aktuelles
Motto des Tages
Open Source Software
Jenseits des Üblichen ....
Besucherstatistik
Statistik
#Sources=1126864
#Domains=1897691