root/sys/dev/pci/drm/amd/display/dc/core/dc_stream.c
/*
 * Copyright 2012-15 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 "dm_services.h"
#include "basics/dc_common.h"
#include "dc.h"
#include "core_types.h"
#include "resource.h"
#include "ipp.h"
#include "timing_generator.h"
#include "dc_dmub_srv.h"
#include "dc_state_priv.h"
#include "dc_stream_priv.h"

#define DC_LOGGER dc->ctx->logger
#ifndef MIN
#define MIN(X, Y) ((X) < (Y) ? (X) : (Y))
#endif
#ifndef MAX
#define MAX(x, y) ((x > y) ? x : y)
#endif

/*******************************************************************************
 * Private functions
 ******************************************************************************/
void update_stream_signal(struct dc_stream_state *stream, struct dc_sink *sink)
{
        if (sink->sink_signal == SIGNAL_TYPE_NONE)
                stream->signal = stream->link->connector_signal;
        else
                stream->signal = sink->sink_signal;

        if (dc_is_dvi_signal(stream->signal)) {
                if (stream->ctx->dc->caps.dual_link_dvi &&
                        (stream->timing.pix_clk_100hz / 10) > TMDS_MAX_PIXEL_CLOCK &&
                        sink->sink_signal != SIGNAL_TYPE_DVI_SINGLE_LINK)
                        stream->signal = SIGNAL_TYPE_DVI_DUAL_LINK;
                else
                        stream->signal = SIGNAL_TYPE_DVI_SINGLE_LINK;
        }
}

bool dc_stream_construct(struct dc_stream_state *stream,
        struct dc_sink *dc_sink_data)
{
        uint32_t i = 0;

        stream->sink = dc_sink_data;
        dc_sink_retain(dc_sink_data);

        stream->ctx = dc_sink_data->ctx;
        stream->link = dc_sink_data->link;
        stream->sink_patches = dc_sink_data->edid_caps.panel_patch;
        stream->converter_disable_audio = dc_sink_data->converter_disable_audio;
        stream->qs_bit = dc_sink_data->edid_caps.qs_bit;
        stream->qy_bit = dc_sink_data->edid_caps.qy_bit;

        /* Copy audio modes */
        /* TODO - Remove this translation */
        for (i = 0; i < (dc_sink_data->edid_caps.audio_mode_count); i++) {
                stream->audio_info.modes[i].channel_count = dc_sink_data->edid_caps.audio_modes[i].channel_count;
                stream->audio_info.modes[i].format_code = dc_sink_data->edid_caps.audio_modes[i].format_code;
                stream->audio_info.modes[i].sample_rates.all = dc_sink_data->edid_caps.audio_modes[i].sample_rate;
                stream->audio_info.modes[i].sample_size = dc_sink_data->edid_caps.audio_modes[i].sample_size;
        }
        stream->audio_info.mode_count = dc_sink_data->edid_caps.audio_mode_count;
        stream->audio_info.audio_latency = dc_sink_data->edid_caps.audio_latency;
        stream->audio_info.video_latency = dc_sink_data->edid_caps.video_latency;
        memmove(
                stream->audio_info.display_name,
                dc_sink_data->edid_caps.display_name,
                AUDIO_INFO_DISPLAY_NAME_SIZE_IN_CHARS);
        stream->audio_info.manufacture_id = dc_sink_data->edid_caps.manufacturer_id;
        stream->audio_info.product_id = dc_sink_data->edid_caps.product_id;
        stream->audio_info.flags.all = dc_sink_data->edid_caps.speaker_flags;

        if (dc_sink_data->dc_container_id != NULL) {
                struct dc_container_id *dc_container_id = dc_sink_data->dc_container_id;

                stream->audio_info.port_id[0] = dc_container_id->portId[0];
                stream->audio_info.port_id[1] = dc_container_id->portId[1];
        } else {
                /* TODO - WindowDM has implemented,
                other DMs need Unhardcode port_id */
                stream->audio_info.port_id[0] = 0x5558859e;
                stream->audio_info.port_id[1] = 0xd989449;
        }

        /* EDID CAP translation for HDMI 2.0 */
        stream->timing.flags.LTE_340MCSC_SCRAMBLE = dc_sink_data->edid_caps.lte_340mcsc_scramble;

        memset(&stream->timing.dsc_cfg, 0, sizeof(stream->timing.dsc_cfg));
        stream->timing.dsc_cfg.num_slices_h = 0;
        stream->timing.dsc_cfg.num_slices_v = 0;
        stream->timing.dsc_cfg.bits_per_pixel = 128;
        stream->timing.dsc_cfg.block_pred_enable = 1;
        stream->timing.dsc_cfg.linebuf_depth = 9;
        stream->timing.dsc_cfg.version_minor = 2;
        stream->timing.dsc_cfg.ycbcr422_simple = 0;

        update_stream_signal(stream, dc_sink_data);

        stream->out_transfer_func.type = TF_TYPE_BYPASS;

        dc_stream_assign_stream_id(stream);

        return true;
}

void dc_stream_destruct(struct dc_stream_state *stream)
{
        dc_sink_release(stream->sink);
}

void dc_stream_assign_stream_id(struct dc_stream_state *stream)
{
        /* MSB is reserved to indicate phantoms */
        stream->stream_id = stream->ctx->dc_stream_id_count;
        stream->ctx->dc_stream_id_count++;
}

