/*
 * Copyright © 2006-2010 Intel Corporation
 * Copyright (c) 2006 Dave Airlie <airlied@linux.ie>
 *
 * 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 (including the next
 * paragraph) 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 AUTHORS OR COPYRIGHT HOLDERS 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:
 *      Eric Anholt <eric@anholt.net>
 *      Dave Airlie <airlied@linux.ie>
 *      Jesse Barnes <jesse.barnes@intel.com>
 *      Chris Wilson <chris@chris-wilson.co.uk>
 */

#include <linux/kernel.h>
#include <linux/pwm.h>

#include <drm/drm_edid.h>
#include <drm/drm_print.h>

#include "intel_backlight.h"
#include "intel_connector.h"
#include "intel_display_core.h"
#include "intel_display_driver.h"
#include "intel_display_types.h"
#include "intel_drrs.h"
#include "intel_panel.h"
#include "intel_quirks.h"
#include "intel_vrr.h"

bool intel_panel_use_ssc(struct intel_display *display)
{
        if (display->params.panel_use_ssc >= 0)
                return display->params.panel_use_ssc != 0;
        return display->vbt.lvds_use_ssc &&
                !intel_has_quirk(display, QUIRK_LVDS_SSC_DISABLE);
}

const struct drm_display_mode *
intel_panel_preferred_fixed_mode(struct intel_connector *connector)
{
        return list_first_entry_or_null(&connector->panel.fixed_modes,
                                        struct drm_display_mode, head);
}

static bool is_best_fixed_mode(struct intel_connector *connector,
                               int vrefresh, int fixed_mode_vrefresh,
                               const struct drm_display_mode *best_mode)
{
        /* we want to always return something */
        if (!best_mode)
                return true;

        /*
         * With VRR always pick a mode with equal/higher than requested
         * vrefresh, which we can then reduce to match the requested
         * vrefresh by extending the vblank length.
         */
        if (intel_vrr_is_in_range(connector, vrefresh) &&
            intel_vrr_is_in_range(connector, fixed_mode_vrefresh) &&
            fixed_mode_vrefresh < vrefresh)
                return false;

        /* pick the fixed_mode that is closest in terms of vrefresh */
        return abs(fixed_mode_vrefresh - vrefresh) <
                abs(drm_mode_vrefresh(best_mode) - vrefresh);
}

const struct drm_display_mode *
intel_panel_fixed_mode(struct intel_connector *connector,
                       const struct drm_display_mode *mode)
{
        const struct drm_display_mode *fixed_mode, *best_mode = NULL;
        int vrefresh = drm_mode_vrefresh(mode);

        list_for_each_entry(fixed_mode, &connector->panel.fixed_modes, head) {
                int fixed_mode_vrefresh = drm_mode_vrefresh(fixed_mode);

                if (is_best_fixed_mode(connector, vrefresh,
                                       fixed_mode_vrefresh, best_mode))
                        best_mode = fixed_mode;
        }

        return best_mode;
}

static bool is_alt_drrs_mode(const struct drm_display_mode *mode,
                             const struct drm_display_mode *preferred_mode)
{
        return drm_mode_match(mode, preferred_mode,
                              DRM_MODE_MATCH_TIMINGS |
                              DRM_MODE_MATCH_FLAGS |
                              DRM_MODE_MATCH_3D_FLAGS) &&
                mode->clock != preferred_mode->clock;
}

static bool is_alt_fixed_mode(const struct drm_display_mode *mode,
                              const struct drm_display_mode *preferred_mode)
{
        u32 sync_flags = DRM_MODE_FLAG_PHSYNC | DRM_MODE_FLAG_NHSYNC |
                DRM_MODE_FLAG_PVSYNC | DRM_MODE_FLAG_NVSYNC;

        return (mode->flags & ~sync_flags) == (preferred_mode->flags & ~sync_flags) &&
                mode->hdisplay == preferred_mode->hdisplay &&
                mode->vdisplay == preferred_mode->vdisplay;
}

