← Documents Documentation/arch/arm/microchip.rst GitHub 원문 ↗

Linux 6.18.37 · Architecture

ARM Microchip SoCs (aka AT91)

AT91로 불리는 Microchip/Atmel ARM SoC·MCU family와 mainline 위치, datasheet, Device Tree naming·ABI 규칙을 정리합니다.

Source pathDocumentation/arch/arm/microchip.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

microchip.rst:1-230

공식 제품명은 바뀌었지만 Linux의 유지보수 단위는 여전히 `at91`입니다. ARM920·ARM926에서 Cortex-A5/A7와 Cortex-M7까지 이어지는 제품군이 `arch/arm/mach-at91`과 공통 Device Tree 규칙 아래 묶입니다.

AT91 architecture 세대
ARM920ARM926Cortex-A5Cortex-A5 + NEONCortex-A7
AT91 namingarch/arm/mach-at91Cortex-M7 MCUs

Linux에서 같은 AT91 유지보수 계보로 다루는 CPU 세대입니다.

Device Tree naming
대상규칙
SoC include공식 제품명.dtsisama5d33.dtsi
공통 peripheral이름_주제.dtsisama5d3_gmac.dtsi
boardat91- prefix일부 역사적 예외 존재

파일이 나타내는 범위에 따라 이름 규칙이 달라집니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 =============================
2 ARM Microchip SoCs (aka AT91)
3 =============================
4
5
6 Introduction
7 ------------
8 This document gives useful information about the ARM Microchip SoCs that are
9 currently supported in Linux Mainline (you know, the one on kernel.org).
10
11 It is important to note that the Microchip (previously Atmel) ARM-based MPU
12 product line is historically named "AT91" or "at91" throughout the Linux kernel
13 development process even if this product prefix has completely disappeared from
14 the official Microchip product name. Anyway, files, directories, git trees,
15 git branches/tags and email subject always contain this "at91" sub-string.
16
17
18 AT91 SoCs
19 ---------
20 Documentation and detailed datasheet for each product are available on
21 the Microchip website: http://www.microchip.com.
22
23 Flavors:
24 * ARM 920 based SoC
25 - at91rm9200
26
27 * Datasheet
28
29 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-1768-32-bit-ARM920T-Embedded-Microprocessor-AT91RM9200_Datasheet.pdf
30
31 * ARM 926 based SoCs
32 - at91sam9260
33
34 * Datasheet
35
36 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6221-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9260_Datasheet.pdf
37
38 - at91sam9xe
39
40 * Datasheet
41
42 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6254-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9XE_Datasheet.pdf
43
44 - at91sam9261
45
46 * Datasheet
47
48 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6062-ARM926EJ-S-Microprocessor-SAM9261_Datasheet.pdf
49
50 - at91sam9263
51
52 * Datasheet
53
54 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6249-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9263_Datasheet.pdf
55
56 - at91sam9rl
57
58 * Datasheet
59
60 http://ww1.microchip.com/downloads/en/DeviceDoc/doc6289.pdf
61
62 - at91sam9g20
63
64 * Datasheet
65
66 http://ww1.microchip.com/downloads/en/DeviceDoc/DS60001516A.pdf
67
68 - at91sam9g45 family
69 - at91sam9g45
70 - at91sam9g46
71 - at91sam9m10
72 - at91sam9m11 (device superset)
73
74 * Datasheet
75
76 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
77
78 - at91sam9x5 family (aka "The 5 series")
79 - at91sam9g15
80 - at91sam9g25
81 - at91sam9g35
82 - at91sam9x25
83 - at91sam9x35
84
85 * Datasheet (can be considered as covering the whole family)
86
87 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-11055-32-bit-ARM926EJ-S-Microcontroller-SAM9X35_Datasheet.pdf
88
89 - at91sam9n12
90
91 * Datasheet
92
93 http://ww1.microchip.com/downloads/en/DeviceDoc/DS60001517A.pdf
94
95 - sam9x60
96
97 * Datasheet
98
99 http://ww1.microchip.com/downloads/en/DeviceDoc/SAM9X60-Data-Sheet-DS60001579A.pdf
100
101 * ARM Cortex-A5 based SoCs
102 - sama5d3 family
103
104 - sama5d31
105 - sama5d33
106 - sama5d34
107 - sama5d35
108 - sama5d36 (device superset)
109
110 * Datasheet
111
112 http://ww1.microchip.com/downloads/en/DeviceDoc/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet_B.pdf
113
114 * ARM Cortex-A5 + NEON based SoCs
115 - sama5d4 family
116
117 - sama5d41
118 - sama5d42
119 - sama5d43
120 - sama5d44 (device superset)
121
122 * Datasheet
123
124 http://ww1.microchip.com/downloads/en/DeviceDoc/60001525A.pdf
125
126 - sama5d2 family
127
128 - sama5d21
129 - sama5d22
130 - sama5d23
131 - sama5d24
132 - sama5d26
133 - sama5d27 (device superset)
134 - sama5d28 (device superset + environmental monitors)
135
136 * Datasheet
137
138 http://ww1.microchip.com/downloads/en/DeviceDoc/DS60001476B.pdf
139
140 * ARM Cortex-A7 based SoCs
141 - sama7g5 family
142
143 - sama7g51
144 - sama7g52
145 - sama7g53
146 - sama7g54 (device superset)
147
148 * Datasheet
149
150 Coming soon
151
152 - lan966 family
153 - lan9662
154 - lan9668
155
156 * Datasheet
157
158 Coming soon
159
160 * ARM Cortex-M7 MCUs
161 - sams70 family
162
163 - sams70j19
164 - sams70j20
165 - sams70j21
166 - sams70n19
167 - sams70n20
168 - sams70n21
169 - sams70q19
170 - sams70q20
171 - sams70q21
172
173 - samv70 family
174
175 - samv70j19
176 - samv70j20
177 - samv70n19
178 - samv70n20
179 - samv70q19
180 - samv70q20
181
182 - samv71 family
183
184 - samv71j19
185 - samv71j20
186 - samv71j21
187 - samv71n19
188 - samv71n20
189 - samv71n21
190 - samv71q19
191 - samv71q20
192 - samv71q21
193
194 * Datasheet
195
196 http://ww1.microchip.com/downloads/en/DeviceDoc/SAM-E70-S70-V70-V71-Family-Data-Sheet-DS60001527D.pdf
197
198
199 Linux kernel information
200 ------------------------
201 Linux kernel mach directory: arch/arm/mach-at91
202 MAINTAINERS entry is: "ARM/Microchip (AT91) SoC support"
203
204
205 Device Tree for AT91 SoCs and boards
206 ------------------------------------
207 All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
208 must use this method to boot the Linux kernel.
209
210 Work In Progress statement:
211 Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
212 considered as "Unstable". To be completely clear, any at91 binding can change at
213 any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
214 the same source tree.
215 Please refer to the Documentation/devicetree/bindings/ABI.rst file for a
216 definition of a "Stable" binding/ABI.
217 This statement will be removed by AT91 MAINTAINERS when appropriate.
218
219 Naming conventions and best practice:
220
221 - SoCs Device Tree Source Include files are named after the official name of
222 the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
223 - Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
224 shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
225 When collecting nodes for a particular peripheral or topic, the identifier have to
226 be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
227 or sama5d3_gmac.dtsi for example).
228 - board Device Tree Source files (.dts) are prefixed by the string "at91-" so
229 that they can be identified easily. Note that some files are historical exceptions
230 to this rule (sama5d3[13456]ek.dts, usb_a9g20.dts or animeo_ip.dts for example).
231

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