void dc_stream_retain(struct dc_stream_state *stream)
{
        kref_get(&stream->refcount);
}

static void dc_stream_free(struct kref *kref)
{
        struct dc_stream_state *stream = container_of(kref, struct dc_stream_state, refcount);

        dc_stream_destruct(stream);
        kfree(stream);
}

void dc_stream_release(struct dc_stream_state *stream)
{
        if (stream != NULL) {
                kref_put(&stream->refcount, dc_stream_free);
        }
}

struct dc_stream_state *dc_create_stream_for_sink(
                struct dc_sink *sink)
{
        struct dc_stream_state *stream;

        if (sink == NULL)
                return NULL;

        stream = kzalloc(sizeof(struct dc_stream_state), GFP_ATOMIC);
        if (stream == NULL)
                goto alloc_fail;

        if (dc_stream_construct(stream, sink) == false)
                goto construct_fail;

        kref_init(&stream->refcount);

        return stream;

construct_fail:
        kfree(stream);

alloc_fail:
        return NULL;
}

struct dc_stream_state *dc_copy_stream(const struct dc_stream_state *stream)
{
        struct dc_stream_state *new_stream;

        new_stream = kmemdup(stream, sizeof(struct dc_stream_state), GFP_KERNEL);
        if (!new_stream)
                return NULL;

        if (new_stream->sink)
                dc_sink_retain(new_stream->sink);

        dc_stream_assign_stream_id(new_stream);

        /* If using dynamic encoder assignment, wait till stream committed to assign encoder. */
        if (new_stream->ctx->dc->res_pool->funcs->link_encs_assign &&
                        !new_stream->ctx->dc->config.unify_link_enc_assignment)
                new_stream->link_enc = NULL;

        kref_init(&new_stream->refcount);

        return new_stream;
}

/**
 * dc_stream_get_status() - Get current stream status of the given stream state
 * @stream: The stream to get the stream status for.
 *
 * The given stream is expected to exist in dc->current_state. Otherwise, NULL
 * will be returned.
 */
struct dc_stream_status *dc_stream_get_status(
        struct dc_stream_state *stream)
{
        struct dc *dc = stream->ctx->dc;
        return dc_state_get_stream_status(dc->current_state, stream);
}

void program_cursor_attributes(
        struct dc *dc,
        struct dc_stream_state *stream)
{
        int i;
        struct resource_context *res_ctx;
        struct pipe_ctx *pipe_to_program = NULL;

        if (!stream)
                return;

        res_ctx = &dc->current_state->res_ctx;

        for (i = 0; i < MAX_PIPES; i++) {
                struct pipe_ctx *pipe_ctx = &res_ctx->pipe_ctx[i];

                if (pipe_ctx->stream != stream)
                        continue;

                if (!pipe_to_program) {
                        pipe_to_program = pipe_ctx;
                        dc->hwss.cursor_lock(dc, pipe_to_program, true);
                        if (pipe_to_program->next_odm_pipe)
                                dc->hwss.cursor_lock(dc, pipe_to_program->next_odm_pipe, true);
                }

                dc->hwss.set_cursor_attribute(pipe_ctx);
                if (dc->ctx->dmub_srv)
                        dc_send_update_cursor_info_to_dmu(pipe_ctx, i);
                if (dc->hwss.set_cursor_sdr_white_level)
                        dc->hwss.set_cursor_sdr_white_level(pipe_ctx);
        }

        if (pipe_to_program) {
                dc->hwss.cursor_lock(dc, pipe_to_program, false);
                if (pipe_to_program->next_odm_pipe)
                        dc->hwss.cursor_lock(dc, pipe_to_program->next_odm_pipe, false);
        }
}

/*
 * dc_stream_check_cursor_attributes() - Check validitity of cursor attributes and surface address
 */
bool dc_stream_check_cursor_attributes(
        const struct dc_stream_state *stream,
        struct dc_state *state,
        const struct dc_cursor_attributes *attributes)
{
        const struct dc *dc;

        unsigned int max_cursor_size;

        if (NULL == stream) {
                dm_error("DC: dc_stream is NULL!\n");
                return false;
        }
        if (NULL == attributes) {
                dm_error("DC: attributes is NULL!\n");
                return false;
        }

        if (attributes->address.quad_part == 0) {
                dm_output_to_console("DC: Cursor address is 0!\n");
                return false;
        }

        dc = stream->ctx->dc;

        /* SubVP is not compatible with HW cursor larger than what can fit in cursor SRAM.
         * Therefore, if cursor is greater than this, fallback to SW cursor.
         */
        if (dc->debug.allow_sw_cursor_fallback && dc->res_pool->funcs->get_max_hw_cursor_size) {
                max_cursor_size = dc->res_pool->funcs->get_max_hw_cursor_size(dc, state, stream);
                max_cursor_size = max_cursor_size * max_cursor_size * 4;

                if (attributes->height * attributes->width * 4 > max_cursor_size) {
                        return false;
                }
        }

        return true;
}

/*
 * dc_stream_set_cursor_attributes() - Update cursor attributes and set cursor surface address
 */
bool dc_stream_set_cursor_attributes(
        struct dc_stream_state *stream,
        const struct dc_cursor_attributes *attributes)
{
        bool result = false;

        if (!stream)
                return false;

        if (dc_stream_check_cursor_attributes(stream, stream->ctx->dc->current_state, attributes)) {
                stream->cursor_attributes = *attributes;
                result = true;
        }

        return result;
}

