Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit aee2828c authored by Martin Blumenstingl's avatar Martin Blumenstingl Committed by Kevin Hilman
Browse files

dt-bindings: Amlogic: add documentation for the SoC info register areas



There are three register areas which contain information about the SoC
version and revision:
- the assist registers contain the SoC's "major version" which encodes
  the SoC generation and part number. this is available on Meson6,
  Meson8 and Meson8b SoCs.
- the bootrom register contains at least the SoCs "misc version". this
  is avilable on Meson6, Meson8 and Meson8b
- the analog top registers contain information about the SoC revision.
  this is only available on Meson8 and Meson8b

Not much else is currently known about these registers.

Signed-off-by: default avatarMartin Blumenstingl <martin.blumenstingl@googlemail.com>
Acked-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarKevin Hilman <khilman@baylibre.com>
parent 291f45dd
Loading
Loading
Loading
Loading
+20 −0
Original line number Diff line number Diff line
Amlogic Meson8 and Meson8b "analog top" registers:
--------------------------------------------------

The analog top registers contain information about the so-called
"metal revision" (which encodes the "minor version") of the SoC.

Required properties:
- reg: the register range of the analog top registers
- compatible: depending on the SoC this should be one of:
		- "amlogic,meson8-analog-top"
		- "amlogic,meson8b-analog-top"
		along with "syscon"


Example:

	analog_top: analog-top@81a8 {
		compatible = "amlogic,meson8-analog-top", "syscon";
		reg = <0x81a8 0x14>;
	};
+17 −0
Original line number Diff line number Diff line
Amlogic Meson6/Meson8/Meson8b assist registers:
-----------------------------------------------

The assist registers contain basic information about the SoC,
for example the encoded SoC part number.

Required properties:
- reg: the register range of the assist registers
- compatible: should be "amlogic,meson-mx-assist" along with "syscon"


Example:

	assist: assist@7c00 {
		compatible = "amlogic,meson-mx-assist", "syscon";
		reg = <0x7c00 0x200>;
	};
+17 −0
Original line number Diff line number Diff line
Amlogic Meson6/Meson8/Meson8b bootrom:
--------------------------------------

The bootrom register area can be used to access SoC specific
information, such as the "misc version".

Required properties:
- reg: the register range of the bootrom registers
- compatible: should be "amlogic,meson-mx-bootrom" along with "syscon"


Example:

	bootrom: bootrom@d9040000 {
		compatible = "amlogic,meson-mx-bootrom", "syscon";
		reg = <0xd9040000 0x10000>;
	};