HelenOS sources

root/uspace/drv/platform/amdm37x/amdm37x.c

/* [<][>][^][v][top][bottom][index][help] */

DEFINITIONS

This source file includes following definitions.
  1. log_message
  2. amdm37x_init
  3. amdm37x_setup_dpll_on_autoidle
  4. amdm37x_usb_clocks_set
  5. amdm37x_usb_tll_init

/*
 * Copyright (c) 2012 Jan Vesely
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/**
 * @addtogroup amdm37x
 * @{
 */

/** @file
 */

#include "amdm37x.h"

#include <assert.h>
#include <ddi.h>
#include <ddf/log.h>
#include <errno.h>
#include <stdio.h>

static void
log_message(const volatile void *place, uint64_t val, volatile void *base, size_t size,
    void *data, bool write)
{
        printf("PIO %s: %p(%p) %#" PRIx64 "\n", write ? "WRITE" : "READ",
            (place - base) + data, place, val);
}

errno_t amdm37x_init(amdm37x_t *device, bool trace)
{
        assert(device);
        errno_t ret = EOK;

        ret = pio_enable((void *)USBHOST_CM_BASE_ADDRESS, USBHOST_CM_SIZE,
            (void **)&device->cm.usbhost);
        if (ret != EOK)
                return ret;

        ret = pio_enable((void *)CORE_CM_BASE_ADDRESS, CORE_CM_SIZE,
            (void **)&device->cm.core);
        if (ret != EOK)
                return ret;

        ret = pio_enable((void *)CLOCK_CONTROL_CM_BASE_ADDRESS,
            CLOCK_CONTROL_CM_SIZE, (void **)&device->cm.clocks);
        if (ret != EOK)
                return ret;

        ret = pio_enable((void *)MPU_CM_BASE_ADDRESS,
            MPU_CM_SIZE, (void **)&device->cm.mpu);
        if (ret != EOK)
                return ret;

        ret = pio_enable((void *)IVA2_CM_BASE_ADDRESS,
            IVA2_CM_SIZE, (void **)&device->cm.iva2);
        if (ret != EOK)
                return ret;

        ret = pio_enable((void *)CLOCK_CONTROL_PRM_BASE_ADDRESS,
            CLOCK_CONTROL_PRM_SIZE, (void **)&device->prm.clocks);
        if (ret != EOK)
                return ret;

        ret = pio_enable((void *)GLOBAL_REG_PRM_BASE_ADDRESS,
            GLOBAL_REG_PRM_SIZE, (void **)&device->prm.global);
        if (ret != EOK)
                return ret;

        ret = pio_enable((void *)AMDM37x_USBTLL_BASE_ADDRESS,
            AMDM37x_USBTLL_SIZE, (void **)&device->tll);
        if (ret != EOK)
                return ret;

        ret = pio_enable((void *)AMDM37x_UHH_BASE_ADDRESS,
            AMDM37x_UHH_SIZE, (void **)&device->uhh);
        if (ret != EOK)
                return ret;

        if (trace) {
                pio_trace_enable(device->tll, AMDM37x_USBTLL_SIZE, log_message, (void *)AMDM37x_USBTLL_BASE_ADDRESS);
                pio_trace_enable(device->cm.clocks, CLOCK_CONTROL_CM_SIZE, log_message, (void *)CLOCK_CONTROL_CM_BASE_ADDRESS);
                pio_trace_enable(device->cm.core, CORE_CM_SIZE, log_message, (void *)CORE_CM_BASE_ADDRESS);
                pio_trace_enable(device->cm.mpu, MPU_CM_SIZE, log_message, (void *)MPU_CM_BASE_ADDRESS);
                pio_trace_enable(device->cm.iva2, IVA2_CM_SIZE, log_message, (void *)IVA2_CM_BASE_ADDRESS);
                pio_trace_enable(device->cm.usbhost, USBHOST_CM_SIZE, log_message, (void *)USBHOST_CM_BASE_ADDRESS);
                pio_trace_enable(device->uhh, AMDM37x_UHH_SIZE, log_message, (void *)AMDM37x_UHH_BASE_ADDRESS);
                pio_trace_enable(device->prm.clocks, CLOCK_CONTROL_PRM_SIZE, log_message, (void *)CLOCK_CONTROL_PRM_BASE_ADDRESS);
                pio_trace_enable(device->prm.global, GLOBAL_REG_PRM_SIZE, log_message, (void *)GLOBAL_REG_PRM_BASE_ADDRESS);
        }
        return EOK;
}

