drm: rcar-du: Fix comments to comply with the kernel coding style
authorLaurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
Mon, 10 Jul 2017 22:13:20 +0000 (01:13 +0300)
committerLaurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
Thu, 3 Aug 2017 13:17:22 +0000 (16:17 +0300)
To avoid mixing comment styles when new comments complying with the
kernel coding style are introduced, fix all multiline comments in one
go.

Signed-off-by: Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
Acked-by: Kieran Bingham <kieran.bingham+renesas@ideasonboard.com>
drivers/gpu/drm/rcar-du/rcar_du_crtc.c
drivers/gpu/drm/rcar-du/rcar_du_drv.c
drivers/gpu/drm/rcar-du/rcar_du_group.c
drivers/gpu/drm/rcar-du/rcar_du_kms.c
drivers/gpu/drm/rcar-du/rcar_du_lvdsenc.c
drivers/gpu/drm/rcar-du/rcar_du_plane.c
drivers/gpu/drm/rcar-du/rcar_du_plane.h
drivers/gpu/drm/rcar-du/rcar_du_vsp.c

index f131fc68cc4699716e078ba35c3f4544fba8c6ad..a04802f7b2f1cd128d72eb49c9e80276ed3ddbe3 100644 (file)
@@ -168,7 +168,8 @@ static void rcar_du_crtc_set_display_timing(struct rcar_du_crtc *rcrtc)
        u32 escr;
        u32 div;
 
-       /* Compute the clock divisor and select the internal or external dot
+       /*
+        * Compute the clock divisor and select the internal or external dot
         * clock based on the requested frequency.
         */
        clk = clk_get_rate(rcrtc->clock);
@@ -261,12 +262,14 @@ void rcar_du_crtc_route_output(struct drm_crtc *crtc,
        struct rcar_du_crtc *rcrtc = to_rcar_crtc(crtc);
        struct rcar_du_device *rcdu = rcrtc->group->dev;
 
-       /* Store the route from the CRTC output to the DU output. The DU will be
+       /*
+        * Store the route from the CRTC output to the DU output. The DU will be
         * configured when starting the CRTC.
         */
        rcrtc->outputs |= BIT(output);
 
-       /* Store RGB routing to DPAD0, the hardware will be configured when
+       /*
+        * Store RGB routing to DPAD0, the hardware will be configured when
         * starting the CRTC.
         */
        if (output == RCAR_DU_OUTPUT_DPAD0)
@@ -342,7 +345,8 @@ static void rcar_du_crtc_update_planes(struct rcar_du_crtc *rcrtc)
                }
        }
 
-       /* Update the planes to display timing and dot clock generator
+       /*
+        * Update the planes to display timing and dot clock generator
         * associations.
         *
         * Updating the DPTSR register requires restarting the CRTC group,
@@ -450,7 +454,8 @@ static void rcar_du_crtc_start(struct rcar_du_crtc *rcrtc)
        /* Start with all planes disabled. */
        rcar_du_group_write(rcrtc->group, rcrtc->index % 2 ? DS2PR : DS1PR, 0);
 
-       /* Select master sync mode. This enables display operation in master
+       /*
+        * Select master sync mode. This enables display operation in master
         * sync mode (with the HSYNC and VSYNC signals configured as outputs and
         * actively driven).
         */
@@ -478,7 +483,8 @@ static void rcar_du_crtc_stop(struct rcar_du_crtc *rcrtc)
        if (!rcrtc->started)
                return;
 
-       /* Disable all planes and wait for the change to take effect. This is
+       /*
+        * Disable all planes and wait for the change to take effect. This is
         * required as the DSnPR registers are updated on vblank, and no vblank
         * will occur once the CRTC is stopped. Disabling planes when starting
         * the CRTC thus wouldn't be enough as it would start scanning out
@@ -491,7 +497,8 @@ static void rcar_du_crtc_stop(struct rcar_du_crtc *rcrtc)
        rcar_du_group_write(rcrtc->group, rcrtc->index % 2 ? DS2PR : DS1PR, 0);
        drm_crtc_wait_one_vblank(crtc);
 
-       /* Disable vertical blanking interrupt reporting. We first need to wait
+       /*
+        * Disable vertical blanking interrupt reporting. We first need to wait
         * for page flip completion before stopping the CRTC as userspace
         * expects page flips to eventually complete.
         */
