引导期内存机制与实现详解

源码路径：rk3588/kernel-6.1/mm/memblock.c、sparse.c、init-mm.c、mm_init.c
内核版本：Linux 6.1（RK3588 / ARM64）
文档目录：linuxDoc/mm/

目录

• 一、原理
• 二、实现方式
• 三、关键数据结构与接口
• 四、RK3588 平台说明
• 五、调试与观测
• 附录：源码索引

一、原理

1.1 为什么需要 memblock

内核启动早期，伙伴分配器（buddy） 与 SLUB 尚未初始化，但架构代码、设备树解析、CMA 预留等已经需要“分配/保留”物理地址范围。此时使用 memblock 作为临时分配器：

• 将系统视为若干 连续物理区间（region）
• 区分 可用内存（memory） 与 已保留（reserved）
• 只做 线性遍历与合并，不做细粒度 free list

1.2 从 memblock 到 buddy 的过渡

1.3 稀疏内存（SPARSEMEM）

ARM64 通常启用 CONFIG_SPARSEMEM：物理内存按 section 分段，只为实际存在的 section 分配 struct page 数组，避免为空洞内存浪费静态数组。

可选 CONFIG_SPARSEMEM_VMEMMAP：用虚拟映射的 vmemmap 降低元数据占用。

1.4 init_mm

全局 init_mm 是内核初始地址空间（swapper_pg_dir），所有内核线程在借用用户 mm 之前依赖它；与用户进程的 mm_struct 分离。

二、实现方式

2.1 memblock 核心结构

memblock.c 维护：

每个 region 为 struct memblock_region { base, size, flags, nid }。

2.2 登记与保留 API

架构在 setup_arch() 中解析 DT 后调用 memblock_add；reserved-memory 节点对应 memblock_reserve。

2.3 释放给 buddy：memblock_free_all()

1
2
3
4
5
6
7
8
9
10

void __init memblock_free_all(void)
{
	unsigned long pages;

	free_unused_memmap();
	reset_all_zones_managed_pages();

	pages = free_low_memory_core_early();
	totalram_pages_add(pages);
}

流程要点：

1. free_unused_memmap()：释放未使用 section 的 memmap 浪费
2. reset_all_zones_managed_pages()：同步 zone 的 managed_pages
3. free_low_memory_core_early()：遍历 memory region，对非保留页调用 __free_pages_memory()，页进入伙伴系统

之后 memblock_discard() 可丢弃 memblock 内部数据结构（仅保留 debugfs 需要时）。

2.4 sparse_init

sparse.c 中 sparse_init()：

• 为每个 online section 调用 sparse_init_one_section()
• 建立 pfn ↔ struct page 映射
• 与 pfn_valid()、NODE_DATA() 等后续 MM API 衔接

2.5 free_area_init 与 page_alloc_init

在 page_alloc.c：

• free_area_init(max_zone_pfn)：按 zone 切分 PFN 范围，初始化 pg_data_t、水位线、空闲链表头
• page_alloc_init()：注册 CPU hotplug 回调，初始化 per-CPU page lists（zone_pcp_update）

2.6 mm_init.c

mm_init.c 提供 调试验证（CONFIG_DEBUG_MEMORY_INIT）：打印 zonelist、pageflags 位域布局，不参与运行时分配。

2.7 init-mm.c

静态定义 struct mm_struct init_mm，绑定 swapper_pg_dir、mmap_lock、maple tree 根等，供内核态页表操作使用。

三、关键数据结构与接口

四、RK3588 平台说明

4.1 设备树与 reserved-memory

RK3588 在 DT 中常见：

• linux,cma 默认 CMA 池
• 显示/相机/VPU 专用 reserved-memory

这些在 arch/arm64 或 early boot 中转为 memblock_reserve()，在 memblock_free_all 时 不会 进入 buddy 空闲链表。

4.2 Rockchip Thunder Boot 延迟释放（本树特有）

memblock.c 含 CONFIG_ROCKCHIP_THUNDER_BOOT_DEFER_FREE_MEMBLOCK：

• 大块内存可登记到 db[]，在 defer_free_memblock 内核线程中 延迟 __free_pages_memory
• rk_defer_init_hpages() 可推迟 HighMem 区页初始化（本配置下 ARM64 通常不涉及 HighMem）
• 目的：加快快启路径，稍后再把 RAM 交给 buddy

排查启动内存问题时，注意 dmesg 中 defer_free_memblock 相关 pr_info。