const struct drm_display_mode *
intel_panel_downclock_mode(struct intel_connector *connector,
                           const struct drm_display_mode *adjusted_mode)
{
        const struct drm_display_mode *fixed_mode, *best_mode = NULL;
        int min_vrefresh = connector->panel.vbt.seamless_drrs_min_refresh_rate;
        int max_vrefresh = drm_mode_vrefresh(adjusted_mode);

        /* pick the fixed_mode with the lowest refresh rate */
        list_for_each_entry(fixed_mode, &connector->panel.fixed_modes, head) {
                int vrefresh = drm_mode_vrefresh(fixed_mode);

                if (is_alt_drrs_mode(fixed_mode, adjusted_mode) &&
                    vrefresh >= min_vrefresh && vrefresh < max_vrefresh) {
                        max_vrefresh = vrefresh;
                        best_mode = fixed_mode;
                }
        }

        return best_mode;
}

const struct drm_display_mode *
intel_panel_highest_mode(struct intel_connector *connector,
                         const struct drm_display_mode *adjusted_mode)
{
        const struct drm_display_mode *fixed_mode, *best_mode = adjusted_mode;

        /* pick the fixed_mode that has the highest clock */
        list_for_each_entry(fixed_mode, &connector->panel.fixed_modes, head) {
                if (fixed_mode->clock > best_mode->clock)
                        best_mode = fixed_mode;
        }

        return best_mode;
}

int intel_panel_get_modes(struct intel_connector *connector)
{
        const struct drm_display_mode *fixed_mode;
        int num_modes = 0;

        list_for_each_entry(fixed_mode, &connector->panel.fixed_modes, head) {
                struct drm_display_mode *mode;

                mode = drm_mode_duplicate(connector->base.dev, fixed_mode);
                if (mode) {
                        drm_mode_probed_add(&connector->base, mode);
                        num_modes++;
                }
        }

        return num_modes;
}

static bool has_drrs_modes(struct intel_connector *connector)
{
        const struct drm_display_mode *mode1;

        list_for_each_entry(mode1, &connector->panel.fixed_modes, head) {
                const struct drm_display_mode *mode2 = mode1;

                list_for_each_entry_continue(mode2, &connector->panel.fixed_modes, head) {
                        if (is_alt_drrs_mode(mode1, mode2))
                                return true;
                }
        }

        return false;
}

enum drrs_type intel_panel_drrs_type(struct intel_connector *connector)
{
        return connector->panel.vbt.drrs_type;
}

int intel_panel_compute_config(struct intel_connector *connector,
                               struct drm_display_mode *adjusted_mode)
{
        const struct drm_display_mode *fixed_mode =
                intel_panel_fixed_mode(connector, adjusted_mode);
        int vrefresh, fixed_mode_vrefresh;
        bool is_vrr;

        if (!fixed_mode)
                return 0;

        vrefresh = drm_mode_vrefresh(adjusted_mode);
        fixed_mode_vrefresh = drm_mode_vrefresh(fixed_mode);

        /*
         * Assume that we shouldn't muck about with the
         * timings if they don't land in the VRR range.
         */
        is_vrr = intel_vrr_is_in_range(connector, vrefresh) &&
                intel_vrr_is_in_range(connector, fixed_mode_vrefresh);

        if (!is_vrr) {
                /*
                 * We don't want to lie too much to the user about the refresh
                 * rate they're going to get. But we have to allow a bit of latitude
                 * for Xorg since it likes to automagically cook up modes with slightly
                 * off refresh rates.
                 */
                if (abs(vrefresh - fixed_mode_vrefresh) > 1) {
                        drm_dbg_kms(connector->base.dev,
                                    "[CONNECTOR:%d:%s] Requested mode vrefresh (%d Hz) does not match fixed mode vrefresh (%d Hz)\n",
                                    connector->base.base.id, connector->base.name,
                                    vrefresh, fixed_mode_vrefresh);

                        return -EINVAL;
                }
        }

        drm_mode_copy(adjusted_mode, fixed_mode);