/** Set DPLLs 1,2,3,4,5 to ON (locked) and autoidle.
 * @param device Register map.
 *
 * The idea is to get all DPLLs running and make hw control their power mode,
 * based on the module requirements (module ICLKs and FCLKs).
 */
void amdm37x_setup_dpll_on_autoidle(amdm37x_t *device)
{
        assert(device);
        /*
         * Get SYS_CLK value, it is used as reference clock by all DPLLs,
         * NFI who sets this or why it is set to specific value.
         */
        const unsigned osc_clk = pio_read_32(&device->prm.clocks->clksel) &
            CLOCK_CONTROL_PRM_CLKSEL_SYS_CLKIN_MASK;
        const unsigned clk_reg = pio_read_32(&device->prm.global->clksrc_ctrl);
        const unsigned base_freq = sys_clk_freq_kHz(osc_clk) /
            GLOBAL_REG_PRM_CLKSRC_CTRL_SYSCLKDIV_GET(clk_reg);
        ddf_msg(LVL_NOTE, "Base frequency: %d.%dMhz",
            base_freq / 1000, base_freq % 1000);

        /*
         * DPLL1 provides MPU(CPU) clock.
         * It uses SYS_CLK as reference clock and core clock (DPLL3) as
         * high frequency bypass (MPU then runs on L3 interconnect freq).
         * It should be setup by fw or u-boot.
         */
        mpu_cm_regs_t *mpu = device->cm.mpu;

        /* Current MPU frequency. */
        if (pio_read_32(&mpu->clkstst) & MPU_CM_CLKSTST_CLKACTIVITY_MPU_ACTIVE_FLAG) {
                if (pio_read_32(&mpu->idlest_pll) & MPU_CM_IDLEST_PLL_ST_MPU_CLK_LOCKED_FLAG) {
                        /* DPLL active and locked */
                        const uint32_t reg = pio_read_32(&mpu->clksel1_pll);
                        const unsigned multiplier =
                            (reg & MPU_CM_CLKSEL1_PLL_MPU_DPLL_MULT_MASK) >>
                            MPU_CM_CLKSEL1_PLL_MPU_DPLL_MULT_SHIFT;
                        const unsigned divisor =
                            (reg & MPU_CM_CLKSEL1_PLL_MPU_DPLL_DIV_MASK) >>
                            MPU_CM_CLKSEL1_PLL_MPU_DPLL_DIV_SHIFT;
                        const unsigned divisor2 =
                            (pio_read_32(&mpu->clksel2_pll) &
                            MPU_CM_CLKSEL2_PLL_MPU_DPLL_CLKOUT_DIV_MASK);
                        if (multiplier && divisor && divisor2) {
                                /** See AMDM37x TRM p. 300 for the formula */
                                const unsigned freq =
                                    ((base_freq * multiplier) / (divisor + 1)) /
                                    divisor2;
                                ddf_msg(LVL_NOTE, "MPU running at %d.%d MHz",
                                    freq / 1000, freq % 1000);
                        } else {
                                ddf_msg(LVL_WARN, "Frequency divisor and/or "
                                    "multiplier value invalid: %d %d %d",
                                    multiplier, divisor, divisor2);
                        }
                } else {
                        /* DPLL in LP bypass mode */
                        const unsigned divisor =
                            MPU_CM_CLKSEL1_PLL_MPU_CLK_SRC_VAL(
                            pio_read_32(&mpu->clksel1_pll));
                        ddf_msg(LVL_NOTE, "MPU DPLL in bypass mode, running at"
                            " CORE CLK / %d MHz", divisor);
                }
        } else {
                ddf_msg(LVL_WARN, "MPU clock domain is not active, we should not be running...");
        }
        // TODO: Enable this (automatic MPU downclocking):
#if 0
        /*
         * Enable low power bypass mode, this will take effect the next lock or
         * relock sequence.
         */
        //TODO: We might need to force re-lock after enabling this
        pio_set_32(&mpu->clken_pll, MPU_CM_CLKEN_PLL_EN_MPU_DPLL_LP_MODE_FLAG, 5);
        /* Enable automatic relocking */
        pio_change_32(&mpu->autoidle_pll, MPU_CM_AUTOIDLE_PLL_AUTO_MPU_DPLL_ENABLED, MPU_CM_AUTOIDLE_PLL_AUTO_MPU_DPLL_MASK, 5);
#endif

        /*
         * DPLL2 provides IVA(video acceleration) clock.
         * It uses SYS_CLK as reference clokc and core clock (DPLL3) as
         * high frequency bypass (IVA runs on L3 freq).
         */
        // TODO: We can probably turn this off entirely. IVA is left unused.
        /*
         * Enable low power bypass mode, this will take effect the next lock or
         * relock sequence.
         */
        //TODO: We might need to force re-lock after enabling this
        pio_set_32(&device->cm.iva2->clken_pll, MPU_CM_CLKEN_PLL_EN_MPU_DPLL_LP_MODE_FLAG, 5);
        /* Enable automatic relocking */
        pio_change_32(&device->cm.iva2->autoidle_pll, MPU_CM_AUTOIDLE_PLL_AUTO_MPU_DPLL_ENABLED, MPU_CM_AUTOIDLE_PLL_AUTO_MPU_DPLL_MASK, 5);

        /*
         * DPLL3 provides tons of clocks:
         * CORE_CLK, COREX2_CLK, DSS_TV_CLK, 12M_CLK, 48M_CLK, 96M_CLK, L3_ICLK,
         * and L4_ICLK. It uses SYS_CLK as reference clock and low frequency
         * bypass. It should be setup by fw or u-boot as it controls critical
         * interconnects.
         */
        if (pio_read_32(&device->cm.clocks->idlest_ckgen) & CLOCK_CONTROL_CM_IDLEST_CKGEN_ST_CORE_CLK_FLAG) {
                /* DPLL active and locked */
                const uint32_t reg =
                    pio_read_32(&device->cm.clocks->clksel1_pll);
                const unsigned multiplier =
                    CLOCK_CONTROL_CM_CLKSEL1_PLL_CORE_DPLL_MULT_GET(reg);
                const unsigned divisor =
                    CLOCK_CONTROL_CM_CLKSEL1_PLL_CORE_DPLL_DIV_GET(reg);
                const unsigned divisor2 =
                    CLOCK_CONTROL_CM_CLKSEL1_PLL_CORE_DPLL_CLKOUT_DIV_GET(reg);
                if (multiplier && divisor && divisor2) {
                        /** See AMDM37x TRM p. 300 for the formula */
                        const unsigned freq =
                            ((base_freq * multiplier) / (divisor + 1)) / divisor2;
                        ddf_msg(LVL_NOTE, "CORE CLK running at %d.%d MHz",
                            freq / 1000, freq % 1000);
                        const unsigned l3_div =
                            pio_read_32(&device->cm.core->clksel) &
                            CORE_CM_CLKSEL_CLKSEL_L3_MASK;
                        if (l3_div == CORE_CM_CLKSEL_CLKSEL_L3_DIVIDED1 ||
                            l3_div == CORE_CM_CLKSEL_CLKSEL_L3_DIVIDED2) {
                                ddf_msg(LVL_NOTE, "L3 interface at %d.%d MHz",
                                    (freq / l3_div) / 1000,
                                    (freq / l3_div) % 1000);
                        } else {
                                ddf_msg(LVL_WARN, "L3 interface clock divisor is"
                                    " invalid: %d", l3_div);
                        }
                } else {
                        ddf_msg(LVL_WARN, "DPLL3 frequency divisor and/or "
                            "multiplier value invalid: %d %d %d",
                            multiplier, divisor, divisor2);
                }
        } else {
                ddf_msg(LVL_WARN, "CORE CLK in bypass mode, fruunig at SYS_CLK"
                    " frreq of %d.%d MHz", base_freq / 1000, base_freq % 1000);
        }

        /* Set DPLL3 to automatic to save power */
        pio_change_32(&device->cm.clocks->autoidle_pll,
            CLOCK_CONTROL_CM_AUTOIDLE_PLL_AUTO_CORE_DPLL_AUTOMATIC,
            CLOCK_CONTROL_CM_AUTOIDLE_PLL_AUTO_CORE_DPLL_MASK, 5);

        /*
         * DPLL4 provides peripheral domain clocks:
         * CAM_MCLK, EMU_PER_ALWON_CLK, DSS1_ALWON_FCLK, and 96M_ALWON_FCLK.
         * It uses SYS_CLK as reference clock and low frequency bypass.
         * 96M clock is used by McBSP[1,5], MMC[1,2,3], I2C[1,2,3], so
         * we can probably turn this off entirely (DSS is still non-functional).
         */
        /* Set DPLL4 to automatic to save power */
        pio_change_32(&device->cm.clocks->autoidle_pll,
            CLOCK_CONTROL_CM_AUTOIDLE_PLL_AUTO_PERIPH_DPLL_AUTOMATIC,
            CLOCK_CONTROL_CM_AUTOIDLE_PLL_AUTO_PERIPH_DPLL_MASK, 5);

        /*
         * DPLL5 provide peripheral domain clocks: 120M_FCLK.
         * It uses SYS_CLK as reference clock and low frequency bypass.
         * 120M clock is used by HS USB and USB TLL.
         */
        // TODO setup DPLL5
        if ((pio_read_32(&device->cm.clocks->clken2_pll) &
            CLOCK_CONTROL_CM_CLKEN2_PLL_EN_PERIPH2_DPLL_MASK) !=
            CLOCK_CONTROL_CM_CLKEN2_PLL_EN_PERIPH2_DPLL_LOCK) {
                /*
                 * Compute divisors and multiplier
                 * See AMDM37x TRM p. 300 for the formula
                 */
                // TODO: base_freq does not have to be rounded to Mhz
                // (that's why I used KHz as unit).
                const unsigned mult = 120;
                const unsigned div = (base_freq / 1000) - 1;
                const unsigned div2 = 1;
                if (((base_freq % 1000) != 0) || (div > 127)) {
                        ddf_msg(LVL_ERROR, "Rounding error, or divisor to big "
                            "freq: %d, div: %d", base_freq, div);
                        return;
                }
                assert(div <= 127);

                /* Set multiplier */
                pio_change_32(&device->cm.clocks->clksel4_pll,
                    CLOCK_CONTROL_CM_CLKSEL4_PLL_PERIPH2_DPLL_MULT_CREATE(mult),
                    CLOCK_CONTROL_CM_CLKSEL4_PLL_PERIPH2_DPLL_MULT_MASK, 10);

                /* Set DPLL divisor */
                pio_change_32(&device->cm.clocks->clksel4_pll,
                    CLOCK_CONTROL_CM_CLKSEL4_PLL_PERIPH2_DPLL_DIV_CREATE(div),
                    CLOCK_CONTROL_CM_CLKSEL4_PLL_PERIPH2_DPLL_DIV_MASK, 10);

                /* Set output clock divisor */
                pio_change_32(&device->cm.clocks->clksel5_pll,
                    CLOCK_CONTROL_CM_CLKSEL5_PLL_DIV120M_CREATE(div2),
                    CLOCK_CONTROL_CM_CLKSEL5_PLL_DIV120M_MASK, 10);

                /* Start DPLL5 */
                pio_change_32(&device->cm.clocks->clken2_pll,
                    CLOCK_CONTROL_CM_CLKEN2_PLL_EN_PERIPH2_DPLL_LOCK,
                    CLOCK_CONTROL_CM_CLKEN2_PLL_EN_PERIPH2_DPLL_MASK, 10);

        }
        /* Set DPLL5 to automatic to save power */
        pio_change_32(&device->cm.clocks->autoidle2_pll,
            CLOCK_CONTROL_CM_AUTOIDLE2_PLL_AUTO_PERIPH2_DPLL_AUTOMATIC,
            CLOCK_CONTROL_CM_AUTOIDLE2_PLL_AUTO_PERIPH2_DPLL_MASK, 5);
}

