jpawlowski/hass.tibber_prices
1
0
Fork 0
mirror of https://github.com/jpawlowski/hass.tibber_prices.git synced 2026-03-30 13:23:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
hass.tibber_prices/docs/user/docs/concepts.md
Julian Pawlowski d73eda4b2f git commit -m "feat(docs): add dual Docusaurus sites with custom branding and Giscus integration 
- Split documentation into separate User and Developer sites
- Migrated existing docs to proper Docusaurus structure
- Added custom Tibber-themed header logos (light + dark mode variants)
- Implemented custom color scheme matching integration branding
  - Hero gradient: Cyan → Dark Cyan → Gold
  - Removed standard Docusaurus purple/green theme
- Integrated Giscus comments system for community collaboration
  - User docs: Comments enabled on guides, examples, FAQ
  - User docs: Comments disabled on reference pages (glossary, sensors, troubleshooting)
  - Developer docs: No comments (GitHub Issues/PRs preferred)
- Added categorized sidebars with emoji navigation
- Created 8 new placeholder documentation pages
- Fixed image paths for baseUrl compatibility (local + GitHub Pages)
- Escaped MDX special characters in performance metrics
- Added GitHub Actions workflow for automated deployment
- Created helper scripts: dev-user, dev-developer, build-all

Breaking changes:
- Moved /docs/user/*.md to /docs/user/docs/*.md
- Moved /docs/development/*.md to /docs/developer/docs/*.md
2025-12-06 01:37:06 +00:00

2.2 KiB
Raw Blame History

Core Concepts

Understanding the fundamental concepts behind the Tibber Prices integration.

Price Intervals

The integration works with quarter-hourly intervals (15 minutes):

  • Each interval has a start time (e.g., 14:00, 14:15, 14:30, 14:45)
  • Prices are fixed for the entire interval
  • Synchronized with Tibber's smart meter readings

Price Ratings

Prices are automatically classified into rating levels:

  • VERY_CHEAP - Exceptionally low prices (great for energy-intensive tasks)
  • CHEAP - Below average prices (good for flexible loads)
  • NORMAL - Around average prices (regular consumption)
  • EXPENSIVE - Above average prices (reduce consumption if possible)
  • VERY_EXPENSIVE - Exceptionally high prices (avoid heavy loads)

Rating is based on statistical analysis comparing current price to:

  • Daily average
  • Trailing 24-hour average
  • User-configured thresholds

Price Periods

Best Price Periods and Peak Price Periods are automatically detected time windows:

  • Best Price Period - Consecutive intervals with favorable prices (for scheduling energy-heavy tasks)
  • Peak Price Period - Time windows with highest prices (to avoid or shift consumption)

Periods can:

  • Span multiple hours
  • Cross midnight boundaries
  • Adapt based on your configuration (flex, min_distance, rating levels)

See Period Calculation for detailed configuration.

Statistical Analysis

The integration enriches every interval with context:

  • Trailing 24h Average - Average price over the last 24 hours
  • Leading 24h Average - Average price over the next 24 hours
  • Price Difference - How much current price deviates from average (in %)
  • Volatility - Price stability indicator (LOW, MEDIUM, HIGH)

This helps you understand if current prices are exceptional or typical.

Multi-Home Support

You can add multiple Tibber homes to track prices for:

  • Different locations
  • Different electricity contracts
  • Comparison between regions

Each home gets its own set of sensors with unique entity IDs.

💡 Next Steps: