// SPDX-License-Identifier: GPL-2.0-only
/*
 * Copyright (C) 2015 Broadcom
 */

/**
 * DOC: VC4 CRTC module
 *
 * In VC4, the Pixel Valve is what most closely corresponds to the
 * DRM's concept of a CRTC.  The PV generates video timings from the
 * encoder's clock plus its configuration.  It pulls scaled pixels from
 * the HVS at that timing, and feeds it to the encoder.
 *
 * However, the DRM CRTC also collects the configuration of all the
 * DRM planes attached to it.  As a result, the CRTC is also
 * responsible for writing the display list for the HVS channel that
 * the CRTC will use.
 *
 * The 2835 has 3 different pixel valves.  pv0 in the audio power
 * domain feeds DSI0 or DPI, while pv1 feeds DS1 or SMI.  pv2 in the
 * image domain can feed either HDMI or the SDTV controller.  The
 * pixel valve chooses from the CPRMAN clocks (HSM for HDMI, VEC for
 * SDTV, etc.) according to which output type is chosen in the mux.
 *
 * For power management, the pixel valve's registers are all clocked
 * by the AXI clock, while the timings and FIFOs make use of the
 * output-specific clock.  Since the encoders also directly consume
 * the CPRMAN clocks, and know what timings they need, they are the
 * ones that set the clock.
 */

#include <linux/clk.h>
#include <linux/component.h>
#include <linux/of.h>
#include <linux/platform_device.h>
#include <linux/pm_runtime.h>

#include <drm/drm_atomic.h>
#include <drm/drm_atomic_helper.h>
#include <drm/drm_atomic_uapi.h>
#include <drm/drm_fb_dma_helper.h>
#include <drm/drm_framebuffer.h>
#include <drm/drm_drv.h>
#include <drm/drm_print.h>
#include <drm/drm_probe_helper.h>
#include <drm/drm_vblank.h>

#include "vc4_drv.h"
#include "vc4_hdmi.h"
#include "vc4_regs.h"

#define HVS_FIFO_LATENCY_PIX    6

#define CRTC_WRITE(offset, val)                                                         \
        do {                                                                            \
                kunit_fail_current_test("Accessing a register in a unit test!\n");      \
                writel(val, vc4_crtc->regs + (offset));                                 \
        } while (0)

#define CRTC_READ(offset)                                                               \
        ({                                                                              \
                kunit_fail_current_test("Accessing a register in a unit test!\n");      \
                readl(vc4_crtc->regs + (offset));                                       \
        })

static const struct debugfs_reg32 crtc_regs[] = {
        VC4_REG32(PV_CONTROL),
        VC4_REG32(PV_V_CONTROL),
        VC4_REG32(PV_VSYNCD_EVEN),
        VC4_REG32(PV_HORZA),
        VC4_REG32(PV_HORZB),
        VC4_REG32(PV_VERTA),
        VC4_REG32(PV_VERTB),
        VC4_REG32(PV_VERTA_EVEN),
        VC4_REG32(PV_VERTB_EVEN),
        VC4_REG32(PV_INTEN),
        VC4_REG32(PV_INTSTAT),
        VC4_REG32(PV_STAT),
        VC4_REG32(PV_HACT_ACT),
};

static unsigned int
vc4_crtc_get_cob_allocation(struct vc4_dev *vc4, unsigned int channel)
{
        struct vc4_hvs *hvs = vc4->hvs;
        u32 dispbase, top, base;

        /* Top/base are supposed to be 4-pixel aligned, but the
         * Raspberry Pi firmware fills the low bits (which are
         * presumably ignored).
         */

        if (vc4->gen >= VC4_GEN_6_C) {
                dispbase = HVS_READ(SCALER6_DISPX_COB(channel));
                top = VC4_GET_FIELD(dispbase, SCALER6_DISPX_COB_TOP) & ~3;
                base = VC4_GET_FIELD(dispbase, SCALER6_DISPX_COB_BASE) & ~3;
        } else {
                dispbase = HVS_READ(SCALER_DISPBASEX(channel));
                top = VC4_GET_FIELD(dispbase, SCALER_DISPBASEX_TOP) & ~3;
                base = VC4_GET_FIELD(dispbase, SCALER_DISPBASEX_BASE) & ~3;
        }

        return top - base + 4;
}

static bool vc4_crtc_get_scanout_position(struct drm_crtc *crtc,
                                          bool in_vblank_irq,
                                          int *vpos, int *hpos,
                                          ktime_t *stime, ktime_t *etime,
                                          const struct drm_display_mode *mode)
{
        struct drm_device *dev = crtc->dev;
        struct vc4_dev *vc4 = to_vc4_dev(dev);
        struct vc4_hvs *hvs = vc4->hvs;
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        struct vc4_crtc_state *vc4_crtc_state = to_vc4_crtc_state(crtc->state);
        unsigned int channel = vc4_crtc_state->assigned_channel;
        unsigned int cob_size;
        u32 val;
        int fifo_lines;
        int vblank_lines;
        bool ret = false;

        /* preempt_disable_rt() should go right here in PREEMPT_RT patchset. */

        /* Get optional system timestamp before query. */
        if (stime)
                *stime = ktime_get();

        /*
         * Read vertical scanline which is currently composed for our
         * pixelvalve by the HVS, and also the scaler status.
         */
        if (vc4->gen >= VC4_GEN_6_C)
                val = HVS_READ(SCALER6_DISPX_STATUS(channel));
        else
                val = HVS_READ(SCALER_DISPSTATX(channel));

        /* Get optional system timestamp after query. */
        if (etime)
                *etime = ktime_get();

        /* preempt_enable_rt() should go right here in PREEMPT_RT patchset. */

        /* Vertical position of hvs composed scanline. */

        if (vc4->gen >= VC4_GEN_6_C)
                *vpos = VC4_GET_FIELD(val, SCALER6_DISPX_STATUS_YLINE);
        else
                *vpos = VC4_GET_FIELD(val, SCALER_DISPSTATX_LINE);

        *hpos = 0;

        if (mode->flags & DRM_MODE_FLAG_INTERLACE) {
                *vpos /= 2;

                /* Use hpos to correct for field offset in interlaced mode. */
                if (vc4_hvs_get_fifo_frame_count(hvs, channel) % 2)
                        *hpos += mode->crtc_htotal / 2;
        }

        cob_size = vc4_crtc_get_cob_allocation(vc4, channel);
        /* This is the offset we need for translating hvs -> pv scanout pos. */
        fifo_lines = cob_size / mode->crtc_hdisplay;

        if (fifo_lines > 0)
                ret = true;

        /* HVS more than fifo_lines into frame for compositing? */
        if (*vpos > fifo_lines) {
                /*
                 * We are in active scanout and can get some meaningful results
                 * from HVS. The actual PV scanout can not trail behind more
                 * than fifo_lines as that is the fifo's capacity. Assume that
                 * in active scanout the HVS and PV work in lockstep wrt. HVS
                 * refilling the fifo and PV consuming from the fifo, ie.
                 * whenever the PV consumes and frees up a scanline in the
                 * fifo, the HVS will immediately refill it, therefore
                 * incrementing vpos. Therefore we choose HVS read position -
                 * fifo size in scanlines as a estimate of the real scanout
                 * position of the PV.
                 */
                *vpos -= fifo_lines + 1;

                return ret;
        }

        /*
         * Less: This happens when we are in vblank and the HVS, after getting
         * the VSTART restart signal from the PV, just started refilling its
         * fifo with new lines from the top-most lines of the new framebuffers.
         * The PV does not scan out in vblank, so does not remove lines from
         * the fifo, so the fifo will be full quickly and the HVS has to pause.
         * We can't get meaningful readings wrt. scanline position of the PV
         * and need to make things up in a approximative but consistent way.
         */
        vblank_lines = mode->vtotal - mode->vdisplay;

        if (in_vblank_irq) {
                /*
                 * Assume the irq handler got called close to first
                 * line of vblank, so PV has about a full vblank
                 * scanlines to go, and as a base timestamp use the
                 * one taken at entry into vblank irq handler, so it
                 * is not affected by random delays due to lock
                 * contention on event_lock or vblank_time lock in
                 * the core.
                 */
                *vpos = -vblank_lines;

                if (stime)
                        *stime = vc4_crtc->t_vblank;
                if (etime)
                        *etime = vc4_crtc->t_vblank;

                /*
                 * If the HVS fifo is not yet full then we know for certain
                 * we are at the very beginning of vblank, as the hvs just
                 * started refilling, and the stime and etime timestamps
                 * truly correspond to start of vblank.
                 *
                 * Unfortunately there's no way to report this to upper levels
                 * and make it more useful.
                 */
        } else {
                /*
                 * No clue where we are inside vblank. Return a vpos of zero,
                 * which will cause calling code to just return the etime
                 * timestamp uncorrected. At least this is no worse than the
                 * standard fallback.
                 */
                *vpos = 0;
        }

        return ret;
}

