summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorHugo Hromic <hhromic@gmail.com>2018-04-16 14:03:13 +0100
committerAndrei Gherzan <andrei@gherzan.com>2018-04-20 15:17:20 +0100
commit3175e7f3e2066ef34897013742ab95341c3ebaae (patch)
tree7f4cbe7aa20c498a0b250138433477e92b215bb2 /docs
parent5641ac3730502980353e9dfb187d9c5a08a99e9f (diff)
downloadmeta-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.md48
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
35See: <https://www.raspberrypi.org/documentation/configuration/config-txt/memory.md>
36
35## Add purchased license codecs 37## Add purchased license codecs
36 38
37To add you own licenses use variables `KEY_DECODE_MPG2` and `KEY_DECODE_WVC1` in 39To 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
49See: <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
61By default a rainbow splash screen is shown after the GPU firmware is loaded.
62To disable this set this variable in local.conf:
63
64 DISABLE_SPLASH = "1"
65
66## Boot delay
67
68The Raspberry Pi waits a number of seconds after loading the GPU firmware and
69before loading the kernel. By default it is one second. This is useful if your
70SD card needs a while to get ready before Linux is able to boot from it.
71To 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
58The Raspberry PI can be overclocked. As of now overclocking up to the "Turbo 78The Raspberry Pi can be overclocked. As of now overclocking up to the "Turbo
59Mode" is officially supported by the raspbery and does not void warranty. Check 79Mode" is officially supported by the raspbery and does not void warranty. Check
60the config.txt for a detailed description of options and modes. Example turbo 80the config.txt for a detailed description of options and modes. The following
61mode: 81variables are supported in local.conf: `ARM_FREQ`, `GPU_FREQ`, `CORE_FREQ`,
82`SDRAM_FREQ` and `OVER_VOLTAGE`.
83
84Example 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
91See: <https://www.raspberrypi.org/documentation/configuration/config-txt/overclocking.md>
92
93## HDMI and composite video options
94
95The Raspberry Pi can output video over HDMI or SDTV composite (the RCA connector).
96By default the video mode for these is autodetected on boot: the HDMI mode is
97selected according to the connected monitor's EDID information and the composite
98mode is defaulted to NTSC using a 4:3 aspect ratio. Check the config.txt for a
99detailed description of options and modes. The following variables are supported in
100local.conf: `HDMI_FORCE_HOTPLUG`, `HDMI_DRIVE`, `HDMI_GROUP`, `HDMI_MODE`,
101`CONFIG_HDMI_BOOST`, `SDTV_MODE`, `SDTV_ASPECT` and `DISPLAY_ROTATE`.
102
103Example to force HDMI output to 720p in CEA mode:
104
105 HDMI_GROUP = "1"
106 HDMI_MODE = "4"
107
108See: <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
70Set this variable to enable support for the video camera (Linux 3.12.4+ 112Set this variable to enable support for the video camera (Linux 3.12.4+