root/drivers/gpu/drm/amd/display/dc/optc/dcn35/dcn35_optc.c
/* SPDX-License-Identifier: MIT */
/*
 * Copyright 2023 Advanced Micro Devices, Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 * OTHER DEALINGS IN THE SOFTWARE.
 *
 * Authors: AMD
 *
 */

#include "dcn35_optc.h"

#include "dcn30/dcn30_optc.h"
#include "dcn31/dcn31_optc.h"
#include "dcn32/dcn32_optc.h"
#include "reg_helper.h"
#include "dc.h"
#include "dcn_calc_math.h"
#include "dc_dmub_srv.h"

#define REG(reg)\
        optc1->tg_regs->reg

#define CTX \
        optc1->base.ctx

#undef FN
#define FN(reg_name, field_name) \
        optc1->tg_shift->field_name, optc1->tg_mask->field_name

/**
 * optc35_set_odm_combine() - Enable CRTC - call ASIC Control Object to enable Timing generator.
 *
 * @optc: Output Pipe Timing Combine instance reference.
 * @opp_id: Output Plane Processor instance ID.
 * @opp_cnt: Output Plane Processor count.
 * @segment_width: Width of the segment.
 * @last_segment_width: Width of the last segment.
 *
 * Return: void.
 */
static void optc35_set_odm_combine(struct timing_generator *optc, int *opp_id, int opp_cnt,
                int segment_width, int last_segment_width)
{
        struct optc *optc1 = DCN10TG_FROM_TG(optc);
        uint32_t memory_mask = 0;
        int h_active = segment_width * opp_cnt;
        /* Each memory instance is 2048x(314x2) bits to support half line of 4096 */
        int odm_mem_count = (h_active + 2047) / 2048;

        /*
         * display <= 4k : 2 memories + 2 pipes
         * 4k < display <= 8k : 4 memories + 2 pipes
         * 8k < display <= 12k : 6 memories + 4 pipes
         */
        if (opp_cnt == 4) {
                if (odm_mem_count <= 2)
                        memory_mask = 0x3;
                else if (odm_mem_count <= 4)
                        memory_mask = 0xf;
                else
                        memory_mask = 0x3f;
        } else {
                if (odm_mem_count <= 2)
                        memory_mask = 0x1 << (opp_id[0] * 2) | 0x1 << (opp_id[1] * 2);
                else if (odm_mem_count <= 4)
                        memory_mask = 0x3 << (opp_id[0] * 2) | 0x3 << (opp_id[1] * 2);
                else
                        memory_mask = 0x77;
        }

        REG_SET(OPTC_MEMORY_CONFIG, 0,
                OPTC_MEM_SEL, memory_mask);

        if (opp_cnt == 2) {
                REG_SET_3(OPTC_DATA_SOURCE_SELECT, 0,
                                OPTC_NUM_OF_INPUT_SEGMENT, 1,
                                OPTC_SEG0_SRC_SEL, opp_id[0],
                                OPTC_SEG1_SRC_SEL, opp_id[1]);
        } else if (opp_cnt == 4) {
                REG_SET_5(OPTC_DATA_SOURCE_SELECT, 0,
                                OPTC_NUM_OF_INPUT_SEGMENT, 3,
                                OPTC_SEG0_SRC_SEL, opp_id[0],
                                OPTC_SEG1_SRC_SEL, opp_id[1],
                                OPTC_SEG2_SRC_SEL, opp_id[2],
                                OPTC_SEG3_SRC_SEL, opp_id[3]);
        }

        REG_UPDATE(OPTC_WIDTH_CONTROL,
                        OPTC_SEGMENT_WIDTH, segment_width);

        REG_UPDATE(OTG_H_TIMING_CNTL, OTG_H_TIMING_DIV_MODE, opp_cnt - 1);
        optc1->opp_count = opp_cnt;
}

