Linux-2.6.12-rc2
[pandora-kernel.git] / Documentation / arm / Samsung-S3C24XX / Overview.txt
1                         S3C24XX ARM Linux Overview
2                         ==========================
3
4
5
6 Introduction
7 ------------
8
9   The Samsung S3C24XX range of ARM9 System-on-Chip CPUs are supported
10   by the 's3c2410' architecture of ARM Linux. Currently the S3C2410 and
11   the S3C2440 are supported CPUs.
12
13
14 Configuration
15 -------------
16
17   A generic S3C2410 configuration is provided, and can be used as the
18   default by `make s3c2410_defconfig`. This configuration has support
19   for all the machines, and the commonly used features on them.
20
21   Certain machines may have their own default configurations as well,
22   please check the machine specific documentation.
23
24
25 Machines
26 --------
27
28   The currently supported machines are as follows:
29
30   Simtec Electronics EB2410ITX (BAST)
31
32     A general purpose development board, see EB2410ITX.txt for further
33     details
34
35   Samsung SMDK2410
36
37     Samsung's own development board, geared for PDA work.
38
39   Samsung/Meritech SMDK2440
40
41     The S3C2440 compatible version of the SMDK2440
42
43   Thorcom VR1000
44
45     Custom embedded board
46
47   HP IPAQ 1940
48
49     Handheld (IPAQ), available in several varieties
50
51   HP iPAQ rx3715
52
53     S3C2440 based IPAQ, with a number of variations depending on
54     features shipped.
55
56   Acer N30
57
58     A S3C2410 based PDA from Acer.  There is a Wiki page at
59     http://handhelds.org/moin/moin.cgi/AcerN30Documentation .
60
61
62 Adding New Machines
63 -------------------
64
65   The archicture has been designed to support as many machines as can
66   be configured for it in one kernel build, and any future additions
67   should keep this in mind before altering items outside of their own
68   machine files.
69
70   Machine definitions should be kept in linux/arch/arm/mach-s3c2410,
71   and there are a number of examples that can be looked at.
72
73   Read the kernel patch submission policies as well as the
74   Documentation/arm directory before submitting patches. The
75   ARM kernel series is managed by Russell King, and has a patch system
76   located at http://www.arm.linux.org.uk/developer/patches/
77   as well as mailing lists that can be found from the same site.
78
79   As a courtesy, please notify <ben-linux@fluff.org> of any new
80   machines or other modifications.
81
82   Any large scale modifications, or new drivers should be discussed
83   on the ARM kernel mailing list (linux-arm-kernel) before being
84   attempted.
85
86
87 NAND
88 ----
89
90   The current kernels now have support for the s3c2410 NAND
91   controller. If there are any problems the latest linux-mtd
92   CVS can be found from http://www.linux-mtd.infradead.org/
93
94
95 Serial
96 ------
97
98   The s3c2410 serial driver provides support for the internal
99   serial ports. These devices appear as /dev/ttySAC0 through 3.
100
101   To create device nodes for these, use the following commands
102
103     mknod ttySAC0 c 204 64
104     mknod ttySAC1 c 204 65
105     mknod ttySAC2 c 204 66
106
107
108 GPIO
109 ----
110
111   The core contains support for manipulating the GPIO, see the
112   documentation in GPIO.txt in the same directory as this file.
113
114
115 Clock Management
116 ----------------
117
118   The core provides the interface defined in the header file
119   include/asm-arm/hardware/clock.h, to allow control over the
120   various clock units
121
122
123 Port Contributors
124 -----------------
125
126   Ben Dooks (BJD)
127   Vincent Sanders
128   Herbert Potzl
129   Arnaud Patard (RTP)
130   Roc Wu
131   Klaus Fetscher
132   Dimitry Andric
133   Shannon Holland
134   Guillaume Gourat (NexVision)
135   Christer Weinigel (wingel) (Acer N30)
136   Lucas Correia Villa Real (S3C2400 port)
137
138
139 Document Changes
140 ----------------
141
142   05 Sep 2004 - BJD - Added Document Changes section
143   05 Sep 2004 - BJD - Added Klaus Fetscher to list of contributors
144   25 Oct 2004 - BJD - Added Dimitry Andric to list of contributors
145   25 Oct 2004 - BJD - Updated the MTD from the 2.6.9 merge
146   21 Jan 2005 - BJD - Added rx3715, added Shannon to contributors
147   10 Feb 2005 - BJD - Added Guillaume Gourat to contributors
148   02 Mar 2005 - BJD - Added SMDK2440 to list of machines
149   06 Mar 2005 - BJD - Added Christer Weinigel
150   08 Mar 2005 - BJD - Added LCVR to list of people, updated introduction
151   08 Mar 2005 - BJD - Added section on adding machines
152
153 Document Author
154 ---------------
155
156 Ben Dooks, (c) 2004-2005 Simtec Electronics