        if (is_vrr && fixed_mode_vrefresh != vrefresh)
                adjusted_mode->vtotal =
                        DIV_ROUND_CLOSEST(adjusted_mode->clock * 1000,
                                          adjusted_mode->htotal * vrefresh);

        drm_mode_set_crtcinfo(adjusted_mode, 0);

        return 0;
}

static void intel_panel_add_edid_alt_fixed_modes(struct intel_connector *connector)
{
        struct intel_display *display = to_intel_display(connector);
        const struct drm_display_mode *preferred_mode =
                intel_panel_preferred_fixed_mode(connector);
        struct drm_display_mode *mode, *next;

        list_for_each_entry_safe(mode, next, &connector->base.probed_modes, head) {
                if (!is_alt_fixed_mode(mode, preferred_mode))
                        continue;

                drm_dbg_kms(display->drm,
                            "[CONNECTOR:%d:%s] using alternate EDID fixed mode: " DRM_MODE_FMT "\n",
                            connector->base.base.id, connector->base.name,
                            DRM_MODE_ARG(mode));

                list_move_tail(&mode->head, &connector->panel.fixed_modes);
        }
}

static void intel_panel_add_edid_preferred_mode(struct intel_connector *connector)
{
        struct intel_display *display = to_intel_display(connector);
        struct drm_display_mode *scan, *fixed_mode = NULL;

        if (list_empty(&connector->base.probed_modes))
                return;

        /* make sure the preferred mode is first */
        list_for_each_entry(scan, &connector->base.probed_modes, head) {
                if (scan->type & DRM_MODE_TYPE_PREFERRED) {
                        fixed_mode = scan;
                        break;
                }
        }

        if (!fixed_mode)
                fixed_mode = list_first_entry(&connector->base.probed_modes,
                                              typeof(*fixed_mode), head);

        drm_dbg_kms(display->drm,
                    "[CONNECTOR:%d:%s] using %s EDID fixed mode: " DRM_MODE_FMT "\n",
                    connector->base.base.id, connector->base.name,
                    fixed_mode->type & DRM_MODE_TYPE_PREFERRED ? "preferred" : "first",
                    DRM_MODE_ARG(fixed_mode));

        fixed_mode->type |= DRM_MODE_TYPE_PREFERRED;

        list_move_tail(&fixed_mode->head, &connector->panel.fixed_modes);
}

static void intel_panel_destroy_probed_modes(struct intel_connector *connector)
{
        struct intel_display *display = to_intel_display(connector);
        struct drm_display_mode *mode, *next;

        list_for_each_entry_safe(mode, next, &connector->base.probed_modes, head) {
                drm_dbg_kms(display->drm,
                            "[CONNECTOR:%d:%s] not using EDID mode: " DRM_MODE_FMT "\n",
                            connector->base.base.id, connector->base.name,
                            DRM_MODE_ARG(mode));
                list_del(&mode->head);
                drm_mode_destroy(display->drm, mode);
        }
}

void intel_panel_add_edid_fixed_modes(struct intel_connector *connector,
                                      bool use_alt_fixed_modes)
{
        intel_panel_add_edid_preferred_mode(connector);
        if (intel_panel_preferred_fixed_mode(connector) && use_alt_fixed_modes)
                intel_panel_add_edid_alt_fixed_modes(connector);
        intel_panel_destroy_probed_modes(connector);
}

static void intel_panel_add_fixed_mode(struct intel_connector *connector,
                                       struct drm_display_mode *fixed_mode,
                                       const char *type)
{
        struct intel_display *display = to_intel_display(connector);
        struct drm_display_info *info = &connector->base.display_info;

        if (!fixed_mode)
                return;

        fixed_mode->type |= DRM_MODE_TYPE_PREFERRED | DRM_MODE_TYPE_DRIVER;

        info->width_mm = fixed_mode->width_mm;
        info->height_mm = fixed_mode->height_mm;

        drm_dbg_kms(display->drm, "[CONNECTOR:%d:%s] using %s fixed mode: " DRM_MODE_FMT "\n",
                    connector->base.base.id, connector->base.name, type,
                    DRM_MODE_ARG(fixed_mode));

        list_add_tail(&fixed_mode->head, &connector->panel.fixed_modes);
}

