Hi Dafna, Am Montag, 18. Januar 2021, 10:19:41 CET schrieb Dafna Hirschfeld: > Am 15.01.21 um 21:29 schrieb Heiko Stübner: > > Am Freitag, 15. Januar 2021, 20:42:41 CET schrieb Laurent Pinchart: > >> On Fri, Jan 15, 2021 at 05:38:28PM +0100, Heiko Stuebner wrote: > >>> From: Heiko Stuebner <heiko.stuebner@xxxxxxxxxxxxxxxxxxxxx> > >>> > >>> The IP block evolved from its rk3288/rk3399 base and the vendor > >>> designates them with a numerical version. rk3399 for example > >>> is designated V10 probably meaning V1.0. > >>> > >>> There doesn't seem to be an actual version register we could read that > >>> information from, so allow the match_data to carry that information > >>> for future differentiation. > >>> > >>> Also carry that information in the hw_revision field of the media- > >>> controller API, so that userspace also has access to that. > >>> > >>> The added versions are: > >>> - V10: at least rk3288 + rk3399 > >>> - V11: seemingly unused as of now, but probably appeared in some soc > >>> - V12: at least rk3326 + px30 > >>> - V13: at least rk1808 > >> > >> In addition to changes to the ISP itself, are there changes in how it is > >> integrated in the system, in particular in how it is connected to CSI-2 > >> receivers ? > > > > Hooking up my camera on the px30 was pretty straightforward. > > As you can see in [0] the actual csi-phy block is different, but structurally > > everything else stayed the same and the px30 series merely accounts > > for some isp-specific changes, like the split interrupts and the V12-specific > > parts. > > > > > >> Do all the above SoCs have two ISP instances ? > > > > Nope, I think only the rk3399 has two ISPs. > > > > All others only seem to have one instance and maybe an additional more > > simple video input processor. (like the rk3288 has both an ISP and something > > called VIP - a simpler block) > > > > Similar is the rk3326/px30 (same soc) which has an ISP as well as a VIP that > > Maxime Chevallier is working on [1] > > > > Heiko > > > > [0] https://lore.kernel.org/linux-media/20210108193311.3423236-1-heiko@xxxxxxxxx/ > > [1] https://lore.kernel.org/linux-devicetree/20201229161724.511102-1-maxime.chevallier@xxxxxxxxxxx/ > > > > > >>> Signed-off-by: Heiko Stuebner <heiko.stuebner@xxxxxxxxxxxxxxxxxxxxx> > >>> Reviewed-by: Ezequiel Garcia <ezequiel@xxxxxxxxxxxxx> > >>> --- > >>> Documentation/admin-guide/media/rkisp1.rst | 16 ++++++++++++++ > >>> .../platform/rockchip/rkisp1/rkisp1-dev.c | 21 +++++++++++-------- > >>> include/uapi/linux/rkisp1-config.h | 16 ++++++++++++++ > >>> 3 files changed, 44 insertions(+), 9 deletions(-) > >>> > >>> diff --git a/Documentation/admin-guide/media/rkisp1.rst b/Documentation/admin-guide/media/rkisp1.rst > >>> index 2267e4fb475e..ccf418713623 100644 > >>> --- a/Documentation/admin-guide/media/rkisp1.rst > >>> +++ b/Documentation/admin-guide/media/rkisp1.rst > >>> @@ -13,6 +13,22 @@ This file documents the driver for the Rockchip ISP1 that is part of RK3288 > >>> and RK3399 SoCs. The driver is located under drivers/staging/media/rkisp1 > >>> and uses the Media-Controller API. > >>> > >>> +Revisions > >>> +========= > >>> + > >>> +There exist multiple smaller revisions to this ISP that got introduced in > >>> +later SoCs. Revisions can be found in the enum :c:type:`rkisp1_cif_isp_version` > >>> +in the UAPI and the revision of the ISP inside the running SoC can be read > >>> +in the field hw_revision of struct media_device_info as returned by > >>> +ioctl MEDIA_IOC_DEVICE_INFO. > >>> + > >>> +Versions in use are: > >>> + > >>> +- RKISP1_V10: used at least in rk3288 and rk3399 > >>> +- RKISP1_V11: declared in the original vendor code, but not used > >>> +- RKISP1_V12: used at least in rk3326 and px30 > >>> +- RKISP1_V13: used at least in rk1808 > >>> + > >>> Topology > >>> ======== > >>> .. _rkisp1_topology_graph: > >>> diff --git a/drivers/media/platform/rockchip/rkisp1/rkisp1-dev.c b/drivers/media/platform/rockchip/rkisp1/rkisp1-dev.c > >>> index 68da1eed753d..f7e9fd305548 100644 > >>> --- a/drivers/media/platform/rockchip/rkisp1/rkisp1-dev.c > >>> +++ b/drivers/media/platform/rockchip/rkisp1/rkisp1-dev.c > >>> @@ -104,6 +104,7 @@ > >>> struct rkisp1_match_data { > >>> const char * const *clks; > >>> unsigned int size; > >>> + enum rkisp1_cif_isp_version isp_ver; > >>> }; > >>> > >>> /* ---------------------------------------------------------------------------- > >>> @@ -411,15 +412,16 @@ static const char * const rk3399_isp_clks[] = { > >>> "hclk", > >>> }; > >>> > >>> -static const struct rkisp1_match_data rk3399_isp_clk_data = { > >>> +static const struct rkisp1_match_data rk3399_isp_match_data = { > >>> .clks = rk3399_isp_clks, > >>> .size = ARRAY_SIZE(rk3399_isp_clks), > >>> + .isp_ver = RKISP1_V10, > >>> }; > >>> > >>> static const struct of_device_id rkisp1_of_match[] = { > >>> { > >>> .compatible = "rockchip,rk3399-cif-isp", > >>> - .data = &rk3399_isp_clk_data, > >>> + .data = &rk3399_isp_match_data, > >>> }, > >>> {}, > >>> }; > >>> @@ -457,15 +459,15 @@ static void rkisp1_debug_init(struct rkisp1_device *rkisp1) > >>> > >>> static int rkisp1_probe(struct platform_device *pdev) > >>> { > >>> - const struct rkisp1_match_data *clk_data; > >>> + const struct rkisp1_match_data *match_data; > >>> struct device *dev = &pdev->dev; > >>> struct rkisp1_device *rkisp1; > >>> struct v4l2_device *v4l2_dev; > >>> unsigned int i; > >>> int ret, irq; > >>> > >>> - clk_data = of_device_get_match_data(&pdev->dev); > >>> - if (!clk_data) > >>> + match_data = of_device_get_match_data(&pdev->dev); > >>> + if (!match_data) > >>> return -ENODEV; > >>> > >>> rkisp1 = devm_kzalloc(dev, sizeof(*rkisp1), GFP_KERNEL); > >>> @@ -494,15 +496,16 @@ static int rkisp1_probe(struct platform_device *pdev) > >>> > >>> rkisp1->irq = irq; > >>> > >>> - for (i = 0; i < clk_data->size; i++) > >>> - rkisp1->clks[i].id = clk_data->clks[i]; > >>> - ret = devm_clk_bulk_get(dev, clk_data->size, rkisp1->clks); > >>> + for (i = 0; i < match_data->size; i++) > >>> + rkisp1->clks[i].id = match_data->clks[i]; > >>> + ret = devm_clk_bulk_get(dev, match_data->size, rkisp1->clks); > >>> if (ret) > >>> return ret; > >>> - rkisp1->clk_size = clk_data->size; > >>> + rkisp1->clk_size = match_data->size; > >>> > >>> pm_runtime_enable(&pdev->dev); > >>> > >>> + rkisp1->media_dev.hw_revision = match_data->isp_ver; > >>> strscpy(rkisp1->media_dev.model, RKISP1_DRIVER_NAME, > >>> sizeof(rkisp1->media_dev.model)); > >>> rkisp1->media_dev.dev = &pdev->dev; > >>> diff --git a/include/uapi/linux/rkisp1-config.h b/include/uapi/linux/rkisp1-config.h > >>> index ba443771cc0b..9fecb6bc457d 100644 > >>> --- a/include/uapi/linux/rkisp1-config.h > >>> +++ b/include/uapi/linux/rkisp1-config.h > >>> @@ -124,6 +124,22 @@ > >>> #define RKISP1_CIF_ISP_STAT_AFM (1U << 2) > >>> #define RKISP1_CIF_ISP_STAT_HIST (1U << 3) > >>> > >>> + > >>> +/** > >>> + * enum rkisp1_cif_isp_version - ISP variants > >>> + * > >>> + * @RKISP1_V10: used at least in rk3288 and rk3399 > >>> + * @RKISP1_V11: declared in the original vendor code, but not used > >>> + * @RKISP1_V12: used at least in rk3326 and px30 > >>> + * @RKISP1_V13: used at least in rk1808 > >>> + */ > >>> +enum rkisp1_cif_isp_version { > >>> + RKISP1_V10 = 0, > > I wonder if it is useful to start the enum with: > RKISP1_V10 = 10, > > So when printing the hw revision it always prints a positive number. makes sense ... also if userspace prints the value somewhere, it's readable without knowing the constants - will change with the v5 I'm preparing. Heiko