К основному содержанию
скилл CX Codex

power-budget-calculator — скилл для Claude Code: обзор и установка

Скилл power-budget-calculator рассчитывает потребление тока и время работы от батареи для проектов на Arduino, ESP32 и RP2040. Помогает подобрать аккумулятор и настроить режимы сна.

MIT 178 установок ★ 33 обновлён 2026-10-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add wedsamuel1230/embedded-engineering-skills --skill power-budget-calculator -a claude-code
Открыть на GitHub

Что делает power-budget-calculator

Скилл оценивает энергопотребление встраиваемых систем по данным даташитов. Внутри лежат база references/component-database.md и скрипт scripts/calculate_power.py. Скрипт учитывает скважность активных циклов, периоды глубокого сна (deep sleep) и пиковые скачки тока при передаче данных через Wi-Fi, Bluetooth или LoRa.

Расчёт можно вести интерактивно через диалог или запуском скрипта через uv run --no-project scripts/calculate_power.py --interactive. В базе собраны типовые токи для контроллеров ATmega328P, ESP32, ESP32-C3 и RP2040, а также для дисплеев, реле и популярных датчиков вроде BME280 или MPU6050. Для автономных устройств применяется коэффициент полезной ёмкости 0.8.

Для точных консольных вычислений и генерации отчётов в report.md в системе потребуется менеджер uv.

Какие задачи решает

  • Рассчитать средний ток и время автономной работы устройства от аккумулятора
  • Оценить потребление микроконтроллера в режимах deep sleep и active
  • Подобрать ёмкость батареи под заданный рабочий цикл сенсоров и радиомодулей
  • Выявить пиковые скачки тока компонентов перед сборкой схемы

Примеры запросов агенту

  • Посчитай, сколько проживёт ESP32 с датчиком BME280 от аккумулятора 18650 на 2500 мАч при выходе на связь раз в час
  • Какой аккумулятор нужен для Arduino Uno и датчика расстояния, чтобы плата проработала трое суток?
  • Выведи отчёт по энергопотреблению проекта из файла assets/example-project.json

Как установить power-budget-calculator

1Через Skills CLI (Vercel)

npx skills add wedsamuel1230/embedded-engineering-skills --skill power-budget-calculator -a claude-code

2Вручную: положить файлы

~/.claude/skills/power-budget-calculator/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/power-budget-calculator/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о power-budget-calculator

Как установить power-budget-calculator в Claude Code?

Выполните в терминале команду: npx skills add wedsamuel1230/embedded-engineering-skills --skill power-budget-calculator -a claude-code.

Какие микроконтроллеры есть в готовой базе скилла?

В справочнике уже есть параметры для Arduino ATmega328P, ESP32 WROOM-32, ESP32-C3, а также Raspberry Pi RP2040 Pico и Pico W с учётом разных частот и радиомодулей.

Как запускать скрипт расчёта напрямую?

Используйте инструмент uv: выполните uv run --no-project scripts/calculate_power.py --interactive для пошагового ввода или укажите компонент флагом --component.

Исходный текст

SKILL.md · MIT
---
name: power-budget-calculator
description: Calculates total power consumption and battery life for Arduino/ESP32/RP2040 projects. Use when user asks about battery life, power requirements, current draw, or needs to estimate runtime. Includes sleep mode analysis, power optimization tips, and battery sizing recommendations. Run scripts/calculate_power.py for accurate calculations.
metadata: {triggers: "power budget, current draw, battery life, runtime, regulator"}
---

# Power Budget Calculator

Estimates power consumption and battery life for embedded projects.

## Resources

- **scripts/calculate_power.py** - Python calculator with component database, duty cycle support, battery life estimation
- **references/component-database.md** - Comprehensive current draw reference from datasheets  
- **assets/example-project.json** - Sample project configuration

## Quick Start

Run the calculator interactively:
```bash
uv run --no-project scripts/calculate_power.py --interactive
```

Or calculate for a single component:
```bash
uv run --no-project scripts/calculate_power.py --component ESP32 --mode deep_sleep --duty 95
```

Load a project configuration:
```bash
uv run --no-project scripts/calculate_power.py --json assets/example-project.json --output report.md
```

List all components in database:
```bash
uv run --no-project scripts/calculate_power.py --list
```

## When to Use
- "How long will my battery last?"
- "What size battery do I need?"
- "How much current does my project draw?"
- Planning battery-powered projects
- Optimizing for low power

## Workflow

### Step 1: Gather Component List

Ask user for:
1. Microcontroller (model and operating mode)
2. All sensors and modules
3. Displays
4. Actuators (motors, LEDs, relays)
5. Communication (WiFi, Bluetooth, LoRa)
6. Operating profile (always on vs. duty cycle)

