Custom Linux: A Porting Guide

Porting LinuxPPC to a Custom SBC

Shie Erlich

Rafi Yanai

Avi Rubenbach

Revision History
Revision 2.02002-06-13Revised by: tab
Added GFDL per author
Revision 1.02002-05-13Revised by: SE
Initial release

Table of Contents
1. Introduction
1.1. Who needs to read this ?
1.2. What do I need to know (why so much) ?
1.3. The tools
1.4. The hardware
1.5. Copyright & License
2. Bootcamp: How To Begin ?
2.1. Creating a development environment
2.2. Compiling the first kernel
2.3. Booting the machine
3. Booting In The Dark
3.1. Debugging with print_str()
3.2. Modifying code using compiler flags
3.3. Getting the console to work
4. Linux Still Isn't Booting
4.1. Memory probing, RTC and decrementors
4.2. Big-little endian (we should have known)
4.3. Ethernet: our first PCI device
4.4. Some Miscellaneous Issues
5. Linux Is Booting ... What Now ?
5.1. The 64 bit barrier
5.2. Booting from flash
A. GNU Free Documentation License
A.1. PREAMBLE
A.2. APPLICABILITY AND DEFINITIONS
A.3. VERBATIM COPYING
A.4. COPYING IN QUANTITY
A.5. MODIFICATIONS
A.6. COMBINING DOCUMENTS
A.7. COLLECTIONS OF DOCUMENTS
A.8. AGGREGATION WITH INDEPENDENT WORKS
A.9. TRANSLATION
A.10. TERMINATION
A.11. FUTURE REVISIONS OF THIS LICENSE
A.12. How to use this License for your documents
B. Trademarks