4.3 ARM64 无 highmem

RK3588 64 位内核一般 不使用 highmem.c 热路径；可用内存在 ZONE_NORMAL（及 ZONE_DMA32）。

五、调试与观测

附录：源码索引

物理页分配机制与实现详解

源码路径：rk3588/kernel-6.1/mm/page_alloc.c、mmzone.c、vmstat.c
内核版本：Linux 6.1（RK3588 / ARM64）
文档目录：linuxDoc/mm/

目录

• 一、原理
• 二、实现方式
• 三、关键数据结构与接口
• 四、RK3588 平台说明
• 五、调试与观测
• 附录：源码索引

一、原理

1.1 伙伴系统（Buddy Allocator）

物理内存按 2^order 个连续页 组成块管理：

• order 0：单页（4KB，取决于 PAGE_SIZE）
• order n：2^n 页连续块
• 分配：在对应 order 空闲链取块；若无则向更高 order 分裂
• 释放：与 buddy 合并，若 buddy 也空闲则升阶

优点：O(log N) 分配/释放；缺点：外部碎片（有足够空闲页但无足够连续块）。

1.2 Zone 分层

每个 NUMA node（RK3588 UMA 通常仅 node 0）划分为多个 zone：

分配请求通过 zonelist 按策略遍历 zone（本地 node 优先、fallback 等）。

1.3 水位线（Watermark）

每个 zone 维护 min / low / high 三档空闲页阈值：

1.4 GFP 与迁移类型

gfp_t 指定分配上下文：是否可睡眠、是否 IO/FS、是否 DMA32、是否 可迁移（MIGRATE_MOVABLE） 等。

迁移类型（migratetype） 将空闲页分类（不可迁移、可迁移、可回收、CMA 等），避免不可移动内核数据阻塞 compaction。

1.5 Per-CPU 页缓存（PCP）

为降低 zone->lock 竞争，每个 CPU 有 per-cpu pageset：小 order 分配优先从本地列表取，批量 refill/drain。

二、实现方式

2.1 总入口：__alloc_pages()

1
2
3
4
5
6
7
8
9
10
11
12
13

struct page *__alloc_pages(gfp_t gfp, unsigned int order, int preferred_nid,
							nodemask_t *nodemask)
{
	// ...
	prepare_alloc_pages(...);
	page = get_page_from_freelist(alloc_gfp, order, alloc_flags, &ac);
	if (likely(page))
		goto out;
	page = __alloc_pages_slowpath(alloc_gfp, order, &ac);
out:
	// memcg charge, trace, kmsan ...
	return page;
}

快路径：get_page_from_freelist() 在水位允许时从 zonelist 取页。
慢路径：__alloc_pages_slowpath() → direct reclaim、try_to_compact_pages、再次尝试 freelist，最后 __alloc_pages_may_oom()。

2.2 prepare_alloc_pages

构建 struct alloc_context：

• 解析 preferred nid、nodemask（NUMA/cpuset）
• 计算 alloc_flags（ALLOC_WMARK_*、ALLOC_CPUSET 等）
• 选择起始 zoneref

2.3 get_page_from_freelist

对每个候选 zone：

1. 检查 水位 + cpuset + spread 等
2. 调用 rmqueue() 从 buddy 或 PCP 取页
3. prep_new_page() 初始化页状态

失败则尝试下一个 zone 或降低 watermark 等级（ALLOC_NO_WATERMARKS 仅特殊 GFP）。

2.4 rmqueue 与伙伴合并

• __rmqueue_smallest：从最小满足 order 的 free_area 取
• expand()：分裂大块
• __free_one_page() / free_pages()：释放时 buddy = pfn ^ (1 << order) 尝试合并

2.5 慢路径概要

1
2
3
4
5

__alloc_pages_slowpath
  ├─ wake_all_kswapds()
  ├─ __perform_reclaim()      // direct reclaim
  ├─ try_to_compact_pages()   // 需要连续物理页时
  └─ __alloc_pages_may_oom()

2.6 初始化

2.7 vmstat.c

维护 NR_FREE_PAGES、NR_ALLOC_BATCH、per-zone LRU 统计等，供 /proc/vmstat、/proc/zoneinfo 与回收逻辑读取。

三、关键数据结构与接口

order 上限：MAX_ORDER（通常 11，即 4MB 块，与配置相关）。

四、RK3588 平台说明