static u32 vc4_get_fifo_full_level(struct vc4_crtc *vc4_crtc, u32 format)
{
        const struct vc4_crtc_data *crtc_data = vc4_crtc_to_vc4_crtc_data(vc4_crtc);
        const struct vc4_pv_data *pv_data = vc4_crtc_to_vc4_pv_data(vc4_crtc);
        struct vc4_dev *vc4 = to_vc4_dev(vc4_crtc->base.dev);

        /*
         * NOTE: Could we use register 0x68 (PV_HW_CFG1) to get the FIFO
         * size?
         */
        u32 fifo_len_bytes = pv_data->fifo_depth;

        /*
         * Pixels are pulled from the HVS if the number of bytes is
         * lower than the FIFO full level.
         *
         * The latency of the pixel fetch mechanism is 6 pixels, so we
         * need to convert those 6 pixels in bytes, depending on the
         * format, and then subtract that from the length of the FIFO
         * to make sure we never end up in a situation where the FIFO
         * is full.
         */
        switch (format) {
        case PV_CONTROL_FORMAT_DSIV_16:
        case PV_CONTROL_FORMAT_DSIC_16:
                return fifo_len_bytes - 2 * HVS_FIFO_LATENCY_PIX;
        case PV_CONTROL_FORMAT_DSIV_18:
                return fifo_len_bytes - 14;
        case PV_CONTROL_FORMAT_24:
        case PV_CONTROL_FORMAT_DSIV_24:
        default:
                /*
                 * For some reason, the pixelvalve4 doesn't work with
                 * the usual formula and will only work with 32.
                 */
                if (crtc_data->hvs_output == 5)
                        return 32;

                /*
                 * It looks like in some situations, we will overflow
                 * the PixelValve FIFO (with the bit 10 of PV stat being
                 * set) and stall the HVS / PV, eventually resulting in
                 * a page flip timeout.
                 *
                 * Displaying the video overlay during a playback with
                 * Kodi on an RPi3 seems to be a great solution with a
                 * failure rate around 50%.
                 *
                 * Removing 1 from the FIFO full level however
                 * seems to completely remove that issue.
                 */
                if (vc4->gen == VC4_GEN_4)
                        return fifo_len_bytes - 3 * HVS_FIFO_LATENCY_PIX - 1;

                return fifo_len_bytes - 3 * HVS_FIFO_LATENCY_PIX;
        }
}

static u32 vc4_crtc_get_fifo_full_level_bits(struct vc4_crtc *vc4_crtc,
                                             u32 format)
{
        u32 level = vc4_get_fifo_full_level(vc4_crtc, format);
        u32 ret = 0;

        ret |= VC4_SET_FIELD((level >> 6),
                             PV5_CONTROL_FIFO_LEVEL_HIGH);

        return ret | VC4_SET_FIELD(level & 0x3f,
                                   PV_CONTROL_FIFO_LEVEL);
}

/*
 * Returns the encoder attached to the CRTC.
 *
 * VC4 can only scan out to one encoder at a time, while the DRM core
 * allows drivers to push pixels to more than one encoder from the
 * same CRTC.
 */
struct drm_encoder *vc4_get_crtc_encoder(struct drm_crtc *crtc,
                                         struct drm_crtc_state *state)
{
        struct drm_encoder *encoder;

        WARN_ON(hweight32(state->encoder_mask) > 1);

        drm_for_each_encoder_mask(encoder, crtc->dev, state->encoder_mask)
                return encoder;

        return NULL;
}

static void vc4_crtc_pixelvalve_reset(struct drm_crtc *crtc)
{
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        struct drm_device *dev = crtc->dev;
        int idx;

        if (!drm_dev_enter(dev, &idx))
                return;

        /* The PV needs to be disabled before it can be flushed */
        CRTC_WRITE(PV_CONTROL, CRTC_READ(PV_CONTROL) & ~PV_CONTROL_EN);
        CRTC_WRITE(PV_CONTROL, CRTC_READ(PV_CONTROL) | PV_CONTROL_FIFO_CLR);

        drm_dev_exit(idx);
}

static void vc4_crtc_config_pv(struct drm_crtc *crtc, struct drm_encoder *encoder,
                               struct drm_atomic_state *state)
{
        struct drm_device *dev = crtc->dev;
        struct vc4_dev *vc4 = to_vc4_dev(dev);
        struct vc4_encoder *vc4_encoder = to_vc4_encoder(encoder);
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        const struct vc4_pv_data *pv_data = vc4_crtc_to_vc4_pv_data(vc4_crtc);
        struct drm_crtc_state *crtc_state = crtc->state;
        struct drm_display_mode *mode = &crtc_state->adjusted_mode;
        bool interlace = mode->flags & DRM_MODE_FLAG_INTERLACE;
        bool is_hdmi = vc4_encoder->type == VC4_ENCODER_TYPE_HDMI0 ||
                       vc4_encoder->type == VC4_ENCODER_TYPE_HDMI1;
        u32 pixel_rep = ((mode->flags & DRM_MODE_FLAG_DBLCLK) && !is_hdmi) ? 2 : 1;
        bool is_dsi = (vc4_encoder->type == VC4_ENCODER_TYPE_DSI0 ||
                       vc4_encoder->type == VC4_ENCODER_TYPE_DSI1);
        bool is_dsi1 = vc4_encoder->type == VC4_ENCODER_TYPE_DSI1;
        bool is_vec = vc4_encoder->type == VC4_ENCODER_TYPE_VEC;
        u32 format = is_dsi1 ? PV_CONTROL_FORMAT_DSIV_24 : PV_CONTROL_FORMAT_24;
        u8 ppc = pv_data->pixels_per_clock;

        u16 vert_bp = mode->crtc_vtotal - mode->crtc_vsync_end;
        u16 vert_sync = mode->crtc_vsync_end - mode->crtc_vsync_start;
        u16 vert_fp = mode->crtc_vsync_start - mode->crtc_vdisplay;

        bool debug_dump_regs = false;
        int idx;

        if (!drm_dev_enter(dev, &idx))
                return;