static bool optc35_enable_crtc(struct timing_generator *optc)
{
        struct optc *optc1 = DCN10TG_FROM_TG(optc);

        /* opp instance for OTG, 1 to 1 mapping and odm will adjust */
        REG_UPDATE(OPTC_DATA_SOURCE_SELECT,
                        OPTC_SEG0_SRC_SEL, optc->inst);

        /* VTG enable first is for HW workaround */
        REG_UPDATE(CONTROL,
                        VTG0_ENABLE, 1);

        REG_SEQ_START();

        /* Enable CRTC */
        REG_UPDATE_2(OTG_CONTROL,
                        OTG_DISABLE_POINT_CNTL, 2,
                        OTG_MASTER_EN, 1);

        REG_SEQ_SUBMIT();
        REG_SEQ_WAIT_DONE();

        return true;
}

/* disable_crtc */
static bool optc35_disable_crtc(struct timing_generator *optc)
{
        struct optc *optc1 = DCN10TG_FROM_TG(optc);

        REG_UPDATE_5(OPTC_DATA_SOURCE_SELECT,
                        OPTC_SEG0_SRC_SEL, 0xf,
                        OPTC_SEG1_SRC_SEL, 0xf,
                        OPTC_SEG2_SRC_SEL, 0xf,
                        OPTC_SEG3_SRC_SEL, 0xf,
                        OPTC_NUM_OF_INPUT_SEGMENT, 0);

        REG_UPDATE(OPTC_MEMORY_CONFIG,
                        OPTC_MEM_SEL, 0);

        /* disable otg request until end of the first line
         * in the vertical blank region
         */
        REG_UPDATE(OTG_CONTROL,
                        OTG_MASTER_EN, 0);

        REG_UPDATE(CONTROL,
                        VTG0_ENABLE, 0);

        /* CRTC disabled, so disable  clock. */
        REG_WAIT(OTG_CLOCK_CONTROL,
                        OTG_BUSY, 0,
                        1, 100000);
        REG_WAIT(OTG_CONTROL, OTG_CURRENT_MASTER_EN_STATE, 0, 1, 100000);

        optc1_clear_optc_underflow(optc);

        return true;
}

static void optc35_phantom_crtc_post_enable(struct timing_generator *optc)
{
        struct optc *optc1 = DCN10TG_FROM_TG(optc);

        /* Disable immediately. */
        REG_UPDATE_2(OTG_CONTROL, OTG_DISABLE_POINT_CNTL, 0, OTG_MASTER_EN, 0);

        /* CRTC disabled, so disable  clock. */
        REG_WAIT(OTG_CLOCK_CONTROL, OTG_BUSY, 0, 1, 100000);
}

/**
 * optc35_get_crc - Capture CRC result per component
 *
 * @optc: timing_generator instance.
 * @idx: index of crc engine to get CRC from
 * @r_cr: primary CRC signature for red data.
 * @g_y: primary CRC signature for green data.
 * @b_cb: primary CRC signature for blue data.
 *
 * This function reads the CRC signature from the OPTC registers. Notice that
 * we have three registers to keep the CRC result per color component (RGB).
 *
 * For different DCN versions:
 * - If CRC32 registers (OTG_CRC0_DATA_R32/G32/B32) are available, read from
 *   32-bit CRC registers. DCN 3.6+ supports both CRC-32 and CRC-16 polynomials
 *   selectable via OTG_CRC_POLY_SEL.
 * - Otherwise, read from legacy 16-bit CRC registers (OTG_CRC0_DATA_RG/B)
 *   which only support CRC-16 polynomial.
 *
 * Returns:
 * If CRC is disabled, return false; otherwise, return true, and the CRC
 * results in the parameters.
 */