/** Enable/disable function and interface clocks for USBTLL and USBHOST.
 * @param device Register map.
 * @param on True to switch clocks on.
 */
void amdm37x_usb_clocks_set(amdm37x_t *device, bool enabled)
{
        if (enabled) {
                /* Enable interface and function clock for USB TLL */
                pio_set_32(&device->cm.core->fclken3,
                    CORE_CM_FCLKEN3_EN_USBTLL_FLAG, 5);
                pio_set_32(&device->cm.core->iclken3,
                    CORE_CM_ICLKEN3_EN_USBTLL_FLAG, 5);

                /* Enable interface and function clock for USB hosts */
                pio_set_32(&device->cm.usbhost->fclken,
                    USBHOST_CM_FCLKEN_EN_USBHOST1_FLAG |
                    USBHOST_CM_FCLKEN_EN_USBHOST2_FLAG, 5);
                pio_set_32(&device->cm.usbhost->iclken,
                    USBHOST_CM_ICLKEN_EN_USBHOST, 5);
#if 0
                printf("DPLL5 (and everything else) should be on: %"
                    PRIx32 " %" PRIx32 ".\n",
                    pio_read_32(&device->cm.clocks->idlest_ckgen),
                    pio_read_32(&device->cm.clocks->idlest2_ckgen));
#endif
        } else {
                /* Disable interface and function clock for USB hosts */
                pio_clear_32(&device->cm.usbhost->iclken,
                    USBHOST_CM_ICLKEN_EN_USBHOST, 5);
                pio_clear_32(&device->cm.usbhost->fclken,
                    USBHOST_CM_FCLKEN_EN_USBHOST1_FLAG |
                    USBHOST_CM_FCLKEN_EN_USBHOST2_FLAG, 5);

                /* Disable interface and function clock for USB TLL */
                pio_clear_32(&device->cm.core->iclken3,
                    CORE_CM_ICLKEN3_EN_USBTLL_FLAG, 5);
                pio_clear_32(&device->cm.core->fclken3,
                    CORE_CM_FCLKEN3_EN_USBTLL_FLAG, 5);
        }
}