        if (debug_dump_regs) {
                struct drm_printer p = drm_info_printer(&vc4_crtc->pdev->dev);
                dev_info(&vc4_crtc->pdev->dev, "CRTC %d regs before:\n",
                         drm_crtc_index(crtc));
                drm_print_regset32(&p, &vc4_crtc->regset);
        }

        vc4_crtc_pixelvalve_reset(crtc);

        CRTC_WRITE(PV_HORZA,
                   VC4_SET_FIELD((mode->htotal - mode->hsync_end) * pixel_rep / ppc,
                                 PV_HORZA_HBP) |
                   VC4_SET_FIELD((mode->hsync_end - mode->hsync_start) * pixel_rep / ppc,
                                 PV_HORZA_HSYNC));

        CRTC_WRITE(PV_HORZB,
                   VC4_SET_FIELD((mode->hsync_start - mode->hdisplay) * pixel_rep / ppc,
                                 PV_HORZB_HFP) |
                   VC4_SET_FIELD(mode->hdisplay * pixel_rep / ppc,
                                 PV_HORZB_HACTIVE));

        if (interlace) {
                bool odd_field_first = false;
                u32 field_delay = mode->htotal * pixel_rep / (2 * ppc);
                u16 vert_bp_even = vert_bp;
                u16 vert_fp_even = vert_fp;

                if (is_vec) {
                        /* VEC (composite output) */
                        ++field_delay;
                        if (mode->htotal == 858) {
                                /* 525-line mode (NTSC or PAL-M) */
                                odd_field_first = true;
                        }
                }

                if (odd_field_first)
                        ++vert_fp_even;
                else
                        ++vert_bp;

                CRTC_WRITE(PV_VERTA_EVEN,
                           VC4_SET_FIELD(vert_bp_even, PV_VERTA_VBP) |
                           VC4_SET_FIELD(vert_sync, PV_VERTA_VSYNC));
                CRTC_WRITE(PV_VERTB_EVEN,
                           VC4_SET_FIELD(vert_fp_even, PV_VERTB_VFP) |
                           VC4_SET_FIELD(mode->crtc_vdisplay, PV_VERTB_VACTIVE));

                /* We set up first field even mode for HDMI and VEC's PAL.
                 * For NTSC, we need first field odd.
                 */
                CRTC_WRITE(PV_V_CONTROL,
                           PV_VCONTROL_CONTINUOUS |
                           (vc4->gen >= VC4_GEN_6_C ? PV_VCONTROL_ODD_TIMING : 0) |
                           (is_dsi ? PV_VCONTROL_DSI : 0) |
                           PV_VCONTROL_INTERLACE |
                           (odd_field_first
                                   ? PV_VCONTROL_ODD_FIRST
                                   : VC4_SET_FIELD(field_delay,
                                                   PV_VCONTROL_ODD_DELAY)));
                CRTC_WRITE(PV_VSYNCD_EVEN,
                           (odd_field_first ? field_delay : 0));
        } else {
                CRTC_WRITE(PV_V_CONTROL,
                           PV_VCONTROL_CONTINUOUS |
                           (vc4->gen >= VC4_GEN_6_C ? PV_VCONTROL_ODD_TIMING : 0) |
                           (is_dsi ? PV_VCONTROL_DSI : 0));
                CRTC_WRITE(PV_VSYNCD_EVEN, 0);
        }

        CRTC_WRITE(PV_VERTA,
                   VC4_SET_FIELD(vert_bp, PV_VERTA_VBP) |
                   VC4_SET_FIELD(vert_sync, PV_VERTA_VSYNC));
        CRTC_WRITE(PV_VERTB,
                   VC4_SET_FIELD(vert_fp, PV_VERTB_VFP) |
                   VC4_SET_FIELD(mode->crtc_vdisplay, PV_VERTB_VACTIVE));

        if (is_dsi)
                CRTC_WRITE(PV_HACT_ACT, mode->hdisplay * pixel_rep);

        if (vc4->gen >= VC4_GEN_5)
                CRTC_WRITE(PV_MUX_CFG,
                           VC4_SET_FIELD(PV_MUX_CFG_RGB_PIXEL_MUX_MODE_NO_SWAP,
                                         PV_MUX_CFG_RGB_PIXEL_MUX_MODE));

        if (vc4->gen >= VC4_GEN_6_C)
                CRTC_WRITE(PV_PIPE_INIT_CTRL,
                           VC4_SET_FIELD(1, PV_PIPE_INIT_CTRL_PV_INIT_WIDTH) |
                           VC4_SET_FIELD(1, PV_PIPE_INIT_CTRL_PV_INIT_IDLE) |
                           PV_PIPE_INIT_CTRL_PV_INIT_EN);

        CRTC_WRITE(PV_CONTROL, PV_CONTROL_FIFO_CLR |
                   vc4_crtc_get_fifo_full_level_bits(vc4_crtc, format) |
                   VC4_SET_FIELD(format, PV_CONTROL_FORMAT) |
                   VC4_SET_FIELD(pixel_rep - 1, PV_CONTROL_PIXEL_REP) |
                   PV_CONTROL_CLR_AT_START |
                   PV_CONTROL_TRIGGER_UNDERFLOW |
                   PV_CONTROL_WAIT_HSTART |
                   VC4_SET_FIELD(vc4_encoder->clock_select,
                                 PV_CONTROL_CLK_SELECT));

        if (debug_dump_regs) {
                struct drm_printer p = drm_info_printer(&vc4_crtc->pdev->dev);
                dev_info(&vc4_crtc->pdev->dev, "CRTC %d regs after:\n",
                         drm_crtc_index(crtc));
                drm_print_regset32(&p, &vc4_crtc->regset);
        }

        drm_dev_exit(idx);
}

static void require_hvs_enabled(struct drm_device *dev)
{
        struct vc4_dev *vc4 = to_vc4_dev(dev);
        struct vc4_hvs *hvs = vc4->hvs;

        if (vc4->gen >= VC4_GEN_6_C)
                WARN_ON_ONCE(!(HVS_READ(SCALER6_CONTROL) & SCALER6_CONTROL_HVS_EN));
        else
                WARN_ON_ONCE(!(HVS_READ(SCALER_DISPCTRL) & SCALER_DISPCTRL_ENABLE));
}

static int vc4_crtc_disable(struct drm_crtc *crtc,
                            struct drm_encoder *encoder,
                            struct drm_atomic_state *state,
                            unsigned int channel)
{
        struct vc4_encoder *vc4_encoder = to_vc4_encoder(encoder);
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        struct drm_device *dev = crtc->dev;
        struct vc4_dev *vc4 = to_vc4_dev(dev);
        int idx, ret;

        if (!drm_dev_enter(dev, &idx))
                return -ENODEV;

        CRTC_WRITE(PV_V_CONTROL,
                   CRTC_READ(PV_V_CONTROL) & ~PV_VCONTROL_VIDEN);
        ret = wait_for(!(CRTC_READ(PV_V_CONTROL) & PV_VCONTROL_VIDEN), 1);
        WARN_ONCE(ret, "Timeout waiting for !PV_VCONTROL_VIDEN\n");

        /*
         * This delay is needed to avoid to get a pixel stuck in an
         * unflushable FIFO between the pixelvalve and the HDMI
         * controllers on the BCM2711.
         *
         * Timing is fairly sensitive here, so mdelay is the safest
         * approach.
         *
         * If it was to be reworked, the stuck pixel happens on a
         * BCM2711 when changing mode with a good probability, so a
         * script that changes mode on a regular basis should trigger
         * the bug after less than 10 attempts. It manifests itself with
         * every pixels being shifted by one to the right, and thus the
         * last pixel of a line actually being displayed as the first
         * pixel on the next line.
         */
        mdelay(20);

        if (vc4_encoder && vc4_encoder->post_crtc_disable)
                vc4_encoder->post_crtc_disable(encoder, state);

        vc4_crtc_pixelvalve_reset(crtc);
        vc4_hvs_stop_channel(vc4->hvs, channel);

        if (vc4_encoder && vc4_encoder->post_crtc_powerdown)
                vc4_encoder->post_crtc_powerdown(encoder, state);

        drm_dev_exit(idx);

        return 0;
}

