From 8b2219bfa2da36e7809588ef723a10483a6e137f Mon Sep 17 00:00:00 2001 From: Francis Rowe Date: Wed, 05 Nov 2014 20:52:36 -0500 Subject: Documentation: *major* cleanup. Cleanup was long overdue. Old structure was messy and inefficient. --- (limited to 'docs/grub') diff --git a/docs/grub/index.html b/docs/grub/index.html new file mode 100644 index 0000000..f2d554a --- /dev/null +++ b/docs/grub/index.html @@ -0,0 +1,123 @@ + + + + + + + + + GRUB payload + + + + +

GRUB payload

+

+ This section relates to the GRUB payload used in libreboot. +

+

+ Or Back to main index. +

+ + +
+ +

Setting font in GRUB (for reference)

+ +

You don't need to do this unless you would like to change the default font yourself. + (this is just for reference. It has already been done for you)

+ +

The old font used was Unifont, and this had some missing characters: for instance, the border showed ??? characters instead of lines.

+ +

I tried DeJavu Sans Mono from this website: + dejavu-fonts.org

+ +

Specifically, the version that I chose was the latest at the time of writing (Saturday 21 June 2014): + this one

+ +

This is a free font that is also contained in GNU/Linux distributions like Trisquel or Parabola.

+ +

$ cd libreboot_src/grub
+ compile grub ('build' script has the info on how to do this)
+ come back out into libreboot_src/resources/grub:
+ $ cd ../libreboot_src/resources/grub/font

+ +

I took Dejavu Sans Mono from dejavu (included in this version of libreboot) and did:
+ $ ../../../grub/grub-mkfont -o dejavusansmono.pf2 ../../../dejavu-fonts-ttf-2.34/ttf/DejaVuSansMono.ttf

+ +

I then added the instructions to 'build' script to include resources/grub/dejavusansmono.pf2 in all of the ROM's in root of cbfs.
+ I then added that instructions to the grub.cfg files (to load the font):
+ loadfont (cbfsdisk)/dejavusansmono.pf2

+ +

Back to top of page

+ +
+ +

GRUB keyboard layouts (for reference)

+ +

Custom keyboard layout in GRUB (for reference)

+ +

+ Keymaps are stored in resources/utilities/grub-assemble/keymap/. +

+ +

+ Example (French Azerty):
+ $ ckbcomp fr > frazerty

+ Go in grub directory:
+ cat frazerty | ./grub/grub-mklayout -o frazerty.gkb +

+ +

+ You must make sure that the files are named keymap and keymap.gkb (where 'keymap' can be whatever you want). +

+ +

+ Then from the above example, you would put frazerty in resources/utilities/grub-assemble/keymap/original/ and + the frazerty.gkb file goes under resources/utilities/grub-assemble/keymap/ +

+ +

+ The scripts build and buildrom-withgrub will automatically see this, and automatically build + ROM's with your custom layout (given the name) and include them under bin. Example: libreboot_frazerty.rom. +

+ +

Back to top of page

+ +

UK Dvorak keyboard layout in GRUB (for reference)

+ +

+ ukdvorak had to be created manually, based on usdvorak. diff them (under resources/utilities/grub-assemble/keymap/original) + to see how ukdvorak file was created +

+ +

$ cat ukdvorak | ./grub/grub-mklayout -o ukdvorak.gkb

+ +

Back to top of page

+ +
+ +

+ Copyright © 2014 Francis Rowe <info@gluglug.org.uk>
+ This document is released under the Creative Commons Attribution-ShareAlike 4.0 International Public License and all future versions. + A copy of the license can be found at ../license.txt. +

+ +

+ This document is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See ../license.txt for more information. +

+ + + -- cgit v0.9.1