clock.h

Go to the documentation of this file.

/* SPDX-License-Identifier: GPL-2.0-only */
 
#ifndef __SOC_NVIDIA_TEGRA124_CLOCK_H__
#define __SOC_NVIDIA_TEGRA124_CLOCK_H__
 
#include <arch/hlt.h>
#include <console/console.h>
#include <device/mmio.h>
#include <soc/clk_rst.h>
#include <stdint.h>
 
enum {
        CLK_L_CPU = 0x1 << 0,
        CLK_L_COP = 0x1 << 1,
        CLK_L_TRIG_SYS = 0x1 << 2,
        CLK_L_RTC = 0x1 << 4,
        CLK_L_TMR = 0x1 << 5,
        CLK_L_UARTA = 0x1 << 6,
        CLK_L_UARTB = 0x1 << 7,
        CLK_L_GPIO = 0x1 << 8,
        CLK_L_SDMMC2 = 0x1 << 9,
        CLK_L_SPDIF = 0x1 << 10,
        CLK_L_I2S1 = 0x1 << 11,
        CLK_L_I2C1 = 0x1 << 12,
        CLK_L_NDFLASH = 0x1 << 13,
        CLK_L_SDMMC1 = 0x1 << 14,
        CLK_L_SDMMC4 = 0x1 << 15,
        CLK_L_PWM = 0x1 << 17,
        CLK_L_I2S2 = 0x1 << 18,
        CLK_L_EPP = 0x1 << 19,
        CLK_L_VI = 0x1 << 20,
        CLK_L_2D = 0x1 << 21,
        CLK_L_USBD = 0x1 << 22,
        CLK_L_ISP = 0x1 << 23,
        CLK_L_3D = 0x1 << 24,
        CLK_L_DISP2 = 0x1 << 26,
        CLK_L_DISP1 = 0x1 << 27,
        CLK_L_HOST1X = 0x1 << 28,
        CLK_L_VCP = 0x1 << 29,
        CLK_L_I2S0 = 0x1 << 30,
        CLK_L_CACHE2 = 0x1 << 31,
 
        CLK_H_MEM = 0x1 << 0,
        CLK_H_AHBDMA = 0x1 << 1,
        CLK_H_APBDMA = 0x1 << 2,
        CLK_H_KBC = 0x1 << 4,
        CLK_H_STAT_MON = 0x1 << 5,
        CLK_H_PMC = 0x1 << 6,
        CLK_H_FUSE = 0x1 << 7,
        CLK_H_KFUSE = 0x1 << 8,
        CLK_H_SBC1 = 0x1 << 9,
        CLK_H_SNOR = 0x1 << 10,
        CLK_H_JTAG2TBC = 0x1 << 11,
        CLK_H_SBC2 = 0x1 << 12,
        CLK_H_SBC3 = 0x1 << 14,
        CLK_H_I2C5 = 0x1 << 15,
        CLK_H_DSI = 0x1 << 16,
        CLK_H_HSI = 0x1 << 18,
        CLK_H_HDMI = 0x1 << 19,
        CLK_H_CSI = 0x1 << 20,
        CLK_H_I2C2 = 0x1 << 22,
        CLK_H_UARTC = 0x1 << 23,
        CLK_H_MIPI_CAL = 0x1 << 24,
        CLK_H_EMC = 0x1 << 25,
        CLK_H_USB2 = 0x1 << 26,
        CLK_H_USB3 = 0x1 << 27,
        CLK_H_MPE = 0x1 << 28,
        CLK_H_VDE = 0x1 << 29,
        CLK_H_BSEA = 0x1 << 30,
        CLK_H_BSEV = 0x1 << 31,
 
        CLK_U_UARTD = 0x1 << 1,
        CLK_U_UARTE = 0x1 << 2,
        CLK_U_I2C3 = 0x1 << 3,
        CLK_U_SBC4 = 0x1 << 4,
        CLK_U_SDMMC3 = 0x1 << 5,
        CLK_U_PCIE = 0x1 << 6,
        CLK_U_OWR = 0x1 << 7,
        CLK_U_AFI = 0x1 << 8,
        CLK_U_CSITE = 0x1 << 9,
        CLK_U_PCIEXCLK = 0x1 << 10,
        CLK_U_AVPUCQ = 0x1 << 11,
        CLK_U_TRACECLKIN = 0x1 << 13,
        CLK_U_SOC_THERM = 0x1 << 14,
        CLK_U_DTV = 0x1 << 15,
        CLK_U_NAND_SPEED = 0x1 << 16,
        CLK_U_I2C_SLOW = 0x1 << 17,
        CLK_U_DSIB = 0x1 << 18,
        CLK_U_TSEC = 0x1 << 19,
        CLK_U_IRAMA = 0x1 << 20,
        CLK_U_IRAMB = 0x1 << 21,
        CLK_U_IRAMC = 0x1 << 22,
 
        // Clock reset.
        CLK_U_EMUCIF = 0x1 << 23,
        // Clock enable.
        CLK_U_IRAMD = 0x1 << 23,
 
