aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/arm/SA1100
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
committerLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
commit1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 (patch)
tree0bba044c4ce775e45a88a51686b5d9f90697ea9d /Documentation/arm/SA1100
Linux-2.6.12-rc2v2.6.12-rc2
Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip!
Diffstat (limited to 'Documentation/arm/SA1100')
-rw-r--r--Documentation/arm/SA1100/ADSBitsy43
-rw-r--r--Documentation/arm/SA1100/Assabet301
-rw-r--r--Documentation/arm/SA1100/Brutus66
-rw-r--r--Documentation/arm/SA1100/CERF29
-rw-r--r--Documentation/arm/SA1100/FreeBird21
-rw-r--r--Documentation/arm/SA1100/GraphicsClient98
-rw-r--r--Documentation/arm/SA1100/GraphicsMaster53
-rw-r--r--Documentation/arm/SA1100/HUW_WEBPANEL17
-rw-r--r--Documentation/arm/SA1100/Itsy39
-rw-r--r--Documentation/arm/SA1100/LART14
-rw-r--r--Documentation/arm/SA1100/PLEB11
-rw-r--r--Documentation/arm/SA1100/Pangolin23
-rw-r--r--Documentation/arm/SA1100/Tifon7
-rw-r--r--Documentation/arm/SA1100/Victor16
-rw-r--r--Documentation/arm/SA1100/Yopy2
-rw-r--r--Documentation/arm/SA1100/empeg2
-rw-r--r--Documentation/arm/SA1100/nanoEngine11
-rw-r--r--Documentation/arm/SA1100/serial_UART47
18 files changed, 800 insertions, 0 deletions
diff --git a/Documentation/arm/SA1100/ADSBitsy b/Documentation/arm/SA1100/ADSBitsy
new file mode 100644
index 000000000000..ab47c3833908
--- /dev/null
+++ b/Documentation/arm/SA1100/ADSBitsy
@@ -0,0 +1,43 @@
1ADS Bitsy Single Board Computer
2(It is different from Bitsy(iPAQ) of Compaq)
3
4For more details, contact Applied Data Systems or see
5http://www.applieddata.net/products.html
6
7The Linux support for this product has been provided by
8Woojung Huh <whuh@applieddata.net>
9
10Use 'make adsbitsy_config' before any 'make config'.
11This will set up defaults for ADS Bitsy support.
12
13The kernel zImage is linked to be loaded and executed at 0xc0400000.
14
15Linux can be used with the ADS BootLoader that ships with the
16newer rev boards. See their documentation on how to load Linux.
17
18Supported peripherals:
19- SA1100 LCD frame buffer (8/16bpp...sort of)
20- SA1111 USB Master
21- SA1100 serial port
22- pcmcia, compact flash
23- touchscreen(ucb1200)
24- console on LCD screen
25- serial ports (ttyS[0-2])
26 - ttyS0 is default for serial console
27
28To do:
29- everything else! :-)
30
31Notes:
32
33- The flash on board is divided into 3 partitions.
34 You should be careful to use flash on board.
35 It's partition is different from GraphicsClient Plus and GraphicsMaster
36
37- 16bpp mode requires a different cable than what ships with the board.
38 Contact ADS or look through the manual to wire your own. Currently,
39 if you compile with 16bit mode support and switch into a lower bpp
40 mode, the timing is off so the image is corrupted. This will be
41 fixed soon.
42
43Any contribution can be sent to nico@cam.org and will be greatly welcome!
diff --git a/Documentation/arm/SA1100/Assabet b/Documentation/arm/SA1100/Assabet
new file mode 100644
index 000000000000..cbbe5587c78d
--- /dev/null
+++ b/Documentation/arm/SA1100/Assabet
@@ -0,0 +1,301 @@
1The Intel Assabet (SA-1110 evaluation) board
2============================================
3
4Please see:
5http://developer.intel.com/design/strong/quicklist/eval-plat/sa-1110.htm
6http://developer.intel.com/design/strong/guides/278278.htm
7
8Also some notes from John G Dorsey <jd5q@andrew.cmu.edu>:
9http://www.cs.cmu.edu/~wearable/software/assabet.html
10
11
12Building the kernel
13-------------------
14
15To build the kernel with current defaults:
16
17 make assabet_config
18 make oldconfig
19 make zImage
20
21The resulting kernel image should be available in linux/arch/arm/boot/zImage.
22
23
24Installing a bootloader
25-----------------------
26
27A couple of bootloaders able to boot Linux on Assabet are available:
28
29BLOB (http://www.lart.tudelft.nl/lartware/blob/)
30
31 BLOB is a bootloader used within the LART project. Some contributed
32 patches were merged into BLOB to add support for Assabet.
33
34Compaq's Bootldr + John Dorsey's patch for Assabet support
35(http://www.handhelds.org/Compaq/bootldr.html)
36(http://www.wearablegroup.org/software/bootldr/)
37
38 Bootldr is the bootloader developed by Compaq for the iPAQ Pocket PC.
39 John Dorsey has produced add-on patches to add support for Assabet and
40 the JFFS filesystem.
41
42RedBoot (http://sources.redhat.com/redboot/)
43
44 RedBoot is a bootloader developed by Red Hat based on the eCos RTOS
45 hardware abstraction layer. It supports Assabet amongst many other
46 hardware platforms.
47
48RedBoot is currently the recommended choice since it's the only one to have
49networking support, and is the most actively maintained.
50
51Brief examples on how to boot Linux with RedBoot are shown below. But first
52you need to have RedBoot installed in your flash memory. A known to work
53precompiled RedBoot binary is available from the following location:
54
55ftp://ftp.netwinder.org/users/n/nico/
56ftp://ftp.arm.linux.org.uk/pub/linux/arm/people/nico/
57ftp://ftp.handhelds.org/pub/linux/arm/sa-1100-patches/
58
59Look for redboot-assabet*.tgz. Some installation infos are provided in
60redboot-assabet*.txt.
61
62
63Initial RedBoot configuration
64-----------------------------
65
66The commands used here are explained in The RedBoot User's Guide available
67on-line at http://sources.redhat.com/ecos/docs-latest/redboot/redboot.html.
68Please refer to it for explanations.
69
70If you have a CF network card (my Assabet kit contained a CF+ LP-E from
71Socket Communications Inc.), you should strongly consider using it for TFTP
72file transfers. You must insert it before RedBoot runs since it can't detect
73it dynamically.
74
75To initialize the flash directory:
76
77 fis init -f
78
79To initialize the non-volatile settings, like whether you want to use BOOTP or
80a static IP address, etc, use this command:
81
82 fconfig -i
83
84
85Writing a kernel image into flash
86---------------------------------
87
88First, the kernel image must be loaded into RAM. If you have the zImage file
89available on a TFTP server:
90
91 load zImage -r -b 0x100000
92
93If you rather want to use Y-Modem upload over the serial port:
94
95 load -m ymodem -r -b 0x100000
96
97To write it to flash:
98
99 fis create "Linux kernel" -b 0x100000 -l 0xc0000
100
101
102Booting the kernel
103------------------
104
105The kernel still requires a filesystem to boot. A ramdisk image can be loaded
106as follows:
107
108 load ramdisk_image.gz -r -b 0x800000
109
110Again, Y-Modem upload can be used instead of TFTP by replacing the file name
111by '-y ymodem'.
112
113Now the kernel can be retrieved from flash like this:
114
115 fis load "Linux kernel"
116
117or loaded as described previously. To boot the kernel:
118
119 exec -b 0x100000 -l 0xc0000
120
121The ramdisk image could be stored into flash as well, but there are better
122solutions for on-flash filesystems as mentioned below.
123
124
125Using JFFS2
126-----------
127
128Using JFFS2 (the Second Journalling Flash File System) is probably the most
129convenient way to store a writable filesystem into flash. JFFS2 is used in
130conjunction with the MTD layer which is responsible for low-level flash
131management. More information on the Linux MTD can be found on-line at:
132http://www.linux-mtd.infradead.org/. A JFFS howto with some infos about
133creating JFFS/JFFS2 images is available from the same site.
134
135For instance, a sample JFFS2 image can be retrieved from the same FTP sites
136mentioned below for the precompiled RedBoot image.
137
138To load this file:
139
140 load sample_img.jffs2 -r -b 0x100000
141
142The result should look like:
143
144RedBoot> load sample_img.jffs2 -r -b 0x100000
145Raw file loaded 0x00100000-0x00377424
146
147Now we must know the size of the unallocated flash:
148
149 fis free
150
151Result:
152
153RedBoot> fis free
154 0x500E0000 .. 0x503C0000
155
156The values above may be different depending on the size of the filesystem and
157the type of flash. See their usage below as an example and take care of
158substituting yours appropriately.
159
160We must determine some values:
161
162size of unallocated flash: 0x503c0000 - 0x500e0000 = 0x2e0000
163size of the filesystem image: 0x00377424 - 0x00100000 = 0x277424
164
165We want to fit the filesystem image of course, but we also want to give it all
166the remaining flash space as well. To write it:
167
168 fis unlock -f 0x500E0000 -l 0x2e0000
169 fis erase -f 0x500E0000 -l 0x2e0000
170 fis write -b 0x100000 -l 0x277424 -f 0x500E0000
171 fis create "JFFS2" -n -f 0x500E0000 -l 0x2e0000
172
173Now the filesystem is associated to a MTD "partition" once Linux has discovered
174what they are in the boot process. From Redboot, the 'fis list' command
175displays them:
176
177RedBoot> fis list
178Name FLASH addr Mem addr Length Entry point
179RedBoot 0x50000000 0x50000000 0x00020000 0x00000000
180RedBoot config 0x503C0000 0x503C0000 0x00020000 0x00000000
181FIS directory 0x503E0000 0x503E0000 0x00020000 0x00000000
182Linux kernel 0x50020000 0x00100000 0x000C0000 0x00000000
183JFFS2 0x500E0000 0x500E0000 0x002E0000 0x00000000
184
185However Linux should display something like:
186
187SA1100 flash: probing 32-bit flash bus
188SA1100 flash: Found 2 x16 devices at 0x0 in 32-bit mode
189Using RedBoot partition definition
190Creating 5 MTD partitions on "SA1100 flash":
1910x00000000-0x00020000 : "RedBoot"
1920x00020000-0x000e0000 : "Linux kernel"
1930x000e0000-0x003c0000 : "JFFS2"
1940x003c0000-0x003e0000 : "RedBoot config"
1950x003e0000-0x00400000 : "FIS directory"
196
197What's important here is the position of the partition we are interested in,
198which is the third one. Within Linux, this correspond to /dev/mtdblock2.
199Therefore to boot Linux with the kernel and its root filesystem in flash, we
200need this RedBoot command:
201
202 fis load "Linux kernel"
203 exec -b 0x100000 -l 0xc0000 -c "root=/dev/mtdblock2"
204
205Of course other filesystems than JFFS might be used, like cramfs for example.
206You might want to boot with a root filesystem over NFS, etc. It is also
207possible, and sometimes more convenient, to flash a filesystem directly from
208within Linux while booted from a ramdisk or NFS. The Linux MTD repository has
209many tools to deal with flash memory as well, to erase it for example. JFFS2
210can then be mounted directly on a freshly erased partition and files can be
211copied over directly. Etc...
212
213
214RedBoot scripting
215-----------------
216
217All the commands above aren't so useful if they have to be typed in every
218time the Assabet is rebooted. Therefore it's possible to automatize the boot
219process using RedBoot's scripting capability.
220
221For example, I use this to boot Linux with both the kernel and the ramdisk
222images retrieved from a TFTP server on the network:
223
224RedBoot> fconfig
225Run script at boot: false true
226Boot script:
227Enter script, terminate with empty line
228>> load zImage -r -b 0x100000
229>> load ramdisk_ks.gz -r -b 0x800000
230>> exec -b 0x100000 -l 0xc0000
231>>
232Boot script timeout (1000ms resolution): 3
233Use BOOTP for network configuration: true
234GDB connection port: 9000
235Network debug at boot time: false
236Update RedBoot non-volatile configuration - are you sure (y/n)? y
237
238Then, rebooting the Assabet is just a matter of waiting for the login prompt.
239
240
241
242Nicolas Pitre
243nico@cam.org
244June 12, 2001
245
246
247Status of peripherals in -rmk tree (updated 14/10/2001)
248-------------------------------------------------------
249
250Assabet:
251 Serial ports:
252 Radio: TX, RX, CTS, DSR, DCD, RI
253 PM: Not tested.
254 COM: TX, RX, CTS, DSR, DCD, RTS, DTR, PM
255 PM: Not tested.
256 I2C: Implemented, not fully tested.
257 L3: Fully tested, pass.
258 PM: Not tested.
259
260 Video:
261 LCD: Fully tested. PM
262 (LCD doesn't like being blanked with
263 neponset connected)
264 Video out: Not fully
265
266 Audio:
267 UDA1341:
268 Playback: Fully tested, pass.
269 Record: Implemented, not tested.
270 PM: Not tested.
271
272 UCB1200:
273 Audio play: Implemented, not heavily tested.
274 Audio rec: Implemented, not heavily tested.
275 Telco audio play: Implemented, not heavily tested.
276 Telco audio rec: Implemented, not heavily tested.
277 POTS control: No
278 Touchscreen: Yes
279 PM: Not tested.
280
281 Other:
282 PCMCIA:
283 LPE: Fully tested, pass.
284 USB: No
285 IRDA:
286 SIR: Fully tested, pass.
287 FIR: Fully tested, pass.
288 PM: Not tested.
289
290Neponset:
291 Serial ports:
292 COM1,2: TX, RX, CTS, DSR, DCD, RTS, DTR
293 PM: Not tested.
294 USB: Implemented, not heavily tested.
295 PCMCIA: Implemented, not heavily tested.
296 PM: Not tested.
297 CF: Implemented, not heavily tested.
298 PM: Not tested.
299
300More stuff can be found in the -np (Nicolas Pitre's) tree.
301
diff --git a/Documentation/arm/SA1100/Brutus b/Documentation/arm/SA1100/Brutus
new file mode 100644
index 000000000000..2254c8f0b326
--- /dev/null
+++ b/Documentation/arm/SA1100/Brutus
@@ -0,0 +1,66 @@
1Brutus is an evaluation platform for the SA1100 manufactured by Intel.
2For more details, see:
3
4http://developer.intel.com/design/strong/applnots/sa1100lx/getstart.htm
5
6To compile for Brutus, you must issue the following commands:
7
8 make brutus_config
9 make config
10 [accept all the defaults]
11 make zImage
12
13The resulting kernel will end up in linux/arch/arm/boot/zImage. This file
14must be loaded at 0xc0008000 in Brutus's memory and execution started at
150xc0008000 as well with the value of registers r0 = 0 and r1 = 16 upon
16entry.
17
18But prior to execute the kernel, a ramdisk image must also be loaded in
19memory. Use memory address 0xd8000000 for this. Note that the file
20containing the (compressed) ramdisk image must not exceed 4 MB.
21
22Typically, you'll need angelboot to load the kernel.
23The following angelboot.opt file should be used:
24
25----- begin angelboot.opt -----
26base 0xc0008000
27entry 0xc0008000
28r0 0x00000000
29r1 0x00000010
30device /dev/ttyS0
31options "9600 8N1"
32baud 115200
33otherfile ramdisk_img.gz
34otherbase 0xd8000000
35----- end angelboot.opt -----
36
37Then load the kernel and ramdisk with:
38
39 angelboot -f angelboot.opt zImage
40
41The first Brutus serial port (assumed to be linked to /dev/ttyS0 on your
42host PC) is used by angel to load the kernel and ramdisk image. The serial
43console is provided through the second Brutus serial port. To access it,
44you may use minicom configured with /dev/ttyS1, 9600 baud, 8N1, no flow
45control.
46
47Currently supported:
48 - RS232 serial ports
49 - audio output
50 - LCD screen
51 - keyboard
52
53The actual Brutus support may not be complete without extra patches.
54If such patches exist, they should be found from
55ftp.netwinder.org/users/n/nico.
56
57A full PCMCIA support is still missing, although it's possible to hack
58some drivers in order to drive already inserted cards at boot time with
59little modifications.
60
61Any contribution is welcome.
62
63Please send patches to nico@cam.org
64
65Have Fun !
66
diff --git a/Documentation/arm/SA1100/CERF b/Documentation/arm/SA1100/CERF
new file mode 100644
index 000000000000..b3d845301ef1
--- /dev/null
+++ b/Documentation/arm/SA1100/CERF
@@ -0,0 +1,29 @@
1*** The StrongARM version of the CerfBoard/Cube has been discontinued ***
2
3The Intrinsyc CerfBoard is a StrongARM 1110-based computer on a board
4that measures approximately 2" square. It includes an Ethernet
5controller, an RS232-compatible serial port, a USB function port, and
6one CompactFlash+ slot on the back. Pictures can be found at the
7Intrinsyc website, http://www.intrinsyc.com.
8
9This document describes the support in the Linux kernel for the
10Intrinsyc CerfBoard.
11
12Supported in this version:
13 - CompactFlash+ slot (select PCMCIA in General Setup and any options
14 that may be required)
15 - Onboard Crystal CS8900 Ethernet controller (Cerf CS8900A support in
16 Network Devices)
17 - Serial ports with a serial console (hardcoded to 38400 8N1)
18
19In order to get this kernel onto your Cerf, you need a server that runs
20both BOOTP and TFTP. Detailed instructions should have come with your
21evaluation kit on how to use the bootloader. This series of commands
22will suffice:
23
24 make ARCH=arm CROSS_COMPILE=arm-linux- cerfcube_defconfig
25 make ARCH=arm CROSS_COMPILE=arm-linux- zImage
26 make ARCH=arm CROSS_COMPILE=arm-linux- modules
27 cp arch/arm/boot/zImage <TFTP directory>
28
29support@intrinsyc.com
diff --git a/Documentation/arm/SA1100/FreeBird b/Documentation/arm/SA1100/FreeBird
new file mode 100644
index 000000000000..eda28b3232e7
--- /dev/null
+++ b/Documentation/arm/SA1100/FreeBird
@@ -0,0 +1,21 @@
1Freebird-1.1 is produced by Legned(C) ,Inc.
2(http://www.legend.com.cn)
3and software/linux mainatined by Coventive(C),Inc.
4(http://www.coventive.com)
5
6Based on the Nicolas's strongarm kernel tree.
7
8===============================================================
9Maintainer:
10
11Chester Kuo <chester@coventive.com>
12 <chester@linux.org.tw>
13
14Author :
15Tim wu <timwu@coventive.com>
16CIH <cih@coventive.com>
17Eric Peng <ericpeng@coventive.com>
18Jeff Lee <jeff_lee@coventive.com>
19Allen Cheng
20Tony Liu <tonyliu@coventive.com>
21
diff --git a/Documentation/arm/SA1100/GraphicsClient b/Documentation/arm/SA1100/GraphicsClient
new file mode 100644
index 000000000000..8fa7e8027ff1
--- /dev/null
+++ b/Documentation/arm/SA1100/GraphicsClient
@@ -0,0 +1,98 @@
1ADS GraphicsClient Plus Single Board Computer
2
3For more details, contact Applied Data Systems or see
4http://www.applieddata.net/products.html
5
6The original Linux support for this product has been provided by
7Nicolas Pitre <nico@cam.org>. Continued development work by
8Woojung Huh <whuh@applieddata.net>
9
10It's currently possible to mount a root filesystem via NFS providing a
11complete Linux environment. Otherwise a ramdisk image may be used. The
12board supports MTD/JFFS, so you could also mount something on there.
13
14Use 'make graphicsclient_config' before any 'make config'. This will set up
15defaults for GraphicsClient Plus support.
16
17The kernel zImage is linked to be loaded and executed at 0xc0200000.
18Also the following registers should have the specified values upon entry:
19
20 r0 = 0
21 r1 = 29 (this is the GraphicsClient architecture number)
22
23Linux can be used with the ADS BootLoader that ships with the
24newer rev boards. See their documentation on how to load Linux.
25Angel is not available for the GraphicsClient Plus AFAIK.
26
27There is a board known as just the GraphicsClient that ADS used to
28produce but has end of lifed. This code will not work on the older
29board with the ADS bootloader, but should still work with Angel,
30as outlined below. In any case, if you're planning on deploying
31something en masse, you should probably get the newer board.
32
33If using Angel on the older boards, here is a typical angel.opt option file
34if the kernel is loaded through the Angel Debug Monitor:
35
36----- begin angelboot.opt -----
37base 0xc0200000
38entry 0xc0200000
39r0 0x00000000
40r1 0x0000001d
41device /dev/ttyS1
42options "38400 8N1"
43baud 115200
44#otherfile ramdisk.gz
45#otherbase 0xc0800000
46exec minicom
47----- end angelboot.opt -----
48
49Then the kernel (and ramdisk if otherfile/otherbase lines above are
50uncommented) would be loaded with:
51
52 angelboot -f angelboot.opt zImage
53
54Here it is assumed that the board is connected to ttyS1 on your PC
55and that minicom is preconfigured with /dev/ttyS1, 38400 baud, 8N1, no flow
56control by default.
57
58If any other bootloader is used, ensure it accomplish the same, especially
59for r0/r1 register values before jumping into the kernel.
60
61
62Supported peripherals:
63- SA1100 LCD frame buffer (8/16bpp...sort of)
64- on-board SMC 92C96 ethernet NIC
65- SA1100 serial port
66- flash memory access (MTD/JFFS)
67- pcmcia
68- touchscreen(ucb1200)
69- ps/2 keyboard
70- console on LCD screen
71- serial ports (ttyS[0-2])
72 - ttyS0 is default for serial console
73- Smart I/O (ADC, keypad, digital inputs, etc)
74 See http://www.applieddata.com/developers/linux for IOCTL documentation
75 and example user space code. ps/2 keybd is multiplexed through this driver
76
77To do:
78- UCB1200 audio with new ucb_generic layer
79- everything else! :-)
80
81Notes:
82
83- The flash on board is divided into 3 partitions. mtd0 is where
84 the ADS boot ROM and zImage is stored. It's been marked as
85 read-only to keep you from blasting over the bootloader. :) mtd1 is
86 for the ramdisk.gz image. mtd2 is user flash space and can be
87 utilized for either JFFS or if you're feeling crazy, running ext2
88 on top of it. If you're not using the ADS bootloader, you're
89 welcome to blast over the mtd1 partition also.
90
91- 16bpp mode requires a different cable than what ships with the board.
92 Contact ADS or look through the manual to wire your own. Currently,
93 if you compile with 16bit mode support and switch into a lower bpp
94 mode, the timing is off so the image is corrupted. This will be
95 fixed soon.
96
97Any contribution can be sent to nico@cam.org and will be greatly welcome!
98
diff --git a/Documentation/arm/SA1100/GraphicsMaster b/Documentation/arm/SA1100/GraphicsMaster
new file mode 100644
index 000000000000..dd28745ac521
--- /dev/null
+++ b/Documentation/arm/SA1100/GraphicsMaster
@@ -0,0 +1,53 @@
1ADS GraphicsMaster Single Board Computer
2
3For more details, contact Applied Data Systems or see
4http://www.applieddata.net/products.html
5
6The original Linux support for this product has been provided by
7Nicolas Pitre <nico@cam.org>. Continued development work by
8Woojung Huh <whuh@applieddata.net>
9
10Use 'make graphicsmaster_config' before any 'make config'.
11This will set up defaults for GraphicsMaster support.
12
13The kernel zImage is linked to be loaded and executed at 0xc0400000.
14
15Linux can be used with the ADS BootLoader that ships with the
16newer rev boards. See their documentation on how to load Linux.
17
18Supported peripherals:
19- SA1100 LCD frame buffer (8/16bpp...sort of)
20- SA1111 USB Master
21- on-board SMC 92C96 ethernet NIC
22- SA1100 serial port
23- flash memory access (MTD/JFFS)
24- pcmcia, compact flash
25- touchscreen(ucb1200)
26- ps/2 keyboard
27- console on LCD screen
28- serial ports (ttyS[0-2])
29 - ttyS0 is default for serial console
30- Smart I/O (ADC, keypad, digital inputs, etc)
31 See http://www.applieddata.com/developers/linux for IOCTL documentation
32 and example user space code. ps/2 keybd is multiplexed through this driver
33
34To do:
35- everything else! :-)
36
37Notes:
38
39- The flash on board is divided into 3 partitions. mtd0 is where
40 the zImage is stored. It's been marked as read-only to keep you
41 from blasting over the bootloader. :) mtd1 is
42 for the ramdisk.gz image. mtd2 is user flash space and can be
43 utilized for either JFFS or if you're feeling crazy, running ext2
44 on top of it. If you're not using the ADS bootloader, you're
45 welcome to blast over the mtd1 partition also.
46
47- 16bpp mode requires a different cable than what ships with the board.
48 Contact ADS or look through the manual to wire your own. Currently,
49 if you compile with 16bit mode support and switch into a lower bpp
50 mode, the timing is off so the image is corrupted. This will be
51 fixed soon.
52
53Any contribution can be sent to nico@cam.org and will be greatly welcome!
diff --git a/Documentation/arm/SA1100/HUW_WEBPANEL b/Documentation/arm/SA1100/HUW_WEBPANEL
new file mode 100644
index 000000000000..fd56b48d4833
--- /dev/null
+++ b/Documentation/arm/SA1100/HUW_WEBPANEL
@@ -0,0 +1,17 @@
1The HUW_WEBPANEL is a product of the german company Hoeft & Wessel AG
2
3If you want more information, please visit
4http://www.hoeft-wessel.de
5
6To build the kernel:
7 make huw_webpanel_config
8 make oldconfig
9 [accept all defaults]
10 make zImage
11
12Mostly of the work is done by:
13Roman Jordan jor@hoeft-wessel.de
14Christoph Schulz schu@hoeft-wessel.de
15
162000/12/18/
17
diff --git a/Documentation/arm/SA1100/Itsy b/Documentation/arm/SA1100/Itsy
new file mode 100644
index 000000000000..3b594534323b
--- /dev/null
+++ b/Documentation/arm/SA1100/Itsy
@@ -0,0 +1,39 @@
1Itsy is a research project done by the Western Research Lab, and Systems
2Research Center in Palo Alto, CA. The Itsy project is one of several
3research projects at Compaq that are related to pocket computing.
4
5For more information, see:
6
7 http://www.research.digital.com/wrl/itsy/index.html
8
9Notes on initial 2.4 Itsy support (8/27/2000) :
10The port was done on an Itsy version 1.5 machine with a daughtercard with
1164 Meg of DRAM and 32 Meg of Flash. The initial work includes support for
12serial console (to see what you're doing). No other devices have been
13enabled.
14
15To build, do a "make menuconfig" (or xmenuconfig) and select Itsy support.
16Disable Flash and LCD support. and then do a make zImage.
17Finally, you will need to cd to arch/arm/boot/tools and execute a make there
18to build the params-itsy program used to boot the kernel.
19
20In order to install the port of 2.4 to the itsy, You will need to set the
21configuration parameters in the monitor as follows:
22Arg 1:0x08340000, Arg2: 0xC0000000, Arg3:18 (0x12), Arg4:0
23Make sure the start-routine address is set to 0x00060000.
24
25Next, flash the params-itsy program to 0x00060000 ("p 1 0x00060000" in the
26flash menu) Flash the kernel in arch/arm/boot/zImage into 0x08340000
27("p 1 0x00340000"). Finally flash an initial ramdisk into 0xC8000000
28("p 2 0x0") We used ramdisk-2-30.gz from the 0.11 version directory on
29handhelds.org.
30
31The serial connection we established was at:
32 8-bit data, no parity, 1 stop bit(s), 115200.00 b/s. in the monitor, in the
33params-itsy program, and in the kernel itself. This can be changed, but
34not easily. The monitor parameters are easily changed, the params program
35setup is assembly outl's, and the kernel is a configuration item specific to
36the itsy. (i.e. grep for CONFIG_SA1100_ITSY and you'll find where it is.)
37
38
39This should get you a properly booting 2.4 kernel on the itsy.
diff --git a/Documentation/arm/SA1100/LART b/Documentation/arm/SA1100/LART
new file mode 100644
index 000000000000..2f73f513e16a
--- /dev/null
+++ b/Documentation/arm/SA1100/LART
@@ -0,0 +1,14 @@
1Linux Advanced Radio Terminal (LART)
2------------------------------------
3
4The LART is a small (7.5 x 10cm) SA-1100 board, designed for embedded
5applications. It has 32 MB DRAM, 4MB Flash ROM, double RS232 and all
6other StrongARM-gadgets. Almost all SA signals are directly accessible
7through a number of connectors. The powersupply accepts voltages
8between 3.5V and 16V and is overdimensioned to support a range of
9daughterboards. A quad Ethernet / IDE / PS2 / sound daughterboard
10is under development, with plenty of others in different stages of
11planning.
12
13The hardware designs for this board have been released under an open license;
14see the LART page at http://www.lart.tudelft.nl/ for more information.
diff --git a/Documentation/arm/SA1100/PLEB b/Documentation/arm/SA1100/PLEB
new file mode 100644
index 000000000000..92cae066908d
--- /dev/null
+++ b/Documentation/arm/SA1100/PLEB
@@ -0,0 +1,11 @@
1The PLEB project was started as a student initiative at the School of
2Computer Science and Engineering, University of New South Wales to make a
3pocket computer capable of running the Linux Kernel.
4
5PLEB support has yet to be fully integrated.
6
7For more information, see:
8
9 http://www.cse.unsw.edu.au/~pleb/
10
11
diff --git a/Documentation/arm/SA1100/Pangolin b/Documentation/arm/SA1100/Pangolin
new file mode 100644
index 000000000000..077a6120e129
--- /dev/null
+++ b/Documentation/arm/SA1100/Pangolin
@@ -0,0 +1,23 @@
1Pangolin is a StrongARM 1110-based evaluation platform produced
2by Dialogue Technology (http://www.dialogue.com.tw/).
3It has EISA slots for ease of configuration with SDRAM/Flash
4memory card, USB/Serial/Audio card, Compact Flash card,
5PCMCIA/IDE card and TFT-LCD card.
6
7To compile for Pangolin, you must issue the following commands:
8
9 make pangolin_config
10 make oldconfig
11 make zImage
12
13Supported peripherals:
14- SA1110 serial port (UART1/UART2/UART3)
15- flash memory access
16- compact flash driver
17- UDA1341 sound driver
18- SA1100 LCD controller for 800x600 16bpp TFT-LCD
19- MQ-200 driver for 800x600 16bpp TFT-LCD
20- Penmount(touch panel) driver
21- PCMCIA driver
22- SMC91C94 LAN driver
23- IDE driver (experimental)
diff --git a/Documentation/arm/SA1100/Tifon b/Documentation/arm/SA1100/Tifon
new file mode 100644
index 000000000000..dd1934d9c851
--- /dev/null
+++ b/Documentation/arm/SA1100/Tifon
@@ -0,0 +1,7 @@
1Tifon
2-----
3
4More info has to come...
5
6Contact: Peter Danielsson <peter.danielsson@era-t.ericsson.se>
7
diff --git a/Documentation/arm/SA1100/Victor b/Documentation/arm/SA1100/Victor
new file mode 100644
index 000000000000..01e81fc49461
--- /dev/null
+++ b/Documentation/arm/SA1100/Victor
@@ -0,0 +1,16 @@
1Victor is known as a "digital talking book player" manufactured by
2VisuAide, Inc. to be used by blind people.
3
4For more information related to Victor, see:
5
6 http://www.visuaide.com/victor
7
8Of course Victor is using Linux as its main operating system.
9The Victor implementation for Linux is maintained by Nicolas Pitre:
10
11 nico@visuaide.com
12 nico@cam.org
13
14For any comments, please feel free to contact me through the above
15addresses.
16
diff --git a/Documentation/arm/SA1100/Yopy b/Documentation/arm/SA1100/Yopy
new file mode 100644
index 000000000000..e14f16d836ac
--- /dev/null
+++ b/Documentation/arm/SA1100/Yopy
@@ -0,0 +1,2 @@
1See http://www.yopydeveloper.org for more.
2
diff --git a/Documentation/arm/SA1100/empeg b/Documentation/arm/SA1100/empeg
new file mode 100644
index 000000000000..4ece4849a42c
--- /dev/null
+++ b/Documentation/arm/SA1100/empeg
@@ -0,0 +1,2 @@
1See ../empeg/README
2
diff --git a/Documentation/arm/SA1100/nanoEngine b/Documentation/arm/SA1100/nanoEngine
new file mode 100644
index 000000000000..fc431cbfefc2
--- /dev/null
+++ b/Documentation/arm/SA1100/nanoEngine
@@ -0,0 +1,11 @@
1nanoEngine
2----------
3
4"nanoEngine" is a SA1110 based single board computer from
5Bright Star Engineering Inc. See www.brightstareng.com/arm
6for more info.
7(Ref: Stuart Adams <sja@brightstareng.com>)
8
9Also visit Larry Doolittle's "Linux for the nanoEngine" site:
10http://recycle.lbl.gov/~ldoolitt/bse/
11
diff --git a/Documentation/arm/SA1100/serial_UART b/Documentation/arm/SA1100/serial_UART
new file mode 100644
index 000000000000..aea2e91ca0ef
--- /dev/null
+++ b/Documentation/arm/SA1100/serial_UART
@@ -0,0 +1,47 @@
1The SA1100 serial port had its major/minor numbers officially assigned:
2
3> Date: Sun, 24 Sep 2000 21:40:27 -0700
4> From: H. Peter Anvin <hpa@transmeta.com>
5> To: Nicolas Pitre <nico@CAM.ORG>
6> Cc: Device List Maintainer <device@lanana.org>
7> Subject: Re: device
8>
9> Okay. Note that device numbers 204 and 205 are used for "low density
10> serial devices", so you will have a range of minors on those majors (the
11> tty device layer handles this just fine, so you don't have to worry about
12> doing anything special.)
13>
14> So your assignments are:
15>
16> 204 char Low-density serial ports
17> 5 = /dev/ttySA0 SA1100 builtin serial port 0
18> 6 = /dev/ttySA1 SA1100 builtin serial port 1
19> 7 = /dev/ttySA2 SA1100 builtin serial port 2
20>
21> 205 char Low-density serial ports (alternate device)
22> 5 = /dev/cusa0 Callout device for ttySA0
23> 6 = /dev/cusa1 Callout device for ttySA1
24> 7 = /dev/cusa2 Callout device for ttySA2
25>
26
27If you're not using devfs, you must create those inodes in /dev
28on the root filesystem used by your SA1100-based device:
29
30 mknod ttySA0 c 204 5
31 mknod ttySA1 c 204 6
32 mknod ttySA2 c 204 7
33 mknod cusa0 c 205 5
34 mknod cusa1 c 205 6
35 mknod cusa2 c 205 7
36
37In addition to the creation of the appropriate device nodes above, you
38must ensure your user space applications make use of the correct device
39name. The classic example is the content of the /etc/inittab file where
40you might have a getty process started on ttyS0. In this case:
41
42- replace occurrences of ttyS0 with ttySA0, ttyS1 with ttySA1, etc.
43
44- don't forget to add 'ttySA0', 'console', or the appropriate tty name
45 in /etc/securetty for root to be allowed to login as well.
46
47