/*
* linux/arch/arm/mach-davinci/clock.c
*
* TI DaVinci clock config file
*
* Copyright (C) 2006 Texas Instruments.
*
* ----------------------------------------------------------------------------
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
* ----------------------------------------------------------------------------
*
*/
/* 该文件中到程序实现了各模块PSC的管理，时钟的初始化、注册、获取以及使能等 */
/**************************************************************************
* Included Files
**************************************************************************/
#include <linux/config.h>
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/init.h>
#include <linux/fs.h>
#include <linux/major.h>
#include <linux/root_dev.h>
#include <asm/setup.h>
#include <asm/semaphore.h>
#include <asm/hardware/clock.h>
#include <asm/io.h>
#include <asm/mach-types.h>
#include <asm/mach/arch.h>
#include <asm/mach/map.h>
#include <asm/arch/hardware.h>
#include <asm/arch/cpu.h>
#include <asm/arch/mux.h>
#include "clock.h"
#define PLL1_PLLM __REG(0x01c40910)
#define PLL2_PLLM __REG(0x01c40D10)
#define PTCMD __REG(0x01C41120)
#define PDSTAT __REG(0x01C41200)
#define PDCTL1 __REG(0x01C41304)
#define EPCPR __REG(0x01C41070)
#define PTSTAT __REG(0x01C41128)
#define MDSTAT IO_ADDRESS(0x01C41800)
#define MDCTL IO_ADDRESS(0x01C41A00)
#define VDD3P3V_PWDN __REG(0x01C40048)
static LIST_HEAD(clocks); // 链表头，用于管理所有到时钟结构体
static DECLARE_MUTEX(clocks_sem); // 添加和删除时钟用到信号量，用来互斥
static DEFINE_RAW_SPINLOCK(clockfw_lock);
static unsigned int commonrate;
static unsigned int div_by_four;
static unsigned int div_by_six;
static unsigned int div_by_eight;
static unsigned int armrate;
static unsigned int fixedrate;
/*
* 正如下面英文解释所说的，board_setup_psc函数用于使能和禁止某个PSC域，
* 共有两个域DSP和ARM,在include/asm-arm/arch-davinci/hardware.h
* 中定义。如果要使用某个模块到功能，比如SPI，则必须先使用该函数，打开该
* 模块的电源和时钟，然后才可以设置其寄存器和操作。
*/
/**************************************
Routine: board_setup_psc
Description: Enable/Disable a PSC domain
**************************************/
void board_setup_psc(unsigned int domain, unsigned int id, char enable)
{
volatile unsigned int *mdstat = (unsigned int *)((int)MDSTAT + 4 * id);
volatile unsigned int *mdctl = (unsigned int *)((int)MDCTL + 4 * id);
if (enable) {
*mdctl |= 0x00000003; /* Enable Module */
} else {
*mdctl &= 0xFFFFFFF2; /* Disable Module */
}
if ((PDSTAT & 0x00000001) == 0) {
PDCTL1 |= 0x1;
PTCMD = (1 << domain);
while ((((EPCPR >> domain) & 1) == 0)) ;
PDCTL1 |= 0x100;
while (!(((PTSTAT >> domain) & 1) == 0)) ;
} else {
PTCMD = (1 << domain);
while (!(((PTSTAT >> domain) & 1) == 0)) ;
}
if (enable) {
while (!((*mdstat & 0x0000001F) == 0x3)) ;
} else {
while (!((*mdstat & 0x0000001F) == 0x2)) ;
}
}
/*
* 获取时钟结构体指针
* 从链表中获取时钟结构体指针，比较时钟名（字符串），如果相同就返回该结构体指针
*/
struct clk *clk_get(struct device *dev, const char *id)
{
struct clk *p, *clk = ERR_PTR(-ENOENT);
down(&clocks_sem);
list_for_each_entry(p, &clocks, node) {
if (strcmp(id, p->name) == 0 && try_module_get(p->owner)) {
clk = p;
break;
}
}
up(&clocks_sem);
return clk;
}
/* 导出该符号，以便其它驱动程序调用 */
EXPORT_SYMBOL(clk_get);
/* 将时钟结构体放回到链表中，以便其它驱动能够获得 */
void clk_put(struct clk *clk)
{
if (clk && !IS_ERR(clk))
module_put(clk->owner); // 减少模块使用计数,模块使用计数的介绍可参考本站转载的文章《Linux kernel-2.6 模块使用计数》
}
EXPORT_SYMBOL(clk_put);
/* 打开模块的电源和时钟 */
int __clk_enable(struct clk *clk)
{
if (clk->flags & ALWAYS_ENABLED) // 检查是否已经打开
return 0;
board_setup_psc(DAVINCI_GPSC_ARMDOMAIN, clk->lpsc, 1); // 1代表使能
return 0;
}
/* 关闭模块的电源和时钟 */
void __clk_disable(struct clk *clk)
{
if (clk->usecount) // 检查模块是否正在被使用
return;
board_setup_psc(DAVINCI_GPSC_ARMDOMAIN, clk->lpsc, 0); // 0代表关闭
}
/* 减少时钟引用计数 */
void __clk_unuse(struct clk *clk)
{
if (clk->usecount > 0) {
--clk->usecount;
}
}
/* 增加时钟引用计数 */
int __clk_use(struct clk *clk)
{
int ret = 0;
clk->usecount++;
return ret;
}
/* __clk_enable函数的封装，其它驱动可调用。 */
int clk_enable(struct clk *clk)
{
unsigned long flags;
int ret;
spin_lock_irqsave(&clockfw_lock, flags); // 关中断和多CPU占用
ret = __clk_enable(clk);
spin_unlock_irqrestore(&clockfw_lock, flags);
if (davinci_pinmux_setup)
davinci_pinmux_setup(clk->lpsc); /* 打开其引脚到模块功能，dm644x各模块到功能引脚大多和GPIO功能复用，
故使用前要初始化，默认是模块功能一脚而非GPIO */
else
printk (KERN_WARNING "WARNING davinci_pinmux_setup "
"uninitialized\n");
return ret;
}
EXPORT_SYMBOL(clk_enable);
/* __clk_disable函数的封装 */
void clk_disable(struct clk *clk)
{
unsigned long flags;
spin_lock_irqsave(&clockfw_lock, flags);
__clk_disable(clk);
spin_unlock_irqrestore(&clockfw_lock, flags);
}
EXPORT_SYMBOL(clk_disable);
/* __clk_use函数的封装 */
int clk_use(struct clk *clk)
{
unsigned long flags;
int ret = 0;
spin_lock_irqsave(&clockfw_lock, flags);
ret = __clk_use(clk);
spin_unlock_irqrestore(&clockfw_lock, flags);
return ret;
}
EXPORT_SYMBOL(clk_use);
/* __clk_unuse函数的封装 */
void clk_unuse(struct clk *clk)
{
unsigned long flags;
spin_lock_irqsave(&clockfw_lock, flags);
__clk_unuse(clk);
spin_unlock_irqrestore(&clockfw_lock, flags);
}
EXPORT_SYMBOL(clk_unuse);
/* 获取模块时钟的频率 */
unsigned long clk_get_rate(struct clk *clk)
{
return *(clk->rate);
}
EXPORT_SYMBOL(clk_get_rate);
/* 添加时钟到链表中 */
int clk_register(struct clk *clk)
{
down(&clocks_sem);
list_add(&clk->node, &clocks);
up(&clocks_sem);
return 0;
}
EXPORT_SYMBOL(clk_register);
/* 将时钟从链表中清除 */
void clk_unregister(struct clk *clk)
{
down(&clocks_sem);
list_del(&clk->node);
up(&clocks_sem);
}
EXPORT_SYMBOL(clk_unregister);
/* dm644x平台所有模块的时钟*/
static struct clk davinci_dm644x_clks[] = {
{
.name = "ARMCLK", // 时钟名，ARM域的时钟
.rate = &armrate,
.lpsc = -1,
.flags = ALWAYS_ENABLED,
},
{
.name = "UART0",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_UART0,
.usecount = 1,
},
{
.name = "EMACCLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_EMAC_WRAPPER,
},
{
.name = "I2CCLK",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_I2C,
},
{
.name = "IDECLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_ATA,
},
{
.name = "McBSPCLK0",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_McBSP0,
},
{
.name = "MMCSDCLK0",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_MMC_SD0,
},
{
.name = "SPICLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_SPI,
},
{
.name = "gpio",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_GPIO,
},
{
.name = "AEMIFCLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_AEMIF,
.usecount = 1,
},
{
.name = "PWM0_CLK",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_PWM0,
},
{
.name = "PWM1_CLK",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_PWM1,
},
{
.name = "PWM2_CLK",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_PWM2,
},
{
.name = "USBCLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_USB,
},
};
/* dm6467平台所有模块的时钟*/
static struct clk davinci_dm6467_clks[] = {
{
.name = "ARMCLK",
.rate = &armrate,
.lpsc = -1,
.flags = ALWAYS_ENABLED,
},
{
.name = "UART0",
.rate = &fixedrate,
.lpsc = DAVINCI_DM646X_LPSC_UART0,
.usecount = 1,
},
{
.name = "UART1",
.rate = &fixedrate,
.lpsc = DAVINCI_DM646X_LPSC_UART1,
.usecount = 1,
},
{
.name = "UART2",
.rate = &fixedrate,
.lpsc = DAVINCI_DM646X_LPSC_UART2,
.usecount = 1,
},
{
.name = "EMACCLK",
.rate = &div_by_four,
.lpsc = DAVINCI_DM646X_LPSC_EMAC,
},
{
.name = "I2CCLK",
.rate = &div_by_four,
.lpsc = DAVINCI_DM646X_LPSC_I2C,
},
{
.name = "IDECLK",
.rate = &div_by_six,
.lpsc = DAVINCI_LPSC_ATA,
},
{
.name = "McASPCLK0",
.rate = &div_by_four,
.lpsc = DAVINCI_DM646X_LPSC_McASP0,
},
{
.name = "McASPCLK1",
.rate = &div_by_four,
.lpsc = DAVINCI_DM646X_LPSC_McASP1,
},
{
.name = "SPICLK",
.rate = &div_by_four,
.lpsc = DAVINCI_DM646X_LPSC_SPI,
},
{
.name = "AEMIFCLK",
.rate = &div_by_four,
.lpsc = DAVINCI_DM646X_LPSC_AEMIF,
.usecount = 1,
},
{
.name = "PWM0_CLK",
.rate = &div_by_four,
.lpsc = DAVINCI_DM646X_LPSC_PWM0,
},
{
.name = "PWM1_CLK",
.rate = &div_by_four,
.lpsc = DAVINCI_DM646X_LPSC_PWM1,
},
{
.name = "USBCLK",
.rate = &div_by_four,
.lpsc = DAVINCI_LPSC_USB,
},
};
/* dm355平台所有模块的时钟*/
static struct clk davinci_dm355_clks[] = {
{
.name = "ARMCLK",
.rate = &armrate,
.lpsc = -1,
.flags = ALWAYS_ENABLED,
},
{
.name = "UART0",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_UART0,
.usecount = 1,
},
{
.name = "UART1",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_UART1,
.usecount = 1,
},
{
.name = "UART2",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_UART2,
.usecount = 1,
},
{
.name = "EMACCLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_EMAC_WRAPPER,
},
{
.name = "I2CCLK",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_I2C,
},
{
.name = "IDECLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_ATA,
},
{
.name = "McBSPCLK0",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_McBSP0,
},
{
.name = "McBSPCLK1",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_McBSP1,
},
{
.name = "MMCSDCLK0",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_MMC_SD0,
},
{
.name = "MMCSDCLK1",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_MMC_SD1,
},
{
.name = "SPICLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_SPI,
},
{
.name = "gpio",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_GPIO,
},
{
.name = "AEMIFCLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_AEMIF,
.usecount = 1,
},
{
.name = "PWM0_CLK",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_PWM0,
},
{
.name = "PWM1_CLK",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_PWM1,
},
{
.name = "PWM2_CLK",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_PWM2,
},
{
.name = "PWM3_CLK",
.rate = &fixedrate,
.lpsc = DAVINCI_LPSC_PWM3,
},
{
.name = "USBCLK",
.rate = &commonrate,
.lpsc = DAVINCI_LPSC_USB,
},
};
/*
clk初始化，采用一个链表把所有到时钟结构体链接在一起，该链表的头是clocks。
davinci_clk_init()例程由io.c中的davinci_map_common_io()例程调用，后者被
davinci_map_io()例程调用，而其又被注册到board_evm.c中的机器描述符中（struct machine_desc），
故具体调用过程是：
start_kernel()-->setup_arch()-->paging_init()-->mdesc->map_io()
(其就是davinci_map_io())-->davinci_map_common_io()-->davinci_clk_init()。
*/
void davinci_clk_init(void)
{
struct clk *clkp;
static struct clk *board_clks;
int count = 0, num_clks;
if (cpu_is_davinci_dm355()) { // dm355平台时钟初始化
/*
* FIXME
* We're assuming a 24MHz reference, but the DM355 also
* supports a 36MHz reference.
*/
unsigned long postdiv;
/*
* Read the PLL1 POSTDIV register to determine if the post
* divider is /1 or /2
*/
postdiv = (davinci_readl(DAVINCI_PLL_CNTRL0_BASE + 0x128)
& 0x1f) + 1;
fixedrate = 24000000;
armrate = (PLL1_PLLM + 1) * (fixedrate / (16 * postdiv));
commonrate = armrate / 2;
board_clks = davinci_dm355_clks;
num_clks = ARRAY_SIZE(davinci_dm355_clks);
} else if (cpu_is_davinci_dm6467()) { // dm6467平台时钟初始化
fixedrate = 24000000;
div_by_four = ((PLL1_PLLM + 1) * 27000000) / 4;
div_by_six = ((PLL1_PLLM + 1) * 27000000) / 6;
div_by_eight = ((PLL1_PLLM + 1) * 27000000) / 8;
armrate = ((PLL1_PLLM + 1) * 27000000) / 2;
board_clks = davinci_dm6467_clks;
num_clks = ARRAY_SIZE(davinci_dm6467_clks);
} else { // dm644X平台时钟初始化
fixedrate = 27000000; // 平台输入频率，即晶振频率
armrate = (PLL1_PLLM + 1) * (fixedrate / 2); // arm时钟，其为DSP时钟的一半
commonrate = armrate / 3; // 其他时钟为DSP时钟的1/6，arm时钟的1/3
board_clks = davinci_dm644x_clks;
num_clks = ARRAY_SIZE(davinci_dm644x_clks);
}
for (clkp = board_clks; count < num_clks; count++, clkp++) {
clk_register(clkp); // 将时钟注册到链表中
/* Turn on clocks that have been enabled in the
* table above */
if (clkp->usecount) { // 如果该时钟已经被使用，则开启它
clk_enable(clkp); // 使能该时钟
}
}
}
|