bool dc_stream_program_cursor_attributes(
        struct dc_stream_state *stream,
        const struct dc_cursor_attributes *attributes)
{
        struct dc  *dc;
        bool reset_idle_optimizations = false;

        if (!stream)
                return false;

        dc = stream->ctx->dc;

        if (dc_stream_set_cursor_attributes(stream, attributes)) {
                dc_z10_restore(dc);
                /* disable idle optimizations while updating cursor */
                if (dc->idle_optimizations_allowed) {
                        dc_allow_idle_optimizations(dc, false);
                        reset_idle_optimizations = true;
                }

                program_cursor_attributes(dc, stream);

                /* re-enable idle optimizations if necessary */
                if (reset_idle_optimizations && !dc->debug.disable_dmub_reallow_idle)
                        dc_allow_idle_optimizations(dc, true);

                return true;
        }

        return false;
}

void program_cursor_position(
        struct dc *dc,
        struct dc_stream_state *stream)
{
        int i;
        struct resource_context *res_ctx;
        struct pipe_ctx *pipe_to_program = NULL;

        if (!stream)
                return;

        res_ctx = &dc->current_state->res_ctx;

        for (i = 0; i < MAX_PIPES; i++) {
                struct pipe_ctx *pipe_ctx = &res_ctx->pipe_ctx[i];

                if (pipe_ctx->stream != stream ||
                                (!pipe_ctx->plane_res.mi  && !pipe_ctx->plane_res.hubp) ||
                                !pipe_ctx->plane_state ||
                                (!pipe_ctx->plane_res.xfm && !pipe_ctx->plane_res.dpp) ||
                                (!pipe_ctx->plane_res.ipp && !pipe_ctx->plane_res.dpp))
                        continue;

                if (!pipe_to_program) {
                        pipe_to_program = pipe_ctx;
                        dc->hwss.cursor_lock(dc, pipe_to_program, true);
                }

                dc->hwss.set_cursor_position(pipe_ctx);
                if (dc->ctx->dmub_srv)
                        dc_send_update_cursor_info_to_dmu(pipe_ctx, i);
        }

        if (pipe_to_program)
                dc->hwss.cursor_lock(dc, pipe_to_program, false);
}

bool dc_stream_set_cursor_position(
        struct dc_stream_state *stream,
        const struct dc_cursor_position *position)
{
        if (NULL == stream) {
                dm_error("DC: dc_stream is NULL!\n");
                return false;
        }

        if (NULL == position) {
                dm_error("DC: cursor position is NULL!\n");
                return false;
        }

        stream->cursor_position = *position;


        return true;
}

bool dc_stream_program_cursor_position(
        struct dc_stream_state *stream,
        const struct dc_cursor_position *position)
{
        struct dc *dc;
        bool reset_idle_optimizations = false;
        const struct dc_cursor_position *old_position;

        if (!stream)
                return false;

        old_position = &stream->cursor_position;
        dc = stream->ctx->dc;

        if (dc_stream_set_cursor_position(stream, position)) {
                dc_z10_restore(dc);

                /* disable idle optimizations if enabling cursor */
                if (dc->idle_optimizations_allowed &&
                    (!old_position->enable || dc->debug.exit_idle_opt_for_cursor_updates) &&
                    position->enable) {
                        dc_allow_idle_optimizations(dc, false);
                        reset_idle_optimizations = true;
                }

                program_cursor_position(dc, stream);
                /* re-enable idle optimizations if necessary */
                if (reset_idle_optimizations && !dc->debug.disable_dmub_reallow_idle)
                        dc_allow_idle_optimizations(dc, true);

                /* apply/update visual confirm */
                if (dc->debug.visual_confirm == VISUAL_CONFIRM_HW_CURSOR) {
                        /* update software state */
                        int i;

                        for (i = 0; i < dc->res_pool->pipe_count; i++) {
                                struct pipe_ctx *pipe_ctx = &dc->current_state->res_ctx.pipe_ctx[i];

                                /* adjust visual confirm color for all pipes with current stream */
                                if (stream == pipe_ctx->stream) {
                                        get_cursor_visual_confirm_color(pipe_ctx, &(pipe_ctx->visual_confirm_color));

                                        /* programming hardware */
                                        if (pipe_ctx->plane_state)
                                                dc->hwss.update_visual_confirm_color(dc, pipe_ctx,
                                                                pipe_ctx->plane_res.hubp->mpcc_id);
                                }
                        }
                }

                return true;
        }

        return false;
}

bool dc_stream_add_writeback(struct dc *dc,
                struct dc_stream_state *stream,
                struct dc_writeback_info *wb_info)
{
        bool isDrc = false;
        int i = 0;
        struct dwbc *dwb;

        if (stream == NULL) {
                dm_error("DC: dc_stream is NULL!\n");
                return false;
        }

        if (wb_info == NULL) {
                dm_error("DC: dc_writeback_info is NULL!\n");
                return false;
        }

        if (wb_info->dwb_pipe_inst >= MAX_DWB_PIPES) {
                dm_error("DC: writeback pipe is invalid!\n");
                return false;
        }

        dc_exit_ips_for_hw_access(dc);

        wb_info->dwb_params.out_transfer_func = &stream->out_transfer_func;