• 编解码/显示驱动大块 DMA 常需 高 order 或 CMA；buddy 高 order 失败时依赖 compaction（见 07 文档）。
• __GFP_DMA32：限制从 DMA32 zone 分配，避免 32 位设备无法访问高物理地址。
• CMA 页：带 PageCMA，普通 __alloc_pages 在无 CMA 标志时不应长期占用 CMA 池（由 migratetype 与 gfp 约束）。

五、调试与观测

tracepoint：trace_mm_page_alloc。

附录：源码索引

net 网络子系统机制与原理详解

1. 在内核中的位置

rk3588/kernel-6.1/net/（约 1887 文件）实现 Linux 内核网络协议栈：从 socket(2) 系统调用到 链路层以太类型处理，涵盖 IPv4/IPv6、TCP/UDP、路由、邻居、Netfilter、tc、BPF、无线 cfg80211 等。

不包含 具体网卡/MAC/PHY 寄存器驱动——它们在 drivers/net/，通过 struct net_device、netdev_ops、napi_poll 与 net/ 协作。

2. 顶层 Makefile 逻辑

1
2
3
4
5
6

obj-y := devres.o socket.o core/
obj-y += ethernet/ 802/ sched/ netlink/ bpf/ ethtool/
obj-$(CONFIG_INET)     += ipv4/
obj-y                  += ipv6/
obj-$(CONFIG_NETFILTER) += netfilter/
obj-$(CONFIG_RFKILL)   += rfkill/

3. 核心对象（跨子系统）

4. 配置入口

net/Kconfig 在顶层 Networking support (CONFIG_NET) 下 source 各子目录 Kconfig；CONFIG_INET 打开 TCP/IP；CONFIG_IPV6 控制 IPv6 特性子集。

5. 与 RK3588 的关系（摘要）

详见 08-RK3588平台关联与使用场景详解.md。

6. 文档体系说明

本仓库 linuxDoc/net/ 含两套互补文档：

1. 编号 01–08（本系列）：按 原理 + 实现 纵向剖面（core → L3 → filter → tc/BPF → L2/无线 → 驱动边界 → RK）。
2. *rk3588-kernel-6.1-net-分析_zh.md：按 子目录横向 逐模块说明（70+ 篇）。

建议先读本文与 源码目录与模块索引.md，再按需打开子目录专文。

net 文档索引（RK3588 树）

Linux 6.1（RK3588）内核 net/ 网络协议栈源码分析与原理说明。

源码路径：rk3588/kernel-6.1/net/（约 1887 文件）。

编号专题（原理 + 实现，推荐阅读顺序）

速查：netfilter

速查：Netlink

速查：NAPI

子目录横向专文（按模块）

以太网 MAC/PHY 设备驱动 在 drivers/net/（如 drivers/net/ethernet/stmicro/、drivers/net/phy/ 及厂商扩展）；net/ 主要负责协议栈与 struct net_device/sk_buff 框架逻辑。

net 源码目录与模块索引

源码根：rk3588/kernel-6.1/net/（约 1887 文件，70+ 顶层子目录）

1. 按文件量排序（Top 25）

2. 根目录关键文件

3. core/ 对象清单（Makefile）

4. Rockchip 相关（net/ 内）

5. 与 drivers/net 分界

数据路径：tcp_sendmsg → IP 层 → dev_queue_xmit → 驱动 ndo_start_xmit。

6. 子目录 → 既有专文（linuxDoc/net）

每个子目录大多已有 rk3588-kernel-6.1-net-<name>分析_zh.md，见 README.md 完整表。

7. 快速定位

ALSA Core 与 PCM 设备机制与实现详解

源码路径：rk3588/kernel-6.1/sound/core/
文档目录：linuxDoc/sound/

目录

• 一、原理
• 二、字符设备复用 sound.c
• 三、声卡与 PCM
• 四、控制与 proc
• 五、RK3588
• 附录

一、原理

ALSA（Advanced Linux Sound Architecture） 在内核提供：

• 统一 主设备号（通常 116）+ 次设备号 区分 control/pcm/timer
• PCM 抽象：playback/capture、周期、格式、速率
• Control：音量、开关、路由（mixer 元素）

ASoC 声卡最终也注册为 ALSA struct snd_card，对用户态 API 一致。

二、字符设备复用 sound.c

core/sound.c（含中文综述注释）：

1. 用户 open("/dev/snd/pcmC0D0p") → snd_open
2. 按 minor 查 snd_minors[]
3. replace_fops 为真实驱动（pcm/control）
4. 调用具体 ->open