### Step 2: Calculate Power Budget

Run `scripts/calculate_power.py --interactive` for guided calculation, or use this template:

```markdown
# Power Budget: [Project Name]

## Operating Conditions
- Supply Voltage: [V]
- Operating Modes: [Active/Sleep cycles]
- Duty Cycle: [X% active, Y% sleep]

## Component Current Draw

### Always-On Components
| Component | Voltage | Current | Power | Notes |
|-----------|---------|---------|-------|-------|
| [name] | [V] | [mA] | [mW] | [conditions] |
| ... | ... | ... | ... | ... |
| **Subtotal** | - | **[mA]** | **[mW]** | - |

### Active Mode Only
| Component | Voltage | Current | Power | Duty % |
|-----------|---------|---------|-------|--------|
| [name] | [V] | [mA] | [mW] | [%] |
| ... | ... | ... | ... | ... |
| **Subtotal** | - | **[mA]** | **[mW]** | - |

### Peak Current Events
| Event | Current | Duration | Frequency |
|-------|---------|----------|-----------|
| [WiFi TX] | [mA] | [ms] | [per hour] |
| ... | ... | ... | ... |

## Power Calculations

### Average Current
```
I_avg = (I_active × t_active + I_sleep × t_sleep) / t_total
I_avg = ([X]mA × [Y]s + [Z]mA × [W]s) / [T]s
I_avg = [result] mA
```

### Battery Life Estimate
```
Capacity: [X] mAh
Efficiency factor: 0.8 (80% usable)
Effective capacity: [X × 0.8] mAh

Runtime = Effective capacity / I_avg
Runtime = [X] mAh / [Y] mA
Runtime = [Z] hours ([days] days)
```

## Recommendations
- [Power optimization suggestions]
- [Battery type recommendation]
- [Sleep mode configuration]
```

## Current Draw Database

### Microcontrollers

#### Arduino (ATmega328P @ 5V)
| Mode | Current | Notes |
|------|---------|-------|
| Active (16MHz) | 15-20mA | No peripherals |
| Idle | 6mA | CPU stopped, peripherals on |
| Power-down | 0.1µA | Only WDT/external interrupt |
| With USB-Serial | +50mA | CH340/FTDI chip always on |

#### ESP32 (WROOM-32)
| Mode | Current | Notes |
|------|---------|-------|
| Active (WiFi TX) | 160-260mA | Peak during transmission |
| Active (WiFi RX) | 95-100mA | Listening |
| Active (no WiFi) | 20-68mA | CPU only |
| Modem-sleep | 20mA | WiFi off, CPU on |
| Light-sleep | 0.8mA | CPU paused |
| Deep-sleep | 10µA | RTC only |
| Hibernation | 5µA | RTC off |

#### ESP32-C3
| Mode | Current | Notes |
|------|---------|-------|
| Active (WiFi TX) | 320mA peak | Brief spikes |
| Active (BLE) | 50-100mA | During advertising |
| Active (no radio) | 25-35mA | CPU at 160MHz |
| Light-sleep | 130µA | Auto wake |
| Deep-sleep | 5µA | RTC on |

#### RP2040 (Pico)
| Mode | Current | Notes |
|------|---------|-------|
| Active (both cores) | 25-50mA | Depends on clock |
| Single core | 15-25mA | One core dormant |
| Dormant | 0.18mA | Wake on GPIO/RTC |
| Sleep | 1.3mA | |

#### RP2040 (Pico W)
| Mode | Current | Notes |
|------|---------|-------|
| WiFi active | 50-150mA | During TX |
| WiFi idle | 30-40mA | Connected, listening |
| WiFi off | 25-50mA | Radio disabled |

### Sensors

| Sensor | Active | Sleep | Notes |
|--------|--------|-------|-------|
| DHT22 | 1.5mA | 50µA | During read |
| BME280 | 0.35mA | 0.1µA | Forced mode |
| BMP280 | 0.27mA | 0.1µA | |
| MPU6050 | 3.8mA | 5µA | All axes |
| DS18B20 | 1.5mA | 1µA | During conversion |
| HC-SR04 | 15mA | 2mA | No true sleep |
| VL53L0X | 19mA | 5µA | During ranging |
| MAX30102 | 600µA | 0.7µA | Low power mode |
| BH1750 | 120µA | 1µA | Power down mode |
| GPS (NEO-6M) | 45mA | 11mA | Backup mode |

### Displays

