GRUB payload

Edit this page -- Back to previous index

This section relates to the GRUB payload used in osboot.

GRUB keyboard layouts (for reference)

Custom keyboard layout in GRUB (for reference)

Keymaps are stored in resources/grub/keymap/

How were they made?

Example (French Azerty) (NOTE: last tested when developing Libreboot and the command below was last tested in Trisquel GNU+Linux, version 6.0 LTS in 2014):

ckbcomp fr > frazerty

Go in grub directory (ditto to above):

cat frazerty | ./grub/grub-mklayout -o frazerty.gkb

The above steps should still work on modern GNU+Linux distributions. This page was forked from Libreboot, since osboot is a fork of Libreboot. Even in Libreboot, this page was very old. Some of the information on this page, such as directory paths for GRUB resources in the build system, have been altered to reflect their current location in the osboot build system.

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/grub/keymap/original/ and the frazerty.gkb file goes under resources/grub/keymap/

The build scripts will automatically see this, and automatically build ROM images with your custom layout (given the name) and include them under bin/grub_boardname/

UK Dvorak keyboard layout in GRUB (for reference)

ukdvorak had to be created manually, based on usdvorak. diff them (under resources/grub/keymap/original) to see how ukdvorak file was created. The scan codes were laboriously converted, by hand!

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

Edit this pageLicenseTemplateAuthorsDonateBuy preinstalled

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License Version 1.3 or any later version published by the Free Software Foundation with no Invariant Sections, no Front Cover Texts, and no Back Cover Texts. A copy of this license is found in /docs/fdl-1.3.html