        dwb = dc->res_pool->dwbc[wb_info->dwb_pipe_inst];
        dwb->dwb_is_drc = false;

        /* recalculate and apply DML parameters */

        for (i = 0; i < stream->num_wb_info; i++) {
                /*dynamic update*/
                if (stream->writeback_info[i].wb_enabled &&
                        stream->writeback_info[i].dwb_pipe_inst == wb_info->dwb_pipe_inst) {
                        stream->writeback_info[i] = *wb_info;
                        isDrc = true;
                }
        }

        if (!isDrc) {
                ASSERT(stream->num_wb_info + 1 <= MAX_DWB_PIPES);
                stream->writeback_info[stream->num_wb_info++] = *wb_info;
        }

        if (dc->hwss.enable_writeback) {
                struct dc_stream_status *stream_status = dc_stream_get_status(stream);
                struct dwbc *dwb = dc->res_pool->dwbc[wb_info->dwb_pipe_inst];
                if (stream_status)
                        dwb->otg_inst = stream_status->primary_otg_inst;
        }

        if (!dc->hwss.update_bandwidth(dc, dc->current_state)) {
                dm_error("DC: update_bandwidth failed!\n");
                return false;
        }

        /* enable writeback */
        if (dc->hwss.enable_writeback) {
                struct dwbc *dwb = dc->res_pool->dwbc[wb_info->dwb_pipe_inst];

                if (dwb->funcs->is_enabled(dwb)) {
                        /* writeback pipe already enabled, only need to update */
                        dc->hwss.update_writeback(dc, wb_info, dc->current_state);
                } else {
                        /* Enable writeback pipe from scratch*/
                        dc->hwss.enable_writeback(dc, wb_info, dc->current_state);
                }
        }

        return true;
}

bool dc_stream_fc_disable_writeback(struct dc *dc,
                struct dc_stream_state *stream,
                uint32_t dwb_pipe_inst)
{
        struct dwbc *dwb = dc->res_pool->dwbc[dwb_pipe_inst];

        if (stream == NULL) {
                dm_error("DC: dc_stream is NULL!\n");
                return false;
        }

        if (dwb_pipe_inst >= MAX_DWB_PIPES) {
                dm_error("DC: writeback pipe is invalid!\n");
                return false;
        }

        if (stream->num_wb_info > MAX_DWB_PIPES) {
                dm_error("DC: num_wb_info is invalid!\n");
                return false;
        }

        dc_exit_ips_for_hw_access(dc);

        if (dwb->funcs->set_fc_enable)
                dwb->funcs->set_fc_enable(dwb, DWB_FRAME_CAPTURE_DISABLE);

        return true;
}

/**
 * dc_stream_remove_writeback() - Disables writeback and removes writeback info.
 * @dc: Display core control structure.
 * @stream: Display core stream state.
 * @dwb_pipe_inst: Display writeback pipe.
 *
 * Return: returns true on success, false otherwise.
 */
bool dc_stream_remove_writeback(struct dc *dc,
                struct dc_stream_state *stream,
                uint32_t dwb_pipe_inst)
{
        unsigned int i, j;
        if (stream == NULL) {
                dm_error("DC: dc_stream is NULL!\n");
                return false;
        }

        if (dwb_pipe_inst >= MAX_DWB_PIPES) {
                dm_error("DC: writeback pipe is invalid!\n");
                return false;
        }

        if (stream->num_wb_info > MAX_DWB_PIPES) {
                dm_error("DC: num_wb_info is invalid!\n");
                return false;
        }

        /* remove writeback info for disabled writeback pipes from stream */
        for (i = 0, j = 0; i < stream->num_wb_info; i++) {
                if (stream->writeback_info[i].wb_enabled) {

                        if (stream->writeback_info[i].dwb_pipe_inst == dwb_pipe_inst)
                                stream->writeback_info[i].wb_enabled = false;

                        /* trim the array */
                        if (j < i) {
                                memcpy(&stream->writeback_info[j], &stream->writeback_info[i],
                                                sizeof(struct dc_writeback_info));
                                j++;
                        }
                }
        }
        stream->num_wb_info = j;

        /* recalculate and apply DML parameters */
        if (!dc->hwss.update_bandwidth(dc, dc->current_state)) {
                dm_error("DC: update_bandwidth failed!\n");
                return false;
        }

        dc_exit_ips_for_hw_access(dc);

        /* disable writeback */
        if (dc->hwss.disable_writeback) {
                struct dwbc *dwb = dc->res_pool->dwbc[dwb_pipe_inst];

                if (dwb->funcs->is_enabled(dwb))
                        dc->hwss.disable_writeback(dc, dwb_pipe_inst);
        }

        return true;
}

uint32_t dc_stream_get_vblank_counter(const struct dc_stream_state *stream)
{
        uint8_t i;
        struct dc  *dc = stream->ctx->dc;
        struct resource_context *res_ctx =
                &dc->current_state->res_ctx;

        dc_exit_ips_for_hw_access(dc);

        for (i = 0; i < MAX_PIPES; i++) {
                struct timing_generator *tg = res_ctx->pipe_ctx[i].stream_res.tg;

                if (res_ctx->pipe_ctx[i].stream != stream || !tg)
                        continue;

                return tg->funcs->get_frame_count(tg);
        }

        return 0;
}

