Merge tag '4.3-rc-smb3-fixes' of git://git.samba.org/sfrench/cifs-2.6
[sfrench/cifs-2.6.git] / Documentation / arm / sa1100 / brutus.rst
1 ======
2 Brutus
3 ======
4
5 Brutus is an evaluation platform for the SA1100 manufactured by Intel.
6 For more details, see:
7
8 http://developer.intel.com
9
10 To compile for Brutus, you must issue the following commands::
11
12         make brutus_config
13         make config
14         [accept all the defaults]
15         make zImage
16
17 The resulting kernel will end up in linux/arch/arm/boot/zImage.  This file
18 must be loaded at 0xc0008000 in Brutus's memory and execution started at
19 0xc0008000 as well with the value of registers r0 = 0 and r1 = 16 upon
20 entry.
21
22 But prior to execute the kernel, a ramdisk image must also be loaded in
23 memory.  Use memory address 0xd8000000 for this.  Note that the file
24 containing the (compressed) ramdisk image must not exceed 4 MB.
25
26 Typically, you'll need angelboot to load the kernel.
27 The following angelboot.opt file should be used::
28
29         base 0xc0008000
30         entry 0xc0008000
31         r0 0x00000000
32         r1 0x00000010
33         device /dev/ttyS0
34         options "9600 8N1"
35         baud 115200
36         otherfile ramdisk_img.gz
37         otherbase 0xd8000000
38
39 Then load the kernel and ramdisk with::
40
41         angelboot -f angelboot.opt zImage
42
43 The first Brutus serial port (assumed to be linked to /dev/ttyS0 on your
44 host PC) is used by angel to load the kernel and ramdisk image. The serial
45 console is provided through the second Brutus serial port. To access it,
46 you may use minicom configured with /dev/ttyS1, 9600 baud, 8N1, no flow
47 control.
48
49 Currently supported
50 ===================
51
52         - RS232 serial ports
53         - audio output
54         - LCD screen
55         - keyboard
56
57 The actual Brutus support may not be complete without extra patches.
58 If such patches exist, they should be found from
59 ftp.netwinder.org/users/n/nico.
60
61 A full PCMCIA support is still missing, although it's possible to hack
62 some drivers in order to drive already inserted cards at boot time with
63 little modifications.
64
65 Any contribution is welcome.
66
67 Please send patches to nico@fluxnic.net
68
69 Have Fun !