static bool optc35_get_crc(struct timing_generator *optc, uint8_t idx,
                   uint32_t *r_cr, uint32_t *g_y, uint32_t *b_cb)
{
        uint32_t field = 0;
        struct optc *optc1 = DCN10TG_FROM_TG(optc);

        REG_GET(OTG_CRC_CNTL, OTG_CRC_EN, &field);

        /* Early return if CRC is not enabled for this CRTC */
        if (!field)
                return false;

        if (optc1->tg_mask->CRC0_R_CR32 != 0 && optc1->tg_mask->CRC1_R_CR32 != 0 &&
            optc1->tg_mask->CRC0_G_Y32 != 0 && optc1->tg_mask->CRC1_G_Y32 != 0 &&
            optc1->tg_mask->CRC0_B_CB32 != 0 && optc1->tg_mask->CRC1_B_CB32 != 0) {
                switch (idx) {
                case 0:
                        /* OTG_CRC0_DATA_R32/G32/B32 has the CRC32 results */
                        REG_GET(OTG_CRC0_DATA_R32,
                                CRC0_R_CR32, r_cr);
                        REG_GET(OTG_CRC0_DATA_G32,
                                CRC0_G_Y32, g_y);
                        REG_GET(OTG_CRC0_DATA_B32,
                                CRC0_B_CB32, b_cb);
                        break;
                case 1:
                        /* OTG_CRC1_DATA_R32/G32/B32 has the CRC32 results */
                        REG_GET(OTG_CRC1_DATA_R32,
                                CRC1_R_CR32, r_cr);
                        REG_GET(OTG_CRC1_DATA_G32,
                                CRC1_G_Y32, g_y);
                        REG_GET(OTG_CRC1_DATA_B32,
                                CRC1_B_CB32, b_cb);
                        break;
                default:
                        return false;
                }
        } else {
                switch (idx) {
                case 0:
                        /* OTG_CRC0_DATA_RG has the CRC16 results for the red and green component */
                        REG_GET_2(OTG_CRC0_DATA_RG,
                                CRC0_R_CR, r_cr,
                                CRC0_G_Y, g_y);

                        /* OTG_CRC0_DATA_B has the CRC16 results for the blue component */
                        REG_GET(OTG_CRC0_DATA_B,
                                CRC0_B_CB, b_cb);
                        break;
                case 1:
                        /* OTG_CRC1_DATA_RG has the CRC16 results for the red and green component */
                        REG_GET_2(OTG_CRC1_DATA_RG,
                                CRC1_R_CR, r_cr,
                                CRC1_G_Y, g_y);

                        /* OTG_CRC1_DATA_B has the CRC16 results for the blue component */
                        REG_GET(OTG_CRC1_DATA_B,
                                CRC1_B_CB, b_cb);
                        break;
                default:
                        return false;
                        }
        }

        return true;
}

