Message-ID: <3a666f71-fb91-5c76-853d-df9de5a9af10@xs4all.nl>
Date:   Mon, 3 Jul 2017 12:33:23 +0200
From:   Hans Verkuil <hverkuil@...all.nl>
To:     Jose Abreu <Jose.Abreu@...opsys.com>, linux-media@...r.kernel.org,
        linux-kernel@...r.kernel.org
Cc:     Carlos Palminha <CARLOS.PALMINHA@...opsys.com>,
        Mauro Carvalho Chehab <mchehab@...nel.org>,
        Hans Verkuil <hans.verkuil@...co.com>,
        Sylwester Nawrocki <snawrocki@...nel.org>
Subject: Re: [PATCH v5 2/4] [media] platform: Add Synopsys Designware HDMI RX
 Controller Driver

On 07/03/2017 11:53 AM, Jose Abreu wrote:
> Hi Hans,
> 
> 
> On 03-07-2017 10:27, Hans Verkuil wrote:
>> On 06/29/2017 12:46 PM, Jose Abreu wrote:
>>> This is an initial submission for the Synopsys Designware HDMI RX
>>> Controller Driver. This driver interacts with a phy driver so
>>> that
>>> a communication between them is created and a video pipeline is
>>> configured.
>>>
>>> The controller + phy pipeline can then be integrated into a fully
>>> featured system that can be able to receive video up to 4k@...z
>>> with deep color 48bit RGB, depending on the platform. Although,
>>> this initial version does not yet handle deep color modes.
>>>
>>> This driver was implemented as a standard V4L2 subdevice and its
>>> main features are:
>>>      - Internal state machine that reconfigures phy until the
>>>      video is not stable
>>>      - JTAG communication with phy
>>>      - Inter-module communication with phy driver
>>>      - Debug write/read ioctls
>>>
>>> Some notes:
>>>      - RX sense controller (cable connection/disconnection) must
>>>      be handled by the platform wrapper as this is not integrated
>>>      into the controller RTL
>>>      - The same goes for EDID ROM's
>>>      - ZCAL calibration is needed only in FPGA platforms, in ASIC
>>>      this is not needed
>>>      - The state machine is not an ideal solution as it creates a
>>>      kthread but it is needed because some sources might not be
>>>      very stable at sending the video (i.e. we must react
>>>      accordingly).
>>>
>>> Signed-off-by: Jose Abreu <joabreu@...opsys.com>
>>> Cc: Carlos Palminha <palminha@...opsys.com>
>>> Cc: Mauro Carvalho Chehab <mchehab@...nel.org>
>>> Cc: Hans Verkuil <hans.verkuil@...co.com>
>>> Cc: Sylwester Nawrocki <snawrocki@...nel.org>
>>>
>>> Changes from v4:
>>>      - Add flag V4L2_SUBDEV_FL_HAS_DEVNODE (Sylwester)
>>>      - Remove some comments and change some messages to dev_dbg
>>> (Sylwester)
>>>      - Use v4l2_async_subnotifier_register() (Sylwester)
>>> Changes from v3:
>>>      - Use v4l2 async API (Sylwester)
>>>      - Do not block waiting for phy
>>>      - Do not use busy waiting delays (Sylwester)
>>>      - Simplify dw_hdmi_power_on (Sylwester)
>>>      - Use clock API (Sylwester)
>>>      - Use compatible string (Sylwester)
>>>      - Minor fixes (Sylwester)
>>> Changes from v2:
>>>      - Address review comments from Hans regarding CEC
>>>      - Use CEC notifier
>>>      - Enable SCDC
>>> Changes from v1:
>>>      - Add support for CEC
>>>      - Correct typo errors
>>>      - Correctly detect interlaced video modes
>>>      - Correct VIC parsing
>>> Changes from RFC:
>>>      - Add support for HDCP 1.4
>>>      - Fixup HDMI_VIC not being parsed (Hans)
>>>      - Send source change signal when powering off (Hans)
>>>      - Add a "wait stable delay"
>>>      - Detect interlaced video modes (Hans)
>>>      - Restrain g/s_register from reading/writing to HDCP regs
>>> (Hans)
>>> ---
>>>    drivers/media/platform/dwc/Kconfig      |   15 +
>>>    drivers/media/platform/dwc/Makefile     |    1 +
>>>    drivers/media/platform/dwc/dw-hdmi-rx.c | 1824
>>> +++++++++++++++++++++++++++++++
>>>    drivers/media/platform/dwc/dw-hdmi-rx.h |  441 ++++++++
>>>    include/media/dwc/dw-hdmi-rx-pdata.h    |   97 ++
>>>    5 files changed, 2378 insertions(+)
>>>    create mode 100644 drivers/media/platform/dwc/dw-hdmi-rx.c
>>>    create mode 100644 drivers/media/platform/dwc/dw-hdmi-rx.h
>>>    create mode 100644 include/media/dwc/dw-hdmi-rx-pdata.h
>>>
>>> diff --git a/drivers/media/platform/dwc/Kconfig
>>> b/drivers/media/platform/dwc/Kconfig
>>> index 361d38d..3ddccde 100644
>>> --- a/drivers/media/platform/dwc/Kconfig
>>> +++ b/drivers/media/platform/dwc/Kconfig
>>> @@ -6,3 +6,18 @@ config VIDEO_DWC_HDMI_PHY_E405
>>>            To compile this driver as a module, choose M here.
>>> The module
>>>          will be called dw-hdmi-phy-e405.
>>> +
>>> +config VIDEO_DWC_HDMI_RX
>>> +    tristate "Synopsys Designware HDMI Receiver driver"
>>> +    depends on VIDEO_V4L2 && VIDEO_V4L2_SUBDEV_API
>>> +    help
>>> +      Support for Synopsys Designware HDMI RX controller.
>>> +
>>> +      To compile this driver as a module, choose M here. The
>>> module
>>> +      will be called dw-hdmi-rx.
>>> +
>>> +config VIDEO_DWC_HDMI_RX_CEC
>>> +    bool
>>> +    depends on VIDEO_DWC_HDMI_RX
>>> +    select CEC_CORE
>>> +    select CEC_NOTIFIER
>>> diff --git a/drivers/media/platform/dwc/Makefile
>>> b/drivers/media/platform/dwc/Makefile
>>> index fc3b62c..cd04ca9 100644
>>> --- a/drivers/media/platform/dwc/Makefile
>>> +++ b/drivers/media/platform/dwc/Makefile
>>> @@ -1 +1,2 @@
>>>    obj-$(CONFIG_VIDEO_DWC_HDMI_PHY_E405) += dw-hdmi-phy-e405.o
>>> +obj-$(CONFIG_VIDEO_DWC_HDMI_RX) += dw-hdmi-rx.o
>>> diff --git a/drivers/media/platform/dwc/dw-hdmi-rx.c
>>> b/drivers/media/platform/dwc/dw-hdmi-rx.c
>>> new file mode 100644
>>> index 0000000..4a7b8fc
>>> --- /dev/null
>>> +++ b/drivers/media/platform/dwc/dw-hdmi-rx.c
>>
>> <snip>