void intel_panel_add_vbt_lfp_fixed_mode(struct intel_connector *connector)
{
        struct intel_display *display = to_intel_display(connector);
        const struct drm_display_mode *mode;

        mode = connector->panel.vbt.lfp_vbt_mode;
        if (!mode)
                return;

        intel_panel_add_fixed_mode(connector,
                                   drm_mode_duplicate(display->drm, mode),
                                   "VBT LFP");
}

void intel_panel_add_vbt_sdvo_fixed_mode(struct intel_connector *connector)
{
        struct intel_display *display = to_intel_display(connector);
        const struct drm_display_mode *mode;

        mode = connector->panel.vbt.sdvo_lvds_vbt_mode;
        if (!mode)
                return;

        intel_panel_add_fixed_mode(connector,
                                   drm_mode_duplicate(display->drm, mode),
                                   "VBT SDVO");
}

void intel_panel_add_encoder_fixed_mode(struct intel_connector *connector,
                                        struct intel_encoder *encoder)
{
        intel_panel_add_fixed_mode(connector,
                                   intel_encoder_current_mode(encoder),
                                   "current (BIOS)");
}

enum drm_connector_status
intel_panel_detect(struct drm_connector *connector, bool force)
{
        struct intel_display *display = to_intel_display(connector->dev);

        if (!intel_display_device_enabled(display))
                return connector_status_disconnected;

        if (!intel_display_driver_check_access(display))
                return connector->status;

        return connector_status_connected;
}

enum drm_mode_status
intel_panel_mode_valid(struct intel_connector *connector,
                       const struct drm_display_mode *mode)
{
        const struct drm_display_mode *fixed_mode =
                intel_panel_fixed_mode(connector, mode);

        if (!fixed_mode)
                return MODE_OK;

        if (mode->hdisplay != fixed_mode->hdisplay)
                return MODE_PANEL;

        if (mode->vdisplay != fixed_mode->vdisplay)
                return MODE_PANEL;

        if (drm_mode_vrefresh(mode) != drm_mode_vrefresh(fixed_mode))
                return MODE_PANEL;

        return MODE_OK;
}

void intel_panel_init_alloc(struct intel_connector *connector)
{
        struct intel_panel *panel = &connector->panel;

        connector->panel.vbt.panel_type = -1;
        connector->panel.vbt.backlight.controller = -1;
        INIT_LIST_HEAD(&panel->fixed_modes);
}

int intel_panel_init(struct intel_connector *connector,
                     const struct drm_edid *fixed_edid)
{
        struct intel_panel *panel = &connector->panel;

        panel->fixed_edid = fixed_edid;

        intel_backlight_init_funcs(panel);

        if (!has_drrs_modes(connector))
                connector->panel.vbt.drrs_type = DRRS_TYPE_NONE;

        drm_dbg_kms(connector->base.dev,
                    "[CONNECTOR:%d:%s] DRRS type: %s\n",
                    connector->base.base.id, connector->base.name,
                    intel_drrs_type_str(intel_panel_drrs_type(connector)));

        return 0;
}

void intel_panel_fini(struct intel_connector *connector)
{
        struct intel_panel *panel = &connector->panel;
        struct drm_display_mode *fixed_mode, *next;

        if (!IS_ERR_OR_NULL(panel->fixed_edid))
                drm_edid_free(panel->fixed_edid);

        intel_backlight_destroy(panel);

        intel_bios_fini_panel(panel);

        list_for_each_entry_safe(fixed_mode, next, &panel->fixed_modes, head) {
                list_del(&fixed_mode->head);
                drm_mode_destroy(connector->base.dev, fixed_mode);
        }
}

/*
 * If the panel was already enabled at probe, and we took over the state, the
 * panel prepared state is out of sync, and the panel followers won't be
 * notified. We need to call drm_panel_prepare() on enabled panels.
 *
 * It would be natural to handle this e.g. in the connector ->sync_state hook at
 * intel_modeset_readout_hw_state(), but that's unfortunately too early. We
 * don't have drm_connector::kdev at that time. For now, figure out the state at
 * ->late_register, and sync there.
 */
