alistair23-linux/drivers/staging/sm750fb/sm750_accel.h
Greg Kroah-Hartman b24413180f License cleanup: add SPDX GPL-2.0 license identifier to files with no license
Many source files in the tree are missing licensing information, which
makes it harder for compliance tools to determine the correct license.

By default all files without license information are under the default
license of the kernel, which is GPL version 2.

Update the files which contain no license information with the 'GPL-2.0'
SPDX license identifier.  The SPDX identifier is a legally binding
shorthand, which can be used instead of the full boiler plate text.

This patch is based on work done by Thomas Gleixner and Kate Stewart and
Philippe Ombredanne.

How this work was done:

Patches were generated and checked against linux-4.14-rc6 for a subset of
the use cases:
 - file had no licensing information it it.
 - file was a */uapi/* one with no licensing information in it,
 - file was a */uapi/* one with existing licensing information,

Further patches will be generated in subsequent months to fix up cases
where non-standard license headers were used, and references to license
had to be inferred by heuristics based on keywords.

The analysis to determine which SPDX License Identifier to be applied to
a file was done in a spreadsheet of side by side results from of the
output of two independent scanners (ScanCode & Windriver) producing SPDX
tag:value files created by Philippe Ombredanne.  Philippe prepared the
base worksheet, and did an initial spot review of a few 1000 files.

The 4.13 kernel was the starting point of the analysis with 60,537 files
assessed.  Kate Stewart did a file by file comparison of the scanner
results in the spreadsheet to determine which SPDX license identifier(s)
to be applied to the file. She confirmed any determination that was not
immediately clear with lawyers working with the Linux Foundation.

Criteria used to select files for SPDX license identifier tagging was:
 - Files considered eligible had to be source code files.
 - Make and config files were included as candidates if they contained >5
   lines of source
 - File already had some variant of a license header in it (even if <5
   lines).

All documentation files were explicitly excluded.

The following heuristics were used to determine which SPDX license
identifiers to apply.

 - when both scanners couldn't find any license traces, file was
   considered to have no license information in it, and the top level
   COPYING file license applied.

   For non */uapi/* files that summary was:

   SPDX license identifier                            # files
   ---------------------------------------------------|-------
   GPL-2.0                                              11139

   and resulted in the first patch in this series.

   If that file was a */uapi/* path one, it was "GPL-2.0 WITH
   Linux-syscall-note" otherwise it was "GPL-2.0".  Results of that was:

   SPDX license identifier                            # files
   ---------------------------------------------------|-------
   GPL-2.0 WITH Linux-syscall-note                        930

   and resulted in the second patch in this series.

 - if a file had some form of licensing information in it, and was one
   of the */uapi/* ones, it was denoted with the Linux-syscall-note if
   any GPL family license was found in the file or had no licensing in
   it (per prior point).  Results summary:

   SPDX license identifier                            # files
   ---------------------------------------------------|------
   GPL-2.0 WITH Linux-syscall-note                       270
   GPL-2.0+ WITH Linux-syscall-note                      169
   ((GPL-2.0 WITH Linux-syscall-note) OR BSD-2-Clause)    21
   ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause)    17
   LGPL-2.1+ WITH Linux-syscall-note                      15
   GPL-1.0+ WITH Linux-syscall-note                       14
   ((GPL-2.0+ WITH Linux-syscall-note) OR BSD-3-Clause)    5
   LGPL-2.0+ WITH Linux-syscall-note                       4
   LGPL-2.1 WITH Linux-syscall-note                        3
   ((GPL-2.0 WITH Linux-syscall-note) OR MIT)              3
   ((GPL-2.0 WITH Linux-syscall-note) AND MIT)             1

   and that resulted in the third patch in this series.

 - when the two scanners agreed on the detected license(s), that became
   the concluded license(s).

 - when there was disagreement between the two scanners (one detected a
   license but the other didn't, or they both detected different
   licenses) a manual inspection of the file occurred.

 - In most cases a manual inspection of the information in the file
   resulted in a clear resolution of the license that should apply (and
   which scanner probably needed to revisit its heuristics).

 - When it was not immediately clear, the license identifier was
   confirmed with lawyers working with the Linux Foundation.

 - If there was any question as to the appropriate license identifier,
   the file was flagged for further research and to be revisited later
   in time.

In total, over 70 hours of logged manual review was done on the
spreadsheet to determine the SPDX license identifiers to apply to the
source files by Kate, Philippe, Thomas and, in some cases, confirmation
by lawyers working with the Linux Foundation.

Kate also obtained a third independent scan of the 4.13 code base from
FOSSology, and compared selected files where the other two scanners
disagreed against that SPDX file, to see if there was new insights.  The
Windriver scanner is based on an older version of FOSSology in part, so
they are related.

Thomas did random spot checks in about 500 files from the spreadsheets
for the uapi headers and agreed with SPDX license identifier in the
files he inspected. For the non-uapi files Thomas did random spot checks
in about 15000 files.

In initial set of patches against 4.14-rc6, 3 files were found to have
copy/paste license identifier errors, and have been fixed to reflect the
correct identifier.

Additionally Philippe spent 10 hours this week doing a detailed manual
inspection and review of the 12,461 patched files from the initial patch
version early this week with:
 - a full scancode scan run, collecting the matched texts, detected
   license ids and scores
 - reviewing anything where there was a license detected (about 500+
   files) to ensure that the applied SPDX license was correct
 - reviewing anything where there was no detection but the patch license
   was not GPL-2.0 WITH Linux-syscall-note to ensure that the applied
   SPDX license was correct

This produced a worksheet with 20 files needing minor correction.  This
worksheet was then exported into 3 different .csv files for the
different types of files to be modified.

These .csv files were then reviewed by Greg.  Thomas wrote a script to
parse the csv files and add the proper SPDX tag to the file, in the
format that the file expected.  This script was further refined by Greg
based on the output to detect more types of files automatically and to
distinguish between header and source .c files (which need different
comment types.)  Finally Greg ran the script using the .csv files to
generate the patches.

Reviewed-by: Kate Stewart <kstewart@linuxfoundation.org>
Reviewed-by: Philippe Ombredanne <pombredanne@nexb.com>
Reviewed-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2017-11-02 11:10:55 +01:00

227 lines
11 KiB
C

/* SPDX-License-Identifier: GPL-2.0 */
#ifndef ACCEL_H__
#define ACCEL_H__
#define HW_ROP2_COPY 0xc
#define HW_ROP2_XOR 0x6
/* notes: below address are the offset value from de_base_address (0x100000)*/
/* for sm718/750/502 de_base is at mmreg_1mb*/
#define DE_BASE_ADDR_TYPE1 0x100000
/* for sm712,de_base is at mmreg_32kb */
#define DE_BASE_ADDR_TYPE2 0x8000
/* for sm722,de_base is at mmreg_0 */
#define DE_BASE_ADDR_TYPE3 0
/* type1 data port address is at mmreg_0x110000*/
#define DE_PORT_ADDR_TYPE1 0x110000
/* for sm712,data port address is at mmreg_0 */
#define DE_PORT_ADDR_TYPE2 0x100000
/* for sm722,data port address is at mmreg_1mb */
#define DE_PORT_ADDR_TYPE3 0x100000
#define DE_SOURCE 0x0
#define DE_SOURCE_WRAP BIT(31)
#define DE_SOURCE_X_K1_SHIFT 16
#define DE_SOURCE_X_K1_MASK (0x3fff << 16)
#define DE_SOURCE_X_K1_MONO_MASK (0x1f << 16)
#define DE_SOURCE_Y_K2_MASK 0xffff
#define DE_DESTINATION 0x4
#define DE_DESTINATION_WRAP BIT(31)
#define DE_DESTINATION_X_SHIFT 16
#define DE_DESTINATION_X_MASK (0x1fff << 16)
#define DE_DESTINATION_Y_MASK 0xffff
#define DE_DIMENSION 0x8
#define DE_DIMENSION_X_SHIFT 16
#define DE_DIMENSION_X_MASK (0x1fff << 16)
#define DE_DIMENSION_Y_ET_MASK 0x1fff
#define DE_CONTROL 0xC
#define DE_CONTROL_STATUS BIT(31)
#define DE_CONTROL_PATTERN BIT(30)
#define DE_CONTROL_UPDATE_DESTINATION_X BIT(29)
#define DE_CONTROL_QUICK_START BIT(28)
#define DE_CONTROL_DIRECTION BIT(27)
#define DE_CONTROL_MAJOR BIT(26)
#define DE_CONTROL_STEP_X BIT(25)
#define DE_CONTROL_STEP_Y BIT(24)
#define DE_CONTROL_STRETCH BIT(23)
#define DE_CONTROL_HOST BIT(22)
#define DE_CONTROL_LAST_PIXEL BIT(21)
#define DE_CONTROL_COMMAND_SHIFT 16
#define DE_CONTROL_COMMAND_MASK (0x1f << 16)
#define DE_CONTROL_COMMAND_BITBLT (0x0 << 16)
#define DE_CONTROL_COMMAND_RECTANGLE_FILL (0x1 << 16)
#define DE_CONTROL_COMMAND_DE_TILE (0x2 << 16)
#define DE_CONTROL_COMMAND_TRAPEZOID_FILL (0x3 << 16)
#define DE_CONTROL_COMMAND_ALPHA_BLEND (0x4 << 16)
#define DE_CONTROL_COMMAND_RLE_STRIP (0x5 << 16)
#define DE_CONTROL_COMMAND_SHORT_STROKE (0x6 << 16)
#define DE_CONTROL_COMMAND_LINE_DRAW (0x7 << 16)
#define DE_CONTROL_COMMAND_HOST_WRITE (0x8 << 16)
#define DE_CONTROL_COMMAND_HOST_READ (0x9 << 16)
#define DE_CONTROL_COMMAND_HOST_WRITE_BOTTOM_UP (0xa << 16)
#define DE_CONTROL_COMMAND_ROTATE (0xb << 16)
#define DE_CONTROL_COMMAND_FONT (0xc << 16)
#define DE_CONTROL_COMMAND_TEXTURE_LOAD (0xe << 16)
#define DE_CONTROL_ROP_SELECT BIT(15)
#define DE_CONTROL_ROP2_SOURCE BIT(14)
#define DE_CONTROL_MONO_DATA_SHIFT 12
#define DE_CONTROL_MONO_DATA_MASK (0x3 << 12)
#define DE_CONTROL_MONO_DATA_NOT_PACKED (0x0 << 12)
#define DE_CONTROL_MONO_DATA_8_PACKED (0x1 << 12)
#define DE_CONTROL_MONO_DATA_16_PACKED (0x2 << 12)
#define DE_CONTROL_MONO_DATA_32_PACKED (0x3 << 12)
#define DE_CONTROL_REPEAT_ROTATE BIT(11)
#define DE_CONTROL_TRANSPARENCY_MATCH BIT(10)
#define DE_CONTROL_TRANSPARENCY_SELECT BIT(9)
#define DE_CONTROL_TRANSPARENCY BIT(8)
#define DE_CONTROL_ROP_MASK 0xff
/* Pseudo fields. */
#define DE_CONTROL_SHORT_STROKE_DIR_MASK (0xf << 24)
#define DE_CONTROL_SHORT_STROKE_DIR_225 (0x0 << 24)
#define DE_CONTROL_SHORT_STROKE_DIR_135 (0x1 << 24)
#define DE_CONTROL_SHORT_STROKE_DIR_315 (0x2 << 24)
#define DE_CONTROL_SHORT_STROKE_DIR_45 (0x3 << 24)
#define DE_CONTROL_SHORT_STROKE_DIR_270 (0x4 << 24)
#define DE_CONTROL_SHORT_STROKE_DIR_90 (0x5 << 24)
#define DE_CONTROL_SHORT_STROKE_DIR_180 (0x8 << 24)
#define DE_CONTROL_SHORT_STROKE_DIR_0 (0xa << 24)
#define DE_CONTROL_ROTATION_MASK (0x3 << 24)
#define DE_CONTROL_ROTATION_0 (0x0 << 24)
#define DE_CONTROL_ROTATION_270 (0x1 << 24)
#define DE_CONTROL_ROTATION_90 (0x2 << 24)
#define DE_CONTROL_ROTATION_180 (0x3 << 24)
#define DE_PITCH 0x000010
#define DE_PITCH_DESTINATION_SHIFT 16
#define DE_PITCH_DESTINATION_MASK (0x1fff << 16)
#define DE_PITCH_SOURCE_MASK 0x1fff
#define DE_FOREGROUND 0x000014
#define DE_FOREGROUND_COLOR_MASK 0xffffffff
#define DE_BACKGROUND 0x000018
#define DE_BACKGROUND_COLOR_MASK 0xffffffff
#define DE_STRETCH_FORMAT 0x00001C
#define DE_STRETCH_FORMAT_PATTERN_XY BIT(30)
#define DE_STRETCH_FORMAT_PATTERN_Y_SHIFT 27
#define DE_STRETCH_FORMAT_PATTERN_Y_MASK (0x7 << 27)
#define DE_STRETCH_FORMAT_PATTERN_X_SHIFT 23
#define DE_STRETCH_FORMAT_PATTERN_X_MASK (0x7 << 23)
#define DE_STRETCH_FORMAT_PIXEL_FORMAT_SHIFT 20
#define DE_STRETCH_FORMAT_PIXEL_FORMAT_MASK (0x3 << 20)
#define DE_STRETCH_FORMAT_PIXEL_FORMAT_8 (0x0 << 20)
#define DE_STRETCH_FORMAT_PIXEL_FORMAT_16 (0x1 << 20)
#define DE_STRETCH_FORMAT_PIXEL_FORMAT_32 (0x2 << 20)
#define DE_STRETCH_FORMAT_PIXEL_FORMAT_24 (0x3 << 20)
#define DE_STRETCH_FORMAT_ADDRESSING_SHIFT 16
#define DE_STRETCH_FORMAT_ADDRESSING_MASK (0xf << 16)
#define DE_STRETCH_FORMAT_ADDRESSING_XY (0x0 << 16)
#define DE_STRETCH_FORMAT_ADDRESSING_LINEAR (0xf << 16)
#define DE_STRETCH_FORMAT_SOURCE_HEIGHT_MASK 0xfff
#define DE_COLOR_COMPARE 0x000020
#define DE_COLOR_COMPARE_COLOR_MASK 0xffffff
#define DE_COLOR_COMPARE_MASK 0x000024
#define DE_COLOR_COMPARE_MASK_MASK 0xffffff
#define DE_MASKS 0x000028
#define DE_MASKS_BYTE_MASK (0xffff << 16)
#define DE_MASKS_BIT_MASK 0xffff
#define DE_CLIP_TL 0x00002C
#define DE_CLIP_TL_TOP_MASK (0xffff << 16)
#define DE_CLIP_TL_STATUS BIT(13)
#define DE_CLIP_TL_INHIBIT BIT(12)
#define DE_CLIP_TL_LEFT_MASK 0xfff
#define DE_CLIP_BR 0x000030
#define DE_CLIP_BR_BOTTOM_MASK (0xffff << 16)
#define DE_CLIP_BR_RIGHT_MASK 0x1fff
#define DE_MONO_PATTERN_LOW 0x000034
#define DE_MONO_PATTERN_LOW_PATTERN_MASK 0xffffffff
#define DE_MONO_PATTERN_HIGH 0x000038
#define DE_MONO_PATTERN_HIGH_PATTERN_MASK 0xffffffff
#define DE_WINDOW_WIDTH 0x00003C
#define DE_WINDOW_WIDTH_DST_SHIFT 16
#define DE_WINDOW_WIDTH_DST_MASK (0x1fff << 16)
#define DE_WINDOW_WIDTH_SRC_MASK 0x1fff
#define DE_WINDOW_SOURCE_BASE 0x000040
#define DE_WINDOW_SOURCE_BASE_EXT BIT(27)
#define DE_WINDOW_SOURCE_BASE_CS BIT(26)
#define DE_WINDOW_SOURCE_BASE_ADDRESS_MASK 0x3ffffff
#define DE_WINDOW_DESTINATION_BASE 0x000044
#define DE_WINDOW_DESTINATION_BASE_EXT BIT(27)
#define DE_WINDOW_DESTINATION_BASE_CS BIT(26)
#define DE_WINDOW_DESTINATION_BASE_ADDRESS_MASK 0x3ffffff
#define DE_ALPHA 0x000048
#define DE_ALPHA_VALUE_MASK 0xff
#define DE_WRAP 0x00004C
#define DE_WRAP_X_MASK (0xffff << 16)
#define DE_WRAP_Y_MASK 0xffff
#define DE_STATUS 0x000050
#define DE_STATUS_CSC BIT(1)
#define DE_STATUS_2D BIT(0)
/* blt direction */
#define TOP_TO_BOTTOM 0
#define LEFT_TO_RIGHT 0
#define BOTTOM_TO_TOP 1
#define RIGHT_TO_LEFT 1
void sm750_hw_set2dformat(struct lynx_accel *accel, int fmt);
void sm750_hw_de_init(struct lynx_accel *accel);
int sm750_hw_fillrect(struct lynx_accel *accel,
u32 base, u32 pitch, u32 Bpp,
u32 x, u32 y, u32 width, u32 height,
u32 color, u32 rop);
int sm750_hw_copyarea(
struct lynx_accel *accel,
unsigned int sBase, /* Address of source: offset in frame buffer */
unsigned int sPitch, /* Pitch value of source surface in BYTE */
unsigned int sx,
unsigned int sy, /* Starting coordinate of source surface */
unsigned int dBase, /* Address of destination: offset in frame buffer */
unsigned int dPitch, /* Pitch value of destination surface in BYTE */
unsigned int bpp, /* Color depth of destination surface */
unsigned int dx,
unsigned int dy, /* Starting coordinate of destination surface */
unsigned int width,
unsigned int height, /* width and height of rectangle in pixel value */
unsigned int rop2);
int sm750_hw_imageblit(struct lynx_accel *accel,
const char *pSrcbuf, /* pointer to start of source buffer in system memory */
u32 srcDelta, /* Pitch value (in bytes) of the source buffer, +ive means top down and -ive mean button up */
u32 startBit, /* Mono data can start at any bit in a byte, this value should be 0 to 7 */
u32 dBase, /* Address of destination: offset in frame buffer */
u32 dPitch, /* Pitch value of destination surface in BYTE */
u32 bytePerPixel, /* Color depth of destination surface */
u32 dx,
u32 dy, /* Starting coordinate of destination surface */
u32 width,
u32 height, /* width and height of rectangle in pixel value */
u32 fColor, /* Foreground color (corresponding to a 1 in the monochrome data */
u32 bColor, /* Background color (corresponding to a 0 in the monochrome data */
u32 rop2);
#endif