int vc4_crtc_disable_at_boot(struct drm_crtc *crtc)
{
        struct drm_device *drm = crtc->dev;
        struct vc4_dev *vc4 = to_vc4_dev(drm);
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        enum vc4_encoder_type encoder_type;
        const struct vc4_pv_data *pv_data;
        struct drm_encoder *encoder;
        struct vc4_hdmi *vc4_hdmi;
        unsigned encoder_sel;
        int channel;
        int ret;

        if (!(of_device_is_compatible(vc4_crtc->pdev->dev.of_node,
                                      "brcm,bcm2711-pixelvalve2") ||
              of_device_is_compatible(vc4_crtc->pdev->dev.of_node,
                                      "brcm,bcm2711-pixelvalve4") ||
              of_device_is_compatible(vc4_crtc->pdev->dev.of_node,
                                      "brcm,bcm2712-pixelvalve0") ||
              of_device_is_compatible(vc4_crtc->pdev->dev.of_node,
                                      "brcm,bcm2712-pixelvalve1")))
                return 0;

        if (!(CRTC_READ(PV_CONTROL) & PV_CONTROL_EN))
                return 0;

        if (!(CRTC_READ(PV_V_CONTROL) & PV_VCONTROL_VIDEN))
                return 0;

        channel = vc4_hvs_get_fifo_from_output(vc4->hvs, vc4_crtc->data->hvs_output);
        if (channel < 0)
                return 0;

        encoder_sel = VC4_GET_FIELD(CRTC_READ(PV_CONTROL), PV_CONTROL_CLK_SELECT);
        if (WARN_ON(encoder_sel != 0))
                return 0;

        pv_data = vc4_crtc_to_vc4_pv_data(vc4_crtc);
        encoder_type = pv_data->encoder_types[encoder_sel];
        encoder = vc4_find_encoder_by_type(drm, encoder_type);
        if (WARN_ON(!encoder))
                return 0;

        vc4_hdmi = encoder_to_vc4_hdmi(encoder);
        ret = pm_runtime_resume_and_get(&vc4_hdmi->pdev->dev);
        if (ret)
                return ret;

        ret = vc4_crtc_disable(crtc, encoder, NULL, channel);
        if (ret)
                return ret;

        /*
         * post_crtc_powerdown will have called pm_runtime_put, so we
         * don't need it here otherwise we'll get the reference counting
         * wrong.
         */

        return 0;
}

void vc4_crtc_send_vblank(struct drm_crtc *crtc)
{
        struct drm_device *dev = crtc->dev;
        unsigned long flags;

        if (!crtc->state || !crtc->state->event)
                return;

        spin_lock_irqsave(&dev->event_lock, flags);
        drm_crtc_send_vblank_event(crtc, crtc->state->event);
        crtc->state->event = NULL;
        spin_unlock_irqrestore(&dev->event_lock, flags);
}

static void vc4_crtc_atomic_disable(struct drm_crtc *crtc,
                                    struct drm_atomic_state *state)
{
        struct drm_crtc_state *old_state = drm_atomic_get_old_crtc_state(state,
                                                                         crtc);
        struct vc4_crtc_state *old_vc4_state = to_vc4_crtc_state(old_state);
        struct drm_encoder *encoder = vc4_get_crtc_encoder(crtc, old_state);
        struct drm_device *dev = crtc->dev;

        drm_dbg(dev, "Disabling CRTC %s (%u) connected to Encoder %s (%u)",
                crtc->name, crtc->base.id, encoder->name, encoder->base.id);

        require_hvs_enabled(dev);

        /* Disable vblank irq handling before crtc is disabled. */
        drm_crtc_vblank_off(crtc);

        vc4_crtc_disable(crtc, encoder, state, old_vc4_state->assigned_channel);

        /*
         * Make sure we issue a vblank event after disabling the CRTC if
         * someone was waiting it.
         */
        vc4_crtc_send_vblank(crtc);
}

static void vc4_crtc_atomic_enable(struct drm_crtc *crtc,
                                   struct drm_atomic_state *state)
{
        struct drm_crtc_state *new_state = drm_atomic_get_new_crtc_state(state,
                                                                         crtc);
        struct drm_device *dev = crtc->dev;
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        struct drm_encoder *encoder = vc4_get_crtc_encoder(crtc, new_state);
        struct vc4_encoder *vc4_encoder = to_vc4_encoder(encoder);
        int idx;

        drm_dbg(dev, "Enabling CRTC %s (%u) connected to Encoder %s (%u)",
                crtc->name, crtc->base.id, encoder->name, encoder->base.id);

        if (!drm_dev_enter(dev, &idx))
                return;

        require_hvs_enabled(dev);

        /* Enable vblank irq handling before crtc is started otherwise
         * drm_crtc_get_vblank() fails in vc4_crtc_update_dlist().
         */
        drm_crtc_vblank_on(crtc);

        vc4_hvs_atomic_enable(crtc, state);

        if (vc4_encoder->pre_crtc_configure)
                vc4_encoder->pre_crtc_configure(encoder, state);

        vc4_crtc_config_pv(crtc, encoder, state);

        CRTC_WRITE(PV_CONTROL, CRTC_READ(PV_CONTROL) | PV_CONTROL_EN);

        if (vc4_encoder->pre_crtc_enable)
                vc4_encoder->pre_crtc_enable(encoder, state);

        /* When feeding the transposer block the pixelvalve is unneeded and
         * should not be enabled.
         */
        CRTC_WRITE(PV_V_CONTROL,
                   CRTC_READ(PV_V_CONTROL) | PV_VCONTROL_VIDEN);

        if (vc4_encoder->post_crtc_enable)
                vc4_encoder->post_crtc_enable(encoder, state);

        drm_dev_exit(idx);
}

static enum drm_mode_status vc4_crtc_mode_valid(struct drm_crtc *crtc,
                                                const struct drm_display_mode *mode)
{
        /* Do not allow doublescan modes from user space */
        if (mode->flags & DRM_MODE_FLAG_DBLSCAN) {
                DRM_DEBUG_KMS("[CRTC:%d] Doublescan mode rejected.\n",
                              crtc->base.id);
                return MODE_NO_DBLESCAN;
        }

        return MODE_OK;
}

void vc4_crtc_get_margins(struct drm_crtc_state *state,
                          unsigned int *left, unsigned int *right,
                          unsigned int *top, unsigned int *bottom)
{
        struct vc4_crtc_state *vc4_state = to_vc4_crtc_state(state);
        struct drm_connector_state *conn_state;
        struct drm_connector *conn;
        int i;

        *left = vc4_state->margins.left;
        *right = vc4_state->margins.right;
        *top = vc4_state->margins.top;
        *bottom = vc4_state->margins.bottom;

        /* We have to interate over all new connector states because
         * vc4_crtc_get_margins() might be called before
         * vc4_crtc_atomic_check() which means margins info in vc4_crtc_state
         * might be outdated.
         */
        for_each_new_connector_in_state(state->state, conn, conn_state, i) {
                if (conn_state->crtc != state->crtc)
                        continue;

                *left = conn_state->tv.margins.left;
                *right = conn_state->tv.margins.right;
                *top = conn_state->tv.margins.top;
                *bottom = conn_state->tv.margins.bottom;
                break;
        }
}