        CLK_U_CRAM2 = 0x2 << 24,
        CLK_U_XUSB_HOST = 0x1 << 25,
        CLK_U_MSENC = 0x1 << 27,
        CLK_U_SUS_OUT = 0x1 << 28,
        CLK_U_DEV2_OUT = 0x1 << 29,
        CLK_U_DEV1_OUT = 0x1 << 30,
        CLK_U_XUSB_DEV = 0x1 << 31,
 
        CLK_V_CPUG = 0x1 << 0,
        CLK_V_CPULP = 0x1 << 1,
        CLK_V_3D2 = 0x1 << 2,
        CLK_V_MSELECT = 0x1 << 3,
        CLK_V_I2S3 = 0x1 << 5,
        CLK_V_I2S4 = 0x1 << 6,
        CLK_V_I2C4 = 0x1 << 7,
        CLK_V_SBC5 = 0x1 << 8,
        CLK_V_SBC6 = 0x1 << 9,
        CLK_V_AUDIO = 0x1 << 10,
        CLK_V_APBIF = 0x1 << 11,
        CLK_V_DAM0 = 0x1 << 12,
        CLK_V_DAM1 = 0x1 << 13,
        CLK_V_DAM2 = 0x1 << 14,
        CLK_V_HDA2CODEC_2X = 0x1 << 15,
        CLK_V_ATOMICS = 0x1 << 16,
        CLK_V_ACTMON = 0x1 << 23,
        CLK_V_EXTPERIPH1 = 0x1 << 24,
        CLK_V_SATA = 0x1 << 28,
        CLK_V_HDA = 0x1 << 29,
 
        CLK_W_HDA2HDMICODEC = 0x1 << 0,
        CLK_W_SATACOLD = 0x1 << 1,
        CLK_W_CEC = 0x1 << 8,
        CLK_W_XUSB_PADCTL = 0x1 << 14,
        CLK_W_ENTROPY = 0x1 << 21,
        CLK_W_AMX0 = 0x1 << 25,
        CLK_W_ADX0 = 0x1 << 26,
        CLK_W_DVFS = 0x1 << 27,
        CLK_W_XUSB_SS = 0x1 << 28,
        CLK_W_MC1 = 0x1 << 30,
        CLK_W_EMC1 = 0x1 << 31,
 
        CLK_X_AFC0 = 0x1 << 31,
        CLK_X_AFC1 = 0x1 << 30,
        CLK_X_AFC2 = 0x1 << 29,
        CLK_X_AFC3 = 0x1 << 28,
        CLK_X_AFC4 = 0x1 << 27,
        CLK_X_AFC5 = 0x1 << 26,
        CLK_X_AMX1 = 0x1 << 25,
        CLK_X_GPU = 0x1 << 24,
        CLK_X_SOR0 = 0x1 << 22,
        CLK_X_DPAUX = 0x1 << 21,
        CLK_X_ADX1 = 0x1 << 20,
        CLK_X_VIC = 0x1 << 18,
        CLK_X_CLK72MHZ = 0x1 << 17,
        CLK_X_HDMI_AUDIO = 0x1 << 16,
        CLK_X_EMC_DLL = 0x1 << 14,
        CLK_X_VIM2_CLK = 0x1 << 11,
        CLK_X_I2C6 = 0x1 << 6,
        CLK_X_CAM_MCLK2 = 0x1 << 5,
        CLK_X_CAM_MCLK = 0x1 << 4,
        CLK_X_SPARE = 0x1 << 0,
};
 
/* PLL stabilization delay in usec */
#define CLOCK_PLL_STABLE_DELAY_US 300
 
#define IO_STABILIZATION_DELAY (2)
 
/* Calculate clock fractional divider value from ref and target frequencies.
 * This is for a U7.1 format. This is not well written up in the book and
 * there have been some questions about this macro, so here we go.
 * U7.1 format is defined as (ddddddd+1) + (h*.5)
 * The lowest order bit is actually a fractional bit.
 * Hence, the divider can be thought of as 9 bits.
 * So:
 * divider = ((ref/freq) << 1 - 1) (upper 7 bits) |
 *      (ref/freq & 1) (low order half-bit)
 * however we can't do fractional arithmetic ... these are integers!
 * So we normalize by shifting the result left 1 bit, and extracting
 * ddddddd and h directly to the returned u8.
 * divider = 2*(ref/freq);
 * We want to
 * preserve 7 bits of divisor and one bit of fraction, in 8 bits, as well as
 * subtract one from ddddddd. Since we computed ref*2, the dddddd is now nicely
 * situated in the upper 7 bits, and the h is sitting there in the low order
 * bit. To subtract 1 from ddddddd, just subtract 2 from the 8-bit number
 * and voila, upper 7 bits are (ref/freq-1), and lowest bit is h. Since you
 * will assign this to a u8, it gets nicely truncated for you.
 */
#define CLK_DIVIDER(REF, FREQ)  (DIV_ROUND_UP(((REF) * 2), (FREQ)) - 2)
 
