/[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.16 - (hide annotations) (download) (as text)
Sat Mar 16 18:58:17 2013 UTC (5 years, 5 months ago) by swift
Branch: MAIN
Changes since 1.15: +3 -26 lines
File MIME type: application/xml
Fix bug #460852 - Move timezone information to the "Installing the Gentoo Base System" chapter

1 vapier 1.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 swift 1.16 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-arm-kernel.xml,v 1.15 2012/02/22 21:27:45 swift Exp $ -->
8 vapier 1.1
9     <sections>
10    
11 swift 1.16 <version>11</version>
12     <date>2013-03-16</date>
13 vapier 1.1
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 nightmorph 1.3 For ARM systems, we will use <c>gentoo-sources</c> (contains additional patches
30 neysx 1.12 for extra features).
31 vapier 1.1 </p>
32    
33     <p>
34 nightmorph 1.3 Now install it using <c>emerge</c>.
35 vapier 1.1 </p>
36    
37     <pre caption="Installing a kernel source">
38 nightmorph 1.3 # <i>emerge gentoo-sources</i>
39 vapier 1.1 </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>Default: 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 vapier 1.2 <pre caption="NetWinder configuration options">
133     <comment>First generate a default config</comment>
134     # <i>make netwinder_defconfig</i>
135 vapier 1.1
136     <comment>Required options</comment>
137     System Type ---&gt;
138 vapier 1.2 ARM system type (FootBridge) ---&gt;
139     (X) FootBridge
140 vapier 1.1 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 nightmorph 1.4
247 vapier 1.1 <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 nightmorph 1.14
268 vapier 1.1 <subsection>
269 nightmorph 1.14 <include href="hb-install-kernelmodules.xml"/>
270     </subsection>
271 vapier 1.1
272     </section>
273     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20