bool optc35_configure_crc(struct timing_generator *optc,
                                 const struct crc_params *params)
{
        struct optc *optc1 = DCN10TG_FROM_TG(optc);

        /* Cannot configure crc on a CRTC that is disabled */
        if (!optc1_is_tg_enabled(optc))
                return false;

        if (!params->enable || params->reset)
                REG_WRITE(OTG_CRC_CNTL, 0);

        if (!params->enable)
                return true;

        /* Program frame boundaries */
        switch (params->crc_eng_inst) {
        case 0:
                /* Window A x axis start and end. */
                REG_UPDATE_2(OTG_CRC0_WINDOWA_X_CONTROL,
                                OTG_CRC0_WINDOWA_X_START, params->windowa_x_start,
                                OTG_CRC0_WINDOWA_X_END, params->windowa_x_end);

                /* Window A y axis start and end. */
                REG_UPDATE_2(OTG_CRC0_WINDOWA_Y_CONTROL,
                                OTG_CRC0_WINDOWA_Y_START, params->windowa_y_start,
                                OTG_CRC0_WINDOWA_Y_END, params->windowa_y_end);

                /* Window B x axis start and end. */
                REG_UPDATE_2(OTG_CRC0_WINDOWB_X_CONTROL,
                                OTG_CRC0_WINDOWB_X_START, params->windowb_x_start,
                                OTG_CRC0_WINDOWB_X_END, params->windowb_x_end);

                /* Window B y axis start and end. */
                REG_UPDATE_2(OTG_CRC0_WINDOWB_Y_CONTROL,
                                OTG_CRC0_WINDOWB_Y_START, params->windowb_y_start,
                                OTG_CRC0_WINDOWB_Y_END, params->windowb_y_end);

                if (optc1->base.ctx->dc->debug.otg_crc_db && optc1->tg_mask->OTG_CRC_WINDOW_DB_EN != 0)
                        REG_UPDATE_4(OTG_CRC_CNTL,
                                        OTG_CRC_CONT_EN, params->continuous_mode ? 1 : 0,
                                        OTG_CRC0_SELECT, params->selection,
                                        OTG_CRC_EN, 1,
                                        OTG_CRC_WINDOW_DB_EN, 1);
                else
                        REG_UPDATE_3(OTG_CRC_CNTL,
                                        OTG_CRC_CONT_EN, params->continuous_mode ? 1 : 0,
                                        OTG_CRC0_SELECT, params->selection,
                                        OTG_CRC_EN, 1);
                break;
        case 1:
                /* Window A x axis start and end. */
                REG_UPDATE_2(OTG_CRC1_WINDOWA_X_CONTROL,
                                OTG_CRC1_WINDOWA_X_START, params->windowa_x_start,
                                OTG_CRC1_WINDOWA_X_END, params->windowa_x_end);

                /* Window A y axis start and end. */
                REG_UPDATE_2(OTG_CRC1_WINDOWA_Y_CONTROL,
                                OTG_CRC1_WINDOWA_Y_START, params->windowa_y_start,
                                OTG_CRC1_WINDOWA_Y_END, params->windowa_y_end);

                /* Window B x axis start and end. */
                REG_UPDATE_2(OTG_CRC1_WINDOWB_X_CONTROL,
                                OTG_CRC1_WINDOWB_X_START, params->windowb_x_start,
                                OTG_CRC1_WINDOWB_X_END, params->windowb_x_end);

                /* Window B y axis start and end. */
                REG_UPDATE_2(OTG_CRC1_WINDOWB_Y_CONTROL,
                                OTG_CRC1_WINDOWB_Y_START, params->windowb_y_start,
                                OTG_CRC1_WINDOWB_Y_END, params->windowb_y_end);

                if (optc1->base.ctx->dc->debug.otg_crc_db && optc1->tg_mask->OTG_CRC_WINDOW_DB_EN != 0)
                        REG_UPDATE_4(OTG_CRC_CNTL,
                                        OTG_CRC_CONT_EN, params->continuous_mode ? 1 : 0,
                                        OTG_CRC1_SELECT, params->selection,
                                        OTG_CRC_EN, 1,
                                        OTG_CRC_WINDOW_DB_EN, 1);
                else
                        REG_UPDATE_3(OTG_CRC_CNTL,
                                        OTG_CRC_CONT_EN, params->continuous_mode ? 1 : 0,
                                        OTG_CRC1_SELECT, params->selection,
                                        OTG_CRC_EN, 1);
                break;
        default:
                return false;
        }
        if (optc1->tg_mask->OTG_CRC_POLY_SEL != 0) {
                REG_UPDATE(OTG_CRC_CNTL,
                                OTG_CRC_POLY_SEL, params->crc_poly_mode);
        }
        return true;
}

static void optc35_setup_manual_trigger(struct timing_generator *optc)
{
        if (!optc || !optc->ctx)
                return;

        struct optc *optc1 = DCN10TG_FROM_TG(optc);
        struct dc *dc = optc->ctx->dc;

        if (dc->caps.dmub_caps.mclk_sw && !dc->debug.disable_fams)
                dc_dmub_srv_set_drr_manual_trigger_cmd(dc, optc->inst);
        else {
                /*
                 * MIN_MASK_EN is gone and MASK is now always enabled.
                 *
                 * To get it to it work with manual trigger we need to make sure
                 * we program the correct bit.
                 */
                REG_UPDATE_4(OTG_V_TOTAL_CONTROL,
                                OTG_V_TOTAL_MIN_SEL, 1,
                                OTG_V_TOTAL_MAX_SEL, 1,
                                OTG_FORCE_LOCK_ON_EVENT, 0,
                                OTG_SET_V_TOTAL_MIN_MASK, (1 << 1)); /* TRIGA */

                // Setup manual flow control for EOF via TRIG_A
                if (optc->funcs && optc->funcs->setup_manual_trigger)
                        optc->funcs->setup_manual_trigger(optc);
        }
}

