配置和管理内存

Qualcomm^® Linux 内核基线支持所有内存管理特性和分配器。以下信息概述了如何自定义内存映射（memory map）以及执行堆（heap）管理。有关 Linux 内核内存管理的更多信息，请参阅 Memory management。 内存映射 内存映射描述了在内核启动期间为调制解调器、摄像头、aDSP 和 cDSP 等子系统保留的区域。内存映射在 DTSI 中为划出（carved out）的区域设置 no-map，使内核无法访问这些区域。可配置的划出区域在 arch/arm64/boot/dts/qcom/kodiak.dtsi 文件的 reserved-memory 节点下定义。

reserved-memory {
               cdsp_secure_heap_mem: cdsp-secure-heap@81800000 {
                        reg = <0x0 0x81800000 0x0 0x1e00000>;
                        no-map;
               };

               camera_mem: camera@84300000 {
                        reg = <0x0 0x84300000 0x0 0x500000>;
                        no-map;
               };

               wpss_mem: wpss@0x84800000 {
                        reg = <0x0 0x84800000 0x0 0x1900000>;
                        no-map;
               };

               adsp_mem: adsp@86100000 {
                        reg = <0x0 0x86100000 0x0 0x2800000>;
                        no-map;
               };
};

对于 Qualcomm SoC，请参阅特定于 SoC 的 Qualcomm DTSI 文件以获取此信息。

以下早期启动日志显示了为不同子系统创建的划出区域：

[    0.000000] OF: reserved mem: 0x0000000081800000..0x00000000835fffff (30720 KiB) nomap non-reusable cdsp-secure-heap@81800000
[    0.000000] OF: reserved mem: 0x0000000084300000..0x00000000847fffff (5120 KiB) nomap non-reusable camera@84300000
[    0.000000] OF: reserved mem: 0x0000000084800000..0x00000000860fffff (25600 KiB) nomap non-reusable wpss@0x84800000
[    0.000000] OF: reserved mem: 0x0000000086100000..0x00000000888fffff (40960 KiB) nomap non-reusable adsp@86100000

连续内存分配器

Qualcomm Linux 发行版支持 CMA 来分配大块物理连续内存。CMA 在启动时保留一块大的物理连续内存区域，并为 CMA 分配提供物理连续内存。在不使用时，CMA 内存可供内核伙伴分配器（buddy allocator）用于可移动（movable）分配。要更改默认 CMA 区域的大小，请在内核命令行参数中使用 cma=size_in_MB。有关如何使用该内核参数的更多信息，请参阅以下示例：

cma=nn[MG]@[start[MG][-end[MG]]]
                        [KNL,CMA]
                        Sets the size of kernel global memory area for
                        contiguous memory allocations and optionally the
                        placement constraint by the physical address range of
                        memory allocations. A value of 0 disables CMA
                        altogether. For more information, see
                        kernel/dma/contiguous.c

自定义 CMA 区域在 reserved-memory 节点下定义，并带有表示 CMA 区域的 shared-dma-pool compatible 标记：

adsp_heap_mem: adsp-heap {
                        compatible = "shared-dma-pool";
                        alloc-ranges = <0x0 0x00000000 0x0 0xffffffff>;
                        reusable;
                        alignment = <0x0 0x400000>;
                        size = <0x0 0xc00000>;
               };

以下是启动时保留的 aDSP CMA 内存区域的示例日志：

[    0.000000] OF: reserved mem: initialized node adsp-heap, compatible id shared-dma-pool
[    0.000000] OF: reserved mem: 0x00000000ff000000..0x00000000ffbfffff (12288 KiB) map reusable adsp-heap

支持的堆

下表列出了 Qualcomm Linux 发行版默认支持的堆： 表：默认支持的堆

堆名称	设备节点	描述	用法
System	/dev/dma_heap/system	内核创建的默认 DMA-BUF 堆。	所有通用用例都应使用底层采用通用 Linux 内存管理伙伴分配器的 system 堆。
Reserved	/dev/dma_heap/reserved	系统中创建的默认 CMA 类型堆，使用默认的 reserved CMA 区域。	如果因某些约束需要连续内存，请使用 CMA 堆。

使用 DMA-BUF 堆

Qualcomm Linux 发行版支持 DMA-BUF 堆，用于指定自定义 CMA 堆。使用 DMA-BUF 堆时，/dev/dma_heap 文件系统中的每个堆都对应一个设备文件。除了 system 堆和通用的 CMA reserved 堆之外，您还可以创建自己的 CMA 类型 DMA-BUF 堆。以下示例程序演示了如何使用 Qualcomm Linux 内核在 /dev/dma_heap/system 中创建的 DMA-BUF system 堆：

include <stdio.h>
include <stdlib.h>
include <fcntl.h>
include <errno.h>
include <unistd.h>
include <sys/ioctl.h>
include <linux/dma-buf.h>
#include <linux/dma-heap.h>

define DMA_HEAP_NAME "system"
define SZ_4 0x00000004  // to allocate a 4K buffer

