Skip to content

Commit

Permalink
dt-bindings: Amlogic: add documentation for the SoC info register areas
Browse files Browse the repository at this point in the history
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: Martin Blumenstingl <martin.blumenstingl@googlemail.com>
Acked-by: Rob Herring <robh@kernel.org>
Signed-off-by: Kevin Hilman <khilman@baylibre.com>
  • Loading branch information
Martin Blumenstingl authored and Kevin Hilman committed Oct 6, 2017
1 parent 291f45d commit aee2828
Show file tree
Hide file tree
Showing 3 changed files with 54 additions and 0 deletions.
20 changes: 20 additions & 0 deletions Documentation/devicetree/bindings/arm/amlogic/analog-top.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
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 changes: 17 additions & 0 deletions Documentation/devicetree/bindings/arm/amlogic/assist.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
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 changes: 17 additions & 0 deletions Documentation/devicetree/bindings/arm/amlogic/bootrom.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
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>;
};

0 comments on commit aee2828

Please sign in to comment.