diff options
author | Hugo Hromic <hhromic@gmail.com> | 2018-04-16 14:03:13 +0100 |
---|---|---|
committer | Andrei Gherzan <andrei@gherzan.com> | 2018-04-20 15:17:20 +0100 |
commit | 3175e7f3e2066ef34897013742ab95341c3ebaae (patch) | |
tree | 7f4cbe7aa20c498a0b250138433477e92b215bb2 /docs | |
parent | 5641ac3730502980353e9dfb187d9c5a08a99e9f (diff) | |
download | meta-raspberrypi-3175e7f3e2066ef34897013742ab95341c3ebaae.tar.gz |
rpi-config: support more commonly used config variables and update documentation
Added support for and documented the following new extra build options:
* gpu_freq overclocking option
* disable boot rainbow splash screen
* configure the boot delay after GPU firmware loading
* configure common HDMI and composite video options
Signed-off-by: Hugo Hromic <hhromic@gmail.com>
Diffstat (limited to 'docs')
-rw-r--r-- | docs/extra-build-config.md | 48 |
1 files changed, 45 insertions, 3 deletions
diff --git a/docs/extra-build-config.md b/docs/extra-build-config.md index d162abc..35abbdf 100644 --- a/docs/extra-build-config.md +++ b/docs/extra-build-config.md | |||
@@ -32,6 +32,8 @@ Accommodate the values above to your own needs (ex: ext3 / ext4). | |||
32 | * `GPU_MEM_1024`: GPU memory in megabyte for the 1024MB Raspberry Pi. Ignored by | 32 | * `GPU_MEM_1024`: GPU memory in megabyte for the 1024MB Raspberry Pi. Ignored by |
33 | the 256MB/512MB RP. Overrides gpu_mem. Max 944. Default not set. | 33 | the 256MB/512MB RP. Overrides gpu_mem. Max 944. Default not set. |
34 | 34 | ||
35 | See: <https://www.raspberrypi.org/documentation/configuration/config-txt/memory.md> | ||
36 | |||
35 | ## Add purchased license codecs | 37 | ## Add purchased license codecs |
36 | 38 | ||
37 | To add you own licenses use variables `KEY_DECODE_MPG2` and `KEY_DECODE_WVC1` in | 39 | To add you own licenses use variables `KEY_DECODE_MPG2` and `KEY_DECODE_WVC1` in |
@@ -44,6 +46,7 @@ You can supply more licenses separated by comma. Example: | |||
44 | 46 | ||
45 | KEY_DECODE_WVC1 = "0x12345678,0xabcdabcd,0x87654321" | 47 | KEY_DECODE_WVC1 = "0x12345678,0xabcdabcd,0x87654321" |
46 | 48 | ||
49 | See: <https://www.raspberrypi.org/documentation/configuration/config-txt/codeclicence.md> | ||
47 | 50 | ||
48 | ## Disable overscan | 51 | ## Disable overscan |
49 | 52 | ||
@@ -53,18 +56,57 @@ local.conf: | |||
53 | 56 | ||
54 | DISABLE_OVERSCAN = "1" | 57 | DISABLE_OVERSCAN = "1" |
55 | 58 | ||
59 | ## Disable splash screen | ||
60 | |||
61 | By default a rainbow splash screen is shown after the GPU firmware is loaded. | ||
62 | To disable this set this variable in local.conf: | ||
63 | |||
64 | DISABLE_SPLASH = "1" | ||
65 | |||
66 | ## Boot delay | ||
67 | |||
68 | The Raspberry Pi waits a number of seconds after loading the GPU firmware and | ||
69 | before loading the kernel. By default it is one second. This is useful if your | ||
70 | SD card needs a while to get ready before Linux is able to boot from it. | ||
71 | To remove (or adjust) this delay set these variables in local.conf: | ||
72 | |||
73 | BOOT_DELAY = "0" | ||
74 | BOOT_DELAY_MS = "0" | ||
75 | |||
56 | ## Set overclocking options | 76 | ## Set overclocking options |
57 | 77 | ||
58 | The Raspberry PI can be overclocked. As of now overclocking up to the "Turbo | 78 | The Raspberry Pi can be overclocked. As of now overclocking up to the "Turbo |
59 | Mode" is officially supported by the raspbery and does not void warranty. Check | 79 | Mode" is officially supported by the raspbery and does not void warranty. Check |
60 | the config.txt for a detailed description of options and modes. Example turbo | 80 | the config.txt for a detailed description of options and modes. The following |
61 | mode: | 81 | variables are supported in local.conf: `ARM_FREQ`, `GPU_FREQ`, `CORE_FREQ`, |
82 | `SDRAM_FREQ` and `OVER_VOLTAGE`. | ||
83 | |||
84 | Example official settings for Turbo Mode in Raspberry Pi 2: | ||
62 | 85 | ||
63 | ARM_FREQ = "1000" | 86 | ARM_FREQ = "1000" |
64 | CORE_FREQ = "500" | 87 | CORE_FREQ = "500" |
65 | SDRAM_FREQ = "500" | 88 | SDRAM_FREQ = "500" |
66 | OVER_VOLTAGE = "6" | 89 | OVER_VOLTAGE = "6" |
67 | 90 | ||
91 | See: <https://www.raspberrypi.org/documentation/configuration/config-txt/overclocking.md> | ||
92 | |||
93 | ## HDMI and composite video options | ||
94 | |||
95 | The Raspberry Pi can output video over HDMI or SDTV composite (the RCA connector). | ||
96 | By default the video mode for these is autodetected on boot: the HDMI mode is | ||
97 | selected according to the connected monitor's EDID information and the composite | ||
98 | mode is defaulted to NTSC using a 4:3 aspect ratio. Check the config.txt for a | ||
99 | detailed description of options and modes. The following variables are supported in | ||
100 | local.conf: `HDMI_FORCE_HOTPLUG`, `HDMI_DRIVE`, `HDMI_GROUP`, `HDMI_MODE`, | ||
101 | `CONFIG_HDMI_BOOST`, `SDTV_MODE`, `SDTV_ASPECT` and `DISPLAY_ROTATE`. | ||
102 | |||
103 | Example to force HDMI output to 720p in CEA mode: | ||
104 | |||
105 | HDMI_GROUP = "1" | ||
106 | HDMI_MODE = "4" | ||
107 | |||
108 | See: <https://www.raspberrypi.org/documentation/configuration/config-txt/video.md> | ||
109 | |||
68 | ## Video camera support with V4L2 drivers | 110 | ## Video camera support with V4L2 drivers |
69 | 111 | ||
70 | Set this variable to enable support for the video camera (Linux 3.12.4+ | 112 | Set this variable to enable support for the video camera (Linux 3.12.4+ |