void optc35_set_drr(
        struct timing_generator *optc,
        const struct drr_params *params)
{
        if (!optc || !params)
                return;

        struct optc *optc1 = DCN10TG_FROM_TG(optc);
        uint32_t max_otg_v_total = optc1->max_v_total - 1;

        if (params != NULL &&
                params->vertical_total_max > 0 &&
                params->vertical_total_min > 0) {

                if (params->vertical_total_mid != 0) {

                        REG_SET(OTG_V_TOTAL_MID, 0,
                                OTG_V_TOTAL_MID, params->vertical_total_mid - 1);

                        REG_UPDATE_2(OTG_V_TOTAL_CONTROL,
                                        OTG_VTOTAL_MID_REPLACING_MAX_EN, 1,
                                        OTG_VTOTAL_MID_FRAME_NUM,
                                        (uint8_t)params->vertical_total_mid_frame_num);

                }

                if (optc->funcs && optc->funcs->set_vtotal_min_max)
                        optc->funcs->set_vtotal_min_max(optc,
                                params->vertical_total_min - 1, params->vertical_total_max - 1);
                optc35_setup_manual_trigger(optc);
        } else {
                REG_UPDATE_4(OTG_V_TOTAL_CONTROL,
                                OTG_SET_V_TOTAL_MIN_MASK, 0,
                                OTG_V_TOTAL_MIN_SEL, 0,
                                OTG_V_TOTAL_MAX_SEL, 0,
                                OTG_FORCE_LOCK_ON_EVENT, 0);

                if (optc->funcs && optc->funcs->set_vtotal_min_max)
                        optc->funcs->set_vtotal_min_max(optc, 0, 0);
        }

        REG_WRITE(OTG_V_COUNT_STOP_CONTROL, max_otg_v_total);
        REG_WRITE(OTG_V_COUNT_STOP_CONTROL2, 0);
}