int main()
{
int fd, dma_buf_fd;

struct dma_heap_allocation_data dma_alloc_data = {
   .len = SZ_4,
   .fd_flags = O_RDWR | O_CLOEXEC,
};

struct dma_buf_sync sync_start = {
   .flags = DMA_BUF_SYNC_START,
};
struct dma_buf_sync sync_end = {
   .flags = DMA_BUF_SYNC_END,
};

fd = open("/dev/dma_heap/system", O_RDWR);
if (fd < 0) {
   perror("open");
   return errno;
}

dma_buf_fd = ioctl(fd, DMA_HEAP_IOCTL_ALLOC, &dma_alloc_data);
if (dma_buf_fd < 0) {
   perror("ioctl");
   return errno;
}
printf("Allocated DMA buffer with fd %d\n", dma_buf_fd);

if (ioctl(dma_buf_fd, DMA_BUF_IOCTL_SYNC, &sync_start)) {
   perror("ioctl DMA_BUF_IOCTL_SYNC start");
   return errno;
}

//        Do something with the buffer here

if (ioctl(dma_buf_fd, DMA_BUF_IOCTL_SYNC, &sync_end))
{
   perror("ioctl DMA_BUF_IOCTL_SYNC end");
   return errno;
}

if (close(dma_buf_fd)) {
   perror("close");
   return errno;
}

if (close(fd)) {
   perror("close");
   return errno;
}

return 0;
}

将 ZRAM 配置为交换设备

ZRAM 是一种压缩交换机制，它在 RAM 中创建一个虚拟块设备。ZRAM 在内核 defconfig 中作为模块启用。 ZRAM 在 Yocto 构建中的 recipes-extended/zram/zram/zram-swap-init-update 文件中配置。要启用或配置 ZRAM，请执行以下操作：

# check if zram module is loaded
  lsmod | grep zram

# else load it
  modprobe zram

# Configure /dev/zram0 size according to your RAM size
  echo 128M > /sys/block/zram0/disksize

# activate swap
  mkswap /dev/zram0
  swapon /dev/zram0

要将 ZRAM 配置为交换设备，请参阅 zram: Compressed RAM-based block devices。

扩展内存映射

要扩展内存映射，请在 DTSI 文件中调整内存区域的地址和大小。使用以下信息扩展划出区域：使用以下语法在 arch/arm64/boot/dts/qcom/<SoC>-<board>-<variant>.dts 文件的 reserved-memory 节点中添加划出区域：

my_carveout_mem: my_carveout_mem@address {
      reg= <0x0 0xbase_address 0x0 0xsize>;
      no-map;
}

例如：

my_carveout_mem: my_carveout_mem@d0800000 {
      reg= <0x0 0xd0800000 0x0 0x100000>;
      no-map;
}

表：划出区域语法

变量	描述
my_carveout_mem@d0800000	表示设备节点的名称。按照约定，必须将内存区域的基地址附加到名称后面。
my_carveout_mem	表示分配给此节点的标签，可通过 phandle 从设备树中的其他节点引用此节点。
reg	表示该属性，它是一个 64 位值，定义了内存区域的基地址和大小。
no-map	表示该区域已被划出，内核应将其映射从可寻址范围中移除。

任何区域都不应重叠。如果必须增大某个区域的大小，请移动所有后续区域，并在设备树中进行配置以避免重叠。
内核要求为内核使用而定义的所有内存区域边界为 1 MB。
现有的划出区域受可信固件保护，内核无法访问。减小其大小或删除它们可能导致外部中止（external abort），进而引发内核崩溃。

添加 CMA 区域 要在 arch/arm64/boot/dts/qcom/<SoC>-<board>-<variant>.dts 文件的 reserved-memory 节点下添加 CMA 区域，请使用以下语法：

my_cma_mem: my_cma {
   compatible = "shared-dma-pool";
   alloc-ranges = <0x0 0x00000000 0x0 0xffffffff>;
   reusable;
   alignment = <0x0 0x400000>;
   size = <0x0 0x1400000>;
};

表：添加 CMA 区域的语法

参数	描述
my_cma_mem	CMA 节点的标签，可作为 phandle 访问。标签 `my_cma` 是 CMA 区域的名称。
shared-dma-pool	表示该区域是一个 CMA 区域。
alloc-ranges	表示该区域是否应位于某个内存限制内，因为某些设备无法访问超出 32 位地址限制的内存区域。
reusable	表示内核可以在该区域空闲时使用其中的内存。
alignment	表示该区域的任何对齐要求。
size	表示该区域的大小。
reg	这是一个可选属性，表示用于内存分配的固定区域；如果没有该属性，内存将在随机地址动态分配。

简介

架构

关键文档

技术

系统

发行说明

连续内存分配器

支持的堆

使用 DMA-BUF 堆

将 ZRAM 配置为交换设备

扩展内存映射

​连续内存分配器

​支持的堆

​使用 DMA-BUF 堆

​将 ZRAM 配置为交换设备

​扩展内存映射

连续内存分配器

支持的堆

使用 DMA-BUF 堆

将 ZRAM 配置为交换设备

扩展内存映射