bool dc_stream_send_dp_sdp(const struct dc_stream_state *stream,
                const uint8_t *custom_sdp_message,
                unsigned int sdp_message_size)
{
        int i;
        struct dc  *dc;
        struct resource_context *res_ctx;

        if (stream == NULL) {
                dm_error("DC: dc_stream is NULL!\n");
                return false;
        }

        dc = stream->ctx->dc;
        res_ctx = &dc->current_state->res_ctx;

        dc_exit_ips_for_hw_access(dc);

        for (i = 0; i < MAX_PIPES; i++) {
                struct pipe_ctx *pipe_ctx = &res_ctx->pipe_ctx[i];

                if (pipe_ctx->stream != stream)
                        continue;

                if (dc->hwss.send_immediate_sdp_message != NULL)
                        dc->hwss.send_immediate_sdp_message(pipe_ctx,
                                                                custom_sdp_message,
                                                                sdp_message_size);
                else
                        DC_LOG_WARNING("%s:send_immediate_sdp_message not implemented on this ASIC\n",
                        __func__);

        }

        return true;
}

bool dc_stream_get_scanoutpos(const struct dc_stream_state *stream,
                                  uint32_t *v_blank_start,
                                  uint32_t *v_blank_end,
                                  uint32_t *h_position,
                                  uint32_t *v_position)
{
        uint8_t i;
        bool ret = false;
        struct dc  *dc;
        struct resource_context *res_ctx;

        if (!stream->ctx)
                return false;

        dc = stream->ctx->dc;
        res_ctx = &dc->current_state->res_ctx;

        dc_exit_ips_for_hw_access(dc);

        for (i = 0; i < MAX_PIPES; i++) {
                struct timing_generator *tg = res_ctx->pipe_ctx[i].stream_res.tg;

                if (res_ctx->pipe_ctx[i].stream != stream || !tg)
                        continue;

                tg->funcs->get_scanoutpos(tg,
                                          v_blank_start,
                                          v_blank_end,
                                          h_position,
                                          v_position);

                ret = true;
                break;
        }

        return ret;
}

bool dc_stream_dmdata_status_done(struct dc *dc, struct dc_stream_state *stream)
{
        struct pipe_ctx *pipe = NULL;
        int i;

        if (!dc->hwss.dmdata_status_done)
                return false;

        for (i = 0; i < MAX_PIPES; i++) {
                pipe = &dc->current_state->res_ctx.pipe_ctx[i];
                if (pipe->stream == stream)
                        break;
        }
        /* Stream not found, by default we'll assume HUBP fetched dm data */
        if (i == MAX_PIPES)
                return true;

        dc_exit_ips_for_hw_access(dc);

        return dc->hwss.dmdata_status_done(pipe);
}

bool dc_stream_set_dynamic_metadata(struct dc *dc,
                struct dc_stream_state *stream,
                struct dc_dmdata_attributes *attr)
{
        struct pipe_ctx *pipe_ctx = NULL;
        struct hubp *hubp;
        int i;

        /* Dynamic metadata is only supported on HDMI or DP */
        if (!dc_is_hdmi_signal(stream->signal) && !dc_is_dp_signal(stream->signal))
                return false;

        /* Check hardware support */
        if (!dc->hwss.program_dmdata_engine)
                return false;

        for (i = 0; i < MAX_PIPES; i++) {
                pipe_ctx = &dc->current_state->res_ctx.pipe_ctx[i];
                if (pipe_ctx->stream == stream)
                        break;
        }

        if (i == MAX_PIPES)
                return false;

        hubp = pipe_ctx->plane_res.hubp;
        if (hubp == NULL)
                return false;

        pipe_ctx->stream->dmdata_address = attr->address;

        dc_exit_ips_for_hw_access(dc);

        dc->hwss.program_dmdata_engine(pipe_ctx);

        if (hubp->funcs->dmdata_set_attributes != NULL &&
                        pipe_ctx->stream->dmdata_address.quad_part != 0) {
                hubp->funcs->dmdata_set_attributes(hubp, attr);
        }

        return true;
}

enum dc_status dc_stream_add_dsc_to_resource(struct dc *dc,
                struct dc_state *state,
                struct dc_stream_state *stream)
{
        if (dc->res_pool->funcs->add_dsc_to_stream_resource) {
                return dc->res_pool->funcs->add_dsc_to_stream_resource(dc, state, stream);
        } else {
                return DC_NO_DSC_RESOURCE;
        }
}

struct pipe_ctx *dc_stream_get_pipe_ctx(struct dc_stream_state *stream)
{
        int i = 0;

        for (i = 0; i < MAX_PIPES; i++) {
                struct pipe_ctx *pipe = &stream->ctx->dc->current_state->res_ctx.pipe_ctx[i];

                if (pipe->stream == stream)
                        return pipe;
        }

        return NULL;
}