static void intel_panel_sync_state(struct intel_connector *connector)
{
        struct intel_display *display = to_intel_display(connector);
        struct drm_connector_state *conn_state;
        struct intel_crtc *crtc;
        int ret;

        ret = drm_modeset_lock(&display->drm->mode_config.connection_mutex, NULL);
        if (ret)
                return;

        conn_state = connector->base.state;

        crtc = to_intel_crtc(conn_state->crtc);
        if (crtc) {
                struct intel_crtc_state *crtc_state;

                crtc_state = to_intel_crtc_state(crtc->base.state);

                if (crtc_state->hw.active) {
                        drm_dbg_kms(display->drm, "[CONNECTOR:%d:%s] Panel prepare\n",
                                    connector->base.base.id, connector->base.name);
                        intel_panel_prepare(crtc_state, conn_state);
                }
        }

        drm_modeset_unlock(&display->drm->mode_config.connection_mutex);
}

static const struct drm_panel_funcs dummy_panel_funcs = {
};

int intel_panel_register(struct intel_connector *connector)
{
        struct intel_display *display = to_intel_display(connector);
        struct intel_panel *panel = &connector->panel;
        int ret;

        ret = intel_backlight_device_register(connector);
        if (ret)
                return ret;

        if (connector->base.connector_type == DRM_MODE_CONNECTOR_DSI ||
            connector->base.connector_type == DRM_MODE_CONNECTOR_eDP) {
                struct device *dev = connector->base.kdev;
                struct drm_panel *base;

                /* Sanity check. */
                if (drm_WARN_ON(display->drm, !dev))
                        goto out;

                /*
                 * We need drm_connector::kdev for allocating the panel, to make
                 * drm_panel_add_follower() lookups work. The kdev is
                 * initialized in drm_sysfs_connector_add(), just before the
                 * connector .late_register() hooks. So we can't allocate the
                 * panel at connector init time, and can't allocate struct
                 * intel_panel with a drm_panel sub-struct. For now, use
                 * __devm_drm_panel_alloc() directly.
                 *
                 * The lookups also depend on drm_connector::fwnode being set in
                 * intel_acpi_assign_connector_fwnodes(). However, if that's
                 * missing, it will gracefully lead to -EPROBE_DEFER in
                 * drm_panel_add_follower().
                 */
                base = __devm_drm_panel_alloc(dev, sizeof(*base), 0,
                                              &dummy_panel_funcs,
                                              connector->base.connector_type);
                if (IS_ERR(base)) {
                        ret = PTR_ERR(base);
                        goto err;
                }

                panel->base = base;

                drm_panel_add(panel->base);

                drm_dbg_kms(display->drm, "[CONNECTOR:%d:%s] Registered panel device '%s', has fwnode: %s\n",
                            connector->base.base.id, connector->base.name,
                            dev_name(dev), str_yes_no(dev_fwnode(dev)));

                intel_panel_sync_state(connector);
        }

out:
        return 0;

err:
        intel_backlight_device_unregister(connector);

        return ret;
}

void intel_panel_unregister(struct intel_connector *connector)
{
        struct intel_panel *panel = &connector->panel;

        if (panel->base)
                drm_panel_remove(panel->base);

        intel_backlight_device_unregister(connector);
}

/* Notify followers, if any, about power being up. */
void intel_panel_prepare(const struct intel_crtc_state *crtc_state,
                         const struct drm_connector_state *conn_state)
{
        struct intel_connector *connector = to_intel_connector(conn_state->connector);
        struct intel_panel *panel = &connector->panel;

        drm_panel_prepare(panel->base);
}

/* Notify followers, if any, about power going down. */
void intel_panel_unprepare(const struct drm_connector_state *old_conn_state)
{
        struct intel_connector *connector = to_intel_connector(old_conn_state->connector);
        struct intel_panel *panel = &connector->panel;

        drm_panel_unprepare(panel->base);
}