@@ -502,7 +509,8 @@ static void rcar_du_crtc_stop(struct rcar_du_crtc *rcrtc)
        if (rcar_du_has(rcrtc->group->dev, RCAR_DU_FEATURE_VSP1_SOURCE))
                rcar_du_vsp_disable(rcrtc);
 
-       /* Select switch sync mode. This stops display operation and configures
+       /*
+        * Select switch sync mode. This stops display operation and configures
         * the HSYNC and VSYNC signals as inputs.
         */
        rcar_du_crtc_clr_set(rcrtc, DSYSR, DSYSR_TVM_MASK, DSYSR_TVM_SWITCH);
index d6a0255181ccea6c1883bdb2946c82937aa1b61c..b95437bccb3daba487ecb8e8767781aff2787566 100644 (file)
@@ -39,7 +39,8 @@ static const struct rcar_du_device_info rcar_du_r8a7779_info = {
        .features = 0,
        .num_crtcs = 2,
        .routes = {
-               /* R8A7779 has two RGB outputs and one (currently unsupported)
+               /*
+                * R8A7779 has two RGB outputs and one (currently unsupported)
                 * TCON output.
                 */
                [RCAR_DU_OUTPUT_DPAD0] = {
@@ -61,7 +62,8 @@ static const struct rcar_du_device_info rcar_du_r8a7790_info = {
        .quirks = RCAR_DU_QUIRK_ALIGN_128B | RCAR_DU_QUIRK_LVDS_LANES,
        .num_crtcs = 3,
        .routes = {
-               /* R8A7790 has one RGB output, two LVDS outputs and one
+               /*
+                * R8A7790 has one RGB output, two LVDS outputs and one
                 * (currently unsupported) TCON output.
                 */
                [RCAR_DU_OUTPUT_DPAD0] = {
@@ -87,7 +89,8 @@ static const struct rcar_du_device_info rcar_du_r8a7791_info = {
                  | RCAR_DU_FEATURE_EXT_CTRL_REGS,
        .num_crtcs = 2,
        .routes = {
-               /* R8A779[13] has one RGB output, one LVDS output and one
+               /*
+                * R8A779[13] has one RGB output, one LVDS output and one
                 * (currently unsupported) TCON output.
                 */
                [RCAR_DU_OUTPUT_DPAD0] = {
@@ -127,7 +130,8 @@ static const struct rcar_du_device_info rcar_du_r8a7794_info = {
                  | RCAR_DU_FEATURE_EXT_CTRL_REGS,
        .num_crtcs = 2,
        .routes = {
-               /* R8A7794 has two RGB outputs and one (currently unsupported)
+               /*
+                * R8A7794 has two RGB outputs and one (currently unsupported)
                 * TCON output.
                 */
                [RCAR_DU_OUTPUT_DPAD0] = {
@@ -149,7 +153,8 @@ static const struct rcar_du_device_info rcar_du_r8a7795_info = {
                  | RCAR_DU_FEATURE_VSP1_SOURCE,
        .num_crtcs = 4,
        .routes = {
-               /* R8A7795 has one RGB output, two HDMI outputs and one
+               /*
+                * R8A7795 has one RGB output, two HDMI outputs and one
                 * LVDS output.
                 */
                [RCAR_DU_OUTPUT_DPAD0] = {
@@ -180,7 +185,8 @@ static const struct rcar_du_device_info rcar_du_r8a7796_info = {
                  | RCAR_DU_FEATURE_VSP1_SOURCE,
        .num_crtcs = 3,
        .routes = {
-               /* R8A7796 has one RGB output, one LVDS output and one
+               /*
+                * R8A7796 has one RGB output, one LVDS output and one
                 * (currently unsupported) HDMI output.
                 */
                [RCAR_DU_OUTPUT_DPAD0] = {
@@ -341,7 +347,8 @@ static int rcar_du_probe(struct platform_device *pdev)
 
        ddev->irq_enabled = 1;
 
-       /* Register the DRM device with the core and the connectors with
+       /*
+        * Register the DRM device with the core and the connectors with
         * sysfs.
         */
        ret = drm_dev_register(ddev, 0);
index 64738fca96d04acfa0515a020f24ffa07dea036c..a3e29bb420fd0f85c3197b06770c2a803098cc12 100644 (file)
@@ -64,7 +64,8 @@ static void rcar_du_group_setup_defr8(struct rcar_du_group *rgrp)
        if (rcdu->info->gen < 3) {
                defr8 |= DEFR8_DEFE8;
 
-               /* On Gen2 the DEFR8 register for the first group also controls
+               /*
+                * On Gen2 the DEFR8 register for the first group also controls
                 * RGB output routing to DPAD0 and VSPD1 routing to DU0/1/2 for
                 * DU instances that support it.
                 */
@@ -75,7 +76,8 @@ static void rcar_du_group_setup_defr8(struct rcar_du_group *rgrp)
                                defr8 |= DEFR8_VSCS;
                }
        } else {
-               /* On Gen3 VSPD routing can't be configured, but DPAD routing
+               /*
+                * On Gen3 VSPD routing can't be configured, but DPAD routing
                 * needs to be set despite having a single option available.
                 */
                u32 crtc = ffs(possible_crtcs) - 1;
@@ -124,7 +126,8 @@ static void rcar_du_group_setup(struct rcar_du_group *rgrp)
        if (rcdu->info->gen >= 3)
                rcar_du_group_write(rgrp, DEFR10, DEFR10_CODE | DEFR10_DEFE10);
 
-       /* Use DS1PR and DS2PR to configure planes priorities and connects the
+       /*
+        * Use DS1PR and DS2PR to configure planes priorities and connects the
         * superposition 0 to DU0 pins. DU1 pins will be configured dynamically.
         */
        rcar_du_group_write(rgrp, DORCR, DORCR_PG1D_DS1 | DORCR_DPRS);
@@ -177,7 +180,8 @@ static void __rcar_du_group_start_stop(struct rcar_du_group *rgrp, bool start)
 
 void rcar_du_group_start_stop(struct rcar_du_group *rgrp, bool start)
 {
-       /* Many of the configuration bits are only updated when the display
+       /*
+        * Many of the configuration bits are only updated when the display
         * reset (DRES) bit in DSYSR is set to 1, disabling *both* CRTCs. Some
         * of those bits could be pre-configured, but others (especially the
         * bits related to plane assignment to display timing controllers) need
@@ -213,7 +217,8 @@ int rcar_du_set_dpad0_vsp1_routing(struct rcar_du_device *rcdu)
        if (!rcar_du_has(rcdu, RCAR_DU_FEATURE_EXT_CTRL_REGS))
                return 0;
 
-       /* RGB output routing to DPAD0 and VSP1D routing to DU0/1/2 are
+       /*
+        * RGB output routing to DPAD0 and VSP1D routing to DU0/1/2 are
         * configured in the DEFR8 register of the first group. As this function
         * can be called with the DU0 and DU1 CRTCs disabled, we need to enable
         * the first group clock before accessing the register.
@@ -236,7 +241,8 @@ int rcar_du_group_set_routing(struct rcar_du_group *rgrp)
 
        dorcr &= ~(DORCR_PG2T | DORCR_DK2S | DORCR_PG2D_MASK);
 
-       /* Set the DPAD1 pins sources. Select CRTC 0 if explicitly requested and
+       /*
+        * Set the DPAD1 pins sources. Select CRTC 0 if explicitly requested and
         * CRTC 1 in all other cases to avoid cloning CRTC 0 to DPAD0 and DPAD1
         * by default.
         */
index 48961896c53ec48cd14fd0a3d6fd4bb4111ce20a..1a0a0ce3e01c4f9ee5f1cc3eeaf101f482532391 100644 (file)
@@ -96,7 +96,8 @@ static const struct rcar_du_format_info rcar_du_format_infos[] = {
                .pnmr = PnMR_SPIM_TP_OFF | PnMR_DDDF_YC,
                .edf = PnDDCR4_EDF_NONE,
        },
-       /* The following formats are not supported on Gen2 and thus have no
+       /*
+        * The following formats are not supported on Gen2 and thus have no
         * associated .pnmr or .edf settings.
         */
        {
@@ -153,7 +154,8 @@ int rcar_du_dumb_create(struct drm_file *file, struct drm_device *dev,
        unsigned int min_pitch = DIV_ROUND_UP(args->width * args->bpp, 8);
        unsigned int align;
 
-       /* The R8A7779 DU requires a 16 pixels pitch alignment as documented,
+       /*
+        * The R8A7779 DU requires a 16 pixels pitch alignment as documented,
         * but the R8A7790 DU seems to require a 128 bytes pitch alignment.
         */
        if (rcar_du_needs(rcdu, RCAR_DU_QUIRK_ALIGN_128B))
@@ -419,7 +421,8 @@ static int rcar_du_properties_init(struct rcar_du_device *rcdu)
        if (rcdu->props.alpha == NULL)
                return -ENOMEM;
 
-       /* The color key is expressed as an RGB888 triplet stored in a 32-bit
+       /*
+        * The color key is expressed as an RGB888 triplet stored in a 32-bit
         * integer in XRGB8888 format. Bit 24 is used as a flag to disable (0)
         * or enable source color keying (1).
         */
@@ -461,7 +464,8 @@ int rcar_du_modeset_init(struct rcar_du_device *rcdu)
        if (ret < 0)
                return ret;
 
-       /* Initialize vertical blanking interrupts handling. Start with vblank
+       /*
+        * Initialize vertical blanking interrupts handling. Start with vblank
         * disabled for all CRTCs.
         */
        ret = drm_vblank_init(dev, (1 << rcdu->info->num_crtcs) - 1);
@@ -481,7 +485,8 @@ int rcar_du_modeset_init(struct rcar_du_device *rcdu)
                rgrp->index = i;
                rgrp->num_crtcs = min(rcdu->num_crtcs - 2 * i, 2U);
 
-               /* If we have more than one CRTCs in this group pre-associate
+               /*
+                * If we have more than one CRTCs in this group pre-associate
                 * the low-order planes with CRTC 0 and the high-order planes
                 * with CRTC 1 to minimize flicker occurring when the
                 * association is changed.
@@ -537,7 +542,8 @@ int rcar_du_modeset_init(struct rcar_du_device *rcdu)
 
        num_encoders = ret;
 
-       /* Set the possible CRTCs and possible clones. There's always at least
+       /*
+        * Set the possible CRTCs and possible clones. There's always at least
         * one way for all encoders to clone each other, set all bits in the
         * possible clones field.
         */
index 1661f620121005398956028dfc8c291aac96238a..12d22f3db1af0fd992693711080f87a3ca8bee5c 100644 (file)
@@ -59,7 +59,8 @@ static void rcar_du_lvdsenc_start_gen2(struct rcar_du_lvdsenc *lvds,
 
        rcar_lvds_write(lvds, LVDPLLCR, pllcr);
 
-       /* Select the input, hardcode mode 0, enable LVDS operation and turn
+       /*
+        * Select the input, hardcode mode 0, enable LVDS operation and turn
         * bias circuitry on.
         */
        lvdcr0 = (lvds->mode << LVDCR0_LVMD_SHIFT) | LVDCR0_BEN | LVDCR0_LVEN;
@@ -73,7 +74,8 @@ static void rcar_du_lvdsenc_start_gen2(struct rcar_du_lvdsenc *lvds,
                        LVDCR1_CHSTBY_GEN2(1) | LVDCR1_CHSTBY_GEN2(0) |
                        LVDCR1_CLKSTBY_GEN2);
 
-       /* Turn the PLL on, wait for the startup delay, and turn the output
+       /*
+        * Turn the PLL on, wait for the startup delay, and turn the output
         * on.
         */
        lvdcr0 |= LVDCR0_PLLON;
@@ -140,7 +142,8 @@ static int rcar_du_lvdsenc_start(struct rcar_du_lvdsenc *lvds,
        if (ret < 0)
                return ret;
 
-       /* Hardcode the channels and control signals routing for now.
+       /*
+        * Hardcode the channels and control signals routing for now.
         *
         * HSYNC -> CTRL0
         * VSYNC -> CTRL1
@@ -202,7 +205,8 @@ void rcar_du_lvdsenc_atomic_check(struct rcar_du_lvdsenc *lvds,
 {
        struct rcar_du_device *rcdu = lvds->dev;
 
-       /* The internal LVDS encoder has a restricted clock frequency operating
+       /*
+        * The internal LVDS encoder has a restricted clock frequency operating
         * range (30MHz to 150MHz on Gen2, 25.175MHz to 148.5MHz on Gen3). Clamp
         * the clock accordingly.
         */
index dcde6288da6c9dabf4a340c9802c842b2e5f2d28..b0040478a3db6dc336cc7f81c427a32b46b96fb0 100644 (file)
@@ -57,7 +57,8 @@ static bool rcar_du_plane_needs_realloc(struct rcar_du_plane *plane,
 
        cur_state = to_rcar_plane_state(plane->plane.state);
 
-       /* Lowering the number of planes doesn't strictly require reallocation
+       /*
+        * Lowering the number of planes doesn't strictly require reallocation
         * as the extra hardware plane will be freed when committing, but doing
         * so could lead to more fragmentation.
         */
@@ -155,7 +156,8 @@ int rcar_du_atomic_check_planes(struct drm_device *dev,
                dev_dbg(rcdu->dev, "%s: checking plane (%u,%tu)\n", __func__,
                        plane->group->index, plane - plane->group->planes);
 
-               /* If the plane is being disabled we don't need to go through
+               /*
+                * If the plane is being disabled we don't need to go through
                 * the full reallocation procedure. Just mark the hardware
                 * plane(s) as freed.
                 */
@@ -168,7 +170,8 @@ int rcar_du_atomic_check_planes(struct drm_device *dev,
                        continue;
                }
 
-               /* If the plane needs to be reallocated mark it as such, and
+               /*
+                * If the plane needs to be reallocated mark it as such, and
                 * mark the hardware plane(s) as free.
                 */
                if (rcar_du_plane_needs_realloc(plane, plane_state)) {
@@ -186,7 +189,8 @@ int rcar_du_atomic_check_planes(struct drm_device *dev,
        if (!needs_realloc)
                return 0;
 
-       /* Grab all plane states for the groups that need reallocation to ensure
+       /*
+        * Grab all plane states for the groups that need reallocation to ensure
         * locking and avoid racy updates. This serializes the update operation,
         * but there's not much we can do about it as that's the hardware
         * design.
@@ -211,7 +215,8 @@ int rcar_du_atomic_check_planes(struct drm_device *dev,
                        if (IS_ERR(s))
                                return PTR_ERR(s);
 
-                       /* If the plane has been freed in the above loop its
+                       /*
+                        * If the plane has been freed in the above loop its
                         * hardware planes must not be added to the used planes
                         * bitmask. However, the current state doesn't reflect
                         * the free state yet, as we've modified the new state
@@ -259,14 +264,16 @@ int rcar_du_atomic_check_planes(struct drm_device *dev,
                dev_dbg(rcdu->dev, "%s: allocating plane (%u,%tu)\n", __func__,
                        plane->group->index, plane - plane->group->planes);
 
-               /* Skip planes that are being disabled or don't need to be
+               /*
+                * Skip planes that are being disabled or don't need to be
                 * reallocated.
                 */
                if (!plane_state->format ||
                    !rcar_du_plane_needs_realloc(plane, plane_state))
                        continue;
 
-               /* Try to allocate the plane from the free planes currently
+               /*
+                * Try to allocate the plane from the free planes currently
                 * associated with the target CRTC to avoid restarting the CRTC
                 * group and thus minimize flicker. If it fails fall back to
                 * allocating from all free planes.
@@ -351,14 +358,16 @@ static void rcar_du_plane_setup_scanout(struct rcar_du_group *rgrp,
                dma[1] = 0;
        }
 
-       /* Memory pitch (expressed in pixels). Must be doubled for interlaced
+       /*
+        * Memory pitch (expressed in pixels). Must be doubled for interlaced
         * operation with 32bpp formats.
         */
        rcar_du_plane_write(rgrp, index, PnMWR,
                            (interlaced && state->format->bpp == 32) ?
                            pitch * 2 : pitch);
 
-       /* The Y position is expressed in raster line units and must be doubled
+       /*
+        * The Y position is expressed in raster line units and must be doubled
         * for 32bpp formats, according to the R8A7790 datasheet. No mention of
         * doubling the Y position is found in the R8A7779 datasheet, but the
         * rule seems to apply there as well.
@@ -396,7 +405,8 @@ static void rcar_du_plane_setup_mode(struct rcar_du_group *rgrp,
        u32 colorkey;
        u32 pnmr;
 
-       /* The PnALPHAR register controls alpha-blending in 16bpp formats
+       /*
+        * The PnALPHAR register controls alpha-blending in 16bpp formats
         * (ARGB1555 and XRGB1555).
         *
         * For ARGB, set the alpha value to 0, and enable alpha-blending when
@@ -413,7 +423,8 @@ static void rcar_du_plane_setup_mode(struct rcar_du_group *rgrp,
 
        pnmr = PnMR_BM_MD | state->format->pnmr;
 
-       /* Disable color keying when requested. YUV formats have the
+       /*
+        * Disable color keying when requested. YUV formats have the
         * PnMR_SPIM_TP_OFF bit set in their pnmr field, disabling color keying
         * automatically.
         */
@@ -457,7 +468,8 @@ static void rcar_du_plane_setup_format_gen2(struct rcar_du_group *rgrp,
        u32 ddcr2 = PnDDCR2_CODE;
        u32 ddcr4;
 
-       /* Data format
+       /*
+        * Data format
         *
         * The data format is selected by the DDDF field in PnMR and the EDF
         * field in DDCR4.
@@ -589,7 +601,8 @@ static void rcar_du_plane_atomic_update(struct drm_plane *plane,
 
        rcar_du_plane_setup(rplane);
 
-       /* Check whether the source has changed from memory to live source or
+       /*
+        * Check whether the source has changed from memory to live source or
         * from live source to memory. The source has been configured by the
         * VSPS bit in the PnDDCR4 register. Although the datasheet states that
         * the bit is updated during vertical blanking, it seems that updates
@@ -726,7 +739,8 @@ int rcar_du_planes_init(struct rcar_du_group *rgrp)
        unsigned int i;
        int ret;
 
-        /* Create one primary plane per CRTC in this group and seven overlay
+        /*
+         * Create one primary plane per CRTC in this group and seven overlay
          * planes.
          */
        rgrp->num_planes = rgrp->num_crtcs + 7;
index 8b91dd3a46e44992971a2f5025329bb124136a1e..f62e09f195de595316972e22df221dad1fbfd6e2 100644 (file)
@@ -20,7 +20,8 @@
 struct rcar_du_format_info;
 struct rcar_du_group;
 
-/* The RCAR DU has 8 hardware planes, shared between primary and overlay planes.
+/*
+ * The RCAR DU has 8 hardware planes, shared between primary and overlay planes.
  * As using overlay planes requires at least one of the CRTCs being enabled, no
  * more than 7 overlay planes can be available. We thus create 1 primary plane
  * per CRTC and 7 overlay planes, for a total of up to 9 KMS planes.
index d46dce054442f97b480b4d2ee605c59d264c9de1..75853ce369d49d5567e50efceae01528f9d16ba6 100644 (file)
@@ -73,7 +73,8 @@ void rcar_du_vsp_enable(struct rcar_du_crtc *crtc)
 
        __rcar_du_plane_setup(crtc->group, &state);
 
-       /* Ensure that the plane source configuration takes effect by requesting
+       /*
+        * Ensure that the plane source configuration takes effect by requesting
         * a restart of the group. See rcar_du_plane_atomic_update() for a more
         * detailed explanation.
         *
@@ -417,7 +418,8 @@ int rcar_du_vsp_init(struct rcar_du_vsp *vsp)
        if (ret < 0)
                return ret;
 
-        /* The VSP2D (Gen3) has 5 RPFs, but the VSP1D (Gen2) is limited to
+        /*
+         * The VSP2D (Gen3) has 5 RPFs, but the VSP1D (Gen2) is limited to
          * 4 RPFs.
          */
        vsp->num_planes = rcdu->info->gen >= 3 ? 5 : 4;