void dc_stream_log(const struct dc *dc, const struct dc_stream_state *stream)
{
        DC_LOG_DC(
                        "core_stream 0x%p: src: %d, %d, %d, %d; dst: %d, %d, %d, %d, colorSpace:%d\n",
                        stream,
                        stream->src.x,
                        stream->src.y,
                        stream->src.width,
                        stream->src.height,
                        stream->dst.x,
                        stream->dst.y,
                        stream->dst.width,
                        stream->dst.height,
                        stream->output_color_space);
        DC_LOG_DC(
                        "\tpix_clk_khz: %d, h_total: %d, v_total: %d, pixel_encoding:%s, color_depth:%s\n",
                        stream->timing.pix_clk_100hz / 10,
                        stream->timing.h_total,
                        stream->timing.v_total,
                        dc_pixel_encoding_to_str(stream->timing.pixel_encoding),
                        dc_color_depth_to_str(stream->timing.display_color_depth));
        DC_LOG_DC(
                        "\tlink: %d\n",
                        stream->link->link_index);

        DC_LOG_DC(
                        "\tdsc: %d, mst_pbn: %d\n",
                        stream->timing.flags.DSC,
                        stream->timing.dsc_cfg.mst_pbn);

        if (stream->sink) {
                if (stream->sink->sink_signal != SIGNAL_TYPE_VIRTUAL &&
                        stream->sink->sink_signal != SIGNAL_TYPE_NONE) {

                        DC_LOG_DC(
                                        "\tdispname: %s signal: %x\n",
                                        stream->sink->edid_caps.display_name,
                                        stream->signal);
                }
        }
}

/*
*       dc_stream_get_3dlut()
*       Requirements:
*       1. Is stream already owns an RMCM instance, return it.
*       2. If it doesn't and we don't need to allocate, return NULL.
*       3. If there's a free RMCM instance, assign to stream and return it.
*       4. If no free RMCM instances, return NULL.
*/

struct dc_rmcm_3dlut *dc_stream_get_3dlut_for_stream(
        const struct dc *dc,
        const struct dc_stream_state *stream,
        bool allocate_one)
{
        unsigned int num_rmcm = dc->caps.color.mpc.num_rmcm_3dluts;

        // see if one is allocated for this stream
        for (int i = 0; i < num_rmcm; i++) {
                if (dc->res_pool->rmcm_3dlut[i].isInUse &&
                        dc->res_pool->rmcm_3dlut[i].stream == stream)
                        return &dc->res_pool->rmcm_3dlut[i];
        }

        //case: not found one, and dont need to allocate
        if (!allocate_one)
                return NULL;

        //see if there is an unused 3dlut, allocate
        for (int i = 0; i < num_rmcm; i++) {
                if (!dc->res_pool->rmcm_3dlut[i].isInUse) {
                        dc->res_pool->rmcm_3dlut[i].isInUse = true;
                        dc->res_pool->rmcm_3dlut[i].stream = stream;
                        return &dc->res_pool->rmcm_3dlut[i];
                }
        }

        //dont have a 3dlut
        return NULL;
}


void dc_stream_release_3dlut_for_stream(
        const struct dc *dc,
        const struct dc_stream_state *stream)
{
        struct dc_rmcm_3dlut *rmcm_3dlut =
                dc_stream_get_3dlut_for_stream(dc, stream, false);

        if (rmcm_3dlut) {
                rmcm_3dlut->isInUse = false;
                rmcm_3dlut->stream  = NULL;
                rmcm_3dlut->protection_bits = 0;
        }
}


void dc_stream_init_rmcm_3dlut(struct dc *dc)
{
        unsigned int num_rmcm = dc->caps.color.mpc.num_rmcm_3dluts;

        for (int i = 0; i < num_rmcm; i++) {
                dc->res_pool->rmcm_3dlut[i].isInUse = false;
                dc->res_pool->rmcm_3dlut[i].stream = NULL;
                dc->res_pool->rmcm_3dlut[i].protection_bits = 0;
        }
}

/*
 * Finds the greatest index in refresh_rate_hz that contains a value <= refresh
 */
static int dc_stream_get_nearest_smallest_index(struct dc_stream_state *stream, int refresh)
{
        for (int i = 0; i < (LUMINANCE_DATA_TABLE_SIZE - 1); ++i) {
                if ((stream->lumin_data.refresh_rate_hz[i] <= refresh) && (refresh < stream->lumin_data.refresh_rate_hz[i + 1])) {
                        return i;
                }
        }
        return 9;
}

/*
 * Finds a corresponding brightness for a given refresh rate between 2 given indices, where index1 < index2
 */
static int dc_stream_get_brightness_millinits_linear_interpolation (struct dc_stream_state *stream,
                                                                     int index1,
                                                                     int index2,
                                                                     int refresh_hz)
{
        long long slope = 0;
        if (stream->lumin_data.refresh_rate_hz[index2] != stream->lumin_data.refresh_rate_hz[index1]) {
                slope = (stream->lumin_data.luminance_millinits[index2] - stream->lumin_data.luminance_millinits[index1]) /
                            (stream->lumin_data.refresh_rate_hz[index2] - stream->lumin_data.refresh_rate_hz[index1]);
        }

        int y_intercept = stream->lumin_data.luminance_millinits[index2] - slope * stream->lumin_data.refresh_rate_hz[index2];

        return (y_intercept + refresh_hz * slope);
}

/*
 * Finds a corresponding refresh rate for a given brightness between 2 given indices, where index1 < index2
 */
static int dc_stream_get_refresh_hz_linear_interpolation (struct dc_stream_state *stream,
                                                           int index1,
                                                           int index2,
                                                           int brightness_millinits)
{
        long long slope = 1;
        if (stream->lumin_data.refresh_rate_hz[index2] != stream->lumin_data.refresh_rate_hz[index1]) {
                slope = (stream->lumin_data.luminance_millinits[index2] - stream->lumin_data.luminance_millinits[index1]) /
                                (stream->lumin_data.refresh_rate_hz[index2] - stream->lumin_data.refresh_rate_hz[index1]);
        }

        int y_intercept = stream->lumin_data.luminance_millinits[index2] - slope * stream->lumin_data.refresh_rate_hz[index2];

        return ((int)div64_s64((brightness_millinits - y_intercept), slope));
}