ARM Microchip SoCs (aka AT91)

1-5

Linux에서 역사적으로 AT91이라 부르는 Microchip ARM SoC family 문서입니다.

Introduction

6-17

이 문서는 kernel.org의 Linux mainline이 현재 지원하는 ARM Microchip SoC에 유용한 정보를 제공합니다.

Microchip, 이전 Atmel의 ARM 기반 MPU product line은 공식 제품명에서 해당 prefix가 완전히 사라졌어도 Linux kernel 개발 과정에서는 역사적으로 `AT91` 또는 `at91`이라 불립니다. 그래서 file, directory, git tree, branch와 tag, email subject에는 계속 `at91` substring이 들어갑니다.

AT91 SoCs: ARM 920

18-30

각 제품의 상세 문서와 datasheet는 Microchip web site에서 제공합니다. ARM 920 기반 SoC는 `at91rm9200`입니다.

AT91 SoCs: ARM 926

31-100
family·flavor구성·비고
`at91sam9260`ARM926EJ-S embedded microprocessor
`at91sam9xe`ARM926EJ-S embedded microprocessor
`at91sam9261`ARM926EJ-S microprocessor
`at91sam9263`ARM926EJ-S embedded microprocessor
`at91sam9rl`ARM926 기반 SoC
`at91sam9g20`ARM926 기반 SoC
`at91sam9g45` family`at91sam9g45`, `at91sam9g46`, `at91sam9m10`, `at91sam9m11`(device superset)
`at91sam9x5` family, The 5 series`at91sam9g15`, `at91sam9g25`, `at91sam9g35`, `at91sam9x25`, `at91sam9x35`; X35 datasheet가 전체 family를 포괄
`at91sam9n12`ARM926 기반 SoC
`sam9x60`ARM926 기반 SoC