驱动通过 snd_register_device() 登记，关联 struct device 与 sysfs。

三、声卡与 PCM

关键结构：

• struct snd_card：逻辑声卡（索引 0、1…）
• struct snd_pcm：逻辑 PCM 设备（device 号）
• struct snd_pcm_substream：播放或采集流
• struct snd_pcm_runtime：buffer、period、状态机

硬件参数在 hw_params 与 sw_params 中协商（格式 S16_LE、采样率、通道）。

四、控制与 proc

• /dev/snd/controlC0：mixer 与控制项
• /proc/asound/cards、pcmC0D0p：调试信息

五、RK3588

嵌入式通常 card0 为 ASoC 注册声卡；HDMI 与 ES8388 可能为 同一 card 多 PCM 或 多 card，由 DT 与 machine 驱动决定。

用户态：aplay -l、amixer contents。

附录

下一篇：02 ASoC

ASoC 框架与 DAPM 机制与实现详解

源码路径：rk3588/kernel-6.1/sound/soc/soc-*.c
文档目录：linuxDoc/sound/

目录

• 一、原理
• 二、核心对象
• 三、核心文件
• 四、DAPM
• 五、DMA PCM
• 附录

一、原理

ASoC（ALSA System on Chip） 将声卡拆为三类驱动：

避免把板级细节写进每个 DAI 驱动，便于 IP 复用。

二、核心对象

• snd_soc_component：绑定 platform_device 或 i2c_client，含 DAI 与 DAPM
• snd_soc_dai：数字音频接口实例（playback、capture 能力）
• snd_soc_pcm_runtime：一条 link 的运行时（rtd）

注册入口：devm_snd_soc_register_card() / snd_soc_register_card()。

三、核心文件

设备树：常用 of_graph 解析 sound-dai 端点；也支持 snd_soc_of_parse_card_name。

四、DAPM

soc-dapm.c — Dynamic Audio Power Management：

作用：降低空闲功耗、减轻 pop 声（pmdown_time 默认 5000ms 延迟下电）。

Machine/codec 驱动通过 snd_soc_dapm_route 数组定义耳机、扬声器等路径。

五、DMA PCM

soc-generic-dmaengine-pcm.c：

• 使用 dmaengine API 在内存与 I2S FIFO 间传输
• dma_chan、period_bytes、buffer_bytes 由 DT 或驱动指定

Rockchip I2S/TDM、PDM、SPDIF 驱动通常调用 devm_snd_dmaengine_pcm_register() 注册通用 DMAengine PCM；DAI 提供 FIFO 地址、bus width、maxburst 等 DMA data。

附录

相关：03 RK DAI

Rockchip DAI 控制器机制与实现详解

源码路径：rk3588/kernel-6.1/sound/soc/rockchip/
文档目录：linuxDoc/sound/

目录

• 一、原理
• 二、I2S/TDM
• 三、PDM 与 SAI
• 四、SPDIF
• 五、公共与工具
• 附录

一、原理

本源码树为 Rockchip 多代 SoC 提供 I2S/TDM、PDM、SAI、SPDIF 等驱动；其中 RK3588 DTS/匹配表明确使用 I2S/TDM、PDM、SPDIF、SPDIFRX（以后者的 rk3308-spdifrx fallback 匹配）。rockchip_sai.c 只有通用 rockchip,sai-v1 匹配，不能仅凭源码存在认定 RK3588 集成或启用 SAI。驱动作为 ASoC CPU DAI component：

• 解析 设备树（clocks、dma-names、TDM slot）
• 实现 snd_soc_dai_ops：hw_params、set_fmt、trigger
• 通过 DMAengine 与 PCM 环缓冲交互

compatible 区分 SoC 代际（如 rockchip,rk3588-i2s-tdm）。

二、I2S/TDM

rockchip_i2s_tdm.c / rockchip_i2s_tdm.h（主路径，~2700+ 行）：

连接外置 Codec（I2C 控制）或 HDMI IP 的 I2S 输入。

旧版 rockchip_i2s.c：早期 RK 芯片，3588 以 TDM 为主。

三、PDM 与 SAI

适用于 麦克风阵列、语音前端；常与 VAD、DLP 配合。

四、SPDIF

• rockchip_spdif.c：S/PDIF 输出（rk3588-spdif）
• rockchip_spdifrx.c：S/PDIF 输入

用于光纤/同轴数字音频，消费类 RK 板较少。

五、公共与工具