/*
 * Finds the current brightness in millinits given a refresh rate
 */
static int dc_stream_get_brightness_millinits_from_refresh (struct dc_stream_state *stream, int refresh_hz)
{
        int nearest_smallest_index = dc_stream_get_nearest_smallest_index(stream, refresh_hz);
        int nearest_smallest_value = stream->lumin_data.refresh_rate_hz[nearest_smallest_index];

        if (nearest_smallest_value == refresh_hz)
                return stream->lumin_data.luminance_millinits[nearest_smallest_index];

        if (nearest_smallest_index >= 9)
                return dc_stream_get_brightness_millinits_linear_interpolation(stream, nearest_smallest_index - 1, nearest_smallest_index, refresh_hz);

        if (nearest_smallest_value == stream->lumin_data.refresh_rate_hz[nearest_smallest_index + 1])
                return stream->lumin_data.luminance_millinits[nearest_smallest_index];

        return dc_stream_get_brightness_millinits_linear_interpolation(stream, nearest_smallest_index, nearest_smallest_index + 1, refresh_hz);
}

/*
 * Finds the lowest/highest refresh rate (depending on search_for_max_increase)
 * that can be achieved from starting_refresh_hz while staying
 * within flicker criteria
 */
static int dc_stream_calculate_flickerless_refresh_rate(struct dc_stream_state *stream,
                                                         int current_brightness,
                                                         int starting_refresh_hz,
                                                         bool is_gaming,
                                                         bool search_for_max_increase)
{
        int nearest_smallest_index = dc_stream_get_nearest_smallest_index(stream, starting_refresh_hz);

        int flicker_criteria_millinits = is_gaming ?
                                         stream->lumin_data.flicker_criteria_milli_nits_GAMING :
                                         stream->lumin_data.flicker_criteria_milli_nits_STATIC;

        int safe_upper_bound = current_brightness + flicker_criteria_millinits;
        int safe_lower_bound = current_brightness - flicker_criteria_millinits;
        int lumin_millinits_temp = 0;

        int offset = -1;
        if (search_for_max_increase) {
                offset = 1;
        }

        /*
         * Increments up or down by 1 depending on search_for_max_increase
         */
        for (int i = nearest_smallest_index; (i > 0 && !search_for_max_increase) || (i < (LUMINANCE_DATA_TABLE_SIZE - 1) && search_for_max_increase); i += offset) {

                lumin_millinits_temp = stream->lumin_data.luminance_millinits[i + offset];

                if ((lumin_millinits_temp >= safe_upper_bound) || (lumin_millinits_temp <= safe_lower_bound)) {

                        if (stream->lumin_data.refresh_rate_hz[i + offset] == stream->lumin_data.refresh_rate_hz[i])
                                return stream->lumin_data.refresh_rate_hz[i];

                        int target_brightness = (stream->lumin_data.luminance_millinits[i + offset] >= (current_brightness + flicker_criteria_millinits)) ?
                                                                                        current_brightness + flicker_criteria_millinits :
                                                                                        current_brightness - flicker_criteria_millinits;

                        int refresh = 0;

                        /*
                         * Need the second input to be < third input for dc_stream_get_refresh_hz_linear_interpolation
                         */
                        if (search_for_max_increase)
                                refresh = dc_stream_get_refresh_hz_linear_interpolation(stream, i, i + offset, target_brightness);
                        else
                                refresh = dc_stream_get_refresh_hz_linear_interpolation(stream, i + offset, i, target_brightness);

                        if (refresh == stream->lumin_data.refresh_rate_hz[i + offset])
                                return stream->lumin_data.refresh_rate_hz[i + offset];

                        return refresh;
                }
        }

        if (search_for_max_increase)
                return (int)div64_s64((long long)stream->timing.pix_clk_100hz*100, stream->timing.v_total*(long long)stream->timing.h_total);
        else
                return stream->lumin_data.refresh_rate_hz[0];
}

/*
 * Gets the max delta luminance within a specified refresh range
 */
static int dc_stream_get_max_delta_lumin_millinits(struct dc_stream_state *stream, int hz1, int hz2, bool isGaming)
{
        int lower_refresh_brightness = dc_stream_get_brightness_millinits_from_refresh (stream, hz1);
        int higher_refresh_brightness = dc_stream_get_brightness_millinits_from_refresh (stream, hz2);

        int min = lower_refresh_brightness;
        int max = higher_refresh_brightness;

        /*
         * Static screen, therefore no need to scan through array
         */
        if (!isGaming) {
                if (lower_refresh_brightness >= higher_refresh_brightness) {
                        return lower_refresh_brightness - higher_refresh_brightness;
                }
                return higher_refresh_brightness - lower_refresh_brightness;
        }

        min = MIN(lower_refresh_brightness, higher_refresh_brightness);
        max = MAX(lower_refresh_brightness, higher_refresh_brightness);

        int nearest_smallest_index = dc_stream_get_nearest_smallest_index(stream, hz1);

        for (; nearest_smallest_index < (LUMINANCE_DATA_TABLE_SIZE - 1) &&
                        stream->lumin_data.refresh_rate_hz[nearest_smallest_index + 1] <= hz2 ; nearest_smallest_index++) {
                min = MIN(min, stream->lumin_data.luminance_millinits[nearest_smallest_index + 1]);
                max = MAX(max, stream->lumin_data.luminance_millinits[nearest_smallest_index + 1]);
        }

        return (max - min);
}

/*
 * Determines the max flickerless instant vtotal delta for a stream.
 * Determines vtotal increase/decrease based on the bool "increase"
 */
static unsigned int dc_stream_get_max_flickerless_instant_vtotal_delta(struct dc_stream_state *stream, bool is_gaming, bool increase)
{
        if (stream->timing.v_total * stream->timing.h_total == 0)
                return 0;

        int current_refresh_hz = (int)div64_s64((long long)stream->timing.pix_clk_100hz*100, stream->timing.v_total*(long long)stream->timing.h_total);

        int safe_refresh_hz = dc_stream_calculate_flickerless_refresh_rate(stream,
                                                         dc_stream_get_brightness_millinits_from_refresh(stream, current_refresh_hz),
                                                         current_refresh_hz,
                                                         is_gaming,
                                                         increase);

        int safe_refresh_v_total = (int)div64_s64((long long)stream->timing.pix_clk_100hz*100, safe_refresh_hz*(long long)stream->timing.h_total);

        if (increase)
                return (((int) stream->timing.v_total - safe_refresh_v_total) >= 0) ? (stream->timing.v_total - safe_refresh_v_total) : 0;

        return ((safe_refresh_v_total - (int) stream->timing.v_total) >= 0) ? (safe_refresh_v_total - stream->timing.v_total) : 0;
}

/*
 * Finds the highest refresh rate that can be achieved
 * from starting_refresh_hz while staying within flicker criteria
 */
int dc_stream_calculate_max_flickerless_refresh_rate(struct dc_stream_state *stream, int starting_refresh_hz, bool is_gaming)
{
        if (!stream->lumin_data.is_valid)
                return 0;

        int current_brightness = dc_stream_get_brightness_millinits_from_refresh(stream, starting_refresh_hz);

        return dc_stream_calculate_flickerless_refresh_rate(stream,
                                                            current_brightness,
                                                            starting_refresh_hz,
                                                            is_gaming,
                                                            true);
}

/*
 * Finds the lowest refresh rate that can be achieved
 * from starting_refresh_hz while staying within flicker criteria
 */
int dc_stream_calculate_min_flickerless_refresh_rate(struct dc_stream_state *stream, int starting_refresh_hz, bool is_gaming)
{
        if (!stream->lumin_data.is_valid)
                        return 0;

        int current_brightness = dc_stream_get_brightness_millinits_from_refresh(stream, starting_refresh_hz);

        return dc_stream_calculate_flickerless_refresh_rate(stream,
                                                            current_brightness,
                                                            starting_refresh_hz,
                                                            is_gaming,
                                                            false);
}

/*
 * Determines if there will be a flicker when moving between 2 refresh rates
 */
bool dc_stream_is_refresh_rate_range_flickerless(struct dc_stream_state *stream, int hz1, int hz2, bool is_gaming)
{

        /*
         * Assume that we wont flicker if there is invalid data
         */
        if (!stream->lumin_data.is_valid)
                return false;

        int dl = dc_stream_get_max_delta_lumin_millinits(stream, hz1, hz2, is_gaming);

        int flicker_criteria_millinits = (is_gaming) ?
                                          stream->lumin_data.flicker_criteria_milli_nits_GAMING :
                                          stream->lumin_data.flicker_criteria_milli_nits_STATIC;

        return (dl <= flicker_criteria_millinits);
}

/*
 * Determines the max instant vtotal delta increase that can be applied without
 * flickering for a given stream
 */
unsigned int dc_stream_get_max_flickerless_instant_vtotal_decrease(struct dc_stream_state *stream,
                                                                          bool is_gaming)
{
        if (!stream->lumin_data.is_valid)
                return 0;

        return dc_stream_get_max_flickerless_instant_vtotal_delta(stream, is_gaming, true);
}

/*
 * Determines the max instant vtotal delta decrease that can be applied without
 * flickering for a given stream
 */
unsigned int dc_stream_get_max_flickerless_instant_vtotal_increase(struct dc_stream_state *stream,
                                                                          bool is_gaming)
{
        if (!stream->lumin_data.is_valid)
                return 0;

        return dc_stream_get_max_flickerless_instant_vtotal_delta(stream, is_gaming, false);
}

bool dc_stream_is_cursor_limit_pending(struct dc *dc, struct dc_stream_state *stream)
{
        bool is_limit_pending = false;

        if (dc->current_state)
                is_limit_pending = dc_state_get_stream_cursor_subvp_limit(stream, dc->current_state);

        return is_limit_pending;
}

bool dc_stream_can_clear_cursor_limit(struct dc *dc, struct dc_stream_state *stream)
{
        bool can_clear_limit = false;

        if (dc->current_state)
                can_clear_limit = dc_state_get_stream_cursor_subvp_limit(stream, dc->current_state) &&
                                (stream->hw_cursor_req ||
                                !stream->cursor_position.enable ||
                                dc_stream_check_cursor_attributes(stream, dc->current_state, &stream->cursor_attributes));

        return can_clear_limit;
}