/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * Copyright (C) 2011 - 2012 Samsung Electronics Co., Ltd.
 */

#ifndef FIMC_MDEVICE_H_
#define FIMC_MDEVICE_H_

#include <linux/clk.h>
#include <linux/clk-provider.h>
#include <linux/platform_device.h>
#include <linux/mutex.h>
#include <linux/of.h>
#include <linux/pinctrl/consumer.h>
#include <media/media-device.h>
#include <media/media-entity.h>
#include <media/v4l2-device.h>
#include <media/v4l2-subdev.h>
#include <media/drv-intf/exynos-fimc.h>

#include "fimc-core.h"
#include "fimc-lite.h"
#include "mipi-csis.h"

#define FIMC_OF_NODE_NAME       "fimc"
#define FIMC_LITE_OF_NODE_NAME  "fimc-lite"
#define FIMC_IS_OF_NODE_NAME    "fimc-is"
#define CSIS_OF_NODE_NAME       "csis"

#define FIMC_MAX_SENSORS        4
#define FIMC_MAX_CAMCLKS        2
#define DEFAULT_SENSOR_CLK_FREQ 24000000U

/* LCD/ISP Writeback clocks (PIXELASYNCMx) */
enum {
        CLK_IDX_WB_A,
        CLK_IDX_WB_B,
        FIMC_MAX_WBCLKS
};

enum fimc_subdev_index {
        IDX_SENSOR,
        IDX_CSIS,
        IDX_FLITE,
        IDX_IS_ISP,
        IDX_FIMC,
        IDX_MAX,
};

/*
 * This structure represents a chain of media entities, including a data
 * source entity (e.g. an image sensor subdevice), a data capture entity
 * - a video capture device node and any remaining entities.
 */
struct fimc_pipeline {
        struct exynos_media_pipeline ep;
        struct list_head list;
        struct media_entity *vdev_entity;
        struct v4l2_subdev *subdevs[IDX_MAX];
};

#define to_fimc_pipeline(_ep) container_of(_ep, struct fimc_pipeline, ep)

struct fimc_csis_info {
        struct v4l2_subdev *sd;
        int id;
};

struct fimc_camclk_info {
        struct clk *clock;
        int use_count;
        unsigned long frequency;
};

/**
 * struct fimc_sensor_info - image data source subdev information
 * @pdata: sensor's attributes passed as media device's platform data
 * @asd: asynchronous subdev registration data structure
 * @subdev: image sensor v4l2 subdev
 * @host: fimc device the sensor is currently linked to
 *
 * This data structure applies to image sensor and the writeback subdevs.
 */
struct fimc_sensor_info {
        struct fimc_source_info pdata;
        struct v4l2_async_subdev *asd;
        struct v4l2_subdev *subdev;
        struct fimc_dev *host;
};

struct cam_clk {
        struct clk_hw hw;
        struct fimc_md *fmd;
};
#define to_cam_clk(_hw) container_of(_hw, struct cam_clk, hw)

/**
 * struct fimc_md - fimc media device information
 * @csis: MIPI CSIS subdevs data
 * @sensor: array of registered sensor subdevs
 * @num_sensors: actual number of registered sensors
 * @camclk: external sensor clock information
 * @wbclk: external writeback clock information
 * @fimc_lite: array of registered fimc-lite devices
 * @fimc: array of registered fimc devices
 * @fimc_is: fimc-is data structure
 * @use_isp: set to true when FIMC-IS subsystem is used
 * @pmf: handle to the CAMCLK clock control FIMC helper device
 * @media_dev: top level media device
 * @v4l2_dev: top level v4l2_device holding up the subdevs
 * @pdev: platform device this media device is hooked up into
 * @clk_provider: CAMCLK clock provider structure
 * @subdev_notifier: notifier for the subdevs
 * @user_subdev_api: true if subdevs are not configured by the host driver
 * @slock: spinlock protecting @sensor array
 * @pipelines: list of pipelines
 * @link_setup_graph: graph iterator
 */
struct fimc_md {
        struct fimc_csis_info csis[CSIS_MAX_ENTITIES];
        struct fimc_sensor_info sensor[FIMC_MAX_SENSORS];
        int num_sensors;
        struct fimc_camclk_info camclk[FIMC_MAX_CAMCLKS];
        struct clk *wbclk[FIMC_MAX_WBCLKS];
        struct fimc_lite *fimc_lite[FIMC_LITE_MAX_DEVS];
        struct fimc_dev *fimc[FIMC_MAX_DEVS];
        struct fimc_is *fimc_is;
        bool use_isp;
        struct device *pmf;
        struct media_device media_dev;
        struct v4l2_device v4l2_dev;
        struct platform_device *pdev;

        struct cam_clk_provider {
                struct clk *clks[FIMC_MAX_CAMCLKS];
                struct clk_onecell_data clk_data;
                struct device_node *of_node;
                struct cam_clk camclk[FIMC_MAX_CAMCLKS];
                int num_clocks;
        } clk_provider;

        struct v4l2_async_notifier subdev_notifier;

        bool user_subdev_api;
        spinlock_t slock;
        struct list_head pipelines;
        struct media_graph link_setup_graph;
};

static inline
struct fimc_sensor_info *source_to_sensor_info(struct fimc_source_info *si)
{
        return container_of(si, struct fimc_sensor_info, pdata);
}

static inline struct fimc_md *entity_to_fimc_mdev(struct media_entity *me)
{
        return me->graph_obj.mdev == NULL ? NULL :
                container_of(me->graph_obj.mdev, struct fimc_md, media_dev);
}

static inline struct fimc_md *notifier_to_fimc_md(struct v4l2_async_notifier *n)
{
        return container_of(n, struct fimc_md, subdev_notifier);
}

static inline void fimc_md_graph_lock(struct exynos_video_entity *ve)
{
        mutex_lock(&ve->vdev.entity.graph_obj.mdev->graph_mutex);
}

static inline void fimc_md_graph_unlock(struct exynos_video_entity *ve)
{
        mutex_unlock(&ve->vdev.entity.graph_obj.mdev->graph_mutex);
}

int fimc_md_set_camclk(struct v4l2_subdev *sd, bool on);

#ifdef CONFIG_OF
static inline bool fimc_md_is_isp_available(struct device_node *node)
{
        node = of_get_child_by_name(node, FIMC_IS_OF_NODE_NAME);
        return node ? of_device_is_available(node) : false;
}
#else
#define fimc_md_is_isp_available(node) (false)
#endif /* CONFIG_OF */

static inline struct v4l2_subdev *__fimc_md_get_subdev(
                                struct exynos_media_pipeline *ep,
                                unsigned int index)
{
        struct fimc_pipeline *p = to_fimc_pipeline(ep);

        if (!p || index >= IDX_MAX)
                return NULL;
        else
                return p->subdevs[index];
}

#endif