linux/drivers/gpu/drm/omapdrm/omap_dmm_tiler.h

/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * Copyright (C) 2011 Texas Instruments Incorporated - https://www.ti.com/
 * Author: Rob Clark <[email protected]>
 *         Andy Gross <[email protected]>
 */
#ifndef OMAP_DMM_TILER_H
#define OMAP_DMM_TILER_H

#include "omap_drv.h"
#include "tcm.h"

enum tiler_fmt { … };

struct pat_area { … };

struct tiler_block { … };

/* bits representing the same slot in DMM-TILER hw-block */
#define SLOT_WIDTH_BITS …
#define SLOT_HEIGHT_BITS …

/* bits reserved to describe coordinates in DMM-TILER hw-block */
#define CONT_WIDTH_BITS …
#define CONT_HEIGHT_BITS …

/* calculated constants */
#define TILER_PAGE …
#define TILER_WIDTH …
#define TILER_HEIGHT …

/*
Table 15-11. Coding and Description of TILER Orientations
S Y X	Description				Alternate description
0 0 0	0-degree view				Natural view
0 0 1	0-degree view with vertical mirror 	180-degree view with horizontal mirror
0 1 0	0-degree view with horizontal mirror 	180-degree view with vertical mirror
0 1 1	180-degree view
1 0 0	90-degree view with vertical mirror	270-degree view with horizontal mirror
1 0 1	270-degree view
1 1 0	90-degree view
1 1 1	90-degree view with horizontal mirror	270-degree view with vertical mirror
 */
#define MASK_XY_FLIP …
#define MASK_Y_INVERT …
#define MASK_X_INVERT …
#define SHIFT_ACC_MODE …
#define MASK_ACC_MODE …

#define MASK(bits) …

#define TILVIEW_8BIT …
#define TILVIEW_16BIT …
#define TILVIEW_32BIT …
#define TILVIEW_PAGE …
#define TILVIEW_END …

/* create tsptr by adding view orientation and access mode */
#define TIL_ADDR(x, orient, a) …

#ifdef CONFIG_DEBUG_FS
int tiler_map_show(struct seq_file *s, void *arg);
#endif

/* pin/unpin */
int tiler_pin(struct tiler_block *block, struct page **pages,
		u32 npages, u32 roll, bool wait);
int tiler_unpin(struct tiler_block *block);

/* reserve/release */
struct tiler_block *tiler_reserve_2d(enum tiler_fmt fmt, u16 w, u16 h,
				u16 align);
struct tiler_block *tiler_reserve_1d(size_t size);
int tiler_release(struct tiler_block *block);

/* utilities */
dma_addr_t tiler_ssptr(struct tiler_block *block);
dma_addr_t tiler_tsptr(struct tiler_block *block, u32 orient,
		u32 x, u32 y);
u32 tiler_stride(enum tiler_fmt fmt, u32 orient);
size_t tiler_size(enum tiler_fmt fmt, u16 w, u16 h);
size_t tiler_vsize(enum tiler_fmt fmt, u16 w, u16 h);
void tiler_align(enum tiler_fmt fmt, u16 *w, u16 *h);
u32 tiler_get_cpu_cache_flags(void);
bool dmm_is_available(void);

extern struct platform_driver omap_dmm_driver;

/* GEM bo flags -> tiler fmt */
static inline enum tiler_fmt gem2fmt(u32 flags)
{ … }

static inline bool validfmt(enum tiler_fmt fmt)
{ … }

#endif