> 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 位内核。

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

### `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`（48 MHz）。请注意，此时钟仅适用于 UART0（Linux 为 ttyAMA0），且串口的最大波特率受限为时钟的 1/16。树莓派 3 和树莓派 Zero 的默认串口是 UART1（Linux 为 ttyS0），其时钟等同于核心 VPU 时钟——至少为 250 MHz。

### `bootcode_delay`

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

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

### `boot_delay`

参数 `boot_delay` 会在加载内核之前，强制 `start.elf` 阶段等待给定的时间（秒），默认值为 `0`。总延迟计算公式为 `(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`。

### `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` 最终确定后。

## 旧版超频参数

（另请参阅 [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`，会禁止 CPU 访问 GPU 的 L2 缓存，并且需要配套使用禁用了 L2 缓存的内核。BCM2835 的默认值为 `0`。基于 BCM2836、BCM2837、BCM2711 和 BCM2712 的树莓派，其 Arm CPU 自带 L2 缓存，故默认值为 `1`。标准树莓派 `kernel.img` 和 `kernel7.img` 构建反映了这一缓存设置差异。

## 旧版视频参数

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

### HDMI 信号格式

> **注意**
>
> 由于部分设备搭载多个 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`。

最初的 Model B 和 Model A 的默认值为 `2`。Model 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](https://www.raspberrypi.com/documentation/computers/legacy_config_txt.html#raspberry-pi-4-hdmi-pipeline) |
|      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=<宽> <高> <帧率> <宽高比> <边距> <交错> <降低清屏时间>
```

|    值   |  默认值 | 说明                                           |
| :----: | :--: | -------------------------------------------- |
|    宽   | （必填） | 像素宽度                                         |
|    高   | （必填） | 像素高度                                         |
|   帧率   | （必填） | 帧率（Hz）                                       |
|   宽高比  |   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`。在树莓派 4 之前的设备上，默认设置为 `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 度 |
|       `0x10000`       |     水平镜像    |
|       `0x20000`       |     垂直镜像    |

请注意，旋转 90 度、270 度需要更多的 GPU 内存，因此这些选项在 16 MB 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` 中。

通过 `config.txt` 中 `hdmi_timings=` 行手动指定的时序，也必须遵守以下限制：所有水平时序参数必须为 2 的倍数。

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

## 其他旧版参数

### `avoid_warnings`

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

### `logging_level`

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