/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-arm-kernel.xml
Gentoo

Contents of /xml/htdocs/doc/en/handbook/hb-install-arm-kernel.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.17 - (show annotations) (download) (as text)
Sun Apr 14 16:54:20 2013 UTC (5 years ago) by swift
Branch: MAIN
Changes since 1.16: +4 -4 lines
File MIME type: application/xml
Fix bug #465902 - Manual configuration is the only option, not just default

1 <?xml version='1.0' encoding='UTF-8'?>
2 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3
4 <!-- The content of this document is licensed under the CC-BY-SA license -->
5 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6
7 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-arm-kernel.xml,v 1.16 2013/03/16 18:58:17 swift Exp $ -->
8
9 <sections>
10
11 <version>12</version>
12 <date>2013-04-14</date>
13
14 <section>
15 <title>Installing the Sources</title>
16 <subsection>
17 <title>Choosing a Kernel</title>
18 <body>
19
20 <p>
21 The core around which all distributions are built is the Linux kernel. It is the
22 layer between the user programs and your system hardware. Gentoo provides its
23 users several possible kernel sources. A full listing with description is
24 available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
25 Guide</uri>.
26 </p>
27
28 <p>
29 For ARM systems, we will use <c>gentoo-sources</c> (contains additional patches
30 for extra features).
31 </p>
32
33 <p>
34 Now install it using <c>emerge</c>.
35 </p>
36
37 <pre caption="Installing a kernel source">
38 # <i>emerge gentoo-sources</i>
39 </pre>
40
41 <p>
42 When you take a look in <path>/usr/src</path> you should see a symlink called
43 <path>linux</path> pointing to your kernel source. In this case, the installed
44 kernel source points to <c>gentoo-sources-<keyval id="kernel-version"/></c>.
45 Your version may be different, so keep this in mind.
46 </p>
47
48 <pre caption="Viewing the kernel source symlink">
49 # <i>ls -l /usr/src/linux</i>
50 lrwxrwxrwx 1 root root 12 Oct 13 11:04 /usr/src/linux -&gt; linux-<keyval id="kernel-version"/>
51 </pre>
52
53 </body>
54 </subsection>
55 </section>
56 <section id="manual">
57 <title>Manual Configuration</title>
58 <subsection>
59 <title>Introduction</title>
60 <body>
61
62 <p>
63 Manually configuring a kernel is often seen as the most difficult procedure a
64 Linux user ever has to perform. Nothing is less true -- after configuring a
65 couple of kernels you don't even remember that it was difficult ;)
66 </p>
67
68 <p>
69 However, one thing <e>is</e> true: you must know your system when you start
70 configuring a kernel manually. Most information can be gathered by emerging
71 pciutils (<c>emerge pciutils</c>) which contains <c>lspci</c>. You will now
72 be able to use <c>lspci</c> within the chrooted environment. You may safely
73 ignore any <e>pcilib</e> warnings (like pcilib: cannot open
74 /sys/bus/pci/devices) that <c>lspci</c> throws out. Alternatively, you can run
75 <c>lspci</c> from a <e>non-chrooted</e> environment. The results are the same.
76 You can also run <c>lsmod</c> to see what kernel modules the Installation CD
77 uses (it might provide you with a nice hint on what to enable).
78 </p>
79
80 <p>
81 Now go to your kernel source directory and execute <c>make menuconfig</c>. This
82 will fire up an ncurses-based configuration menu.
83 </p>
84
85 <pre caption="Invoking menuconfig">
86 # <i>cd /usr/src/linux</i>
87 # <i>make menuconfig</i>
88 </pre>
89
90 <p>
91 You will be greeted with several configuration sections. We'll first list some
92 options you must activate (otherwise Gentoo will not function, or not function
93 properly without additional tweaks).
94 </p>
95
96 </body>
97 </subsection>
98 <subsection>
99 <title>Activating Required Options</title>
100 <body>
101
102 <p>
103 Due to the highly specific nature of the embedded, we'll cover known
104 configurations for boards here. If your machine is not listed, then you should
105 visit the respective community website to figure out how to properly configure
106 your kernel.
107 </p>
108
109 <p>
110 Please select your machine from the list below to jump to the configuration
111 section.
112 </p>
113
114 <ul>
115 <li><uri link="#netwinder">NetWinder</uri></li>
116 </ul>
117
118 </body>
119 </subsection>
120 </section>
121 <section id="netwinder">
122 <title>NetWinder configuration options</title>
123 <body>
124
125 <p>
126 Remember that EXT2 support is required for the boot partition as that is the
127 only filesystem that the bootloader can read reliably. Otherwise, the only
128 filesystem that has been tested is EXT3 but your welcome to try your luck with
129 the others ;).
130 </p>
131
132 <pre caption="NetWinder configuration options">
133 <comment>First generate a default config</comment>
134 # <i>make netwinder_defconfig</i>
135
136 <comment>Required options</comment>
137 System Type ---&gt;
138 ARM system type (FootBridge) ---&gt;
139 (X) FootBridge
140 Footbridge Implementations ---&gt;
141 [*] NetWinder
142
143 Floating point emulation ---&gt;
144 [*] NWFPE math emulation
145
146 File systems ---&gt;
147 [*] Second extended fs support
148 Pseudo Filesystems ---&gt;
149 [*] /proc file system support
150 [*] Virtual memory file system support (former shm fs)
151
152 Device Drivers ---&gt;
153 ATA/ATAPI/MFM/RLL support ---&gt;
154 [*] ATA/ATAPI/MFM/RLL support
155 [*] Enhanced IDE/MFM/RLL disk/cdrom/tape/floppy support
156 [*] Include IDE/ATA-2 DISK support
157 --- IDE chipset support/bugfixes
158 [*] PCI IDE chipset support
159 [*] Winbond SL82c105 support
160 [*] Generic PCI bus-master DMA support
161
162 Network device support ---&gt;
163 [*] Network device support
164 Ethernet (10 or 100Mbit) ---&gt;
165 [*] Ethernet (10 or 100Mbit)
166 Tulip family network device support ---&gt;
167 [*] "Tulip" family network device support
168 [*] DECchip Tulip (dc2114x) PCI support
169 [*] Use PCI shared mem for NIC registers
170 [*] Use NAPI RX polling
171 [*] EISA, VLB, PCI and on board controllers
172 [*] PCI NE2000 and clones support
173
174 Character devices ---&gt;
175 Serial drivers ---&gt;
176 [*] 8250/16550 and compatible serial support
177 [*] Console on 8250/16550 and compatible serial port
178 --- Non-8250 serial port support
179 [*] DC21285 serial port support
180 [*] Console on DC21285 serial port
181 Watchdog Cards ---&gt;
182 [*] Watchdog Timer Support
183 [*] NetWinder WB83C977 watchdog
184 [*] NetWinder thermometer support
185 [*] NetWinder Button
186 [*] Reboot Using Button
187
188 <comment>Recommended options</comment>
189 Kernel Features ---&gt;
190 [*] Preemptible Kernel
191 [*] Timer and CPU usage LEDs
192 [*] CPU usage LED
193
194 File systems ---&gt;
195 [*] Ext3 journalling file system support
196
197 Device Drivers ---&gt;
198 Input device support ---&gt;
199 [*] Keyboards ---&gt;
200 [*] AT keyboard
201 [*] Mouse ---&gt;
202 [*] PS/2 mouse
203
204 Graphics support ---&gt;
205 [*] Support for frame buffer devices
206 [*] Enable firmware EDID
207 [*] CyberPro 2000/2010/5000 support
208 Logo configuration ---&gt;
209 [*] Bootup logo
210 [*] Standard 224-color Linux logo
211
212 Sound ---&gt;
213 [*] Sound card support
214 Open Sound System ---&gt;
215 [*] Open Sound System
216 [*] OSS sound modules
217 [*] Yamaha FM synthesizer (YM3812/OPL-3) support
218 [*] Netwinder WaveArtist
219
220 <comment>You should only enable this to upgrade your flash</comment>
221 Device Drivers ---&gt;
222 Character devices ---&gt;
223 [*] NetWinder flash support
224 </pre>
225
226 <p>
227 When you've finished configuring the kernel, continue with <uri
228 link="#compiling">Compiling and Installing</uri>.
229 </p>
230
231 </body>
232 </section>
233 <section id="compiling">
234 <title>Compiling and Installing</title>
235 <body>
236
237 <p>
238 Now that your kernel is configured, it is time to compile and install it. Exit
239 the configuration and start the compilation process:
240 </p>
241
242 <pre caption="Compiling the kernel">
243 # <i>make &amp;&amp; make modules_install</i>
244 </pre>
245
246
247 <p>
248 When the kernel has finished compiling, copy the kernel image to
249 <path>/boot</path>. Use whatever name you feel is appropriate for your kernel
250 choice and remember it as you will need it later on when you configure your
251 bootloader. Remember to replace <c><keyval id="kernel-name"/></c> with the
252 name and version of your kernel.
253 </p>
254
255 <pre caption="Installing the kernel">
256 # <i>cp vmlinux.gz /boot/<keyval id="kernel-name"/></i>
257 </pre>
258
259 <p>
260 Now continue with <uri link="#kernel_modules">Kernel Modules</uri>.
261 </p>
262
263 </body>
264 </section>
265 <section id="kernel_modules">
266 <title>Kernel Modules</title>
267
268 <subsection>
269 <include href="hb-install-kernelmodules.xml"/>
270 </subsection>
271
272 </section>
273 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20