Custom Linux: A Porting Guide

Porting LinuxPPC to a Custom SBC

Shie Erlich

<shie@myrealbox.com>

Rafi Yanai - my partner in the porting process

Avi Rubenbach - without whom this wouldn't be possible

Revision History
Revision 2.1	2003-03-08	Revised by: gjf
Modified code example per author
Revision 2.0	2002-06-13	Revised by: tab
Added GFDL per author
Revision 1.0	2002-05-13	Revised 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

		Next
		Introduction