/** Initialize USB TLL port connections.
 *
 * Different modes are on page 3312 of the Manual Figure 22-34.
 * Select mode than can operate in FS/LS.
 */
errno_t amdm37x_usb_tll_init(amdm37x_t *device)
{
        /* Check access */
        if (pio_read_32(&device->cm.core->idlest3) & CORE_CM_IDLEST3_ST_USBTLL_FLAG) {
                ddf_msg(LVL_ERROR, "USB TLL is not accessible");
                return EIO;
        }

        /* Reset USB TLL */
        pio_set_32(&device->tll->sysconfig, TLL_SYSCONFIG_SOFTRESET_FLAG, 5);
        ddf_msg(LVL_DEBUG2, "Waiting for USB TLL reset");
        while (!(pio_read_32(&device->tll->sysstatus) & TLL_SYSSTATUS_RESET_DONE_FLAG))
                ;
        ddf_msg(LVL_DEBUG, "USB TLL Reset done.");

        /* Setup idle mode (smart idle) */
        pio_change_32(&device->tll->sysconfig,
            TLL_SYSCONFIG_CLOCKACTIVITY_FLAG | TLL_SYSCONFIG_AUTOIDLE_FLAG |
            TLL_SYSCONFIG_SIDLE_MODE_SMART, TLL_SYSCONFIG_SIDLE_MODE_MASK, 5);

        /* Smart idle for UHH */
        pio_change_32(&device->uhh->sysconfig,
            UHH_SYSCONFIG_CLOCKACTIVITY_FLAG | UHH_SYSCONFIG_AUTOIDLE_FLAG |
            UHH_SYSCONFIG_SIDLE_MODE_SMART, UHH_SYSCONFIG_SIDLE_MODE_MASK, 5);

        /*
         * Set all ports to go through TLL(UTMI)
         * Direct connection can only work in HS mode
         */
        pio_set_32(&device->uhh->hostconfig,
            UHH_HOSTCONFIG_P1_ULPI_BYPASS_FLAG |
            UHH_HOSTCONFIG_P2_ULPI_BYPASS_FLAG |
            UHH_HOSTCONFIG_P3_ULPI_BYPASS_FLAG, 5);

        /* What is this? */
        pio_set_32(&device->tll->shared_conf, TLL_SHARED_CONF_FCLK_IS_ON_FLAG, 5);

        for (unsigned i = 0; i < 3; ++i) {
                /*
                 * Serial mode is the only one capable of FS/LS operation.
                 * Select FS/LS mode, no idea what the difference is
                 * one of bidirectional modes might be good choice
                 * 2 = 3pin bidi phy.
                 */
                pio_change_32(&device->tll->channel_conf[i],
                    TLL_CHANNEL_CONF_CHANMODE_UTMI_SERIAL_MODE |
                    TLL_CHANNEL_CONF_FSLSMODE_3PIN_BIDI_PHY,
                    TLL_CHANNEL_CONF_CHANMODE_MASK |
                    TLL_CHANNEL_CONF_FSLSMODE_MASK, 5);
        }
        return EOK;
}

/**
 * @}
 */

/* [<][>][^][v][top][bottom][index][help] */
HelenOS homepage, sources at GitHub