Difference between revisions of "Documentation"

From coreboot
Jump to: navigation, search
m
m
(35 intermediate revisions by 8 users not shown)
Line 1: Line 1:
This page contains information on how to get started building and installing coreboot, as well as build tutorials for various specific motherboards.
+
This page is a collection of '''coreboot-related documentation resources''', HOWTOs, development notes, articles and papers.
  
== Build Tutorials ==
+
{| border="0" valign="top" width="100%"
 +
| valign="top"|
  
* See [[:Category:Tutorials]] for the full list of build tutorials.
+
* [[ACPI]]
 +
* [[CBFS]]
 +
* [[Abuild]]
 +
* [[AMD Geode Porting Guide]]
 +
* [[AMD Family 10h Porting Guide]]
 +
* [[Nvidia CK804 Porting Notes]]
 +
* [[Datasheets]]
 +
* [[Creating Valid IRQ Tables]]
 +
* [[MP Table]]
 +
* [[JTAG/BSDL Guide]]
 +
* [[VGA support]]
 +
* [[Glossary]]
 +
* [[EHCI Debug Port]]
 +
* Some documentation on "piggybacking" using PLCC chips: [[:Image:Tivo_prom_piggy_back_socket_installation.pdf|1]], [[:Image:How_to_build_the_tivo_prom_piggy_socket.pdf|2]], [[:Image:Tivo_piggyback_prom.pdf|3]].
 +
* [[Windows|Booting Windows using coreboot]]
 +
* [[FreeBSD|Booting FreeBSD using coreboot]]
 +
* [[Mini HOWTO: using a CF card for testing and developing coreboot]]
 +
* [[CMOS.layout guide]]
 +
* [[LTS-Laptop]]
 +
| valign="top" |
  
== Port Guides ==
+
* [[Initramfs]]
 +
* [[Artecgroup programmable LPC dongle]]
 +
* [[API]]
 +
* [[Soldering a socket on your board]]
 +
* [[Confirmed working svn revisions]]
 +
* [[Distributed and Automated Testsystem]]
 +
* [[Ideas]]
 +
* [[Debugging]]
 +
* [[Laptop]]
 +
* [[Misc]]
 +
* [[Infrastructure Projects]]
 +
* [[Early SMP startup]]
 +
* [[Serial console]]
 +
* [[Security]]
 +
* [[Boot Speed]]
 +
* [[Reverse Engineering PCI Drivers]]
 +
* [[Easy projects]]
 +
* [[Firmware Comparison]]
 +
* [[Binary_situation]]
 +
|}
  
Port guides and experiences.
+
== Obsolete documentation ==
  
=== coreboot v3 ===
+
This is a list of obsolete or heavily outdated documentation, any information here should be used with care.
 +
 
 +