각 flavor와 family에 연결된 원문 datasheet URL을 아래에 그대로 보존합니다.

AT91 SoCs: Cortex-A5 and NEON

101-139
familyflavor특성
`sama5d3``sama5d31`, `sama5d33`, `sama5d34`, `sama5d35`, `sama5d36`ARM Cortex-A5; `sama5d36`은 device superset
`sama5d4``sama5d41`, `sama5d42`, `sama5d43`, `sama5d44`ARM Cortex-A5 + NEON; `sama5d44`는 device superset
`sama5d2``sama5d21`, `sama5d22`, `sama5d23`, `sama5d24`, `sama5d26`, `sama5d27`, `sama5d28``sama5d27`은 device superset, `sama5d28`은 environmental monitor도 포함한 superset

AT91 SoCs: Cortex-A7

140-159
familyflavordatasheet 상태
`sama7g5``sama7g51`, `sama7g52`, `sama7g53`, `sama7g54`(device superset)Coming soon
`lan966``lan9662`, `lan9668`Coming soon

AT91 SoCs: Cortex-M7 MCUs

160-198
familyflavor
`sams70``sams70j19`, `sams70j20`, `sams70j21`, `sams70n19`, `sams70n20`, `sams70n21`, `sams70q19`, `sams70q20`, `sams70q21`
`samv70``samv70j19`, `samv70j20`, `samv70n19`, `samv70n20`, `samv70q19`, `samv70q20`
`samv71``samv71j19`, `samv71j20`, `samv71j21`, `samv71n19`, `samv71n20`, `samv71n21`, `samv71q19`, `samv71q20`, `samv71q21`

세 Cortex-M7 MCU family는 공통 E70/S70/V70/V71 datasheet를 참조합니다.

Linux kernel information

199-204

Linux kernel machine directory는 `arch/arm/mach-at91`입니다. `MAINTAINERS` entry 이름은 `ARM/Microchip (AT91) SoC support`입니다.

Device Tree for AT91 SoCs and boards

205-230

모든 AT91 SoC는 Device Tree로 전환되었습니다. Linux 3.19부터 이 제품들은 Device Tree 방식으로 kernel을 boot해야 합니다.

AT91 SoC와 board에 적용되는 Device Tree file과 binding은 이 문서 시점에 `Unstable`입니다. `at91` binding은 언제든 바뀔 수 있으므로 DTB와 kernel image를 반드시 같은 source tree에서 생성해야 합니다.

`Stable` binding/ABI의 정의는 `Documentation/devicetree/bindings/ABI.rst`를 참고합니다. 적절한 시점에 AT91 maintainer가 이 work-in-progress 문구를 제거합니다.

  • SoC `.dtsi`는 `at91sam9g20.dtsi`, `sama5d33.dtsi`처럼 공식 제품명으로 이름 붙입니다.
  • 공통 node는 `sama5d3.dtsi`, `at91sam9x5cm.dtsi` 같은 `.dtsi`에 모읍니다. 특정 peripheral이나 topic을 모으면 `_` 뒤에 식별자를 붙여 `at91sam9x5_can.dtsi`, `sama5d3_gmac.dtsi`처럼 만듭니다.
  • board `.dts`는 쉽게 식별하도록 `at91-` prefix를 붙입니다.
  • 역사적 예외는 `sama5d3[13456]ek.dts`, `usb_a9g20.dts`, `animeo_ip.dts`입니다.