A specialized tool for calculating and analyzing Phase-Locked Loop (PLL) PI controller parameters within power electronics and renewable energy systems.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pll-designer
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pll-designer using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is PLL Bandwidth Calculator?
The PLL Bandwidth Calculator is a robust utility designed for engineers working on Synchronous Reference Frame Phase-Locked Loops (SRF-PLL). It provides a mathematical framework for both forward design—converting target bandwidth into PI parameters—and reverse analysis, which derives physical performance metrics from existing controller gains. This skill is essential for ensuring system stability in wind power converters, industrial low-voltage grids, and medium-voltage applications.
By leveraging second-order system theory, this skill allows for precise tuning of KPLLp and KPLLi values. It accounts for critical factors such as nominal line voltage (Unom), grid frequency, and optimal damping ratios to provide accurate per-unit (pu) and physical values for control loops.
PLL Bandwidth Calculator Use Cases
- Designing PI controllers for wind power converters using 690V systems.
- Tuning PLL parameters for industrial low-voltage (380V) power electronics.
- Analyzing the closed-loop bandwidth and damping ratio of existing grid-tied inverters.
- Converting between physical PI gains and per-unit (pu) normalized values for embedded firmware.
- Optimizing grid synchronization performance in renewable energy microgrids.
How PLL Bandwidth Calculator Works
- The user provides target performance metrics like bandwidth (f_BW) or existing PI parameters (KPLLp_pu, KPLLi_pu).
- The skill identifies missing critical parameters, such as nominal line voltage (Unom), and prompts the user for input.
- It calculates the Phase Peak Voltage (U_mag) based on the provided line-to-line RMS voltage.
- Using second-order system linear models, it computes the natural frequency (wn) and the bandwidth expansion coefficient (C).
- The tool generates both physical gains and per-unit standardized parameters suitable for implementation in MATLAB or C code.
- A detailed report is provided, including used default values (e.g., f0 = 50Hz, zeta = 0.707) for transparency.
PLL Bandwidth Calculator Setup
To use this tool within your Openclaw Skills environment, ensure you have a MATLAB runner configured if you wish to execute the provided scripts. You can also perform direct calculations through the AI agent interface.
# Clone the repository containing the PLL scripts
git clone https://github.com/openclaw/pll-bandwidth-calc.git
# Navigate to the scripts directory for MATLAB usage
cd pll-bandwidth-calc/scripts
Ensure your environment variables or agent configuration includes the standard grid parameters for your region to streamline the interaction.
PLL Bandwidth Calculator Data Schema & Taxonomy
The skill processes data according to the following parameter taxonomy:
| Parameter | Description | Unit |
|---|---|---|
| Unom | Nominal Line-to-Line RMS Voltage | V |
| f0 | Rated Grid Frequency | Hz |
| zeta | Damping Ratio (Default: 0.707) | Dimensionless |
| f_BW | Closed-loop Bandwidth | Hz |
| KPLLp_pu | Proportional Gain (Per-Unit) | pu |
| KPLLi_pu | Integral Gain (Per-Unit) | pu |
PLL Bandwidth Calculator Advanced Features
- Bi-directional Calculation: Seamlessly switch between design (bandwidth to parameters) and analysis (parameters to bandwidth).
- Automated Per-Unit Conversion: Automatically handles the normalization of gains based on base angular frequency and voltage peaks.
- MATLAB Integration: Includes ready-to-use .m scripts (
get_pll_pi_parameters.mandcalc_pll_bandwidth.m) for simulation workflows. - Interactive Validation: Built-in safeguards prevent calculation errors by mandating voltage and frequency inputs before processing.
SKILL.md
Loading
Related Openclaw Skills
XHS Content Creation Assistant
A comprehensive automation studio for Xiaohongshu creators featuring AI image generation, viral copy templates, and automated draft publishing.
Personalized Newsletter Generator (newsletter-init)
An AI-powered information synthesis skill that automates the search, filtering, and delivery of personalized newsletters and research briefs.
stock-decision
An automated investment assistant for A-share markets that generates real-time trading decisions and position management reports.
LLM Knowledge Bases
A specialized skill for managing structured Markdown wikis through automated source ingestion, knowledge synthesis, and deterministic maintenance.
Meitu DesignKit AI Image & E-commerce Skills
A sophisticated AI-powered toolkit for background removal, image restoration, and automated e-commerce product listing generation.
WeShop CLI Skill
A comprehensive AI-powered multimedia generation and editing suite for professional fashion, product, and cinematic content.
Featured*
