[PATCH v2] video: s3c-fb: Add device tree support

Jingoo Han jg1.han at samsung.com
Fri Apr 6 13:25:47 EST 2012


On Fri, Mar 30, 2012 at 2:23, Thomas Abraham <thomas.abraham at linaro.org> wrote:
> Subject: [PATCH v2] video: s3c-fb: Add device tree support
> 
> Add device tree based discovery support for Samsung's display controller
> framebuffer driver.
> 
> Cc: Jingoo Han <jg1.han at samsung.com>
> Cc: Grant Likely <grant.likely at secretlab.ca>
> Cc: Rob Herring <rob.herring at calxeda.com>
> Signed-off-by: Thomas Abraham <thomas.abraham at linaro.org>
> ---
>  .../devicetree/bindings/fb/samsung-fb.txt          |  148 +++++++++++++
>  drivers/video/s3c-fb.c                             |  230 +++++++++++++++++++-
>  2 files changed, 370 insertions(+), 8 deletions(-)
>  create mode 100644 Documentation/devicetree/bindings/fb/samsung-fb.txt
> 
> diff --git a/Documentation/devicetree/bindings/fb/samsung-fb.txt
> b/Documentation/devicetree/bindings/fb/samsung-fb.txt
> new file mode 100644
> index 0000000..612bd9f
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/fb/samsung-fb.txt
> @@ -0,0 +1,148 @@
> +* Samsung Display Controller Framebuffer Controller
> +
> +The display controller is used to transfer image data from memory to a
> +external display device such as an RGB interface LCD panel. It supports
> +various color formats such as rgb and yuv. It also supports multiple window
> +overlays.
> +
> +Required properties:
> +
> +    - compatible: should be one of the following
> +      - samsung,exynos4210-fimd: for fimd compatible with Exynos4210 fimd
> +      - samsung,s5pv210-fimd: for fimd compatible with s5pv210 fimd
> +
> +    - reg: physical base address of the controller and length of memory
> +      mapped region.
> +
> +    - interrupts: Three interrupts should be specified. The format of the
> +      interrupt specifier depends on the interrupt controller. The interrupts
> +      should be specified in the following order.
> +      - VSYNC (Video Frame) interrupt
> +      - Video FIFO level interrupt
> +      - FIMD System Interrupt
> +
> +    - gpios: The gpios used to interface with the external LCD panel. For a
> +      panel with rgb interface, the gpio interface consists of video data
> +      lines, HSYNC, VSYNC, Pixel Clock and Data Enable. The gpio's used for
> +      these interface lines can be listed under this property in any order.
> +
> +    - samsung,fimd-display: The fimd controller is interfaced with the a
> +      display device such as a lcd panel. This property should specify the
> +      phandle of the display device node. For a display device node that
> +      represents a RGB type display interface, it is expected to specify the
> +      video interface timing using the following properties.
> +
> +      - lcd-htiming: Specifies the horizontal timing for the overlay. The
> +        horizontal timing includes four parameters in the following order.
> +
> +        - horizontal back porch (in number of lcd clocks)
> +        - horizontal front porch (in number of lcd clocks)
> +        - hsync pulse width (in number of lcd clocks)
> +        - Display panels X resolution.
> +
> +      - lcd-vtiming: Specifies the vertical timing for the overlay. The
> +        vertical timing includes four parameters in the following order.
> +
> +        - vertical back porch (in number of lcd lines)
> +        - vertical front porch (in number of lcd lines)
> +        - vsync pulse width (in number of lcd clocks)
> +        - Y resolution.
> +
> +    - Overlay/Windows: Multiple overlays/windows can be specified as child
> +      nodes. Each window should have the following properties (optional
> +      window properties are marked as 'optional').
> +
> +      - samsung,fimd-win-id: Specifies the window number of the fimd controller.
> +
> +      - samsung,fimd-win-bpp: Specifies the bits per pixel. Two values should
> +	be specified in the following order.
> +        - default-bpp: bpp supported by the overlay.
> +        - max-bpp: maximum required bpp for the overlay.
> +
> +      - samsung,fimd-win-res: (OPTIONAL) Specifies the window resolution in
> +        pixels. The resolution contains the X and Y pixel values with X being
> +        specified first. If this property is not specified, the window
> +        resolution is set to be equal to the display panel resolution.
> +
> +      - samsung,fimd-win-virtres: (OPTIONAL) Specifies the resolution of the
> +        virtual frame buffer for the window. The resolution contains the X
> +        and Y resolution in pixels with value of X being the specified first.
> +
> +Optional properties:
> +
> +    - samsung,fimd-vidout-rgb: Video output format is RGB.
> +    - samsung,fimd-inv-hsync: invert hsync pulse polarity.
> +    - samsung,fimd-inv-vsync: invert vsync pulse polarity.
> +    - samsung,fimd-inv-vclk: invert video clock polarity.
> +    - samsung,fimd-inv-vden: invert video enable signal polarity.
> +    - samsung,fimd-frame-rate: Number of video frames per second.
> +
> +Example:
> +
> +    The following is an example for the fimd framebuffer controller is split
> +    into two portions. The SoC specific portion can be specified in the SoC
> +    specific dts file. The board specific portion can be specified in the
> +    board specific dts file.
> +
> +    - SoC Specific portion
> +
> +	fimd at 11C00000 {
> +		compatible = "samsung,exynos4210-fimd";
> +		interrupt-parent = <&combiner>;
> +		reg = <0x11C00000 0x8000>;
> +		interrupts = <11 1>, <11 0>, <11 2>;
> +	};
> +
> +    - Board Specific portion
> +
> +	fimd at 11C00000 {
> +		samsung,fimd-display = <&lcd_fimd0>;
> +		samsung,fimd-vidout-rgb;
> +		samsung,fimd-inv-hsync;
> +		samsung,fimd-inv-vsync;
> +		samsung,fimd-inv-vclk;
> +		samsung,fimd-frame-rate = <60>;
> +
> +		gpios = <&gpf0 0 2 0 0>,
> +			<&gpf0 1 2 0 0>,
> +			<&gpf0 2 2 0 0>,
> +			<&gpf0 3 2 0 0>,
> +			<&gpf0 4 2 0 0>,
> +			<&gpf0 5 2 0 0>,
> +			<&gpf0 6 2 0 0>,
> +			<&gpf0 7 2 0 0>,
> +			<&gpf1 0 2 0 0>,
> +			<&gpf1 1 2 0 0>,
> +			<&gpf1 2 2 0 0>,
> +			<&gpf1 3 2 0 0>,
> +			<&gpf1 4 2 0 0>,
> +			<&gpf1 5 2 0 0>,
> +			<&gpf1 6 2 0 0>,
> +			<&gpf1 7 2 0 0>,
> +			<&gpf2 0 2 0 0>,
> +			<&gpf2 1 2 0 0>,
> +			<&gpf2 2 2 0 0>,
> +			<&gpf2 3 2 0 0>,
> +			<&gpf2 4 2 0 0>,
> +			<&gpf2 5 2 0 0>,
> +			<&gpf2 6 2 0 0>,
> +			<&gpf2 7 2 0 0>,
> +			<&gpf3 0 2 0 0>,
> +			<&gpf3 1 2 0 0>,
> +			<&gpf3 2 2 0 0>,
> +			<&gpf3 3 2 0 0>;
> +
> +		window0 {
> +			samsung,fimd-win-id = <0>;
> +			samsung,fimd-win-bpp = <32 24>;
> +			samsung,fimd-win-res = <512 300>;
> +			samsung,fimd-win-vres = <1024 600>;
> +		};
> +
> +		window1 {
> +			samsung,fimd-win-id = <1>;
> +			samsung,fimd-win-bpp = <32 24>;
> +			samsung,fimd-win-res = <1024 200>;
> +			samsung,fimd-win-vres = <1024 600>;
> +		};
> +	};
> diff --git a/drivers/video/s3c-fb.c b/drivers/video/s3c-fb.c
> index 18c84b8..b8be668 100644
> --- a/drivers/video/s3c-fb.c
> +++ b/drivers/video/s3c-fb.c
> @@ -24,6 +24,8 @@
>  #include <linux/uaccess.h>
>  #include <linux/interrupt.h>
>  #include <linux/pm_runtime.h>
> +#include <linux/of.h>
> +#include <linux/of_gpio.h>
> 
>  #include <mach/map.h>
>  #include <plat/regs-fb-v4.h>
> @@ -220,6 +222,7 @@ struct s3c_fb {
>  	int			 irq_no;
>  	unsigned long		 irq_flags;
>  	struct s3c_fb_vsync	 vsync_info;
> +	int			 *gpios;
>  };
> 
>  /**
> @@ -1352,27 +1355,215 @@ static void s3c_fb_clear_win(struct s3c_fb *sfb, int win)
>  	writel(reg & ~SHADOWCON_WINx_PROTECT(win), regs + SHADOWCON);
>  }
> 
> +#ifdef CONFIG_OF
> +static int s3c_fb_dt_parse_gpios(struct device *dev, struct s3c_fb *sfb,
> +						bool request)
> +{
> +	int nr_gpios, idx, gpio, ret;
> +
> +	nr_gpios = sfb->pdata->win[0]->max_bpp + 4;
> +	sfb->gpios = devm_kzalloc(dev, sizeof(int) * nr_gpios, GFP_KERNEL);
> +	if (!sfb->gpios) {
> +		dev_err(dev, "unable to allocate private data for gpio\n");
> +		return -ENOMEM;
> +	}
> +
> +	for (idx = 0; idx < nr_gpios; idx++) {
> +		gpio = of_get_gpio(dev->of_node, idx);
> +		if (!gpio_is_valid(gpio)) {
> +			dev_err(dev, "invalid gpio[%d]: %d\n", idx, gpio);
> +			return -EINVAL;
> +		}
> +
> +		if (!request)
> +			continue;
> +
> +		ret = gpio_request(gpio, "fimd");
> +		if (ret) {
> +			dev_err(dev, "gpio [%d] request failed\n", gpio);
> +			goto gpio_free;
> +		}
> +		sfb->gpios[idx] = gpio;
> +	}
> +	return 0;
> +
> +gpio_free:
> +	while (--idx >= 0)
> +		gpio_free(sfb->gpios[idx]);
> +	return ret;
> +}
> +
> +static void s3c_fb_dt_free_gpios(struct s3c_fb *sfb)
> +{
> +	unsigned int idx, nr_gpio;
> +
> +	nr_gpio = sfb->pdata->win[0]->max_bpp + 4;
> +	for (idx = 0; idx < nr_gpio; idx++)
> +		gpio_free(sfb->gpios[idx]);
> +}
> +
> +static struct s3c_fb_platdata *s3c_fb_dt_parse_pdata(struct device *dev)
> +{
> +	struct device_node *np = dev->of_node, *win_np;
> +	struct device_node *disp_np;
> +	struct s3c_fb_platdata *pd;
> +	struct s3c_fb_pd_win *win;
> +	u32 wnum = 0, data[4];
> +
> +	pd = devm_kzalloc(dev, sizeof(*pd), GFP_KERNEL);
> +	if (!pd) {
> +		dev_err(dev, "memory allocation for pdata failed\n");
> +		return ERR_PTR(-ENOMEM);
> +	}
> +
> +	pd->vtiming = devm_kzalloc(dev, sizeof(*pd->vtiming), GFP_KERNEL);
> +	if (!pd->vtiming) {
> +		dev_err(dev, "memory allocation for vtiming failed\n");
> +		return ERR_PTR(-ENOMEM);
> +	}
> +
> +	if (of_get_property(np, "samsung,fimd-vidout-rgb", NULL))
> +		pd->vidcon0 |= VIDCON0_VIDOUT_RGB;
> +	if (of_get_property(np, "samsung,fimd-vidout-tv", NULL))
> +		pd->vidcon0 |= VIDCON0_VIDOUT_TV;
> +	if (of_get_property(np, "samsung,fimd-inv-hsync", NULL))
> +		pd->vidcon1 |= VIDCON1_INV_HSYNC;
> +	if (of_get_property(np, "samsung,fimd-inv-vsync", NULL))
> +		pd->vidcon1 |= VIDCON1_INV_VSYNC;
> +	if (of_get_property(np, "samsung,fimd-inv-vclk", NULL))
> +		pd->vidcon1 |= VIDCON1_INV_VCLK;
> +	if (of_get_property(np, "samsung,fimd-inv-vden", NULL))
> +		pd->vidcon1 |= VIDCON1_INV_VDEN;
> +
> +	disp_np = of_parse_phandle(np, "samsung,fimd-display", 0);
> +	if (!disp_np) {
> +		dev_err(dev, "unable to find display panel info\n");
> +		return ERR_PTR(-EINVAL);
> +	}
> +
> +	if (of_property_read_u32_array(disp_np, "lcd-htiming", data, 4)) {
> +		dev_err(dev, "invalid horizontal timing\n");
> +		return ERR_PTR(-EINVAL);
> +	}
> +	pd->vtiming->left_margin = data[0];
> +	pd->vtiming->right_margin = data[1];
> +	pd->vtiming->hsync_len = data[2];
> +	pd->vtiming->xres = data[3];
> +
> +	if (of_property_read_u32_array(disp_np, "lcd-vtiming", data, 4)) {
> +		dev_err(dev, "invalid vertical timing\n");
> +		return ERR_PTR(-EINVAL);
> +	}
> +	pd->vtiming->upper_margin = data[0];
> +	pd->vtiming->lower_margin = data[1];
> +	pd->vtiming->vsync_len = data[2];
> +	pd->vtiming->yres = data[3];
> +
> +	of_property_read_u32_array(np, "samsung,fimd-frame-rate",
> +				&pd->vtiming->refresh, 1);
> +
> +	for_each_child_of_node(np, win_np) {
> +		if (of_property_read_u32_array(win_np, "samsung,fimd-win-id",
> +						&wnum, 1)) {
> +			dev_err(dev, "window id not specified\n");
> +			return ERR_PTR(-EINVAL);
> +		}
> +
> +		win = devm_kzalloc(dev, sizeof(*win), GFP_KERNEL);
> +		if (!win) {
> +			dev_err(dev, "no memory for window[%d] data\n", wnum);
> +			return ERR_PTR(-ENOMEM);
> +		}
> +		pd->win[wnum] = win;
> +
> +		if (of_property_read_u32_array(win_np, "samsung,fimd-win-bpp",
> +						data, 2)) {
> +			dev_err(dev, "invalid window bpp\n");
> +			return ERR_PTR(-EINVAL);
> +		}
> +		win->default_bpp = data[0];
> +		win->max_bpp = data[1];
> +
> +		if (of_property_read_u32_array(win_np, "samsung,fimd-win-res",
> +						data, 2)) {
> +			dev_info(dev, "window [%d] resolution not specified. "
> +				"Using lcd resolution X[%d] and Y[%d]", wnum,
> +				pd->vtiming->xres, pd->vtiming->yres);
> +			win->xres = pd->vtiming->xres;
> +			win->yres = pd->vtiming->yres;
> +		} else {
> +			win->xres = data[0];
> +			win->yres = data[1];
> +		}
> +
> +		if (!of_property_read_u32_array(win_np,
> +				"samsung,fimd-win-virtres", data, 2)) {
> +			win->virtual_x = data[0];
> +			win->virtual_y = data[1];
> +		}
> +	}
> +
> +	return pd;
> +}
> +#else
> +static int s3c_fb_dt_parse_gpios(struct device *dev, struct s3c_fb *sfb,
> +						bool request)
> +{
> +	return 0;
> +}
> +
> +static void s3c_fb_dt_free_gpios(struct s3c_fb *sfb)
> +{
> +	return 0;

It makes build warning.

drivers/video/s3c-fb.c: In function 's3c_fb_dt_free_gpios':
drivers/video/s3c-fb.c:1523: warning: 'return' with a value, in function returning void

> +}
> +
> +static int s3c_fb_dt_parse_pdata(struct device *dev,
> +					struct s3c_fb_platdata **pdata)

It makes build error when CONFIG_OF is disabled.
Please, do build with disabling CONFIG_OF.

drivers/video/s3c-fb.c: In function 's3c_fb_probe':
drivers/video/s3c-fb.c:1568: error: too few arguments to function 's3c_fb_dt_parse_pdata'

> +{
> +	return 0;
> +}
> +#endif /* CONFIG_OF */
> +
> +static const struct of_device_id s3c_fb_dt_match[];
> +
> +static inline struct s3c_fb_driverdata *s3c_fb_get_driver_data(
> +			struct platform_device *pdev)
> +{
> +#ifdef CONFIG_OF
> +	if (pdev->dev.of_node) {
> +		const struct of_device_id *match;
> +		match = of_match_node(s3c_fb_dt_match, pdev->dev.of_node);
> +		return (struct s3c_fb_driverdata *)match->data;
> +	}
> +#endif
> +	return (struct s3c_fb_driverdata *)
> +			platform_get_device_id(pdev)->driver_data;
> +}
> +
>  static int __devinit s3c_fb_probe(struct platform_device *pdev)
>  {
> -	const struct platform_device_id *platid;
>  	struct s3c_fb_driverdata *fbdrv;
>  	struct device *dev = &pdev->dev;
> -	struct s3c_fb_platdata *pd;
> +	struct s3c_fb_platdata *pd = pdev->dev.platform_data;
>  	struct s3c_fb *sfb;
>  	struct resource *res;
>  	int win;
>  	int ret = 0;
>  	u32 reg;
> 
> -	platid = platform_get_device_id(pdev);
> -	fbdrv = (struct s3c_fb_driverdata *)platid->driver_data;
> +	fbdrv = s3c_fb_get_driver_data(pdev);
> 
>  	if (fbdrv->variant.nr_windows > S3C_FB_MAX_WIN) {
>  		dev_err(dev, "too many windows, cannot attach\n");
>  		return -EINVAL;
>  	}
> 
> -	pd = pdev->dev.platform_data;
> +	if (pdev->dev.of_node) {
> +		pd = s3c_fb_dt_parse_pdata(&pdev->dev);
> +		if (IS_ERR(pd))
> +			return PTR_ERR(pd);
> +	}
> +
>  	if (!pd) {
>  		dev_err(dev, "no platform data specified\n");
>  		return -EINVAL;
> @@ -1449,7 +1640,12 @@ static int __devinit s3c_fb_probe(struct platform_device *pdev)
> 
>  	/* setup gpio and output polarity controls */
> 
> -	pd->setup_gpio();
> +	if (dev->of_node) {
> +		if (s3c_fb_dt_parse_gpios(dev, sfb, true))
> +			goto err_lcd_clk;
> +	} else {
> +		pd->setup_gpio();
> +	}
> 
>  	writel(pd->vidcon1, sfb->regs + VIDCON1);
> 
> @@ -1499,6 +1695,7 @@ static int __devinit s3c_fb_probe(struct platform_device *pdev)
>  	return 0;
> 
>  err_pm_runtime:
> +	s3c_fb_dt_free_gpios(sfb);
>  	pm_runtime_put_sync(sfb->dev);
> 
>  err_lcd_clk:
> @@ -1545,6 +1742,7 @@ static int __devexit s3c_fb_remove(struct platform_device *pdev)
> 
>  	pm_runtime_put_sync(sfb->dev);
>  	pm_runtime_disable(sfb->dev);
> +	s3c_fb_dt_free_gpios(sfb);
> 
>  	return 0;
>  }
> @@ -1588,7 +1786,10 @@ static int s3c_fb_resume(struct device *dev)
>  		clk_enable(sfb->lcd_clk);
> 
>  	/* setup gpio and output polarity controls */
> -	pd->setup_gpio();
> +	if (dev->of_node)
> +		s3c_fb_dt_parse_gpios(dev, sfb, false);
> +	else
> +		pd->setup_gpio();
>  	writel(pd->vidcon1, sfb->regs + VIDCON1);
> 
>  	/* set video clock running at under-run */
> @@ -1658,7 +1859,10 @@ static int s3c_fb_runtime_resume(struct device *dev)
>  		clk_enable(sfb->lcd_clk);
> 
>  	/* setup gpio and output polarity controls */
> -	pd->setup_gpio();
> +	if (dev->of_node)
> +		s3c_fb_dt_parse_gpios(dev, sfb, false);
> +	else
> +		pd->setup_gpio();
>  	writel(pd->vidcon1, sfb->regs + VIDCON1);
> 
>  	return 0;
> @@ -2028,6 +2232,15 @@ static struct platform_device_id s3c_fb_driver_ids[] = {
>  };
>  MODULE_DEVICE_TABLE(platform, s3c_fb_driver_ids);
> 
> +#ifdef CONFIG_OF
> +static const struct of_device_id s3c_fb_dt_match[] = {
> +	{ .compatible = "samsung,exynos4210-fimd",
> +		.data = (void *)&s3c_fb_data_exynos4 },
> +	{},
> +};
> +MODULE_DEVICE_TABLE(of, s3c_fb_dt_match);
> +#endif
> +
>  static const struct dev_pm_ops s3cfb_pm_ops = {
>  	SET_SYSTEM_SLEEP_PM_OPS(s3c_fb_suspend, s3c_fb_resume)
>  	SET_RUNTIME_PM_OPS(s3c_fb_runtime_suspend, s3c_fb_runtime_resume,
> @@ -2042,6 +2255,7 @@ static struct platform_driver s3c_fb_driver = {
>  		.name	= "s3c-fb",
>  		.owner	= THIS_MODULE,
>  		.pm	= &s3cfb_pm_ops,
> +		.of_match_table	= of_match_ptr(s3c_fb_dt_match),
>  	},
>  };
> 
> --
> 1.6.6.rc2



More information about the devicetree-discuss mailing list