scenario
Manage FPGA power estimation scenarios: adjust environment, clock frequency, toggle rate, resource utilization, recalculate power, and compare snapshots.
Instructions
统一的场景管理入口——通过 action 参数选择操作。
Actions:
"set_environment"— 设置环境参数（温度、风流量、散热器）。 需要temp，可选airflow（默认 250）、heatsink（默认 medium）。"set_clock_frequency"— 修改某个时钟的频率。 需要name、freq_mhz。"set_toggle_rate"— 修改某个 Block 的信号翻转率。 需要block、pct（0–100）。"set_resource_util"— 修改某个 Block 的资源用量（绝对数量）。 需要block，可选lut/ff/bram/dsp（-1 表示不修改对应项）。填入实际使用的资源数， 如lut=50000表示已用 50000 个 LUT。"recalculate"— 参数修改后重新计算功耗。"compare"— 对比最近两次功耗快照（依赖 power(action="summary") 保存的快照），10% 差异标记 WARN。
Args: action: 操作类型（见上）。 session_id: 目标会话 ID。 temp: 环境温度 (°C)（set_environment）。 airflow: 风流量 LFM（set_environment，默认 250）。 heatsink: 散热器类型 none/small/medium/large（set_environment，默认 medium）。 name: 时钟名称（set_clock_frequency）。 freq_mhz: 新频率 MHz（set_clock_frequency）。 block: Block 名称（set_toggle_rate / set_resource_util）。 pct: 翻转率百分比 0–100（set_toggle_rate）。 lut: 已用 LUT 数量（set_resource_util, -1 跳过）。 ff: 已用 FF 数量（set_resource_util, -1 跳过）。 bram: 已用 BRAM Tile 数量（set_resource_util, -1 跳过）。 dsp: 已用 DSP Slice 数量（set_resource_util, -1 跳过）。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ff | No | ||
| dsp | No | ||
| lut | No | ||
| pct | No | ||
| bram | No | ||
| name | No | ||
| temp | No | ||
| block | No | ||
| action | Yes | ||
| airflow | No | ||
| freq_mhz | No | ||
| heatsink | No | ||
| session_id | No | default |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |