* [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
@ 2015-01-09 13:20 ` Nicolas Ferre
0 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-09 13:20 UTC (permalink / raw)
To: linux-arm-kernel, linux-kernel, Arnd Bergmann, Olof Johansson, khilman
Cc: Jean-Christophe PLAGNIOL-VILLARD, Boris BREZILLON,
Alexandre Belloni, Patrice Vilchez, Ludovic Desroches,
Cyrille Pitchen, Nicolas Ferre, ARM Maintainers
Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
- SoC list + datasheet web links
- Basic but useful information
- Device Tree conventions and Work In Progress statement.
Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
Cc: ARM Maintainers <arm@kernel.org>
---
Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
1 file changed, 120 insertions(+)
create mode 100644 Documentation/arm/Atmel/README
diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
new file mode 100644
index 000000000000..538f8a556277
--- /dev/null
+++ b/Documentation/arm/Atmel/README
@@ -0,0 +1,120 @@
+ARM Atmel SoCs (aka AT91)
+=========================
+
+
+Introduction
+------------
+This document gives useful information about the ARM Atmel SoCs that are
+currently supported in Linux Mainline (you know, the one on kernel.org).
+
+It is important to note that the Atmel | SMART ARM-based MPU product line is
+historically named "AT91" or "at91" throughout the Linux kernel development
+process even if this product prefix has completely disappeared from the
+official Atmel product name. Anyway, files, directories, git trees,
+git branches/tags and email subject always contain this "at91" sub-string.
+
+
+AT91 SoCs
+---------
+Documentation and detailled datasheet for each product are available on
+the Atmel website: http://www.atmel.com.
+
+ Flavors:
+ * ARM 920 based SoC
+ - at91rm9200
+ + Datasheet
+ http://www.atmel.com/Images/doc1768.pdf
+
+ * ARM 926 based SoCs
+ - at91sam9260
+ + Datasheet
+ http://www.atmel.com/Images/doc6221.pdf
+
+ - at91sam9261
+ + Datasheet
+ http://www.atmel.com/Images/doc6062.pdf
+
+ - at91sam9263
+ + Datasheet
+ http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
+
+ - at91sam9rl
+ + Datasheet
+ http://www.atmel.com/Images/doc6289.pdf
+
+ - at91sam9g20
+ + Datasheet
+ http://www.atmel.com/Images/doc6384.pdf
+
+ - at91sam9g45 family
+ - at91sam9g45
+ - at91sam9g46
+ - at91sam9m10
+ - at91sam9m11 (device superset)
+ + Datasheet
+ http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
+
+ - at91sam9x5 family (aka "The 5 series")
+ - at91sam9g15
+ - at91sam9g25
+ - at91sam9g35
+ - at91sam9x25
+ - at91sam9x35
+ + Datasheet (can be considered as covering the whole family)
+ http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
+
+ - at91sam9n12
+ + Datasheet
+ http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
+
+ * ARM Cortex-A5 based SoCs
+ - sama5d3 family
+ - sama5d31
+ - sama5d33
+ - sama5d34
+ - sama5d35
+ - sama5d36 (device superset)
+ + Datasheet
+ http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
+
+ * ARM Cortex-A5 + NEON based SoCs
+ - sama5d4 family
+ - sama5d41
+ - sama5d42
+ - sama5d43
+ - sama5d44 (device superset)
+ + Datasheet
+ http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
+
+
+Linux kernel information
+------------------------
+Linux kernel mach directory: arch/arm/mach-at91
+MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
+
+
+Device Tree for AT91 SoCs and boards
+------------------------------------
+All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
+must use this method to boot the Linux kernel.
+
+Work In Progress statement:
+Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
+considered as "Unstable". To be completely clear, any at91 binding can change at
+any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
+the same source tree.
+Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
+definition of a "Stable" binding/ABI.
+This statement will be removed by AT91 MAINTAINERS when appropriated.
+
+Naming conventions and best practice:
+- SoCs Device Tree Source Include files are named after the official name of
+ the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
+- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
+ shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
+ When collecting nodes for a particular peripheral or topic, the identifier have to
+ be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
+ or sama5d3_gmac.dtsi for example).
+- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
+ that they can be identified easily. Note that the sama5d3[13456]ek.dts files
+ are an historical exception to this rule.
--
2.1.3
^ permalink raw reply related [flat|nested] 14+ messages in thread
* [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
@ 2015-01-09 13:20 ` Nicolas Ferre
0 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-09 13:20 UTC (permalink / raw)
To: linux-arm-kernel
Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
- SoC list + datasheet web links
- Basic but useful information
- Device Tree conventions and Work In Progress statement.
Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
Cc: ARM Maintainers <arm@kernel.org>
---
Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
1 file changed, 120 insertions(+)
create mode 100644 Documentation/arm/Atmel/README
diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
new file mode 100644
index 000000000000..538f8a556277
--- /dev/null
+++ b/Documentation/arm/Atmel/README
@@ -0,0 +1,120 @@
+ARM Atmel SoCs (aka AT91)
+=========================
+
+
+Introduction
+------------
+This document gives useful information about the ARM Atmel SoCs that are
+currently supported in Linux Mainline (you know, the one on kernel.org).
+
+It is important to note that the Atmel | SMART ARM-based MPU product line is
+historically named "AT91" or "at91" throughout the Linux kernel development
+process even if this product prefix has completely disappeared from the
+official Atmel product name. Anyway, files, directories, git trees,
+git branches/tags and email subject always contain this "at91" sub-string.
+
+
+AT91 SoCs
+---------
+Documentation and detailled datasheet for each product are available on
+the Atmel website: http://www.atmel.com.
+
+ Flavors:
+ * ARM 920 based SoC
+ - at91rm9200
+ + Datasheet
+ http://www.atmel.com/Images/doc1768.pdf
+
+ * ARM 926 based SoCs
+ - at91sam9260
+ + Datasheet
+ http://www.atmel.com/Images/doc6221.pdf
+
+ - at91sam9261
+ + Datasheet
+ http://www.atmel.com/Images/doc6062.pdf
+
+ - at91sam9263
+ + Datasheet
+ http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
+
+ - at91sam9rl
+ + Datasheet
+ http://www.atmel.com/Images/doc6289.pdf
+
+ - at91sam9g20
+ + Datasheet
+ http://www.atmel.com/Images/doc6384.pdf
+
+ - at91sam9g45 family
+ - at91sam9g45
+ - at91sam9g46
+ - at91sam9m10
+ - at91sam9m11 (device superset)
+ + Datasheet
+ http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
+
+ - at91sam9x5 family (aka "The 5 series")
+ - at91sam9g15
+ - at91sam9g25
+ - at91sam9g35
+ - at91sam9x25
+ - at91sam9x35
+ + Datasheet (can be considered as covering the whole family)
+ http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
+
+ - at91sam9n12
+ + Datasheet
+ http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
+
+ * ARM Cortex-A5 based SoCs
+ - sama5d3 family
+ - sama5d31
+ - sama5d33
+ - sama5d34
+ - sama5d35
+ - sama5d36 (device superset)
+ + Datasheet
+ http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
+
+ * ARM Cortex-A5 + NEON based SoCs
+ - sama5d4 family
+ - sama5d41
+ - sama5d42
+ - sama5d43
+ - sama5d44 (device superset)
+ + Datasheet
+ http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
+
+
+Linux kernel information
+------------------------
+Linux kernel mach directory: arch/arm/mach-at91
+MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
+
+
+Device Tree for AT91 SoCs and boards
+------------------------------------
+All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
+must use this method to boot the Linux kernel.
+
+Work In Progress statement:
+Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
+considered as "Unstable". To be completely clear, any at91 binding can change at
+any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
+the same source tree.
+Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
+definition of a "Stable" binding/ABI.
+This statement will be removed by AT91 MAINTAINERS when appropriated.
+
+Naming conventions and best practice:
+- SoCs Device Tree Source Include files are named after the official name of
+ the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
+- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
+ shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
+ When collecting nodes for a particular peripheral or topic, the identifier have to
+ be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
+ or sama5d3_gmac.dtsi for example).
+- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
+ that they can be identified easily. Note that the sama5d3[13456]ek.dts files
+ are an historical exception to this rule.
--
2.1.3
^ permalink raw reply related [flat|nested] 14+ messages in thread
* Re: [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
2015-01-09 13:20 ` Nicolas Ferre
@ 2015-01-13 2:03 ` Olof Johansson
-1 siblings, 0 replies; 14+ messages in thread
From: Olof Johansson @ 2015-01-13 2:03 UTC (permalink / raw)
To: Nicolas Ferre
Cc: linux-arm-kernel, linux-kernel, Arnd Bergmann, khilman,
Jean-Christophe PLAGNIOL-VILLARD, Boris BREZILLON,
Alexandre Belloni, Patrice Vilchez, Ludovic Desroches,
Cyrille Pitchen, ARM Maintainers
On Fri, Jan 09, 2015 at 02:20:31PM +0100, Nicolas Ferre wrote:
> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
> - SoC list + datasheet web links
> - Basic but useful information
> - Device Tree conventions and Work In Progress statement.
>
> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
> Cc: ARM Maintainers <arm@kernel.org>
Acked-by: Olof Johansson <olof@lixom.net>
With the understanding that:
> +Device Tree for AT91 SoCs and boards
> +------------------------------------
> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
> +must use this method to boot the Linux kernel.
> +
> +Work In Progress statement:
> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
> +considered as "Unstable". To be completely clear, any at91 binding can change at
> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
> +the same source tree.
> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
> +definition of a "Stable" binding/ABI.
> +This statement will be removed by AT91 MAINTAINERS when appropriated.
While this statement is here, at the end of the day if you break a user
you're responsible for fixing them. I.e. if a tree falls in the forest
and nobody notices, then so be it.
But you can't break existing users and point to this and get away with
it. However, hopefully based on this doc users will go with practices
that means that you can revise bindings if you have to.
-Olof
^ permalink raw reply [flat|nested] 14+ messages in thread
* [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
@ 2015-01-13 2:03 ` Olof Johansson
0 siblings, 0 replies; 14+ messages in thread
From: Olof Johansson @ 2015-01-13 2:03 UTC (permalink / raw)
To: linux-arm-kernel
On Fri, Jan 09, 2015 at 02:20:31PM +0100, Nicolas Ferre wrote:
> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
> - SoC list + datasheet web links
> - Basic but useful information
> - Device Tree conventions and Work In Progress statement.
>
> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
> Cc: ARM Maintainers <arm@kernel.org>
Acked-by: Olof Johansson <olof@lixom.net>
With the understanding that:
> +Device Tree for AT91 SoCs and boards
> +------------------------------------
> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
> +must use this method to boot the Linux kernel.
> +
> +Work In Progress statement:
> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
> +considered as "Unstable". To be completely clear, any at91 binding can change at
> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
> +the same source tree.
> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
> +definition of a "Stable" binding/ABI.
> +This statement will be removed by AT91 MAINTAINERS when appropriated.
While this statement is here, at the end of the day if you break a user
you're responsible for fixing them. I.e. if a tree falls in the forest
and nobody notices, then so be it.
But you can't break existing users and point to this and get away with
it. However, hopefully based on this doc users will go with practices
that means that you can revise bindings if you have to.
-Olof
^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
2015-01-09 13:20 ` Nicolas Ferre
@ 2015-01-13 11:26 ` Nicolas Ferre
-1 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-13 11:26 UTC (permalink / raw)
To: linux-arm-kernel, linux-kernel, Arnd Bergmann, Olof Johansson, khilman
Cc: Jean-Christophe PLAGNIOL-VILLARD, Boris BREZILLON,
Alexandre Belloni, Patrice Vilchez, Ludovic Desroches,
Cyrille Pitchen, ARM Maintainers
Le 09/01/2015 14:20, Nicolas Ferre a écrit :
> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
> - SoC list + datasheet web links
> - Basic but useful information
> - Device Tree conventions and Work In Progress statement.
>
> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
> Cc: ARM Maintainers <arm@kernel.org>
> ---
> Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
> 1 file changed, 120 insertions(+)
> create mode 100644 Documentation/arm/Atmel/README
>
> diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
> new file mode 100644
> index 000000000000..538f8a556277
> --- /dev/null
> +++ b/Documentation/arm/Atmel/README
> @@ -0,0 +1,120 @@
> +ARM Atmel SoCs (aka AT91)
> +=========================
> +
> +
> +Introduction
> +------------
> +This document gives useful information about the ARM Atmel SoCs that are
> +currently supported in Linux Mainline (you know, the one on kernel.org).
> +
> +It is important to note that the Atmel | SMART ARM-based MPU product line is
> +historically named "AT91" or "at91" throughout the Linux kernel development
> +process even if this product prefix has completely disappeared from the
> +official Atmel product name. Anyway, files, directories, git trees,
> +git branches/tags and email subject always contain this "at91" sub-string.
> +
> +
> +AT91 SoCs
> +---------
> +Documentation and detailled datasheet for each product are available on
> +the Atmel website: http://www.atmel.com.
> +
> + Flavors:
> + * ARM 920 based SoC
> + - at91rm9200
> + + Datasheet
> + http://www.atmel.com/Images/doc1768.pdf
> +
> + * ARM 926 based SoCs
> + - at91sam9260
> + + Datasheet
> + http://www.atmel.com/Images/doc6221.pdf
> +
> + - at91sam9261
> + + Datasheet
> + http://www.atmel.com/Images/doc6062.pdf
> +
> + - at91sam9263
> + + Datasheet
> + http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
> +
> + - at91sam9rl
> + + Datasheet
> + http://www.atmel.com/Images/doc6289.pdf
> +
> + - at91sam9g20
> + + Datasheet
> + http://www.atmel.com/Images/doc6384.pdf
> +
> + - at91sam9g45 family
> + - at91sam9g45
> + - at91sam9g46
> + - at91sam9m10
> + - at91sam9m11 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
> +
> + - at91sam9x5 family (aka "The 5 series")
> + - at91sam9g15
> + - at91sam9g25
> + - at91sam9g35
> + - at91sam9x25
> + - at91sam9x35
> + + Datasheet (can be considered as covering the whole family)
> + http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
> +
> + - at91sam9n12
> + + Datasheet
> + http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
> +
> + * ARM Cortex-A5 based SoCs
> + - sama5d3 family
> + - sama5d31
> + - sama5d33
> + - sama5d34
> + - sama5d35
> + - sama5d36 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
> +
> + * ARM Cortex-A5 + NEON based SoCs
> + - sama5d4 family
> + - sama5d41
> + - sama5d42
> + - sama5d43
> + - sama5d44 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
> +
> +
> +Linux kernel information
> +------------------------
> +Linux kernel mach directory: arch/arm/mach-at91
> +MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
> +
> +
> +Device Tree for AT91 SoCs and boards
> +------------------------------------
> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
> +must use this method to boot the Linux kernel.
> +
> +Work In Progress statement:
> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
> +considered as "Unstable". To be completely clear, any at91 binding can change at
> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
> +the same source tree.
> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
> +definition of a "Stable" binding/ABI.
> +This statement will be removed by AT91 MAINTAINERS when appropriated.
> +
> +Naming conventions and best practice:
> +- SoCs Device Tree Source Include files are named after the official name of
> + the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
> +- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
> + shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
> + When collecting nodes for a particular peripheral or topic, the identifier have to
> + be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
> + or sama5d3_gmac.dtsi for example).
> +- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
> + that they can be identified easily. Note that the sama5d3[13456]ek.dts files
> + are an historical exception to this rule.
In fact, this set of boards are not the only exception. I will rephrase
the sentence as:
"Note that some files are historical exceptions to this rule
(sama5d3[13456]ek.dts, usb_a9g20.dts or animeo_ip.dts for example)."
Bye,
--
Nicolas Ferre
^ permalink raw reply [flat|nested] 14+ messages in thread
* [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
@ 2015-01-13 11:26 ` Nicolas Ferre
0 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-13 11:26 UTC (permalink / raw)
To: linux-arm-kernel
Le 09/01/2015 14:20, Nicolas Ferre a ?crit :
> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
> - SoC list + datasheet web links
> - Basic but useful information
> - Device Tree conventions and Work In Progress statement.
>
> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
> Cc: ARM Maintainers <arm@kernel.org>
> ---
> Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
> 1 file changed, 120 insertions(+)
> create mode 100644 Documentation/arm/Atmel/README
>
> diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
> new file mode 100644
> index 000000000000..538f8a556277
> --- /dev/null
> +++ b/Documentation/arm/Atmel/README
> @@ -0,0 +1,120 @@
> +ARM Atmel SoCs (aka AT91)
> +=========================
> +
> +
> +Introduction
> +------------
> +This document gives useful information about the ARM Atmel SoCs that are
> +currently supported in Linux Mainline (you know, the one on kernel.org).
> +
> +It is important to note that the Atmel | SMART ARM-based MPU product line is
> +historically named "AT91" or "at91" throughout the Linux kernel development
> +process even if this product prefix has completely disappeared from the
> +official Atmel product name. Anyway, files, directories, git trees,
> +git branches/tags and email subject always contain this "at91" sub-string.
> +
> +
> +AT91 SoCs
> +---------
> +Documentation and detailled datasheet for each product are available on
> +the Atmel website: http://www.atmel.com.
> +
> + Flavors:
> + * ARM 920 based SoC
> + - at91rm9200
> + + Datasheet
> + http://www.atmel.com/Images/doc1768.pdf
> +
> + * ARM 926 based SoCs
> + - at91sam9260
> + + Datasheet
> + http://www.atmel.com/Images/doc6221.pdf
> +
> + - at91sam9261
> + + Datasheet
> + http://www.atmel.com/Images/doc6062.pdf
> +
> + - at91sam9263
> + + Datasheet
> + http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
> +
> + - at91sam9rl
> + + Datasheet
> + http://www.atmel.com/Images/doc6289.pdf
> +
> + - at91sam9g20
> + + Datasheet
> + http://www.atmel.com/Images/doc6384.pdf
> +
> + - at91sam9g45 family
> + - at91sam9g45
> + - at91sam9g46
> + - at91sam9m10
> + - at91sam9m11 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
> +
> + - at91sam9x5 family (aka "The 5 series")
> + - at91sam9g15
> + - at91sam9g25
> + - at91sam9g35
> + - at91sam9x25
> + - at91sam9x35
> + + Datasheet (can be considered as covering the whole family)
> + http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
> +
> + - at91sam9n12
> + + Datasheet
> + http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
> +
> + * ARM Cortex-A5 based SoCs
> + - sama5d3 family
> + - sama5d31
> + - sama5d33
> + - sama5d34
> + - sama5d35
> + - sama5d36 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
> +
> + * ARM Cortex-A5 + NEON based SoCs
> + - sama5d4 family
> + - sama5d41
> + - sama5d42
> + - sama5d43
> + - sama5d44 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
> +
> +
> +Linux kernel information
> +------------------------
> +Linux kernel mach directory: arch/arm/mach-at91
> +MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
> +
> +
> +Device Tree for AT91 SoCs and boards
> +------------------------------------
> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
> +must use this method to boot the Linux kernel.
> +
> +Work In Progress statement:
> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
> +considered as "Unstable". To be completely clear, any at91 binding can change at
> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
> +the same source tree.
> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
> +definition of a "Stable" binding/ABI.
> +This statement will be removed by AT91 MAINTAINERS when appropriated.
> +
> +Naming conventions and best practice:
> +- SoCs Device Tree Source Include files are named after the official name of
> + the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
> +- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
> + shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
> + When collecting nodes for a particular peripheral or topic, the identifier have to
> + be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
> + or sama5d3_gmac.dtsi for example).
> +- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
> + that they can be identified easily. Note that the sama5d3[13456]ek.dts files
> + are an historical exception to this rule.
In fact, this set of boards are not the only exception. I will rephrase
the sentence as:
"Note that some files are historical exceptions to this rule
(sama5d3[13456]ek.dts, usb_a9g20.dts or animeo_ip.dts for example)."
Bye,
--
Nicolas Ferre
^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
2015-01-13 2:03 ` Olof Johansson
@ 2015-01-13 11:26 ` Nicolas Ferre
-1 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-13 11:26 UTC (permalink / raw)
To: Olof Johansson
Cc: linux-arm-kernel, linux-kernel, Arnd Bergmann, khilman,
Jean-Christophe PLAGNIOL-VILLARD, Boris BREZILLON,
Alexandre Belloni, Patrice Vilchez, Ludovic Desroches,
Cyrille Pitchen, ARM Maintainers
Le 13/01/2015 03:03, Olof Johansson a écrit :
> On Fri, Jan 09, 2015 at 02:20:31PM +0100, Nicolas Ferre wrote:
>> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
>> - SoC list + datasheet web links
>> - Basic but useful information
>> - Device Tree conventions and Work In Progress statement.
>>
>> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
>> Cc: ARM Maintainers <arm@kernel.org>
>
> Acked-by: Olof Johansson <olof@lixom.net>
>
> With the understanding that:
>
>> +Device Tree for AT91 SoCs and boards
>> +------------------------------------
>> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
>> +must use this method to boot the Linux kernel.
>> +
>> +Work In Progress statement:
>> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
>> +considered as "Unstable". To be completely clear, any at91 binding can change at
>> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
>> +the same source tree.
>> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
>> +definition of a "Stable" binding/ABI.
>> +This statement will be removed by AT91 MAINTAINERS when appropriated.
>
> While this statement is here, at the end of the day if you break a user
> you're responsible for fixing them. I.e. if a tree falls in the forest
> and nobody notices, then so be it.
>
> But you can't break existing users and point to this and get away with
> it. However, hopefully based on this doc users will go with practices
> that means that you can revise bindings if you have to.
Yes, that was the intention.
Thanks, bye,
--
Nicolas Ferre
^ permalink raw reply [flat|nested] 14+ messages in thread
* [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
@ 2015-01-13 11:26 ` Nicolas Ferre
0 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-13 11:26 UTC (permalink / raw)
To: linux-arm-kernel
Le 13/01/2015 03:03, Olof Johansson a ?crit :
> On Fri, Jan 09, 2015 at 02:20:31PM +0100, Nicolas Ferre wrote:
>> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
>> - SoC list + datasheet web links
>> - Basic but useful information
>> - Device Tree conventions and Work In Progress statement.
>>
>> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
>> Cc: ARM Maintainers <arm@kernel.org>
>
> Acked-by: Olof Johansson <olof@lixom.net>
>
> With the understanding that:
>
>> +Device Tree for AT91 SoCs and boards
>> +------------------------------------
>> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
>> +must use this method to boot the Linux kernel.
>> +
>> +Work In Progress statement:
>> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
>> +considered as "Unstable". To be completely clear, any at91 binding can change at
>> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
>> +the same source tree.
>> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
>> +definition of a "Stable" binding/ABI.
>> +This statement will be removed by AT91 MAINTAINERS when appropriated.
>
> While this statement is here, at the end of the day if you break a user
> you're responsible for fixing them. I.e. if a tree falls in the forest
> and nobody notices, then so be it.
>
> But you can't break existing users and point to this and get away with
> it. However, hopefully based on this doc users will go with practices
> that means that you can revise bindings if you have to.
Yes, that was the intention.
Thanks, bye,
--
Nicolas Ferre
^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
2015-01-13 11:26 ` Nicolas Ferre
@ 2015-01-13 11:36 ` Alexandre Belloni
-1 siblings, 0 replies; 14+ messages in thread
From: Alexandre Belloni @ 2015-01-13 11:36 UTC (permalink / raw)
To: Nicolas Ferre
Cc: linux-arm-kernel, linux-kernel, Arnd Bergmann, Olof Johansson,
khilman, Jean-Christophe PLAGNIOL-VILLARD, Boris BREZILLON,
Patrice Vilchez, Ludovic Desroches, Cyrille Pitchen,
ARM Maintainers
On 13/01/2015 at 12:26:04 +0100, Nicolas Ferre wrote :
> Le 09/01/2015 14:20, Nicolas Ferre a écrit :
> > Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
> > - SoC list + datasheet web links
> > - Basic but useful information
> > - Device Tree conventions and Work In Progress statement.
> >
> > Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
> > Cc: ARM Maintainers <arm@kernel.org>
> > ---
> > Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
> > 1 file changed, 120 insertions(+)
> > create mode 100644 Documentation/arm/Atmel/README
> >
> > diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
> > new file mode 100644
> > index 000000000000..538f8a556277
> > --- /dev/null
> > +++ b/Documentation/arm/Atmel/README
> > @@ -0,0 +1,120 @@
> > +ARM Atmel SoCs (aka AT91)
> > +=========================
> > +
> > +
> > +Introduction
> > +------------
> > +This document gives useful information about the ARM Atmel SoCs that are
> > +currently supported in Linux Mainline (you know, the one on kernel.org).
> > +
> > +It is important to note that the Atmel | SMART ARM-based MPU product line is
> > +historically named "AT91" or "at91" throughout the Linux kernel development
> > +process even if this product prefix has completely disappeared from the
> > +official Atmel product name. Anyway, files, directories, git trees,
> > +git branches/tags and email subject always contain this "at91" sub-string.
> > +
> > +
> > +AT91 SoCs
> > +---------
> > +Documentation and detailled datasheet for each product are available on
> > +the Atmel website: http://www.atmel.com.
> > +
> > + Flavors:
> > + * ARM 920 based SoC
> > + - at91rm9200
> > + + Datasheet
> > + http://www.atmel.com/Images/doc1768.pdf
> > +
> > + * ARM 926 based SoCs
> > + - at91sam9260
> > + + Datasheet
> > + http://www.atmel.com/Images/doc6221.pdf
> > +
at91sam9xe is still supported, the datasheet is there:
http://www.atmel.com/Images/Atmel-6254-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9XE_Datasheet.pdf
> > + - at91sam9261
> > + + Datasheet
> > + http://www.atmel.com/Images/doc6062.pdf
> > +
> > + - at91sam9263
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
> > +
> > + - at91sam9rl
> > + + Datasheet
> > + http://www.atmel.com/Images/doc6289.pdf
> > +
> > + - at91sam9g20
> > + + Datasheet
> > + http://www.atmel.com/Images/doc6384.pdf
> > +
> > + - at91sam9g45 family
> > + - at91sam9g45
> > + - at91sam9g46
> > + - at91sam9m10
> > + - at91sam9m11 (device superset)
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
> > +
> > + - at91sam9x5 family (aka "The 5 series")
> > + - at91sam9g15
> > + - at91sam9g25
> > + - at91sam9g35
> > + - at91sam9x25
> > + - at91sam9x35
> > + + Datasheet (can be considered as covering the whole family)
> > + http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
> > +
> > + - at91sam9n12
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
> > +
> > + * ARM Cortex-A5 based SoCs
> > + - sama5d3 family
> > + - sama5d31
> > + - sama5d33
> > + - sama5d34
> > + - sama5d35
> > + - sama5d36 (device superset)
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
> > +
> > + * ARM Cortex-A5 + NEON based SoCs
> > + - sama5d4 family
> > + - sama5d41
> > + - sama5d42
> > + - sama5d43
> > + - sama5d44 (device superset)
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
> > +
> > +
> > +Linux kernel information
> > +------------------------
> > +Linux kernel mach directory: arch/arm/mach-at91
> > +MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
> > +
> > +
> > +Device Tree for AT91 SoCs and boards
> > +------------------------------------
> > +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
> > +must use this method to boot the Linux kernel.
> > +
> > +Work In Progress statement:
> > +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
> > +considered as "Unstable". To be completely clear, any at91 binding can change at
> > +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
> > +the same source tree.
> > +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
> > +definition of a "Stable" binding/ABI.
> > +This statement will be removed by AT91 MAINTAINERS when appropriated.
> > +
> > +Naming conventions and best practice:
> > +- SoCs Device Tree Source Include files are named after the official name of
> > + the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
> > +- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
> > + shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
> > + When collecting nodes for a particular peripheral or topic, the identifier have to
> > + be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
> > + or sama5d3_gmac.dtsi for example).
> > +- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
> > + that they can be identified easily. Note that the sama5d3[13456]ek.dts files
> > + are an historical exception to this rule.
>
> In fact, this set of boards are not the only exception. I will rephrase
> the sentence as:
> "Note that some files are historical exceptions to this rule
> (sama5d3[13456]ek.dts, usb_a9g20.dts or animeo_ip.dts for example)."
>
> Bye,
> --
> Nicolas Ferre
--
Alexandre Belloni, Free Electrons
Embedded Linux, Kernel and Android engineering
http://free-electrons.com
^ permalink raw reply [flat|nested] 14+ messages in thread
* [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
@ 2015-01-13 11:36 ` Alexandre Belloni
0 siblings, 0 replies; 14+ messages in thread
From: Alexandre Belloni @ 2015-01-13 11:36 UTC (permalink / raw)
To: linux-arm-kernel
On 13/01/2015 at 12:26:04 +0100, Nicolas Ferre wrote :
> Le 09/01/2015 14:20, Nicolas Ferre a ?crit :
> > Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
> > - SoC list + datasheet web links
> > - Basic but useful information
> > - Device Tree conventions and Work In Progress statement.
> >
> > Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
> > Cc: ARM Maintainers <arm@kernel.org>
> > ---
> > Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
> > 1 file changed, 120 insertions(+)
> > create mode 100644 Documentation/arm/Atmel/README
> >
> > diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
> > new file mode 100644
> > index 000000000000..538f8a556277
> > --- /dev/null
> > +++ b/Documentation/arm/Atmel/README
> > @@ -0,0 +1,120 @@
> > +ARM Atmel SoCs (aka AT91)
> > +=========================
> > +
> > +
> > +Introduction
> > +------------
> > +This document gives useful information about the ARM Atmel SoCs that are
> > +currently supported in Linux Mainline (you know, the one on kernel.org).
> > +
> > +It is important to note that the Atmel | SMART ARM-based MPU product line is
> > +historically named "AT91" or "at91" throughout the Linux kernel development
> > +process even if this product prefix has completely disappeared from the
> > +official Atmel product name. Anyway, files, directories, git trees,
> > +git branches/tags and email subject always contain this "at91" sub-string.
> > +
> > +
> > +AT91 SoCs
> > +---------
> > +Documentation and detailled datasheet for each product are available on
> > +the Atmel website: http://www.atmel.com.
> > +
> > + Flavors:
> > + * ARM 920 based SoC
> > + - at91rm9200
> > + + Datasheet
> > + http://www.atmel.com/Images/doc1768.pdf
> > +
> > + * ARM 926 based SoCs
> > + - at91sam9260
> > + + Datasheet
> > + http://www.atmel.com/Images/doc6221.pdf
> > +
at91sam9xe is still supported, the datasheet is there:
http://www.atmel.com/Images/Atmel-6254-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9XE_Datasheet.pdf
> > + - at91sam9261
> > + + Datasheet
> > + http://www.atmel.com/Images/doc6062.pdf
> > +
> > + - at91sam9263
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
> > +
> > + - at91sam9rl
> > + + Datasheet
> > + http://www.atmel.com/Images/doc6289.pdf
> > +
> > + - at91sam9g20
> > + + Datasheet
> > + http://www.atmel.com/Images/doc6384.pdf
> > +
> > + - at91sam9g45 family
> > + - at91sam9g45
> > + - at91sam9g46
> > + - at91sam9m10
> > + - at91sam9m11 (device superset)
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
> > +
> > + - at91sam9x5 family (aka "The 5 series")
> > + - at91sam9g15
> > + - at91sam9g25
> > + - at91sam9g35
> > + - at91sam9x25
> > + - at91sam9x35
> > + + Datasheet (can be considered as covering the whole family)
> > + http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
> > +
> > + - at91sam9n12
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
> > +
> > + * ARM Cortex-A5 based SoCs
> > + - sama5d3 family
> > + - sama5d31
> > + - sama5d33
> > + - sama5d34
> > + - sama5d35
> > + - sama5d36 (device superset)
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
> > +
> > + * ARM Cortex-A5 + NEON based SoCs
> > + - sama5d4 family
> > + - sama5d41
> > + - sama5d42
> > + - sama5d43
> > + - sama5d44 (device superset)
> > + + Datasheet
> > + http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
> > +
> > +
> > +Linux kernel information
> > +------------------------
> > +Linux kernel mach directory: arch/arm/mach-at91
> > +MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
> > +
> > +
> > +Device Tree for AT91 SoCs and boards
> > +------------------------------------
> > +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
> > +must use this method to boot the Linux kernel.
> > +
> > +Work In Progress statement:
> > +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
> > +considered as "Unstable". To be completely clear, any at91 binding can change at
> > +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
> > +the same source tree.
> > +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
> > +definition of a "Stable" binding/ABI.
> > +This statement will be removed by AT91 MAINTAINERS when appropriated.
> > +
> > +Naming conventions and best practice:
> > +- SoCs Device Tree Source Include files are named after the official name of
> > + the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
> > +- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
> > + shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
> > + When collecting nodes for a particular peripheral or topic, the identifier have to
> > + be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
> > + or sama5d3_gmac.dtsi for example).
> > +- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
> > + that they can be identified easily. Note that the sama5d3[13456]ek.dts files
> > + are an historical exception to this rule.
>
> In fact, this set of boards are not the only exception. I will rephrase
> the sentence as:
> "Note that some files are historical exceptions to this rule
> (sama5d3[13456]ek.dts, usb_a9g20.dts or animeo_ip.dts for example)."
>
> Bye,
> --
> Nicolas Ferre
--
Alexandre Belloni, Free Electrons
Embedded Linux, Kernel and Android engineering
http://free-electrons.com
^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
2015-01-13 11:36 ` Alexandre Belloni
@ 2015-01-13 13:40 ` Nicolas Ferre
-1 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-13 13:40 UTC (permalink / raw)
To: Alexandre Belloni
Cc: linux-arm-kernel, linux-kernel, Arnd Bergmann, Olof Johansson,
khilman, Jean-Christophe PLAGNIOL-VILLARD, Boris BREZILLON,
Patrice Vilchez, Ludovic Desroches, Cyrille Pitchen,
ARM Maintainers
Le 13/01/2015 12:36, Alexandre Belloni a écrit :
> On 13/01/2015 at 12:26:04 +0100, Nicolas Ferre wrote :
>> Le 09/01/2015 14:20, Nicolas Ferre a écrit :
>>> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
>>> - SoC list + datasheet web links
>>> - Basic but useful information
>>> - Device Tree conventions and Work In Progress statement.
>>>
>>> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
>>> Cc: ARM Maintainers <arm@kernel.org>
>>> ---
>>> Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
>>> 1 file changed, 120 insertions(+)
>>> create mode 100644 Documentation/arm/Atmel/README
>>>
>>> diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
>>> new file mode 100644
>>> index 000000000000..538f8a556277
>>> --- /dev/null
>>> +++ b/Documentation/arm/Atmel/README
>>> @@ -0,0 +1,120 @@
>>> +ARM Atmel SoCs (aka AT91)
>>> +=========================
>>> +
>>> +
>>> +Introduction
>>> +------------
>>> +This document gives useful information about the ARM Atmel SoCs that are
>>> +currently supported in Linux Mainline (you know, the one on kernel.org).
>>> +
>>> +It is important to note that the Atmel | SMART ARM-based MPU product line is
>>> +historically named "AT91" or "at91" throughout the Linux kernel development
>>> +process even if this product prefix has completely disappeared from the
>>> +official Atmel product name. Anyway, files, directories, git trees,
>>> +git branches/tags and email subject always contain this "at91" sub-string.
>>> +
>>> +
>>> +AT91 SoCs
>>> +---------
>>> +Documentation and detailled datasheet for each product are available on
>>> +the Atmel website: http://www.atmel.com.
>>> +
>>> + Flavors:
>>> + * ARM 920 based SoC
>>> + - at91rm9200
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc1768.pdf
>>> +
>>> + * ARM 926 based SoCs
>>> + - at91sam9260
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc6221.pdf
>>> +
>
> at91sam9xe is still supported, the datasheet is there:
> http://www.atmel.com/Images/Atmel-6254-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9XE_Datasheet.pdf
Ok, I add it. Thanks.
>>> + - at91sam9261
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc6062.pdf
>>> +
>>> + - at91sam9263
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
>>> +
>>> + - at91sam9rl
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc6289.pdf
>>> +
>>> + - at91sam9g20
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc6384.pdf
>>> +
>>> + - at91sam9g45 family
>>> + - at91sam9g45
>>> + - at91sam9g46
>>> + - at91sam9m10
>>> + - at91sam9m11 (device superset)
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
>>> +
>>> + - at91sam9x5 family (aka "The 5 series")
>>> + - at91sam9g15
>>> + - at91sam9g25
>>> + - at91sam9g35
>>> + - at91sam9x25
>>> + - at91sam9x35
>>> + + Datasheet (can be considered as covering the whole family)
>>> + http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
>>> +
>>> + - at91sam9n12
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
>>> +
>>> + * ARM Cortex-A5 based SoCs
>>> + - sama5d3 family
>>> + - sama5d31
>>> + - sama5d33
>>> + - sama5d34
>>> + - sama5d35
>>> + - sama5d36 (device superset)
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
>>> +
>>> + * ARM Cortex-A5 + NEON based SoCs
>>> + - sama5d4 family
>>> + - sama5d41
>>> + - sama5d42
>>> + - sama5d43
>>> + - sama5d44 (device superset)
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
>>> +
>>> +
>>> +Linux kernel information
>>> +------------------------
>>> +Linux kernel mach directory: arch/arm/mach-at91
>>> +MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
>>> +
>>> +
>>> +Device Tree for AT91 SoCs and boards
>>> +------------------------------------
>>> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
>>> +must use this method to boot the Linux kernel.
>>> +
>>> +Work In Progress statement:
>>> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
>>> +considered as "Unstable". To be completely clear, any at91 binding can change at
>>> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
>>> +the same source tree.
>>> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
>>> +definition of a "Stable" binding/ABI.
>>> +This statement will be removed by AT91 MAINTAINERS when appropriated.
>>> +
>>> +Naming conventions and best practice:
>>> +- SoCs Device Tree Source Include files are named after the official name of
>>> + the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
>>> +- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
>>> + shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
>>> + When collecting nodes for a particular peripheral or topic, the identifier have to
>>> + be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
>>> + or sama5d3_gmac.dtsi for example).
>>> +- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
>>> + that they can be identified easily. Note that the sama5d3[13456]ek.dts files
>>> + are an historical exception to this rule.
>>
>> In fact, this set of boards are not the only exception. I will rephrase
>> the sentence as:
>> "Note that some files are historical exceptions to this rule
>> (sama5d3[13456]ek.dts, usb_a9g20.dts or animeo_ip.dts for example)."
>>
>> Bye,
>> --
>> Nicolas Ferre
>
--
Nicolas Ferre
^ permalink raw reply [flat|nested] 14+ messages in thread
* [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
@ 2015-01-13 13:40 ` Nicolas Ferre
0 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-13 13:40 UTC (permalink / raw)
To: linux-arm-kernel
Le 13/01/2015 12:36, Alexandre Belloni a ?crit :
> On 13/01/2015 at 12:26:04 +0100, Nicolas Ferre wrote :
>> Le 09/01/2015 14:20, Nicolas Ferre a ?crit :
>>> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
>>> - SoC list + datasheet web links
>>> - Basic but useful information
>>> - Device Tree conventions and Work In Progress statement.
>>>
>>> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
>>> Cc: ARM Maintainers <arm@kernel.org>
>>> ---
>>> Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
>>> 1 file changed, 120 insertions(+)
>>> create mode 100644 Documentation/arm/Atmel/README
>>>
>>> diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
>>> new file mode 100644
>>> index 000000000000..538f8a556277
>>> --- /dev/null
>>> +++ b/Documentation/arm/Atmel/README
>>> @@ -0,0 +1,120 @@
>>> +ARM Atmel SoCs (aka AT91)
>>> +=========================
>>> +
>>> +
>>> +Introduction
>>> +------------
>>> +This document gives useful information about the ARM Atmel SoCs that are
>>> +currently supported in Linux Mainline (you know, the one on kernel.org).
>>> +
>>> +It is important to note that the Atmel | SMART ARM-based MPU product line is
>>> +historically named "AT91" or "at91" throughout the Linux kernel development
>>> +process even if this product prefix has completely disappeared from the
>>> +official Atmel product name. Anyway, files, directories, git trees,
>>> +git branches/tags and email subject always contain this "at91" sub-string.
>>> +
>>> +
>>> +AT91 SoCs
>>> +---------
>>> +Documentation and detailled datasheet for each product are available on
>>> +the Atmel website: http://www.atmel.com.
>>> +
>>> + Flavors:
>>> + * ARM 920 based SoC
>>> + - at91rm9200
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc1768.pdf
>>> +
>>> + * ARM 926 based SoCs
>>> + - at91sam9260
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc6221.pdf
>>> +
>
> at91sam9xe is still supported, the datasheet is there:
> http://www.atmel.com/Images/Atmel-6254-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9XE_Datasheet.pdf
Ok, I add it. Thanks.
>>> + - at91sam9261
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc6062.pdf
>>> +
>>> + - at91sam9263
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
>>> +
>>> + - at91sam9rl
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc6289.pdf
>>> +
>>> + - at91sam9g20
>>> + + Datasheet
>>> + http://www.atmel.com/Images/doc6384.pdf
>>> +
>>> + - at91sam9g45 family
>>> + - at91sam9g45
>>> + - at91sam9g46
>>> + - at91sam9m10
>>> + - at91sam9m11 (device superset)
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
>>> +
>>> + - at91sam9x5 family (aka "The 5 series")
>>> + - at91sam9g15
>>> + - at91sam9g25
>>> + - at91sam9g35
>>> + - at91sam9x25
>>> + - at91sam9x35
>>> + + Datasheet (can be considered as covering the whole family)
>>> + http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
>>> +
>>> + - at91sam9n12
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
>>> +
>>> + * ARM Cortex-A5 based SoCs
>>> + - sama5d3 family
>>> + - sama5d31
>>> + - sama5d33
>>> + - sama5d34
>>> + - sama5d35
>>> + - sama5d36 (device superset)
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
>>> +
>>> + * ARM Cortex-A5 + NEON based SoCs
>>> + - sama5d4 family
>>> + - sama5d41
>>> + - sama5d42
>>> + - sama5d43
>>> + - sama5d44 (device superset)
>>> + + Datasheet
>>> + http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
>>> +
>>> +
>>> +Linux kernel information
>>> +------------------------
>>> +Linux kernel mach directory: arch/arm/mach-at91
>>> +MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
>>> +
>>> +
>>> +Device Tree for AT91 SoCs and boards
>>> +------------------------------------
>>> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
>>> +must use this method to boot the Linux kernel.
>>> +
>>> +Work In Progress statement:
>>> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
>>> +considered as "Unstable". To be completely clear, any at91 binding can change at
>>> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
>>> +the same source tree.
>>> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
>>> +definition of a "Stable" binding/ABI.
>>> +This statement will be removed by AT91 MAINTAINERS when appropriated.
>>> +
>>> +Naming conventions and best practice:
>>> +- SoCs Device Tree Source Include files are named after the official name of
>>> + the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
>>> +- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
>>> + shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
>>> + When collecting nodes for a particular peripheral or topic, the identifier have to
>>> + be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
>>> + or sama5d3_gmac.dtsi for example).
>>> +- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
>>> + that they can be identified easily. Note that the sama5d3[13456]ek.dts files
>>> + are an historical exception to this rule.
>>
>> In fact, this set of boards are not the only exception. I will rephrase
>> the sentence as:
>> "Note that some files are historical exceptions to this rule
>> (sama5d3[13456]ek.dts, usb_a9g20.dts or animeo_ip.dts for example)."
>>
>> Bye,
>> --
>> Nicolas Ferre
>
--
Nicolas Ferre
^ permalink raw reply [flat|nested] 14+ messages in thread
* Re: [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
2015-01-09 13:20 ` Nicolas Ferre
@ 2015-01-15 14:27 ` Nicolas Ferre
-1 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-15 14:27 UTC (permalink / raw)
To: linux-arm-kernel, linux-kernel, Arnd Bergmann, Olof Johansson, khilman
Cc: Jean-Christophe PLAGNIOL-VILLARD, Boris BREZILLON,
Alexandre Belloni, Patrice Vilchez, Ludovic Desroches,
Cyrille Pitchen, ARM Maintainers
Le 09/01/2015 14:20, Nicolas Ferre a écrit :
> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
> - SoC list + datasheet web links
> - Basic but useful information
> - Device Tree conventions and Work In Progress statement.
>
> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
> Cc: ARM Maintainers <arm@kernel.org>
With corrections by Alexandre and myself, pushed in at91-3.20-cleanup
Bye.
> ---
> Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
> 1 file changed, 120 insertions(+)
> create mode 100644 Documentation/arm/Atmel/README
>
> diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
> new file mode 100644
> index 000000000000..538f8a556277
> --- /dev/null
> +++ b/Documentation/arm/Atmel/README
> @@ -0,0 +1,120 @@
> +ARM Atmel SoCs (aka AT91)
> +=========================
> +
> +
> +Introduction
> +------------
> +This document gives useful information about the ARM Atmel SoCs that are
> +currently supported in Linux Mainline (you know, the one on kernel.org).
> +
> +It is important to note that the Atmel | SMART ARM-based MPU product line is
> +historically named "AT91" or "at91" throughout the Linux kernel development
> +process even if this product prefix has completely disappeared from the
> +official Atmel product name. Anyway, files, directories, git trees,
> +git branches/tags and email subject always contain this "at91" sub-string.
> +
> +
> +AT91 SoCs
> +---------
> +Documentation and detailled datasheet for each product are available on
> +the Atmel website: http://www.atmel.com.
> +
> + Flavors:
> + * ARM 920 based SoC
> + - at91rm9200
> + + Datasheet
> + http://www.atmel.com/Images/doc1768.pdf
> +
> + * ARM 926 based SoCs
> + - at91sam9260
> + + Datasheet
> + http://www.atmel.com/Images/doc6221.pdf
> +
> + - at91sam9261
> + + Datasheet
> + http://www.atmel.com/Images/doc6062.pdf
> +
> + - at91sam9263
> + + Datasheet
> + http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
> +
> + - at91sam9rl
> + + Datasheet
> + http://www.atmel.com/Images/doc6289.pdf
> +
> + - at91sam9g20
> + + Datasheet
> + http://www.atmel.com/Images/doc6384.pdf
> +
> + - at91sam9g45 family
> + - at91sam9g45
> + - at91sam9g46
> + - at91sam9m10
> + - at91sam9m11 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
> +
> + - at91sam9x5 family (aka "The 5 series")
> + - at91sam9g15
> + - at91sam9g25
> + - at91sam9g35
> + - at91sam9x25
> + - at91sam9x35
> + + Datasheet (can be considered as covering the whole family)
> + http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
> +
> + - at91sam9n12
> + + Datasheet
> + http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
> +
> + * ARM Cortex-A5 based SoCs
> + - sama5d3 family
> + - sama5d31
> + - sama5d33
> + - sama5d34
> + - sama5d35
> + - sama5d36 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
> +
> + * ARM Cortex-A5 + NEON based SoCs
> + - sama5d4 family
> + - sama5d41
> + - sama5d42
> + - sama5d43
> + - sama5d44 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
> +
> +
> +Linux kernel information
> +------------------------
> +Linux kernel mach directory: arch/arm/mach-at91
> +MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
> +
> +
> +Device Tree for AT91 SoCs and boards
> +------------------------------------
> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
> +must use this method to boot the Linux kernel.
> +
> +Work In Progress statement:
> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
> +considered as "Unstable". To be completely clear, any at91 binding can change at
> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
> +the same source tree.
> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
> +definition of a "Stable" binding/ABI.
> +This statement will be removed by AT91 MAINTAINERS when appropriated.
> +
> +Naming conventions and best practice:
> +- SoCs Device Tree Source Include files are named after the official name of
> + the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
> +- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
> + shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
> + When collecting nodes for a particular peripheral or topic, the identifier have to
> + be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
> + or sama5d3_gmac.dtsi for example).
> +- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
> + that they can be identified easily. Note that the sama5d3[13456]ek.dts files
> + are an historical exception to this rule.
>
--
Nicolas Ferre
^ permalink raw reply [flat|nested] 14+ messages in thread
* [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs
@ 2015-01-15 14:27 ` Nicolas Ferre
0 siblings, 0 replies; 14+ messages in thread
From: Nicolas Ferre @ 2015-01-15 14:27 UTC (permalink / raw)
To: linux-arm-kernel
Le 09/01/2015 14:20, Nicolas Ferre a ?crit :
> Add a README file to describe Atmel SoCs (aka AT91) support in Mainline Linux:
> - SoC list + datasheet web links
> - Basic but useful information
> - Device Tree conventions and Work In Progress statement.
>
> Signed-off-by: Nicolas Ferre <nicolas.ferre@atmel.com>
> Cc: ARM Maintainers <arm@kernel.org>
With corrections by Alexandre and myself, pushed in at91-3.20-cleanup
Bye.
> ---
> Documentation/arm/Atmel/README | 120 +++++++++++++++++++++++++++++++++++++++++
> 1 file changed, 120 insertions(+)
> create mode 100644 Documentation/arm/Atmel/README
>
> diff --git a/Documentation/arm/Atmel/README b/Documentation/arm/Atmel/README
> new file mode 100644
> index 000000000000..538f8a556277
> --- /dev/null
> +++ b/Documentation/arm/Atmel/README
> @@ -0,0 +1,120 @@
> +ARM Atmel SoCs (aka AT91)
> +=========================
> +
> +
> +Introduction
> +------------
> +This document gives useful information about the ARM Atmel SoCs that are
> +currently supported in Linux Mainline (you know, the one on kernel.org).
> +
> +It is important to note that the Atmel | SMART ARM-based MPU product line is
> +historically named "AT91" or "at91" throughout the Linux kernel development
> +process even if this product prefix has completely disappeared from the
> +official Atmel product name. Anyway, files, directories, git trees,
> +git branches/tags and email subject always contain this "at91" sub-string.
> +
> +
> +AT91 SoCs
> +---------
> +Documentation and detailled datasheet for each product are available on
> +the Atmel website: http://www.atmel.com.
> +
> + Flavors:
> + * ARM 920 based SoC
> + - at91rm9200
> + + Datasheet
> + http://www.atmel.com/Images/doc1768.pdf
> +
> + * ARM 926 based SoCs
> + - at91sam9260
> + + Datasheet
> + http://www.atmel.com/Images/doc6221.pdf
> +
> + - at91sam9261
> + + Datasheet
> + http://www.atmel.com/Images/doc6062.pdf
> +
> + - at91sam9263
> + + Datasheet
> + http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
> +
> + - at91sam9rl
> + + Datasheet
> + http://www.atmel.com/Images/doc6289.pdf
> +
> + - at91sam9g20
> + + Datasheet
> + http://www.atmel.com/Images/doc6384.pdf
> +
> + - at91sam9g45 family
> + - at91sam9g45
> + - at91sam9g46
> + - at91sam9m10
> + - at91sam9m11 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
> +
> + - at91sam9x5 family (aka "The 5 series")
> + - at91sam9g15
> + - at91sam9g25
> + - at91sam9g35
> + - at91sam9x25
> + - at91sam9x35
> + + Datasheet (can be considered as covering the whole family)
> + http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
> +
> + - at91sam9n12
> + + Datasheet
> + http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
> +
> + * ARM Cortex-A5 based SoCs
> + - sama5d3 family
> + - sama5d31
> + - sama5d33
> + - sama5d34
> + - sama5d35
> + - sama5d36 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
> +
> + * ARM Cortex-A5 + NEON based SoCs
> + - sama5d4 family
> + - sama5d41
> + - sama5d42
> + - sama5d43
> + - sama5d44 (device superset)
> + + Datasheet
> + http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
> +
> +
> +Linux kernel information
> +------------------------
> +Linux kernel mach directory: arch/arm/mach-at91
> +MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
> +
> +
> +Device Tree for AT91 SoCs and boards
> +------------------------------------
> +All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
> +must use this method to boot the Linux kernel.
> +
> +Work In Progress statement:
> +Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
> +considered as "Unstable". To be completely clear, any at91 binding can change at
> +any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
> +the same source tree.
> +Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
> +definition of a "Stable" binding/ABI.
> +This statement will be removed by AT91 MAINTAINERS when appropriated.
> +
> +Naming conventions and best practice:
> +- SoCs Device Tree Source Include files are named after the official name of
> + the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
> +- Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
> + shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
> + When collecting nodes for a particular peripheral or topic, the identifier have to
> + be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
> + or sama5d3_gmac.dtsi for example).
> +- board Device Tree Source files (.dts) are prefixed by the string "at91-" so
> + that they can be identified easily. Note that the sama5d3[13456]ek.dts files
> + are an historical exception to this rule.
>
--
Nicolas Ferre
^ permalink raw reply [flat|nested] 14+ messages in thread
end of thread, other threads:[~2015-01-15 14:27 UTC | newest]
Thread overview: 14+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-01-09 13:20 [PATCH] ARM: at91/Documentation: add a README for Atmel SoCs Nicolas Ferre
2015-01-09 13:20 ` Nicolas Ferre
2015-01-13 2:03 ` Olof Johansson
2015-01-13 2:03 ` Olof Johansson
2015-01-13 11:26 ` Nicolas Ferre
2015-01-13 11:26 ` Nicolas Ferre
2015-01-13 11:26 ` Nicolas Ferre
2015-01-13 11:26 ` Nicolas Ferre
2015-01-13 11:36 ` Alexandre Belloni
2015-01-13 11:36 ` Alexandre Belloni
2015-01-13 13:40 ` Nicolas Ferre
2015-01-13 13:40 ` Nicolas Ferre
2015-01-15 14:27 ` Nicolas Ferre
2015-01-15 14:27 ` Nicolas Ferre
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.