int vc4_crtc_atomic_check(struct drm_crtc *crtc,
                          struct drm_atomic_state *state)
{
        struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state,
                                                                          crtc);
        struct vc4_crtc_state *vc4_state = to_vc4_crtc_state(crtc_state);
        struct drm_connector *conn;
        struct drm_connector_state *conn_state;
        struct drm_encoder *encoder;
        int ret, i;

        ret = vc4_hvs_atomic_check(crtc, state);
        if (ret)
                return ret;

        encoder = vc4_get_crtc_encoder(crtc, crtc_state);
        if (encoder) {
                const struct drm_display_mode *mode = &crtc_state->adjusted_mode;
                struct vc4_encoder *vc4_encoder = to_vc4_encoder(encoder);

                if (vc4_encoder->type == VC4_ENCODER_TYPE_HDMI0) {
                        vc4_state->hvs_load = max(mode->clock * mode->hdisplay / mode->htotal + 8000,
                                                  mode->clock * 9 / 10) * 1000;
                } else {
                        vc4_state->hvs_load = mode->clock * 1000;
                }
        }

        for_each_new_connector_in_state(state, conn, conn_state,
                                        i) {
                if (conn_state->crtc != crtc)
                        continue;

                if (memcmp(&vc4_state->margins, &conn_state->tv.margins,
                           sizeof(vc4_state->margins))) {
                        memcpy(&vc4_state->margins, &conn_state->tv.margins,
                               sizeof(vc4_state->margins));

                        /*
                         * Need to force the dlist entries for all planes to be
                         * updated so that the dest rectangles are changed.
                         */
                        crtc_state->zpos_changed = true;
                }
                break;
        }

        return 0;
}

static int vc4_enable_vblank(struct drm_crtc *crtc)
{
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        struct drm_device *dev = crtc->dev;
        int idx;

        if (!drm_dev_enter(dev, &idx))
                return -ENODEV;

        CRTC_WRITE(PV_INTEN, PV_INT_VFP_START);

        drm_dev_exit(idx);

        return 0;
}

static void vc4_disable_vblank(struct drm_crtc *crtc)
{
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        struct drm_device *dev = crtc->dev;
        int idx;

        if (!drm_dev_enter(dev, &idx))
                return;

        CRTC_WRITE(PV_INTEN, 0);

        drm_dev_exit(idx);
}

static void vc4_crtc_handle_page_flip(struct vc4_crtc *vc4_crtc)
{
        struct drm_crtc *crtc = &vc4_crtc->base;
        struct drm_device *dev = crtc->dev;
        struct vc4_dev *vc4 = to_vc4_dev(dev);
        struct vc4_hvs *hvs = vc4->hvs;
        unsigned int current_dlist;
        u32 chan = vc4_crtc->current_hvs_channel;
        unsigned long flags;

        spin_lock_irqsave(&dev->event_lock, flags);
        spin_lock(&vc4_crtc->irq_lock);

        if (vc4->gen >= VC4_GEN_6_C)
                current_dlist = VC4_GET_FIELD(HVS_READ(SCALER6_DISPX_DL(chan)),
                                              SCALER6_DISPX_DL_LACT);
        else
                current_dlist = HVS_READ(SCALER_DISPLACTX(chan));

        if (vc4_crtc->event &&
            (vc4_crtc->current_dlist == current_dlist || vc4_crtc->feeds_txp)) {
                drm_crtc_send_vblank_event(crtc, vc4_crtc->event);
                vc4_crtc->event = NULL;
                drm_crtc_vblank_put(crtc);

                /* Wait for the page flip to unmask the underrun to ensure that
                 * the display list was updated by the hardware. Before that
                 * happens, the HVS will be using the previous display list with
                 * the CRTC and encoder already reconfigured, leading to
                 * underruns. This can be seen when reconfiguring the CRTC.
                 */
                if (vc4->gen < VC4_GEN_6_C)
                        vc4_hvs_unmask_underrun(hvs, chan);
        }
        spin_unlock(&vc4_crtc->irq_lock);
        spin_unlock_irqrestore(&dev->event_lock, flags);
}

void vc4_crtc_handle_vblank(struct vc4_crtc *crtc)
{
        crtc->t_vblank = ktime_get();
        drm_crtc_handle_vblank(&crtc->base);
        vc4_crtc_handle_page_flip(crtc);
}

static irqreturn_t vc4_crtc_irq_handler(int irq, void *data)
{
        struct vc4_crtc *vc4_crtc = data;
        u32 stat = CRTC_READ(PV_INTSTAT);
        irqreturn_t ret = IRQ_NONE;

        if (stat & PV_INT_VFP_START) {
                CRTC_WRITE(PV_INTSTAT, PV_INT_VFP_START);
                vc4_crtc_handle_vblank(vc4_crtc);
                ret = IRQ_HANDLED;
        }

        return ret;
}

struct vc4_async_flip_state {
        struct drm_crtc *crtc;
        struct drm_framebuffer *fb;
        struct drm_framebuffer *old_fb;
        struct drm_pending_vblank_event *event;
        struct dma_fence_cb cb;
};

/* Called when the V3D execution for the BO being flipped to is done, so that
 * we can actually update the plane's address to point to it.
 */
static void
vc4_async_page_flip_complete(struct vc4_async_flip_state *flip_state)
{
        struct drm_crtc *crtc = flip_state->crtc;
        struct drm_device *dev = crtc->dev;
        struct drm_plane *plane = crtc->primary;

        vc4_plane_async_set_fb(plane, flip_state->fb);
        if (flip_state->event) {
                unsigned long flags;

                spin_lock_irqsave(&dev->event_lock, flags);
                drm_crtc_send_vblank_event(crtc, flip_state->event);
                spin_unlock_irqrestore(&dev->event_lock, flags);
        }

        drm_crtc_vblank_put(crtc);
        drm_framebuffer_put(flip_state->fb);

        if (flip_state->old_fb)
                drm_framebuffer_put(flip_state->old_fb);

        kfree(flip_state);
}

static void vc4_async_page_flip_complete_with_cleanup(struct dma_fence *fence,
                                                      struct dma_fence_cb *cb)
{
        struct vc4_async_flip_state *flip_state =
                container_of(cb, struct vc4_async_flip_state, cb);
        struct vc4_bo *bo = NULL;

        if (flip_state->old_fb) {
                struct drm_gem_dma_object *dma_bo =
                        drm_fb_dma_get_gem_obj(flip_state->old_fb, 0);
                bo = to_vc4_bo(&dma_bo->base);
        }

        vc4_async_page_flip_complete(flip_state);
        dma_fence_put(fence);

        /*
         * Decrement the BO usecnt in order to keep the inc/dec
         * calls balanced when the planes are updated through
         * the async update path.
         *
         * FIXME: we should move to generic async-page-flip when
         * it's available, so that we can get rid of this
         * hand-made cleanup_fb() logic.
         */
        if (bo)
                vc4_bo_dec_usecnt(bo);
}