时钟：依赖 HAVE_CLK，从 CRU/CCU 获取 MCLK/BCLK/LRCK。

附录

下一篇：04 Machine/HDMI

Rockchip 机器驱动与 HDMI 机制与实现详解

源码路径：rk3588/kernel-6.1/sound/soc/rockchip/（machine）、soc/codecs/rk_codec_digital.c
文档目录：linuxDoc/sound/

目录

• 一、Machine 驱动角色
• 二、multicodecs
• 三、HDMI 音频
• 四、VAD ASRC DLP
• 五、片上数字 Codec
• 附录

一、Machine 驱动角色

Machine（平台驱动）填充 struct snd_soc_card：

• dai_link[]：CPU DAI ↔ Codec DAI 连接、格式 DAIFMT
• dapm_routes：耳机/喇叭/麦克风路径
• GPIO：功放使能、耳机检测
• 可选：jack、extcon、ADC 按键

RK 板级常由 设备树 sound 节点 + 驱动 probe 解析子节点完成。

二、multicodecs

rockchip_multicodecs.c（DRV_NAME "rk-multicodecs"）：

适用于 RK3308 等 多 Codec 音箱方案；RK3588 产品可复用或参考 DT 写法。

三、HDMI 音频

rockchip_hdmi.c（rk-hdmi-sound）：

• 链接 CPU I2S → hdmi-codec（SND_SOC_HDMI_CODEC）
• 与 DRM HDMI 驱动配合，音频随显示输出
• 可选 HDMI jack 检测热插拔

本树 RK3588 活跃路径是 rockchip_hdmi.c + soc/codecs/hdmi-codec.c + DRM codec callbacks。rockchip_hdmi_dp.c、rockchip_cdndp.c 虽保留在源码目录中，但没有加入 sound/soc/rockchip/Makefile，属于不可直接使用的遗留文件。

RK3588 常见板级映射：

• HDMI0/1：I2S5/I2S6，常用 mclk-fs = <128>；
• DP0/1：SPDIF TX2/TX5，常用 mclk-fs = <512>；
• HDMI-IN：HDMI RX → I2S7 capture。

编解码盒 HDMI 输出带音频 时，用户态播放到 card 的 HDMI PCM 即可。

四、VAD ASRC DLP

VAD 含 ARM64 预处理汇编（vad_preprocess_arm64.S）。

五、片上数字 Codec

soc/codecs/rk_codec_digital.c：

• rockchip,rk3588-codec-digital
• 通过 GRF 寄存器（如 RK3588_GRF_SOC_CON6）做 SOC 侧数字音频开关配置
• 非 完整模拟 Codec，常与 HDMI/内置路径配合

附录

RK3588 新品以 DT + i2s_tdm + hdmi/multicodecs 为主，不局限上述遗留模块。

相关：06 RK3588 拓扑

Codec 与其它音频路径机制与实现详解

源码路径：rk3588/kernel-6.1/sound/soc/codecs/、sound/usb/、sound/hda/
文档目录：linuxDoc/sound/

目录

• 一、Codec 层
• 二、RK 相关 Codec
• 三、USB 音频
• 四、HDA 与其它
• 五、RK3588
• 附录

一、Codec 层

sound/soc/codecs/ 实现 hundreds of Codec/I2C 设备 的 ASoC 驱动：

每个驱动提供 snd_soc_component_driver + snd_soc_dai_driver，与 CPU DAI 格式协商（set_fmt、时钟主从）。

二、RK 相关 Codec

实际 RK3588 板卡常见：ES8388 / ES8311 等（具体以 BSP DTS 为准，可能在 codecs 目录有对应 .c）。

三、USB 音频

sound/usb/（~100+ 文件）：

• USB Audio Class 1/2
• card.c、pcm.c、mixer.c 标准 UAC 流程
• 大量 quirks（quirks.c）修正厂商设备

RK3588 作 USB Host 时可接 USB 声卡；OTG 声卡模式 另涉 gadget 栈（不在 sound/usb 主机路径）。

四、HDA 与其它

五、RK3588

• 产品音频 主力：内置 I2S + 外置 Codec + HDMI
• USB 麦克风/声卡：走 usb-audio 模块，与 ASoC 并存第二套 card
• 编解码器 VPU 处理视频轨音频常 不重采样经 ALSA（容器内 FFmpeg），但 HDMI 输出 仍可能用本栈

附录

调试外置 Codec：i2cdetect、检查 sound-dai graph、dmesg | grep asoc。

相关：03 DAI