| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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 |