static void vc4_async_page_flip_fence_complete(struct dma_fence *fence,
                                               struct dma_fence_cb *cb)
{
        struct vc4_async_flip_state *flip_state =
                container_of(cb, struct vc4_async_flip_state, cb);

        vc4_async_page_flip_complete(flip_state);
        dma_fence_put(fence);
}

static int vc4_async_set_fence_cb(struct drm_device *dev,
                                  struct vc4_async_flip_state *flip_state)
{
        struct drm_framebuffer *fb = flip_state->fb;
        struct drm_gem_dma_object *dma_bo = drm_fb_dma_get_gem_obj(fb, 0);
        dma_fence_func_t async_page_flip_complete_function;
        struct vc4_dev *vc4 = to_vc4_dev(dev);
        struct dma_fence *fence;
        int ret;

        if (vc4->gen == VC4_GEN_4)
                async_page_flip_complete_function = vc4_async_page_flip_complete_with_cleanup;
        else
                async_page_flip_complete_function = vc4_async_page_flip_fence_complete;

        ret = dma_resv_get_singleton(dma_bo->base.resv, DMA_RESV_USAGE_READ, &fence);
        if (ret)
                return ret;

        /* If there's no fence, complete the page flip immediately */
        if (!fence) {
                async_page_flip_complete_function(fence, &flip_state->cb);
                return 0;
        }

        /* If the fence has already been completed, complete the page flip */
        if (dma_fence_add_callback(fence, &flip_state->cb,
                                   async_page_flip_complete_function))
                async_page_flip_complete_function(fence, &flip_state->cb);

        return 0;
}

static int
vc4_async_page_flip_common(struct drm_crtc *crtc,
                           struct drm_framebuffer *fb,
                           struct drm_pending_vblank_event *event,
                           uint32_t flags)
{
        struct drm_device *dev = crtc->dev;
        struct drm_plane *plane = crtc->primary;
        struct vc4_async_flip_state *flip_state;

        flip_state = kzalloc_obj(*flip_state);
        if (!flip_state)
                return -ENOMEM;

        drm_framebuffer_get(fb);
        flip_state->fb = fb;
        flip_state->crtc = crtc;
        flip_state->event = event;

        /* Save the current FB before it's replaced by the new one in
         * drm_atomic_set_fb_for_plane(). We'll need the old FB in
         * vc4_async_page_flip_complete() to decrement the BO usecnt and keep
         * it consistent.
         * FIXME: we should move to generic async-page-flip when it's
         * available, so that we can get rid of this hand-made cleanup_fb()
         * logic.
         */
        flip_state->old_fb = plane->state->fb;
        if (flip_state->old_fb)
                drm_framebuffer_get(flip_state->old_fb);

        WARN_ON(drm_crtc_vblank_get(crtc) != 0);

        /* Immediately update the plane's legacy fb pointer, so that later
         * modeset prep sees the state that will be present when the semaphore
         * is released.
         */
        drm_atomic_set_fb_for_plane(plane->state, fb);

        vc4_async_set_fence_cb(dev, flip_state);

        /* Driver takes ownership of state on successful async commit. */
        return 0;
}

/* Implements async (non-vblank-synced) page flips.
 *
 * The page flip ioctl needs to return immediately, so we grab the
 * modeset semaphore on the pipe, and queue the address update for
 * when V3D is done with the BO being flipped to.
 */
static int vc4_async_page_flip(struct drm_crtc *crtc,
                               struct drm_framebuffer *fb,
                               struct drm_pending_vblank_event *event,
                               uint32_t flags)
{
        struct drm_device *dev = crtc->dev;
        struct vc4_dev *vc4 = to_vc4_dev(dev);
        struct drm_gem_dma_object *dma_bo = drm_fb_dma_get_gem_obj(fb, 0);
        struct vc4_bo *bo = to_vc4_bo(&dma_bo->base);
        int ret;

        if (WARN_ON_ONCE(vc4->gen > VC4_GEN_4))
                return -ENODEV;

        /*
         * Increment the BO usecnt here, so that we never end up with an
         * unbalanced number of vc4_bo_{dec,inc}_usecnt() calls when the
         * plane is later updated through the non-async path.
         *
         * FIXME: we should move to generic async-page-flip when
         * it's available, so that we can get rid of this
         * hand-made prepare_fb() logic.
         */
        ret = vc4_bo_inc_usecnt(bo);
        if (ret)
                return ret;

        ret = vc4_async_page_flip_common(crtc, fb, event, flags);
        if (ret) {
                vc4_bo_dec_usecnt(bo);
                return ret;
        }

        return 0;
}

static int vc5_async_page_flip(struct drm_crtc *crtc,
                               struct drm_framebuffer *fb,
                               struct drm_pending_vblank_event *event,
                               uint32_t flags)
{
        return vc4_async_page_flip_common(crtc, fb, event, flags);
}

int vc4_page_flip(struct drm_crtc *crtc,
                  struct drm_framebuffer *fb,
                  struct drm_pending_vblank_event *event,
                  uint32_t flags,
                  struct drm_modeset_acquire_ctx *ctx)
{
        if (flags & DRM_MODE_PAGE_FLIP_ASYNC) {
                struct drm_device *dev = crtc->dev;
                struct vc4_dev *vc4 = to_vc4_dev(dev);

                if (vc4->gen > VC4_GEN_4)
                        return vc5_async_page_flip(crtc, fb, event, flags);
                else
                        return vc4_async_page_flip(crtc, fb, event, flags);
        } else {
                return drm_atomic_helper_page_flip(crtc, fb, event, flags, ctx);
        }
}

struct drm_crtc_state *vc4_crtc_duplicate_state(struct drm_crtc *crtc)
{
        struct vc4_crtc_state *vc4_state, *old_vc4_state;

        vc4_state = kzalloc_obj(*vc4_state);
        if (!vc4_state)
                return NULL;

        old_vc4_state = to_vc4_crtc_state(crtc->state);
        vc4_state->margins = old_vc4_state->margins;
        vc4_state->assigned_channel = old_vc4_state->assigned_channel;

        __drm_atomic_helper_crtc_duplicate_state(crtc, &vc4_state->base);
        return &vc4_state->base;
}

void vc4_crtc_destroy_state(struct drm_crtc *crtc,
                            struct drm_crtc_state *state)
{
        struct vc4_dev *vc4 = to_vc4_dev(crtc->dev);
        struct vc4_crtc_state *vc4_state = to_vc4_crtc_state(state);

        if (drm_mm_node_allocated(&vc4_state->mm)) {
                unsigned long flags;

                spin_lock_irqsave(&vc4->hvs->mm_lock, flags);
                drm_mm_remove_node(&vc4_state->mm);
                spin_unlock_irqrestore(&vc4->hvs->mm_lock, flags);

        }

        drm_atomic_helper_crtc_destroy_state(crtc, state);
}

void vc4_crtc_reset(struct drm_crtc *crtc)
{
        struct vc4_crtc_state *vc4_crtc_state;

        if (crtc->state)
                vc4_crtc_destroy_state(crtc, crtc->state);

        vc4_crtc_state = kzalloc_obj(*vc4_crtc_state);
        if (!vc4_crtc_state) {
                crtc->state = NULL;
                return;
        }

        vc4_crtc_state->assigned_channel = VC4_HVS_CHANNEL_DISABLED;
        __drm_atomic_helper_crtc_reset(crtc, &vc4_crtc_state->base);
}