| Display | Active | Off/Sleep | Notes |
|---------|--------|-----------|-------|
| 16x2 LCD (backlight) | 80-120mA | 1mA | Backlight dominates |
| 16x2 LCD (no backlight) | 1-2mA | 1mA | |
| SSD1306 OLED 128x64 | 8-20mA | 10µA | Depends on content |
| SSD1306 OLED 128x32 | 5-15mA | 10µA | |
| ST7735 TFT | 20-40mA | 20mA | Backlight always on |
| ILI9341 TFT | 50-80mA | 50mA | |
| E-Paper 2.9" | 8mA | 0µA | Only during refresh |

### Communication Modules

| Module | TX Peak | RX/Idle | Sleep | Notes |
|--------|---------|---------|-------|-------|
| ESP8266 (module) | 170mA | 70mA | 20µA | Deep sleep |
| NRF24L01 | 11.3mA | 13.5mA | 0.9µA | |
| HC-05 Bluetooth | 40mA | 8mA | 2mA | |
| RFM95 LoRa | 120mA | 10mA | 0.2µA | |
| SIM800L GSM | 2A peak | 15mA | 1mA | Needs big cap! |

### Actuators

| Component | Current | Notes |
|-----------|---------|-------|
| LED (typical) | 10-20mA | Through resistor |
| RGB LED (each color) | 20mA | Per channel |
| WS2812B NeoPixel | 60mA max | Full white |
| SG90 Servo (idle) | 10mA | No load |
| SG90 Servo (moving) | 200-500mA | Under load |
| MG996R Servo | 500-900mA | Under load |
| Small DC motor | 100-500mA | Varies with load |
| 5V Relay module | 70-100mA | Coil energized |
| Buzzer (passive) | 30mA | |

## Sleep Mode Configurations

### ESP32 Deep Sleep Template
```cpp
#include <esp_sleep.h>

#define uS_TO_S_FACTOR 1000000ULL
#define TIME_TO_SLEEP 60  // seconds

void setup() {
    // Do measurements here
    
    // Configure wake-up source
    esp_sleep_enable_timer_wakeup(TIME_TO_SLEEP * uS_TO_S_FACTOR);
    
    // Enter deep sleep
    esp_deep_sleep_start();
}

void loop() {
    // Never reached
}
```

### Arduino Power-Down Template
```cpp
#include <avr/sleep.h>
#include <avr/wdt.h>

void enterSleep() {
    set_sleep_mode(SLEEP_MODE_PWR_DOWN);
    sleep_enable();
    sleep_mode();  // Sleep here
    sleep_disable();
}

// Wake on watchdog or external interrupt
ISR(WDT_vect) {
    // Wake up
}
```

## Power Optimization Checklist

### Hardware
- [ ] Remove power LED (saves 5-10mA)
- [ ] Remove USB-Serial chip for battery operation
- [ ] Use LDO with low quiescent current (<10µA)
- [ ] Add MOSFET to power-gate high-current peripherals
- [ ] Use pull-downs on unused pins
- [ ] Disable ADC when not reading

### Software
- [ ] Use sleep modes between readings
- [ ] Reduce clock speed if possible
- [ ] Batch data and transmit less frequently
- [ ] Turn off WiFi/BLE when not needed
- [ ] Disable brown-out detector in deep sleep
- [ ] Use interrupts instead of polling

### Design Patterns

**Power Gating:**
```
       VCC
        │
    [P-MOSFET] ← GPIO (LOW = ON)
        │
    [Sensor/Module]
        │
       GND
```

**Duty Cycling Formula:**
```
I_average = (I_active × T_active + I_sleep × T_sleep) / T_total

Example: Sensor reads every 5 minutes
- Active: 50mA for 2 seconds
- Sleep: 10µA for 298 seconds

I_avg = (50mA × 2s + 0.01mA × 298s) / 300s
I_avg = (100 + 2.98) / 300
I_avg = 0.34mA

With 2000mAh battery:
Runtime = 2000mAh × 0.8 / 0.34mA = 4706 hours = 196 days
```

## Battery Reference

### Common Battery Types

| Type | Voltage | Typical Capacity | Notes |
|------|---------|------------------|-------|
| CR2032 | 3V | 220mAh | Very low current only |
| 2x AA Alkaline | 3V | 2500mAh | Good for low power |
| 3x AA Alkaline | 4.5V | 2500mAh | Direct to 5V systems |
| 4x AA Alkaline | 6V | 2500mAh | With LDO to 5V |
| 18650 Li-ion | 3.7V | 2000-3500mAh | Rechargeable, popular |
| LiPo 1S | 3.7V | Various | Flat, light |
| 9V Alkaline | 9V | 500mAh | Poor energy density |

### Voltage Over Discharge