void optc35_set_long_vtotal(
        struct timing_generator *optc,
        const struct long_vtotal_params *params)
{
        if (!optc || !params)
                return;

        struct optc *optc1 = DCN10TG_FROM_TG(optc);
        uint32_t vcount_stop_timer = 0, vcount_stop = 0;
        uint32_t max_otg_v_total = optc1->max_v_total - 1;

        if (params->vertical_total_min <= max_otg_v_total && params->vertical_total_max <= max_otg_v_total)
                return;

        if (params->vertical_total_max == 0 || params->vertical_total_min == 0) {
                REG_UPDATE_4(OTG_V_TOTAL_CONTROL,
                                                OTG_SET_V_TOTAL_MIN_MASK, 0,
                                                OTG_V_TOTAL_MIN_SEL, 0,
                                                OTG_V_TOTAL_MAX_SEL, 0,
                                                OTG_FORCE_LOCK_ON_EVENT, 0);

                if (optc->funcs && optc->funcs->set_vtotal_min_max)
                        optc->funcs->set_vtotal_min_max(optc, 0, 0);
        } else if (params->vertical_total_max == params->vertical_total_min) {
                vcount_stop = params->vertical_blank_start;
                vcount_stop_timer = params->vertical_total_max - max_otg_v_total;

                REG_UPDATE_4(OTG_V_TOTAL_CONTROL,
                                OTG_V_TOTAL_MIN_SEL, 1,
                                OTG_V_TOTAL_MAX_SEL, 1,
                                OTG_FORCE_LOCK_ON_EVENT, 0,
                                OTG_SET_V_TOTAL_MIN_MASK, 0);

                if (optc->funcs && optc->funcs->set_vtotal_min_max)
                        optc->funcs->set_vtotal_min_max(optc, max_otg_v_total, max_otg_v_total);

                REG_WRITE(OTG_V_COUNT_STOP_CONTROL, vcount_stop);
                REG_WRITE(OTG_V_COUNT_STOP_CONTROL2, vcount_stop_timer);
        } else {
                // Variable rate, keep DRR trigger mask
                if (params->vertical_total_min > max_otg_v_total) {
                        // cannot be supported
                        // If MAX_OTG_V_COUNT < DRR trigger < v_total_min < v_total_max,
                        // DRR trigger will drop the vtotal counting directly to a new frame.
                        // But it should trigger between v_total_min and v_total_max.
                        ASSERT(0);

                        REG_UPDATE_4(OTG_V_TOTAL_CONTROL,
                                OTG_SET_V_TOTAL_MIN_MASK, 0,
                                OTG_V_TOTAL_MIN_SEL, 0,
                                OTG_V_TOTAL_MAX_SEL, 0,
                                OTG_FORCE_LOCK_ON_EVENT, 0);

                        if (optc->funcs && optc->funcs->set_vtotal_min_max)
                                optc->funcs->set_vtotal_min_max(optc, 0, 0);

                        REG_WRITE(OTG_V_COUNT_STOP_CONTROL, max_otg_v_total);
                        REG_WRITE(OTG_V_COUNT_STOP_CONTROL2, 0);
                } else {
                        // For total_min <= MAX_OTG_V_COUNT and total_max > MAX_OTG_V_COUNT
                        vcount_stop = params->vertical_total_min;
                        vcount_stop_timer = params->vertical_total_max - max_otg_v_total;

                        // Example:
                        // params->vertical_total_min 1000
                        // params->vertical_total_max 2000
                        // MAX_OTG_V_COUNT_STOP = 1500
                        //
                        // If DRR event not happened,
                        //     time     0,1,2,3,4,...1000,1001,........,1500,1501,1502,     ...1999
                        //     vcount   0,1,2,3,4....1000...................,1001,1002,1003,...1399
                        //     vcount2                       0,1,2,3,4,..499,
                        // else (DRR event happened, ex : at line 1004)
                        //     time    0,1,2,3,4,...1000,1001.....1004, 0
                        //     vcount  0,1,2,3,4....1000,.............. 0 (new frame)
                        //     vcount2                      0,1,2,   3, -
                        if (optc->funcs && optc->funcs->set_vtotal_min_max)
                                optc->funcs->set_vtotal_min_max(optc,
                                        params->vertical_total_min - 1, max_otg_v_total);
                        optc35_setup_manual_trigger(optc);

                        REG_WRITE(OTG_V_COUNT_STOP_CONTROL, vcount_stop);
                        REG_WRITE(OTG_V_COUNT_STOP_CONTROL2, vcount_stop_timer);
                }
        }
}

void optc35_wait_otg_disable(struct timing_generator *optc)
{
        struct optc *optc1;
        uint32_t is_master_en;

        if (!optc || !optc->ctx)
                return;

        optc1 = DCN10TG_FROM_TG(optc);

        REG_GET(OTG_CONTROL, OTG_MASTER_EN, &is_master_en);
        if (!is_master_en)
                REG_WAIT(OTG_CLOCK_CONTROL, OTG_CURRENT_MASTER_EN_STATE, 0, 1, 100000);
}