>>> +static int dw_hdmi_g_register(struct v4l2_subdev *sd,
>>> +        struct v4l2_dbg_register *reg)
>>> +{
>>> +    struct dw_hdmi_dev *dw_dev = to_dw_dev(sd);
>>> +
>>> +    switch (reg->reg >> 15) {
>>> +    case 0: /* Controller core read */
>>> +        if (dw_hdmi_is_reserved_register(dw_dev, reg->reg &
>>> 0x7fff))
>>> +            return -EINVAL;
>>
>> Is this necessary? Obviously you shouldn't be able to set it,
>> but I think it
>> should be fine to read it. Up to you, though.
> 
> Actually some of the HDCP 1.4 registers are write only and if
> someone tries to read the controller will not respond and will
> block the bus. This is no problem for x86, but for some archs it
> can block the system entirely.

Worth a comment in that case.

>>> +static const struct v4l2_subdev_video_ops
>>> dw_hdmi_sd_video_ops = {
>>> +    .s_routing = dw_hdmi_s_routing,
>>> +    .g_input_status = dw_hdmi_g_input_status,
>>> +    .g_parm = dw_hdmi_g_parm,
>>> +    .g_dv_timings = dw_hdmi_g_dv_timings,
>>> +    .query_dv_timings = dw_hdmi_query_dv_timings,
>>
>> No s_dv_timings???
> 
> Hmm, yeah, I didn't implement it because the callchain and the
> player I use just use {get/set}_fmt. s_dv_timings can just
> populate the fields and replace them with the detected dv_timings
> ? Just like set_fmt does? Because the controller has no scaler.

No, s_dv_timings is the function that actually sets dw_dev->timings.
After you check that it is valid of course (call v4l2_valid_dv_timings).

set_fmt calls get_fmt which returns the information from dw_dev->timings.

But it is s_dv_timings that has to set dw_dev->timings.

With the current code you can only capture 640x480 (the default timings).
Have you ever tested this with any other timings? I don't quite understand
how you test.

> 
>>
>>> +};
>>> +
>>> +static const struct v4l2_subdev_pad_ops dw_hdmi_sd_pad_ops = {
>>> +    .enum_mbus_code = dw_hdmi_enum_mbus_code,
>>> +    .get_fmt = dw_hdmi_get_fmt,
>>> +    .set_fmt = dw_hdmi_set_fmt,
>>> +    .dv_timings_cap = dw_hdmi_dv_timings_cap,
>>> +    .enum_dv_timings = dw_hdmi_enum_dv_timings,
>>> +};
>>> +
>>> +static const struct v4l2_subdev_ops dw_hdmi_sd_ops = {
>>> +    .core = &dw_hdmi_sd_core_ops,
>>> +    .video = &dw_hdmi_sd_video_ops,
>>> +    .pad = &dw_hdmi_sd_pad_ops,
>>> +};
>>> +
>>> +static const struct v4l2_subdev_internal_ops
>>> dw_hdmi_internal_ops = {
>>> +    .registered = dw_hdmi_registered,
>>> +    .unregistered = dw_hdmi_unregistered,
>>> +};
>>> +
>>> +static int dw_hdmi_v4l2_notify_bound(struct
>>> v4l2_async_notifier *notifier,
>>> +        struct v4l2_subdev *subdev, struct v4l2_async_subdev
>>> *asd)
>>> +{
>>> +    struct dw_hdmi_dev *dw_dev = notifier_to_dw_dev(notifier);
>>> +
>>> +    if (dw_dev->phy_async_sd.match.fwnode.fwnode ==
>>> +            of_fwnode_handle(subdev->dev->of_node)) {
>>> +        dev_dbg(dw_dev->dev, "found new subdev '%s'\n",
>>> subdev->name);
>>> +        dw_dev->phy_sd = subdev;
>>> +        return 0;
>>> +    }
>>> +
>>> +    return -EINVAL;
>>> +}
>>> +
>>> +static void dw_hdmi_v4l2_notify_unbind(struct
>>> v4l2_async_notifier *notifier,
>>> +        struct v4l2_subdev *subdev, struct v4l2_async_subdev
>>> *asd)
>>> +{
>>> +    struct dw_hdmi_dev *dw_dev = notifier_to_dw_dev(notifier);
>>> +
>>> +    if (dw_dev->phy_sd == subdev) {
>>> +        dev_dbg(dw_dev->dev, "unbinding '%s'\n", subdev->name);
>>> +        dw_dev->phy_sd = NULL;
>>> +    }
>>> +}
>>> +
>>> +static int dw_hdmi_v4l2_init_notifier(struct dw_hdmi_dev
>>> *dw_dev)
>>> +{
>>> +    struct v4l2_async_subdev **subdevs = NULL;
>>> +    struct device_node *child = NULL;
>>> +
>>> +    subdevs = devm_kzalloc(dw_dev->dev, sizeof(*subdevs),
>>> GFP_KERNEL);
>>> +    if (!subdevs)
>>> +        return -ENOMEM;
>>> +
>>> +    child = dw_hdmi_get_phy_of_node(dw_dev, NULL);
>>> +    if (!child)
>>> +        return -EINVAL;
>>> +
>>> +    dw_dev->phy_async_sd.match.fwnode.fwnode =
>>> of_fwnode_handle(child);
>>> +    dw_dev->phy_async_sd.match_type = V4L2_ASYNC_MATCH_FWNODE;
>>> +
>>> +    subdevs[0] = &dw_dev->phy_async_sd;
>>> +    dw_dev->v4l2_notifier.num_subdevs = 1;
>>> +    dw_dev->v4l2_notifier.subdevs = subdevs;
>>> +    dw_dev->v4l2_notifier.bound = dw_hdmi_v4l2_notify_bound;
>>> +    dw_dev->v4l2_notifier.unbind = dw_hdmi_v4l2_notify_unbind;
>>> +
>>> +    return 0;
>>> +}
>>> +
>>> +static int dw_hdmi_parse_dt(struct dw_hdmi_dev *dw_dev)
>>> +{
>>> +    struct device_node *notifier, *phy_node, *np =
>>> dw_dev->of_node;
>>> +    u32 tmp;
>>> +    int ret;
>>> +
>>> +    if (!np) {
>>> +        dev_err(dw_dev->dev, "missing DT node\n");
>>> +        return -EINVAL;
>>> +    }
>>> +
>>> +    /* PHY properties parsing */
>>> +    phy_node = dw_hdmi_get_phy_of_node(dw_dev, NULL);
>>> +    of_property_read_u32(phy_node, "reg", &tmp);
>>> +
>>> +    dw_dev->phy_jtag_addr = tmp & 0xff;
>>> +    if (!dw_dev->phy_jtag_addr) {
>>> +        dev_err(dw_dev->dev, "missing phy jtag address in
>>> DT\n");
>>> +        return -EINVAL;
>>> +    }
>>> +
>>> +    /* Get config clock value */
>>> +    dw_dev->clk = devm_clk_get(dw_dev->dev, "cfg");
>>> +    if (IS_ERR(dw_dev->clk)) {
>>> +        dev_err(dw_dev->dev, "failed to get cfg clock\n");
>>> +        return PTR_ERR(dw_dev->clk);
>>> +    }
>>> +
>>> +    ret = clk_prepare_enable(dw_dev->clk);
>>> +    if (ret) {
>>> +        dev_err(dw_dev->dev, "failed to enable cfg clock\n");
>>> +        return ret;
>>> +    }
>>> +
>>> +    dw_dev->cfg_clk = clk_get_rate(dw_dev->clk) / 1000000U;
>>> +    if (!dw_dev->cfg_clk) {
>>> +        dev_err(dw_dev->dev, "invalid cfg clock frequency\n");
>>> +        ret = -EINVAL;
>>> +        goto err_clk;
>>> +    }
>>> +
>>> +#if IS_ENABLED(CONFIG_VIDEO_DWC_HDMI_RX_CEC)
>>> +    /* Notifier device parsing */
>>> +    notifier = of_parse_phandle(np, "edid-phandle", 0);
>>> +    if (!notifier) {
>>> +        dev_err(dw_dev->dev, "missing edid-phandle in DT\n");
>>> +        ret = -EINVAL;
>>> +        goto err_clk;
>>> +    }
>>> +
>>> +    dw_dev->notifier_pdev = of_find_device_by_node(notifier);
>>> +    if (!dw_dev->notifier_pdev)
>>> +        return -EPROBE_DEFER;
>>> +#endif
>>> +
>>> +    return 0;
>>> +
>>> +err_clk:
>>> +    clk_disable_unprepare(dw_dev->clk);
>>> +    return ret;
>>> +}
>>> +
>>> +static int dw_hdmi_rx_probe(struct platform_device *pdev)
>>> +{
>>> +    const struct v4l2_dv_timings timings_def =
>>> HDMI_DEFAULT_TIMING;
>>> +    struct dw_hdmi_rx_pdata *pdata = pdev->dev.platform_data;
>>> +    struct device *dev = &pdev->dev;
>>> +    struct dw_hdmi_dev *dw_dev;
>>> +    struct v4l2_subdev *sd;
>>> +    struct resource *res;
>>> +    int ret, irq;
>>> +
>>> +    dev_dbg(dev, "%s\n", __func__);
>>> +
>>> +    dw_dev = devm_kzalloc(dev, sizeof(*dw_dev), GFP_KERNEL);
>>> +    if (!dw_dev)
>>> +        return -ENOMEM;
>>> +
>>> +    if (!pdata) {
>>> +        dev_err(dev, "missing platform data\n");
>>> +        return -EINVAL;
>>> +    }
>>> +
>>> +    dw_dev->dev = dev;
>>> +    dw_dev->config = pdata;
>>> +    dw_dev->state = HDMI_STATE_NO_INIT;
>>> +    dw_dev->of_node = dev->of_node;
>>> +    spin_lock_init(&dw_dev->lock);
>>> +
>>> +    ret = dw_hdmi_parse_dt(dw_dev);
>>> +    if (ret)
>>> +        return ret;
>>> +
>>> +    /* Deferred work */
>>> +    dw_dev->wq =
>>> create_singlethread_workqueue(DW_HDMI_RX_DRVNAME);
>>> +    if (!dw_dev->wq) {
>>> +        dev_err(dev, "failed to create workqueue\n");
>>> +        return -ENOMEM;
>>> +    }
>>> +
>>> +    res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
>>> +    dw_dev->regs = devm_ioremap_resource(dev, res);
>>> +    if (IS_ERR(dw_dev->regs)) {
>>> +        dev_err(dev, "failed to remap resource\n");
>>> +        ret = PTR_ERR(dw_dev->regs);
>>> +        goto err_wq;
>>> +    }
>>> +
>>> +    /* Disable HPD as soon as posssible */
>>> +    dw_hdmi_disable_hpd(dw_dev);
>>> +
>>> +    ret = dw_hdmi_config_hdcp(dw_dev);
>>> +    if (ret)
>>> +        goto err_wq;
>>> +
>>> +    irq = platform_get_irq(pdev, 0);
>>> +    if (irq < 0) {
>>> +        ret = irq;
>>> +        goto err_wq;
>>> +    }
>>> +
>>> +    ret = devm_request_threaded_irq(dev, irq, NULL,
>>> dw_hdmi_irq_handler,
>>> +            IRQF_ONESHOT, DW_HDMI_RX_DRVNAME, dw_dev);
>>> +    if (ret)
>>> +        goto err_wq;
>>> +
>>> +    irq = platform_get_irq(pdev, 1);
>>> +    if (irq < 0) {
>>> +        ret = irq;
>>> +        goto err_wq;
>>> +    }
>>> +
>>> +    ret = devm_request_threaded_irq(dev, irq,
>>> dw_hdmi_5v_hard_irq_handler,
>>> +            dw_hdmi_5v_irq_handler, IRQF_ONESHOT,
>>> +            DW_HDMI_RX_DRVNAME "-5v-handler", dw_dev);
>>> +    if (ret)
>>> +        goto err_wq;
>>> +
>>> +    /* V4L2 initialization */
>>> +    sd = &dw_dev->sd;
>>> +    v4l2_subdev_init(sd, &dw_hdmi_sd_ops);
>>> +    strlcpy(sd->name, dev_name(dev), sizeof(sd->name));
>>> +    sd->dev = dev;
>>> +    sd->internal_ops = &dw_hdmi_internal_ops;
>>> +    sd->flags |= V4L2_SUBDEV_FL_HAS_EVENTS |
>>> V4L2_SUBDEV_FL_HAS_DEVNODE;
>>
>> You need to add at this control: V4L2_CID_DV_RX_POWER_PRESENT.
>> This is a
>> read-only control that reports the 5V status. Important for
>> applications to have.
> 
> Ok.
> 
>>
>> I gather that this IP doesn't handle InfoFrames? If it does,
>> then let me know.
> 
> Yes, it handles but I didn't implement the parsing yet (I just
> parse the VIC for now).

Ah, OK. When you add that, then I strongly recommend that you also add
support for the V4L2_CID_DV_RX_RGB_RANGE control, provided this IP can
do quantization range conversion. If quantization range conversion is not
part of this IP, then just ignore this comment.

> 
>>
>>> +
>>> +    /* Notifier for subdev binding */
>>> +    ret = dw_hdmi_v4l2_init_notifier(dw_dev);
>>> +    if (ret) {
>>> +        dev_err(dev, "failed to init v4l2 notifier\n");
>>> +        goto err_wq;
>>> +    }
>>> +
>>> +    /* PHY loading */
>>> +    ret = dw_hdmi_phy_init(dw_dev);
>>> +    if (ret)
>>> +        goto err_wq;
>>> +
>>> +    /* CEC */
>>> +#if IS_ENABLED(CONFIG_VIDEO_DWC_HDMI_RX_CEC)
>>> +    dw_dev->cec_adap =
>>> cec_allocate_adapter(&dw_hdmi_cec_adap_ops,
>>> +            dw_dev, dev_name(dev), CEC_CAP_TRANSMIT |
>>> +            CEC_CAP_LOG_ADDRS | CEC_CAP_RC |
>>> CEC_CAP_PASSTHROUGH,
>>> +            HDMI_CEC_MAX_LOG_ADDRS);
>>> +    ret = PTR_ERR_OR_ZERO(dw_dev->cec_adap);
>>> +    if (ret) {
>>> +        dev_err(dev, "failed to allocate CEC adapter\n");
>>> +        goto err_phy;
>>> +    }
>>> +
>>> +    dw_dev->cec_notifier =
>>> cec_notifier_get(&dw_dev->notifier_pdev->dev);
>>> +    if (!dw_dev->cec_notifier) {
>>> +        dev_err(dev, "failed to allocate CEC notifier\n");
>>> +        ret = -ENOMEM;
>>> +        goto err_cec;
>>> +    }
>>> +
>>> +    dev_info(dev, "CEC is enabled\n");
>>> +#else
>>> +    dev_info(dev, "CEC is disabled\n");
>>> +#endif
>>> +
>>> +    ret = v4l2_async_register_subdev(sd);
>>> +    if (ret) {
>>> +        dev_err(dev, "failed to register subdev\n");
>>> +        goto err_cec;
>>> +    }
>>> +
>>> +    /* Fill initial format settings */
>>> +    dw_dev->timings = timings_def;
>>
>> Unless I missed something it appears dw_dev->timings never
>> changes value since this
>> appears to be the only assignment. I'm fairly certain you need
>> a s_dv_timings op as
>> well.
>>
>>> +    dw_dev->mbus_code = MEDIA_BUS_FMT_BGR888_1X24;
>>> +
>>> +    dev_set_drvdata(dev, sd);
>>> +    dw_dev->state = HDMI_STATE_POWER_OFF;
>>> +    dw_hdmi_detect_tx_5v(dw_dev);
>>> +    dev_dbg(dev, "driver probed\n");
>>> +    return 0;
>>> +
>>> +err_cec:
>>> +    cec_delete_adapter(dw_dev->cec_adap);
>>> +err_phy:
>>> +    dw_hdmi_phy_exit(dw_dev);
>>> +err_wq:
>>> +    destroy_workqueue(dw_dev->wq);
>>> +    return ret;
>>> +}
>>> +
>>> +static int dw_hdmi_rx_remove(struct platform_device *pdev)
>>> +{
>>> +    struct device *dev = &pdev->dev;
>>> +    struct v4l2_subdev *sd = dev_get_drvdata(dev);
>>> +    struct dw_hdmi_dev *dw_dev = to_dw_dev(sd);
>>> +
>>> +    dw_hdmi_disable_ints(dw_dev);
>>> +    dw_hdmi_disable_hpd(dw_dev);
>>> +    dw_hdmi_disable_scdc(dw_dev);
>>> +    dw_hdmi_power_off(dw_dev);
>>> +    dw_hdmi_phy_s_power(dw_dev, false);
>>> +    flush_workqueue(dw_dev->wq);
>>> +    destroy_workqueue(dw_dev->wq);
>>> +    dw_hdmi_phy_exit(dw_dev);
>>> +    v4l2_async_unregister_subdev(sd);
>>> +    clk_disable_unprepare(dw_dev->clk);
>>> +    dev_dbg(dev, "driver removed\n");
>>> +    return 0;
>>> +}
>>> +
>>> +static const struct of_device_id dw_hdmi_rx_id[] = {
>>> +    { .compatible = "snps,dw-hdmi-rx" },
>>> +    { },
>>> +};
>>> +MODULE_DEVICE_TABLE(of, dw_hdmi_rx_id);
>>> +
>>> +static struct platform_driver dw_hdmi_rx_driver = {
>>> +    .probe = dw_hdmi_rx_probe,
>>> +    .remove = dw_hdmi_rx_remove,
>>> +    .driver = {
>>> +        .name = DW_HDMI_RX_DRVNAME,
>>> +        .of_match_table = dw_hdmi_rx_id,
>>> +    }
>>> +};
>>> +module_platform_driver(dw_hdmi_rx_driver);
>>>
> 
> <snip>
> 
>>> diff --git a/include/media/dwc/dw-hdmi-rx-pdata.h
>>> b/include/media/dwc/dw-hdmi-rx-pdata.h
>>> new file mode 100644
>>> index 0000000..38c6d91
>>> --- /dev/null
>>> +++ b/include/media/dwc/dw-hdmi-rx-pdata.h
>>> @@ -0,0 +1,97 @@
>>> +/*
>>> + * Synopsys Designware HDMI Receiver controller platform data
>>> + *
>>> + * This Synopsys dw-hdmi-rx software and associated
>>> documentation
>>> + * (hereinafter the "Software") is an unsupported proprietary
>>> work of
>>> + * Synopsys, Inc. unless otherwise expressly agreed to in
>>> writing between
>>> + * Synopsys and you. The Software IS NOT an item of Licensed
>>> Software or a
>>> + * Licensed Product under any End User Software License
>>> Agreement or
>>> + * Agreement for Licensed Products with Synopsys or any
>>> supplement thereto.
>>> + * Synopsys is a registered trademark of Synopsys, Inc. Other
>>> names included
>>> + * in the SOFTWARE may be the trademarks of their respective
>>> owners.
>>> + *
>>> + * The contents of this file are dual-licensed; you may
>>> select either version 2
>>> + * of the GNU General Public License (“GPL”) or the MIT
>>> license (“MIT”).
>>> + *
>>> + * Copyright (c) 2017 Synopsys, Inc. and/or its affiliates.
>>> + *
>>> + * THIS 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
>>> THE USE OR
>>> + * OTHER DEALINGS IN THE SOFTWARE.
>>> + */
>>> +
>>> +#ifndef __DW_HDMI_RX_PDATA_H__
>>> +#define __DW_HDMI_RX_PDATA_H__
>>> +
>>> +#define DW_HDMI_RX_DRVNAME            "dw-hdmi-rx"
>>> +
>>> +/* Notify events */
>>> +#define DW_HDMI_NOTIFY_IS_OFF        1
>>> +#define DW_HDMI_NOTIFY_INPUT_CHANGED    2
>>> +#define DW_HDMI_NOTIFY_AUDIO_CHANGED    3
>>> +#define DW_HDMI_NOTIFY_IS_STABLE    4
>>> +
>>> +/* HDCP 1.4 */
>>> +#define DW_HDMI_HDCP14_BKSV_SIZE    2
>>> +#define DW_HDMI_HDCP14_KEYS_SIZE    (2 * 40)
>>> +
>>> +/**
>>> + * struct dw_hdmi_hdcp14_key - HDCP 1.4 keys structure.
>>> + *
>>> + * @seed: Seeed value for HDCP 1.4 engine (16 bits).
>>
>> Typo: Seeed -> Seed
>>
>>> + *
>>> + * @bksv: BKSV value for HDCP 1.4 engine (40 bits).
>>> + *
>>> + * @keys: Keys value for HDCP 1.4 engine (80 * 56 bits).
>>> + *
>>> + * @keys_valid: Must be set to true if the keys in this
>>> structure are valid
>>> + * and can be used by the HDMI receiver controller.
>>> + */
>>> +struct dw_hdmi_hdcp14_key {
>>> +    u32 seed;
>>> +    u32 bksv[DW_HDMI_HDCP14_BKSV_SIZE];
>>> +    u32 keys[DW_HDMI_HDCP14_KEYS_SIZE];
>>> +    bool keys_valid;
>>> +};
>>> +
>>> +/**
>>> + * struct dw_hdmi_rx_pdata - Platform Data configuration for
>>> HDMI receiver.
>>> + *
>>> + * @hdcp14_keys: Keys for HDCP 1.4 engine. See
>>> @dw_hdmi_hdcp14_key.
>>
>> Was this for debugging only? These are the Device Private Keys
>> you're talking about?
>>
>> If this is indeed the case, then this doesn't belong here. You
>> should never rely on
>> software to set these keys. It should be fused in the hardware,
>> or read from an
>> encrypted eeprom or something like that. None of this
>> (including the bksv) should
>> be settable from the driver. You can read the bksv since that's
>> public.
>>
>> This can't be in a kernel driver, nor can it be set or read
>> through the s_register API.
>>
>> Instead there should be a big fat disclaimer that how you
>> program these keys is up to
>> the hardware designer and that it should be in accordance to
>> the HDCP requirements.
>>
>> I would drop this completely from the pdata. My recommendation
>> would be to not include
>> HDCP support at all for this first version. Add it in follow-up
>> patches which include
>> a new V4L2 API for handling HDCP. This needs to be handled
>> carefully.
> 
> Yes, in real HW these keys will not be handled this way. I'm
> using a prototyping system so its easier to debug. I will remove
> this entirely and drop HDCP 1.4 support for now.
> 
> Hmm, I'm seeing the configuration flow for keys written in HW and
> it actually just needs a seed (for encrypted keys, for decrypted
> ones it just doesn't need anything). Shall I drop the support or
> change the code? I've no way to test this right now though...

Drop the support. I don't want to mix this in with the other code. HDCP
support should be done in a separate patch series once this is merged.
That way I can give it the attention it deserves.

Regards,

	Hans

> 
> Best regards,
> Jose Miguel Abreu
> 
>>
>>> + *
>>> + * @dw_5v_status: 5v status callback. Shall return the status
>>> of the given
>>> + * input, i.e. shall be true if a cable is connected to the
>>> specified input.
>>> + *
>>> + * @dw_5v_clear: 5v clear callback. Shall clear the interrupt
>>> associated with
>>> + * the 5v sense controller.
>>> + *
>>> + * @dw_5v_arg: Argument to be used with the 5v sense callbacks.
>>> + *
>>> + * @dw_zcal_reset: Impedance calibration reset callback.
>>> Shall be called when
>>> + * the impedance calibration needs to be restarted. This is
>>> used by phy driver
>>> + * only.
>>> + *
>>> + * @dw_zcal_done: Impendace calibration status callback.
>>> Shall return true if
>>
>> Typo: Impendace -> Impedance
>>
>>> + * the impedance calibration procedure has ended. This is
>>> used by phy driver
>>> + * only.
>>> + *
>>> + * @dw_zcal_arg: Argument to be used with the ZCAL
>>> calibration callbacks.
>>> + */
>>> +struct dw_hdmi_rx_pdata {
>>> +    /* Controller configuration */
>>> +    struct dw_hdmi_hdcp14_key hdcp14_keys;
>>> +    /* 5V sense interface */
>>> +    bool (*dw_5v_status)(void __iomem *regs, int input);
>>> +    void (*dw_5v_clear)(void __iomem *regs);
>>> +    void __iomem *dw_5v_arg;
>>> +    /* Zcal interface */
>>> +    void (*dw_zcal_reset)(void __iomem *regs);
>>> +    bool (*dw_zcal_done)(void __iomem *regs);
>>> +    void __iomem *dw_zcal_arg;
>>> +};
>>> +
>>> +#endif /* __DW_HDMI_RX_PDATA_H__ */
>>>
>>
>> Regards,
>>
>>      Hans
> 

Powered by blists - more mailing lists