forked from mirrors/linux
		
	Amlogic SoCs have a repository of 256 canvas which they use to describe pixel buffers. They contain metadata like width, height, block mode, endianness [..] Many IPs within those SoCs like vdec/vpu rely on those canvas to read/write pixels. Reviewed-by: Jerome Brunet <jbrunet@baylibre.com> Tested-by: Neil Armstrong <narmstrong@baylibre.com> Signed-off-by: Maxime Jourdan <mjourdan@baylibre.com> Signed-off-by: Kevin Hilman <khilman@baylibre.com>
		
			
				
	
	
		
			65 lines
		
	
	
	
		
			1.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			65 lines
		
	
	
	
		
			1.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* SPDX-License-Identifier: GPL-2.0+ */
 | 
						|
/*
 | 
						|
 * Copyright (C) 2018 BayLibre, SAS
 | 
						|
 */
 | 
						|
#ifndef __SOC_MESON_CANVAS_H
 | 
						|
#define __SOC_MESON_CANVAS_H
 | 
						|
 | 
						|
#include <linux/kernel.h>
 | 
						|
 | 
						|
#define MESON_CANVAS_WRAP_NONE	0x00
 | 
						|
#define MESON_CANVAS_WRAP_X	0x01
 | 
						|
#define MESON_CANVAS_WRAP_Y	0x02
 | 
						|
 | 
						|
#define MESON_CANVAS_BLKMODE_LINEAR	0x00
 | 
						|
#define MESON_CANVAS_BLKMODE_32x32	0x01
 | 
						|
#define MESON_CANVAS_BLKMODE_64x64	0x02
 | 
						|
 | 
						|
#define MESON_CANVAS_ENDIAN_SWAP16	0x1
 | 
						|
#define MESON_CANVAS_ENDIAN_SWAP32	0x3
 | 
						|
#define MESON_CANVAS_ENDIAN_SWAP64	0x7
 | 
						|
#define MESON_CANVAS_ENDIAN_SWAP128	0xf
 | 
						|
 | 
						|
struct meson_canvas;
 | 
						|
 | 
						|
/**
 | 
						|
 * meson_canvas_get() - get a canvas provider instance
 | 
						|
 *
 | 
						|
 * @dev: consumer device pointer
 | 
						|
 */
 | 
						|
struct meson_canvas *meson_canvas_get(struct device *dev);
 | 
						|
 | 
						|
/**
 | 
						|
 * meson_canvas_alloc() - take ownership of a canvas
 | 
						|
 *
 | 
						|
 * @canvas: canvas provider instance retrieved from meson_canvas_get()
 | 
						|
 * @canvas_index: will be filled with the canvas ID
 | 
						|
 */
 | 
						|
int meson_canvas_alloc(struct meson_canvas *canvas, u8 *canvas_index);
 | 
						|
 | 
						|
/**
 | 
						|
 * meson_canvas_free() - remove ownership from a canvas
 | 
						|
 *
 | 
						|
 * @canvas: canvas provider instance retrieved from meson_canvas_get()
 | 
						|
 * @canvas_index: canvas ID that was obtained via meson_canvas_alloc()
 | 
						|
 */
 | 
						|
int meson_canvas_free(struct meson_canvas *canvas, u8 canvas_index);
 | 
						|
 | 
						|
/**
 | 
						|
 * meson_canvas_config() - configure a canvas
 | 
						|
 *
 | 
						|
 * @canvas: canvas provider instance retrieved from meson_canvas_get()
 | 
						|
 * @canvas_index: canvas ID that was obtained via meson_canvas_alloc()
 | 
						|
 * @addr: physical address to the pixel buffer
 | 
						|
 * @stride: width of the buffer
 | 
						|
 * @height: height of the buffer
 | 
						|
 * @wrap: undocumented
 | 
						|
 * @blkmode: block mode (linear, 32x32, 64x64)
 | 
						|
 * @endian: byte swapping (swap16, swap32, swap64, swap128)
 | 
						|
 */
 | 
						|
int meson_canvas_config(struct meson_canvas *canvas, u8 canvas_index,
 | 
						|
			u32 addr, u32 stride, u32 height,
 | 
						|
			unsigned int wrap, unsigned int blkmode,
 | 
						|
			unsigned int endian);
 | 
						|
 | 
						|
#endif
 |