4 This directory contains Device Tree overlays. Device Tree makes it possible
5 to support many hardware configurations with a single kernel and without the
6 need to explicitly load or blacklist kernel modules. Note that this isn't a
7 "pure" Device Tree configuration (c.f. MACH_BCM2835) - some on-board devices
8 are still configured by the board support code, but the intention is to
9 eventually reach that goal.
11 On Raspberry Pi, Device Tree usage is controlled from /boot/config.txt. By
12 default, the Raspberry Pi kernel boots with device tree enabled. You can
13 completely disable DT usage (for now) by adding:
17 to your config.txt, which should cause your Pi to revert to the old way of
18 doing things after a reboot.
20 In /boot you will find a .dtb for each base platform. This describes the
21 hardware that is part of the Raspberry Pi board. The loader (start.elf and its
22 siblings) selects the .dtb file appropriate for the platform by name, and reads
23 it into memory. At this point, all of the optional interfaces (i2c, i2s, spi)
24 are disabled, but they can be enabled using Device Tree parameters:
26 dtparam=i2c=on,i2s=on,spi=on
28 However, this shouldn't be necessary in many use cases because loading an
29 overlay that requires one of those interfaces will cause it to be enabled
30 automatically, and it is advisable to only enable interfaces if they are
33 Configuring additional, optional hardware is done using Device Tree overlays
36 GPIO numbering uses the hardware pin numbering scheme (aka BCM scheme) and
37 not the physical pin numbers.
42 The Advanced Options section of the raspi-config utility can enable and disable
43 Device Tree use, as well as toggling the I2C and SPI interfaces. Note that it
44 is possible to both enable an interface and blacklist the driver, if for some
45 reason you should want to defer the loading.
50 As well as describing the hardware, Device Tree also gives enough information
51 to allow suitable driver modules to be located and loaded, with the corollary
52 that unneeded modules are not loaded. As a result it should be possible to
53 remove lines from /etc/modules, and /etc/modprobe.d/raspi-blacklist.conf can
54 have its contents deleted (or commented out).
59 Overlays are loaded using the "dtoverlay" config.txt setting. As an example,
60 consider I2C Real Time Clock drivers. In the pre-DT world these would be loaded
61 by writing a magic string comprising a device identifier and an I2C address to
62 a special file in /sys/class/i2c-adapter, having first loaded the driver for
63 the I2C interface and the RTC device - something like this:
67 echo ds1307 0x68 > /sys/class/i2c-adapter/i2c-1/new_device
69 With DT enabled, this becomes a line in config.txt:
71 dtoverlay=i2c-rtc,ds1307
73 This causes the file /boot/overlays/i2c-rtc.dtbo to be loaded and a "node"
74 describing the DS1307 I2C device to be added to the Device Tree for the Pi. By
75 default it usees address 0x68, but this can be modified with an additional DT
78 dtoverlay=i2c-rtc,ds1307,addr=0x68
80 Parameters usually have default values, although certain parameters are
81 mandatory. See the list of overlays below for a description of the parameters
84 Making new Overlays based on existing Overlays
85 ==============================================
87 Recent overlays have been designed in a more general way, so that they can be
88 adapted to hardware by changing their parameters. When you have additional
89 hardware with more than one device of a kind, you end up using the same overlay
90 multiple times with other parameters, e.g.
92 # 2 CAN FD interfaces on spi but with different pins
93 dtoverlay=mcp251xfd,spi0-0,interrupt=25
94 dtoverlay=mcp251xfd,spi0-1,interrupt=24
96 # a realtime clock on i2c
97 dtoverlay=i2c-rtc,pcf85063
99 While this approach does work, it requires knowledge about the hardware design.
100 It is more feasible to simplify things for the end user by providing a single
101 overlay as it is done the traditional way.
103 A new overlay can be generated by using ovmerge utility.
104 https://github.com/raspberrypi/utils/blob/master/ovmerge/ovmerge
106 To generate an overlay for the above configuration we pass the configuration
107 to ovmerge and add the -c flag.
109 ovmerge -c mcp251xfd-overlay.dts,spi0-0,interrupt=25 \
110 mcp251xfd-overlay.dts,spi0-1,interrupt=24 \
111 i2c-rtc-overlay.dts,pcf85063 \
112 >> merged-overlay.dts
114 The -c option writes the command above as a comment into the overlay as
115 a marker that this overlay is generated and how it was generated.
116 After compiling the overlay it can be loaded in a single line.
120 It does the same as the original configuration but without parameters.
122 The Overlay and Parameter Reference
123 ===================================
125 N.B. When editing this file, please preserve the indentation levels to make it
126 simple to parse programmatically. NO HARD TABS.
130 Info: Configures the base Raspberry Pi hardware
131 Load: <loaded automatically>
133 ant1 Select antenna 1 (default). CM4 only.
135 ant2 Select antenna 2. CM4 only.
137 noant Disable both antennas. CM4 only.
139 audio Set to "on" to enable the onboard ALSA audio
140 interface (default "off")
142 axiperf Set to "on" to enable the AXI bus performance
144 See /sys/kernel/debug/raspberrypi_axi_monitor
147 bdaddr Set an alternative Bluetooth address (BDADDR).
148 The value should be a 6-byte hexadecimal value,
149 with or without colon separators, written least-
150 significant-byte first. For example,
151 bdaddr=06:05:04:03:02:01
152 will set the BDADDR to 01:02:03:04:05:06.
154 button_debounce Set the debounce delay (in ms) on the power/
155 shutdown button (default 50ms)
157 cam0_reg Enables CAM 0 regulator.
158 Only required on CM1 & 3.
160 cam0_reg_gpio Set GPIO for CAM 0 regulator.
161 Default 31 on CM1, 3, and 4S.
162 Default of GPIO expander 5 on CM4, but override
163 switches to normal GPIO.
165 cam1_reg Enables CAM 1 regulator.
166 Only required on CM1 & 3.
168 cam1_reg_gpio Set GPIO for CAM 1 regulator.
169 Default 3 on CM1, 3, and 4S.
170 Default of GPIO expander 5 on CM4, but override
171 switches to normal GPIO.
173 cooling_fan Enables the Pi 5 cooling fan (enabled
174 automatically by the firmware)
176 drm_fb0_rp1_dpi Assign /dev/fb0 to the RP1 DPI output
178 drm_fb0_rp1_dsi0 Assign /dev/fb0 to the RP1 DSI0 output
180 drm_fb0_rp1_dsi1 Assign /dev/fb0 to the RP1 DSI1 output
182 drm_fb0_vc4 Assign /dev/fb0 to the vc4 outputs
184 drm_fb1_rp1_dpi Assign /dev/fb1 to the RP1 DPI output
186 drm_fb1_rp1_dsi0 Assign /dev/fb1 to the RP1 DSI0 output
188 drm_fb1_rp1_dsi1 Assign /dev/fb1 to the RP1 DSI1 output
190 drm_fb1_vc4 Assign /dev/fb1 to the vc4 outputs
192 drm_fb2_rp1_dpi Assign /dev/fb2 to the RP1 DPI output
194 drm_fb2_rp1_dsi0 Assign /dev/fb2 to the RP1 DSI0 output
196 drm_fb2_rp1_dsi1 Assign /dev/fb2 to the RP1 DSI1 output
198 drm_fb2_vc4 Assign /dev/fb2 to the vc4 outputs
200 eee Enable Energy Efficient Ethernet support for
201 compatible devices (default "on"). See also
202 "tx_lpi_timer". Pi3B+ only.
204 eth_downshift_after Set the number of auto-negotiation failures
205 after which the 1000Mbps modes are disabled.
206 Legal values are 2, 3, 4, 5 and 0, where
207 0 means never downshift (default 2). Pi3B+ only.
209 eth_led0 Set mode of LED0 - amber on Pi3B+ (default "1"),
210 green on Pi4 (default "0").
211 The legal values are:
215 0=link/activity 1=link1000/activity
216 2=link100/activity 3=link10/activity
217 4=link100/1000/activity 5=link10/1000/activity
218 6=link10/100/activity 14=off 15=on
222 0=Speed/Activity 1=Speed
223 2=Flash activity 3=FDX
228 eth_led1 Set mode of LED1 - green on Pi3B+ (default "6"),
229 amber on Pi4 (default "8"). See eth_led0 for
232 eth_max_speed Set the maximum speed a link is allowed
233 to negotiate. Legal values are 10, 100 and
234 1000 (default 1000). Pi3B+ only.
236 hdmi Set to "off" to disable the HDMI interface
239 i2c An alias for i2c_arm
241 i2c_arm Set to "on" to enable the ARM's i2c interface
244 i2c_arm_baudrate Set the baudrate of the ARM's i2c interface
247 i2c_baudrate An alias for i2c_arm_baudrate
249 i2c_csi_dsi Set to "on" to enable the i2c_csi_dsi interface
251 i2c_csi_dsi0 Set to "on" to enable the i2c_csi_dsi0 interface
253 i2c_csi_dsi1 Set to "on" to enable the i2c_csi_dsi1 interface
255 i2c_vc Set to "on" to enable the i2c interface
256 usually reserved for the VideoCore processor
259 i2c_vc_baudrate Set the baudrate of the VideoCore i2c interface
262 i2s Set to "on" to enable the i2s interface
265 i2s_dma4 Use to enable 40-bit DMA on the i2s interface
266 (the assigned value doesn't matter)
269 krnbt Set to "off" to disable autoprobing of Bluetooth
270 driver without need of hciattach/btattach
273 krnbt_baudrate Set the baudrate of the PL011 UART when used
276 nvme Alias for "pciex1" (2712 only)
278 pcie Set to "off" to disable the PCIe interface
280 (2711 only, but not applicable on CM4S)
281 N.B. USB-A ports on 4B are subsequently disabled
283 pcie_tperst_clk_ms Add N milliseconds between PCIe reference clock
284 activation and PERST# deassertion
285 (CM4 and 2712, default "0")
287 pciex1 Set to "on" to enable the external PCIe link
288 (2712 only, default "off")
290 pciex1_gen Sets the PCIe "GEN"/speed for the external PCIe
291 link (2712 only, default "2")
293 pciex1_no_l0s Set to "on" to disable ASPM L0s on the external
294 PCIe link for devices that have broken
295 implementations (2712 only, default "off")
297 pciex1_tperst_clk_ms Alias for pcie_tperst_clk_ms
298 (2712 only, default "0")
300 spi Set to "on" to enable the spi interfaces
303 spi_dma4 Use to enable 40-bit DMA on spi interfaces
304 (the assigned value doesn't matter)
307 random Set to "on" to enable the hardware random
308 number generator (default "on")
310 rtc_bbat_vchg Set the RTC backup battery charging voltage in
311 microvolts. If set to 0 or not specified, the
312 trickle charger is disabled.
313 (2712 only, default "0")
315 sd Set to "off" to disable the SD card (or eMMC on
316 non-lite SKU of CM4).
319 sd_overclock Clock (in MHz) to use when the MMC framework
322 sd_poll_once Looks for a card once after booting. Useful
323 for network booting scenarios to avoid the
324 overhead of continuous polling. N.B. Using
325 this option restricts the system to using a
326 single card per boot (or none at all).
329 sd_force_pio Disable DMA support for SD driver (default off)
331 sd_pio_limit Number of blocks above which to use DMA for
334 sd_debug Enable debug output from SD driver (default off)
336 sdio_overclock Clock (in MHz) to use when the MMC framework
337 requests 50MHz for the SDIO/WLAN interface.
339 suspend Make the power button trigger a suspend rather
340 than a power-off (2712 only, default "off")
342 tx_lpi_timer Set the delay in microseconds between going idle
343 and entering the low power state (default 600).
344 Requires EEE to be enabled - see "eee".
346 uart0 Set to "off" to disable uart0 (default "on")
348 uart0_console Move the kernel boot console to UART0 on pins
349 6, 8 and 10 of the 40-way header (2712 only,
352 uart1 Set to "on" or "off" to enable or disable uart1
355 watchdog Set to "on" to enable the hardware watchdog
358 wifiaddr Set an alternative WiFi MAC address.
359 The value should be a 6-byte hexadecimal value,
360 with or without colon separators, written in the
361 natural (big-endian) order.
363 act_led_trigger Choose which activity the LED tracks.
364 Use "heartbeat" for a nice load indicator.
367 act_led_activelow Set to "on" to invert the sense of the LED
369 N.B. For Pi 3B, 3B+, 3A+ and 4B, use the act-led
372 act_led_gpio Set which GPIO to use for the activity LED
373 (in case you want to connect it to an external
375 (default "16" on a non-Plus board, "47" on a
377 N.B. For Pi 3B, 3B+, 3A+ and 4B, use the act-led
383 As for act_led_*, but using the PWR LED.
384 Not available on Model A/B boards.
386 N.B. It is recommended to only enable those interfaces that are needed.
387 Leaving all interfaces enabled can lead to unwanted behaviour (i2c_vc
388 interfering with Pi Camera, I2S and SPI hogging GPIO pins, etc.)
389 Note also that i2c, i2c_arm and i2c_vc are aliases for the physical
390 interfaces i2c0 and i2c1. Use of the numeric variants is still possible
391 but deprecated because the ARM/VC assignments differ between board
392 revisions. The same board-specific mapping applies to i2c_baudrate,
393 and the other i2c baudrate parameters.
397 Info: Pi 3B, 3B+, 3A+ and 4B use a GPIO expander to drive the LEDs which can
398 only be accessed from the VPU. There is a special driver for this with a
399 separate DT node, which has the unfortunate consequence of breaking the
400 act_led_gpio and act_led_activelow dtparams.
401 This overlay changes the GPIO controller back to the standard one and
402 restores the dtparams.
403 Load: dtoverlay=act-led,<param>=<val>
404 Params: activelow Set to "on" to invert the sense of the LED
407 gpio Set which GPIO to use for the activity LED
408 (in case you want to connect it to an external
413 Name: adafruit-st7735r
414 Info: Overlay for the SPI-connected Adafruit 1.8" 160x128 or 128x128 displays,
415 based on the ST7735R chip.
416 This overlay uses the newer DRM/KMS "Tiny" driver.
417 Load: dtoverlay=adafruit-st7735r,<param>=<val>
418 Params: 128x128 Select the 128x128 driver (default 160x128)
419 rotate Display rotation {0,90,180,270} (default 90)
420 speed SPI bus speed in Hz (default 4000000)
421 dc_pin GPIO pin for D/C (default 24)
422 reset_pin GPIO pin for RESET (default 25)
423 led_pin GPIO used to control backlight (default 18)
427 Info: Overlay for the SPI-connected Adafruit 1.8" display (based on the
428 ST7735R chip). It includes support for the "green tab" version.
429 This overlay uses the older fbtft driver.
430 Load: dtoverlay=adafruit18,<param>=<val>
431 Params: green Use the adafruit18_green variant.
432 rotate Display rotation {0,90,180,270}
433 speed SPI bus speed in Hz (default 4000000)
434 fps Display frame rate in Hz
435 bgr Enable BGR mode (default off)
436 debug Debug output level {0-7}
437 dc_pin GPIO pin for D/C (default 24)
438 reset_pin GPIO pin for RESET (default 25)
439 led_pin GPIO used to control backlight (default 18)
443 Info: Overlay for activation of ADAU1977 ADC codec over I2C for control
445 Load: dtoverlay=adau1977-adc
449 Name: adau7002-simple
450 Info: Overlay for the activation of ADAU7002 stereo PDM to I2S converter.
451 Load: dtoverlay=adau7002-simple,<param>=<val>
452 Params: card-name Override the default, "adau7002", card name.
456 Info: Overlay for activation of Texas Instruments ADS1015 ADC over I2C
457 Load: dtoverlay=ads1015,<param>=<val>
458 Params: addr I2C bus address of device. Set based on how the
459 addr pin is wired. (default=0x48 assumes addr
461 cha_enable Enable virtual channel a. (default=true)
462 cha_cfg Set the configuration for virtual channel a.
463 (default=4 configures this channel for the
464 voltage at A0 with respect to GND)
465 cha_datarate Set the datarate (samples/sec) for this channel.
466 (default=4 sets 1600 sps)
467 cha_gain Set the gain of the Programmable Gain
468 Amplifier for this channel. (default=2 sets the
469 full scale of the channel to 2.048 Volts)
471 Channel (ch) parameters can be set for each enabled channel.
472 A maximum of 4 channels can be enabled (letters a thru d).
473 For more information refer to the device datasheet at:
474 http://www.ti.com/lit/ds/symlink/ads1015.pdf
478 Info: Texas Instruments ADS1115 ADC
479 Load: dtoverlay=ads1115,<param>[=<val>]
480 Params: addr I2C bus address of device. Set based on how the
481 addr pin is wired. (default=0x48 assumes addr
483 cha_enable Enable virtual channel a.
484 cha_cfg Set the configuration for virtual channel a.
485 (default=4 configures this channel for the
486 voltage at A0 with respect to GND)
487 cha_datarate Set the datarate (samples/sec) for this channel.
488 (default=7 sets 860 sps)
489 cha_gain Set the gain of the Programmable Gain
490 Amplifier for this channel. (Default 1 sets the
491 full scale of the channel to 4.096 Volts)
492 i2c0 Choose the I2C0 bus on GPIOs 0&1
493 i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
494 i2c3 Choose the I2C3 bus (configure with the i2c3
495 overlay - BCM2711 only)
496 i2c4 Choose the I2C4 bus (configure with the i2c4
497 overlay - BCM2711 only)
498 i2c5 Choose the I2C5 bus (configure with the i2c5
499 overlay - BCM2711 only)
500 i2c6 Choose the I2C6 bus (configure with the i2c6
501 overlay - BCM2711 only)
503 Channel parameters can be set for each enabled channel.
504 A maximum of 4 channels can be enabled (letters a thru d).
505 For more information refer to the device datasheet at:
506 http://www.ti.com/lit/ds/symlink/ads1115.pdf
510 Info: ADS7846 Touch controller
511 Load: dtoverlay=ads7846,<param>=<val>
512 Params: cs SPI bus Chip Select (default 1)
513 speed SPI bus speed (default 2MHz, max 3.25MHz)
514 penirq GPIO used for PENIRQ. REQUIRED
515 penirq_pull Set GPIO pull (default 0=none, 2=pullup)
516 swapxy Swap x and y axis
517 xmin Minimum value on the X axis (default 0)
518 ymin Minimum value on the Y axis (default 0)
519 xmax Maximum value on the X axis (default 4095)
520 ymax Maximum value on the Y axis (default 4095)
521 pmin Minimum reported pressure value (default 0)
522 pmax Maximum reported pressure value (default 65535)
523 xohms Touchpanel sensitivity (X-plate resistance)
526 penirq is required and usually xohms (60-100) has to be set as well.
527 Apart from that, pmax (255) and swapxy are also common.
528 The rest of the calibration can be done with xinput-calibrator.
529 See: github.com/notro/fbtft/wiki/FBTFT-on-Raspian
530 Device Tree binding document:
531 www.kernel.org/doc/Documentation/devicetree/bindings/input/ads7846.txt
535 Info: Analog Devices ADV7282M analogue video to CSI2 bridge.
536 Uses Unicam1, which is the standard camera connector on most Pi
538 Load: dtoverlay=adv7282m,<param>=<val>
539 Params: addr Overrides the I2C address (default 0x21)
540 media-controller Configure use of Media Controller API for
541 configuring the sensor (default off)
545 Info: Analog Devices ADV728[0|1|2]-M analogue video to CSI2 bridges.
546 This is a wrapper for adv7282m, and defaults to ADV7282M.
547 Load: dtoverlay=adv728x-m,<param>=<val>
548 Params: addr Overrides the I2C address (default 0x21)
549 adv7280m Select ADV7280-M.
550 adv7281m Select ADV7281-M.
551 adv7281ma Select ADV7281-MA.
552 media-controller Configure use of Media Controller API for
553 configuring the sensor (default off)
556 Name: akkordion-iqdacplus
557 Info: Configures the Digital Dreamtime Akkordion Music Player (based on the
558 OEM IQAudIO DAC+ or DAC Zero module).
559 Load: dtoverlay=akkordion-iqdacplus,<param>=<val>
560 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
561 Digital volume control. Enable with
562 dtoverlay=akkordion-iqdacplus,24db_digital_gain
563 (The default behaviour is that the Digital
564 volume control is limited to a maximum of
565 0dB. ie. it can attenuate but not provide
566 gain. For most users, this will be desired
567 as it will prevent clipping. By appending
568 the 24db_digital_gain parameter, the Digital
569 volume control will allow up to 24dB of
570 gain. If this parameter is enabled, it is the
571 responsibility of the user to ensure that
572 the Digital volume control is set to a value
573 that does not result in clipping/distortion!)
576 Name: allo-boss-dac-pcm512x-audio
577 Info: Configures the Allo Boss DAC audio cards.
578 Load: dtoverlay=allo-boss-dac-pcm512x-audio,<param>
579 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
580 Digital volume control. Enable with
581 "dtoverlay=allo-boss-dac-pcm512x-audio,
583 (The default behaviour is that the Digital
584 volume control is limited to a maximum of
585 0dB. ie. it can attenuate but not provide
586 gain. For most users, this will be desired
587 as it will prevent clipping. By appending
588 the 24db_digital_gain parameter, the Digital
589 volume control will allow up to 24dB of
590 gain. If this parameter is enabled, it is the
591 responsibility of the user to ensure that
592 the Digital volume control is set to a value
593 that does not result in clipping/distortion!)
594 slave Force Boss DAC into slave mode, using Pi a
595 master for bit clock and frame clock. Enable
596 with "dtoverlay=allo-boss-dac-pcm512x-audio,
600 Name: allo-boss2-dac-audio
601 Info: Configures the Allo Boss2 DAC audio card
602 Load: dtoverlay=allo-boss2-dac-audio
607 Info: Configures the Allo Digione audio card
608 Load: dtoverlay=allo-digione
612 Name: allo-katana-dac-audio
613 Info: Configures the Allo Katana DAC audio card
614 Load: dtoverlay=allo-katana-dac-audio
618 Name: allo-piano-dac-pcm512x-audio
619 Info: Configures the Allo Piano DAC (2.0/2.1) audio cards.
620 (NB. This initial support is for 2.0 channel audio ONLY! ie. stereo.
621 The subwoofer outputs on the Piano 2.1 are not currently supported!)
622 Load: dtoverlay=allo-piano-dac-pcm512x-audio,<param>
623 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
624 Digital volume control.
625 (The default behaviour is that the Digital
626 volume control is limited to a maximum of
627 0dB. ie. it can attenuate but not provide
628 gain. For most users, this will be desired
629 as it will prevent clipping. By appending
630 the 24db_digital_gain parameter, the Digital
631 volume control will allow up to 24dB of
632 gain. If this parameter is enabled, it is the
633 responsibility of the user to ensure that
634 the Digital volume control is set to a value
635 that does not result in clipping/distortion!)
638 Name: allo-piano-dac-plus-pcm512x-audio
639 Info: Configures the Allo Piano DAC (2.1) audio cards.
640 Load: dtoverlay=allo-piano-dac-plus-pcm512x-audio,<param>
641 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
642 Digital volume control.
643 (The default behaviour is that the Digital
644 volume control is limited to a maximum of
645 0dB. ie. it can attenuate but not provide
646 gain. For most users, this will be desired
647 as it will prevent clipping. By appending
648 the 24db_digital_gain parameter, the Digital
649 volume control will allow up to 24dB of
650 gain. If this parameter is enabled, it is the
651 responsibility of the user to ensure that
652 the Digital volume control is set to a value
653 that does not result in clipping/distortion!)
654 glb_mclk This option is only with Kali board. If enabled,
655 MCLK for Kali is used and PLL is disabled for
656 better voice quality. (default Off)
660 Info: Universal device tree overlay for SPI devices
662 Just specify the SPI address and device name ("compatible" property).
663 This overlay lacks any device-specific parameter support!
665 For devices on spi1 or spi2, the interfaces should be enabled
666 with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
669 1. SPI NOR flash on spi0.1, maximum SPI clock frequency 45MHz:
670 dtoverlay=anyspi:spi0-1,dev="jedec,spi-nor",speed=45000000
671 2. MCP3204 ADC on spi1.2, maximum SPI clock frequency 500kHz:
672 dtoverlay=anyspi:spi1-2,dev="microchip,mcp3204"
673 Load: dtoverlay=anyspi,<param>=<val>
674 Params: spi<n>-<m> Configure device at spi<n>, cs<m>
676 dev Set device name to search compatible module
678 speed Set SPI clock frequency in Hz
679 (integer, optional, default 500000)
683 Info: Configures the AVAGO APDS9960 digital proximity, ambient light, RGB and
685 Load: dtoverlay=apds9960,<param>=<val>
686 Params: gpiopin GPIO used for INT (default 4)
687 noints Disable the interrupt GPIO line.
691 Info: Configures the Orchard Audio ApplePi-DAC audio card
692 Load: dtoverlay=applepi-dac
697 Info: Arducam 64MP camera module.
698 Uses Unicam 1, which is the standard camera connector on most Pi
700 Load: dtoverlay=arducam-64mp,<param>=<val>
701 Params: rotation Mounting rotation of the camera sensor (0 or
703 orientation Sensor orientation (0 = front, 1 = rear,
704 2 = external, default external)
705 media-controller Configure use of Media Controller API for
706 configuring the sensor (default on)
707 cam0 Adopt the default configuration for CAM0 on a
708 Compute Module (CSI0, i2c_vc, and cam0_reg).
709 vcm Select lens driver state. Default is enabled,
710 but vcm=off will disable.
713 Name: arducam-pivariety
714 Info: Arducam Pivariety camera module.
715 Uses Unicam 1, which is the standard camera connector on most Pi
717 Load: dtoverlay=arducam-pivariety,<param>=<val>
718 Params: rotation Mounting rotation of the camera sensor (0 or
720 orientation Sensor orientation (0 = front, 1 = rear,
721 2 = external, default external)
722 media-controller Configure use of Media Controller API for
723 configuring the sensor (default on)
724 cam0 Adopt the default configuration for CAM0 on a
725 Compute Module (CSI0, i2c_vc, and cam0_reg).
729 Info: Configures the Atmel AT86RF233 802.15.4 low-power WPAN transceiver,
731 Load: dtoverlay=at86rf233,<param>=<val>
732 Params: interrupt GPIO used for INT (default 23)
733 reset GPIO used for Reset (default 24)
734 sleep GPIO used for Sleep (default 25)
735 speed SPI bus speed in Hz (default 3000000)
736 trim Fine tuning of the internal capacitance
737 arrays (0=+0pF, 15=+4.5pF, default 15)
740 Name: audioinjector-addons
741 Info: Configures the audioinjector.net audio add on soundcards
742 Load: dtoverlay=audioinjector-addons,<param>=<val>
743 Params: non-stop-clocks Keeps the clocks running even when the stream
744 is paused or stopped (default off)
747 Name: audioinjector-bare-i2s
748 Info: Configures the audioinjector.net audio bare i2s soundcard
749 Load: dtoverlay=audioinjector-bare-i2s
753 Name: audioinjector-isolated-soundcard
754 Info: Configures the audioinjector.net isolated soundcard
755 Load: dtoverlay=audioinjector-isolated-soundcard
759 Name: audioinjector-ultra
760 Info: Configures the audioinjector.net ultra soundcard
761 Load: dtoverlay=audioinjector-ultra
765 Name: audioinjector-wm8731-audio
766 Info: Configures the audioinjector.net audio add on soundcard
767 Load: dtoverlay=audioinjector-wm8731-audio
772 Info: Configures the audiosense-pi add on soundcard
773 For more information refer to
774 https://gitlab.com/kakar0t/audiosense-pi
775 Load: dtoverlay=audiosense-pi
780 Info: Switches PWM sound output to GPIOs on the 40-pin header
781 Load: dtoverlay=audremap,<param>=<val>
782 Params: swap_lr Reverse the channel allocation, which will also
783 swap the audio jack outputs (default off)
784 enable_jack Don't switch off the audio jack output. Does
785 nothing on BCM2711 (default off)
786 pins_12_13 Select GPIOs 12 & 13 (default)
787 pins_18_19 Select GPIOs 18 & 19
788 pins_40_41 Select GPIOs 40 & 41 (not available on CM4, used
790 pins_40_45 Select GPIOs 40 & 45 (don't use on BCM2711 - the
791 pins are on different controllers)
795 Info: Overlay that enables WLAN, Bluetooth and the GPIO expander on the
796 balenaFin carrier board for the Raspberry Pi Compute Module 3/3+ Lite.
797 Load: dtoverlay=balena-fin
801 Name: bmp085_i2c-sensor
802 Info: This overlay is now deprecated - see i2c-sensor
806 Name: camera-mux-2port
807 Info: Configures a 2 port camera multiplexer
808 Note that currently ALL IMX290 modules share a common clock, therefore
809 all modules will need to have the same clock frequency.
810 Load: dtoverlay=camera-mux-2port,<param>=<val>
811 Params: cam0-arducam-64mp Select Arducam64MP for camera on port 0
812 cam0-imx219 Select IMX219 for camera on port 0
813 cam0-imx258 Select IMX258 for camera on port 0
814 cam0-imx290 Select IMX290 for camera on port 0
815 cam0-imx477 Select IMX477 for camera on port 0
816 cam0-imx519 Select IMX519 for camera on port 0
817 cam0-imx708 Select IMX708 for camera on port 0
818 cam0-ov2311 Select OV2311 for camera on port 0
819 cam0-ov5647 Select OV5647 for camera on port 0
820 cam0-ov7251 Select OV7251 for camera on port 0
821 cam0-ov9281 Select OV9281 for camera on port 0
822 cam0-imx290-clk-freq Set clock frequency for an IMX290 on port 0
823 cam1-arducam-64mp Select Arducam64MP for camera on port 1
824 cam1-imx219 Select IMX219 for camera on port 1
825 cam1-imx258 Select IMX258 for camera on port 1
826 cam1-imx290 Select IMX290 for camera on port 1
827 cam1-imx477 Select IMX477 for camera on port 1
828 cam1-imx519 Select IMX519 for camera on port 1
829 cam1-imx708 Select IMX708 for camera on port 1
830 cam1-ov2311 Select OV2311 for camera on port 1
831 cam1-ov5647 Select OV5647 for camera on port 1
832 cam1-ov7251 Select OV7251 for camera on port 1
833 cam1-ov9281 Select OV9281 for camera on port 1
834 cam1-imx290-clk-freq Set clock frequency for an IMX290 on port 1
836 cam0 Connect the mux to CAM0 port (default is CAM1)
839 Name: camera-mux-4port
840 Info: Configures a 4 port camera multiplexer
841 Note that currently ALL IMX290 modules share a common clock, therefore
842 all modules will need to have the same clock frequency.
843 Load: dtoverlay=camera-mux-4port,<param>=<val>
844 Params: cam0-arducam-64mp Select Arducam64MP for camera on port 0
845 cam0-imx219 Select IMX219 for camera on port 0
846 cam0-imx258 Select IMX258 for camera on port 0
847 cam0-imx290 Select IMX290 for camera on port 0
848 cam0-imx477 Select IMX477 for camera on port 0
849 cam0-imx519 Select IMX519 for camera on port 0
850 cam0-imx708 Select IMX708 for camera on port 0
851 cam0-ov2311 Select OV2311 for camera on port 0
852 cam0-ov5647 Select OV5647 for camera on port 0
853 cam0-ov7251 Select OV7251 for camera on port 0
854 cam0-ov9281 Select OV9281 for camera on port 0
855 cam0-imx290-clk-freq Set clock frequency for an IMX290 on port 0
856 cam1-arducam-64mp Select Arducam64MP for camera on port 1
857 cam1-imx219 Select IMX219 for camera on port 1
858 cam1-imx258 Select IMX258 for camera on port 1
859 cam1-imx290 Select IMX290 for camera on port 1
860 cam1-imx477 Select IMX477 for camera on port 1
861 cam1-imx519 Select IMX519 for camera on port 1
862 cam1-imx708 Select IMX708 for camera on port 1
863 cam1-ov2311 Select OV2311 for camera on port 1
864 cam1-ov5647 Select OV5647 for camera on port 1
865 cam1-ov7251 Select OV7251 for camera on port 1
866 cam1-ov9281 Select OV9281 for camera on port 1
867 cam1-imx290-clk-freq Set clock frequency for an IMX290 on port 1
868 cam2-arducam-64mp Select Arducam64MP for camera on port 2
869 cam2-imx219 Select IMX219 for camera on port 2
870 cam2-imx258 Select IMX258 for camera on port 2
871 cam2-imx290 Select IMX290 for camera on port 2
872 cam2-imx477 Select IMX477 for camera on port 2
873 cam2-imx519 Select IMX519 for camera on port 2
874 cam2-imx708 Select IMX708 for camera on port 2
875 cam2-ov2311 Select OV2311 for camera on port 2
876 cam2-ov5647 Select OV5647 for camera on port 2
877 cam2-ov7251 Select OV7251 for camera on port 2
878 cam2-ov9281 Select OV9281 for camera on port 2
879 cam2-imx290-clk-freq Set clock frequency for an IMX290 on port 2
880 cam3-arducam-64mp Select Arducam64MP for camera on port 3
881 cam3-imx219 Select IMX219 for camera on port 3
882 cam3-imx258 Select IMX258 for camera on port 3
883 cam3-imx290 Select IMX290 for camera on port 3
884 cam3-imx477 Select IMX477 for camera on port 3
885 cam3-imx519 Select IMX519 for camera on port 3
886 cam3-imx708 Select IMX708 for camera on port 3
887 cam3-ov2311 Select OV2311 for camera on port 3
888 cam3-ov5647 Select OV5647 for camera on port 3
889 cam3-ov7251 Select OV7251 for camera on port 3
890 cam3-ov9281 Select OV9281 for camera on port 3
891 cam3-imx290-clk-freq Set clock frequency for an IMX290 on port 3
893 cam0 Connect the mux to CAM0 port (default is CAM1)
897 Info: Enables the ability to use the cap1106 touch sensor as a keyboard
898 Load: dtoverlay=cap1106,<param>=<val>
899 Params: int_pin GPIO pin for interrupt signal (default 23)
903 Info: Configures Chip Dip audio cards.
904 Load: dtoverlay=chipdip-dac
909 Info: Configures the Cirrus Logic Audio Card
910 Load: dtoverlay=cirrus-wm5102
915 Info: Largely for Compute Modules 1&3 where the original instructions for
916 adding a camera used GPIOs 0&1 for CAM1 and 28&29 for CAM0, whilst all
917 other platforms use 28&29 (or 44&45) for CAM1.
918 The default assignment through using this overlay is for
919 i2c0 to use 28&29, and i2c10 (aka i2c_csi_dsi) to use 28&29, but the
920 overrides allow this to be changed.
921 Load: dtoverlay=cm-swap-i2c0,<param>=<val>
922 Params: i2c0-gpio0 Use GPIOs 0&1 for i2c0
923 i2c0-gpio28 Use GPIOs 28&29 for i2c0 (default)
924 i2c0-gpio44 Use GPIOs 44&45 for i2c0
925 i2c10-gpio0 Use GPIOs 0&1 for i2c0 (default)
926 i2c10-gpio28 Use GPIOs 28&29 for i2c0
927 i2c10-gpio44 Use GPIOs 44&45 for i2c0
931 Info: Set custom CMA sizes, only use if you know what you are doing, might
932 clash with other overlays like vc4-fkms-v3d and vc4-kms-v3d.
933 Load: dtoverlay=cma,<param>=<val>
934 Params: cma-512 CMA is 512MB (needs 1GB)
935 cma-448 CMA is 448MB (needs 1GB)
936 cma-384 CMA is 384MB (needs 1GB)
937 cma-320 CMA is 320MB (needs 1GB)
938 cma-256 CMA is 256MB (needs 1GB)
939 cma-192 CMA is 192MB (needs 1GB)
943 cma-size CMA size in bytes, 4MB aligned
944 cma-default Use upstream's default value
947 Name: crystalfontz-cfa050_pi_m
948 Info: Configures the Crystalfontz CFA050-PI-M series of Raspberry Pi CM4
949 based modules using the CFA7201280A0_050Tx 7" TFT LCD displays,
950 with or without capacitive touch screen.
951 Requires use of vc4-kms-v3d.
952 Load: dtoverlay=crystalfontz-cfa050_pi_m,<param>=<val>
953 Params: captouch Enable capacitive touch display
957 Info: 8" TFT LCD display and touch panel used by cutiepi.io
958 Load: dtoverlay=cutiepi-panel
963 Info: Configures the dacberry400 add on soundcard
964 Load: dtoverlay=dacberry400
969 Info: Overlay for the DHT11/DHT21/DHT22 humidity/temperature sensors
970 Also sometimes found with the part number(s) AM230x.
971 Load: dtoverlay=dht11,<param>=<val>
972 Params: gpiopin GPIO connected to the sensor's DATA output.
977 Info: Configures the Dion Audio KIWI STREAMER
978 Load: dtoverlay=dionaudio-kiwi
983 Info: Configures the Dion Audio LOCO DAC-AMP
984 Load: dtoverlay=dionaudio-loco
988 Name: dionaudio-loco-v2
989 Info: Configures the Dion Audio LOCO-V2 DAC-AMP
990 Load: dtoverlay=dionaudio-loco-v2,<param>=<val>
991 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
992 Digital volume control. Enable with
993 "dtoverlay=hifiberry-dacplus,24db_digital_gain"
994 (The default behaviour is that the Digital
995 volume control is limited to a maximum of
996 0dB. ie. it can attenuate but not provide
997 gain. For most users, this will be desired
998 as it will prevent clipping. By appending
999 the 24dB_digital_gain parameter, the Digital
1000 volume control will allow up to 24dB of
1001 gain. If this parameter is enabled, it is the
1002 responsibility of the user to ensure that
1003 the Digital volume control is set to a value
1004 that does not result in clipping/distortion!)
1008 Info: Disable onboard Bluetooth on Bluetooth-capable Raspberry Pis. On Pis
1009 prior to Pi 5 this restores UART0/ttyAMA0 over GPIOs 14 & 15.
1010 Load: dtoverlay=disable-bt
1014 Name: disable-bt-pi5
1015 Info: See disable-bt
1019 Info: Disable EMMC2 controller on BCM2711.
1020 The allows the onboard EMMC storage on Compute Module 4 to be disabled
1021 e.g. if a fault has occurred.
1022 Load: dtoverlay=disable-emmc2
1027 Info: Disable onboard WLAN on WiFi-capable Raspberry Pis.
1028 Load: dtoverlay=disable-wifi
1032 Name: disable-wifi-pi5
1033 Info: See disable-wifi
1037 Info: Overlay for a generic 18-bit DPI display
1038 This uses GPIOs 0-21 (so no I2C, uart etc.), and activates the output
1039 2-3 seconds after the kernel has started.
1040 Load: dtoverlay=dpi18
1045 Info: Overlay for a generic 18-bit DPI display (in 'mode 6' connection scheme)
1046 This uses GPIOs 0-9,12-17,20-25 (so no I2C, uart etc.), and activates
1047 the output 3-3 seconds after the kernel has started.
1048 Load: dtoverlay=dpi18cpadhi
1053 Info: Overlay for a generic 24-bit DPI display
1054 This uses GPIOs 0-27 (so no I2C, uart etc.), and activates the output
1055 2-3 seconds after the kernel has started.
1056 Load: dtoverlay=dpi24
1061 Info: Configures the NW Digital Radio DRAWS Hat
1063 The board includes an ADC to measure various board values and also
1064 provides two analog user inputs on the expansion header. The ADC
1065 can be configured for various sample rates and gain values to adjust
1066 the input range. Tables describing the two parameters follow.
1078 ADC Datarate Values:
1083 4 = 1600sps (default)
1087 Load: dtoverlay=draws,<param>=<val>
1088 Params: draws_adc_ch4_gain Sets the full scale resolution of the ADCs
1089 input voltage sensor (default 1)
1091 draws_adc_ch4_datarate Sets the datarate of the ADCs input voltage
1094 draws_adc_ch5_gain Sets the full scale resolution of the ADCs
1095 5V rail voltage sensor (default 1)
1097 draws_adc_ch5_datarate Sets the datarate of the ADCs 4V rail voltage
1100 draws_adc_ch6_gain Sets the full scale resolution of the ADCs
1101 AIN2 input (default 2)
1103 draws_adc_ch6_datarate Sets the datarate of the ADCs AIN2 input
1105 draws_adc_ch7_gain Sets the full scale resolution of the ADCs
1106 AIN3 input (default 2)
1108 draws_adc_ch7_datarate Sets the datarate of the ADCs AIN3 input
1110 alsaname Name of the ALSA audio device (default "draws")
1114 Info: Selects the dwc_otg USB controller driver which has fiq support. This
1115 is the default on all except the Pi Zero which defaults to dwc2.
1116 Load: dtoverlay=dwc-otg
1121 Info: Selects the dwc2 USB controller driver
1122 Load: dtoverlay=dwc2,<param>=<val>
1123 Params: dr_mode Dual role mode: "host", "peripheral" or "otg"
1125 g-rx-fifo-size Size of rx fifo size in gadget mode
1127 g-np-tx-fifo-size Size of non-periodic tx fifo size in gadget
1132 Info: See dwc2 (this is the Pi 5 version)
1135 [ The ds1307-rtc overlay has been deleted. See i2c-rtc. ]
1139 Info: Overlay for the EDT FT5406 touchscreen.
1140 This works with the Raspberry Pi 7" touchscreen when not being polled
1142 By default the overlay uses the i2c_csi_dsi I2C interface, but this
1144 You MUST use either "disable_touchscreen=1" or "ignore_lcd=1" in
1145 config.txt to stop the firmware polling the touchscreen.
1146 Load: dtoverlay=edt-ft5406,<param>=<val>
1147 Params: sizex Touchscreen size x (default 800)
1148 sizey Touchscreen size y (default 480)
1149 invx Touchscreen inverted x axis
1150 invy Touchscreen inverted y axis
1151 swapxy Touchscreen swapped x y axis
1152 i2c0 Choose the I2C0 bus on GPIOs 0&1
1153 i2c1 Choose the I2C1 bus on GPIOs 2&3
1154 i2c3 Choose the I2C3 bus (configure with the i2c3
1155 overlay - BCM2711 only)
1156 i2c4 Choose the I2C4 bus (configure with the i2c4
1157 overlay - BCM2711 only)
1158 i2c5 Choose the I2C5 bus (configure with the i2c5
1159 overlay - BCM2711 only)
1160 i2c6 Choose the I2C6 bus (configure with the i2c6
1161 overlay - BCM2711 only)
1162 addr Sets the address for the touch controller. Note
1163 that the device must be configured to use the
1168 Info: Overlay for the Microchip ENC28J60 Ethernet Controller on SPI0
1169 Load: dtoverlay=enc28j60,<param>=<val>
1170 Params: int_pin GPIO used for INT (default 25)
1172 speed SPI bus speed (default 12000000)
1176 Info: Overlay for the Microchip ENC28J60 Ethernet Controller on SPI2
1177 Load: dtoverlay=enc28j60-spi2,<param>=<val>
1178 Params: int_pin GPIO used for INT (default 39)
1180 speed SPI bus speed (default 12000000)
1184 Info: Enables I2C connected EETI EXC3000 multiple touch controller using
1185 GPIO 4 (pin 7 on GPIO header) for interrupt.
1186 Load: dtoverlay=exc3000,<param>=<val>
1187 Params: interrupt GPIO used for interrupt (default 4)
1188 sizex Touchscreen size x (default 4096)
1189 sizey Touchscreen size y (default 4096)
1190 invx Touchscreen inverted x axis
1191 invy Touchscreen inverted y axis
1192 swapxy Touchscreen swapped x y axis
1196 Info: Overlay for SPI-connected displays using the fbtft drivers.
1198 This overlay seeks to replace the functionality provided by fbtft_device
1199 which is now gone from the kernel.
1201 Most displays from fbtft_device have been ported over.
1203 dtoverlay=fbtft,spi0-0,rpi-display,reset_pin=23,dc_pin=24,led_pin=18,rotate=270
1205 It is also possible to specify the controller (this will use the default
1206 init sequence in the driver).
1208 dtoverlay=fbtft,spi0-0,ili9341,bgr,reset_pin=23,dc_pin=24,led_pin=18,rotate=270
1210 For devices on spi1 or spi2, the interfaces should be enabled
1211 with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
1213 The following features of fbtft_device have not been ported over:
1214 - parallel bus is not supported
1215 - the init property which overrides the controller initialization
1216 sequence is not supported as a parameter due to memory limitations in
1217 the bootloader responsible for applying the overlay.
1219 See https://github.com/notro/fbtft/wiki/FBTFT-RPI-overlays for how to
1222 Load: dtoverlay=fbtft,<param>=<val>
1224 spi<n>-<m> Configure device at spi<n>, cs<m>
1226 speed SPI bus speed in Hz (default 32000000)
1227 cpha Shifted clock phase (CPHA) mode
1228 cpol Inverse clock polarity (CPOL) mode
1230 adafruit18 Adafruit 1.8
1231 adafruit22 Adafruit 2.2 (old)
1232 adafruit22a Adafruit 2.2
1233 adafruit28 Adafruit 2.8
1234 adafruit13m Adafruit 1.3 OLED
1235 admatec_c-berry28 C-Berry28
1237 er_tftm050_2 ER-TFTM070-2
1238 er_tftm070_5 ER-TFTM070-5
1240 ew24ha0_9bit EW24HA0 in 9-bit mode
1241 freetronicsoled128 Freetronics OLED128
1244 itdb28_spi ITDB02-2.8 with SPI interface circuit
1245 mi0283qt-2 Watterott MI0283QT-2
1246 mi0283qt-9a Watterott MI0283QT-9A
1247 nokia3310 Nokia 3310
1248 nokia3310a Nokia 3310a
1249 nokia5110 Nokia 5110
1251 pitft Adafruit PiTFT 2.8
1253 rpi-display Watterott rpi-display
1254 sainsmart18 Sainsmart 1.8
1255 sainsmart32_spi Sainsmart 3.2 with SPI interfce circuit
1256 tinylcd35 TinyLCD 3.5
1257 tm022hdh26 Tianma TM022HDH26
1258 tontec35_9481 Tontect 3.5 with ILI9481 controller
1259 tontec35_9486 Tontect 3.5 with ILI9486 controller
1260 waveshare32b Waveshare 3.2
1261 waveshare22 Waveshare 2.2
1263 bd663474 BD663474 display controller
1264 hx8340bn HX8340BN display controller
1265 hx8347d HX8347D display controller
1266 hx8353d HX8353D display controller
1267 hx8357d HX8357D display controller
1268 ili9163 ILI9163 display controller
1269 ili9320 ILI9320 display controller
1270 ili9325 ILI9325 display controller
1271 ili9340 ILI9340 display controller
1272 ili9341 ILI9341 display controller
1273 ili9481 ILI9481 display controller
1274 ili9486 ILI9486 display controller
1275 pcd8544 PCD8544 display controller
1276 ra8875 RA8875 display controller
1277 s6d02a1 S6D02A1 display controller
1278 s6d1121 S6D1121 display controller
1279 seps525 SEPS525 display controller
1280 sh1106 SH1106 display controller
1281 ssd1289 SSD1289 display controller
1282 ssd1305 SSD1305 display controller
1283 ssd1306 SSD1306 display controller
1284 ssd1325 SSD1325 display controller
1285 ssd1331 SSD1331 display controller
1286 ssd1351 SSD1351 display controller
1287 st7735r ST7735R display controller
1288 st7789v ST7789V display controller
1289 tls8204 TLS8204 display controller
1290 uc1611 UC1611 display controller
1291 uc1701 UC1701 display controller
1292 upd161704 UPD161704 display controller
1294 width Display width in pixels
1295 height Display height in pixels
1296 regwidth Display controller register width (default is
1298 buswidth Display bus interface width (default 8)
1299 debug Debug output level {0-7}
1300 rotate Display rotation {0, 90, 180, 270} (counter
1301 clockwise). Not supported by all drivers.
1302 bgr Enable BGR mode (default off). Use if Red and
1303 Blue are swapped. Not supported by all drivers.
1304 fps Frames per second (default 30). In effect this
1305 states how long the driver will wait after video
1306 memory has been changed until display update
1307 transfer is started.
1308 txbuflen Length of the FBTFT transmit buffer
1310 startbyte Sets the Start byte used by fb_ili9320,
1311 fb_ili9325 and fb_hx8347d. Common value is 0x70.
1312 gamma String representation of Gamma Curve(s). Driver
1313 specific. Not supported by all drivers.
1314 reset_pin GPIO pin for RESET
1315 dc_pin GPIO pin for D/C
1316 led_pin GPIO pin for LED backlight
1320 Info: Configures the Fe-Pi Audio Sound Card
1321 Load: dtoverlay=fe-pi-audio
1326 Info: A demonstration of the gpio-fsm driver. The GPIOs are chosen to work
1327 nicely with a "traffic-light" display of red, amber and green LEDs on
1328 GPIOs 7, 8 and 25 respectively.
1329 Load: dtoverlay=fsm-demo,<param>=<val>
1330 Params: fsm_debug Enable debug logging (default off)
1334 Info: Enables GalaxyCore's GC9A01 single chip driver based displays on
1335 SPI0 as fb1, using GPIOs DC=25, RST=27 and BL=18 (physical
1336 GPIO header pins 22, 13 and 12 respectively) in addition to the
1337 SPI0 pins DIN=10, CLK=11 and CS=8 (physical GPIO header pins 19,
1338 23 and 24 respectively).
1339 Load: dtoverlay=gc9a01,<param>=<val>
1340 Params: speed Display SPI bus speed
1342 rotate Display rotation {0,90,180,270}
1344 width Width of the display
1346 height Height of the display
1348 fps Delay between frame updates
1350 debug Debug output level {0-7}
1354 Info: An overlay for the Ghost amplifier.
1355 Load: dtoverlay=ghost-amp,<param>=<val>
1356 Params: fsm_debug Enable debug logging of the GPIO FSM (default
1361 Info: Enables I2C connected Goodix gt9271 multiple touch controller using
1362 GPIOs 4 and 17 (pins 7 and 11 on GPIO header) for interrupt and reset.
1363 Load: dtoverlay=goodix,<param>=<val>
1364 Params: interrupt GPIO used for interrupt (default 4)
1365 reset GPIO used for reset (default 17)
1368 Name: googlevoicehat-soundcard
1369 Info: Configures the Google voiceHAT soundcard
1370 Load: dtoverlay=googlevoicehat-soundcard
1375 Info: This is a generic overlay for detecting charger with GPIO.
1376 Load: dtoverlay=gpio-charger,<param>=<val>
1377 Params: gpio GPIO pin to trigger on (default 4)
1378 active_low When this is 1 (active low), a falling
1379 edge generates a charging event and a
1380 rising edge generates a discharging event.
1381 When this is 0 (active high), this is
1382 reversed. The default is 0 (active high)
1383 gpio_pull Desired pull-up/down state (off, down, up)
1385 type Set a charger type for the pin. (Default: mains)
1389 Info: Configure a GPIO pin to control a cooling fan.
1390 Load: dtoverlay=gpio-fan,<param>=<val>
1391 Params: gpiopin GPIO used to control the fan (default 12)
1392 temp Temperature at which the fan switches on, in
1393 millicelcius (default 55000)
1394 hyst Temperature delta (in millicelcius) below
1395 temp at which the fan will drop to minrpm
1400 Info: Activate a "hog" for a GPIO - request that the kernel configures it as
1401 an output, driven low or high as indicated by the presence or absence
1402 of the active_low parameter. Note that a hogged GPIO is not available
1403 to other drivers or for gpioset/gpioget.
1404 Load: dtoverlay=gpio-hog,<param>=<val>
1405 Params: gpio GPIO pin to hog (default 26)
1406 active_low If set, the hog drives the GPIO low (defaults
1407 to off - the GPIO is driven high)
1411 Info: Use GPIO pin as rc-core style infrared receiver input. The rc-core-
1412 based gpio_ir_recv driver maps received keys directly to a
1413 /dev/input/event* device, all decoding is done by the kernel - LIRC is
1414 not required! The key mapping and other decoding parameters can be
1415 configured by "ir-keytable" tool.
1416 Load: dtoverlay=gpio-ir,<param>=<val>
1417 Params: gpio_pin Input pin number. Default is 18.
1419 gpio_pull Desired pull-up/down state (off, down, up)
1422 invert "1" = invert the input (active-low signalling).
1423 "0" = non-inverted input (active-high
1424 signalling). Default is "1".
1426 rc-map-name Default rc keymap (can also be changed by
1427 ir-keytable), defaults to "rc-rc6-mce"
1431 Info: Use GPIO pin as bit-banged infrared transmitter output.
1432 This is an alternative to "pwm-ir-tx". gpio-ir-tx doesn't require
1433 a PWM so it can be used together with onboard analog audio.
1434 Load: dtoverlay=gpio-ir-tx,<param>=<val>
1435 Params: gpio_pin Output GPIO (default 18)
1437 invert "1" = invert the output (make it active-low).
1438 Default is "0" (active-high).
1442 Info: This is a generic overlay for activating GPIO keypresses using
1443 the gpio-keys library and this dtoverlay. Multiple keys can be
1444 set up using multiple calls to the overlay for configuring
1445 additional buttons or joysticks. You can see available keycodes
1446 at https://github.com/torvalds/linux/blob/v4.12/include/uapi/
1447 linux/input-event-codes.h#L64
1448 Load: dtoverlay=gpio-key,<param>=<val>
1449 Params: gpio GPIO pin to trigger on (default 3)
1450 active_low When this is 1 (active low), a falling
1451 edge generates a key down event and a
1452 rising edge generates a key up event.
1453 When this is 0 (active high), this is
1454 reversed. The default is 1 (active low)
1455 gpio_pull Desired pull-up/down state (off, down, up)
1456 Default is "up". Note that the default pin
1457 (GPIO3) has an external pullup
1458 label Set a label for the key
1459 keycode Set the key code for the button
1464 Info: This is a generic overlay for activating LEDs (or any other component)
1465 by a GPIO pin. Multiple LEDs can be set up using multiple calls to the
1466 overlay. While there are many existing methods to activate LEDs on the
1467 RPi, this method offers some advantages:
1468 1) Does not require any userspace programs.
1469 2) LEDs can be connected to the kernel's led-trigger framework,
1470 and drive the LED based on triggers such as cpu load, heartbeat,
1471 kernel panic, key input, timers and others.
1472 3) LED can be tied to the input state of another GPIO pin.
1473 4) The LED is setup early during the kernel boot process (useful
1474 for cpu/heartbeat/panic triggers).
1476 Typical electrical connection is:
1477 RPI-GPIO.19 -> LED -> 300ohm resister -> RPI-GND
1478 The GPIO pin number can be changed with the 'gpio=' parameter.
1480 To control an LED from userspace, write a 0 or 1 value:
1481 echo 1 > /sys/class/leds/myled1/brightness
1482 The 'myled1' name can be changed with the 'label=' parameter.
1484 To connect the LED to a kernel trigger from userspace:
1485 echo cpu > /sys/class/leds/myled1/trigger
1486 echo heartbeat > /sys/class/leds/myled1/trigger
1487 echo none > /sys/class/leds/myled1/trigger
1488 To connect the LED to GPIO.26 pin (physical pin 37):
1489 echo gpio > /sys/class/leds/myled1/trigger
1490 echo 26 > /sys/class/leds/myled1/gpio
1492 cat /sys/class/leds/myled1/trigger
1494 More information about the Linux kernel LED/Trigger system:
1495 https://www.kernel.org/doc/Documentation/leds/leds-class.rst
1496 https://www.kernel.org/doc/Documentation/leds/ledtrig-oneshot.rst
1497 Load: dtoverlay=gpio-led,<param>=<val>
1498 Params: gpio GPIO pin connected to the LED (default 19)
1499 label The label for this LED. It will appear under
1500 /sys/class/leds/<label> . Default 'myled1'.
1501 trigger Set the led-trigger to connect to this LED.
1502 default 'none' (LED is user-controlled).
1503 Some possible triggers:
1504 cpu - CPU load (all CPUs)
1505 cpu0 - CPU load of first CPU.
1506 mmc - disk activity (all disks)
1507 panic - turn on on kernel panic
1508 heartbeat - indicate system health
1509 gpio - connect to a GPIO input pin (note:
1510 currently the GPIO PIN can not be set
1511 using overlay parameters, must be
1512 done in userspace, see examples above.
1513 active_low Set to 1 to turn invert the LED control
1514 (writing 0 to /sys/class/leds/XXX/brightness
1515 will turn on the GPIO/LED). Default '0'.
1518 Name: gpio-no-bank0-irq
1519 Info: Use this overlay to disable GPIO interrupts for GPIOs in bank 0 (0-27),
1520 which can be useful for UIO drivers.
1521 N.B. Using this overlay will trigger a kernel WARN during booting, but
1522 this can safely be ignored - the system should work as expected.
1523 Load: dtoverlay=gpio-no-bank0-irq
1528 Info: Use this overlay to disable all GPIO interrupts, which can be useful
1529 for user-space GPIO edge detection systems.
1530 Load: dtoverlay=gpio-no-irq
1535 Info: Drives a GPIO high or low on poweroff (including halt). Using this
1536 overlay interferes with the normal power-down sequence, preventing the
1537 kernel from resetting the SoC (a necessary step in a normal power-off
1538 or reboot). This also disables the ability to trigger a boot by driving
1541 The GPIO starts in an inactive state. At poweroff time it is driven
1542 active for 100ms, then inactive for 100ms, then active again. It is
1543 safe to remove the power at any point after the initial activation of
1546 Users of this overlay are required to provide an external mechanism to
1547 switch off the power supply when signalled - failure to do so results
1548 in a kernel BUG, increased power consumption and undefined behaviour.
1549 Load: dtoverlay=gpio-poweroff,<param>=<val>
1550 Params: gpiopin GPIO for signalling (default 26)
1552 active_low Set if the power control device requires a
1553 high->low transition to trigger a power-down.
1554 Note that this will require the support of a
1555 custom dt-blob.bin to prevent a power-down
1556 during the boot process, and that a reboot
1557 will also cause the pin to go low.
1558 input Set if the gpio pin should be configured as
1560 export Set to export the configured pin to sysfs
1561 active_delay_ms Initial GPIO active period (default 100)
1562 inactive_delay_ms Subsequent GPIO inactive period (default 100)
1563 timeout_ms Specify (in ms) how long the kernel waits for
1564 power-down before issuing a WARN (default 3000).
1568 Info: Initiates a shutdown when GPIO pin changes. The given GPIO pin
1569 is configured as an input key that generates KEY_POWER events.
1571 This event is handled by systemd-logind by initiating a
1572 shutdown. Systemd versions older than 225 need an udev rule
1573 enable listening to the input device:
1575 ACTION!="REMOVE", SUBSYSTEM=="input", KERNEL=="event*", \
1576 SUBSYSTEMS=="platform", DRIVERS=="gpio-keys", \
1577 ATTRS{keys}=="116", TAG+="power-switch"
1579 Alternatively this event can be handled also on systems without
1580 systemd, just by traditional SysV init daemon. KEY_POWER event
1581 (keycode 116) needs to be mapped to KeyboardSignal on console
1582 and then kb::kbrequest inittab action which is triggered by
1583 KeyboardSignal from console can be configured to issue system
1584 shutdown. Steps for this configuration are:
1586 Add following lines to the /etc/console-setup/remap.inc file:
1588 # Key Power as special keypress
1589 keycode 116 = KeyboardSignal
1591 Then add following lines to /etc/inittab file:
1593 # Action on special keypress (Key Power)
1594 kb::kbrequest:/sbin/shutdown -t1 -a -h -P now
1596 And finally reload configuration by calling following commands:
1598 # dpkg-reconfigure console-setup
1599 # service console-setup reload
1602 This overlay only handles shutdown. After shutdown, the system
1603 can be powered up again by driving GPIO3 low. The default
1604 configuration uses GPIO3 with a pullup, so if you connect a
1605 button between GPIO3 and GND (pin 5 and 6 on the 40-pin header),
1606 you get a shutdown and power-up button. Please note that
1607 Raspberry Pi 1 Model B rev 1 uses GPIO1 instead of GPIO3.
1608 Load: dtoverlay=gpio-shutdown,<param>=<val>
1609 Params: gpio_pin GPIO pin to trigger on (default 3)
1610 For Raspberry Pi 1 Model B rev 1 set this
1611 explicitly to value 1, e.g.:
1613 dtoverlay=gpio-shutdown,gpio_pin=1
1615 active_low When this is 1 (active low), a falling
1616 edge generates a key down event and a
1617 rising edge generates a key up event.
1618 When this is 0 (active high), this is
1619 reversed. The default is 1 (active low).
1621 gpio_pull Desired pull-up/down state (off, down, up)
1624 Note that the default pin (GPIO3) has an
1625 external pullup. Same applies for GPIO1
1626 on Raspberry Pi 1 Model B rev 1.
1628 debounce Specify the debounce interval in milliseconds
1633 Info: Configures an HD44780 compatible LCD display. Uses 4 gpio pins for
1634 data, 2 gpio pins for enable and register select and 1 optional pin
1635 for enabling/disabling the backlight display.
1636 Load: dtoverlay=hd44780-lcd,<param>=<val>
1637 Params: pin_d4 GPIO pin for data pin D4 (default 6)
1639 pin_d5 GPIO pin for data pin D5 (default 13)
1641 pin_d6 GPIO pin for data pin D6 (default 19)
1643 pin_d7 GPIO pin for data pin D7 (default 26)
1645 pin_en GPIO pin for "Enable" (default 21)
1647 pin_rs GPIO pin for "Register Select" (default 20)
1649 pin_bl Optional pin for enabling/disabling the
1650 display backlight. (default disabled)
1652 display_height Height of the display in characters
1654 display_width Width of the display in characters
1657 Name: hdmi-backlight-hwhack-gpio
1658 Info: Devicetree overlay for GPIO based backlight on/off capability.
1659 Use this if you have one of those HDMI displays whose backlight cannot
1660 be controlled via DPMS over HDMI and plan to do a little soldering to
1661 use an RPi gpio pin for on/off switching. See:
1662 https://www.waveshare.com/wiki/7inch_HDMI_LCD_(C)#Backlight_Control
1663 Load: dtoverlay=hdmi-backlight-hwhack-gpio,<param>=<val>
1664 Params: gpio_pin GPIO pin used (default 17)
1665 active_low Set this to 1 if the display backlight is
1666 switched on when the wire goes low.
1667 Leave the default (value 0) if the backlight
1668 expects a high to switch it on.
1672 Info: Configures the HifiBerry Amp and Amp+ audio cards
1673 Load: dtoverlay=hifiberry-amp
1677 Name: hifiberry-amp100
1678 Info: Configures the HifiBerry AMP100 audio card
1679 Load: dtoverlay=hifiberry-amp100,<param>=<val>
1680 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
1681 Digital volume control. Enable with
1682 "dtoverlay=hifiberry-amp100,24db_digital_gain"
1683 (The default behaviour is that the Digital
1684 volume control is limited to a maximum of
1685 0dB. ie. it can attenuate but not provide
1686 gain. For most users, this will be desired
1687 as it will prevent clipping. By appending
1688 the 24dB_digital_gain parameter, the Digital
1689 volume control will allow up to 24dB of
1690 gain. If this parameter is enabled, it is the
1691 responsibility of the user to ensure that
1692 the Digital volume control is set to a value
1693 that does not result in clipping/distortion!)
1694 slave Force AMP100 into slave mode, using Pi as
1695 master for bit clock and frame clock.
1696 leds_off If set to 'true' the onboard indicator LEDs
1697 are switched off at all times.
1698 auto_mute If set to 'true' the amplifier is automatically
1699 muted when the DAC is not playing.
1700 mute_ext_ctl The amplifier's HW mute control is enabled
1701 in ALSA mixer and set to <val>.
1702 Will be overwritten by ALSA user settings.
1705 Name: hifiberry-amp3
1706 Info: Configures the HifiBerry Amp3 audio card
1707 Load: dtoverlay=hifiberry-amp3
1712 Info: Configures the HifiBerry DAC audio cards
1713 Load: dtoverlay=hifiberry-dac
1717 Name: hifiberry-dacplus
1718 Info: Configures the HifiBerry DAC+ audio card
1719 Load: dtoverlay=hifiberry-dacplus,<param>=<val>
1720 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
1721 Digital volume control. Enable with
1722 "dtoverlay=hifiberry-dacplus,24db_digital_gain"
1723 (The default behaviour is that the Digital
1724 volume control is limited to a maximum of
1725 0dB. ie. it can attenuate but not provide
1726 gain. For most users, this will be desired
1727 as it will prevent clipping. By appending
1728 the 24dB_digital_gain parameter, the Digital
1729 volume control will allow up to 24dB of
1730 gain. If this parameter is enabled, it is the
1731 responsibility of the user to ensure that
1732 the Digital volume control is set to a value
1733 that does not result in clipping/distortion!)
1734 slave Force DAC+ into slave mode, using Pi as
1735 master for bit clock and frame clock.
1736 leds_off If set to 'true' the onboard indicator LEDs
1737 are switched off at all times.
1740 Name: hifiberry-dacplusadc
1741 Info: Configures the HifiBerry DAC+ADC audio card
1742 Load: dtoverlay=hifiberry-dacplusadc,<param>=<val>
1743 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
1744 Digital volume control. Enable with
1745 "dtoverlay=hifiberry-dacplus,24db_digital_gain"
1746 (The default behaviour is that the Digital
1747 volume control is limited to a maximum of
1748 0dB. ie. it can attenuate but not provide
1749 gain. For most users, this will be desired
1750 as it will prevent clipping. By appending
1751 the 24dB_digital_gain parameter, the Digital
1752 volume control will allow up to 24dB of
1753 gain. If this parameter is enabled, it is the
1754 responsibility of the user to ensure that
1755 the Digital volume control is set to a value
1756 that does not result in clipping/distortion!)
1757 slave Force DAC+ADC into slave mode, using Pi as
1758 master for bit clock and frame clock.
1759 leds_off If set to 'true' the onboard indicator LEDs
1760 are switched off at all times.
1763 Name: hifiberry-dacplusadcpro
1764 Info: Configures the HifiBerry DAC+ADC PRO audio card
1765 Load: dtoverlay=hifiberry-dacplusadcpro,<param>=<val>
1766 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
1767 Digital volume control. Enable with
1768 "dtoverlay=hifiberry-dacplusadcpro,24db_digital_gain"
1769 (The default behaviour is that the Digital
1770 volume control is limited to a maximum of
1771 0dB. ie. it can attenuate but not provide
1772 gain. For most users, this will be desired
1773 as it will prevent clipping. By appending
1774 the 24dB_digital_gain parameter, the Digital
1775 volume control will allow up to 24dB of
1776 gain. If this parameter is enabled, it is the
1777 responsibility of the user to ensure that
1778 the Digital volume control is set to a value
1779 that does not result in clipping/distortion!)
1780 slave Force DAC+ADC Pro into slave mode, using Pi as
1781 master for bit clock and frame clock.
1782 leds_off If set to 'true' the onboard indicator LEDs
1783 are switched off at all times.
1786 Name: hifiberry-dacplusdsp
1787 Info: Configures the HifiBerry DAC+DSP audio card
1788 Load: dtoverlay=hifiberry-dacplusdsp
1792 Name: hifiberry-dacplushd
1793 Info: Configures the HifiBerry DAC+ HD audio card
1794 Load: dtoverlay=hifiberry-dacplushd
1798 Name: hifiberry-digi
1799 Info: Configures the HifiBerry Digi and Digi+ audio card
1800 Load: dtoverlay=hifiberry-digi
1804 Name: hifiberry-digi-pro
1805 Info: Configures the HifiBerry Digi+ Pro and Digi2 Pro audio card
1806 Load: dtoverlay=hifiberry-digi-pro
1811 Info: Enables "High Peripheral" mode
1812 Load: dtoverlay=highperi
1817 Info: HY28A - 2.8" TFT LCD Display Module by HAOYU Electronics
1818 Default values match Texy's display shield
1819 Load: dtoverlay=hy28a,<param>=<val>
1820 Params: speed Display SPI bus speed
1822 rotate Display rotation {0,90,180,270}
1824 fps Delay between frame updates
1826 debug Debug output level {0-7}
1828 xohms Touchpanel sensitivity (X-plate resistance)
1830 resetgpio GPIO used to reset controller
1832 ledgpio GPIO used to control backlight
1836 Info: HY28B - 2.8" TFT LCD Display Module by HAOYU Electronics
1837 Default values match Texy's display shield
1838 Load: dtoverlay=hy28b,<param>=<val>
1839 Params: speed Display SPI bus speed
1841 rotate Display rotation {0,90,180,270}
1843 fps Delay between frame updates
1845 debug Debug output level {0-7}
1847 xohms Touchpanel sensitivity (X-plate resistance)
1849 resetgpio GPIO used to reset controller
1851 ledgpio GPIO used to control backlight
1855 Info: HY28B 2017 version - 2.8" TFT LCD Display Module by HAOYU Electronics
1856 Default values match Texy's display shield
1857 Load: dtoverlay=hy28b-2017,<param>=<val>
1858 Params: speed Display SPI bus speed
1860 rotate Display rotation {0,90,180,270}
1862 fps Delay between frame updates
1864 debug Debug output level {0-7}
1866 xohms Touchpanel sensitivity (X-plate resistance)
1868 resetgpio GPIO used to reset controller
1870 ledgpio GPIO used to control backlight
1874 Info: Configures the Audiophonics I-SABRE Q2M DAC
1875 Load: dtoverlay=i-sabre-q2m
1880 Info: Fall back to the i2c_bcm2708 driver for the i2c_arm bus.
1881 Load: dtoverlay=i2c-bcm2708
1886 Info: Adds support for a number of I2C fan controllers
1887 Load: dtoverlay=i2c-fan,<param>=<val>
1888 Params: addr Sets the address for the fan controller. Note
1889 that the device must be configured to use the
1892 i2c0 Choose the I2C0 bus on GPIOs 0&1
1894 i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
1896 i2c3 Choose the I2C3 bus (configure with the i2c3
1897 overlay - BCM2711 only)
1899 i2c4 Choose the I2C4 bus (configure with the i2c4
1900 overlay - BCM2711 only)
1902 i2c5 Choose the I2C5 bus (configure with the i2c5
1903 overlay - BCM2711 only)
1905 i2c6 Choose the I2C6 bus (configure with the i2c6
1906 overlay - BCM2711 only)
1908 minpwm PWM setting for the fan when the SoC is below
1909 mintemp (range 0-255. default 0)
1910 maxpwm PWM setting for the fan when the SoC is above
1911 maxtemp (range 0-255. default 255)
1912 midtemp Temperature (in millicelcius) at which the fan
1913 begins to speed up (default 50000)
1915 midtemp_hyst Temperature delta (in millicelcius) below
1916 mintemp at which the fan will drop to minrpm
1919 maxtemp Temperature (in millicelcius) at which the fan
1920 will be held at maxrpm (default 70000)
1922 maxtemp_hyst Temperature delta (in millicelcius) below
1923 maxtemp at which the fan begins to slow down
1926 emc2301 Select the Microchip EMC230x controller family
1927 - EMC2301, EMC2302, EMC2303, EMC2305.
1931 Info: Adds support for software i2c controller on gpio pins
1932 Load: dtoverlay=i2c-gpio,<param>=<val>
1933 Params: i2c_gpio_sda GPIO used for I2C data (default "23")
1935 i2c_gpio_scl GPIO used for I2C clock (default "24")
1937 i2c_gpio_delay_us Clock delay in microseconds
1938 (default "2" = ~100kHz)
1940 bus Set to a unique, non-zero value if wanting
1941 multiple i2c-gpio busses. If set, will be used
1942 as the preferred bus number (/dev/i2c-<n>). If
1943 not set, the default value is 0, but the bus
1944 number will be dynamically assigned - probably
1949 Info: Adds support for a number of I2C bus multiplexers on i2c_arm
1950 Load: dtoverlay=i2c-mux,<param>=<val>
1951 Params: pca9542 Select the NXP PCA9542 device
1953 pca9545 Select the NXP PCA9545 device
1955 pca9548 Select the NXP PCA9548 device
1957 addr Change I2C address of the device (default 0x70)
1959 i2c0 Choose the I2C0 bus on GPIOs 0&1
1961 i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
1963 i2c3 Choose the I2C3 bus (configure with the i2c3
1964 overlay - BCM2711 only)
1966 i2c4 Choose the I2C3 bus (configure with the i2c3
1967 overlay - BCM2711 only)
1969 i2c5 Choose the I2C5 bus (configure with the i2c4
1970 overlay - BCM2711 only)
1972 i2c6 Choose the I2C6 bus (configure with the i2c6
1973 overlay - BCM2711 only)
1976 [ The i2c-mux-pca9548a overlay has been deleted. See i2c-mux. ]
1979 Name: i2c-pwm-pca9685a
1980 Info: Adds support for an NXP PCA9685A I2C PWM controller on i2c_arm
1981 Load: dtoverlay=i2c-pwm-pca9685a,<param>=<val>
1982 Params: addr I2C address of PCA9685A (default 0x40)
1983 i2c0 Choose the I2C0 bus on GPIOs 0&1
1984 i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
1985 i2c3 Choose the I2C3 bus (configure with the i2c3
1986 overlay - BCM2711 only)
1987 i2c4 Choose the I2C3 bus (configure with the i2c3
1988 overlay - BCM2711 only)
1989 i2c5 Choose the I2C5 bus (configure with the i2c4
1990 overlay - BCM2711 only)
1991 i2c6 Choose the I2C6 bus (configure with the i2c6
1992 overlay - BCM2711 only)
1996 Info: Adds support for a number of I2C Real Time Clock devices
1997 Load: dtoverlay=i2c-rtc,<param>=<val>
1998 Params: abx80x Select one of the ABx80x family:
1999 AB0801, AB0803, AB0804, AB0805,
2000 AB1801, AB1803, AB1804, AB1805
2002 bq32000 Select the TI BQ32000 device
2004 ds1307 Select the DS1307 device
2006 ds1339 Select the DS1339 device
2008 ds1340 Select the DS1340 device
2010 ds3231 Select the DS3231 device
2012 m41t62 Select the M41T62 device
2014 mcp7940x Select the MCP7940x device
2016 mcp7941x Select the MCP7941x device
2018 pcf2127 Select the PCF2127 device
2020 pcf2129 Select the PCF2129 device
2022 pcf85063 Select the PCF85063 device
2024 pcf85063a Select the PCF85063A device
2026 pcf8523 Select the PCF8523 device
2028 pcf85363 Select the PCF85363 device
2030 pcf8563 Select the PCF8563 device
2032 rv1805 Select the Micro Crystal RV1805 device
2034 rv3028 Select the Micro Crystal RV3028 device
2036 rv3032 Select the Micro Crystal RV3032 device
2038 rv8803 Select the Micro Crystal RV8803 device
2040 sd3078 Select the ZXW Shenzhen whwave SD3078 device
2042 s35390a Select the ABLIC S35390A device
2044 i2c0 Choose the I2C0 bus on GPIOs 0&1
2046 i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
2048 i2c3 Choose the I2C3 bus (configure with the i2c3
2049 overlay - BCM2711 only)
2051 i2c4 Choose the I2C3 bus (configure with the i2c3
2052 overlay - BCM2711 only)
2054 i2c5 Choose the I2C5 bus (configure with the i2c4
2055 overlay - BCM2711 only)
2057 i2c6 Choose the I2C6 bus (configure with the i2c6
2058 overlay - BCM2711 only)
2060 addr Sets the address for the RTC. Note that the
2061 device must be configured to use the specified
2064 trickle-diode-disable Do not use the internal trickle charger diode
2067 trickle-diode-type Diode type for trickle charge - "standard" or
2068 "schottky" (ABx80x and RV1805 only)
2070 trickle-resistor-ohms Resistor value for trickle charge (DS1339,
2071 ABx80x, BQ32000, RV1805, RV3028, RV3032)
2073 trickle-voltage-mv Charge pump voltage for trickle charge (RV3032)
2075 wakeup-source Specify that the RTC can be used as a wakeup
2078 backup-switchover-mode Backup power supply switch mode. Must be 0 for
2079 off or 1 for Vdd < VBackup (RV3028, RV3032)
2083 Info: Adds support for a number of I2C Real Time Clock devices
2084 using the software i2c controller
2085 Load: dtoverlay=i2c-rtc-gpio,<param>=<val>
2086 Params: abx80x Select one of the ABx80x family:
2087 AB0801, AB0803, AB0804, AB0805,
2088 AB1801, AB1803, AB1804, AB1805
2090 bq32000 Select the TI BQ32000 device
2092 ds1307 Select the DS1307 device
2094 ds1339 Select the DS1339 device
2096 ds1340 Select the DS1340 device
2098 ds3231 Select the DS3231 device
2100 m41t62 Select the M41T62 device
2102 mcp7940x Select the MCP7940x device
2104 mcp7941x Select the MCP7941x device
2106 pcf2127 Select the PCF2127 device
2108 pcf2129 Select the PCF2129 device
2110 pcf85063 Select the PCF85063 device
2112 pcf85063a Select the PCF85063A device
2114 pcf8523 Select the PCF8523 device
2116 pcf85363 Select the PCF85363 device
2118 pcf8563 Select the PCF8563 device
2120 rv1805 Select the Micro Crystal RV1805 device
2122 rv3028 Select the Micro Crystal RV3028 device
2124 rv3032 Select the Micro Crystal RV3032 device
2126 rv8803 Select the Micro Crystal RV8803 device
2128 sd3078 Select the ZXW Shenzhen whwave SD3078 device
2130 s35390a Select the ABLIC S35390A device
2132 addr Sets the address for the RTC. Note that the
2133 device must be configured to use the specified
2136 trickle-diode-disable Do not use the internal trickle charger diode
2139 trickle-diode-type Diode type for trickle charge - "standard" or
2140 "schottky" (ABx80x and RV1805 only)
2142 trickle-resistor-ohms Resistor value for trickle charge (DS1339,
2143 ABx80x, BQ32000, RV1805, RV3028, RV3032)
2145 trickle-voltage-mv Charge pump voltage for trickle charge (RV3032)
2147 wakeup-source Specify that the RTC can be used as a wakeup
2150 backup-switchover-mode Backup power supply switch mode. Must be 0 for
2151 off or 1 for Vdd < VBackup (RV3028, RV3032)
2153 i2c_gpio_sda GPIO used for I2C data (default "23")
2155 i2c_gpio_scl GPIO used for I2C clock (default "24")
2157 i2c_gpio_delay_us Clock delay in microseconds
2158 (default "2" = ~100kHz)
2162 Info: Adds support for a number of I2C barometric pressure, temperature,
2163 light level and chemical sensors on i2c_arm
2164 Load: dtoverlay=i2c-sensor,<param>=<val>
2165 Params: addr Set the address for the ADT7410, BH1750, BME280,
2166 BME680, BMP280, BMP380, CCS811, DS1621, HDC100X,
2167 JC42, LM75, MCP980x, MPU6050, MPU9250, MS5637,
2168 MS5803, MS5805, MS5837, MS8607, SHT3x or TMP102
2170 adt7410 Select the Analog Devices ADT7410 and ADT7420
2172 Valid address 0x48-0x4b, default 0x48
2174 aht10 Select the Aosong AHT10 temperature and humidity
2177 bh1750 Select the Rohm BH1750 ambient light sensor
2178 Valid addresses 0x23 or 0x5c, default 0x23
2180 bme280 Select the Bosch Sensortronic BME280
2181 Valid addresses 0x76-0x77, default 0x76
2183 bme680 Select the Bosch Sensortronic BME680
2184 Valid addresses 0x76-0x77, default 0x76
2186 bmp085 Select the Bosch Sensortronic BMP085
2188 bmp180 Select the Bosch Sensortronic BMP180
2190 bmp280 Select the Bosch Sensortronic BMP280
2191 Valid addresses 0x76-0x77, default 0x76
2193 bmp380 Select the Bosch Sensortronic BMP380
2194 Valid addresses 0x76-0x77, default 0x76
2196 bno055 Select the Bosch Sensortronic BNO055 IMU
2197 Valid address 0x28-0x29, default 0x29
2199 ccs811 Select the AMS CCS811 digital gas sensor
2200 Valid addresses 0x5a-0x5b, default 0x5b
2202 ds1621 Select the Dallas Semiconductors DS1621 temp
2203 sensor. Valid addresses 0x48-0x4f, default 0x48
2205 hdc100x Select the Texas Instruments HDC100x temp sensor
2206 Valid addresses 0x40-0x43, default 0x40
2208 htu21 Select the HTU21 temperature and humidity sensor
2210 int_pin Set the GPIO to use for interrupts (max30102,
2211 mpu6050 and mpu9250 only)
2213 jc42 Select any of the many JEDEC JC42.4-compliant
2214 temperature sensors, including:
2215 ADT7408, AT30TS00, CAT34TS02, CAT6095,
2216 MAX6604, MCP9804, MCP9805, MCP9808,
2217 MCP98242, MCP98243, MCP98244, MCP9843,
2218 SE97, SE98, STTS424(E), STTS2002, STTS3000,
2219 TSE2002, TSE2004, TS3000, and TS3001.
2220 The default address is 0x18.
2222 lm75 Select the Maxim LM75 temperature sensor
2223 Valid addresses 0x48-0x4f, default 0x4f
2225 lm75addr Deprecated - use addr parameter instead
2227 max17040 Select the Maxim Integrated MAX17040 battery
2230 max30102 Select the Maxim Integrated MAX30102 heart-rate
2231 and blood-oxygen sensor
2233 mcp980x Select the Maxim MCP980x range of temperature
2234 sensors (i.e. MCP9800, MCP9801, MCP9802 and
2235 MCP9803). N.B. For MCP9804, MCP9805 and MCP9808,
2236 use the "jc42" option.
2237 Valid addresses are 0x18-0x1f (default 0x18)
2239 mpu6050 Select the InvenSense MPU6050 IMU. Valid
2240 valid addresses are 0x68 and 0x69 (default 0x68)
2242 mpu9250 Select the InvenSense MPU9250 IMU. Valid
2243 valid addresses are 0x68 and 0x69 (default 0x68)
2245 ms5637 Select the Measurement Specialities MS5637
2246 pressure and temperature sensor.
2248 ms5803 Select the Measurement Specialities MS5803
2249 pressure and temperature sensor.
2251 ms5805 Select the Measurement Specialities MS5805
2252 pressure and temperature sensor.
2254 ms5837 Select the Measurement Specialities MS5837
2255 pressure and temperature sensor.
2257 ms8607 Select the Measurement Specialities MS8607
2258 pressure and temperature sensor.
2260 no_timeout Disable the SMBUS timeout. N.B. Only supported
2261 by some jc42 devices - using with an
2262 incompatible device can stop it from being
2265 reset_pin GPIO to be used to reset the device (bno055
2266 only, disabled by default)
2268 sht3x Select the Sensirion SHT3x temperature and
2269 humidity sensors. Valid addresses 0x44-0x45,
2272 sht4x Select the Sensirion SHT4x temperature and
2273 humidity sensors. Valid addresses 0x44-0x45,
2276 si7020 Select the Silicon Labs Si7013/20/21 humidity/
2279 sps30 Select the Sensirion SPS30 particulate matter
2280 sensor. Fixed address 0x69.
2282 sgp30 Select the Sensirion SGP30 VOC sensor.
2285 tmp102 Select the Texas Instruments TMP102 temp sensor
2286 Valid addresses 0x48-0x4b, default 0x48
2288 tsl4531 Select the AMS TSL4531 digital ambient light
2291 veml6070 Select the Vishay VEML6070 ultraviolet light
2294 i2c0 Choose the I2C0 bus on GPIOs 0&1
2296 i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
2298 i2c3 Choose the I2C3 bus (configure with the i2c3
2299 overlay - BCM2711 only)
2301 i2c4 Choose the I2C3 bus (configure with the i2c3
2302 overlay - BCM2711 only)
2304 i2c5 Choose the I2C5 bus (configure with the i2c4
2305 overlay - BCM2711 only)
2307 i2c6 Choose the I2C6 bus (configure with the i2c6
2308 overlay - BCM2711 only)
2312 Info: Change i2c0 pin usage. Not all pin combinations are usable on all
2313 platforms - platforms other then Compute Modules can only use this
2314 to disable transaction combining.
2315 Do NOT use in conjunction with dtparam=i2c_vc=on. From the 5.4 kernel
2316 onwards the base DT includes the use of i2c_mux_pinctrl to expose two
2317 muxings of BSC0 - GPIOs 0&1, and whichever combination is used for the
2318 camera and display connectors. This overlay disables that mux and
2319 configures /dev/i2c0 to point at whichever set of pins is requested.
2320 dtparam=i2c_vc=on will try and enable the mux, so combining the two
2321 will cause conflicts.
2322 Load: dtoverlay=i2c0,<param>=<val>
2323 Params: pins_0_1 Use pins 0 and 1 (default)
2324 pins_28_29 Use pins 28 and 29
2325 pins_44_45 Use pins 44 and 45
2326 pins_46_47 Use pins 46 and 47
2327 combine Allow transactions to be combined (default
2332 Info: Deprecated, legacy version of i2c0.
2337 Info: Enable i2c0 (Pi 5 only)
2338 Load: dtoverlay=i2c0-pi5,<param>=<val>
2339 Params: pins_0_1 Use GPIOs 0 and 1 (default)
2340 pins_8_9 Use GPIOs 8 and 9
2341 baudrate Set the baudrate for the interface (default
2346 Info: Change i2c1 pin usage. Not all pin combinations are usable on all
2347 platforms - platforms other then Compute Modules can only use this
2348 to disable transaction combining.
2349 Load: dtoverlay=i2c1,<param>=<val>
2350 Params: pins_2_3 Use pins 2 and 3 (default)
2351 pins_44_45 Use pins 44 and 45
2352 combine Allow transactions to be combined (default
2357 Info: Deprecated, legacy version of i2c1.
2362 Info: Enable i2c1 (Pi 5 only)
2363 Load: dtoverlay=i2c1-pi5,<param>=<val>
2364 Params: pins_2_3 Use GPIOs 2 and 3 (default)
2365 pins_10_11 Use GPIOs 10 and 11
2366 baudrate Set the baudrate for the interface (default
2371 Info: Enable i2c2 (Pi 5 only)
2372 Load: dtoverlay=i2c2-pi5,<param>=<val>
2373 Params: pins_4_5 Use GPIOs 4 and 5 (default)
2374 pins_12_13 Use GPIOs 12 and 13
2375 baudrate Set the baudrate for the interface (default
2380 Info: Enable the i2c3 bus. BCM2711 only.
2381 Load: dtoverlay=i2c3,<param>
2382 Params: pins_2_3 Use GPIOs 2 and 3
2383 pins_4_5 Use GPIOs 4 and 5 (default)
2384 baudrate Set the baudrate for the interface (default
2389 Info: Enable i2c3 (Pi 5 only)
2390 Load: dtoverlay=i2c3-pi5,<param>=<val>
2391 Params: pins_6_7 Use GPIOs 6 and 7 (default)
2392 pins_14_15 Use GPIOs 14 and 15
2393 pins_22_23 Use GPIOs 22 and 23
2394 baudrate Set the baudrate for the interface (default
2399 Info: Enable the i2c4 bus. BCM2711 only.
2400 Load: dtoverlay=i2c4,<param>
2401 Params: pins_6_7 Use GPIOs 6 and 7
2402 pins_8_9 Use GPIOs 8 and 9 (default)
2403 baudrate Set the baudrate for the interface (default
2408 Info: Enable the i2c5 bus. BCM2711 only.
2409 Load: dtoverlay=i2c5,<param>
2410 Params: pins_10_11 Use GPIOs 10 and 11
2411 pins_12_13 Use GPIOs 12 and 13 (default)
2412 baudrate Set the baudrate for the interface (default
2417 Info: Enable the i2c6 bus. BCM2711 only.
2418 Load: dtoverlay=i2c6,<param>
2419 Params: pins_0_1 Use GPIOs 0 and 1
2420 pins_22_23 Use GPIOs 22 and 23 (default)
2421 baudrate Set the baudrate for the interface (default
2426 Info: Configures any passive I2S DAC soundcard.
2427 Load: dtoverlay=i2s-dac
2432 Info: move I2S function block to GPIO 28 to 31
2433 Load: dtoverlay=i2s-gpio28-31
2438 Info: Enables I2C connected Ilitek 251x multiple touch controller using
2439 GPIO 4 (pin 7 on GPIO header) for interrupt.
2440 Load: dtoverlay=ilitek251x,<param>=<val>
2441 Params: interrupt GPIO used for interrupt (default 4)
2442 sizex Touchscreen size x, horizontal resolution of
2443 touchscreen (in pixels)
2444 sizey Touchscreen size y, vertical resolution of
2445 touchscreen (in pixels)
2449 Info: Sony IMX219 camera module.
2450 Uses Unicam 1, which is the standard camera connector on most Pi
2452 Load: dtoverlay=imx219,<param>=<val>
2453 Params: rotation Mounting rotation of the camera sensor (0 or
2455 orientation Sensor orientation (0 = front, 1 = rear,
2456 2 = external, default external)
2457 media-controller Configure use of Media Controller API for
2458 configuring the sensor (default on)
2459 cam0 Adopt the default configuration for CAM0 on a
2460 Compute Module (CSI0, i2c_vc, and cam0_reg).
2461 vcm Configure a VCM focus drive on the sensor.
2465 Info: Sony IMX258 camera module.
2466 Uses Unicam 1, which is the standard camera connector on most Pi
2468 Load: dtoverlay=imx258,<param>=<val>
2469 Params: rotation Mounting rotation of the camera sensor (0 or
2471 orientation Sensor orientation (0 = front, 1 = rear,
2472 2 = external, default external)
2473 media-controller Configure use of Media Controller API for
2474 configuring the sensor (default on)
2475 cam0 Adopt the default configuration for CAM0 on a
2476 Compute Module (CSI0, i2c_vc, and cam0_reg).
2477 vcm Configure a VCM focus drive on the sensor.
2478 4lane Enable 4 CSI2 lanes. This requires a Compute
2479 Module (1, 3, or 4).
2483 Info: Sony IMX290 camera module.
2484 Uses Unicam 1, which is the standard camera connector on most Pi
2486 Load: dtoverlay=imx290,<param>
2487 Params: 4lane Enable 4 CSI2 lanes. This requires a Compute
2488 Module (1, 3, or 4).
2489 clock-frequency Sets the clock frequency to match that used on
2491 Modules from Vision Components use 37.125MHz
2492 (the default), whilst those from Innomaker use
2494 mono Denote that the module is a mono sensor.
2495 orientation Sensor orientation (0 = front, 1 = rear,
2496 2 = external, default external)
2497 rotation Mounting rotation of the camera sensor (0 or
2499 media-controller Configure use of Media Controller API for
2500 configuring the sensor (default on)
2501 cam0 Adopt the default configuration for CAM0 on a
2502 Compute Module (CSI0, i2c_vc, and cam0_reg).
2506 Info: Sony IMX296 camera module.
2507 Uses Unicam 1, which is the standard camera connector on most Pi
2509 Load: dtoverlay=imx296,<param>=<val>
2510 Params: rotation Mounting rotation of the camera sensor (0 or
2512 orientation Sensor orientation (0 = front, 1 = rear,
2513 2 = external, default external)
2514 media-controller Configure use of Media Controller API for
2515 configuring the sensor (default on)
2516 cam0 Adopt the default configuration for CAM0 on a
2517 Compute Module (CSI0, i2c_vc, and cam0_reg).
2518 clock-frequency Sets the clock frequency to match that used on
2519 the board, which should be one of 54000000
2520 (the default), 37125000 or 74250000.
2524 Info: Sony IMX327 camera module.
2525 Uses Unicam 1, which is the standard camera connector on most Pi
2527 Load: dtoverlay=imx327,<param>
2528 Params: 4lane Enable 4 CSI2 lanes. This requires a Compute
2529 Module (1, 3, or 4).
2530 clock-frequency Sets the clock frequency to match that used on
2532 Modules from Vision Components use 37.125MHz
2533 (the default), whilst those from Innomaker use
2535 mono Denote that the module is a mono sensor.
2536 orientation Sensor orientation (0 = front, 1 = rear,
2537 2 = external, default external)
2538 rotation Mounting rotation of the camera sensor (0 or
2540 media-controller Configure use of Media Controller API for
2541 configuring the sensor (default on)
2542 cam0 Adopt the default configuration for CAM0 on a
2543 Compute Module (CSI0, i2c_vc, and cam0_reg).
2547 Info: Sony IMX378 camera module.
2548 Uses Unicam 1, which is the standard camera connector on most Pi
2550 Load: dtoverlay=imx378,<param>=<val>
2551 Params: rotation Mounting rotation of the camera sensor (0 or
2553 orientation Sensor orientation (0 = front, 1 = rear,
2554 2 = external, default external)
2555 media-controller Configure use of Media Controller API for
2556 configuring the sensor (default on)
2557 cam0 Adopt the default configuration for CAM0 on a
2558 Compute Module (CSI0, i2c_vc, and cam0_reg).
2562 Info: Sony IMX462 camera module.
2563 Uses Unicam 1, which is the standard camera connector on most Pi
2565 Load: dtoverlay=imx462,<param>
2566 Params: 4lane Enable 4 CSI2 lanes. This requires a Compute
2567 Module (1, 3, or 4).
2568 clock-frequency Sets the clock frequency to match that used on
2570 Modules from Vision Components use 37.125MHz
2571 (the default), whilst those from Innomaker use
2573 mono Denote that the module is a mono sensor.
2574 orientation Sensor orientation (0 = front, 1 = rear,
2575 2 = external, default external)
2576 rotation Mounting rotation of the camera sensor (0 or
2578 media-controller Configure use of Media Controller API for
2579 configuring the sensor (default on)
2580 cam0 Adopt the default configuration for CAM0 on a
2581 Compute Module (CSI0, i2c_vc, and cam0_reg).
2585 Info: Sony IMX477 camera module.
2586 Uses Unicam 1, which is the standard camera connector on most Pi
2588 Load: dtoverlay=imx477,<param>=<val>
2589 Params: rotation Mounting rotation of the camera sensor (0 or
2591 orientation Sensor orientation (0 = front, 1 = rear,
2592 2 = external, default external)
2593 media-controller Configure use of Media Controller API for
2594 configuring the sensor (default on)
2595 cam0 Adopt the default configuration for CAM0 on a
2596 Compute Module (CSI0, i2c_vc, and cam0_reg).
2600 Info: Sony IMX519 camera module.
2601 Uses Unicam 1, which is the standard camera connector on most Pi
2603 Load: dtoverlay=imx519,<param>=<val>
2604 Params: rotation Mounting rotation of the camera sensor (0 or
2606 orientation Sensor orientation (0 = front, 1 = rear,
2607 2 = external, default external)
2608 media-controller Configure use of Media Controller API for
2609 configuring the sensor (default on)
2610 cam0 Adopt the default configuration for CAM0 on a
2611 Compute Module (CSI0, i2c_vc, and cam0_reg).
2612 vcm Select lens driver state. Default is enabled,
2613 but vcm=off will disable.
2617 Info: Sony IMX708 camera module.
2618 Uses Unicam 1, which is the standard camera connector on most Pi
2620 Load: dtoverlay=imx708,<param>=<val>
2621 Params: rotation Mounting rotation of the camera sensor (0 or
2623 orientation Sensor orientation (0 = front, 1 = rear,
2624 2 = external, default external)
2625 vcm Select lens driver state. Default is enabled,
2626 but vcm=off will disable.
2627 media-controller Configure use of Media Controller API for
2628 configuring the sensor (default on)
2629 cam0 Adopt the default configuration for CAM0 on a
2630 Compute Module (CSI0, i2c_vc, and cam0_reg).
2631 link-frequency Allowable link frequency values to use in Hz:
2632 450000000 (default), 447000000, 453000000.
2636 Info: Configures the IQaudio Codec audio card
2637 Load: dtoverlay=iqaudio-codec
2642 Info: Configures the IQaudio DAC audio card
2643 Load: dtoverlay=iqaudio-dac,<param>
2644 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
2645 Digital volume control. Enable with
2646 "dtoverlay=iqaudio-dac,24db_digital_gain"
2647 (The default behaviour is that the Digital
2648 volume control is limited to a maximum of
2649 0dB. ie. it can attenuate but not provide
2650 gain. For most users, this will be desired
2651 as it will prevent clipping. By appending
2652 the 24db_digital_gain parameter, the Digital
2653 volume control will allow up to 24dB of
2654 gain. If this parameter is enabled, it is the
2655 responsibility of the user to ensure that
2656 the Digital volume control is set to a value
2657 that does not result in clipping/distortion!)
2660 Name: iqaudio-dacplus
2661 Info: Configures the IQaudio DAC+ audio card
2662 Load: dtoverlay=iqaudio-dacplus,<param>=<val>
2663 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
2664 Digital volume control. Enable with
2665 "dtoverlay=iqaudio-dacplus,24db_digital_gain"
2666 (The default behaviour is that the Digital
2667 volume control is limited to a maximum of
2668 0dB. ie. it can attenuate but not provide
2669 gain. For most users, this will be desired
2670 as it will prevent clipping. By appending
2671 the 24db_digital_gain parameter, the Digital
2672 volume control will allow up to 24dB of
2673 gain. If this parameter is enabled, it is the
2674 responsibility of the user to ensure that
2675 the Digital volume control is set to a value
2676 that does not result in clipping/distortion!)
2677 auto_mute_amp If specified, unmute/mute the IQaudIO amp when
2678 starting/stopping audio playback.
2679 unmute_amp If specified, unmute the IQaudIO amp once when
2680 the DAC driver module loads.
2683 Name: iqaudio-digi-wm8804-audio
2684 Info: Configures the IQAudIO Digi WM8804 audio card
2685 Load: dtoverlay=iqaudio-digi-wm8804-audio,<param>=<val>
2686 Params: card_name Override the default, "IQAudIODigi", card name.
2687 dai_name Override the default, "IQAudIO Digi", dai name.
2688 dai_stream_name Override the default, "IQAudIO Digi HiFi",
2693 Info: Enables I2C connected Azoteq IQS550 trackpad/touchscreen controller
2694 using GPIO 4 (pin 7 on GPIO header) for interrupt.
2695 Load: dtoverlay=iqs550,<param>=<val>
2696 Params: interrupt GPIO used for interrupt (default 4)
2697 reset GPIO used for reset (optional)
2698 sizex Touchscreen size x (default 800)
2699 sizey Touchscreen size y (default 480)
2700 invx Touchscreen inverted x axis
2701 invy Touchscreen inverted y axis
2702 swapxy Touchscreen swapped x y axis
2706 Info: Infineon irs1125 TOF camera module.
2707 Uses Unicam 1, which is the standard camera connector on most Pi
2709 Load: dtoverlay=irs1125,<param>=<val>
2710 Params: media-controller Configure use of Media Controller API for
2711 configuring the sensor (default off)
2712 cam0 Adopt the default configuration for CAM0 on a
2713 Compute Module (CSI0, i2c_vc, and cam0_reg).
2717 Info: Adds support for JEDEC-compliant SPI NOR flash devices. (Note: The
2718 "jedec,spi-nor" kernel driver was formerly known as "m25p80".)
2719 Load: dtoverlay=jedec-spi-nor,<param>=<val>
2720 Params: spi<n>-<m> Enable flash device on SPI<n>, CS#<m>
2721 fastr Add fast read capability to the flash device
2722 speed Maximum SPI frequency (Hz)
2723 flash-spi<n>-<m> Same as spi<n>-<m> (deprecated)
2724 flash-fastr-spi<n>-<m> Same as spi<n>->m>,fastr (deprecated)
2728 Info: Simultaneous usage of an justboom-dac and justboom-digi based
2730 Load: dtoverlay=justboom-both,<param>=<val>
2731 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
2732 Digital volume control. Enable with
2733 "dtoverlay=justboom-dac,24db_digital_gain"
2734 (The default behaviour is that the Digital
2735 volume control is limited to a maximum of
2736 0dB. ie. it can attenuate but not provide
2737 gain. For most users, this will be desired
2738 as it will prevent clipping. By appending
2739 the 24dB_digital_gain parameter, the Digital
2740 volume control will allow up to 24dB of
2741 gain. If this parameter is enabled, it is the
2742 responsibility of the user to ensure that
2743 the Digital volume control is set to a value
2744 that does not result in clipping/distortion!)
2748 Info: Configures the JustBoom DAC HAT, Amp HAT, DAC Zero and Amp Zero audio
2750 Load: dtoverlay=justboom-dac,<param>=<val>
2751 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
2752 Digital volume control. Enable with
2753 "dtoverlay=justboom-dac,24db_digital_gain"
2754 (The default behaviour is that the Digital
2755 volume control is limited to a maximum of
2756 0dB. ie. it can attenuate but not provide
2757 gain. For most users, this will be desired
2758 as it will prevent clipping. By appending
2759 the 24dB_digital_gain parameter, the Digital
2760 volume control will allow up to 24dB of
2761 gain. If this parameter is enabled, it is the
2762 responsibility of the user to ensure that
2763 the Digital volume control is set to a value
2764 that does not result in clipping/distortion!)
2768 Info: Configures the JustBoom Digi HAT and Digi Zero audio cards
2769 Load: dtoverlay=justboom-digi
2774 Info: This overlay has been deprecated and removed - see gpio-ir
2779 Info: Adds support for the ltc294x family of battery gauges
2780 Load: dtoverlay=ltc294x,<param>=<val>
2781 Params: ltc2941 Select the ltc2941 device
2783 ltc2942 Select the ltc2942 device
2785 ltc2943 Select the ltc2943 device
2787 ltc2944 Select the ltc2944 device
2789 resistor-sense The sense resistor value in milli-ohms.
2790 Can be a 32-bit negative value when the battery
2791 has been connected to the wrong end of the
2794 prescaler-exponent Range and accuracy of the gauge. The value is
2795 programmed into the chip only if it differs
2796 from the current setting.
2798 - Default value is 128
2799 - the exponent is in the range 0-7 (default 7)
2800 See the datasheet for more information.
2804 Info: Configures the Maxim MAX98357A I2S DAC
2805 Load: dtoverlay=max98357a,<param>=<val>
2806 Params: no-sdmode Driver does not manage the state of the DAC's
2807 SD_MODE pin (i.e. chip is always on).
2808 sdmode-pin integer, GPIO pin connected to the SD_MODE input
2809 of the DAC (default GPIO4 if parameter omitted).
2813 Info: Configure a MAX6675, MAX31855 or MAX31856 thermocouple as an IIO device.
2815 For devices on spi1 or spi2, the interfaces should be enabled
2816 with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2817 The overlay expects to disable the relevant spidev node, so also using
2818 e.g. cs0_spidev=off is unnecessary.
2821 MAX31855 on /dev/spidev0.0
2822 dtoverlay=maxtherm,spi0-0,max31855
2823 MAX31856 using a type J thermocouple on /dev/spidev2.1
2825 dtoverlay=maxtherm,spi2-1,max31856,type_j
2827 Load: dtoverlay=maxtherm,<param>=<val>
2828 Params: spi<n>-<m> Configure device at spi<n>, cs<m>
2830 max6675 Enable support for the MAX6675 (default)
2831 max31855 Enable support for the MAX31855
2832 max31855e Enable support for the MAX31855E
2833 max31855j Enable support for the MAX31855J
2834 max31855k Enable support for the MAX31855K
2835 max31855n Enable support for the MAX31855N
2836 max31855r Enable support for the MAX31855R
2837 max31855s Enable support for the MAX31855S
2838 max31855t Enable support for the MAX31855T
2839 max31856 Enable support for the MAX31856 (with type K)
2840 type_b Select a type B sensor for max31856
2841 type_e Select a type E sensor for max31856
2842 type_j Select a type J sensor for max31856
2843 type_k Select a type K sensor for max31856
2844 type_n Select a type N sensor for max31856
2845 type_r Select a type R sensor for max31856
2846 type_s Select a type S sensor for max31856
2847 type_t Select a type T sensor for max31856
2851 Info: Configures the mbed AudioCODEC (TLV320AIC23B)
2852 Load: dtoverlay=mbed-dac
2857 Info: Configures the MCP23017 I2C GPIO expander
2858 Load: dtoverlay=mcp23017,<param>=<val>
2859 Params: gpiopin Gpio pin connected to the INTA output of the
2860 MCP23017 (default: 4)
2862 addr I2C address of the MCP23017 (default: 0x20)
2864 mcp23008 Configure an MCP23008 instead.
2865 noints Disable the interrupt GPIO line.
2866 i2c0 Choose the I2C0 bus on GPIOs 0&1
2867 i2c_csi_dsi Choose the I2C0 bus on GPIOs 44&45
2868 i2c3 Choose the I2C3 bus (configure with the i2c3
2869 overlay - BCM2711 only)
2870 i2c4 Choose the I2C4 bus (configure with the i2c4
2871 overlay - BCM2711 only)
2872 i2c5 Choose the I2C5 bus (configure with the i2c5
2873 overlay - BCM2711 only)
2874 i2c6 Choose the I2C6 bus (configure with the i2c6
2875 overlay - BCM2711 only)
2879 Info: Configures the MCP23S08/17 SPI GPIO expanders.
2880 If devices are present on SPI1 or SPI2, those interfaces must be enabled
2881 with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2882 If interrupts are enabled for a device on a given CS# on a SPI bus, that
2883 device must be the only one present on that SPI bus/CS#.
2884 Load: dtoverlay=mcp23s17,<param>=<val>
2885 Params: s08-spi<n>-<m>-present 4-bit integer, bitmap indicating MCP23S08
2886 devices present on SPI<n>, CS#<m>
2888 s17-spi<n>-<m>-present 8-bit integer, bitmap indicating MCP23S17
2889 devices present on SPI<n>, CS#<m>
2891 s08-spi<n>-<m>-int-gpio integer, enables interrupts on a single
2892 MCP23S08 device on SPI<n>, CS#<m>, specifies
2893 the GPIO pin to which INT output of MCP23S08
2896 s17-spi<n>-<m>-int-gpio integer, enables mirrored interrupts on a
2897 single MCP23S17 device on SPI<n>, CS#<m>,
2898 specifies the GPIO pin to which either INTA
2899 or INTB output of MCP23S17 is connected.
2903 Info: Configures the MCP2515 CAN controller on spi0/1/2
2904 For devices on spi1 or spi2, the interfaces should be enabled
2905 with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2906 Load: dtoverlay=mcp2515,<param>=<val>
2907 Params: spi<n>-<m> Configure device at spi<n>, cs<m>
2910 oscillator Clock frequency for the CAN controller (Hz)
2912 speed Maximum SPI frequence (Hz)
2914 interrupt GPIO for interrupt signal
2918 Info: Configures the MCP2515 CAN controller on spi0.0
2919 Load: dtoverlay=mcp2515-can0,<param>=<val>
2920 Params: oscillator Clock frequency for the CAN controller (Hz)
2922 spimaxfrequency Maximum SPI frequence (Hz)
2924 interrupt GPIO for interrupt signal
2928 Info: Configures the MCP2515 CAN controller on spi0.1
2929 Load: dtoverlay=mcp2515-can1,<param>=<val>
2930 Params: oscillator Clock frequency for the CAN controller (Hz)
2932 spimaxfrequency Maximum SPI frequence (Hz)
2934 interrupt GPIO for interrupt signal
2938 Info: Configures the MCP251XFD CAN controller family
2939 For devices on spi1 or spi2, the interfaces should be enabled
2940 with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2941 Load: dtoverlay=mcp251xfd,<param>=<val>
2942 Params: spi<n>-<m> Configure device at spi<n>, cs<m>
2945 oscillator Clock frequency for the CAN controller (Hz)
2947 speed Maximum SPI frequence (Hz)
2949 interrupt GPIO for interrupt signal
2951 rx_interrupt GPIO for RX interrupt signal (nINT1) (optional)
2953 xceiver_enable GPIO for CAN transceiver enable (optional)
2955 xceiver_active_high specifiy if CAN transceiver enable pin is
2956 active high (optional, default: active low)
2960 Info: Configures MCP3008 A/D converters
2961 For devices on spi1 or spi2, the interfaces should be enabled
2962 with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2963 Load: dtoverlay=mcp3008,<param>[=<val>]
2964 Params: spi<n>-<m>-present boolean, configure device at spi<n>, cs<m>
2965 spi<n>-<m>-speed integer, set the spi bus speed for this device
2969 Info: Configures MCP3202 A/D converters
2970 For devices on spi1 or spi2, the interfaces should be enabled
2971 with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
2972 Load: dtoverlay=mcp3202,<param>[=<val>]
2973 Params: spi<n>-<m>-present boolean, configure device at spi<n>, cs<m>
2974 spi<n>-<m>-speed integer, set the spi bus speed for this device
2978 Info: Overlay for activation of Microchip MCP3421-3428 ADCs over I2C
2979 Load: dtoverlay=mcp342x,<param>=<val>
2980 Params: addr I2C bus address of device, for devices with
2981 addresses that are configurable, e.g. by
2982 hardware links (default=0x68)
2983 mcp3421 The device is an MCP3421
2984 mcp3422 The device is an MCP3422
2985 mcp3423 The device is an MCP3423
2986 mcp3424 The device is an MCP3424
2987 mcp3425 The device is an MCP3425
2988 mcp3426 The device is an MCP3426
2989 mcp3427 The device is an MCP3427
2990 mcp3428 The device is an MCP3428
2994 Info: Media Center HAT - 2.83" Touch Display + extras by Pi Supply
2995 Load: dtoverlay=media-center,<param>=<val>
2996 Params: speed Display SPI bus speed
2997 rotate Display rotation {0,90,180,270}
2998 fps Delay between frame updates
2999 xohms Touchpanel sensitivity (X-plate resistance)
3000 swapxy Swap x and y axis
3001 backlight Change backlight GPIO pin {e.g. 12, 18}
3002 debug "on" = enable additional debug messages
3007 Info: Configures the merus-amp audio card
3008 Load: dtoverlay=merus-amp
3013 Info: Configures UART0 (ttyAMA0) so that a requested 38.4kbaud actually gets
3014 31.25kbaud, the frequency required for MIDI
3015 Load: dtoverlay=midi-uart0
3019 Name: midi-uart0-pi5
3020 Info: See midi-uart0 (this is the Pi 5 version)
3024 Info: Configures UART1 (ttyS0) so that a requested 38.4kbaud actually gets
3025 31.25kbaud, the frequency required for MIDI
3026 Load: dtoverlay=midi-uart1
3030 Name: midi-uart1-pi5
3031 Info: See midi-uart1 (this is the Pi 5 version)
3035 Info: Configures UART2 (ttyAMA2) so that a requested 38.4kbaud actually gets
3036 31.25kbaud, the frequency required for MIDI
3037 Load: dtoverlay=midi-uart2
3041 Name: midi-uart2-pi5
3042 Info: See midi-uart2 (this is the Pi 5 version)
3046 Info: Configures UART3 (ttyAMA3) so that a requested 38.4kbaud actually gets
3047 31.25kbaud, the frequency required for MIDI
3048 Load: dtoverlay=midi-uart3
3052 Name: midi-uart3-pi5
3053 Info: See midi-uart3 (this is the Pi 5 version)
3057 Info: Configures UART4 (ttyAMA4) so that a requested 38.4kbaud actually gets
3058 31.25kbaud, the frequency required for MIDI
3059 Load: dtoverlay=midi-uart4
3063 Name: midi-uart4-pi5
3064 Info: See midi-uart4 (this is the Pi 5 version)
3068 Info: Configures UART5 (ttyAMA5) so that a requested 38.4kbaud actually gets
3069 31.25kbaud, the frequency required for MIDI
3070 Load: dtoverlay=midi-uart5
3075 Info: Overlay for AdaFruit Mini Pi 1.3" TFT via SPI using fbtft driver.
3076 Load: dtoverlay=minipitft13,<param>=<val>
3077 Params: speed SPI bus speed (default 32000000)
3078 rotate Display rotation (0, 90, 180 or 270; default 0)
3079 width Display width (default 240)
3080 height Display height (default 240)
3081 fps Delay between frame updates (default 25)
3082 debug Debug output level (0-7; default 0)
3086 Info: Switch the onboard Bluetooth function of a BT-equipped Raspberry Pi
3087 to use the mini-UART (ttyS0) and restore UART0/ttyAMA0 over GPIOs 14 &
3088 15. Note that this option uses a lower baudrate, and should only be used
3089 with low-bandwidth peripherals.
3090 Load: dtoverlay=miniuart-bt,<param>=<val>
3091 Params: krnbt Set to "off" to disable autoprobing of Bluetooth
3092 driver without need of hciattach/btattach
3096 Info: Overlay for SPI-connected MIPI DBI displays using the panel-mipi-dbi
3097 driver. The driver will load a file /lib/firmware/panel.bin containing
3098 the initialisation commands.
3101 dtoverlay=mipi-dbi-spi,spi0-0,speed=70000000
3102 dtparam=width=320,height=240
3103 dtparam=reset-gpio=23,dc-gpio=24
3104 dtparam=backlight-gpio=18
3106 Compared to fbtft panel-mipi-dbi runs pixel data at spi-max-frequency
3107 and init commands at 10MHz. This makes it possible to push the envelope
3108 without messing up the controller configuration due to command
3109 transmission errors.
3111 For devices on spi1 or spi2, the interfaces should be enabled
3112 with one of the spi1-1/2/3cs and/or spi2-1/2/3cs overlays.
3114 See https://github.com/notro/panel-mipi-dbi/wiki for more info.
3116 Load: dtoverlay=mipi-dbi-spi,<param>=<val>
3118 compatible Set the compatible string to load a different
3119 firmware file. Both the panel compatible value
3120 used to load the firmware file and the value
3121 used to load the driver has to be set having a
3122 NUL (\0) separator between them.
3124 dtparam=compatible=mypanel\0panel-mipi-dbi-spi
3125 spi<n>-<m> Configure device at spi<n>, cs<m>
3127 speed SPI bus speed in Hz (default 32000000)
3128 cpha Shifted SPI clock phase (CPHA) mode
3129 cpol Inverse SPI clock polarity (CPOL) mode
3130 write-only Controller is not readable
3131 (ie. MISO is not wired up).
3133 width Panel width in pixels (required)
3134 height Panel height in pixels (required)
3135 width-mm Panel width in mm
3136 height-mm Panel height in mm
3137 x-offset Panel x-offset in controller RAM
3138 y-offset Panel y-offset in controller RAM
3140 clock-frequency Panel clock frequency in Hz
3141 (optional, just informational).
3143 reset-gpio GPIO pin to be used for RESET
3144 dc-gpio GPIO pin to be used for D/C
3146 backlight-gpio GPIO pin to be used for backlight control
3148 backlight-pwm PWM channel to be used for backlight control
3149 (default of none). NB Disables audio headphone
3150 output as that also uses PWM.
3151 backlight-pwm-chan Choose channel on &pwm node for backlight
3152 control (default 0).
3153 backlight-pwm-gpio GPIO pin to be used for the PWM backlight. See
3154 pwm-2chan for valid options (default 18).
3155 backlight-pwm-func Pin function of GPIO used for the PWM backlight.
3156 See pwm-2chan for valid options (default 2).
3157 backlight-def-brightness
3158 Set the default brightness. Normal range 1-16.
3163 Info: Overlay for i2c connected mlx90640 thermal camera
3164 Load: dtoverlay=mlx90640
3169 Info: Selects the bcm2835-mmc SD/MMC driver, optionally with overclock
3170 Load: dtoverlay=mmc,<param>=<val>
3171 Params: overclock_50 Clock (in MHz) to use when the MMC framework
3176 Info: This overlay has been deprecated - use "dtoverlay=i2c-sensor,mpu6050"
3177 instead. Note that "int_pin" is the new name for the "interrupt"
3183 Info: MZ61581 display by Tontec
3184 Load: dtoverlay=mz61581,<param>=<val>
3185 Params: speed Display SPI bus speed
3187 rotate Display rotation {0,90,180,270}
3189 fps Delay between frame updates
3191 txbuflen Transmit buffer length (default 32768)
3193 debug Debug output level {0-7}
3195 xohms Touchpanel sensitivity (X-plate resistance)
3199 Info: Omnivision OV2311 camera module.
3200 Uses Unicam 1, which is the standard camera connector on most Pi
3202 Load: dtoverlay=ov2311,<param>=<val>
3203 Params: rotation Mounting rotation of the camera sensor (0 or
3205 orientation Sensor orientation (0 = front, 1 = rear,
3206 2 = external, default external)
3207 media-controller Configure use of Media Controller API for
3208 configuring the sensor (default on)
3209 cam0 Adopt the default configuration for CAM0 on a
3210 Compute Module (CSI0, i2c_vc, and cam0_reg).
3214 Info: Omnivision OV5647 camera module.
3215 Uses Unicam 1, which is the standard camera connector on most Pi
3217 Load: dtoverlay=ov5647,<param>=<val>
3218 Params: rotation Mounting rotation of the camera sensor (0 or
3220 orientation Sensor orientation (0 = front, 1 = rear,
3221 2 = external, default external)
3222 media-controller Configure use of Media Controller API for
3223 configuring the sensor (default on)
3224 cam0 Adopt the default configuration for CAM0 on a
3225 Compute Module (CSI0, i2c_vc, and cam0_reg).
3226 vcm Configure a VCM focus drive on the sensor.
3230 Info: Omnivision OV7251 camera module.
3231 Uses Unicam 1, which is the standard camera connector on most Pi
3233 Load: dtoverlay=ov7251,<param>=<val>
3234 Params: rotation Mounting rotation of the camera sensor (0 or
3236 orientation Sensor orientation (0 = front, 1 = rear,
3237 2 = external, default external)
3238 media-controller Configure use of Media Controller API for
3239 configuring the sensor (default off)
3240 cam0 Adopt the default configuration for CAM0 on a
3241 Compute Module (CSI0, i2c_vc, and cam0_reg).
3245 Info: Omnivision OV9281 camera module.
3246 Uses Unicam 1, which is the standard camera connector on most Pi
3248 Load: dtoverlay=ov9281,<param>=<val>
3249 Params: rotation Mounting rotation of the camera sensor (0 or
3251 orientation Sensor orientation (0 = front, 1 = rear,
3252 2 = external, default external)
3253 media-controller Configure use of Media Controller API for
3254 configuring the sensor (default on)
3255 cam0 Adopt the default configuration for CAM0 on a
3256 Compute Module (CSI0, i2c_vc, and cam0_reg).
3260 Info: PaPiRus ePaper Screen by Pi Supply (both HAT and pHAT)
3261 Load: dtoverlay=papirus,<param>=<val>
3262 Params: panel Display panel (required):
3267 speed Display SPI bus speed
3271 Info: TI PCA953x family of I2C GPIO expanders. Default is for NXP PCA9534.
3272 Load: dtoverlay=pca953x,<param>=<val>
3273 Params: addr I2C address of expander. Default 0x20.
3274 pca6416 Select the NXP PCA6416 (16 bit)
3275 pca9505 Select the NXP PCA9505 (40 bit)
3276 pca9535 Select the NXP PCA9535 (16 bit)
3277 pca9536 Select the NXP PCA9536 or TI PCA9536 (4 bit)
3278 pca9537 Select the NXP PCA9537 (4 bit)
3279 pca9538 Select the NXP PCA9538 (8 bit)
3280 pca9539 Select the NXP PCA9539 (16 bit)
3281 pca9554 Select the NXP PCA9554 (8 bit)
3282 pca9555 Select the NXP PCA9555 (16 bit)
3283 pca9556 Select the NXP PCA9556 (8 bit)
3284 pca9557 Select the NXP PCA9557 (8 bit)
3285 pca9574 Select the NXP PCA9574 (8 bit)
3286 pca9575 Select the NXP PCA9575 (16 bit)
3287 pca9698 Select the NXP PCA9698 (40 bit)
3288 pcal6416 Select the NXP PCAL6416 (16 bit)
3289 pcal6524 Select the NXP PCAL6524 (24 bit)
3290 pcal9555a Select the NXP PCAL9555A (16 bit)
3291 max7310 Select the Maxim MAX7310 (8 bit)
3292 max7312 Select the Maxim MAX7312 (16 bit)
3293 max7313 Select the Maxim MAX7313 (16 bit)
3294 max7315 Select the Maxim MAX7315 (8 bit)
3295 pca6107 Select the TI PCA6107 (8 bit)
3296 tca6408 Select the TI TCA6408 (8 bit)
3297 tca6416 Select the TI TCA6416 (16 bit)
3298 tca6424 Select the TI TCA6424 (24 bit)
3299 tca9539 Select the TI TCA9539 (16 bit)
3300 tca9554 Select the TI TCA9554 (8 bit)
3301 cat9554 Select the Onnn CAT9554 (8 bit)
3302 pca9654 Select the Onnn PCA9654 (8 bit)
3303 xra1202 Select the Exar XRA1202 (8 bit)
3307 Info: NXP PCF857x family of I2C GPIO expanders.
3308 Load: dtoverlay=pcf857x,<param>=<val>
3309 Params: addr I2C address of expander. Default
3310 depends on model selected.
3311 pcf8574 Select the NXP PCF8574 (8 bit)
3312 pcf8574a Select the NXP PCF8574A (8 bit)
3313 pcf8575 Select the NXP PCF8575 (16 bit)
3314 pca8574 Select the NXP PCA8574 (8 bit)
3317 Name: pcie-32bit-dma
3318 Info: Force PCIe config to support 32bit DMA addresses at the expense of
3319 having to bounce buffers.
3320 Load: dtoverlay=pcie-32bit-dma
3324 [ The pcf2127-rtc overlay has been deleted. See i2c-rtc. ]
3327 [ The pcf8523-rtc overlay has been deleted. See i2c-rtc. ]
3330 [ The pcf8563-rtc overlay has been deleted. See i2c-rtc. ]
3334 Info: This overlay has been renamed act-led, keeping pi3-act-led as an alias
3335 for backwards compatibility.
3339 Name: pi3-disable-bt
3340 Info: This overlay has been renamed disable-bt, keeping pi3-disable-bt as an
3341 alias for backwards compatibility.
3345 Name: pi3-disable-wifi
3346 Info: This overlay has been renamed disable-wifi, keeping pi3-disable-wifi as
3347 an alias for backwards compatibility.
3351 Name: pi3-miniuart-bt
3352 Info: This overlay has been renamed miniuart-bt, keeping pi3-miniuart-bt as
3353 an alias for backwards compatibility.
3358 Info: Configures the pibell audio card.
3359 Load: dtoverlay=pibell,<param>=<val>
3360 Params: alsaname Set the name as it appears in ALSA (default
3365 Info: Configures the PiFace Digital mcp23s17 GPIO port expander.
3366 Load: dtoverlay=pifacedigital,<param>=<val>
3367 Params: spi-present-mask 8-bit integer, bitmap indicating MCP23S17 SPI0
3368 CS0 address. PiFace Digital supports addresses
3369 0-3, which can be configured with JP1 and JP2.
3373 Info: Configures the PiFi 40W stereo amplifier
3374 Load: dtoverlay=pifi-40
3379 Info: Configures the PiFi DAC HD
3380 Load: dtoverlay=pifi-dac-hd
3385 Info: Configures the PiFi DAC Zero
3386 Load: dtoverlay=pifi-dac-zero
3391 Info: Configures the PiFi Mini stereo amplifier
3392 Load: dtoverlay=pifi-mini-210
3397 Info: Configures the PiGlow by pimoroni.com
3398 Load: dtoverlay=piglow
3403 Info: PiScreen display by OzzMaker.com
3404 Load: dtoverlay=piscreen,<param>=<val>
3405 Params: speed Display SPI bus speed
3407 rotate Display rotation {0,90,180,270}
3409 fps Delay between frame updates
3411 debug Debug output level {0-7}
3413 xohms Touchpanel sensitivity (X-plate resistance)
3415 drm Select the DRM/KMS driver instead of the FBTFT
3420 Info: PiScreen 2 with resistive TP display by OzzMaker.com
3421 Load: dtoverlay=piscreen2r,<param>=<val>
3422 Params: speed Display SPI bus speed
3424 rotate Display rotation {0,90,180,270}
3426 fps Delay between frame updates
3428 debug Debug output level {0-7}
3430 xohms Touchpanel sensitivity (X-plate resistance)
3434 Info: Configures the Blokas Labs pisound card
3435 Load: dtoverlay=pisound
3440 Info: Adafruit PiTFT 2.2" screen
3441 Load: dtoverlay=pitft22,<param>=<val>
3442 Params: speed Display SPI bus speed
3444 rotate Display rotation {0,90,180,270}
3446 fps Delay between frame updates
3448 debug Debug output level {0-7}
3451 Name: pitft28-capacitive
3452 Info: Adafruit PiTFT 2.8" capacitive touch screen
3453 Load: dtoverlay=pitft28-capacitive,<param>=<val>
3454 Params: speed Display SPI bus speed
3456 rotate Display rotation {0,90,180,270}
3458 fps Delay between frame updates
3460 debug Debug output level {0-7}
3462 touch-sizex Touchscreen size x (default 240)
3464 touch-sizey Touchscreen size y (default 320)
3466 touch-invx Touchscreen inverted x axis
3468 touch-invy Touchscreen inverted y axis
3470 touch-swapxy Touchscreen swapped x y axis
3473 Name: pitft28-resistive
3474 Info: Adafruit PiTFT 2.8" resistive touch screen
3475 Load: dtoverlay=pitft28-resistive,<param>=<val>
3476 Params: speed Display SPI bus speed
3478 rotate Display rotation {0,90,180,270}
3480 fps Delay between frame updates
3482 debug Debug output level {0-7}
3484 drm Force the use of the mi0283qt DRM driver (by
3485 default the ili9340 framebuffer driver will
3486 be used in preference if available)
3489 Name: pitft35-resistive
3490 Info: Adafruit PiTFT 3.5" resistive touch screen
3491 Load: dtoverlay=pitft35-resistive,<param>=<val>
3492 Params: speed Display SPI bus speed
3494 rotate Display rotation {0,90,180,270}
3496 fps Delay between frame updates
3498 debug Debug output level {0-7}
3500 drm Force the use of the hx8357d DRM driver (by
3501 default the fb_hx8357d framebuffer driver will
3502 be used in preference if available)
3506 Info: Configures the pps-gpio (pulse-per-second time signal via GPIO).
3507 Load: dtoverlay=pps-gpio,<param>=<val>
3508 Params: gpiopin Input GPIO (default "18")
3509 assert_falling_edge When present, assert is indicated by a falling
3510 edge, rather than by a rising edge (default
3512 capture_clear Generate clear events on the trailing edge
3514 pull Desired pull-up/down state (off, down, up)
3519 Info: Configures the PROTO Audio Codec card
3520 Load: dtoverlay=proto-codec
3525 Info: Configures a single PWM channel
3526 Legal pin,function combinations for each channel:
3527 PWM0: 12,4(Alt0) 18,2(Alt5) 40,4(Alt0) 52,5(Alt1)
3528 PWM1: 13,4(Alt0) 19,2(Alt5) 41,4(Alt0) 45,4(Alt0) 53,5(Alt1)
3530 1) Pin 18 is the only one available on all platforms, and
3531 it is the one used by the I2S audio interface.
3532 Pins 12 and 13 might be better choices on an A+, B+ or Pi2.
3533 2) The onboard analogue audio output uses both PWM channels.
3534 3) So be careful mixing audio and PWM.
3535 4) Currently the clock must have been enabled and configured
3537 Load: dtoverlay=pwm,<param>=<val>
3538 Params: pin Output pin (default 18) - see table
3539 func Pin function (default 2 = Alt5) - see above
3540 clock PWM clock frequency (informational)
3544 Info: Configures both PWM channels
3545 Legal pin,function combinations for each channel:
3546 PWM0: 12,4(Alt0) 18,2(Alt5) 40,4(Alt0) 52,5(Alt1)
3547 PWM1: 13,4(Alt0) 19,2(Alt5) 41,4(Alt0) 45,4(Alt0) 53,5(Alt1)
3549 1) Pin 18 is the only one available on all platforms, and
3550 it is the one used by the I2S audio interface.
3551 Pins 12 and 13 might be better choices on an A+, B+ or Pi2.
3552 2) The onboard analogue audio output uses both PWM channels.
3553 3) So be careful mixing audio and PWM.
3554 4) Currently the clock must have been enabled and configured
3556 Load: dtoverlay=pwm-2chan,<param>=<val>
3557 Params: pin Output pin (default 18) - see table
3558 pin2 Output pin for other channel (default 19)
3559 func Pin function (default 2 = Alt5) - see above
3560 func2 Function for pin2 (default 2 = Alt5)
3561 clock PWM clock frequency (informational)
3565 Info: Use GPIO pin as pwm-assisted infrared transmitter output.
3566 This is an alternative to "gpio-ir-tx". pwm-ir-tx makes use
3567 of PWM0 to reduce the CPU load during transmission compared to
3568 gpio-ir-tx which uses bit-banging.
3569 Legal pin,function combinations are:
3570 12,4(Alt0) 18,2(Alt5) 40,4(Alt0) 52,5(Alt1)
3571 Load: dtoverlay=pwm-ir-tx,<param>=<val>
3572 Params: gpio_pin Output GPIO (default 18)
3574 func Pin function (default 2 = Alt5)
3578 Info: Configures one or two PWM channel on PWM1 (BCM2711 only)
3580 1) The onboard analogue audio output uses both PWM channels.
3581 2) So be careful mixing audio and PWM.
3582 Note that even when only one pin is enabled, both channels are available
3583 from the PWM driver, so be careful to use the correct one.
3584 Load: dtoverlay=pwm1,<param>=<val>
3585 Params: clock PWM clock frequency (informational)
3586 pins_40 Enable channel 0 (PWM1_0) on GPIO 40
3587 pins_41 Enable channel 1 (PWM1_1) on GPIO 41
3588 pins_40_41 Enable channels 0 (PWM1_0) and 1 (PW1_1) on
3589 GPIOs 40 and 41 (default)
3590 pull_up Enable pull-ups on the PWM pins (default)
3591 pull_down Enable pull-downs on the PWM pins
3592 pull_off Disable pulls on the PWM pins
3596 Info: in-tech's Evaluation Board for PLC Stamp micro
3597 This uses spi0 and a separate GPIO interrupt to connect the QCA7000.
3598 Load: dtoverlay=qca7000,<param>=<val>
3599 Params: int_pin GPIO pin for interrupt signal (default 23)
3601 speed SPI bus speed (default 12 MHz)
3605 Info: in-tech's Evaluation Board for PLC Stamp micro (UART)
3606 This uses uart0/ttyAMA0 over GPIOs 14 & 15 to connect the QCA7000.
3607 But it requires disabling of onboard Bluetooth on
3608 Pi 3B, 3B+, 3A+, 4B and Zero W.
3609 Load: dtoverlay=qca7000-uart0,<param>=<val>
3610 Params: baudrate Set the baudrate for the UART (default
3615 Info: Enable the preservation of crash logs across a reboot. With
3616 systemd-pstore enabled (as it is on Raspberry Pi OS) the crash logs
3617 are moved to /var/lib/systemd/pstore/ on reboot.
3618 Load: dtoverlay=ramoops,<param>=<val>
3619 Params: base-addr Where to place the capture buffer (default
3621 total-size How much memory to allocate altogether (in
3622 bytes - default 64kB)
3623 record-size How much space to use for each capture, i.e.
3624 total-size / record-size = number of captures
3626 console-size Size of non-panic dmesg captures (default 0)
3630 Info: The version of the ramoops overlay for the Pi 4 family. It should be
3631 loaded automatically if dtoverlay=ramoops is specified on a Pi 4.
3632 Load: dtoverlay=ramoops-pi4,<param>=<val>
3633 Params: base-addr Where to place the capture buffer (default
3635 total-size How much memory to allocate altogether (in
3636 bytes - default 64kB)
3637 record-size How much space to use for each capture, i.e.
3638 total-size / record-size = number of captures
3640 console-size Size of non-panic dmesg captures (default 0)
3643 Name: rotary-encoder
3644 Info: Overlay for GPIO connected rotary encoder.
3645 Load: dtoverlay=rotary-encoder,<param>=<val>
3646 Params: pin_a GPIO connected to rotary encoder channel A
3648 pin_b GPIO connected to rotary encoder channel B
3650 relative_axis register a relative axis rather than an
3651 absolute one. Relative axis will only
3652 generate +1/-1 events on the input device,
3653 hence no steps need to be passed.
3654 linux_axis the input subsystem axis to map to this
3655 rotary encoder. Defaults to 0 (ABS_X / REL_X)
3656 rollover Automatic rollover when the rotary value
3657 becomes greater than the specified steps or
3658 smaller than 0. For absolute axis only.
3659 steps-per-period Number of steps (stable states) per period.
3660 The values have the following meaning:
3661 1: Full-period mode (default)
3663 4: Quarter-period mode
3664 steps Number of steps in a full turnaround of the
3665 encoder. Only relevant for absolute axis.
3666 Defaults to 24 which is a typical value for
3668 wakeup Boolean, rotary encoder can wake up the
3670 encoding String, the method used to encode steps.
3671 Supported are "gray" (the default and more
3672 common) and "binary".
3676 Info: Raspberry Pi official display backlight driver
3677 Load: dtoverlay=rpi-backlight
3681 Name: rpi-cirrus-wm5102
3682 Info: This overlay has been renamed to cirrus-wm5102
3687 Info: Configures the Raspberry Pi Codec Zero sound card
3688 Load: dtoverlay=rpi-codeczero
3693 Info: This overlay has been renamed to i2s-dac.
3698 Info: Configures the Raspberry Pi DAC+ card
3699 Load: dtoverlay=rpi-dacplus,<param>=<val>
3700 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
3701 digital volume control. Enable by adding
3702 "dtparam=24db_digital_gain" to config.txt
3703 before any "dtoverlay" lines.
3704 The default behaviour is that the digital
3705 volume control is limited to a maximum of
3706 0dB. ie. it can attenuate but not provide
3707 gain. For most users, this will be desired
3708 as it will prevent clipping. By appending
3709 the 24db_digital_gain parameter, the digital
3710 volume control will allow up to 24dB of
3711 gain. If this parameter is enabled, it is the
3712 responsibility of the user to ensure that
3713 the digital volume control is set to a value
3714 that does not result in clipping/distortion!
3718 Info: Configures the Raspberry Pi DAC Pro sound card
3719 Load: dtoverlay=rpi-dacpro,<param>=<val>
3720 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
3721 digital volume control. Enable by adding
3722 "dtparam=24db_digital_gain" to config.txt
3723 before any "dtoverlay" lines.
3724 The default behaviour is that the digital
3725 volume control is limited to a maximum of
3726 0dB. ie. it can attenuate but not provide
3727 gain. For most users, this will be desired
3728 as it will prevent clipping. By appending
3729 the 24db_digital_gain parameter, the digital
3730 volume control will allow up to 24dB of
3731 gain. If this parameter is enabled, it is the
3732 responsibility of the user to ensure that
3733 the digital volume control is set to a value
3734 that does not result in clipping/distortion!
3737 Name: rpi-digiampplus
3738 Info: Configures the Raspberry Pi DigiAMP+ sound card
3739 Load: dtoverlay=rpi-digiampplus,<param>=<val>
3740 Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
3741 digital volume control. Enable by adding
3742 "dtparam=24db_digital_gain" to config.txt
3743 before any "dtoverlay" lines.
3744 The default behaviour is that the digital
3745 volume control is limited to a maximum of
3746 0dB. ie. it can attenuate but not provide
3747 gain. For most users, this will be desired
3748 as it will prevent clipping. By appending
3749 the 24db_digital_gain parameter, the digital
3750 volume control will allow up to 24dB of
3751 gain. If this parameter is enabled, it is the
3752 responsibility of the user to ensure that
3753 the digital volume control is set to a value
3754 that does not result in clipping/distortion!
3755 auto_mute_amp If specified, unmute/mute the DigiAMP+ when
3756 starting/stopping audio playback (default "on").
3757 unmute_amp If specified, unmute the DigiAMP+ amp once when
3758 the DAC driver module loads (default "off").
3762 Info: This overlay has been renamed to watterott-display
3767 Info: Official Raspberry Pi display touchscreen
3768 Load: dtoverlay=rpi-ft5406,<param>=<val>
3769 Params: touchscreen-size-x Touchscreen X resolution (default 800)
3770 touchscreen-size-y Touchscreen Y resolution (default 480);
3771 touchscreen-inverted-x Invert touchscreen X coordinates (default 0);
3772 touchscreen-inverted-y Invert touchscreen Y coordinates (default 0);
3773 touchscreen-swapped-x-y Swap X and Y cordinates (default 0);
3777 Info: Raspberry Pi PoE HAT fan
3778 Load: dtoverlay=rpi-poe,<param>[=<val>]
3779 Params: poe_fan_temp0 Temperature (in millicelcius) at which the fan
3780 turns on (default 40000)
3781 poe_fan_temp0_hyst Temperature delta (in millicelcius) at which
3782 the fan turns off (default 2000)
3783 poe_fan_temp1 Temperature (in millicelcius) at which the fan
3784 speeds up (default 45000)
3785 poe_fan_temp1_hyst Temperature delta (in millicelcius) at which
3786 the fan slows down (default 2000)
3787 poe_fan_temp2 Temperature (in millicelcius) at which the fan
3788 speeds up (default 50000)
3789 poe_fan_temp2_hyst Temperature delta (in millicelcius) at which
3790 the fan slows down (default 2000)
3791 poe_fan_temp3 Temperature (in millicelcius) at which the fan
3792 speeds up (default 55000)
3793 poe_fan_temp3_hyst Temperature delta (in millicelcius) at which
3794 the fan slows down (default 5000)
3795 i2c Control the fan via Linux I2C drivers instead of
3800 Info: Raspberry Pi PoE+ HAT fan
3801 Load: dtoverlay=rpi-poe-plus,<param>[=<val>]
3802 Params: poe_fan_temp0 Temperature (in millicelcius) at which the fan
3803 turns on (default 40000)
3804 poe_fan_temp0_hyst Temperature delta (in millicelcius) at which
3805 the fan turns off (default 2000)
3806 poe_fan_temp1 Temperature (in millicelcius) at which the fan
3807 speeds up (default 45000)
3808 poe_fan_temp1_hyst Temperature delta (in millicelcius) at which
3809 the fan slows down (default 2000)
3810 poe_fan_temp2 Temperature (in millicelcius) at which the fan
3811 speeds up (default 50000)
3812 poe_fan_temp2_hyst Temperature delta (in millicelcius) at which
3813 the fan slows down (default 2000)
3814 poe_fan_temp3 Temperature (in millicelcius) at which the fan
3815 speeds up (default 55000)
3816 poe_fan_temp3_hyst Temperature delta (in millicelcius) at which
3817 the fan slows down (default 5000)
3818 i2c Control the fan via Linux I2C drivers instead of
3823 Info: This overlay has been renamed to proto-codec.
3828 Info: Raspberry Pi Sense HAT
3829 Load: dtoverlay=rpi-sense
3834 Info: Raspberry Pi Sense HAT v2
3835 Load: dtoverlay=rpi-sense-v2
3840 Info: Raspberry Pi TV HAT
3841 Load: dtoverlay=rpi-tv
3846 Info: This overlay has been deprecated and deleted as the V4L2 stateless
3847 video decoder driver is enabled by default.
3851 Name: rra-digidac1-wm8741-audio
3852 Info: Configures the Red Rocks Audio DigiDAC1 soundcard
3853 Load: dtoverlay=rra-digidac1-wm8741-audio
3858 Info: Overlay for the SPI-connected Sainsmart 1.8" display (based on the
3860 Load: dtoverlay=sainsmart18,<param>=<val>
3861 Params: rotate Display rotation {0,90,180,270}
3862 speed SPI bus speed in Hz (default 4000000)
3863 fps Display frame rate in Hz
3864 bgr Enable BGR mode (default off)
3865 debug Debug output level {0-7}
3866 dc_pin GPIO pin for D/C (default 24)
3867 reset_pin GPIO pin for RESET (default 25)
3871 Info: Overlay for the NXP SC16IS750 UART with I2C Interface
3872 Enables the chip on I2C1 at 0x48 (or the "addr" parameter value). To
3873 select another address, please refer to table 10 in reference manual.
3874 Load: dtoverlay=sc16is750-i2c,<param>=<val>
3875 Params: int_pin GPIO used for IRQ (default 24)
3876 addr Address (default 0x48)
3877 xtal On-board crystal frequency (default 14745600)
3881 Info: Overlay for the NXP SC16IS752 dual UART with I2C Interface
3882 Enables the chip on I2C1 at 0x48 (or the "addr" parameter value). To
3883 select another address, please refer to table 10 in reference manual.
3884 Load: dtoverlay=sc16is752-i2c,<param>=<val>
3885 Params: int_pin GPIO used for IRQ (default 24)
3886 addr Address (default 0x48)
3887 xtal On-board crystal frequency (default 14745600)
3890 Name: sc16is752-spi0
3891 Info: Overlay for the NXP SC16IS752 Dual UART with SPI Interface
3892 Enables the chip on SPI0.
3893 Load: dtoverlay=sc16is752-spi0,<param>=<val>
3894 Params: int_pin GPIO used for IRQ (default 24)
3895 xtal On-board crystal frequency (default 14745600)
3898 Name: sc16is752-spi1
3899 Info: Overlay for the NXP SC16IS752 Dual UART with SPI Interface
3900 Enables the chip on SPI1.
3901 N.B.: spi1 is only accessible on devices with a 40pin header, eg:
3902 A+, B+, Zero and PI2 B; as well as the Compute Module.
3904 Load: dtoverlay=sc16is752-spi1,<param>=<val>
3905 Params: int_pin GPIO used for IRQ (default 24)
3906 xtal On-board crystal frequency (default 14745600)
3910 Info: Selects the bcm2835-sdhost SD/MMC driver, optionally with overclock.
3911 N.B. This overlay is designed for situations where the mmc driver is
3912 the default, so it disables the other (mmc) interface - this will kill
3913 WLAN on a Pi3. If this isn't what you want, either use the sdtweak
3914 overlay or the new sd_* dtparams of the base DTBs.
3915 Load: dtoverlay=sdhost,<param>=<val>
3916 Params: overclock_50 Clock (in MHz) to use when the MMC framework
3919 force_pio Disable DMA support (default off)
3921 pio_limit Number of blocks above which to use DMA
3924 debug Enable debug output (default off)
3928 Info: Selects the bcm2835-sdhost SD/MMC driver, optionally with overclock,
3929 and enables SDIO via GPIOs 22-27. An example of use in 1-bit mode is
3930 "dtoverlay=sdio,bus_width=1,gpios_22_25"
3931 Load: dtoverlay=sdio,<param>=<val>
3932 Params: sdio_overclock SDIO Clock (in MHz) to use when the MMC
3933 framework requests 50MHz
3935 poll_once Disable SDIO-device polling every second
3936 (default on: polling once at boot-time)
3938 bus_width Set the SDIO host bus width (default 4 bits)
3940 gpios_22_25 Select GPIOs 22-25 for 1-bit mode. Must be used
3941 with bus_width=1. This replaces the sdio-1bit
3942 overlay, which is now deprecated.
3944 gpios_34_37 Select GPIOs 34-37 for 1-bit mode. Must be used
3947 gpios_34_39 Select GPIOs 34-39 for 4-bit mode. Must be used
3948 with bus_width=4 (the default).
3952 Info: This overlay is now deprecated. Use
3953 "dtoverlay=sdio,bus_width=1,gpios_22_25" instead.
3958 Info: Selects the rp1_mmc0 interface and enables it on GPIOs 22-27.
3960 Load: dtoverlay=sdio-pi5
3965 Info: This overlay is now deprecated. Use the sd_* dtparams in the
3966 base DTB, e.g. "dtoverlay=sdtweak,poll_once" becomes
3967 "dtparam=sd_poll_once".
3971 Name: seeed-can-fd-hat-v1
3972 Info: Overlay for Seeed Studio CAN BUS FD HAT with two CAN FD
3973 channels without RTC. Use this overlay if your HAT has no
3975 https://www.seeedstudio.com/2-Channel-CAN-BUS-FD-Shield-for-Raspberry-Pi-p-4072.html
3976 Load: dtoverlay=seeed-can-fd-hat-v1
3980 Name: seeed-can-fd-hat-v2
3981 Info: Overlay for Seeed Studio CAN BUS FD HAT with two CAN FD
3982 channels and an RTC. Use this overlay if your HAT has a
3984 https://www.seeedstudio.com/CAN-BUS-FD-HAT-for-Raspberry-Pi-p-4742.html
3985 Load: dtoverlay=seeed-can-fd-hat-v2
3990 Info: Overlay for SH1106 OLED via SPI using fbtft staging driver.
3991 Load: dtoverlay=sh1106-spi,<param>=<val>
3992 Params: speed SPI bus speed (default 4000000)
3993 rotate Display rotation (0, 90, 180 or 270; default 0)
3994 fps Delay between frame updates (default 25)
3995 debug Debug output level (0-7; default 0)
3996 dc_pin GPIO pin for D/C (default 24)
3997 reset_pin GPIO pin for RESET (default 25)
3998 height Display height (32 or 64; default 64)
4002 Info: Overlay for Si446x UHF Transceiver via SPI using si446x driver.
4003 The driver is currently out-of-tree at
4004 https://github.com/sunipkmukherjee/silabs.git
4005 Load: dtoverlay=si446x-spi0,<param>=<val>
4006 Params: speed SPI bus speed (default 4000000)
4007 int_pin GPIO pin for interrupts (default 17)
4008 reset_pin GPIO pin for RESET (default 27)
4012 Info: Enables the Secondary Memory Interface peripheral. Uses GPIOs 2-25!
4018 Info: Enables the userspace interface for the SMI driver
4019 Load: dtoverlay=smi-dev
4024 Info: Enables access to NAND flash via the SMI interface
4025 Load: dtoverlay=smi-nand
4030 Info: Move SPI function block to GPIO 35 to 39
4031 Load: dtoverlay=spi-gpio35-39
4036 Info: Move SPI function block to GPIOs 40 to 45
4037 Load: dtoverlay=spi-gpio40-45
4042 Info: Adds support for a number of SPI Real Time Clock devices
4043 Load: dtoverlay=spi-rtc,<param>=<val>
4044 Params: ds3232 Select the DS3232 device
4045 ds3234 Select the DS3234 device
4046 pcf2123 Select the PCF2123 device
4048 spi0_0 Use spi0.0 (default)
4054 cs_high This device requires an active-high CS
4058 Info: Don't claim any CS pins for SPI0. Requires a device with its chip
4059 select permanently enabled, but frees a GPIO for e.g. a DPI display.
4060 Load: dtoverlay=spi0-0cs,<param>=<val>
4061 Params: no_miso Don't claim and use the MISO pin (9), freeing
4066 Info: Only use one CS pin for SPI0
4067 Load: dtoverlay=spi0-1cs,<param>=<val>
4068 Params: cs0_pin GPIO pin for CS0 (default 8)
4069 no_miso Don't claim and use the MISO pin (9), freeing
4074 Info: Change the CS pins for SPI0
4075 Load: dtoverlay=spi0-2cs,<param>=<val>
4076 Params: cs0_pin GPIO pin for CS0 (default 8)
4077 cs1_pin GPIO pin for CS1 (default 7)
4078 no_miso Don't claim and use the MISO pin (9), freeing
4083 Info: This overlay has been renamed spi0-2cs, keeping spi0-cs as an
4084 alias for backwards compatibility.
4089 Info: This overlay has been deprecated and removed because it is no longer
4090 necessary and has been seen to prevent spi0 from working.
4095 Info: Enables spi1 with a single chip select (CS) line and associated spidev
4096 dev node. The gpio pin number for the CS line and spidev device node
4097 creation are configurable.
4098 N.B.: spi1 is not accessible on old Pis without a 40-pin header.
4099 Load: dtoverlay=spi1-1cs,<param>=<val>
4100 Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI1_CE0).
4101 cs0_spidev Set to 'off' to stop the creation of a
4102 userspace device node /dev/spidev1.0 (default
4103 is 'on' or enabled).
4107 Info: Enables spi1 with two chip select (CS) lines and associated spidev
4108 dev nodes. The gpio pin numbers for the CS lines and spidev device node
4109 creation are configurable.
4110 N.B.: spi1 is not accessible on old Pis without a 40-pin header.
4111 Load: dtoverlay=spi1-2cs,<param>=<val>
4112 Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI1_CE0).
4113 cs1_pin GPIO pin for CS1 (default 17 - BCM SPI1_CE1).
4114 cs0_spidev Set to 'off' to stop the creation of a
4115 userspace device node /dev/spidev1.0 (default
4116 is 'on' or enabled).
4117 cs1_spidev Set to 'off' to stop the creation of a
4118 userspace device node /dev/spidev1.1 (default
4119 is 'on' or enabled).
4123 Info: Enables spi1 with three chip select (CS) lines and associated spidev
4124 dev nodes. The gpio pin numbers for the CS lines and spidev device node
4125 creation are configurable.
4126 N.B.: spi1 is not accessible on old Pis without a 40-pin header.
4127 Load: dtoverlay=spi1-3cs,<param>=<val>
4128 Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI1_CE0).
4129 cs1_pin GPIO pin for CS1 (default 17 - BCM SPI1_CE1).
4130 cs2_pin GPIO pin for CS2 (default 16 - BCM SPI1_CE2).
4131 cs0_spidev Set to 'off' to stop the creation of a
4132 userspace device node /dev/spidev1.0 (default
4133 is 'on' or enabled).
4134 cs1_spidev Set to 'off' to stop the creation of a
4135 userspace device node /dev/spidev1.1 (default
4136 is 'on' or enabled).
4137 cs2_spidev Set to 'off' to stop the creation of a
4138 userspace device node /dev/spidev1.2 (default
4139 is 'on' or enabled).
4143 Info: Enables spi2 on GPIOs 40-42 with a single chip select (CS) line and
4144 associated spidev dev node. The gpio pin number for the CS line and
4145 spidev device node creation are configurable. spi2-2cs-pi5 is
4146 substituted on a Pi 5.
4147 N.B.: spi2 is only accessible with the Compute Module or Pi 5.
4148 Load: dtoverlay=spi2-1cs,<param>=<val>
4149 Params: cs0_pin GPIO pin for CS0 (default 43 - BCM SPI2_CE0).
4150 cs0_spidev Set to 'off' to stop the creation of a
4151 userspace device node /dev/spidev2.0 (default
4152 is 'on' or enabled).
4156 Info: Enables spi2 on GPIOs 1-3 with a single chip select (CS) line and
4157 associated spidev dev node. The gpio pin number for the CS line and
4158 spidev device node creation are configurable. Pi 5 only.
4159 Load: dtoverlay=spi2-1cs-pi5,<param>=<val>
4160 Params: cs0_pin GPIO pin for CS0 (default 0).
4161 cs0_spidev Set to 'off' to stop the creation of a
4162 userspace device node /dev/spidev2.0 (default
4163 is 'on' or enabled).
4167 Info: Enables spi2 on GPIOs 40-42 with two chip select (CS) lines and
4168 associated spidev dev nodes. The gpio pin numbers for the CS lines and
4169 spidev device node creation are configurable. spi2-2cs-pi5 is
4170 substituted on a Pi 5.
4171 N.B.: spi2 is only accessible with the Compute Module or Pi 5.
4172 Load: dtoverlay=spi2-2cs,<param>=<val>
4173 Params: cs0_pin GPIO pin for CS0 (default 43 - BCM SPI2_CE0).
4174 cs1_pin GPIO pin for CS1 (default 44 - BCM SPI2_CE1).
4175 cs0_spidev Set to 'off' to stop the creation of a
4176 userspace device node /dev/spidev2.0 (default
4177 is 'on' or enabled).
4178 cs1_spidev Set to 'off' to stop the creation of a
4179 userspace device node /dev/spidev2.1 (default
4180 is 'on' or enabled).
4184 Info: Enables spi2 on GPIOs 1-3 with two chip select (CS) lines and
4185 associated spidev dev nodes. The gpio pin numbers for the CS lines and
4186 spidev device node creation are configurable. Pi 5 only.
4187 Load: dtoverlay=spi2-2cs-pi5,<param>=<val>
4188 Params: cs0_pin GPIO pin for CS0 (default 0).
4189 cs1_pin GPIO pin for CS1 (default 24).
4190 cs0_spidev Set to 'off' to stop the creation of a
4191 userspace device node /dev/spidev2.0 (default
4192 is 'on' or enabled).
4193 cs1_spidev Set to 'off' to stop the creation of a
4194 userspace device node /dev/spidev2.1 (default
4195 is 'on' or enabled).
4199 Info: Enables spi2 on GPIOs 40-42 with three chip select (CS) lines and
4200 associated spidev dev nodes. The gpio pin numbers for the CS lines and
4201 spidev device node creation are configurable.
4202 N.B.: spi2 is only accessible with the Compute Module or Pi 5.
4203 Load: dtoverlay=spi2-3cs,<param>=<val>
4204 Params: cs0_pin GPIO pin for CS0 (default 43 - BCM SPI2_CE0).
4205 cs1_pin GPIO pin for CS1 (default 44 - BCM SPI2_CE1).
4206 cs2_pin GPIO pin for CS2 (default 45 - BCM SPI2_CE2).
4207 cs0_spidev Set to 'off' to stop the creation of a
4208 userspace device node /dev/spidev2.0 (default
4209 is 'on' or enabled).
4210 cs1_spidev Set to 'off' to stop the creation of a
4211 userspace device node /dev/spidev2.1 (default
4212 is 'on' or enabled).
4213 cs2_spidev Set to 'off' to stop the creation of a
4214 userspace device node /dev/spidev2.2 (default
4215 is 'on' or enabled).
4219 Info: Enables spi3 on GPIOs 1-3 with a single chip select (CS) line and
4220 associated spidev dev node. The gpio pin number for the CS line and
4221 spidev device node creation are configurable. BCM2711 only,
4222 spi3-1cs-pi5 is substituted on Pi 5.
4223 Load: dtoverlay=spi3-1cs,<param>=<val>
4224 Params: cs0_pin GPIO pin for CS0 (default 0 - BCM SPI3_CE0).
4225 cs0_spidev Set to 'off' to prevent the creation of a
4226 userspace device node /dev/spidev3.0 (default
4227 is 'on' or enabled).
4231 Info: Enables spi3 on GPIOs 5-7 with a single chip select (CS) line and
4232 associated spidev dev node. The gpio pin number for the CS line and
4233 spidev device node creation are configurable. Pi 5 only.
4234 Load: dtoverlay=spi3-1cs-pi5,<param>=<val>
4235 Params: cs0_pin GPIO pin for CS0 (default 4).
4236 cs0_spidev Set to 'off' to prevent the creation of a
4237 userspace device node /dev/spidev3.0 (default
4238 is 'on' or enabled).
4242 Info: Enables spi3 on GPIO2 1-3 with two chip select (CS) lines and
4243 associated spidev dev nodes. The gpio pin numbers for the CS lines and
4244 spidev device node creation are configurable. BCM2711 only,
4245 spi3-2cs-pi5 is substituted on Pi 5.
4246 Load: dtoverlay=spi3-2cs,<param>=<val>
4247 Params: cs0_pin GPIO pin for CS0 (default 0 - BCM SPI3_CE0).
4248 cs1_pin GPIO pin for CS1 (default 24 - BCM SPI3_CE1).
4249 cs0_spidev Set to 'off' to prevent the creation of a
4250 userspace device node /dev/spidev3.0 (default
4251 is 'on' or enabled).
4252 cs1_spidev Set to 'off' to prevent the creation of a
4253 userspace device node /dev/spidev3.1 (default
4254 is 'on' or enabled).
4258 Info: Enables spi3 on GPIOs 5-7 with two chip select (CS) lines and
4259 associated spidev dev nodes. The gpio pin numbers for the CS lines and
4260 spidev device node creation are configurable. Pi 5 only.
4261 Load: dtoverlay=spi3-2cs-pi5,<param>=<val>
4262 Params: cs0_pin GPIO pin for CS0 (default 4).
4263 cs1_pin GPIO pin for CS1 (default 25).
4264 cs0_spidev Set to 'off' to prevent the creation of a
4265 userspace device node /dev/spidev3.0 (default
4266 is 'on' or enabled).
4267 cs1_spidev Set to 'off' to prevent the creation of a
4268 userspace device node /dev/spidev3.1 (default
4269 is 'on' or enabled).
4273 Info: Enables spi4 on GPIOs 5-7 with a single chip select (CS) line and
4274 associated spidev dev node. The gpio pin number for the CS line and
4275 spidev device node creation are configurable. BCM2711 only.
4276 Load: dtoverlay=spi4-1cs,<param>=<val>
4277 Params: cs0_pin GPIO pin for CS0 (default 4 - BCM SPI4_CE0).
4278 cs0_spidev Set to 'off' to prevent the creation of a
4279 userspace device node /dev/spidev4.0 (default
4280 is 'on' or enabled).
4284 Info: Enables spi4 on GPIOs 5-6 with two chip select (CS) lines and
4285 associated spidev dev nodes. The gpio pin numbers for the CS lines and
4286 spidev device node creation are configurable. BCM2711 only.
4287 Load: dtoverlay=spi4-2cs,<param>=<val>
4288 Params: cs0_pin GPIO pin for CS0 (default 4 - BCM SPI4_CE0).
4289 cs1_pin GPIO pin for CS1 (default 25 - BCM SPI4_CE1).
4290 cs0_spidev Set to 'off' to prevent the creation of a
4291 userspace device node /dev/spidev4.0 (default
4292 is 'on' or enabled).
4293 cs1_spidev Set to 'off' to prevent the creation of a
4294 userspace device node /dev/spidev4.1 (default
4295 is 'on' or enabled).
4299 Info: Enables spi5 on GPIOs 13-15 with a single chip select (CS) line and
4300 associated spidev dev node. The gpio pin numbers for the CS lines and
4301 spidev device node creation are configurable. BCM2711 and Pi 5.
4302 Load: dtoverlay=spi5-1cs,<param>=<val>
4303 Params: cs0_pin GPIO pin for CS0 (default 12).
4304 cs0_spidev Set to 'off' to prevent the creation of a
4305 userspace device node /dev/spidev5.0 (default
4306 is 'on' or enabled).
4314 Info: Enables spi5 on GPIOs 13-15 with two chip select (CS) lines and
4315 associated spidev dev nodes. The gpio pin numbers for the CS lines and
4316 spidev device node creation are configurable. BCM2711 and Pi 5.
4317 Load: dtoverlay=spi5-2cs,<param>=<val>
4318 Params: cs0_pin GPIO pin for CS0 (default 12).
4319 cs1_pin GPIO pin for CS1 (default 26).
4320 cs0_spidev Set to 'off' to prevent the creation of a
4321 userspace device node /dev/spidev5.0 (default
4322 is 'on' or enabled).
4323 cs1_spidev Set to 'off' to prevent the creation of a
4324 userspace device node /dev/spidev5.1 (default
4325 is 'on' or enabled).
4333 Info: Enables spi6 with a single chip select (CS) line and associated spidev
4334 dev node. The gpio pin number for the CS line and spidev device node
4335 creation are configurable. BCM2711 only.
4336 Load: dtoverlay=spi6-1cs,<param>=<val>
4337 Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI6_CE0).
4338 cs0_spidev Set to 'off' to prevent the creation of a
4339 userspace device node /dev/spidev6.0 (default
4340 is 'on' or enabled).
4344 Info: Enables spi6 with two chip select (CS) lines and associated spidev
4345 dev nodes. The gpio pin numbers for the CS lines and spidev device node
4346 creation are configurable. BCM2711 only.
4347 Load: dtoverlay=spi6-2cs,<param>=<val>
4348 Params: cs0_pin GPIO pin for CS0 (default 18 - BCM SPI6_CE0).
4349 cs1_pin GPIO pin for CS1 (default 27 - BCM SPI6_CE1).
4350 cs0_spidev Set to 'off' to prevent the creation of a
4351 userspace device node /dev/spidev6.0 (default
4352 is 'on' or enabled).
4353 cs1_spidev Set to 'off' to prevent the creation of a
4354 userspace device node /dev/spidev6.1 (default
4355 is 'on' or enabled).
4359 Info: Overlay for activation of SSD1306 over I2C OLED display framebuffer.
4360 Load: dtoverlay=ssd1306,<param>=<val>
4361 Params: address Location in display memory of first character.
4363 width Width of display. (default=128)
4364 height Height of display. (default=64)
4365 offset virtual channel a. (default=0)
4366 normal Has no effect on displays tested. (default=not
4368 sequential Set this if every other scan line is missing.
4370 remapped Set this if display is garbled. (default=not
4372 inverted Set this if display is inverted and mirrored.
4376 Typical usage for 128x64 display: dtoverlay=ssd1306,inverted
4378 Typical usage for 128x32 display: dtoverlay=ssd1306,inverted,sequential
4380 i2c_baudrate=400000 will speed up the display.
4382 i2c_baudrate=1000000 seems to work even though it's not officially
4383 supported by the hardware, and is faster still.
4385 For more information refer to the device datasheet at:
4386 https://cdn-shop.adafruit.com/datasheets/SSD1306.pdf
4390 Info: Overlay for SSD1306 OLED via SPI using fbtft staging driver.
4391 Load: dtoverlay=ssd1306-spi,<param>=<val>
4392 Params: speed SPI bus speed (default 10000000)
4393 rotate Display rotation (0, 90, 180 or 270; default 0)
4394 fps Delay between frame updates (default 25)
4395 debug Debug output level (0-7; default 0)
4396 dc_pin GPIO pin for D/C (default 24)
4397 reset_pin GPIO pin for RESET (default 25)
4398 height Display height (32 or 64; default 64)
4399 inverted Set this if display is inverted and mirrored.
4404 Info: Overlay for SSD1331 OLED via SPI using fbtft staging driver.
4405 Load: dtoverlay=ssd1331-spi,<param>=<val>
4406 Params: speed SPI bus speed (default 4500000)
4407 rotate Display rotation (0, 90, 180 or 270; default 0)
4408 fps Delay between frame updates (default 25)
4409 debug Debug output level (0-7; default 0)
4410 dc_pin GPIO pin for D/C (default 24)
4411 reset_pin GPIO pin for RESET (default 25)
4415 Info: Overlay for SSD1351 OLED via SPI using fbtft staging driver.
4416 Load: dtoverlay=ssd1351-spi,<param>=<val>
4417 Params: speed SPI bus speed (default 4500000)
4418 rotate Display rotation (0, 90, 180 or 270; default 0)
4419 fps Delay between frame updates (default 25)
4420 debug Debug output level (0-7; default 0)
4421 dc_pin GPIO pin for D/C (default 24)
4422 reset_pin GPIO pin for RESET (default 25)
4425 Name: superaudioboard
4426 Info: Configures the SuperAudioBoard sound card
4427 Load: dtoverlay=superaudioboard,<param>=<val>
4428 Params: gpiopin GPIO pin for codec reset
4432 Info: Configures the Semtech SX150X I2C GPIO expanders.
4433 Load: dtoverlay=sx150x,<param>=<val>
4434 Params: sx150<x>-<n>-<m> Enables SX150X device on I2C#<n> with slave
4435 address <m>. <x> may be 1-9. <n> may be 0 or 1.
4436 Permissible values of <m> (which is denoted in
4437 hex) depend on the device variant. For SX1501,
4438 SX1502, SX1504 and SX1505, <m> may be 20 or 21.
4439 For SX1503 and SX1506, <m> may be 20. For
4440 SX1507 and SX1509, <m> may be 3E, 3F, 70 or 71.
4441 For SX1508, <m> may be 20, 21, 22 or 23.
4443 sx150<x>-<n>-<m>-int-gpio
4444 Integer, enables interrupts on SX150X device on
4445 I2C#<n> with slave address <m>, specifies
4446 the GPIO pin to which NINT output of SX150X is
4451 Info: Toshiba TC358743 HDMI to CSI-2 bridge chip.
4452 Uses Unicam 1, which is the standard camera connector on most Pi
4454 Load: dtoverlay=tc358743,<param>=<val>
4455 Params: 4lane Use 4 lanes (only applicable to Compute Modules
4458 link-frequency Set the link frequency. Only values of 297000000
4459 (574Mbit/s) and 486000000 (972Mbit/s - default)
4460 are supported by the driver.
4461 media-controller Configure use of Media Controller API for
4462 configuring the sensor (default off)
4463 cam0 Adopt the default configuration for CAM0 on a
4464 Compute Module (CSI0, i2c_vc, and cam0_reg).
4467 Name: tc358743-audio
4468 Info: Used in combination with the tc358743-fast overlay to route the audio
4469 from the TC358743 over I2S to the Pi.
4470 Wiring is LRCK/WFS to GPIO 19, BCK/SCK to GPIO 18, and DATA/SD to GPIO
4472 Load: dtoverlay=tc358743-audio,<param>=<val>
4473 Params: card-name Override the default, "tc358743", card name.
4477 Info: 3.5" Color TFT Display by www.tinylcd.com
4478 Options: Touch, RTC, keypad
4479 Load: dtoverlay=tinylcd35,<param>=<val>
4480 Params: speed Display SPI bus speed
4482 rotate Display rotation {0,90,180,270}
4484 fps Delay between frame updates
4486 debug Debug output level {0-7}
4488 touch Enable touch panel
4490 touchgpio Touch controller IRQ GPIO
4492 xohms Touchpanel: Resistance of X-plate in ohms
4494 rtc-pcf PCF8563 Real Time Clock
4496 rtc-ds DS1307 Real Time Clock
4498 keypad Enable keypad
4501 Display with touchpanel, PCF8563 RTC and keypad:
4502 dtoverlay=tinylcd35,touch,rtc-pcf,keypad
4504 dtoverlay=tinylcd35,touch,touchgpio=3
4508 Info: Enables support for Infineon SLB9670 Trusted Platform Module add-on
4509 boards, which can be used as a secure key storage and hwrng,
4510 available as "Iridium SLB9670" by Infineon and "LetsTrust TPM" by pi3g.
4511 Load: dtoverlay=tpm-slb9670
4516 Info: Enables support for Infineon SLB9673 Trusted Platform Module add-on
4517 boards, which can be used as a secure key storage and hwrng
4518 via the I2C protocol.
4519 Load: dtoverlay=tpm-slb9673
4524 Info: Change the pin usage of uart0
4525 Load: dtoverlay=uart0,<param>=<val>
4526 Params: txd0_pin GPIO pin for TXD0 (14, 32 or 36 - default 14)
4528 rxd0_pin GPIO pin for RXD0 (15, 33 or 37 - default 15)
4530 pin_func Alternative pin function - 4(Alt0) for 14&15,
4531 7(Alt3) for 32&33, 6(Alt2) for 36&37
4535 Info: Enable uart 0 on GPIOs 14-15. Pi 5 only.
4536 Load: dtoverlay=uart0-pi5,<param>
4537 Params: ctsrts Enable CTS/RTS on GPIOs 16-17 (default off)
4541 Info: Change the pin usage of uart1
4542 Load: dtoverlay=uart1,<param>=<val>
4543 Params: txd1_pin GPIO pin for TXD1 (14, 32 or 40 - default 14)
4545 rxd1_pin GPIO pin for RXD1 (15, 33 or 41 - default 15)
4549 Info: Enable uart 1 on GPIOs 0-1. Pi 5 only.
4550 Load: dtoverlay=uart1-pi5,<param>
4551 Params: ctsrts Enable CTS/RTS on GPIOs 2-3 (default off)
4555 Info: Enable uart 2 on GPIOs 0-3. BCM2711 only.
4556 Load: dtoverlay=uart2,<param>
4557 Params: ctsrts Enable CTS/RTS on GPIOs 2-3 (default off)
4561 Info: Enable uart 2 on GPIOs 4-5. Pi 5 only.
4562 Load: dtoverlay=uart2-pi5,<param>
4563 Params: ctsrts Enable CTS/RTS on GPIOs 6-7 (default off)
4567 Info: Enable uart 3 on GPIOs 4-7. BCM2711 only.
4568 Load: dtoverlay=uart3,<param>
4569 Params: ctsrts Enable CTS/RTS on GPIOs 6-7 (default off)
4573 Info: Enable uart 3 on GPIOs 8-9. Pi 5 only.
4574 Load: dtoverlay=uart3-pi5,<param>
4575 Params: ctsrts Enable CTS/RTS on GPIOs 10-11 (default off)
4579 Info: Enable uart 4 on GPIOs 8-11. BCM2711 only.
4580 Load: dtoverlay=uart4,<param>
4581 Params: ctsrts Enable CTS/RTS on GPIOs 10-11 (default off)
4585 Info: Enable uart 4 on GPIOs 12-13. Pi 5 only.
4586 Load: dtoverlay=uart4-pi5,<param>
4587 Params: ctsrts Enable CTS/RTS on GPIOs 14-15 (default off)
4591 Info: Enable uart 5 on GPIOs 12-15. BCM2711 only.
4592 Load: dtoverlay=uart5,<param>
4593 Params: ctsrts Enable CTS/RTS on GPIOs 14-15 (default off)
4597 Info: Configures the NW Digital Radio UDRC Hat
4598 Load: dtoverlay=udrc,<param>=<val>
4599 Params: alsaname Name of the ALSA audio device (default "udrc")
4602 Name: ugreen-dabboard
4603 Info: Configures the ugreen-dabboard I2S overlay
4604 This is a simple overlay based on the simple-audio-card and the dmic
4605 codec. It has the speciality that it is configured to use the codec
4606 as a master I2S device. It works for example with the Si468x DAB
4607 receiver on the uGreen DABBoard.
4608 Load: dtoverlay=ugreen-dabboard,<param>=<val>
4609 Params: card-name Override the default, "dabboard", card name.
4613 Info: Allow usage of downstream .dtb with upstream kernel. Comprises the
4614 vc4-kms-v3d and dwc2 overlays.
4615 Load: dtoverlay=upstream
4619 Name: upstream-aux-interrupt
4620 Info: This overlay has been deprecated and removed because it is no longer
4626 Info: Allow usage of downstream .dtb with upstream kernel on Pi 4. Comprises
4627 the vc4-kms-v3d-pi4 and dwc2 overlays.
4628 Load: dtoverlay=upstream-pi4
4633 Info: Enable Eric Anholt's DRM VC4 V3D driver on top of the dispmanx
4635 Load: dtoverlay=vc4-fkms-v3d,<param>
4636 Params: cma-512 CMA is 512MB (needs 1GB)
4637 cma-448 CMA is 448MB (needs 1GB)
4638 cma-384 CMA is 384MB (needs 1GB)
4639 cma-320 CMA is 320MB (needs 1GB)
4640 cma-256 CMA is 256MB (needs 1GB)
4641 cma-192 CMA is 192MB (needs 1GB)
4642 cma-128 CMA is 128MB
4645 cma-size CMA size in bytes, 4MB aligned
4646 cma-default Use upstream's default value
4649 Name: vc4-fkms-v3d-pi4
4650 Info: Enable Eric Anholt's DRM VC4 V3D driver on top of the dispmanx
4652 Load: dtoverlay=vc4-fkms-v3d-pi4,<param>
4653 Params: cma-512 CMA is 512MB (needs 1GB)
4654 cma-448 CMA is 448MB (needs 1GB)
4655 cma-384 CMA is 384MB (needs 1GB)
4656 cma-320 CMA is 320MB (needs 1GB)
4657 cma-256 CMA is 256MB (needs 1GB)
4658 cma-192 CMA is 192MB (needs 1GB)
4659 cma-128 CMA is 128MB
4662 cma-size CMA size in bytes, 4MB aligned
4663 cma-default Use upstream's default value
4666 Name: vc4-kms-dpi-at056tn53v1
4667 Info: This overlay is now deprecated - see vc4-kms-dpi-panel,at056tn53v1
4671 Name: vc4-kms-dpi-generic
4672 Info: Enable a generic DPI display under KMS. Default timings are for the
4673 Adafruit Kippah with 800x480 panel and RGB666 (GPIOs 0-21)
4674 Requires vc4-kms-v3d to be loaded.
4675 Load: dtoverlay=vc4-kms-dpi-generic,<param>=<val>
4676 Params: clock-frequency Display clock frequency (Hz)
4677 hactive Horizontal active pixels
4678 hfp Horizontal front porch
4679 hsync Horizontal sync pulse width
4680 hbp Horizontal back porch
4681 vactive Vertical active lines
4682 vfp Vertical front porch
4683 vsync Vertical sync pulse width
4684 vbp Vertical back porch
4685 hsync-invert Horizontal sync active low
4686 vsync-invert Vertical sync active low
4687 de-invert Data Enable active low
4688 pixclk-invert Negative edge pixel clock
4689 width-mm Define the screen width in mm
4690 height-mm Define the screen height in mm
4691 rgb565 Change to RGB565 output on GPIOs 0-19
4692 rgb565-padhi Change to RGB565 output on GPIOs 0-8, 12-17, and
4694 bgr666 Change to BGR666 output on GPIOs 0-21.
4695 bgr666-padhi Change to BGR666 output on GPIOs 0-9, 12-17, and
4697 rgb666-padhi Change to RGB666 output on GPIOs 0-9, 12-17, and
4699 bgr888 Change to BGR888 output on GPIOs 0-27
4700 rgb888 Change to RGB888 output on GPIOs 0-27
4701 bus-format Override the bus format for a MEDIA_BUS_FMT_*
4702 value. NB also overridden by rgbXXX overrides.
4703 backlight-gpio Defines a GPIO to be used for backlight control
4705 backlight-pwm Defines a PWM channel to be used for backlight
4706 control (default of none). NB Disables audio
4707 headphone output as that also uses PWM.
4708 backlight-pwm-chan Choose channel on &pwm node for backlight
4711 backlight-pwm-gpio GPIO pin to be used for the PWM backlight. See
4712 pwm-2chan for valid options.
4713 (default 18 - note this can only work with
4715 backlight-pwm-func Pin function of GPIO used for the PWM
4717 See pwm-2chan for valid options.
4719 backlight-def-brightness
4720 Set the default brightness. Normal range 1-16.
4722 rotate Display rotation {0,90,180,270} (default 0)
4725 Name: vc4-kms-dpi-hyperpixel2r
4726 Info: Enable the KMS drivers for the Pimoroni HyperPixel2 Round DPI display.
4727 Requires vc4-kms-v3d to be loaded.
4728 Load: dtoverlay=vc4-kms-dpi-hyperpixel2r,<param>=<val>
4729 Params: disable-touch Disables the touch controller
4730 touchscreen-inverted-x Inverts X direction of touch controller
4731 touchscreen-inverted-y Inverts Y direction of touch controller
4732 touchscreen-swapped-x-y Swaps X & Y axes of touch controller
4733 rotate Display rotation {0,90,180,270} (default 0)
4736 Name: vc4-kms-dpi-hyperpixel4
4737 Info: Enable the KMS drivers for the Pimoroni HyperPixel4 DPI display.
4738 Requires vc4-kms-v3d to be loaded.
4739 Load: dtoverlay=vc4-kms-dpi-hyperpixel4,<param>=<val>
4740 Params: disable-touch Disables the touch controller
4741 touchscreen-inverted-x Inverts X direction of touch controller
4742 touchscreen-inverted-y Inverts Y direction of touch controller
4743 touchscreen-swapped-x-y Swaps X & Y axes of touch controller
4744 rotate Display rotation {0,90,180,270} (default 0)
4747 Name: vc4-kms-dpi-hyperpixel4sq
4748 Info: Enable the KMS drivers for the Pimoroni HyperPixel4 Square DPI display.
4749 Requires vc4-kms-v3d to be loaded.
4750 Load: dtoverlay=vc4-kms-dpi-hyperpixel4sq,<param>=<val>
4751 Params: disable-touch Disables the touch controller
4752 touchscreen-inverted-x Inverts X direction of touch controller
4753 touchscreen-inverted-y Inverts Y direction of touch controller
4754 touchscreen-swapped-x-y Swaps X & Y axes of touch controller
4755 rotate Display rotation {0,90,180,270} (default 0)
4758 Name: vc4-kms-dpi-panel
4759 Info: Enable a preconfigured KMS DPI panel.
4760 Requires vc4-kms-v3d to be loaded.
4761 Load: dtoverlay=vc4-kms-dpi-panel,<param>=<val>
4762 Params: at056tn53v1 Enable an Innolux 5.6in VGA TFT
4763 kippah-7inch Enable an Adafruit Kippah with 7inch panel.
4764 mzp280 Enable a Geekworm MZP280 panel.
4765 backlight-gpio Defines a GPIO to be used for backlight control
4767 backlight-pwm Defines a PWM channel to be used for backlight
4768 control (default of none). NB Disables audio
4769 headphone output as that also uses PWM.
4770 backlight-pwm-chan Choose channel on &pwm node for backlight
4773 backlight-pwm-gpio GPIO pin to be used for the PWM backlight. See
4774 pwm-2chan for valid options.
4775 (default 18 - note this can only work with
4777 backlight-pwm-func Pin function of GPIO used for the PWM
4779 See pwm-2chan for valid options.
4781 backlight-def-brightness
4782 Set the default brightness. Normal range 1-16.
4784 rotate Display rotation {0,90,180,270} (default 0)
4787 Name: vc4-kms-dsi-7inch
4788 Info: Enable the Raspberry Pi DSI 7" screen.
4789 Includes the edt-ft5406 for the touchscreen element.
4790 Requires vc4-kms-v3d to be loaded.
4791 Load: dtoverlay=vc4-kms-dsi-7inch,<param>=<val>
4792 Params: sizex Touchscreen size x (default 800)
4793 sizey Touchscreen size y (default 480)
4794 invx Touchscreen inverted x axis
4795 invy Touchscreen inverted y axis
4796 swapxy Touchscreen swapped x y axis
4797 disable_touch Disables the touch screen overlay driver
4798 dsi0 Use DSI0 and i2c_csi_dsi0 (rather than
4799 the default DSI1 and i2c_csi_dsi).
4802 Name: vc4-kms-dsi-generic
4803 Info: Enable a generic DSI display under KMS.
4804 Default timings are for a 840x480 RGB888 panel.
4805 Requires vc4-kms-v3d to be loaded.
4806 Load: dtoverlay=vc4-kms-dsi-generic,<param>=<val>
4807 Params: clock-frequency Display clock frequency (Hz)
4808 hactive Horizontal active pixels
4809 hfp Horizontal front porch
4810 hsync Horizontal sync pulse width
4811 hbp Horizontal back porch
4812 vactive Vertical active lines
4813 vfp Vertical front porch
4814 vsync Vertical sync pulse width
4815 vbp Vertical back porch
4816 width-mm Define the screen width in mm
4817 height-mm Define the screen height in mm
4818 rgb565 Change to RGB565 output
4819 rgb666 Change to RGB666 output
4820 rgb666p Change to RGB666 output with pixel packing
4821 rgb888 Change to RGB888 output, this is the default
4822 one-lane Use one DSI lane for data transmission
4824 two-lane Use two DSI lanes for data transmission
4825 three-lane Use three DSI lanes for data transmission
4826 Only supported on Pi5 and CM
4827 four-lane Use four DSI lanes for data transmission
4828 Only supported on Pi5 and CM
4829 dsi0 Switch DSI port to DSI0
4830 Only supported on Pi5 and CM
4833 Name: vc4-kms-dsi-lt070me05000
4834 Info: Enable a JDI LT070ME05000 DSI display on DSI1.
4835 Note that this is a 4 lane DSI device, so it will only work on a Compute
4837 Requires vc4-kms-v3d to be loaded.
4838 Load: dtoverlay=vc4-kms-dsi-lt070me05000,<param>
4839 Params: reset GPIO for the reset signal (default 17)
4840 enable GPIO for the enable signal (default 4)
4841 dcdc-en GPIO for the DC-DC converter enable (default 5)
4844 Name: vc4-kms-dsi-lt070me05000-v2
4845 Info: Enable a JDI LT070ME05000 DSI display on DSI1 using Harlab's V2
4847 Note that this is a 4 lane DSI device, so it will only work on a Compute
4849 Requires vc4-kms-v3d to be loaded.
4850 Load: dtoverlay=vc4-kms-dsi-lt070me05000-v2
4854 Name: vc4-kms-dsi-waveshare-panel
4855 Info: Enable a Waveshare DSI touchscreen
4856 Includes the Goodix driver for the touchscreen element.
4857 The default is for the display to be using the I2C0 option for control.
4858 Use the i2c1 override if using the I2C1 wiring with jumper wires from
4859 GPIOs 2&3 (pins 3&5).
4860 invx/invy/swapxy should be used with caution as the panel specifier will
4861 set the default inversions for that panel. Always use them after the
4862 panel specifier, and be aware that you may need to set them as =0, not
4864 Requires vc4-kms-v3d to be loaded.
4865 Load: dtoverlay=vc4-kms-dsi-waveshare-panel,<param>=<val>
4866 Params: 2_8_inch 2.8" 480x640
4867 3_4_inch 3.4" 800x800 round
4868 4_0_inch 4.0" 480x800
4869 7_0_inchC 7.0" C 1024x600
4870 7_9_inch 7.9" 400x1280
4871 8_0_inch 8.0" 1280x800
4872 10_1_inch 10.1" 1280x800
4873 11_9_inch 11.9" 320x1480
4874 i2c1 Use i2c-1 with jumper wires from GPIOs 2&3
4875 disable_touch Disable the touch controller
4876 rotation Set the panel orientation property
4877 invx Touchscreen inverted x axis
4878 invy Touchscreen inverted y axis
4879 swapxy Touchscreen swapped x y axis
4880 dsi0 Use DSI0 and i2c_csi_dsi0 (rather than
4881 the default DSI1 and i2c_csi_dsi).
4884 Name: vc4-kms-kippah-7inch
4885 Info: This overlay is now deprecated - see vc4-kms-dpi-panel,kippah-7inch
4890 Info: Enable Eric Anholt's DRM VC4 HDMI/HVS/V3D driver.
4891 Load: dtoverlay=vc4-kms-v3d,<param>
4892 Params: cma-512 CMA is 512MB (needs 1GB)
4893 cma-448 CMA is 448MB (needs 1GB)
4894 cma-384 CMA is 384MB (needs 1GB)
4895 cma-320 CMA is 320MB (needs 1GB)
4896 cma-256 CMA is 256MB (needs 1GB)
4897 cma-192 CMA is 192MB (needs 1GB)
4898 cma-128 CMA is 128MB
4901 cma-size CMA size in bytes, 4MB aligned
4902 cma-default Use upstream's default value
4903 audio Enable or disable audio over HDMI (default "on")
4904 noaudio Disable all HDMI audio (default "off")
4905 composite Enable the composite output (default "off")
4906 N.B. Disables all other outputs on a Pi 4.
4907 nohdmi Disable HDMI output
4910 Name: vc4-kms-v3d-pi4
4911 Info: Enable Eric Anholt's DRM VC4 HDMI/HVS/V3D driver for Pi4.
4912 Load: dtoverlay=vc4-kms-v3d-pi4,<param>
4913 Params: cma-512 CMA is 512MB
4914 cma-448 CMA is 448MB
4915 cma-384 CMA is 384MB
4916 cma-320 CMA is 320MB
4917 cma-256 CMA is 256MB
4918 cma-192 CMA is 192MB
4919 cma-128 CMA is 128MB
4922 cma-size CMA size in bytes, 4MB aligned
4923 cma-default Use upstream's default value
4924 audio Enable or disable audio over HDMI0 (default
4926 audio1 Enable or disable audio over HDMI1 (default
4928 noaudio Disable all HDMI audio (default "off")
4929 composite Enable the composite output (disables all other
4931 nohdmi Disable both HDMI 0 & 1 outputs
4932 nohdmi0 Disable HDMI 0 output
4933 nohdmi1 Disable HDMI 1 output
4936 Name: vc4-kms-v3d-pi5
4937 Info: See vc4-kms-v3d-pi4 (this is the Pi 5 version)
4940 Name: vc4-kms-vga666
4941 Info: Enable the VGA666 (resistor ladder ADC) for the vc4-kms-v3d driver.
4942 Requires vc4-kms-v3d to be loaded.
4943 Load: dtoverlay=vc4-kms-vga666,<param>
4944 Params: ddc Enables GPIOs 0&1 as the I2C to read the EDID
4945 from the display. NB These are NOT 5V tolerant
4946 GPIOs, therefore level shifters are required.
4950 Info: Overlay for the Fen Logic VGA666 board
4951 This uses GPIOs 2-21 (so no I2C), and activates the output 2-3 seconds
4952 after the kernel has started.
4953 NOT for use with vc4-kms-v3d.
4954 Load: dtoverlay=vga666
4959 Info: Overlay to enable a VIA VL805 USB3 controller on CM4 carriers
4960 Will be loaded automatically by up-to-date firmware if "VL805=1" is
4961 set in the EEPROM config.
4962 Load: dtoverlay=vl805
4967 Info: Configures the w1-gpio Onewire interface module.
4968 Use this overlay if you *don't* need a GPIO to drive an external pullup.
4969 Load: dtoverlay=w1-gpio,<param>=<val>
4970 Params: gpiopin GPIO for I/O (default "4")
4971 pullup Now enabled by default (ignored)
4974 Name: w1-gpio-pullup
4975 Info: Configures the w1-gpio Onewire interface module.
4976 Use this overlay if you *do* need a GPIO to drive an external pullup.
4977 Load: dtoverlay=w1-gpio-pullup,<param>=<val>
4978 Params: gpiopin GPIO for I/O (default "4")
4979 extpullup GPIO for external pullup (default "5")
4980 pullup Now enabled by default (ignored)
4984 Info: Overlay for the Wiznet W5500 Ethernet Controller on SPI0
4985 Load: dtoverlay=w5500,<param>=<val>
4986 Params: int_pin GPIO used for INT (default 25)
4988 speed SPI bus speed (default 30000000)
4990 cs SPI bus Chip Select (default 0)
4993 Name: watterott-display
4994 Info: Watterott RPi-Display - 2.8" Touch Display
4995 Linux has 2 drivers that support this display and this overlay supports
4999 fbtft/fb_ili9341: dtoverlay=watterott-display
5000 drm/mi0283qt: dtoverlay=watterott-display,drm,backlight-pwm,rotate=180
5002 Some notable differences with the DRM driver compared to fbtft:
5003 - The display is turned on when it's first used and not on driver load
5004 as with fbtft. So if nothing uses the display it stays off.
5005 - Can run with a higher SPI clock increasing framerate. This is possible
5006 since the driver avoids messing up the controller configuration due to
5007 transmission errors by running config commands at 10MHz and only pixel
5008 data at full speed (occasional pixel glitch might occur).
5009 - PWM backlight is supported.
5011 Load: dtoverlay=watterott-display,<param>=<val>
5012 Params: speed Display SPI bus speed
5013 rotate Display rotation {0,90,180,270}
5014 fps Delay between frame updates (fbtft only)
5015 debug Debug output level {0-7} (fbtft only)
5016 xohms Touchpanel sensitivity (X-plate resistance)
5017 swapxy Swap x and y axis
5018 backlight Change backlight GPIO pin {e.g. 12, 18}
5020 drm Use DRM/KMS driver mi0283qt instead of fbtft.
5021 Set the SPI clock to 70MHz.
5022 This has to be the first parameter.
5023 backlight-pwm Use pwm for backlight (drm only). NB: Disables
5024 audio headphone output as that also uses PWM.
5027 Name: waveshare-can-fd-hat-mode-a
5028 Info: Overlay for the Waveshare 2-Channel Isolated CAN FD Expansion HAT
5029 for Raspberry Pi, Multi Protections. Use this overlay when the
5030 HAT is configured in Mode A (Default), with can0 on spi0.0
5032 https://www.waveshare.com/2-ch-can-fd-hat.htm
5033 Load: dtoverlay=waveshare-can-fd-hat-mode-a
5037 Name: waveshare-can-fd-hat-mode-b
5038 Info: Overlay for the Waveshare 2-Channel Isolated CAN FD Expansion HAT
5039 for Raspberry Pi, Multi Protections. Use this overlay when the
5040 HAT is configured in Mode B (requires hardware modification), with
5041 can0 on spi0.0 and can1 on spi0.1.
5042 https://www.waveshare.com/2-ch-can-fd-hat.htm
5043 Load: dtoverlay=waveshare-can-fd-hat-mode-b
5048 Info: Configures the wittypi RTC module.
5049 Load: dtoverlay=wittypi,<param>=<val>
5050 Params: led_gpio GPIO for LED (default "17")
5051 led_trigger Choose which activity the LED tracks (default
5055 Name: wm8960-soundcard
5056 Info: Overlay for the Waveshare wm8960 soundcard
5057 Load: dtoverlay=wm8960-soundcard,<param>=<val>
5058 Params: alsaname Changes the card name in ALSA
5059 compatible Changes the codec compatibility
5065 If you are experiencing problems that you think are DT-related, enable DT
5066 diagnostic output by adding this to /boot/config.txt:
5070 and rebooting. Then run:
5074 and look for relevant messages.
5079 This is only meant to be a quick introduction to the subject of Device Tree on
5080 Raspberry Pi. There is a more complete explanation here:
5082 http://www.raspberrypi.org/documentation/configuration/device-tree.md