Promotion of kernel.lnx.4.4-161028.

			1 - 4K

			2 - 16K

			3 - 64K

  Bits 3-63:	Reserved.

  Bit 3:	Kernel physical placement

			0 - 2MB aligned base should be as close as possible

			    to the base of DRAM, since memory below it is not

			    accessible via the linear mapping

			1 - 2MB aligned base may be anywhere in physical

			    memory

  Bits 4-63:	Reserved.

- When image_size is zero, a bootloader should attempt to keep as much

  memory as possible free for use by the kernel immediately after the

  depending on selected features, and is effectively unbound.

The Image must be placed text_offset bytes from a 2MB aligned base

address near the start of usable system RAM and called there. Memory

below that base address is currently unusable by Linux, and therefore it

is strongly recommended that this location is the start of system RAM.

The region between the 2 MB aligned base address and the start of the

image has no special significance to the kernel, and may be used for

other purposes.

address anywhere in usable system RAM and called there. The region

between the 2 MB aligned base address and the start of the image has no

special significance to the kernel, and may be used for other purposes.

At least image_size bytes from the start of the image must be free for

use by the kernel.

NOTE: versions prior to v4.6 cannot make use of memory below the

physical offset of the Image so it is recommended that the Image be

placed as close as possible to the start of system RAM.

Any memory described to the kernel (even that below the start of the

image) which is not marked as reserved from the kernel (e.g., with a

                Silicon Errata and Software Workarounds

                =======================================

Author: Will Deacon <will.deacon@arm.com>

Date  : 27 November 2015

It is an unfortunate fact of life that hardware is often produced with

so-called "errata", which can cause it to deviate from the architecture

under specific circumstances.  For hardware produced by ARM, these

errata are broadly classified into the following categories:

  Category A: A critical error without a viable workaround.

  Category B: A significant or critical error with an acceptable

              workaround.

  Category C: A minor error that is not expected to occur under normal

              operation.

For more information, consult one of the "Software Developers Errata

Notice" documents available on infocenter.arm.com (registration

required).

As far as Linux is concerned, Category B errata may require some special

treatment in the operating system. For example, avoiding a particular

sequence of code, or configuring the processor in a particular way. A

less common situation may require similar actions in order to declassify

a Category A erratum into a Category C erratum. These are collectively

known as "software workarounds" and are only required in the minority of

cases (e.g. those cases that both require a non-secure workaround *and*

can be triggered by Linux).

For software workarounds that may adversely impact systems unaffected by

the erratum in question, a Kconfig entry is added under "Kernel

Features" -> "ARM errata workarounds via the alternatives framework".

These are enabled by default and patched in at runtime when an affected

CPU is detected. For less-intrusive workarounds, a Kconfig option is not

available and the code is structured (preferably with a comment) in such

a way that the erratum will not be hit.

This approach can make it slightly onerous to determine exactly which

errata are worked around in an arbitrary kernel source tree, so this

file acts as a registry of software workarounds in the Linux Kernel and

will be updated when new workarounds are committed and backported to

stable kernels.

| Implementor    | Component       | Erratum ID      | Kconfig                 |

+----------------+-----------------+-----------------+-------------------------+

| ARM            | Cortex-A53      | #826319         | ARM64_ERRATUM_826319    |

| ARM            | Cortex-A53      | #827319         | ARM64_ERRATUM_827319    |

| ARM            | Cortex-A53      | #824069         | ARM64_ERRATUM_824069    |

| ARM            | Cortex-A53      | #819472         | ARM64_ERRATUM_819472    |

| ARM            | Cortex-A53      | #845719         | ARM64_ERRATUM_845719    |

| ARM            | Cortex-A53      | #843419         | ARM64_ERRATUM_843419    |

| ARM            | Cortex-A57      | #832075         | ARM64_ERRATUM_832075    |

| ARM            | Cortex-A57      | #852523         | N/A                     |

| ARM            | Cortex-A57      | #834220         | ARM64_ERRATUM_834220    |

|                |                 |                 |                         |

| Cavium         | ThunderX ITS    | #22375, #24313  | CAVIUM_ERRATUM_22375    |

| Cavium         | ThunderX GICv3  | #23154          | CAVIUM_ERRATUM_23154    |

- target-supply     : regulator for SATA target power

- phys              : reference to the SATA PHY node

- phy-names         : must be "sata-phy"

- ports-implemented : Mask that indicates which ports that the HBA supports

		      are available for software to use. Useful if PORTS_IMPL

		      is not programmed by the BIOS, which is true with

		      some embedded SOC's.

Required properties when using sub-nodes:

- #address-cells    : number of cells to encode an address

 - qcom,dig-vtg-max	: Digital supply maximum voltage in uV

 - qcom,display-resolution	: Display resolution - maxX, maxY

 - qcom,use-scale	: boolean, enables the scaling for touch coordinates

 - pinctrl-names	: defines pinctrl names

			"pmx_ts_active" : Required pinctrl name.

				This should specify active config of TS RST gpio

			"pmx_ts_suspend" : Required pinctrl name

				This should specify suspend config of TS RST gpio

			"ddic_rst_active" : Required pinctrl name

				This should specify active config of DDIC RST gpio

			"ddic_rst_suspend" : Required pinctrl name

				This should specify suspend config of DDIC RST gpio

 - pinctrl-0		: pin control to be used for TS active config

 - pinctrl-1		: pin control to be used for TS suspend config

 - pinctrl-2		: pin control to be used for DDIC active config

 - pinctrl-3		: pin control to be used for DDIC suspend config

Optional properties if qcom,use-scale DT property is defined:

 - qcom,def-maxx	: default X-resolution of the touch panel.

 - qcom,des-maxy	: desired Y-resolution of the touch panel.

			(Above two properties should be defined in pairs only)

Optional Properties if pinctrl names are defined:

 - qcom,pmx-ts-on-seq-delay-us : unsigned integer type for

		delay after active TS RST gpio is changed

 - qcom,fb-resume-delay-us : unsigned integer type for

		delay in early resume framebuffer callback

 - qcom,ddic-rst-on-seq-delay-us : array of unsigned integer type for

		delay of each step in series of DDIC RST gpio control

Optional Properties if qcom,afe-vtg and qcom,dig-vtg are defined

 - qcom,afe-power-on-delay-us : unsigned integer type for

		delay between turning on analog and digital power supply

 - qcom,afe-power-off-delay-us : unsigned integer type for

		delay between turning off digital and analog power supply

Example:

	&soc {

		hbtp {

			qcom,default-max-y = <1920>;

			qcom,desired-max-x = <720>;

			qcom,desired-max-y = <1280>;

			pinctrl-names = "pmx_ts_active","pmx_ts_suspend",

					"ddic_rst_active", "ddic_rst_suspend";

			pinctrl-0 = <&ts_rst_active>;

			pinctrl-1 = <&ts_rst_suspend>;

			pinctrl-2 = <&ddic_rst_active>;

			pinctrl-3 = <&ddic_rst_suspend>;

			qcom,pmx-ts-on-seq-delay-us = <1000>;

			qcom,ddic-rst-on-seq-delay-us = <10000 10000 10000 10000>;

			qcom,fb-resume-delay-us = <90000>;

			qcom,afe-power-on-delay-us = <1000>;

			qcom,afe-power-off-delay-us = <6>;

		};

	};

 - goodix,cfg-data5	: Touch screen controller config data group 5. Ask vendor

				to provide that.

 - goodix,fw-name	: Touch screen controller firmware file name.

 - goodix,slide-wakeup	: To specify slide-wakeup property is enabled or not.

 - goodix,dbl-clk-wakeup	: To specify dbl-clk-wakeup property is enabled or not.

 - goodix,change-x2y	: To specify change-x2y property is enabled or not.

 - goodix,driver-send-cfg	: To specify driver-send-cfg property is enabled or not.

 - goodix,have-touch-key	: To specify have-touch-key property is enabled or not.

 - goodix,with-pen	: To specify with-pen property is enabled or not.

Example:

i2c@f9927000 {

		goodix@5d {

				FF FF FF FF FF FF FF 22 22 22

				22 22 22 FF 07 01];

			goodix,fw_name = "gtp_fw.bin";

			goodix,have-touch-key;

			goodix,driver-send-cfg;

		};

};