1 ARM Microchip SoCs (aka AT91)
2 =============================
7 This document gives useful information about the ARM Microchip SoCs that are
8 currently supported in Linux Mainline (you know, the one on kernel.org).
10 It is important to note that the Microchip (previously Atmel) ARM-based MPU
11 product line is historically named "AT91" or "at91" throughout the Linux kernel
12 development process even if this product prefix has completely disappeared from
13 the official Microchip product name. Anyway, files, directories, git trees,
14 git branches/tags and email subject always contain this "at91" sub-string.
19 Documentation and detailed datasheet for each product are available on
20 the Microchip website: http://www.microchip.com.
26 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-1768-32-bit-ARM920T-Embedded-Microprocessor-AT91RM9200_Datasheet.pdf
31 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6221-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9260_Datasheet.pdf
35 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6254-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9XE_Datasheet.pdf
39 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6062-ARM926EJ-S-Microprocessor-SAM9261_Datasheet.pdf
43 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6249-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9263_Datasheet.pdf
47 http://ww1.microchip.com/downloads/en/DeviceDoc/doc6289.pdf
51 http://ww1.microchip.com/downloads/en/DeviceDoc/DS60001516A.pdf
57 - at91sam9m11 (device superset)
59 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
61 - at91sam9x5 family (aka "The 5 series")
67 + Datasheet (can be considered as covering the whole family)
68 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-11055-32-bit-ARM926EJ-S-Microcontroller-SAM9X35_Datasheet.pdf
72 http://ww1.microchip.com/downloads/en/DeviceDoc/DS60001517A.pdf
74 * ARM Cortex-A5 based SoCs
80 - sama5d36 (device superset)
82 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
84 * ARM Cortex-A5 + NEON based SoCs
89 - sama5d44 (device superset)
91 http://ww1.microchip.com/downloads/en/DeviceDoc/60001525A.pdf
99 - sama5d27 (device superset)
100 - sama5d28 (device superset + environmental monitors)
102 http://ww1.microchip.com/downloads/en/DeviceDoc/DS60001476B.pdf
136 http://ww1.microchip.com/downloads/en/DeviceDoc/60001527A.pdf
139 Linux kernel information
140 ------------------------
141 Linux kernel mach directory: arch/arm/mach-at91
142 MAINTAINERS entry is: "ARM/Microchip (AT91) SoC support"
145 Device Tree for AT91 SoCs and boards
146 ------------------------------------
147 All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
148 must use this method to boot the Linux kernel.
150 Work In Progress statement:
151 Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
152 considered as "Unstable". To be completely clear, any at91 binding can change at
153 any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
154 the same source tree.
155 Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
156 definition of a "Stable" binding/ABI.
157 This statement will be removed by AT91 MAINTAINERS when appropriate.
159 Naming conventions and best practice:
160 - SoCs Device Tree Source Include files are named after the official name of
161 the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
162 - Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
163 shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
164 When collecting nodes for a particular peripheral or topic, the identifier have to
165 be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
166 or sama5d3_gmac.dtsi for example).
167 - board Device Tree Source files (.dts) are prefixed by the string "at91-" so
168 that they can be identified easily. Note that some files are historical exceptions
169 to this rule (sama5d3[13456]ek.dts, usb_a9g20.dts or animeo_ip.dts for example).