README 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129
  1. ARM Atmel SoCs (aka AT91)
  2. =========================
  3. Introduction
  4. ------------
  5. This document gives useful information about the ARM Atmel SoCs that are
  6. currently supported in Linux Mainline (you know, the one on kernel.org).
  7. It is important to note that the Atmel | SMART ARM-based MPU product line is
  8. historically named "AT91" or "at91" throughout the Linux kernel development
  9. process even if this product prefix has completely disappeared from the
  10. official Atmel product name. Anyway, files, directories, git trees,
  11. git branches/tags and email subject always contain this "at91" sub-string.
  12. AT91 SoCs
  13. ---------
  14. Documentation and detailled datasheet for each product are available on
  15. the Atmel website: http://www.atmel.com.
  16. Flavors:
  17. * ARM 920 based SoC
  18. - at91rm9200
  19. + Datasheet
  20. http://www.atmel.com/Images/doc1768.pdf
  21. * ARM 926 based SoCs
  22. - at91sam9260
  23. + Datasheet
  24. http://www.atmel.com/Images/doc6221.pdf
  25. - at91sam9xe
  26. + Datasheet
  27. http://www.atmel.com/Images/Atmel-6254-32-bit-ARM926EJ-S-Embedded-Microprocessor-SAM9XE_Datasheet.pdf
  28. - at91sam9261
  29. + Datasheet
  30. http://www.atmel.com/Images/doc6062.pdf
  31. - at91sam9263
  32. + Datasheet
  33. http://www.atmel.com/Images/Atmel_6249_32-bit-ARM926EJ-S-Microcontroller_SAM9263_Datasheet.pdf
  34. - at91sam9rl
  35. + Datasheet
  36. http://www.atmel.com/Images/doc6289.pdf
  37. - at91sam9g20
  38. + Datasheet
  39. http://www.atmel.com/Images/doc6384.pdf
  40. - at91sam9g45 family
  41. - at91sam9g45
  42. - at91sam9g46
  43. - at91sam9m10
  44. - at91sam9m11 (device superset)
  45. + Datasheet
  46. http://www.atmel.com/Images/Atmel-6437-32-bit-ARM926-Embedded-Microprocessor-SAM9M11_Datasheet.pdf
  47. - at91sam9x5 family (aka "The 5 series")
  48. - at91sam9g15
  49. - at91sam9g25
  50. - at91sam9g35
  51. - at91sam9x25
  52. - at91sam9x35
  53. + Datasheet (can be considered as covering the whole family)
  54. http://www.atmel.com/Images/Atmel_11055_32-bit-ARM926EJ-S-Microcontroller_SAM9X35_Datasheet.pdf
  55. - at91sam9n12
  56. + Datasheet
  57. http://www.atmel.com/Images/Atmel_11063_32-bit-ARM926EJ-S-Microcontroller_SAM9N12CN11CN12_Datasheet.pdf
  58. * ARM Cortex-A5 based SoCs
  59. - sama5d3 family
  60. - sama5d31
  61. - sama5d33
  62. - sama5d34
  63. - sama5d35
  64. - sama5d36 (device superset)
  65. + Datasheet
  66. http://www.atmel.com/Images/Atmel-11121-32-bit-Cortex-A5-Microcontroller-SAMA5D3_Datasheet.pdf
  67. * ARM Cortex-A5 + NEON based SoCs
  68. - sama5d4 family
  69. - sama5d41
  70. - sama5d42
  71. - sama5d43
  72. - sama5d44 (device superset)
  73. + Datasheet
  74. http://www.atmel.com/Images/Atmel-11238-32-bit-Cortex-A5-Microcontroller-SAMA5D4_Datasheet.pdf
  75. - sama5d2 family
  76. - sama5d27
  77. + Datasheet
  78. Coming soon
  79. Linux kernel information
  80. ------------------------
  81. Linux kernel mach directory: arch/arm/mach-at91
  82. MAINTAINERS entry is: "ARM/ATMEL AT91RM9200 AND AT91SAM ARM ARCHITECTURES"
  83. Device Tree for AT91 SoCs and boards
  84. ------------------------------------
  85. All AT91 SoCs are converted to Device Tree. Since Linux 3.19, these products
  86. must use this method to boot the Linux kernel.
  87. Work In Progress statement:
  88. Device Tree files and Device Tree bindings that apply to AT91 SoCs and boards are
  89. considered as "Unstable". To be completely clear, any at91 binding can change at
  90. any time. So, be sure to use a Device Tree Binary and a Kernel Image generated from
  91. the same source tree.
  92. Please refer to the Documentation/devicetree/bindings/ABI.txt file for a
  93. definition of a "Stable" binding/ABI.
  94. This statement will be removed by AT91 MAINTAINERS when appropriate.
  95. Naming conventions and best practice:
  96. - SoCs Device Tree Source Include files are named after the official name of
  97. the product (at91sam9g20.dtsi or sama5d33.dtsi for instance).
  98. - Device Tree Source Include files (.dtsi) are used to collect common nodes that can be
  99. shared across SoCs or boards (sama5d3.dtsi or at91sam9x5cm.dtsi for instance).
  100. When collecting nodes for a particular peripheral or topic, the identifier have to
  101. be placed at the end of the file name, separated with a "_" (at91sam9x5_can.dtsi
  102. or sama5d3_gmac.dtsi for example).
  103. - board Device Tree Source files (.dts) are prefixed by the string "at91-" so
  104. that they can be identified easily. Note that some files are historical exceptions
  105. to this rule (sama5d3[13456]ek.dts, usb_a9g20.dts or animeo_ip.dts for example).