**18650/LiPo Discharge Curve:**
```
Capacity%   Voltage
─────────────────────
100%        4.2V
80%         3.9V
50%         3.7V
20%         3.5V
0%          3.0V (cut-off!)

Never discharge below 3.0V - damages cell!
```

**Alkaline AA Discharge:**
```
Capacity%   Voltage (per cell)
─────────────────────────────
100%        1.5V
50%         1.2V
0%          0.9V

Many devices stop working below 1.1V/cell
```

## Quick Calculator

```
Enter your values:

Always-on current: ______ mA
Active current: ______ mA
Active time: ______ seconds
Sleep current: ______ mA  
Sleep time: ______ seconds
Battery capacity: ______ mAh

Average current = (Active_mA × Active_s + Sleep_mA × Sleep_s) / Total_s
                = (_____ × _____ + _____ × _____) / _____
                = _____ mA

Runtime = Capacity × 0.8 / Average_current
        = _____ × 0.8 / _____
        = _____ hours
        = _____ days
```

## Shared Output Contract

Use [the shared Arduino skill contract](../../docs/arduino-skill-contract.md):
state assumptions, required tools and versions, implementation steps,
tests/evidence by proof stage, known limitations, and recovery/security notes.

© wedsamuel1230 · MIT · wedsamuel1230/embedded-engineering-skills

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
iot-developer daffy0208 Скилл iot-developer помогает писать прошивки для микроконтроллеров, собирать веб-дашборды и настраивать обмен данными датчиков по протоколу MQTT. CX Codex +1 391установок nodrix decoded-cipher MCP-сервер nodrix управляет платами ESP32 и читает телеметрию с вашего Cloudflare-сервера через MCP. Помогает контролировать удалённое железо из чата с ассистентом. CX Codex +1 ★ 48звёзд репо embedded-iot travisjneuman Скилл embedded-iot по встраиваемым системам: паттерны GPIO, I2C и MQTT, задачи FreeRTOS и правила энергосбережения для ESP32, STM32 и Arduino. CX Codex +1 212установок esp32-ai-agent-skill ezrover Плагин esp32-ai-agent-skill для Claude, который подбирает чип ESP32, проверяет назначение GPIO и генерирует код под Arduino и ESP-IDF. ★ 59звёзд репо embedded-iot-mentor Alireza Rezvani embedded-iot-mentor — скилл для Claude Code, который помогает спланировать встроенное или IoT-устройство от выбора платы до способа просмотра показаний. Он подключается к задачам с микроконтроллерами, датчиками и прошивками. CX Codex +1 22установок Schematik schematik-engineering MCP-сервер Schematik для Claude Code ищет электронные компоненты и инструкции по сборке устройств. Агент получает сведения о деталях, распиновке и подключении компонентов. CX Codex +1

Из того же набора19

Весь набор →
arduino-code-generator Скилл arduino-code-generator генерирует код на C++ для плат UNO, ESP32 и RP2040: от опроса датчиков и устранения дребезга кнопок до конечных автоматов и сохранения в EEPROM. CX Codex +1 460установок circuit-debugger Скилл circuit-debugger для Claude Code ведёт по проверкам питания, соединений и сигналов в схемах Arduino, ESP32 и RP2040. Помогает искать причины молчащих датчиков, неподвижных моторов и нагрева компонентов. CX Codex +1 298установок error-message-explainer Скилл error-message-explainer для Claude Code разбирает ошибки компиляции, загрузки, запуска и питания в Arduino-проектах. Объясняет сообщения IDE и платы и связывает их с исправлениями. CX Codex +1 206установок enclosure-designer Скилл enclosure-designer ведёт от «нужен корпус» до модели в OpenSCAD: уточняет замеры, ставит вырезы под разъёмы и подбирает толщину стенки под условия эксплуатации. CX Codex +1 189установок datasheet-interpreter Скилл datasheet-interpreter достаёт из PDF-даташита распиновку, адрес I2C, тайминги и карту регистров — когда нужно быстро подключить модуль, а не писать драйвер. CX Codex +1 173установок bom-generator Скилл bom-generator собирает BOM для проектов на Arduino, ESP32 и RP2040: компоненты, количества, цены, поставщиков и предупреждения о совместимости. CX Codex +1 164установок battery-selector Скилл battery-selector помогает выбрать тип батареи и схему зарядки для проекта на Arduino, ESP32 или RP2040: от химии до расчёта ёмкости. CX Codex +1 163установок arduino-cli-skill Помогает управлять платами, библиотеками и прошивкой через arduino-cli на Windows, macOS и Linux. CX Codex +1 162установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой