to negotiate. Legal values are 10, 100 and
1000 (default 1000). Pi3B+ only.
+ hdmi Set to "off" to disable the HDMI interface
+ (default "on")
+
i2c_arm Set to "on" to enable the ARM's i2c interface
(default "off")
krnbt_baudrate Set the baudrate of the PL011 UART when used
with krnbt=on
+ pcie Set to "off" to disable the PCIe interface
+ (default "on")
+ (2711 only, but not applicable on CM4S)
+ N.B. USB-A ports on 4B are subsequently disabled
+
spi Set to "on" to enable the spi interfaces
(default "off")
random Set to "on" to enable the hardware random
number generator (default "on")
+ sd Set to "off" to disable the SD card (or eMMC on
+ non-lite SKU of CM4).
+ (default "on")
+
sd_overclock Clock (in MHz) to use when the MMC framework
requests 50MHz
Load: dtoverlay=audremap,<param>=<val>
Params: swap_lr Reverse the channel allocation, which will also
swap the audio jack outputs (default off)
- enable_jack Don't switch off the audio jack output
- (default off)
+ enable_jack Don't switch off the audio jack output. Does
+ nothing on BCM2711 (default off)
pins_12_13 Select GPIOs 12 & 13 (default)
pins_18_19 Select GPIOs 18 & 19
+ pins_40_41 Select GPIOs 40 & 41
+ pins_40_45 Select GPIOs 40 & 45 (don't use on BCM2711 - the
+ pins are on different controllers)
Name: balena-fin
cam0-imx258 Select IMX258 for camera on port 0
cam0-imx290 Select IMX290 for camera on port 0
cam0-imx477 Select IMX477 for camera on port 0
+ cam0-imx708 Select IMX708 for camera on port 0
cam0-ov2311 Select OV2311 for camera on port 0
cam0-ov5647 Select OV5647 for camera on port 0
cam0-ov7251 Select OV7251 for camera on port 0
cam1-imx258 Select IMX258 for camera on port 1
cam1-imx290 Select IMX290 for camera on port 1
cam1-imx477 Select IMX477 for camera on port 1
+ cam1-imx708 Select IMX708 for camera on port 1
cam1-ov2311 Select OV2311 for camera on port 1
cam1-ov5647 Select OV5647 for camera on port 1
cam1-ov7251 Select OV7251 for camera on port 1
cam0-imx258 Select IMX258 for camera on port 0
cam0-imx290 Select IMX290 for camera on port 0
cam0-imx477 Select IMX477 for camera on port 0
+ cam0-imx708 Select IMX708 for camera on port 0
cam0-ov2311 Select OV2311 for camera on port 0
cam0-ov5647 Select OV5647 for camera on port 0
cam0-ov7251 Select OV7251 for camera on port 0
cam1-imx258 Select IMX258 for camera on port 1
cam1-imx290 Select IMX290 for camera on port 1
cam1-imx477 Select IMX477 for camera on port 1
+ cam1-imx708 Select IMX708 for camera on port 1
cam1-ov2311 Select OV2311 for camera on port 1
cam1-ov5647 Select OV5647 for camera on port 1
cam1-ov7251 Select OV7251 for camera on port 1
cam2-imx258 Select IMX258 for camera on port 2
cam2-imx290 Select IMX290 for camera on port 2
cam2-imx477 Select IMX477 for camera on port 2
+ cam2-imx708 Select IMX708 for camera on port 2
cam2-ov2311 Select OV2311 for camera on port 2
cam2-ov5647 Select OV5647 for camera on port 2
cam2-ov7251 Select OV7251 for camera on port 2
cam3-imx258 Select IMX258 for camera on port 3
cam3-imx290 Select IMX290 for camera on port 3
cam3-imx477 Select IMX477 for camera on port 3
+ cam3-imx708 Select IMX708 for camera on port 3
cam3-ov2311 Select OV2311 for camera on port 3
cam3-ov5647 Select OV5647 for camera on port 3
cam3-ov7251 Select OV7251 for camera on port 3
Params: <None>
+Name: cirrus-wm5102
+Info: Configures the Cirrus Logic Audio Card
+Load: dtoverlay=cirrus-wm5102
+Params: <None>
+
+
Name: cma
Info: Set custom CMA sizes, only use if you know what you are doing, might
clash with other overlays like vc4-fkms-v3d and vc4-kms-v3d.
rv3028 Select the Micro Crystal RV3028 device
+ rv3032 Select the Micro Crystal RV3032 device
+
rv8803 Select the Micro Crystal RV8803 device
sd3078 Select the ZXW Shenzhen whwave SD3078 device
rv3028 Select the Micro Crystal RV3028 device
+ rv3032 Select the Micro Crystal RV3032 device
+
rv8803 Select the Micro Crystal RV8803 device
sd3078 Select the ZXW Shenzhen whwave SD3078 device
BMP280, CCS811, DS1621, HDC100X, LM75, SHT3x or
TMP102
+ aht10 Select the Aosong AHT10 temperature and humidity
+ sensor
+
bh1750 Select the Rohm BH1750 ambient light sensor
Valid addresses 0x23 or 0x5c, default 0x23
int_pin Set the GPIO to use for interrupts (max30102
only)
+ jc42 Select any of the many JEDEC JC42.4-compliant
+ temperature sensors, including:
+ ADT7408, AT30TS00, CAT34TS02, CAT6095,
+ MAX6604, MCP9804, MCP9805, MCP9808,
+ MCP98242, MCP98243, MCP98244, MCP9843,
+ SE97, SE98, STTS424(E), STTS2002, STTS3000,
+ TSE2002, TSE2004, TS3000, and TS3001.
+ The default address is 0x18.
+
lm75 Select the Maxim LM75 temperature sensor
Valid addresses 0x48-0x4f, default 0x4f
max30102 Select the Maxim Integrated MAX30102 heart-rate
and blood-oxygen sensor
+ mcp980x Select the Maxim MCP980x range of temperature
+ sensors (i.e. MCP9800, MCP9801, MCP9802 and
+ MCP9803). N.B. For MCP9804, MCP9805 and MCP9808,
+ use the "jc42" option.
+ Valid addresses are 0x18-0x1f (default 0x18)
+
sht3x Select the Sensiron SHT3x temperature and
humidity sensor. Valid addresses 0x44-0x45,
default 0x44
"100000")
+Name: i2s-dac
+Info: Configures any passive I2S DAC soundcard.
+Load: dtoverlay=i2s-dac
+Params: <None>
+
+
Name: i2s-gpio28-31
Info: move I2S function block to GPIO 28 to 31
Load: dtoverlay=i2s-gpio28-31
configuring the sensor (default on)
cam0 Adopt the default configuration for CAM0 on a
Compute Module (CSI0, i2c_vc, and cam0_reg).
+ clock-frequency Sets the clock frequency to match that used on
+ the board, which should be one of 54000000
+ (the default), 37125000 or 74250000.
Name: imx327
Compute Module (CSI0, i2c_vc, and cam0_reg).
+Name: imx708
+Info: Sony IMX708 camera module.
+ Uses Unicam 1, which is the standard camera connector on most Pi
+ variants.
+Load: dtoverlay=imx708,<param>=<val>
+Params: rotation Mounting rotation of the camera sensor (0 or
+ 180, default 180)
+ vcm Select lens driver state. Default is enabled,
+ but vcm=off will disable.
+ media-controller Configure use of Media Controller API for
+ configuring the sensor (default on)
+ cam0 Adopt the default configuration for CAM0 on a
+ Compute Module (CSI0, i2c_vc, and cam0_reg).
+
+
Name: iqaudio-codec
Info: Configures the IQaudio Codec audio card
Load: dtoverlay=iqaudio-codec
off)
capture_clear Generate clear events on the trailing edge
(default off)
+ pull Desired pull-up/down state (off, down, up)
+ Default is "off".
+
+
+Name: proto-codec
+Info: Configures the PROTO Audio Codec card
+Load: dtoverlay=proto-codec
+Params: <None>
Name: pwm
func Pin function (default 2 = Alt5)
+Name: pwm1
+Info: Configures one or two PWM channel on PWM1 (BCM2711 only)
+ N.B.:
+ 1) The onboard analogue audio output uses both PWM channels.
+ 2) So be careful mixing audio and PWM.
+ Note that even when only one pin is enabled, both channels are available
+ from the PWM driver, so be careful to use the correct one.
+Load: dtoverlay=pwm1,<param>=<val>
+Params: clock PWM clock frequency (informational)
+ pins_40 Enable channel 0 (PWM1_0) on GPIO 40
+ pins_41 Enable channel 1 (PWM1_1) on GPIO 41
+ pins_40_41 Enable channels 0 (PWM1_0) and 1 (PW1_1) on
+ GPIOs 40 and 41 (default)
+ pull_up Enable pull-ups on the PWM pins (default)
+ pull_down Enable pull-downs on the PWM pins
+ pull_off Disable pulls on the PWM pins
+
+
Name: qca7000
Info: in-tech's Evaluation Board for PLC Stamp micro
This uses spi0 and a separate GPIO interrupt to connect the QCA7000.
Name: rpi-cirrus-wm5102
-Info: Configures the Cirrus Logic Audio Card
-Load: dtoverlay=rpi-cirrus-wm5102
+Info: This overlay has been renamed to cirrus-wm5102
+Load: <Deprecated>
+
+
+Name: rpi-codeczero
+Info: Configures the Raspberry Pi Codec Zero sound card
+Load: dtoverlay=rpi-codeczero
Params: <None>
Name: rpi-dac
-Info: Configures the RPi DAC audio card
-Load: dtoverlay=rpi-dac
-Params: <None>
+Info: This overlay has been renaamed to i2s-dac.
+Load: <Deprecated>
-Name: rpi-display
-Info: RPi-Display - 2.8" Touch Display by Watterott
- Linux has 2 drivers that support this display and this overlay supports
- both.
+Name: rpi-dacplus
+Info: Configures the Raspberry Pi DAC+ card
+Load: dtoverlay=rpi-dacplus,<param>=<val>
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
+ digital volume control. Enable by adding
+ "dtparam=24db_digital_gain" to config.txt
+ before any "dtoverlay" lines.
+ The default behaviour is that the digital
+ volume control is limited to a maximum of
+ 0dB. ie. it can attenuate but not provide
+ gain. For most users, this will be desired
+ as it will prevent clipping. By appending
+ the 24db_digital_gain parameter, the digital
+ volume control will allow up to 24dB of
+ gain. If this parameter is enabled, it is the
+ responsibility of the user to ensure that
+ the digital volume control is set to a value
+ that does not result in clipping/distortion!
- Examples:
- fbtft/fb_ili9341: dtoverlay=rpi-display
- drm/mi0283qt: dtoverlay=rpi-display,drm,backlight-pwm,rotate=180
- Some notable differences with the DRM driver compared to fbtft:
- - The display is turned on when it's first used and not on driver load
- as with fbtft. So if nothing uses the display it stays off.
- - Can run with a higher SPI clock increasing framerate. This is possible
- since the driver avoids messing up the controller configuration due to
- transmission errors by running config commands at 10MHz and only pixel
- data at full speed (occasional pixel glitch might occur).
- - PWM backlight is supported.
+Name: rpi-dacpro
+Info: Configures the Raspberry Pi DAC Pro sound card
+Load: dtoverlay=rpi-dacpro,<param>=<val>
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
+ digital volume control. Enable by adding
+ "dtparam=24db_digital_gain" to config.txt
+ before any "dtoverlay" lines.
+ The default behaviour is that the digital
+ volume control is limited to a maximum of
+ 0dB. ie. it can attenuate but not provide
+ gain. For most users, this will be desired
+ as it will prevent clipping. By appending
+ the 24db_digital_gain parameter, the digital
+ volume control will allow up to 24dB of
+ gain. If this parameter is enabled, it is the
+ responsibility of the user to ensure that
+ the digital volume control is set to a value
+ that does not result in clipping/distortion!
-Load: dtoverlay=rpi-display,<param>=<val>
-Params: speed Display SPI bus speed
- rotate Display rotation {0,90,180,270}
- fps Delay between frame updates (fbtft only)
- debug Debug output level {0-7} (fbtft only)
- xohms Touchpanel sensitivity (X-plate resistance)
- swapxy Swap x and y axis
- backlight Change backlight GPIO pin {e.g. 12, 18}
- (fbtft only)
- drm Use DRM/KMS driver mi0283qt instead of fbtft.
- Set the SPI clock to 70MHz.
- This has to be the first parameter.
- backlight-pwm Use pwm for backlight (drm only). NB: Disables
- audio headphone output as that also uses PWM.
+
+Name: rpi-digiampplus
+Info: Configures the Raspberry Pi DigiAMP+ sound card
+Load: dtoverlay=rpi-digiampplus,<param>=<val>
+Params: 24db_digital_gain Allow gain to be applied via the PCM512x codec
+ digital volume control. Enable by adding
+ "dtparam=24db_digital_gain" to config.txt
+ before any "dtoverlay" lines.
+ The default behaviour is that the digital
+ volume control is limited to a maximum of
+ 0dB. ie. it can attenuate but not provide
+ gain. For most users, this will be desired
+ as it will prevent clipping. By appending
+ the 24db_digital_gain parameter, the digital
+ volume control will allow up to 24dB of
+ gain. If this parameter is enabled, it is the
+ responsibility of the user to ensure that
+ the digital volume control is set to a value
+ that does not result in clipping/distortion!
+ auto_mute_amp If specified, unmute/mute the DigiAMP+ when
+ starting/stopping audio playback (default "on").
+ unmute_amp If specified, unmute the DigiAMP+ amp once when
+ the DAC driver module loads (default "off").
+
+
+Name: rpi-display
+Info: This overlay has been renamed to watterott-display
+Load: <Deprecated>
Name: rpi-ft5406
Name: rpi-proto
-Info: Configures the RPi Proto audio card
-Load: dtoverlay=rpi-proto
-Params: <None>
+Info: This overlay has been renamaed to proto-codec.
+Load: <Deprecated>
Name: rpi-sense
Params: <None>
+Name: rpi-sense-v2
+Info: Raspberry Pi Sense HAT v2
+Load: dtoverlay=rpi-sense-v2
+Params: <None>
+
+
Name: rpi-tv
Info: Raspberry Pi TV HAT
Load: dtoverlay=rpi-tv
cs SPI bus Chip Select (default 0)
+Name: watterott-display
+Info: Watterott RPi-Display - 2.8" Touch Display
+ Linux has 2 drivers that support this display and this overlay supports
+ both.
+
+ Examples:
+ fbtft/fb_ili9341: dtoverlay=watterott-display
+ drm/mi0283qt: dtoverlay=watterott-display,drm,backlight-pwm,rotate=180
+
+ Some notable differences with the DRM driver compared to fbtft:
+ - The display is turned on when it's first used and not on driver load
+ as with fbtft. So if nothing uses the display it stays off.
+ - Can run with a higher SPI clock increasing framerate. This is possible
+ since the driver avoids messing up the controller configuration due to
+ transmission errors by running config commands at 10MHz and only pixel
+ data at full speed (occasional pixel glitch might occur).
+ - PWM backlight is supported.
+
+Load: dtoverlay=watterott-display,<param>=<val>
+Params: speed Display SPI bus speed
+ rotate Display rotation {0,90,180,270}
+ fps Delay between frame updates (fbtft only)
+ debug Debug output level {0-7} (fbtft only)
+ xohms Touchpanel sensitivity (X-plate resistance)
+ swapxy Swap x and y axis
+ backlight Change backlight GPIO pin {e.g. 12, 18}
+ (fbtft only)
+ drm Use DRM/KMS driver mi0283qt instead of fbtft.
+ Set the SPI clock to 70MHz.
+ This has to be the first parameter.
+ backlight-pwm Use pwm for backlight (drm only). NB: Disables
+ audio headphone output as that also uses PWM.
+
+
Name: waveshare-can-fd-hat-mode-a
Info: Overlay for the Waveshare 2-Channel Isolated CAN FD Expansion HAT
for Raspberry Pi, Multi Protections. Use this overlay when the