static const struct timing_generator_funcs dcn35_tg_funcs = {
                .validate_timing = optc1_validate_timing,
                .program_timing = optc1_program_timing,
                .setup_vertical_interrupt0 = optc1_setup_vertical_interrupt0,
                .setup_vertical_interrupt1 = optc1_setup_vertical_interrupt1,
                .setup_vertical_interrupt2 = optc1_setup_vertical_interrupt2,
                .program_global_sync = optc1_program_global_sync,
                .enable_crtc = optc35_enable_crtc,
                .disable_crtc = optc35_disable_crtc,
                .immediate_disable_crtc = optc31_immediate_disable_crtc,
                .phantom_crtc_post_enable = optc35_phantom_crtc_post_enable,
                /* used by enable_timing_synchronization. Not need for FPGA */
                .is_counter_moving = optc1_is_counter_moving,
                .get_position = optc1_get_position,
                .get_frame_count = optc1_get_vblank_counter,
                .get_scanoutpos = optc1_get_crtc_scanoutpos,
                .get_otg_active_size = optc1_get_otg_active_size,
                .set_early_control = optc1_set_early_control,
                /* used by enable_timing_synchronization. Not need for FPGA */
                .wait_for_state = optc1_wait_for_state,
                .set_blank_color = optc3_program_blank_color,
                .did_triggered_reset_occur = optc1_did_triggered_reset_occur,
                .triplebuffer_lock = optc3_triplebuffer_lock,
                .triplebuffer_unlock = optc2_triplebuffer_unlock,
                .enable_reset_trigger = optc1_enable_reset_trigger,
                .enable_crtc_reset = optc1_enable_crtc_reset,
                .disable_reset_trigger = optc1_disable_reset_trigger,
                .lock = optc3_lock,
                .unlock = optc1_unlock,
                .lock_doublebuffer_enable = optc3_lock_doublebuffer_enable,
                .lock_doublebuffer_disable = optc3_lock_doublebuffer_disable,
                .enable_optc_clock = optc1_enable_optc_clock,
                .set_drr = optc35_set_drr,
                .get_last_used_drr_vtotal = optc2_get_last_used_drr_vtotal,
                .set_vtotal_min_max = optc1_set_vtotal_min_max,
                .set_static_screen_control = optc1_set_static_screen_control,
                .program_stereo = optc1_program_stereo,
                .is_stereo_left_eye = optc1_is_stereo_left_eye,
                .tg_init = optc3_tg_init,
                .is_tg_enabled = optc1_is_tg_enabled,
                .is_optc_underflow_occurred = optc1_is_optc_underflow_occurred,
                .clear_optc_underflow = optc1_clear_optc_underflow,
                .setup_global_swap_lock = NULL,
                .get_crc = optc35_get_crc,
                .configure_crc = optc35_configure_crc,
                .set_dsc_config = optc3_set_dsc_config,
                .get_dsc_status = optc2_get_dsc_status,
                .set_dwb_source = NULL,
                .set_odm_bypass = optc32_set_odm_bypass,
                .set_odm_combine = optc35_set_odm_combine,
                .get_optc_source = optc2_get_optc_source,
                .wait_otg_disable = optc35_wait_otg_disable,
                .set_h_timing_div_manual_mode = optc32_set_h_timing_div_manual_mode,
                .set_out_mux = optc3_set_out_mux,
                .set_drr_trigger_window = optc3_set_drr_trigger_window,
                .set_vtotal_change_limit = optc3_set_vtotal_change_limit,
                .set_gsl = optc2_set_gsl,
                .set_gsl_source_select = optc2_set_gsl_source_select,
                .set_vtg_params = optc1_set_vtg_params,
                .program_manual_trigger = optc2_program_manual_trigger,
                .setup_manual_trigger = optc2_setup_manual_trigger,
                .get_hw_timing = optc1_get_hw_timing,
                .init_odm = optc3_init_odm,
                .set_long_vtotal = optc35_set_long_vtotal,
                .is_two_pixels_per_container = optc1_is_two_pixels_per_container,
                .read_otg_state = optc31_read_otg_state,
                .optc_read_reg_state = optc31_read_reg_state,
};

void dcn35_timing_generator_init(struct optc *optc1)
{
        optc1->base.funcs = &dcn35_tg_funcs;

        optc1->max_h_total = optc1->tg_mask->OTG_H_TOTAL + 1;
        optc1->max_v_total = optc1->tg_mask->OTG_V_TOTAL + 1;

        optc1->min_h_blank = 32;
        optc1->min_v_blank = 3;
        optc1->min_v_blank_interlace = 5;
        optc1->min_h_sync_width = 4;
        optc1->min_v_sync_width = 1;
        optc1->max_frame_count = 0xFFFFFF;

        dcn35_timing_generator_set_fgcg(
                optc1, CTX->dc->debug.enable_fine_grain_clock_gating.bits.optc);
}

void dcn35_timing_generator_set_fgcg(struct optc *optc1, bool enable)
{
        REG_UPDATE(OPTC_CLOCK_CONTROL, OPTC_FGCG_REP_DIS, !enable);
}