> For the complete documentation index, see [llms.txt](https://rpicn.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rpicn.bsdcn.org/shu-mei-pai/jiu-ban-config.txt-can-shu.md).

# 旧版 config.txt 参数

## 旧版参数

此处所述的 `config.txt` 参数被视为陈旧设置，树莓派 Bookworm 系统不再使用，亦无官方支持。它们要么涉及旧软件（如固件中的图形驱动程序）、要么已弃用、要么几乎无人使用。然而，它们仍被记录在此，因为它们对于那些使用旧操作系统的用户，及进行裸机开发的人来说，可能仍有用。

## 旧版启动参数

（另请参阅 [config.txt](https://www.raspberrypi.com/documentation/computers/config_txt.html#boot-options) 启动参数。）

### `start_x`、`start_debug`

这里提供了代替参数 `start_file`、`fixup_file` 的简单方法。这是选定固件配置的建议方法。

`start_x=1` 意味着

```sh
  start_file=start_x.elf
  fixup_file=fixup_x.dat
```

对于树莓派 4，如果存在文件 `start4x.elf`、`fixup4x.dat`，则会使用之。

`start_debug=1` 意味着

```sh
  start_file=start_db.elf
  fixup_file=fixup_db.dat
```

### `disable_commandline_tags`

若将参数 `disable_commandline_tags` 置为 `1`，会在启动内核之前禁止 `start.elf` 覆盖 ATAGS（从 `0x100` 开始的内存）。

### `arm_control`

> **警告**
>
> 此参数已弃用。请改用 `arm_64bit` 来启用 64 位内核。

此设置特定于主板的控制位。

### `armstub`

`armstub` 位于启动分区，是用于加载 ARM stub（存根）的文件名。默认的 ARM 存根存储在固件中，会根据树莓派型号及各种设置自动选定。

存根是在内核运行之前被执行的一小段 ARM 代码。它的任务是设置诸如中断控制器等底层硬件，然后再将控制权移交给内核。

### `arm_peri_high`

若将 `arm_peri_high` 置为 `1`：可在树莓派 4 上启用高性能外设模式。若加载了恰当的 DTB，将会自动设定该参数。

> **注意**
>
> 若在缺失兼容设备树（DTB）的情况下，启用高性能外设模式，将导致系统无法启动。目前的 ARM 存根支持尚不完善，因此你还需使用 `armstub` 加载对应的文件。

### `kernel_address`

`kernel_address` 是加载内核镜像的内存地址。在默认情况下，32 位内核会加载到地址 `0x8000`，64 位内核会加载到地址 `0x200000`。若设置了 `kernel_old`，内核会被加载到地址 `0x0`。

### `kernel_old`

若将 `kernel_old` 置为 `1`，可将内核加载至内存地址 `0x0`。

### `init_uart_baud`

`init_uart_baud` 是串口的初始化波特率。默认值为 `115200`。

### `init_uart_clock`

`init_uart_clock` 是串口的初始化时钟频率。默认值为 `48000000`（48MHz）。请注意，此时钟仅适用于 UART0（Linux 为 ttyAMA0），且串口的最大波特率受限为时钟的 1/16。树莓派 3 和树莓派 Zero 的默认串口是 UART1（Linux 为 ttyS0），其时钟等同于核心 VPU 时钟——至少为 250MHz。

### `bootcode_delay`

参数 `bootcode_delay` 设定了在 `bootcode.bin` 阶段的延迟（秒），然后再加载 `start.elf`——默认值为 `0`。

这在读取显示器 EDID 前插入延迟极有用。比如，树莓派和显示器共用一部电源，但显示器的启动时间长于树莓派。如果显示器在初始启动时会检测到错误，但在不断电的情况下重启树莓派后就检测正确了，那么请尝试设置此参数。

### `boot_delay`

参数 `boot_delay` 意味着在加载内核之前，会在 `start.elf` 阶段等待给定的时间（秒）。总延迟计算公式为 `(1000 x boot_delay) + boot_delay_ms`，单位为毫秒。如果你的存储卡需要一些时间才能准备好，继而才能启动 Linux，这可能极有用。

### `boot_delay_ms`

参数 `boot_delay_ms` 意味着在加载内核之前，会在 `start.elf` 阶段（含 `boot_delay`）等待给定的时间（毫秒）。默认值为 `0`。

### `enable_gic`（仅适用于树莓派 4）

在树莓派 4B 上，如果将此值置为 `0`，则中断将从旧的中断控制器（而非 GIC-400）路由到 Arm 处理器。默认值为 `1`。

### `sha256`

如果设置为非 `0` 值，则将：为加载的文件（内核、initramfs、设备树 .dtb 文件和叠加层）记录 SHA256 哈希值日志，哈希值由工具 `sha256sum` 生成。如启用，日志输出将发送到串口，亦可通过 `sudo vclog --msg` 获取。在调试启动故障时，此参数可能极有用，但可能会使启动时间增加数秒。在所有平台上，默认值均为 `0`。

### `uart_2ndstage`

设置 `uart_2ndstage=1` 会触发第二阶段加载程序（树莓派 4 之前的设备为 `bootcode.bin`、树莓派 4 设备为 EEPROM 中的引导代码）和主固件（`start*.elf`）把诊断信息输出到 UART0。

请注意，输出可能会干扰蓝牙正常工作，除非禁用蓝牙（`dtoverlay=disable-bt`）或把蓝牙切换到别的串口（`dtoverlay=miniuart-bt`），如串口同时被用于输出 Linux 数据，则可能会导致数据丢失，从而导致输出故障。此功能应仅在诊断早期引导加载故障时使用。

### `upstream_kernel`

如果设定 `upstream_kernel=1`，固件会将 `os_prefix` 设置为"upstream/"——除非已明确将其设置为其他值。但就像其他 `os_prefix` 值一样，如果在使用前缀时无法找到所需的内核和 .dtb 文件，则会忽略该值。

固件还会优先使用上游 Linux 的 DTB 名称（`bcm2837-rpi-3-b.dtb` 先于 `bcm2710-rpi-3-b.dtb`）。如果找不到上游文件，则固件将加载下游衍生文件，并自动加载"upstream"叠加层来进行调整。请注意，此过程发生在 `os_prefix` 最终确定后。

## 旧版 GPIO 控制

（另请参阅 [config.txt GPIO 控制](https://www.raspberrypi.com/documentation/computers/config_txt.html#gpio-control)。）

### `enable_jtag_gpio`

设置 `enable_jtag_gpio=1`：会把 GPIO 引脚 22-27 设为 Alt4 模式，并在 SoC 内部进行相关配置，从而启用 Arm CPU 的 JTAG 接口。此设置适用于所有型号的树莓派。

|   引脚号  |     功能    |
| :----: | :-------: |
| GPIO22 | ARM\_TRST |
| GPIO23 | ARM\_RTCK |
| GPIO24 |  ARM\_TDO |
| GPIO25 |  ARM\_TCK |
| GPIO26 |  ARM\_TDI |
| GPIO27 |  ARM\_TMS |

## 旧版超频参数

（另请参阅 [config.txt 超频参数](https://www.raspberrypi.com/documentation/computers/config_txt.html#overclocking-options)。）

### 超频

#### `never_over_voltage`

会在一次性可编程（OTP）存储器中置一个位，防止设备过压。旨在锁定树莓派，以防止无意、或恶意地使用无效过电压篡改保修位。

#### `disable_auto_turbo`

对于树莓派 2、3，设置此参数将禁止 GPU 超频。而在特定负载下，GPU 原本可进入超频模式。

## 旧版条件筛选器

（另请参阅 [config.txt 条件筛选器](https://www.raspberrypi.com/documentation/computers/config_txt.html#conditional-filters)。）

### 筛选器 `[HDMI:*]`

> **注意**
>
> 此筛选器仅适用于树莓派 4。

树莓派 4 有两个 HDMI 端口，有许多个同 HDMI 相关的 `config.txt` 参数，有必要指明所选定的 HDMI 端口。HDMI 条件筛选器将后续 HDMI 配置限定到特定端口。

```sh
 [HDMI:0]
   hdmi_group=2
   hdmi_mode=45
 [HDMI:1]
   hdmi_group=2
   hdmi_mode=67
```

所有特定于端口的 HDMI 参数都提供了另外一种语法：`变量:值`。你可以使用以下内容，这与前面的示例相同：

```sh
 hdmi_group:0=2
 hdmi_mode:0=45
 hdmi_group:1=2
 hdmi_mode:1=67
```

## 旧版内存参数

（另请参阅 [config.txt 内存参数](https://www.raspberrypi.com/documentation/computers/config_txt.html#memory-options)）

> **注意**
>
> 树莓派 5 不会为操作系统分配 GPU 内存（显存），故以下参数无效。

### `gpu_mem`

指定要为 GPU 保留多少专用内存（MB）：剩余内存分配给 Arm CPU 供操作系统使用。对于内存小于 1GB 的树莓派来说，默认值为 `64`；对于内存为 1GB 及更大容量的树莓派，默认值为 `76`。

> **重要**
>
> 与 x86 平台（增大显存可提高 3D 性能）上的 GPU 不同。VideoCore 的架构意味着：**指定比必要值更大的值不仅无法带来性能优势**，相反还可能会降低性能。

为了确保 Linux 呈最佳性能，你应把 `gpu_mem` 设置成尽可能低的值。如果某个特定的图形功能无法正常工作，可尝试提高 `gpu_mem` 的值，但请注意下面展示的建议最大值。

在树莓派 4 上，GPU 的 3D 组件有自己的内存管理单元（MMU），故不使用 `gpu_mem` 分配的内存，而是使用 Linux 动态分配的内存。这使得树莓派 4 可指定比先前型号还小的 `gpu_mem` 值。

由旧款内核分配给 GPU 的内存，可用于显示器、3D、编解码器和摄像头等用途，以及一些基本固件管理。下面指定的最大值，假定你正使用着上述所有功能。如无，则应使用较小的 `gpu_mem` 值。

建议最大值如下：

|   总内存   |  建议的 `gpu_mem` 最大值 |
| :-----: | :----------------: |
|  256MB  |        `128`       |
|  512MB  |        `384`       |
| 1GB 及更大 | `512`、树莓派 4 为 `76` |

> **重要**
>
> 树莓派系统上的相机堆栈（libcamera）使用 Linux CMA（连续内存分配器）的内存分配缓冲区，并不占用 GPU 显存，所以增大 GPU 显存没有任何好处可言。

能把 `gpu_mem` 设置成更大的值，但不建议这么做，因为可能会引发故障（可能妨碍 Linux 启动）。`gpu_mem` 的最小值为 `16`——但此值会禁用某些 GPU 功能。

你还可以使用 `gpu_mem_256`、`gpu_mem_512`、`gpu_mem_1024`，以便在不同内存容量间的树莓派交换同一张存储卡，无需每次都编辑 `config.txt`：

### `gpu_mem_256`

参数 `gpu_mem_256` 可为搭载 256MB 内存的树莓派设置 GPU 内存（MB）。如果内存容量不是 256MB，则会被忽略。该参数会覆盖 `gpu_mem`。

### `gpu_mem_512`

参数 `gpu_mem_512` 可为搭载 512MB 内存的树莓派设置 GPU 内存（MB）。如果内存容量不是 512MB，则会被忽略。该参数会覆盖 `gpu_mem`。

### `gpu_mem_1024`

参数 `gpu_mem_1024` 可为搭载 1GB（及更大容量）内存的树莓派设置 GPU 内存（MB）。如果内存容量小于 1GB，则会被忽略。该参数会覆盖 `gpu_mem`。

### `disable_l2cache`

若将该参数置为 `1`（并同时禁用 L2 缓存的相关内核），会禁止 CPU 使用 GPU 的 L2 缓存。BCM2835 的默认值为 `0`。基于 BCM2836、BCM2837、BCM2711 和 BCM2712 的 ARM 有自己的 L2 缓存，故默认值为 `1`。标准版本的树莓派 `kernel.img` 和 `kernel7.img` 对应了缓存设置的差异。

## 旧版视频参数

（另请参阅 [`config.txt` 视频参数](https://www.raspberrypi.com/documentation/computers/config_txt.html#video-options)。）

### HDMI 信号格式

> **注意**
>
> 因为树莓派 4、400 搭载了两个 HDMI 端口，故某些 HDMI 参数可以应用于特定接口。你可以使用语法 `<参数>:<端口>`，其中端口值为 `0` 或 `1`，用来指定此设置应用于哪个端口。如未指定端口，则默认为 `0`。如果在不支持端口号的参数上指定了端口号，则端口将被忽略。更多有关语法和可选机制的详细信息，请参阅文档的[条件部分](https://www.raspberrypi.com/documentation/computers/legacy_config_txt.html#legacy-conditional-filters)中的 HDMI 章节。

#### `hdmi_safe`

若将 `hdmi_safe` 置为 `1`，将触发使用“safe mode（安全模式）”，尝试以最大化 HDMI 兼容性启动。等同于设定以下参数：

```sh
hdmi_force_hotplug=1
hdmi_ignore_edid=0xa5000080
config_hdmi_boost=4
hdmi_group=2
hdmi_mode=4
disable_overscan=0
overscan_left=24
overscan_right=24
overscan_top=24
overscan_bottom=24
```

#### `hdmi_ignore_edid`

如果你的显示器没有准确的 EDID。可将 `hdmi_ignore_edid` 置为 `0xa5000080`，以忽略显示器的 EDID（扩展显示识别数据）信息。它需要此异常值来避免触发故障。

#### `hdmi_edid_file`

若将 `hdmi_edid_file` 置为 `1`，将使 GPU 从启动分区中的 `edid.dat` 文件（而非显示器）中读取 EDID 数据。

#### `hdmi_edid_filename`

在树莓派 4B 上，你可以使用参数 `hdmi_edid_filename` 指定要使用的 EDID 文件的文件名，并指定文件要应用的 HDMI 端口。同时还需要 `hdmi_edid_file=1` 来启用 EDID 文件。

例如：

```sh
hdmi_edid_file=1
hdmi_edid_filename:0=FileForPortZero.edid
hdmi_edid_filename:1=FileForPortOne.edid
```

#### `hdmi_force_edid_audio`

若将 `hdmi_force_edid_audio` 置为 `1`，会把显示器伪装成支持一切音频格式，即使实际上不支持 DTS/AC3，也能进行音频透传。

#### `hdmi_ignore_edid_audio`

若将 `hdmi_ignore_edid_audio` 置为 `1`，会把显示器伪装成不支持一切音频格式。这意味着 ALSA 将默认使用模拟音频（耳机）插孔。

#### `hdmi_force_edid_3d`

若将 `hdmi_force_edid_3d` 置为 `1`，会将所有的 CEA 信号格式伪装成支持 3D，即使 EDID 信息并未标称支持。

#### `hdmi_ignore_cec_init`

若将 `hdmi_ignore_cec_init` 置为 `1`，可在启动过程中禁止发送初始化活动源信息。这可以防止：在重启树莓派时，带 CEC 支持的电视机因从待机状态中唤醒而切换频道。

#### `hdmi_ignore_cec`

若将 `hdmi_ignore_cec` 置为 `1`，会把显示器伪装成不支持 CEC。将不支持一切 CEC 功能。

#### `cec_osd_name`

参数 `cec_osd_name` 可为设备设置初始化 CEC 名称。默认为 `Raspberry Pi`。

#### `hdmi_pixel_encoding`

参数 `hdmi_pixel_encoding` 将强制使用像素编码模式。在默认情况下，它使用从 EDID 请求的信号格式，因此你不大需要更改此参数。

| `hdmi_pixel_encoding` | 意义                          |
| :-------------------: | --------------------------- |
|          `0`          | 默认值（CEA 为有限 RGB，DMT 为全 RGB） |
|          `1`          | 有限 RGB（16-235）              |
|          `2`          | 全 RGB（0-255）                |
|          `3`          | 有限 YCbCr（16-235）            |
|          `4`          | 全 YCbCr（0-255）              |

#### `hdmi_max_pixel_freq`

固件和 KMS 使用像素时钟来选定 HDMI 信号格式。请注意，这与帧率不同。它指定了有效信号格式可以具有的最大频率，从而剔除了更高频率的信号格式。因此，如果你希望彻底禁用 4K 信号格式，你可以指定最大频率为 200000000，因为所有的 4K 信号格式频率均大于此值。

#### `hdmi_blanking`

参数 `hdmi_blanking` 可控制该过程：操作系统为节省电源，要求使用 DPMS（Display Power Management Signaling，显示电源管理信号）让显示器置于待机模式。如果未设置此参数或将其置为 `0`，则 HDMI 输出将被清空但不会关闭。为了模仿其他计算机的行为，你可以同时把 HDMI 输出也设置为关闭，方法是将此参数置为 `1`：已连接的显示器将进入低功耗待机模式。

> **注意**
>
> 在树莓派 4 上，设置 `hdmi_blanking=1` 不会停止 HDMI 输出，因为该功能未实现。当使用不使用 framebuffer（帧缓冲器）的应用程序（如 omxplayer）时，此功能可能会引发问题。

| `hdmi_blanking` |       说明      |
| :-------------: | :-----------: |
|       `0`       |   清空 HDMI 输出  |
|       `1`       | 清空并关闭 HDMI 输出 |

#### `hdmi_drive`

`hdmi_drive` 参数能让你在输出信号格式 HDMI 和 DVI 间进行切换。

| `hdmi_drive` | 说明                          |
| :----------: | --------------------------- |
|      `1`     | 普通 DVI 信号格式（无声音）            |
|      `2`     | 普通 HDMI 信号格式（如果支持且已启用，则有声音） |

#### `config_hdmi_boost`

配置 HDMI 端口的信号强度。最小值为 `0`，最大值为 `11`。

早期型号的 B、A 默认值为 `2`。B+ 及所有后续型号的默认值为 `5`。

如果你遇到了 HDMI 故障（雪花等干扰），请尝试 `7`。特别长的 HDMI 线缆可能需要 `11` 这么大才行——但除非绝对必要，否则不应使用这么高的值。

旧款树莓派 4 会忽略此参数。

#### `hdmi_group`

`hdmi_group` 参数定义了 HDMI 输出组，可以是 CEA（美国消费电子协会标准，一般由电视使用）和 DMT（显示监视器时序标准，一般由显示器使用）。此设置应与 `hdmi_mode` 联合使用。

| `hdmi_group` |     说明    |
| :----------: | :-------: |
|      `0`     | 自动检测 EDID |
|      `1`     |    CEA    |
|      `2`     |    DMT    |

#### `hdmi_mode`

与 `hdmi_group` 一道，`hdmi_mode` 定义了 HDMI 输出格式。信号格式编号符合 [CTA 规范](https://web.archive.org/web/20171201033424/https://standards.cta.tech/kwspub/published_docs/CTA-861-G_FINAL_revised_2017.pdf)。

> **注意**
>
> 并非全部型号都能使用以下所有信号格式。

以下值仅在 `hdmi_group=1`（CEA）下有效：

| `hdmi_mode` |      分辨率     |  刷新率  |   屏幕比例  |    备注   |
| :---------: | :----------: | :---: | :-----: | :-----: |
|      1      | VGA（640x480） |  60Hz |   4:3   |         |
|      2      |     480p     |  60Hz |   4:3   |         |
|      3      |     480p     |  60Hz |   16:9  |         |
|      4      |     720p     |  60Hz |   16:9  |         |
|      5      |     1080i    |  60Hz |   16:9  |         |
|      6      |     480i     |  60Hz |   4:3   |         |
|      7      |     480i     |  60Hz |   16:9  |         |
|      8      |     240p     |  60Hz |   4:3   |         |
|      9      |     240p     |  60Hz |   16:9  |         |
|      10     |     480i     |  60Hz |   4:3   |   四倍像素  |
|      11     |     480i     |  60Hz |   16:9  |   四倍像素  |
|      12     |     240p     |  60Hz |   4:3   |   四倍像素  |
|      13     |     240p     |  60Hz |   16:9  |   四倍像素  |
|      14     |     480p     |  60Hz |   4:3   |   双倍像素  |
|      15     |     480p     |  60Hz |   16:9  |   双倍像素  |
|      16     |     1080p    |  60Hz |   16:9  |         |
|      17     |     576p     |  50Hz |   4:3   |         |
|      18     |     576p     |  50Hz |   16:9  |         |
|      19     |     720p     |  50Hz |   16:9  |         |
|      20     |     1080i    |  50Hz |   16:9  |         |
|      21     |     576i     |  50Hz |   4:3   |         |
|      22     |     576i     |  50Hz |   16:9  |         |
|      23     |     288p     |  50Hz |   4:3   |         |
|      24     |     288p     |  50Hz |   16:9  |         |
|      25     |     576i     |  50Hz |   4:3   |   四倍像素  |
|      26     |     576i     |  50Hz |   16:9  |   四倍像素  |
|      27     |     288p     |  50Hz |   4:3   |   四倍像素  |
|      28     |     288p     |  50Hz |   16:9  |   四倍像素  |
|      29     |     576p     |  50Hz |   4:3   |   双倍像素  |
|      30     |     576p     |  50Hz |   16:9  |   双倍像素  |
|      31     |     1080p    |  50Hz |   16:9  |         |
|      32     |     1080p    |  24Hz |   16:9  |         |
|      33     |     1080p    |  25Hz |   16:9  |         |
|      34     |     1080p    |  30Hz |   16:9  |         |
|      35     |     480p     |  60Hz |   4:3   |   四倍像素  |
|      36     |     480p     |  60Hz |   16:9  |   四倍像素  |
|      37     |     576p     |  50Hz |   4:3   |   四倍像素  |
|      38     |     576p     |  50Hz |   16:9  |   四倍像素  |
|      39     |     1080i    |  50Hz |   16:9  |  降低清屏时间 |
|      40     |     1080i    | 100Hz |   16:9  |         |
|      41     |     720p     | 100Hz |   16:9  |         |
|      42     |     576p     | 100Hz |   4:3   |         |
|      43     |     576p     | 100Hz |   16:9  |         |
|      44     |     576i     | 100Hz |   4:3   |         |
|      45     |     576i     | 100Hz |   16:9  |         |
|      46     |     1080i    | 120Hz |   16:9  |         |
|      47     |     720p     | 120Hz |   16:9  |         |
|      48     |     480p     | 120Hz |   4:3   |         |
|      49     |     480p     | 120Hz |   16:9  |         |
|      50     |     480i     | 120Hz |   4:3   |         |
|      51     |     480i     | 120Hz |   16:9  |         |
|      52     |     576p     | 200Hz |   4:3   |         |
|      53     |     576p     | 200Hz |   16:9  |         |
|      54     |     576i     | 200Hz |   4:3   |         |
|      55     |     576i     | 200Hz |   16:9  |         |
|      56     |     480p     | 240Hz |   4:3   |         |
|      57     |     480p     | 240Hz |   16:9  |         |
|      58     |     480i     | 240Hz |   4:3   |         |
|      59     |     480i     | 240Hz |   16:9  |         |
|      60     |     720p     |  24Hz |   16:9  |         |
|      61     |     720p     |  25Hz |   16:9  |         |
|      62     |     720p     |  30Hz |   16:9  |         |
|      63     |     1080p    | 120Hz |   16:9  |         |
|      64     |     1080p    | 100Hz |   16:9  |         |
|      65     |      自定义     |       |         |         |
|      66     |     720p     |  25Hz |  64:27  |  树莓派 4  |
|      67     |     720p     |  30Hz |  64:27  |  树莓派 4  |
|      68     |     720p     |  50Hz |  64:27  |  树莓派 4  |
|      69     |     720p     |  60Hz |  64:27  |  树莓派 4  |
|      70     |     720p     | 100Hz |  64:27  |  树莓派 4  |
|      71     |     720p     | 120Hz |  64:27  |  树莓派 4  |
|      72     |     1080p    |  24Hz |  64:27  |  树莓派 4  |
|      73     |     1080p    |  25Hz |  64:27  |  树莓派 4  |
|      74     |     1080p    |  30Hz |  64:27  |  树莓派 4  |
|      75     |     1080p    |  50Hz |  64:27  |  树莓派 4  |
|      76     |     1080p    |  60Hz |  64:27  |  树莓派 4  |
|      77     |     1080p    | 100Hz |  64:27  |  树莓派 4  |
|      78     |     1080p    | 120Hz |  64:27  |  树莓派 4  |
|      79     |   1680x720   |  24Hz |  64:27  |  树莓派 4  |
|      80     |   1680x720   |  25z  |  64:27  |  树莓派 4  |
|      81     |   1680x720   |  30Hz |  64:27  |  树莓派 4  |
|      82     |   1680x720   |  50Hz |  64:27  |  树莓派 4  |
|      83     |   1680x720   |  60Hz |  64:27  |  树莓派 4  |
|      84     |   1680x720   | 100Hz |  64:27  |  树莓派 4  |
|      85     |   1680x720   | 120Hz |  64:27  |  树莓派 4  |
|      86     |   2560x720   |  24Hz |  64:27  |  树莓派 4  |
|      87     |   2560x720   |  25Hz |  64:27  |  树莓派 4  |
|      88     |   2560x720   |  30Hz |  64:27  |  树莓派 4  |
|      89     |   2560x720   |  50Hz |  64:27  |  树莓派 4  |
|      90     |   2560x720   |  60Hz |  64:27  |  树莓派 4  |
|      91     |   2560x720   | 100Hz |  64:27  |  树莓派 4  |
|      92     |   2560x720   | 120Hz |  64:27  |  树莓派 4  |
|      93     |     2160p    |  24Hz |   16:9  |  树莓派 4  |
|      94     |     2160p    |  25Hz |   16:9  |  树莓派 4  |
|      95     |     2160p    |  30Hz |   16:9  |  树莓派 4  |
|      96     |     2160p    |  50Hz |   16:9  |  树莓派 4  |
|      97     |     2160p    |  60Hz |   16:9  |  树莓派 4  |
|      98     |   4096x2160  |  24Hz | 256:135 |  树莓派 4  |
|      99     |   4096x2160  |  25Hz | 256:135 |  树莓派 4  |
|     100     |   4096x2160  |  30Hz | 256:135 |  树莓派 4  |
|     101     |   4096x2160  |  50Hz | 256:135 | 树莓派 4 ① |
|     102     |   4096x2160  |  60Hz | 256:135 | 树莓派 4 ① |
|     103     |     2160p    |  24Hz |  64:27  |  树莓派 4  |
|     104     |     2160p    |  25Hz |  64:27  |  树莓派 4  |
|     105     |     2160p    |  30Hz |  64:27  |  树莓派 4  |
|     106     |     2160p    |  50Hz |  64:27  |  树莓派 4  |
|     107     |     2160p    |  60Hz |  64:27  |  树莓派 4  |

① 仅在处理器超频主频下可用：须设置 `core_freq_min=600` 和 `core_freq=600`。[请参阅超频](https://www.raspberrypi.com/documentation/computers/config_txt.html#overclocking)。

双倍像素、四倍像素意味着更高的时钟主频，每个像素各重复两次、四次。

以下值仅在 `hdmi_group=2`（DMT）下有效：

| `hdmi_mode` |    分辨率    |  刷新率  |  屏幕比例 |                                                             备注                                                            |
| :---------: | :-------: | :---: | :---: | :-----------------------------------------------------------------------------------------------------------------------: |
|      1      |  640x350  |  85Hz |       |                                                                                                                           |
|      2      |  640x400  |  85Hz | 16:10 |                                                                                                                           |
|      3      |  720x400  |  85Hz |       |                                                                                                                           |
|      4      |  640x480  |  60Hz |  4:3  |                                                                                                                           |
|      5      |  640x480  |  72Hz |  4:3  |                                                                                                                           |
|      6      |  640x480  |  75Hz |  4:3  |                                                                                                                           |
|      7      |  640x480  |  85Hz |  4:3  |                                                                                                                           |
|      8      |  800x600  |  56Hz |  4:3  |                                                                                                                           |
|      9      |  800x600  |  60Hz |  4:3  |                                                                                                                           |
|      10     |  800x600  |  72Hz |  4:3  |                                                                                                                           |
|      11     |  800x600  |  75Hz |  4:3  |                                                                                                                           |
|      12     |  800x600  |  85Hz |  4:3  |                                                                                                                           |
|      13     |  800x600  | 120Hz |  4:3  |                                                                                                                           |
|      14     |  848x480  |  60Hz |  16:9 |                                                                                                                           |
|      15     |  1024x768 |  43Hz |  4:3  |                                                           树莓派不兼容                                                          |
|      16     |  1024x768 |  60Hz |  4:3  |                                                                                                                           |
|      17     |  1024x768 |  70Hz |  4:3  |                                                                                                                           |
|      18     |  1024x768 |  75Hz |  4:3  |                                                                                                                           |
|      19     |  1024x768 |  85Hz |  4:3  |                                                                                                                           |
|      20     |  1024x768 | 120Hz |  4:3  |                                                                                                                           |
|      21     |  1152x864 |  75Hz |  4:3  |                                                                                                                           |
|      22     |  1280x768 |  60Hz |  15:9 |                                                           降低清屏时间                                                          |
|      23     |  1280x768 |  60Hz |  15:9 |                                                                                                                           |
|      24     |  1280x768 |  75Hz |  15:9 |                                                                                                                           |
|      25     |  1280x768 |  85Hz |  15:9 |                                                                                                                           |
|      26     |  1280x768 | 120Hz |  15:9 |                                                           降低清屏时间                                                          |
|      27     |  1280x800 |   60  | 16:10 |                                                           降低清屏时间                                                          |
|      28     |  1280x800 |  60Hz | 16:10 |                                                                                                                           |
|      29     |  1280x800 |  75Hz | 16:10 |                                                                                                                           |
|      30     |  1280x800 |  85Hz | 16:10 |                                                                                                                           |
|      31     |  1280x800 | 120Hz | 16:10 |                                                           降低清屏时间                                                          |
|      32     |  1280x960 |  60Hz |  4:3  |                                                                                                                           |
|      33     |  1280x960 |  85Hz |  4:3  |                                                                                                                           |
|      34     |  1280x960 | 120Hz |  4:3  |                                                           降低清屏时间                                                          |
|      35     | 1280x1024 |  60Hz |  5:4  |                                                                                                                           |
|      36     | 1280x1024 |  75Hz |  5:4  |                                                                                                                           |
|      37     | 1280x1024 |  85Hz |  5:4  |                                                                                                                           |
|      38     | 1280x1024 | 120Hz |  5:4  |                                                           降低清屏时间                                                          |
|      39     |  1360x768 |  60Hz |  16:9 |                                                                                                                           |
|      40     |  1360x768 | 120Hz |  16:9 |                                                           降低清屏时间                                                          |
|      41     | 1400x1050 |  60Hz |  4:3  |                                                           降低清屏时间                                                          |
|      42     | 1400x1050 |  60Hz |  4:3  |                                                                                                                           |
|      43     | 1400x1050 |  75Hz |  4:3  |                                                                                                                           |
|      44     | 1400x1050 |  85Hz |  4:3  |                                                                                                                           |
|      45     | 1400x1050 | 120Hz |  4:3  |                                                           降低清屏时间                                                          |
|      46     |  1440x900 |  60Hz | 16:10 |                                                           降低清屏时间                                                          |
|      47     |  1440x900 |  60Hz | 16:10 |                                                                                                                           |
|      48     |  1440x900 |  75Hz | 16:10 |                                                                                                                           |
|      49     |  1440x900 |  85Hz | 16:10 |                                                                                                                           |
|      50     |  1440x900 | 120Hz | 16:10 |                                                           降低清屏时间                                                          |
|      51     | 1600x1200 |  60Hz |  4:3  |                                                                                                                           |
|      52     | 1600x1200 |  65Hz |  4:3  |                                                                                                                           |
|      53     | 1600x1200 |  70Hz |  4:3  |                                                                                                                           |
|      54     | 1600x1200 |  75Hz |  4:3  |                                                                                                                           |
|      55     | 1600x1200 |  85Hz |  4:3  |                                                                                                                           |
|      56     | 1600x1200 | 120Hz |  4:3  |                                                           降低清屏时间                                                          |
|      57     | 1680x1050 |  60Hz | 16:10 |                                                           降低清屏时间                                                          |
|      58     | 1680x1050 |  60Hz | 16:10 |                                                                                                                           |
|      59     | 1680x1050 |  75Hz | 16:10 |                                                                                                                           |
|      60     | 1680x1050 |  85Hz | 16:10 |                                                                                                                           |
|      61     | 1680x1050 | 120Hz | 16:10 |                                                           降低清屏时间                                                          |
|      62     | 1792x1344 |  60Hz |  4:3  |                                                                                                                           |
|      63     | 1792x1344 |  75Hz |  4:3  |                                                                                                                           |
|      64     | 1792x1344 | 120Hz |  4:3  |                                                           降低清屏时间                                                          |
|      65     | 1856x1392 |  60Hz |  4:3  |                                                                                                                           |
|      66     | 1856x1392 |  75Hz |  4:3  |                                                                                                                           |
|      67     | 1856x1392 | 120Hz |  4:3  |                                                           降低清屏时间                                                          |
|      68     | 1920x1200 |  60Hz | 16:10 |                                                           降低清屏时间                                                          |
|      69     | 1920x1200 |  60Hz | 16:10 |                                                                                                                           |
|      70     | 1920x1200 |  75Hz | 16:10 |                                                                                                                           |
|      71     | 1920x1200 |  85Hz | 16:10 |                                                                                                                           |
|      72     | 1920x1200 | 120Hz | 16:10 |                                                           降低清屏时间                                                          |
|      73     | 1920x1440 |  60Hz |  4:3  |                                                                                                                           |
|      74     | 1920x1440 |  75Hz |  4:3  |                                                                                                                           |
|      75     | 1920x1440 | 120Hz |  4:3  |                                                           降低清屏时间                                                          |
|      76     | 2560x1600 |  60Hz | 16:10 |                                                           降低清屏时间                                                          |
|      77     | 2560x1600 |  60Hz | 16:10 |                                                                                                                           |
|      78     | 2560x1600 |  75Hz | 16:10 |                                                                                                                           |
|      79     | 2560x1600 |  85Hz | 16:10 |                                                                                                                           |
|      80     | 2560x1600 | 120Hz | 16:10 |                                                           降低清屏时间                                                          |
|      81     |  1366x768 |  60Hz |  16:9 | [不适用于树莓派 4、5](https://www.raspberrypi.com/documentation/computers/config_txt.html#hdmi-pipeline-for-raspberry-pi-4-and-5) |
|      82     | 1920x1080 |  60Hz |  16:9 |                                                           1080p                                                           |
|      83     |  1600x900 |  60Hz |  16:9 |                                                           降低清屏时间                                                          |
|      84     | 2048x1152 |  60Hz |  16:9 |                                                           降低清屏时间                                                          |
|      85     |  1280x720 |  60Hz |  16:9 |                                                            720p                                                           |
|      86     |  1366x768 |  60Hz |  16:9 |                                                           降低清屏时间                                                          |

> **注意**
>
> 像素时钟有限制。树莓派 4 之前的型号支持的最高信号格式为 1920×1200 60Hz，带降低清屏（reduced blanking）时间，而树莓派 4 可以支持高达 4096×2160（俗称 4k）60Hz。还请注意，如果你正在使用树莓派 4 的两个 HDMI 端口进行 4k 输出，则两者都将被限制至 30Hz。

#### `hdmi_timings`

可自定义原始 HDMI 时序值：用 `hdmi_group=2` 和 `hdmi_mode=87` 可自定义信号格式。

```sh
hdmi_timings=<水平有效像素> <水平同步极性> <水平前沿填充> <水平同步脉冲> <水平后沿填充> <垂直有效行数> <垂直同步极性> <垂直前沿填充> <垂直同步脉冲> <垂直后沿填充> <垂直同步偏移量A> <垂直同步偏移量B> <像素复制> <帧率> <隔行> <像素频率> <宽高比>
```

```sh
<水平有效像素>     = 水平像素（宽度）
<水平同步极性>     = 反转水平同步信号极性
<水平上沿填充>     = 从数据使能（DE）信号激活后的水平上沿填充
<水平同步脉冲>     = 水平同步信号脉冲宽度（以像素时钟为单位）
<水平下沿填充>     = 从数据使能（DE）信号激活后的水平下沿填充
<垂直有效行数>     = 垂直像素高度（行数）
<垂直同步极性>     = 反转垂直同步信号极性
<垂直上沿填充>     = 从数据使能（DE）信号激活后的垂直上沿填充
<垂直同步脉冲>     = 垂直同步信号脉冲宽度（以像素时钟为单位）
<垂直下沿填充>     = 从数据使能（DE）信号激活后的垂直下沿填充
<垂直同步偏移量 A> = 保持为零
<垂直同步偏移量 B> = 保持为零
<像素复制>　　　 　 = 保持为零
<帧率>            = 屏幕刷新率（以赫兹为单位）
<隔行>            = 保持为零
<像素频率>　　　　  = 时钟频率（水平有效像素 + 水平前沿填充 + 水平同步脉冲 + 水平后沿填充）
                         *（垂直有效行数 + 垂直前沿填充 + 垂直同步脉冲 + 垂直后沿填充）
                         * 刷新率
<宽高比>          = [参见脚注]
```

可将宽高比设置为以下八个值之一。请从以下选项中，选择一个与你屏幕的宽高比最相近的值：

|  宽高比  |          名称          |  值  |
| :---: | :------------------: | :-: |
|  4:3  |  HDMI\_ASPECT\_4\_3  |  1  |
|  14:9 |  HDMI\_ASPECT\_14\_9 |  2  |
|  16:9 |  HDMI\_ASPECT\_16\_9 |  3  |
|  5:4  |  HDMI\_ASPECT\_5\_4  |  4  |
| 16:10 | HDMI\_ASPECT\_16\_10 |  5  |
|  15:9 |  HDMI\_ASPECT\_15\_9 |  6  |
|  21:9 |  HDMI\_ASPECT\_21\_9 |  7  |
| 64:27 | HDMI\_ASPECT\_64\_27 |  8  |

#### `hdmi_force_mode`

若置为 `1`，将从内部列表中删除所有除 `hdmi_mode` 和 `hdmi_group` 指定外的其他信号格式，这意味着它们不会出现在一切信号格式的枚举列表中。如果显示器似乎无视 `hdmi_mode` 和 `hdmi_group` 配置，此参数可能有用。

#### `edid_content_type`

强制将 EDID 的内容类型设置为特定值。

参数如下：

* `0 = EDID_ContentType_NODATA`，内容类型为无
* `1 = EDID_ContentType_Graphics`，内容类型为图形，必须把 ITC 置为 `1`
* `2 = EDID_ContentType_Photo`，内容类型为照片
* `3 = EDID_ContentType_Cinema`，内容类型为电影
* `4 = EDID_ContentType_Game`，内容类型游戏

### 我的显示器能使用哪些值？

你的 HDMI 显示器可能仅支持有限的信号格式。要找出受支持的格式，请使用以下方法：

* 将输出格式设置为 VGA 60Hz ( `hdmi_group=1` 和 `hdmi_mode=1` ) ，然后启动你的树莓派
* 输入以下参数可列出受支持的 CEA 信号格式: `/opt/vc/bin/tvservice -m CEA`
* 输入以下参数可列出受支持的 DMT 信号格式: `/opt/vc/bin/tvservice -m DMT`
* 输入以下参数可显示当前状态： `/opt/vc/bin/tvservice -s`
* 输入以下参数可从你的显示器中获取更详细的信息： `/opt/vc/bin/tvservice -d edid.dat; /opt/vc/bin/edidparser edid.dat`

在排除默认 HDMI 信号格式的故障时，也应附带 `edid.dat`。

### 自定义信号格式

如果你的显示器所需的信号格式未列在上述表格中，那么可以为其自定义一种 CVT 信号格式：

```bash
hdmi_cvt=<宽> <高> <帧率> <宽高比> <边距> <交错> <降低清屏时间>
```

|    值   |  默认值 | 说明                                           |
| :----: | :--: | -------------------------------------------- |
|    宽   | （必填） | 像素宽度                                         |
|    高   | （必填） | 像素高度                                         |
|   帧率   | （必填） | 每秒帧数                                         |
|   宽高比  |   3  | 宽高比 1=4:3、2=14:9、3=16:9、4=5:4、5=16:10、6=15:9 |
|   边距   |   0  | 0=禁用边距、1=启用边距                                |
|   交错   |   0  | 0=逐行扫描、1=隔行扫描                                |
| 降低清屏时间 |   0  | 0=正常、1=降低清屏时间                                |

可省略末尾的字段，使用默认值。

请注意，这仅 **创建了** 信号格式（group 2 mode 87）。要使树莓派默认应用该信号格式，你需要进行一些额外设置。例如，要选择分辨率 800×480 并启用音频驱动：

```bash
hdmi_cvt=800 480 60 6
hdmi_group=2
hdmi_mode=87
hdmi_drive=2
```

如果你的显示器不支持标准 CVT 时序，则可能无法正常工作。

### 复合视频信号格式

#### `sdtv_mode`

参数 `sdtv_mode` 定义了用于复合视频输出的电视标准。

| `sdtv_mode` |                 意义                |
| :---------: | :-------------------------------: |
|   `0`（默认）   |              普通 NTSC              |
|     `1`     |      日式 NTSC ——无黑电平（pedestal）     |
|     `2`     |               普通 PAL              |
|     `3`     | 巴西式 PAL：使用 525/60 而非 625/50，副载波不同 |
|     `16`    |             逐行扫描的 NTSC            |
|     `18`    |             逐行扫描的 PAL             |

#### `sdtv_aspect`

`sdtv_aspect` 参数定义了复合视频输出的纵横比。默认值为 `1`。

| `sdtv_aspect` |  意义  |
| :-----------: | :--: |
|      `1`      |  4:3 |
|      `2`      | 14:9 |
|      `3`      | 16:9 |

#### `sdtv_disable_colourburst`

若将 `sdtv_disable_colourburst` 置为 `1`，会禁用复合视频输出上的彩色突发信号。图片将以单色显示，但可能会更清晰。

### 液晶显示屏和触摸屏

#### `display_default_lcd`

如果检测到了树莓派触摸显示屏，它将被用作默认显示器，并显示帧缓冲区。设置 `display_default_lcd=0` 可确保液晶显示屏并非是默认显示器，这通常意味着使用 HDMI 的默认输出。仍可通过在受支持的应用程序（如 omxplayer）中选择显示器编号来使用液晶显示屏。

#### `lcd_framerate`

可指定树莓派触摸显示屏的帧率（Hz/fps）。默认为 60Hz。

#### `lcd_rotate`

将使用 LCD 内置的旋转功能调整显示方向，这比使用基于 GPU 的旋转操作更节省计算资源。

如，`lcd_rotate=2` 可回正倒立的显示界面。

#### `enable_dpi_lcd`

启用连接到 DPI GPIO 的 LCD 显示器。将允许使用并行显示接口的第三方 LCD 显示器。

#### `dpi_group`, `dpi_mode`, `dpi_output_format`

参数 `dpi_group` 和 `dpi_mode config.txt` 用于设置预定信号格式（在 HDMI 中使用的 DMT、CEA 信号格式，如上所述）。用户可以以与 HDMI 相同的方式生成自定义信号格式（请参阅 `dpi_timings` 部分）。

`dpi_output_format` 是个位掩码，可指定用于设置显示格式的各种参数。

#### `dpi_timings`

可设置原始 DPI 时序值，用于自定义信号格式，通过 `dpi_group=2` 和 `dpi_mode=87` 选定。

```bash
dpi_timings=<水平有效像素> <水平同步极性> <水平前沿填充> <水平同步脉冲> <水平后沿填充> <垂直有效行数> <垂直同步极性> <垂直前沿填充> <垂直同步脉冲> <垂直后沿填充> <垂直同步偏移量 A> <垂直同步偏移量 B> <像素复制> <帧率> <隔行> <像素频率> <宽高比>
```

```bash
<水平有效像素>     = 水平像素（宽度）
<水平同步极性>     = 反转水平同步信号极性
<水平上沿填充>     = 从数据使能（DE）信号激活后的水平上沿填充
<水平同步脉冲>     = 水平同步信号脉冲宽度（以像素时钟为单位）
<水平下沿填充>     = 从数据使能（DE）信号激活后的水平下沿填充
<垂直有效行数>     = 垂直像素高度（行数）
<垂直同步极性>     = 反转垂直同步信号极性
<垂直上沿填充>     = 从数据使能（DE）信号激活后的垂直上沿填充
<垂直同步脉冲>     = 垂直同步信号脉冲宽度（以像素时钟为单位）
<垂直下沿填充>     = 从数据使能（DE）信号激活后的垂直下沿填充
<垂直同步偏移量 A> = 保持为零
<垂直同步偏移量 B> = 保持为零
<像素复制>        = 保持为零
<帧率>           = 屏幕刷新率（Hz）
<隔行>           = 保持为零
<像素频率>        = 时钟频率（水平有效像素 + 水平前沿填充 + 水平同步脉冲 + 水平后沿填充）
                        *（垂直有效行数 + 垂直前沿填充 + 垂直同步脉冲 + 垂直后沿填充）
                        * 刷新率
<宽高比>          = [参见脚注]
```

可将宽高比设置为以下八个值之一。请从以下选项中，选择一个与你屏幕的宽高比最相近的值：

|  宽高比  |          名称          |  值  |
| :---: | :------------------: | :-: |
|  4:3  |  HDMI\_ASPECT\_4\_3  |  1  |
|  14:9 |  HDMI\_ASPECT\_14\_9 |  2  |
|  16:9 |  HDMI\_ASPECT\_16\_9 |  3  |
|  5:4  |  HDMI\_ASPECT\_5\_4  |  4  |
| 16:10 | HDMI\_ASPECT\_16\_10 |  5  |
|  15:9 |  HDMI\_ASPECT\_15\_9 |  6  |
|  21:9 |  HDMI\_ASPECT\_21\_9 |  7  |
| 64:27 | HDMI\_ASPECT\_64\_27 |  8  |

### 通用显示参数

#### `hdmi_force_hotplug`

若将 `hdmi_force_hotplug` 置为 `1`，会把 HDMI 热插拔信号伪装已触发，使系统认为已接入了 HDMI 显示器。换句话说，即使未检测到 HDMI 显示器，也会使用 HDMI 信号输出。

#### `hdmi_ignore_hotplug`

若将 `hdmi_ignore_hotplug` 置为 `1`，会把 HDMI 热插拔信号伪装成未被触发，因此看起来好似没有连接 HDMI 显示器一样。因此，即使连接了显示器，HDMI 输出也将被禁用。

#### `disable_overscan`

`disable_overscan` 的默认值为 `0`，将为左右上下四周边缘设置默认的过扫描值：CEA 高清信号为 `48`、对于 CEA 标清信号格式为 `32`、DMT 信号格式为 `0`。

若将 `disable_overscan` 置为 `1`，将禁用固件设置的默认的[过扫描](https://www.raspberrypi.com/documentation/computers/configuration.html#underscan)值。

#### `overscan_left`

参数 `overscan_left` 可指定将添加到屏幕左边缘的固件默认过扫描值的像素数。默认值为 `0`。

若文本溢出屏幕左边缘，请增加此值；若屏幕左边缘和文本之间有黑色边框，请调低此值。

#### `overscan_right`

参数 `overscan_right` 可指定将添加到屏幕右边缘过扫描的固件默认值的像素数。默认值为 `0`。

若文本溢出屏幕右边缘，请增加此值；若屏幕右边缘和文本之间有黑色边框，请减少此值。

#### `overscan_top`

`overscan_top` 参数可指定将添加到屏幕顶部过扫描的固件默认值的像素数。默认值为 `0`。

若文本溢出屏幕顶部边缘，请增加此值；若屏幕顶部边缘和文本之间有黑色边框，请减少此值。

#### `overscan_bottom`

`overscan_bottom` 参数可指定将添加到屏幕底部边缘过扫描的像素数。默认值为 `0`。

若文本溢出屏幕底部边缘，请增加此值；若屏幕底部边缘和文本之间有黑色边框，请减少此值。

#### `overscan_scale`

若将 `overscan_scale` 置为 `1`，可强制所有非帧缓冲层遵守过扫描设置。默认值为 `0`。

> **注意**
>
> 通常不建议使用此功能：若这样做，显示器上的所有图层都将由 GPU 缩放，可能会降低图像质量。建议针对显示器自身禁用过扫描，以避免图像被 GPU 和显示器缩放两回。

#### `framebuffer_width`

参数 `framebuffer_width` 可指定像素中的控制台帧缓冲区宽度。默认值为显示宽度减去总水平过扫描量。

#### `framebuffer_height`

参数 `framebuffer_height` 可指定控制台帧缓冲区的像素高度。默认值为显示高度减去总垂直过扫描量。

#### `max_framebuffer_height`、`max_framebuffer_width`

可指定内部帧缓冲区的最大尺寸。

#### `framebuffer_depth`

使用 `framebuffer_depth` 来指定每像素位的控制台帧缓冲区深度。默认值为 `16`。

| `framebuffer_depth` |    结果    | 注解                                      |
| :-----------------: | :------: | --------------------------------------- |
|          8          |  8 位帧缓冲区 | 默认的 RGB 调色板使屏幕难以看清                      |
|          16         | 16 位帧缓冲区 |                                         |
|          24         | 24 位帧缓冲区 | 可能导致显示器损坏                               |
|          32         | 32 位帧缓冲区 | 可能需要与 `framebuffer_ignore_alpha=1` 联合使用 |

#### `framebuffer_ignore_alpha`

若将 `framebuffer_ignore_alpha` 置为 `1`，会禁用 alpha 管道。可以改善 32 位 `framebuffer_depth` 显示。

#### `framebuffer_priority`

如设备接入了多个显示器，若此时使用旧款（KMS 之前）图形驱动程序，回强制特定的内部显示设备成为首个 Linux 帧缓冲区（即 `/dev/fb0`）。

可设置的参数有：

|   显示器  |  ID |
| :----: | :-: |
|  主 LCD |  0  |
|  次 LCD |  1  |
| HDMI 0 |  2  |
| 复合视频输出 |  3  |
| HDMI 1 |  7  |

#### `max_framebuffers`

此配置条目将设置可创建的固件帧缓冲区的最大数量。有效值为 `0`、`1` 和 `2`。在旧设备上，默认设置为 `1`，因此当使用多个显示器时（如 HDMI、DSI、DPI 显示器）时，需要将其增加到 `2`。树莓派 4 的默认配置即是 `2`，因为它有两个 HDMI 端口。

在大多数情况下，将其设置为 `2` 是安全的，因为只有在实际检测到已连接的设备后才会创建帧缓冲区。

若将此值置为 `0`，可在无头模式下减少内存需求，因为这将阻止分配帧缓冲区。

#### `test_mode`

参数 `test_mode` 可在启动过程中，以持续给定的时间（秒），显示测试图像和声音（仅输出至复合视频输出和模拟音频），然后继续正常启动操作系统。用作工厂测试。默认值为 `0`。

#### `display_hdmi_rotate`

使用 `display_hdmi_rotate` 旋转、镜像 HDMI 显示方向。默认值为 `0`。

| `display_hdmi_rotate` |      意义     |
| :-------------------: | :---------: |
|           0           |   不改变屏幕方向   |
|           1           |  顺时针旋转 90 度 |
|           2           | 顺时针旋转 180 度 |
|           3           | 顺时针旋转 270 度 |
|         65536         |     水平镜像    |
|         131072        |     垂直镜像    |

请注意，旋转 90 度、270 度需要更多的 GPU 内存，因此这些参数在 16MB GPU 分配下不可用。

你可以组合旋转、镜像将其叠加。你也可以用相同的方式同时进行水平镜像和垂直镜像。例如，旋转 180 度，再加上垂直镜像、水平镜像为 `0x20000 + 0x10000 + 2 = 0x30002`。

#### `display_lcd_rotate`

对于旧款图形驱动程序（适用于树莓派 4 先前的型号），请使用 `display_lcd_rotate` 来旋转和镜像 LCD 方向。参数与 `display_hdmi_rotate` 相同。另请参阅 `lcd_rotate`。

#### `display_rotate`

在最新款固件中，`display_rotate` 已弃用。仅保留用于向下兼容。请改用 `display_lcd_rotate`、`display_hdmi_rotate`。

使用 `display_rotate` 可旋转和镜像屏幕方向。参数与 `display_hdmi_rotate` 相同。

### 其他参数

#### `dispmanx_offline`

可强制在两个离屏帧缓冲区中离线完成 `dispmanx` 合成。这样可以合成更多的 `dispmanx` 元素，但速度较慢，可能会将屏幕帧率限制在约 30fps 左右。

## 旧版树莓派 4 HDMI 管道

> **重要**
>
> 当使用图形驱动程序 VC4 KMS 时，完整的显示管道由 Linux 管理——包括 HDMI 输出。这些设置仅兼容于旧的 FKMS 和基于固件的图形驱动程序。

树莓派 4 无法在 HDMI 输出 `1366×768 @ 60Hz`。对于这些显示器，可配置其使用 `1360×768 @ 60Hz`。它们通常未通过 EDID 广播此信号格式，因此无法自动选定，但可以手动添加来选定：

```bash
hdmi_group=2
hdmi_mode=87
hdmi_cvt=1360 768 60
```

……到 config.txt。

在 `hdmi_timings=` 这一行，手动指定的时间也需要遵守限制：所有水平时序参数必须为 2 的倍数。

`dpi_timings=` 不受相同限制，因为该管道在每个时钟周期仍然仅运行一个像素。

## 其他旧版参数

### `avoid_warnings`

`avoid_warnings=2`：允许在低电压下进入超频模式。

### `logging_level`

设置 VideoCore 的日志级别。该值是 VideoCore 的一个特定的位掩码。