/* Calculate clock frequency value from reference and clock divider value
 * The discussion in the book is pretty lacking.
 * The idea is that we need to divide a ref clock by a divisor
 * in U7.1 format, where 7 upper bits are the integer
 * and lowest order bit is a fraction.
 * from the book, U7.1 is (ddddddd+1) + (h*.5)
 * To normalize to an actual number, we might do this:
 * ((d>>7+1)&0x7f) + (d&1 >> 1)
 * but as you might guess, the low order bit would be lost.
 * Since we can't express the fractional bit, we need to multiply it all by 2.
 * ((d + 2)&0xfe) + (d & 1)
 * Since we're just adding +2, the lowest order bit is preserved. Hence
 * (d+2) is the same as ((d + 2)&0xfe) + (d & 1)
 *
 * Since you multiply denominator * 2 (by NOT shifting it),
 * you multiply numerator * 2 to cancel it out.
 */
#define CLK_FREQUENCY(REF, REG) (((REF) * 2) / ((REG) + 2))
 
static inline void _clock_set_div(u32 *reg, const char *name, u32 div,
                                  u32 div_mask, u32 src)
{
        // The I2C and UART divisors are 16 bit while all the others are 8 bit.
        // The I2C clocks are handled by the specialized macro below, but the
        // UART clocks aren't. Don't use this function on UART clocks.
        if (div & ~div_mask) {
                printk(BIOS_ERR, "%s clock divisor overflow!", name);
                hlt();
        }
        clrsetbits32(reg, CLK_SOURCE_MASK | CLK_DIVISOR_MASK,
                     src << CLK_SOURCE_SHIFT | div);
}
 
#define clock_configure_irregular_source(device, src, freq, src_id) \
        _clock_set_div(&clk_rst->clk_src_##device, #device, \
                CLK_DIVIDER(TEGRA_##src##_KHZ, freq), 0xff, src_id)
 
/* Warning: Some devices just use different bits for the same sources for no
 * apparent reason. *Always* double-check the TRM before trusting this macro. */
#define clock_configure_source(device, src, freq) \
        clock_configure_irregular_source(device, src, freq, src)
 
/* The I2C divisors are not 7.1 divisors like the others, they divide by n + 1
 * directly. Also, there are internal divisors in the I2C controller itself.
 * We can deal with those here and make it easier to select what the actual
 * bus frequency will be. The 0x19 value is the default divisor in the
 * clk_divisor register in the controller, and 8 is just a magic number in the
 * documentation.
 */
#define clock_configure_i2c_scl_freq(device, src, freq) \
        _clock_set_div(&clk_rst->clk_src_##device, #device, \
                DIV_ROUND_UP(TEGRA_##src##_KHZ, (freq) * (0x19 + 1) * 8) - 1, \
                0xffff, src)
 
enum clock_source {  /* Careful: Not true for all sources, always check TRM! */
        PLLP = 0,
        PLLC2 = 1,
        PLLC = 2,
        PLLD = 2,
        PLLC3 = 3,
        PLLA = 3,
        PLLM = 4,
        PLLD2 = 5,
        CLK_M = 6,
};
 
/* soc-specific */
#define TEGRA_CLK_M_KHZ  clock_get_osc_khz()
#define TEGRA_PLLX_KHZ   CONFIG_PLLX_KHZ
#define TEGRA_PLLP_KHZ   (408000)
#define TEGRA_PLLC_KHZ   (600000)
#define TEGRA_PLLD_KHZ   (925000)
#define TEGRA_PLLU_KHZ   (960000)
 
#define TEGRA_SCLK_KHZ   (300000)
#define TEGRA_HCLK_RATIO 1
#define TEGRA_HCLK_KHZ   (TEGRA_SCLK_KHZ / (1 + TEGRA_HCLK_RATIO))
#define TEGRA_PCLK_RATIO 0
#define TEGRA_PCLK_KHZ   (TEGRA_HCLK_KHZ / (1 + TEGRA_PCLK_RATIO))
 
int clock_get_osc_khz(void);
int clock_get_pll_input_khz(void);
u32 clock_display(u32 frequency);
void clock_early_uart(void);
void clock_external_output(int clk_id);
void clock_sdram(u32 m, u32 n, u32 p, u32 setup, u32 ph45, u32 ph90,
                 u32 ph135, u32 kvco, u32 kcp, u32 stable_time, u32 emc_source,
                 u32 same_freq);
void clock_cpu0_config(void *entry);
void clock_cpu0_remove_reset(void);
void clock_halt_avp(void);
void clock_enable_clear_reset(u32 l, u32 h, u32 u, u32 v, u32 w, u32 x);
void clock_reset_l(u32 l);
void clock_reset_h(u32 h);
void clock_reset_u(u32 u);
void clock_reset_v(u32 v);
void clock_reset_w(u32 w);
void clock_reset_x(u32 x);
void clock_init(void);
void clock_init_arm_generic_timer(void);
void sor_clock_stop(void);
void sor_clock_start(void);
 
#endif /* __SOC_NVIDIA_TEGRA124_CLOCK_H__ */