'''coreboot v3 (obsolete):'''
  
 
* [http://www.coreboot.org/images/0/0a/Newboot.pdf V3 Port Guide]
 
* [http://www.coreboot.org/images/0/0a/Newboot.pdf V3 Port Guide]
Line 15: Line 56:
 
* [[coreboot v3]]
 
* [[coreboot v3]]
  
=== coreboot v2 ===
+
'''coreboot v1 (obsolete):'''
  
* [http://www.openbios.org/LinuxBIOS-AMD64.pdf LinuxBIOS on AMD64 (PDF)]
+
* [[Technoland SBC 710]]
* [[The EPIA-M/MII]]
+
* [[PCCHIPS M810LR]]
* [[AMD Geode Porting Guide]]
+
* [[SiS630]]
* [[ACPI in coreboot]]
+
* [[Anatomy of a Failover coreboot v2 Image]] - you put what where?!
+
  
=== coreboot v1 ===
+
'''Other:'''
 
+
* [[Anatomy of a Failover coreboot v2 Image]] (obsolete since [[CBFS]])
* [[The Technoland SBC 710]]
+
* [[The EPIA-M/MII]]
* [[The PC CHIPS M810LR]]
+
 
+
== Other Documentation ==
+
 
+
* [[JTAG/BSDL Guide]]
+
* [[VGA support]]
+
 
* [[X11 on EPIA-M]]
 
* [[X11 on EPIA-M]]
* [[nvramtool|nvramtool documentation]]
 
 
* [http://www.linuxbios.org/data/docs/configmanual.ps Configuration tool manual] (from freebios/Documentation/configmanual.ps)
 
* [http://www.linuxbios.org/data/docs/configmanual.ps Configuration tool manual] (from freebios/Documentation/configmanual.ps)
 
* [http://www.linuxbios.org/data/lbdoc Project Book, Mangrove LinuxBios] from Mathieu Deschamps
 
* [http://www.linuxbios.org/data/lbdoc Project Book, Mangrove LinuxBios] from Mathieu Deschamps
* coreboot [[Glossary]] + a list of datasheets for each topic
+
* [http://www.openfirmware.info/data/docs/LinuxBIOS-AMD64.pdf LinuxBIOS on AMD64 (PDF)]
* The USB [[EHCI Debug Port]] may be the easiest way to do early debugging without a legacy serial port.
+
* [[Viewvc]]
* [http://web.archive.org/web/20040414101354/http://www.lysator.liu.se/upplysning/fa/linuxbios.pdf Christer Weinigel: Doing Linux programming close to the hardware] (PDF)
+
* [http://snapshots.linuxbios.org/docs/doxygen/ Doxygen generated build documentation]
+
* [[Creating Valid IRQ Tables]]
+
* Some documentation on "piggybacking" using PLCC chips: [[:Image:Tivo_prom_piggy_back_socket_installation.pdf|1]], [[:Image:How_to_build_the_tivo_prom_piggy_socket.pdf|2]], [[:Image:Tivo_piggyback_prom.pdf|3]].
+
* [[Support Tools]]
+
* [[Booting Windows using coreboot]]
+
* [[Booting FreeBSD using coreboot]]
+
* [[AMD Public Documents]]
+
  
== External articles ==
+
== Coreboot Porting Guides ==
  
* [http://www.linuxjournal.com/article/7170 LinuxBIOS at Four]
+
[[Motherboard Porting Guide]]
* [http://plan9.bell-labs.com/wiki/plan9/Integrating_9load_into_the_linuxbios/index.html Integrating 9load into the LinuxBIOS]
+
[[AGESA Porting Guide]]
* [http://blog.perlplexity.org/?p=13 How to get the Iwill DK8-HTX running with LinuxBIOS]
+
  
== Papers/Articles/Slides ==
+
== Papers/articles/slides ==
  
* Breaking the Chains -- Using LinuxBIOS to Liberate Embedded x86 Processors
+
* '''Breaking the Chains -- Using LinuxBIOS to Liberate Embedded x86 Processors''', Jordan H. Crouse, Marc E. Jones, Ronald G. Minnich.
** Jordan H. Crouse, Marc E. Jones, Ronald G. Minnich
+
** Proceedings of the Linux Symposium, June 27th-­30th, 2007, Ottawa, Ontario, Canada. [ [https://ols2006.108.redhat.com/2007/Reprints/crouse-Reprint.pdf pdf] | [http://linuxbios.org/images/8/88/Crouse-Reprint.pdf pdf (local copy)] ]
** Proceedings of the Linux Symposium, June 27th-­30th, 2007, Ottawa, Ontario, Canada
+
** [ [https://ols2006.108.redhat.com/2007/Reprints/crouse-Reprint.pdf pdf] | [http://linuxbios.org/images/8/88/Crouse-Reprint.pdf pdf (local copy)] ]
+
  
* LinuxBIOS - Freedom for your motherboard
+
* '''LinuxBIOS - Freedom for your motherboard''', Alan Carvalho de Assis
** Alan Carvalho de Assis
+
** FISL 8.0 (8th Forum Internacional de Software Livre). [ [[Media:LinuxBIOS-FISL8.pdf|pdf]] ]
** FISL 8.0 (8th Forum Internacional de Software Livre)
+
** [ [[Media:LinuxBIOS-FISL8.pdf|pdf]] ]
+
  
* FSF is moving towards LinuxBIOS deployment (Russian article)
+
* '''FSF is moving towards LinuxBIOS deployment (Russian article)''', Anton Borisov
** Anton Borisov
+
** SAMAG, 02-2006 (http://www.samag.ru). [ [[Media:LX2%40FSF_4a.pdf|pdf]] | [http://ps.kaos.ru/download/FSF_migrates_to_LinuxBIOS_technology.pdf alternative PDF] ]
** SAMAG, 02-2006 (http://www.samag.ru)
+
 
** [ [[Media:LX2%40FSF_4a.pdf|pdf]] | [http://ps.kaos.ru/download/FSF_migrates_to_LinuxBIOS_technology.pdf alternative PDF] ]
+
* '''FreeVGA: Architecture Independent Video Graphics Initialization for LinuxBIOS''', Li-Ta Lo, Gregory R. Watson, Ronald G. Minnich
 +
** Usenix, February 25 2005 (??). [ [http://www.linuxbios.org/data/vgabios/ html] | [[Media:vgabios.pdf|pdf]] ]
 +
 
 +
* [http://web.archive.org/web/20040414101354/http://www.lysator.liu.se/upplysning/fa/linuxbios.pdf Doing Linux programming close to the hardware] (PDF),  Christer Weinigel
 +
 
 +
* [http://plan9.bell-labs.com/wiki/plan9/Integrating_9load_into_the_linuxbios/index.html Integrating 9load into the LinuxBIOS]
  
* FreeVGA: Architecture Independent Video Graphics Initialization for LinuxBIOS
+
* '''[http://www.linuxjournal.com/article/7170 LinuxBIOS at Four]''', Ronald G. Minnich
** Li-Ta Lo, Gregory R. Watson, Ronald G. Minnich
+
** Linux Journal
** Usenix, February 25 2005 (??)
+
** [ [http://www.linuxbios.org/data/vgabios/ html] | [[Media:vgabios.pdf|pdf]] ]
+
  
* Flexibility in ROM: A Stackable Open Source BIOS
+
* '''Flexibility in ROM: A Stackable Open Source BIOS''', Adam Agnew, Adam Sulmicki, Ronald Minnich, William Arbaugh
** Adam Agnew, Adam Sulmicki, Ronald Minnich, William Arbaugh
+
** USENIX 2003 Annual Technical Conference, FREENIX Track, [ [http://www.usenix.org/events/usenix03/tech/freenix03/agnew/agnew_html/index.html HTML] ]
** USENIX 2003 Annual Technical Conference, FREENIX Track
+
** [ [http://www.usenix.org/events/usenix03/tech/freenix03/agnew/agnew_html/index.html HTML] ]
+
  
* Supermon: High performance monitoring for Linux clusters
+
* '''Supermon: High performance monitoring for Linux clusters''', Ron Minnich, Los Alamos National Laboratory, and Karen Reid, University of Toronto
** Ron Minnich, Los Alamos National Laboratory, and Karen Reid, University of Toronto
+
** The [http://www.linuxshowcase.org/2001/ Fifth Annual Linux Showcase and Conference], Oakland, CA, November 5-10 2001, [ [[Media:supermon.ps|ps]] ]  
** The [http://www.linuxshowcase.org/2001/ Fifth Annual Linux Showcase and Conference], Oakland, CA, November 5-10 2001
+
** [ [[Media:supermon.ps|ps]] ]  
+
  
* LOBOS and LinuxBIOS
+
* '''LOBOS and LinuxBIOS''', Cluster Research Brochure
** Cluster Research Brochure
+
** Prepared for SC 2000, November 4-10 2000, [ [[Media:sc00.pdf|pdf]] ]  
** prepared for SC 2000, November 4-10 2000
+
** [ [[Media:sc00.pdf|pdf]] ]  
+
  
* The Linux BIOS
+
* '''The Linux BIOS''', Ron Minnich, James Hendricks, and Dale Webster, Los Alamos National Laboratory
** Ron Minnich, James Hendricks, and Dale Webster, Los Alamos National Laboratory
+
** The [http://www.linuxshowcase.org/2000/ Fourth Annual Linux Showcase and Conference], Atlanta, GA, October 4-11 2000, [ [[Media:linuxbios.pdf|pdf]] | [[Media:linuxbios.ps|ps]] ]  
** The [http://www.linuxshowcase.org/2000/ Fourth Annual Linux Showcase and Conference], Atlanta, GA, October 4-11 2000
+
** [ [[Media:linuxbios.pdf|pdf]] | [[Media:linuxbios.ps|ps]] ]  
+
  
* LOBOS (Linux OS Boots Linux OS): Booting a Kernel in 32-bit Mode
+
*''' LOBOS (Linux OS Boots Linux OS): Booting a Kernel in 32-bit Mode''', Ron Minnich, Los Alamos National Laboratory
** Ron Minnich, Los Alamos National Laboratory
+
** The [http://www.linuxshowcase.org/2000/ Fourth Annual Linux Showcase and Conference], Atlanta, GA, October 4-11 2000, [ [[Media:lobos.pdf|pdf]] | [[Media:lobos.ps|ps]] ]  
** The [http://www.linuxshowcase.org/2000/ Fourth Annual Linux Showcase and Conference], Atlanta, GA, October 4-11 2000
+
** [ [[Media:lobos.pdf|pdf]] | [[Media:lobos.ps|ps]] ]  
+
  
* Putting Linux on your motherboard
+
* '''Putting Linux on your motherboard''', Antony Stone
** Antony Stone
+
** [http://www.linux-magazine.com/ Linux Magazine], March, 2003, Pg. 76[ [[Media:LinuxBIOS.pdf|pdf]] ]
** [http://www.linux-magazine.com/ Linux Magazine], March, 2003, Pg. 76
+
** [ [[Media:LinuxBIOS.pdf|pdf]] ]
+
  
* Look Ma, No Bios
+
* '''Look Ma, No Bios''', Oleg Goldshmidt
** Oleg Goldshmidt
+
** IBM Haifa Research Laboratory, July 2006, [http://www.goldshmidt.org/about/lectures.html Oleg's talks], [ [http://www.goldshmidt.org/about/LinuxBIOS/LinuxBIOSHaifux.html html] | [http://www.goldshmidt.org/about/LinuxBIOS/LinuxBIOSHaifux.html.zip html.zip] | [http://www.goldshmidt.org/about/LinuxBIOS/LinuxBIOSHaifux.ppt.zip ppt.zip] | [[Media:LookMaNoBIOS.pdf|pdf]] ]
** IBM Haifa Research Laboratory, July 2006
+
** [http://www.goldshmidt.org/about/lectures.html Oleg's talks]
+
** [ [http://www.goldshmidt.org/about/LinuxBIOS/LinuxBIOSHaifux.html html] | [http://www.goldshmidt.org/about/LinuxBIOS/LinuxBIOSHaifux.html.zip html.zip] | [http://www.goldshmidt.org/about/LinuxBIOS/LinuxBIOSHaifux.ppt.zip ppt.zip] | [[Media:LookMaNoBIOS.pdf|pdf]] ]
+
  
* A Framework for Using Processor Cache as RAM (CAR)
+
* '''A Framework for Using Processor Cache as RAM (CAR)''', Eswaramoorthi Nallusamy
** Eswaramoorthi Nallusamy
+
** University of New Mexico, [ [[Media:LBCar.ppt|ppt]] | [[Media:LBCar.pdf|pdf]]]
** University of New Mexico
+
** [ [[Media:LBCar.ppt|ppt]] | [[Media:LBCar.pdf|pdf]]]
+
  
 
== Books ==
 
== Books ==

Revision as of 05:53, 5 April 2014

This page is a collection of coreboot-related documentation resources, HOWTOs, development notes, articles and papers.

Obsolete documentation

This is a list of obsolete or heavily outdated documentation, any information here should be used with care.

coreboot v3 (obsolete):

coreboot v1 (obsolete):

Other:

Coreboot Porting Guides

Motherboard Porting Guide AGESA Porting Guide

Papers/articles/slides

  • Breaking the Chains -- Using LinuxBIOS to Liberate Embedded x86 Processors, Jordan H. Crouse, Marc E. Jones, Ronald G. Minnich.
    • Proceedings of the Linux Symposium, June 27th-­30th, 2007, Ottawa, Ontario, Canada. [ pdf | pdf (local copy) ]
  • LinuxBIOS - Freedom for your motherboard, Alan Carvalho de Assis
    • FISL 8.0 (8th Forum Internacional de Software Livre). [ pdf ]
  • FreeVGA: Architecture Independent Video Graphics Initialization for LinuxBIOS, Li-Ta Lo, Gregory R. Watson, Ronald G. Minnich
    • Usenix, February 25 2005 (??). [ html | pdf ]
  • Flexibility in ROM: A Stackable Open Source BIOS, Adam Agnew, Adam Sulmicki, Ronald Minnich, William Arbaugh
    • USENIX 2003 Annual Technical Conference, FREENIX Track, [ HTML ]
  • Supermon: High performance monitoring for Linux clusters, Ron Minnich, Los Alamos National Laboratory, and Karen Reid, University of Toronto
  • LOBOS and LinuxBIOS, Cluster Research Brochure
    • Prepared for SC 2000, November 4-10 2000, [ pdf ]
  • Putting Linux on your motherboard, Antony Stone
  • A Framework for Using Processor Cache as RAM (CAR), Eswaramoorthi Nallusamy
    • University of New Mexico, [ ppt | pdf]

Books

These books do not address LinuxBIOS specifically but provide background information useful for BIOS-level programming on PC hardware.