4、CPF文件结构：CPF文件的语法、层次结构、命令分类及基本编写规则
CPF（Common Power Format）作为一种面向低功耗设计意图描述的标准格式，其文件结构直接决定了功耗意图能否被准确、完整地传递给后端实现与验证工具。理解CPF文件的语法规则、层次化组织方式以及命令分类，是每一位从事低功耗芯片设计的工程师必须掌握的基础技能。本章将系统拆解CPF文件的物理结构、逻辑层次、核心命令族以及编写时的关键约束，帮助读者建立起对CPF文件从“看到”到“读懂”再到“会写”的完整认知。
4.1 CPF文件的物理结构与语法基础
核心原理：CPF文件本质上是一个基于文本的、遵循特定语法规则的描述性文件。它采用类似Tcl的语法风格，每条命令以分号（;）结尾，命令由命令名、参数和选项组成。CPF文件通常以.cpf为扩展名，在逻辑综合阶段由前端工程师创建，在物理实现和验证阶段被后端工具读取。CPF文件的核心价值在于将功耗意图（如电源域划分、电压设置、关断策略）从RTL代码中分离出来，形成独立的、可复用的约束文件。
语法构成要素：一条完整的CPF命令由以下部分组成：
- 命令名：如
create_power_domain、create_supply_net，是命令的唯一标识。 - 参数：命令所操作的对象名称，如
PD_TOP、VDD_TOP。 - 选项：以
-开头的键值对，用于指定命令的附加属性，如-primary_power_net、-update。 - 分号：每条命令的结束符，不可省略。
// 典型CPF命令语法示例
create_power_domain PD_TOP -primary_power_net VDD_TOP -primary_ground_net VSS_TOP;
create_supply_net VDD_TOP -domain PD_TOP -reconnect -voltage 1.0;
create_power_mode PM_NORMAL -domain_power_states {PD_TOP {ON}};文件组织方式：CPF文件支持include机制，允许将不同模块的功耗约束分散在多个子文件中，再通过include命令在顶层文件中统一引用。这种模块化的组织方式便于团队协作和版本管理。同时，CPF文件支持注释，以//或#开头的内容被视为注释，不参与解析。
4.2 CPF的层次结构：从顶层到叶节点的设计视图
核心原理：CPF的层次结构反映了芯片设计的物理与逻辑层次。一个完整的CPF文件从顶层模块开始，逐级向下定义各个子模块的电源域、电源网络和模式。这种层次化定义方式与RTL的模块层次一一对应，使得功耗约束能够精确地绑定到设计中的每一个实例。
层次结构的关键要素：
| 层次级别 | 典型命令 | 作用范围 | 示例 |
|---|---|---|---|
| 顶层设计 | set_design |
整个芯片 | set_design top -top |
| 电源域 | create_power_domain |
模块或实例集合 | create_power_domain PD_CORE -instances {u_core} |
| 电源网络 | create_supply_net |
域内或跨域 | create_supply_net VDD_CORE -domain PD_CORE |
| 电源端口 | create_supply_port |
模块边界 | create_supply_port VDD_CORE_PORT -domain PD_CORE |
| 模式与状态 | create_power_mode |
全局或域级 | create_power_mode PM_SLEEP -domain_power_states {PD_CORE {OFF}} |
层次化定义的操作流程：
- 声明顶层设计：使用
set_design命令指定当前CPF文件所约束的顶层模块名称。 - 创建电源域：在顶层设计下，根据功能模块划分创建电源域，并指定每个域包含的实例或模块。
- 定义电源网络：为每个电源域创建对应的电源网络和地网络，并指定电压值。
- 建立连接关系：通过
connect_supply_net命令将电源网络连接到电源端口或实例的电源引脚。 - 定义工作模式：创建不同的电源模式，并指定每个模式下各电源域的状态（ON/OFF/RETENTION）。
set_design soc_top -top;
create_power_domain PD_CPU -instances {u_cpu};
create_power_domain PD_GPU -instances {u_gpu};
create_power_domain PD_IO -instances {u_io};
create_power_domain PD_SRAM -instances {u_sram};
create_supply_net VDD_CPU -domain PD_CPU -voltage 0.8;
create_supply_net VDD_GPU -domain PD_GPU -voltage 0.9;
create_supply_net VDD_IO -domain PD_IO -voltage 1.8;
create_supply_net VDD_SRAM -domain PD_SRAM -voltage 0.8;4.3 CPF命令分类详解
核心原理：CPF命令按照功能可以划分为五大类：设计对象命令、电源域命令、电源网络命令、模式与状态命令、以及辅助命令。理解命令分类有助于工程师快速定位所需功能，并避免命令混用导致的错误。
命令分类总览：
| 命令类别 | 代表命令 | 功能描述 | 使用频率 |
|---|---|---|---|
| 设计对象命令 | set_design, set_current_design |
指定当前设计对象，建立CPF与网表的关联 | 高 |
| 电源域命令 | create_power_domain, update_power_domain |
创建或修改电源域，定义域的边界和属性 | 高 |
| 电源网络命令 | create_supply_net, create_supply_port, connect_supply_net |
定义电源/地网络、端口及其连接关系 | 高 |
| 模式与状态命令 | create_power_mode, create_power_state, define_power_state_group |
定义工作模式和各域的状态组合 | 中 |
| 辅助命令 | include, report_power_domain, check_power_domain |
文件包含、信息查询、一致性检查 | 中 |
核心命令的深入解析：
create_power_domain是CPF中最核心的命令，它定义了一个电源域的基本属性。关键选项包括：
-instances：指定该域包含的实例列表，可以是单个实例或实例集合。-primary_power_net：指定该域的主电源网络。-primary_ground_net：指定该域的主地网络。-update：用于修改已存在的电源域定义。
create_power_mode命令用于定义芯片的工作模式，其核心参数是-domain_power_states，该参数以列表形式指定每个电源域在该模式下的状态。例如：
create_power_mode PM_ACTIVE -domain_power_states {PD_CPU {ON} PD_GPU {ON} PD_IO {ON} PD_SRAM {ON}};
create_power_mode PM_SLEEP -domain_power_states {PD_CPU {OFF} PD_GPU {OFF} PD_IO {ON} PD_SRAM {RETENTION}};create_power_state和create_power_mode。前者定义的是单个电源域的状态（如ON、OFF、RETENTION），后者定义的是整个芯片在某个工作场景下所有电源域状态的组合。一个模式可以引用多个电源状态，但一个电源状态本身不构成完整的模式。
4.4 CPF基本编写规则与实战要点
核心原理：CPF文件的编写遵循“先定义后引用”的原则，即在使用某个对象之前，必须先通过相应的命令创建该对象。同时，CPF对名称的解析是大小写敏感的，且名称在全局范围内必须唯一。违反这些规则将导致CPF解析错误或工具行为异常。
基本编写规则清单：
- 命令顺序：必须先创建电源域，再创建该域下的电源网络；必须先创建电源网络，才能建立连接关系。
- 名称唯一性：电源域名称、电源网络名称、模式名称在全局范围内不能重复。
- 大小写敏感：
VDD_TOP和vdd_top被视为不同的名称。 - 分号结束：每条命令必须以分号结尾，否则解析器会报错。
- 引号使用：当参数值包含空格或特殊字符时，必须使用双引号或花括号括起来。
- 注释规范：使用
//进行单行注释，使用/* ... */进行多行注释。
实战场景：在一个多电压域的低功耗MCU设计中，我们需要编写CPF文件来描述两个电源域（VDD_CORE和VDD_IO）以及三种工作模式（正常、休眠、深度睡眠）。以下是完整的编写流程：
// 1. 声明顶层设计
set_design mcu_top -top;
// 2. 创建电源域
create_power_domain PD_CORE -instances {u_core} -primary_power_net VDD_CORE -primary_ground_net VSS;
create_power_domain PD_IO -instances {u_io} -primary_power_net VDD_IO -primary_ground_net VSS;
// 3. 创建电源网络
create_supply_net VDD_CORE -domain PD_CORE -voltage 0.8;
create_supply_net VDD_IO -domain PD_IO -voltage 1.8;
create_supply_net VSS -domain {PD_CORE PD_IO} -ground;
// 4. 创建电源端口
create_supply_port VDD_CORE_PORT -domain PD_CORE -direction in;
create_supply_port VDD_IO_PORT -domain PD_IO -direction in;
// 5. 连接电源网络
connect_supply_net VDD_CORE -ports VDD_CORE_PORT;
connect_supply_net VDD_IO -ports VDD_IO_PORT;
// 6. 定义电源状态
create_power_state PS_CORE_ON -domain PD_CORE -status on;
create_power_state PS_CORE_OFF -domain PD_CORE -status off;
create_power_state PS_IO_ON -domain PD_IO -status on;
create_power_state PS_IO_OFF -domain PD_IO -status off;
// 7. 定义工作模式
create_power_mode PM_NORMAL -domain_power_states {PD_CORE {PS_CORE_ON} PD_IO {PS_IO_ON}};
create_power_mode PM_SLEEP -domain_power_states {PD_CORE {PS_CORE_OFF} PD_IO {PS_IO_ON}};
create_power_mode PM_DEEPSLEEP -domain_power_states {PD_CORE {PS_CORE_OFF} PD_IO {PS_IO_OFF}};结果与复盘：上述CPF文件完整描述了MCU的功耗架构。在物理实现阶段，后端工具能够根据这些约束自动插入电源开关单元、电平转换器和隔离单元。通过report_power_domain命令可以验证每个域的电源网络连接是否正确，通过check_power_domain命令可以检查是否存在未连接的电源引脚或未定义的电源状态。
include命令统一管理；第三，在完成CPF编写后，务必运行check_power_domain命令进行一致性检查，确保所有引用都已正确定义。
常见误区与规避策略：
- 误区一：在创建电源域之前就尝试创建该域下的电源网络。规避策略：严格按照“域→网络→连接”的顺序编写。
- 误区二：忽略
-update选项，重复创建同名对象导致冲突。规避策略：在修改已有定义时，使用-update选项。 - 误区三：电源网络电压值设置不一致，导致后端工具报出电压冲突。规避策略：在文件开头统一声明所有电压值，使用常量或变量引用。
- 误区四：忘记定义某个电源域在特定模式下的状态，导致模式定义不完整。规避策略：在定义模式时，逐一检查所有电源域的状态是否都已明确指定。