renegade-project/linux-next
2
0
Fork 0
mirror of https://github.com/edk2-porting/linux-next.git synced 2024-12-23 04:34:11 +08:00
Code
67482129cd
linux-next/include/linux/wm97xx.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

339 lines
11 KiB
C
Raw Blame History

/* SPDX-License-Identifier: GPL-2.0 */
/*
* Register bits and API for Wolfson WM97xx series of codecs
*/
#ifndef _LINUX_WM97XX_H
#define _LINUX_WM97XX_H
#include <sound/core.h>
#include <sound/pcm.h>
#include <sound/ac97_codec.h>
#include <sound/initval.h>
#include <linux/types.h>
#include <linux/list.h>
#include <linux/input.h> /* Input device layer */
#include <linux/platform_device.h>
/*
* WM97xx variants
*/
#define WM97xx_GENERIC 0x0000
#define WM97xx_WM1613 0x1613
/*
* WM97xx AC97 Touchscreen registers
*/
#define AC97_WM97XX_DIGITISER1 0x76
#define AC97_WM97XX_DIGITISER2 0x78
#define AC97_WM97XX_DIGITISER_RD 0x7a
#define AC97_WM9713_DIG1 0x74
#define AC97_WM9713_DIG2 AC97_WM97XX_DIGITISER1
#define AC97_WM9713_DIG3 AC97_WM97XX_DIGITISER2
/*
* WM97xx register bits
*/
#define WM97XX_POLL 0x8000 /* initiate a polling measurement */
#define WM97XX_ADCSEL_X 0x1000 /* x coord measurement */
#define WM97XX_ADCSEL_Y 0x2000 /* y coord measurement */
#define WM97XX_ADCSEL_PRES 0x3000 /* pressure measurement */
#define WM97XX_AUX_ID1 0x4000
#define WM97XX_AUX_ID2 0x5000
#define WM97XX_AUX_ID3 0x6000
#define WM97XX_AUX_ID4 0x7000
#define WM97XX_ADCSEL_MASK 0x7000 /* ADC selection mask */
#define WM97XX_COO 0x0800 /* enable coordinate mode */
#define WM97XX_CTC 0x0400 /* enable continuous mode */
#define WM97XX_CM_RATE_93 0x0000 /* 93.75Hz continuous rate */
#define WM97XX_CM_RATE_187 0x0100 /* 187.5Hz continuous rate */
#define WM97XX_CM_RATE_375 0x0200 /* 375Hz continuous rate */
#define WM97XX_CM_RATE_750 0x0300 /* 750Hz continuous rate */
#define WM97XX_CM_RATE_8K 0x00f0 /* 8kHz continuous rate */
#define WM97XX_CM_RATE_12K 0x01f0 /* 12kHz continuous rate */
#define WM97XX_CM_RATE_24K 0x02f0 /* 24kHz continuous rate */
#define WM97XX_CM_RATE_48K 0x03f0 /* 48kHz continuous rate */
#define WM97XX_CM_RATE_MASK 0x03f0
#define WM97XX_RATE(i) (((i & 3) << 8) | ((i & 4) ? 0xf0 : 0))
#define WM97XX_DELAY(i) ((i << 4) & 0x00f0) /* sample delay times */
#define WM97XX_DELAY_MASK 0x00f0
#define WM97XX_SLEN 0x0008 /* slot read back enable */
#define WM97XX_SLT(i) ((i - 5) & 0x7) /* panel slot (5-11) */
#define WM97XX_SLT_MASK 0x0007
#define WM97XX_PRP_DETW 0x4000 /* detect on, digitise off, wake */
#define WM97XX_PRP_DET 0x8000 /* detect on, digitise off, no wake */
#define WM97XX_PRP_DET_DIG 0xc000 /* setect on, digitise on */
#define WM97XX_RPR 0x2000 /* wake up on pen down */
#define WM97XX_PEN_DOWN 0x8000 /* pen is down */
/* WM9712 Bits */
#define WM9712_45W 0x1000 /* set for 5-wire touchscreen */
#define WM9712_PDEN 0x0800 /* measure only when pen down */
#define WM9712_WAIT 0x0200 /* wait until adc is read before next sample */
#define WM9712_PIL 0x0100 /* current used for pressure measurement. set 400uA else 200uA */
#define WM9712_MASK_HI 0x0040 /* hi on mask pin (47) stops conversions */
#define WM9712_MASK_EDGE 0x0080 /* rising/falling edge on pin delays sample */
#define WM9712_MASK_SYNC 0x00c0 /* rising/falling edge on mask initiates sample */
#define WM9712_RPU(i) (i&0x3f) /* internal pull up on pen detect (64k / rpu) */
#define WM9712_PD(i) (0x1 << i) /* power management */
/* WM9712 Registers */
#define AC97_WM9712_POWER 0x24
#define AC97_WM9712_REV 0x58
/* WM9705 Bits */
#define WM9705_PDEN 0x1000 /* measure only when pen is down */
#define WM9705_PINV 0x0800 /* inverts sense of pen down output */
#define WM9705_BSEN 0x0400 /* BUSY flag enable, pin47 is 1 when busy */
#define WM9705_BINV 0x0200 /* invert BUSY (pin47) output */
#define WM9705_WAIT 0x0100 /* wait until adc is read before next sample */
#define WM9705_PIL 0x0080 /* current used for pressure measurement. set 400uA else 200uA */
#define WM9705_PHIZ 0x0040 /* set PHONE and PCBEEP inputs to high impedance */
#define WM9705_MASK_HI 0x0010 /* hi on mask stops conversions */
#define WM9705_MASK_EDGE 0x0020 /* rising/falling edge on pin delays sample */
#define WM9705_MASK_SYNC 0x0030 /* rising/falling edge on mask initiates sample */
#define WM9705_PDD(i) (i & 0x000f) /* pen detect comparator threshold */
/* WM9713 Bits */
#define WM9713_PDPOL 0x0400 /* Pen down polarity */
#define WM9713_POLL 0x0200 /* initiate a polling measurement */
#define WM9713_CTC 0x0100 /* enable continuous mode */
#define WM9713_ADCSEL_X 0x0002 /* X measurement */
#define WM9713_ADCSEL_Y 0x0004 /* Y measurement */
#define WM9713_ADCSEL_PRES 0x0008 /* Pressure measurement */
#define WM9713_COO 0x0001 /* enable coordinate mode */
#define WM9713_45W 0x1000 /* set for 5 wire panel */
#define WM9713_PDEN 0x0800 /* measure only when pen down */
#define WM9713_ADCSEL_MASK 0x00fe /* ADC selection mask */
#define WM9713_WAIT 0x0200 /* coordinate wait */
/* AUX ADC ID's */
#define TS_COMP1 0x0
#define TS_COMP2 0x1
#define TS_BMON 0x2
#define TS_WIPER 0x3
/* ID numbers */
#define WM97XX_ID1 0x574d
#define WM9712_ID2 0x4c12
#define WM9705_ID2 0x4c05
#define WM9713_ID2 0x4c13
/* Codec GPIO's */
#define WM97XX_MAX_GPIO 16
#define WM97XX_GPIO_1 (1 << 1)
#define WM97XX_GPIO_2 (1 << 2)
#define WM97XX_GPIO_3 (1 << 3)
#define WM97XX_GPIO_4 (1 << 4)
#define WM97XX_GPIO_5 (1 << 5)
#define WM97XX_GPIO_6 (1 << 6)
#define WM97XX_GPIO_7 (1 << 7)
#define WM97XX_GPIO_8 (1 << 8)
#define WM97XX_GPIO_9 (1 << 9)
#define WM97XX_GPIO_10 (1 << 10)
#define WM97XX_GPIO_11 (1 << 11)
#define WM97XX_GPIO_12 (1 << 12)
#define WM97XX_GPIO_13 (1 << 13)
#define WM97XX_GPIO_14 (1 << 14)
#define WM97XX_GPIO_15 (1 << 15)
#define AC97_LINK_FRAME 21 /* time in uS for AC97 link frame */
/*---------------- Return codes from sample reading functions ---------------*/
/* More data is available; call the sample gathering function again */
#define RC_AGAIN 0x00000001
/* The returned sample is valid */
#define RC_VALID 0x00000002
/* The pen is up (the first RC_VALID without RC_PENUP means pen is down) */
#define RC_PENUP 0x00000004
/* The pen is down (RC_VALID implies RC_PENDOWN, but sometimes it is helpful
to tell the handler that the pen is down but we don't know yet his coords,
so the handler should not sleep or wait for pendown irq) */
#define RC_PENDOWN 0x00000008
/*
* The wm97xx driver provides a private API for writing platform-specific
* drivers.
*/
/* The structure used to return arch specific sampled data into */
struct wm97xx_data {
int x;
int y;
int p;
};
/*
* Codec GPIO status
*/
enum wm97xx_gpio_status {
WM97XX_GPIO_HIGH,
WM97XX_GPIO_LOW
};
/*
* Codec GPIO direction
*/
enum wm97xx_gpio_dir {
WM97XX_GPIO_IN,
WM97XX_GPIO_OUT
};
/*
* Codec GPIO polarity
*/
enum wm97xx_gpio_pol {
WM97XX_GPIO_POL_HIGH,
WM97XX_GPIO_POL_LOW
};
/*
* Codec GPIO sticky
*/
enum wm97xx_gpio_sticky {
WM97XX_GPIO_STICKY,
WM97XX_GPIO_NOTSTICKY
};
/*
* Codec GPIO wake
*/
enum wm97xx_gpio_wake {
WM97XX_GPIO_WAKE,
WM97XX_GPIO_NOWAKE
};
/*
* Digitiser ioctl commands
*/
#define WM97XX_DIG_START 0x1
#define WM97XX_DIG_STOP 0x2
#define WM97XX_PHY_INIT 0x3
#define WM97XX_AUX_PREPARE 0x4
#define WM97XX_DIG_RESTORE 0x5
struct wm97xx;
extern struct wm97xx_codec_drv wm9705_codec;
extern struct wm97xx_codec_drv wm9712_codec;
extern struct wm97xx_codec_drv wm9713_codec;
/*
* Codec driver interface - allows mapping to WM9705/12/13 and newer codecs
*/
struct wm97xx_codec_drv {
u16 id;
char *name;
/* read 1 sample */
int (*poll_sample) (struct wm97xx *, int adcsel, int *sample);
/* read X,Y,[P] in poll */
int (*poll_touch) (struct wm97xx *, struct wm97xx_data *);
int (*acc_enable) (struct wm97xx *, int enable);
void (*phy_init) (struct wm97xx *);
void (*dig_enable) (struct wm97xx *, int enable);
void (*dig_restore) (struct wm97xx *);
void (*aux_prepare) (struct wm97xx *);
};
/* Machine specific and accelerated touch operations */
struct wm97xx_mach_ops {
/* accelerated touch readback - coords are transmited on AC97 link */
int acc_enabled;
void (*acc_pen_up) (struct wm97xx *);
int (*acc_pen_down) (struct wm97xx *);
int (*acc_startup) (struct wm97xx *);
void (*acc_shutdown) (struct wm97xx *);
/* interrupt mask control - required for accelerated operation */
void (*irq_enable) (struct wm97xx *, int enable);
/* GPIO pin used for accelerated operation */
int irq_gpio;
/* pre and post sample - can be used to minimise any analog noise */
void (*pre_sample) (int); /* function to run before sampling */
void (*post_sample) (int); /* function to run after sampling */
};
struct wm97xx {
u16 dig[3], id, gpio[6], misc; /* Cached codec registers */
u16 dig_save[3]; /* saved during aux reading */
struct wm97xx_codec_drv *codec; /* attached codec driver*/
struct input_dev *input_dev; /* touchscreen input device */
struct snd_ac97 *ac97; /* ALSA codec access */
struct device *dev; /* ALSA device */
struct platform_device *battery_dev;
struct platform_device *touch_dev;
struct wm97xx_mach_ops *mach_ops;
struct mutex codec_mutex;
struct delayed_work ts_reader; /* Used to poll touchscreen */
unsigned long ts_reader_interval; /* Current interval for timer */
unsigned long ts_reader_min_interval; /* Minimum interval */
unsigned int pen_irq; /* Pen IRQ number in use */
struct workqueue_struct *ts_workq;
struct work_struct pen_event_work;
u16 acc_slot; /* AC97 slot used for acc touch data */
u16 acc_rate; /* acc touch data rate */
unsigned pen_is_down:1; /* Pen is down */
unsigned aux_waiting:1; /* aux measurement waiting */
unsigned pen_probably_down:1; /* used in polling mode */
u16 variant; /* WM97xx chip variant */
u16 suspend_mode; /* PRP in suspend mode */
};
struct wm97xx_batt_pdata {
int batt_aux;
int temp_aux;
int charge_gpio;
int min_voltage;
int max_voltage;
int batt_div;
int batt_mult;
int temp_div;
int temp_mult;
int batt_tech;
char *batt_name;
};
struct wm97xx_pdata {
struct wm97xx_batt_pdata *batt_pdata; /* battery data */
};
/*
* Codec GPIO access (not supported on WM9705)
* This can be used to set/get codec GPIO and Virtual GPIO status.
*/
enum wm97xx_gpio_status wm97xx_get_gpio(struct wm97xx *wm, u32 gpio);
void wm97xx_set_gpio(struct wm97xx *wm, u32 gpio,
enum wm97xx_gpio_status status);
void wm97xx_config_gpio(struct wm97xx *wm, u32 gpio,
enum wm97xx_gpio_dir dir,
enum wm97xx_gpio_pol pol,
enum wm97xx_gpio_sticky sticky,
enum wm97xx_gpio_wake wake);
void wm97xx_set_suspend_mode(struct wm97xx *wm, u16 mode);
/* codec AC97 IO access */
int wm97xx_reg_read(struct wm97xx *wm, u16 reg);
void wm97xx_reg_write(struct wm97xx *wm, u16 reg, u16 val);
/* aux adc readback */
int wm97xx_read_aux_adc(struct wm97xx *wm, u16 adcsel);
/* machine ops */
int wm97xx_register_mach_ops(struct wm97xx *, struct wm97xx_mach_ops *);
void wm97xx_unregister_mach_ops(struct wm97xx *);
#endif
View Git Blame Copy Permalink