From 893ac08f64f044a3b9a000e244fb33ed761b3ccb Mon Sep 17 00:00:00 2001 From: Leah Rowe Date: Sat, 3 Sep 2016 16:03:35 +0100 Subject: remove maintenance section in docs (prep for new build system) --- docs/git/index.html | 127 ---------------------------------------------------- 1 file changed, 127 deletions(-) (limited to 'docs/git') diff --git a/docs/git/index.html b/docs/git/index.html index aaa2ff58..3f3894c6 100644 --- a/docs/git/index.html +++ b/docs/git/index.html @@ -264,133 +264,6 @@ -
- -

Configuring libreboot

- -

- Before building a ROM in libreboot (or coreboot, for that matter), you need to configure it. - Configuration files should already be included, so you don't need to do anything. This information - is only for reference. If you are updating or modifying coreboot-libre, and need to update the configs - in any way, refer to ../maintain/index.html#newboard_libreboot. -

- -

- If you've already built a kernel before, you know how to use this interface. -

- -
-

- dmidecode -

-

- There is certain information that can be useful to enter in particular: -

-
    -
  • Local version string
    • -
  • SMBIOS Serial Number
    • -
  • SMBIOS Manufacturer
    • -
  • SMBIOS Version
    • -
  • SMBIOS Product name
    • -
-

- This information can be obtained using:
- $ sudo dmidecode
- # dmidecode -

-

- Specifically, it's good practise to enter the same information for libreboot that you found when running this - with the original BIOS or firmware. libreboot has already done this for you. This information is for reference, - in the hope that it will be useful. -

-

- In practise, this information is useless and you can - just leave it on the defaults that coreboot uses (this - is what libreboot does, on most boards). -

-
- -

GRUB payload

- -

- GRUB is one of the payloads that libreboot targets. -

- -

- Configurations are then saved as files called ".config". Copies of each configuration used - for each system type by the libreboot build scripts are stored in resources/libreboot/config/grub/ -

- -
-

- Generic configuration file (file: resources/libreboot/config/payload/board/config) -

-
    -
  • General setup / Expert mode = enable
    • -
  • General / Use CMOS for configuration values = enable
    • -
  • Mainboard / Mainboard vendor = Name of manufacturer
    • -
  • Mainboard / Mainboard model = Model name
    • -
  • Mainboard / ROM chip size = size of flash chip
    • -
  • Chipset / Include CPU microcode in CBFS = Do not include microcode updates
    • -
  • Devices / Use native graphics initialization = enable
    • -
  • - Display / Keep VESA framebuffer = disable (disable for text-mode graphics, enable for coreboot vesa framebuffer) -
      -
    • Libreboot provides this with text-mode enabled by default, but it automatically patches a copy of the config at build time - to enable coreboot framebuffer for a separate set of ROM images, in each system.
      • -
    -
    • -
  • Generic Drivers / USB 2.0 EHCI debug dongle support = Enable
    • -
  • Generic Drivers / Enable early (pre-RAM) usbdebug = Enable
    • -
  • Generic Drivers / Type of dongle = Net20DC or compatible
    • -
  • Generic Drivers / Digitizer = Present
    • - -
  • Console / USB dongle console output = enable
    • -
  • Payload / Add a payload = An ELF executable payload
    • -
  • Payload / Payload path and filename = grub.elf
    • -
-

- Now go back into Devices: -

-
    -
  • Devices / Run VGA Option ROMs = disable
    • -
  • Devices / Run Option ROMs on PCI devices = disable
    • -
-

- The resulting .config file was saved as resources/libreboot/config/payload/board/config and is used by the build - scripts for this system. -

-
- -

Configuring libreboot for chromebooks

-

- Depthcharge is one of the payloads that libreboot targets. -

-

- Configurations are then saved as files called ".config". Copies of each configuration used - for each system type by the libreboot build scripts are stored in resources/libreboot/config/depthcharge/ -

-
-

- Generic configuration file (file: resources/libreboot/config/depthcharge/board/config) -

-
    -
  • Mainboard / Mainboard vendor = Google
    • -
  • Mainboard / Mainboard model = name of model
    • -
  • Chipset / ChromeOS / Build for ChromeOS = enable
    • -
  • Chipset / ChromeOS / Verify firmware with vboot. = disable
    • -
  • Payload / Add a payload = An ELF executable payload
    • -
  • Payload / Payload path and filename = depthcharge.elf
    • -
-

- The resulting .config file was saved as resources/libreboot/config/depthcharge/board/config and is used by the build - scripts for this system. -

-
-

Back to top of page.

- -
-

How to build the ROM images

-- cgit v1.2.3-70-g09d2