Questions tagged [config.txt]

This file is parsed by the GPU before the initialisation of the ARM core. It can be used to set various parameters to alter the behaviour of the system, such as display resolution or overclocking settings.

The parameters available for the config.txt file will be listed in this wiki. Please note that you edit this file at your own risk, and some settings may harm your device if used incorrectly. Warnings will be listed where appropriate in the following text.

The config.txt file is a collection of property:value pairs. Unless otherwise stated, the first parameter in each section is the default property. Its placed in /boot/config.txt

Details in this wiki have been adapted for easier reading from the works here: http://elinux.org/RPi_config.txt


Video Mode

sdtv_mode

Used to set the standard for composite output.

sdtv_mode=0    Normal NTSC
sdtv_mode=1    Japanese version of NTSC – no pedestal
sdtv_mode=2    Normal PAL
sdtv_mode=3    Brazilian version of PAL

sdtv_aspect

The aspect ratio for composite output.

sdtv_aspect=1  4:3
sdtv_aspect=2  14:9
sdtv_aspect=3  16:9

sdtv_disable_colourburst

Disables colour burst on composite output. Although the picture will be monochrome, it may be sharper.

sdtv_disable_colourburst=1

hdmi_safe

Use "safe mode" settings to try to boot with maximum hdmi compatibility.

hdmi_safe=1

This is the same as adding the following lines together:

hdmi_force_hotplug=1 
config_hdmi_boost=4
hdmi_group=1
hdmi_mode=1
disable_overscan=0

hdmi_ignore_edid

Enables the ignoring of EDID/display data

hdmi_ignore_edid=0xa5000080

hdmi_force_edid_audio

Pretends all audio formats are supported by display, allowing passthrough of DTS/AC3 even when not reported as supported.

hdmi_force_edid_audio=1

hdmi_ignore_cec

Pretends CEC is not supported by TV. Avoids bringing (CEC enabled) TV out of standby and channel switch when rebooting.

hdmi_ignore_cec=1

hdmi_force_hotplug

Pretends HDMI hotplug signal is asserted so it appears a HDMI display is attached

hdmi_force_hotplug=1 Use HDMI mode even if no HDMI monitor is detected

hdmi_ignore_hotplug

Pretends HDMI hotplug signal is not asserted so it appears a HDMI display is not attached

hdmi_ignore_hotplug=1 Use composite mode even if HDMI monitor is detected

hdmi_drive

Chooses between HDMI and DVI modes. DVI mode will mean that sound is not transmitted though HDMI. Normal mode will transmit sound if supported.

hdmi_drive= 1 Normal DVI mode 
hdmi_drive= 2 Normal HDMI mode 

hdmi_group

Defines the HDMI type. This is used by hdmi_mode. Not specifying the group, or setting to 0 will use the preferred group reported by the edid.

hdmi_group=1   CEA
hdmi_group=2   DMT

CEA:

Electronic Industries Alliance (EIA-861B) refers to a CEA/EIA standard which consists of display timing and formats supported by Digital Televisions

DMT:

Display Monitor Timings (DMT) are a list of VESA standard pre-defined timings which are commonly used within the Computer industry.

hdmi_mode

Defines screen resolution in CEA or DMT format. The following options are supported:

hdmi_group=1 (CEA):

hdmi_mode=1    VGA
hdmi_mode=2    480p  60Hz
hdmi_mode=3    480p  60Hz  H
hdmi_mode=4    720p  60Hz
hdmi_mode=5    1080i 60Hz
hdmi_mode=6    480i  60Hz
hdmi_mode=7    480i  60Hz  H
hdmi_mode=8    240p  60Hz
hdmi_mode=9    240p  60Hz  H
hdmi_mode=10   480i  60Hz  4x
hdmi_mode=11   480i  60Hz  4x H
hdmi_mode=12   240p  60Hz  4x
hdmi_mode=13   240p  60Hz  4x H
hdmi_mode=14   480p  60Hz  2x
hdmi_mode=15   480p  60Hz  2x H
hdmi_mode=16   1080p 60Hz
hdmi_mode=17   576p  50Hz
hdmi_mode=18   576p  50Hz  H
hdmi_mode=19   720p  50Hz
hdmi_mode=20   1080i 50Hz
hdmi_mode=21   576i  50Hz
hdmi_mode=22   576i  50Hz  H
hdmi_mode=23   288p  50Hz
hdmi_mode=24   288p  50Hz  H
hdmi_mode=25   576i  50Hz  4x
hdmi_mode=26   576i  50Hz  4x H
hdmi_mode=27   288p  50Hz  4x
hdmi_mode=28   288p  50Hz  4x H
hdmi_mode=29   576p  50Hz  2x
hdmi_mode=30   576p  50Hz  2x H
hdmi_mode=31   1080p 50Hz
hdmi_mode=32   1080p 24Hz
hdmi_mode=33   1080p 25Hz
hdmi_mode=34   1080p 30Hz
hdmi_mode=35   480p  60Hz  4x
hdmi_mode=36   480p  60Hz  4xH
hdmi_mode=37   576p  50Hz  4x
hdmi_mode=38   576p  50Hz  4x H
hdmi_mode=39   1080i 50Hz  reduced blanking
hdmi_mode=40   1080i 100Hz
hdmi_mode=41   720p  100Hz
hdmi_mode=42   576p  100Hz
hdmi_mode=43   576p  100Hz H
hdmi_mode=44   576i  100Hz
hdmi_mode=45   576i  100Hz H
hdmi_mode=46   1080i 120Hz
hdmi_mode=47   720p  120Hz
hdmi_mode=48   480p  120Hz
hdmi_mode=49   480p  120Hz H
hdmi_mode=50   480i  120Hz
hdmi_mode=51   480i  120Hz H
hdmi_mode=52   576p  200Hz
hdmi_mode=53   576p  200Hz H
hdmi_mode=54   576i  200Hz
hdmi_mode=55   576i  200Hz H
hdmi_mode=56   480p  240Hz
hdmi_mode=57   480p  240Hz H
hdmi_mode=58   480i  240Hz
hdmi_mode=59   480i  240Hz H

Note:

  • H means 16:9 variant (of a normally 4:3 mode).

  • 2x means pixel doubled (i.e. higher clock rate, with each pixel repeated twice)

  • 4x means pixel quadrupled (i.e. higher clock rate, with each pixel repeated four times)

hdmi_group=2 (DMT):

hdmi_mode=1    640x350   85Hz
hdmi_mode=2    640x400   85Hz
hdmi_mode=3    720x400   85Hz
hdmi_mode=4    640x480   60Hz
hdmi_mode=5    640x480   72Hz
hdmi_mode=6    640x480   75Hz
hdmi_mode=7    640x480   85Hz
hdmi_mode=8    800x600   56Hz
hdmi_mode=9    800x600   60Hz
hdmi_mode=10   800x600   72Hz
hdmi_mode=11   800x600   75Hz
hdmi_mode=12   800x600   85Hz
hdmi_mode=13   800x600   120Hz
hdmi_mode=14   848x480   60Hz
hdmi_mode=15   1024x768  43Hz  DO NOT USE
hdmi_mode=16   1024x768  60Hz
hdmi_mode=17   1024x768  70Hz
hdmi_mode=18   1024x768  75Hz
hdmi_mode=19   1024x768  85Hz
hdmi_mode=20   1024x768  120Hz
hdmi_mode=21   1152x864  75Hz
hdmi_mode=22   1280x768        reduced blanking
hdmi_mode=23   1280x768  60Hz
hdmi_mode=24   1280x768  75Hz
hdmi_mode=25   1280x768  85Hz
hdmi_mode=26   1280x768  120Hz reduced blanking
hdmi_mode=27   1280x800        reduced blanking
hdmi_mode=28   1280x800  60Hz
hdmi_mode=29   1280x800  75Hz
hdmi_mode=30   1280x800  85Hz
hdmi_mode=31   1280x800  120Hz reduced blanking
hdmi_mode=32   1280x960  60Hz
hdmi_mode=33   1280x960  85Hz
hdmi_mode=34   1280x960  120Hz reduced blanking
hdmi_mode=35   1280x1024 60Hz
hdmi_mode=36   1280x1024 75Hz
hdmi_mode=37   1280x1024 85Hz
hdmi_mode=38   1280x1024 120Hz reduced blanking
hdmi_mode=39   1360x768  60Hz
hdmi_mode=40   1360x768  120Hz reduced blanking
hdmi_mode=41   1400x1050       reduced blanking
hdmi_mode=42   1400x1050 60Hz
hdmi_mode=43   1400x1050 75Hz
hdmi_mode=44   1400x1050 85Hz
hdmi_mode=45   1400x1050 120Hz reduced blanking
hdmi_mode=46   1440x900        reduced blanking
hdmi_mode=47   1440x900  60Hz
hdmi_mode=48   1440x900  75Hz
hdmi_mode=49   1440x900  85Hz
hdmi_mode=50   1440x900  120Hz reduced blanking
hdmi_mode=51   1600x1200 60Hz
hdmi_mode=52   1600x1200 65Hz
hdmi_mode=53   1600x1200 70Hz
hdmi_mode=54   1600x1200 75Hz
hdmi_mode=55   1600x1200 85Hz
hdmi_mode=56   1600x1200 120Hz reduced blanking
hdmi_mode=57   1680x1050       reduced blanking
hdmi_mode=58   1680x1050 60Hz
hdmi_mode=59   1680x1050 75Hz
hdmi_mode=60   1680x1050 85Hz
hdmi_mode=61   1680x1050 120Hz reduced blanking
hdmi_mode=62   1792x1344 60Hz
hdmi_mode=63   1792x1344 75Hz
hdmi_mode=64   1792x1344 120Hz reduced blanking
hdmi_mode=65   1856x1392 60Hz
hdmi_mode=66   1856x1392 75Hz
hdmi_mode=67   1856x1392 120Hz reduced blanking
hdmi_mode=68   1920x1200       reduced blanking
hdmi_mode=69   1920x1200 60Hz
hdmi_mode=70   1920x1200 75Hz
hdmi_mode=71   1920x1200 85Hz
hdmi_mode=72   1920x1200 120Hz reduced blanking
hdmi_mode=73   1920x1440 60Hz
hdmi_mode=74   1920x1440 75Hz
hdmi_mode=75   1920x1440 120Hz reduced blanking
hdmi_mode=76   2560x1600       reduced blanking
hdmi_mode=77   2560x1600 60Hz
hdmi_mode=78   2560x1600 75Hz
hdmi_mode=79   2560x1600 85Hz
hdmi_mode=80   2560x1600 120Hz reduced blanking
hdmi_mode=81   1366x768  60Hz
hdmi_mode=82   1080p     60Hz
hdmi_mode=83   1600x900        reduced blanking
hdmi_mode=84   2048x1152       reduced blanking
hdmi_mode=85   720p      60Hz
hdmi_mode=86   1366x768        reduced blanking

overscan_left

Number of pixels to skip on left.

overscan_right

Number of pixels to skip on right

overscan_top

Number of pixels to skip on top

overscan_bottom

Number of pixels to skip on bottom

framebuffer_width

Console framebuffer width in pixels. Default is display width minus overscan.

framebuffer_height

Console framebuffer height in pixels. Default is display height minus overscan.

framebuffer_depth

Console framebuffer depth in bits per pixel. Default is 16. 8bit is valid, but default RGB palette makes an unreadable screen. 24bit looks better but has corruption issues as of 20120615. 32bit has no corruption issues but needs framebuffer_ignore_alpha=1 and shows the wrong colors as of 20120615.

framebuffer_ignore_alpha

Set to 1 to disable alpha channel. Helps with 32bit.

test_mode

Enable test sound/image during boot for manufacturing test.

disable_l2cache

Disable arm access to GPU's L2 cache. Needs corresponding L2 disabled kernel. Default is 0.

disable_overscan

Set to 1 to disable overscan.

config_hdmi_boost

Configure the signal strength of the HDMI interface. Default is 2 on Pi 1 model B and 5 on later boards. Try increasing if you have interference issues with hdmi (e.g. to 7) 11 is the maximum.

TODO: Overclocking options

163 questions
47
votes
2 answers

Is setting `max_usb_current=1` to give more power to USB devices a bad idea?

I've been searching around for more information on the /boot/config.txt configuration directive max_usb_current, trying to find out exactly what happens when that is set to 1, but it's hard to find any official documentation. I know the…
geerlingguy
  • 1,676
  • 2
  • 16
  • 22
25
votes
2 answers

What does "dtoverlay=dwc2" REALLY do?

Please don't point me to what it is used for, there are plenty of articles telling me how to make my Pi Zero an ethernet gadget. Putting "dtoverlay=dwc2" into /boot/config.txt appears to fix a known issue with a CH340 Usb to Serial device (arduino…
Lee Sanders
  • 251
  • 1
  • 3
  • 3
23
votes
7 answers

How do I increase the terminal font size?

I have a Raspberry pi B, using Debian, just rigged up with a 3.5 inch TFT-LCD monitor via VGA. The text size in command line mode is too small to read, so I would like to increase its size, and one method says "edit /boot/config.txt". However the…
Harry Weston
  • 467
  • 2
  • 6
  • 16
23
votes
3 answers

Why won't my Raspberry Pi overclock?

I edited the file /boot/config.txt to increase the CPU speed to 800MHz. dmesg includes the following line bcm2835-cpufreq: Freq 800000->700000 (min=700000 max=800000 target=700000 request=700000) Sure enough, my CPU is only running at 700MHz. Why…
John Smith
  • 1,251
  • 3
  • 18
  • 27
21
votes
4 answers

Easiest way to return to a known good state when overclocking

If I try to overclock my Pi, I want to go up to the point where the Pi won't boot anymore, or won't be stable enough. At this point, I want to come back to the latest known good settings for the /boot/config.txt file. How can I do this easily? Do…
Xavier Nodet
  • 432
  • 1
  • 3
  • 10
16
votes
1 answer

Calibrate overscan settings

There are options to adjust the the overscan settings in /boot/config.txt. # uncomment this if your display has a black border of unused pixels visible # and your display can output without overscan disable_overscan=0 # uncomment the following to…
IQAndreas
  • 1,013
  • 3
  • 11
  • 12
15
votes
4 answers

Enabling ARMv8 on Raspberry Pi 3 B

According to this article I should be able to switch to ARMv8 on my Raspberry Pi Model 3B, but I'm getting "rainbow screen" after adding to config.txt the line: arm_control=0x200 Why is it not working? Is it even worth switching from ARMv7 to…
madneon
  • 529
  • 2
  • 5
  • 16
10
votes
2 answers

is dtoverlay a general linux concept or RPi specific?

With all the raspberry pi hats popping on and off, dtoverlay and /boot/config.txt is a very nice method to quickly tell the kernel that you've got new device tree information. But I've never seen this implemented on any other linux platforms,…
Sittin Hawk
  • 203
  • 1
  • 2
  • 5
9
votes
4 answers

config.txt : Hostname

As you might have guessed from the title, I would like to know if it is possible to change a RasPis hostname from the config.txt file on the SD card. I'm making a lot of SDs from a custom image, and obviously the hostnames collide when booting (they…
Jo Colina
  • 191
  • 1
  • 1
  • 4
9
votes
2 answers

Raspberry Pi 4 B GPIO boot and shutdown button(s)

I've been doing some research on power buttons for the Raspberry Pi, but I'm having quite a hard time finding information. Right now, I have button working on GPIO5, and when I connect it to the opposing GND pin, the Pi boots up. I added the line…
are_end
  • 199
  • 1
  • 1
  • 2
8
votes
2 answers

File config.txt with multiple lines is not working

I've been trying to get XBMC (Raspbmc to be exact) working om my Raspberry Pi. After hours of work and a lot of stupid mistakes (who knew FAT32 wasn't made for Linux), I made it work. But now I'm troubling with the screen being to big for my tv. So…
Rick Hoving
  • 657
  • 1
  • 8
  • 7
6
votes
1 answer

Unable to set GPU memory split on Raspberry Pi Zero W

I have looked everywhere (both on and off StackExchange) for this but cannot get an answer: I have a Raspberry Pi Zero W, which has 512MB of RAM total. I am running it headless, so I want to maximize available RAM. I have set gpu_mem=16 in the…
MrChips
  • 993
  • 1
  • 5
  • 11
6
votes
3 answers

Why do I not have a /boot/config.txt fle?

I have a Raspberry pi B, and downloaded and installed "2012-10-28-wheezy-raspbian.img." I am using a 3.5 inch VGA TFT-LCD monitor, where the tiny font was hard to read, but I have managed to increase it (thanks to recantha, who answered my question…
Harry Weston
  • 467
  • 2
  • 6
  • 16
6
votes
1 answer

Problems with Raspberry Pi Resolution

I recently purchased a Raspberry Pi and I hooked it up to my 22" Acer monitor. The monitor has a resolution of 1680x960. I tried several resolutions in the config.txt and some of them make the resolution default to the htmi_safe=1 resolution. Others…
Arvin Am
  • 171
  • 1
  • 4
6
votes
1 answer

HDMI output for 1080p

Need the right configuration to set the standards for the config.txt file to set an PAL LCD 1080p. I have tried hdmi_group set to 0, to use the preferred group. That tweak gave me sharp text although the LCD output in unscaled mode gave me a small…
nicoX
  • 303
  • 1
  • 4
  • 10
1
2 3
10 11