Power Performance

Zephyr Power & Performance

Maximize the efficiency of your embedded system by balancing power consumption and computational performance.

Core Workflows

1. Power Management (PM)

Implement system-level and peripheral-specific power saving strategies.

• Reference: [powermanagement.md](references/powermanagement.md)
• Key Tools: pm_device_action_run, pm_state_set, Residency hooks.

2. Performance Tuning

Optimize critical code paths and monitor system resources.

• Reference: [performancetuning.md](references/performancetuning.md)
• Key Tools: CONFIG_THREAD_ANALYZER, Linker Map, Code relocation.

3. Memory Optimization

Relocate code and data to utilize the fastest memory available.

• Reference: [performancetuning.md](references/performancetuning.md#code--data-relocation)
• Key Tools: __ramfunc, Relocation scripts.

Quick Start (Device Suspend)

#include 

const struct device *spi0 = DEVICE_DT_GET(DT_NODELABEL(spi0));

void sleep_spi(void) {
    pm_device_action_run(spi0, PM_DEVICE_ACTION_SUSPEND);
}

Professional Patterns (Optimization)

• Aggressive Suspend: Transition peripherals to low-power states as soon as their transaction is complete.
• ITCM/DTCM: Use Tightly Coupled Memory for time-critical control loops to avoid Flash latency.
• Runtime Monitoring: Always enable the thread analyzer during development to find the "RAM floor" for your application.
• Coordinated Sleep: To coordinate sleep across modules, see [kernel-services](../kernel-services/SKILL.md) for Zbus-based event-driven power management.

Automation Tools

• [powerbudgetestimator.py](scripts/powerbudgetestimator.py): Estimate average current and battery life from duty-cycle state data.

Examples & Templates

• [powerbudgettemplate.csv](assets/powerbudgettemplate.csv): Starter power-state budget sheet for battery-life estimation.

Validation Checklist

• [ ] Target peripherals enter and exit suspend/resume states without functional regressions.
• [ ] Measured idle and active power align with expected optimization deltas.
• [ ] Thread analyzer and map data confirm stack/RAM budgets are within limits.
• [ ] Relocated time-critical functions execute from intended memory region.

Resources

• [References](references/):
• power_management.md: System states, device PM, and hooks.
• performance_tuning.md: Optimization strategies and relocation.
• [Scripts](scripts/):
• power_budget_estimator.py: Duty-cycle based battery-life estimator.
• [Assets](assets/):
• power_budget_template.csv: Initial state/current budget template.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: beriberikix
• Source: beriberikix/zephyr-agent-skills
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.