int vc4_crtc_late_register(struct drm_crtc *crtc)
{
        struct drm_device *drm = crtc->dev;
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        const struct vc4_crtc_data *crtc_data = vc4_crtc_to_vc4_crtc_data(vc4_crtc);

        vc4_debugfs_add_regset32(drm, crtc_data->debugfs_name,
                                 &vc4_crtc->regset);

        return 0;
}

static const struct drm_crtc_funcs vc4_crtc_funcs = {
        .set_config = drm_atomic_helper_set_config,
        .page_flip = vc4_page_flip,
        .set_property = NULL,
        .cursor_set = NULL, /* handled by drm_mode_cursor_universal */
        .cursor_move = NULL, /* handled by drm_mode_cursor_universal */
        .reset = vc4_crtc_reset,
        .atomic_duplicate_state = vc4_crtc_duplicate_state,
        .atomic_destroy_state = vc4_crtc_destroy_state,
        .enable_vblank = vc4_enable_vblank,
        .disable_vblank = vc4_disable_vblank,
        .get_vblank_timestamp = drm_crtc_vblank_helper_get_vblank_timestamp,
        .late_register = vc4_crtc_late_register,
};

static const struct drm_crtc_helper_funcs vc4_crtc_helper_funcs = {
        .mode_valid = vc4_crtc_mode_valid,
        .atomic_check = vc4_crtc_atomic_check,
        .atomic_begin = vc4_hvs_atomic_begin,
        .atomic_flush = vc4_hvs_atomic_flush,
        .atomic_enable = vc4_crtc_atomic_enable,
        .atomic_disable = vc4_crtc_atomic_disable,
        .get_scanout_position = vc4_crtc_get_scanout_position,
};

const struct vc4_pv_data bcm2835_pv0_data = {
        .base = {
                .name = "pixelvalve-0",
                .debugfs_name = "crtc0_regs",
                .hvs_available_channels = BIT(0),
                .hvs_output = 0,
        },
        .fifo_depth = 64,
        .pixels_per_clock = 1,
        .encoder_types = {
                [PV_CONTROL_CLK_SELECT_DSI] = VC4_ENCODER_TYPE_DSI0,
                [PV_CONTROL_CLK_SELECT_DPI_SMI_HDMI] = VC4_ENCODER_TYPE_DPI,
        },
};

const struct vc4_pv_data bcm2835_pv1_data = {
        .base = {
                .name = "pixelvalve-1",
                .debugfs_name = "crtc1_regs",
                .hvs_available_channels = BIT(2),
                .hvs_output = 2,
        },
        .fifo_depth = 64,
        .pixels_per_clock = 1,
        .encoder_types = {
                [PV_CONTROL_CLK_SELECT_DSI] = VC4_ENCODER_TYPE_DSI1,
                [PV_CONTROL_CLK_SELECT_DPI_SMI_HDMI] = VC4_ENCODER_TYPE_SMI,
        },
};

const struct vc4_pv_data bcm2835_pv2_data = {
        .base = {
                .name = "pixelvalve-2",
                .debugfs_name = "crtc2_regs",
                .hvs_available_channels = BIT(1),
                .hvs_output = 1,
        },
        .fifo_depth = 64,
        .pixels_per_clock = 1,
        .encoder_types = {
                [PV_CONTROL_CLK_SELECT_DPI_SMI_HDMI] = VC4_ENCODER_TYPE_HDMI0,
                [PV_CONTROL_CLK_SELECT_VEC] = VC4_ENCODER_TYPE_VEC,
        },
};

const struct vc4_pv_data bcm2711_pv0_data = {
        .base = {
                .name = "pixelvalve-0",
                .debugfs_name = "crtc0_regs",
                .hvs_available_channels = BIT(0),
                .hvs_output = 0,
        },
        .fifo_depth = 64,
        .pixels_per_clock = 1,
        .encoder_types = {
                [0] = VC4_ENCODER_TYPE_DSI0,
                [1] = VC4_ENCODER_TYPE_DPI,
        },
};

const struct vc4_pv_data bcm2711_pv1_data = {
        .base = {
                .name = "pixelvalve-1",
                .debugfs_name = "crtc1_regs",
                .hvs_available_channels = BIT(0) | BIT(1) | BIT(2),
                .hvs_output = 3,
        },
        .fifo_depth = 64,
        .pixels_per_clock = 1,
        .encoder_types = {
                [0] = VC4_ENCODER_TYPE_DSI1,
                [1] = VC4_ENCODER_TYPE_SMI,
        },
};

const struct vc4_pv_data bcm2711_pv2_data = {
        .base = {
                .name = "pixelvalve-2",
                .debugfs_name = "crtc2_regs",
                .hvs_available_channels = BIT(0) | BIT(1) | BIT(2),
                .hvs_output = 4,
        },
        .fifo_depth = 256,
        .pixels_per_clock = 2,
        .encoder_types = {
                [0] = VC4_ENCODER_TYPE_HDMI0,
        },
};

const struct vc4_pv_data bcm2711_pv3_data = {
        .base = {
                .name = "pixelvalve-3",
                .debugfs_name = "crtc3_regs",
                .hvs_available_channels = BIT(1),
                .hvs_output = 1,
        },
        .fifo_depth = 64,
        .pixels_per_clock = 1,
        .encoder_types = {
                [PV_CONTROL_CLK_SELECT_VEC] = VC4_ENCODER_TYPE_VEC,
        },
};

const struct vc4_pv_data bcm2711_pv4_data = {
        .base = {
                .name = "pixelvalve-4",
                .debugfs_name = "crtc4_regs",
                .hvs_available_channels = BIT(0) | BIT(1) | BIT(2),
                .hvs_output = 5,
        },
        .fifo_depth = 64,
        .pixels_per_clock = 2,
        .encoder_types = {
                [0] = VC4_ENCODER_TYPE_HDMI1,
        },
};

const struct vc4_pv_data bcm2712_pv0_data = {
        .base = {
                .debugfs_name = "crtc0_regs",
                .hvs_available_channels = BIT(0),
                .hvs_output = 0,
        },
        .fifo_depth = 64,
        .pixels_per_clock = 1,
        .encoder_types = {
                [0] = VC4_ENCODER_TYPE_HDMI0,
        },
};

const struct vc4_pv_data bcm2712_pv1_data = {
        .base = {
                .debugfs_name = "crtc1_regs",
                .hvs_available_channels = BIT(1),
                .hvs_output = 1,
        },
        .fifo_depth = 64,
        .pixels_per_clock = 1,
        .encoder_types = {
                [0] = VC4_ENCODER_TYPE_HDMI1,
        },
};

static const struct of_device_id vc4_crtc_dt_match[] = {
        { .compatible = "brcm,bcm2835-pixelvalve0", .data = &bcm2835_pv0_data },
        { .compatible = "brcm,bcm2835-pixelvalve1", .data = &bcm2835_pv1_data },
        { .compatible = "brcm,bcm2835-pixelvalve2", .data = &bcm2835_pv2_data },
        { .compatible = "brcm,bcm2711-pixelvalve0", .data = &bcm2711_pv0_data },
        { .compatible = "brcm,bcm2711-pixelvalve1", .data = &bcm2711_pv1_data },
        { .compatible = "brcm,bcm2711-pixelvalve2", .data = &bcm2711_pv2_data },
        { .compatible = "brcm,bcm2711-pixelvalve3", .data = &bcm2711_pv3_data },
        { .compatible = "brcm,bcm2711-pixelvalve4", .data = &bcm2711_pv4_data },
        { .compatible = "brcm,bcm2712-pixelvalve0", .data = &bcm2712_pv0_data },
        { .compatible = "brcm,bcm2712-pixelvalve1", .data = &bcm2712_pv1_data },
        {}
};

static void vc4_set_crtc_possible_masks(struct drm_device *drm,
                                        struct drm_crtc *crtc)
{
        struct vc4_crtc *vc4_crtc = to_vc4_crtc(crtc);
        const struct vc4_pv_data *pv_data = vc4_crtc_to_vc4_pv_data(vc4_crtc);
        const enum vc4_encoder_type *encoder_types = pv_data->encoder_types;
        struct drm_encoder *encoder;

        drm_for_each_encoder(encoder, drm) {
                struct vc4_encoder *vc4_encoder;
                int i;

                if (encoder->encoder_type == DRM_MODE_ENCODER_VIRTUAL)
                        continue;

                vc4_encoder = to_vc4_encoder(encoder);
                for (i = 0; i < ARRAY_SIZE(pv_data->encoder_types); i++) {
                        if (vc4_encoder->type == encoder_types[i]) {
                                vc4_encoder->clock_select = i;
                                encoder->possible_crtcs |= drm_crtc_mask(crtc);
                                break;
                        }
                }
        }
}

/**
 * __vc4_crtc_init - Initializes a CRTC
 * @drm: DRM Device
 * @pdev: CRTC Platform Device
 * @vc4_crtc: CRTC Object to Initialize
 * @data: Configuration data associated with this CRTC
 * @primary_plane: Primary plane for CRTC
 * @crtc_funcs: Callbacks for the new CRTC
 * @crtc_helper_funcs: Helper Callbacks for the new CRTC
 * @feeds_txp: Is this CRTC connected to the TXP?
 *
 * Initializes our private CRTC structure. This function is mostly
 * relevant for KUnit testing, all other users should use
 * vc4_crtc_init() instead.
 *
 * Returns:
 * 0 on success, a negative error code on failure.
 */
int __vc4_crtc_init(struct drm_device *drm,
                    struct platform_device *pdev,
                    struct vc4_crtc *vc4_crtc,
                    const struct vc4_crtc_data *data,
                    struct drm_plane *primary_plane,
                    const struct drm_crtc_funcs *crtc_funcs,
                    const struct drm_crtc_helper_funcs *crtc_helper_funcs,
                    bool feeds_txp)
{
        struct vc4_dev *vc4 = to_vc4_dev(drm);
        struct drm_crtc *crtc = &vc4_crtc->base;
        unsigned int i;
        int ret;

        vc4_crtc->data = data;
        vc4_crtc->pdev = pdev;
        vc4_crtc->feeds_txp = feeds_txp;
        spin_lock_init(&vc4_crtc->irq_lock);
        ret = drmm_crtc_init_with_planes(drm, crtc, primary_plane, NULL,
                                         crtc_funcs, data->name);
        if (ret)
                return ret;

        drm_crtc_helper_add(crtc, crtc_helper_funcs);

        if (vc4->gen == VC4_GEN_4) {
                drm_mode_crtc_set_gamma_size(crtc, ARRAY_SIZE(vc4_crtc->lut_r));
                drm_crtc_enable_color_mgmt(crtc, 0, false, crtc->gamma_size);

                /* We support CTM, but only for one CRTC at a time. It's therefore
                 * implemented as private driver state in vc4_kms, not here.
                 */
                drm_crtc_enable_color_mgmt(crtc, 0, true, crtc->gamma_size);
        }

        for (i = 0; i < crtc->gamma_size; i++) {
                vc4_crtc->lut_r[i] = i;
                vc4_crtc->lut_g[i] = i;
                vc4_crtc->lut_b[i] = i;
        }

        return 0;
}

int vc4_crtc_init(struct drm_device *drm, struct platform_device *pdev,
                  struct vc4_crtc *vc4_crtc,
                  const struct vc4_crtc_data *data,
                  const struct drm_crtc_funcs *crtc_funcs,
                  const struct drm_crtc_helper_funcs *crtc_helper_funcs,
                  bool feeds_txp)
{
        struct drm_plane *primary_plane;

        /* For now, we create just the primary and the legacy cursor
         * planes.  We should be able to stack more planes on easily,
         * but to do that we would need to compute the bandwidth
         * requirement of the plane configuration, and reject ones
         * that will take too much.
         */
        primary_plane = vc4_plane_init(drm, DRM_PLANE_TYPE_PRIMARY, 0);
        if (IS_ERR(primary_plane)) {
                dev_err(drm->dev, "failed to construct primary plane\n");
                return PTR_ERR(primary_plane);
        }

        return __vc4_crtc_init(drm, pdev, vc4_crtc, data, primary_plane,
                               crtc_funcs, crtc_helper_funcs, feeds_txp);
}

static int vc4_crtc_bind(struct device *dev, struct device *master, void *data)
{
        struct platform_device *pdev = to_platform_device(dev);
        struct drm_device *drm = dev_get_drvdata(master);
        const struct vc4_pv_data *pv_data;
        struct vc4_crtc *vc4_crtc;
        struct drm_crtc *crtc;
        int ret;

        vc4_crtc = drmm_kzalloc(drm, sizeof(*vc4_crtc), GFP_KERNEL);
        if (!vc4_crtc)
                return -ENOMEM;
        crtc = &vc4_crtc->base;

        pv_data = of_device_get_match_data(dev);
        if (!pv_data)
                return -ENODEV;

        vc4_crtc->regs = vc4_ioremap_regs(pdev, 0);
        if (IS_ERR(vc4_crtc->regs))
                return PTR_ERR(vc4_crtc->regs);

        vc4_crtc->regset.base = vc4_crtc->regs;
        vc4_crtc->regset.regs = crtc_regs;
        vc4_crtc->regset.nregs = ARRAY_SIZE(crtc_regs);

        ret = vc4_crtc_init(drm, pdev, vc4_crtc, &pv_data->base,
                            &vc4_crtc_funcs, &vc4_crtc_helper_funcs,
                            false);
        if (ret)
                return ret;
        vc4_set_crtc_possible_masks(drm, crtc);

        CRTC_WRITE(PV_INTEN, 0);
        CRTC_WRITE(PV_INTSTAT, PV_INT_VFP_START);
        ret = devm_request_irq(dev, platform_get_irq(pdev, 0),
                               vc4_crtc_irq_handler,
                               IRQF_SHARED,
                               "vc4 crtc", vc4_crtc);
        if (ret)
                return ret;

        platform_set_drvdata(pdev, vc4_crtc);

        return 0;
}

static void vc4_crtc_unbind(struct device *dev, struct device *master,
                            void *data)
{
        struct platform_device *pdev = to_platform_device(dev);
        struct vc4_crtc *vc4_crtc = dev_get_drvdata(dev);

        CRTC_WRITE(PV_INTEN, 0);

        platform_set_drvdata(pdev, NULL);
}

static const struct component_ops vc4_crtc_ops = {
        .bind   = vc4_crtc_bind,
        .unbind = vc4_crtc_unbind,
};

static int vc4_crtc_dev_probe(struct platform_device *pdev)
{
        return component_add(&pdev->dev, &vc4_crtc_ops);
}

static void vc4_crtc_dev_remove(struct platform_device *pdev)
{
        component_del(&pdev->dev, &vc4_crtc_ops);
}

struct platform_driver vc4_crtc_driver = {
        .probe = vc4_crtc_dev_probe,
        .remove = vc4_crtc_dev_remove,
        .driver = {
                .name = "vc4_crtc",
                .of_match_table = vc4_crtc_dt_match,
        },
};