bolagnaise/tesla-amber-sync Docker 镜像 - 轩辕镜像

Disclaimer

This is an unofficial integration and is not affiliated with or endorsed by Tesla, Inc. or Amber Electric. Use at your own risk. The developers are not responsible for any damages or issues that may arise from the use of this software.

Screenshots

Features

Core Functionality

• 🔋 Automatic TOU Tariff Sync - Updates Tesla Powerwall with Amber Electric pricing every 5 minutes
• 📊 Real-time Pricing Dashboard - Monitor current and historical electricity prices with live updates
• ⚡ Near Real-Time Energy Monitoring - Energy usage charts update every 30 seconds
• 🌏 Timezone Support - Auto-detects timezone from Amber data for accurate time display across all Australian states

Advanced Features

• ⚡ AEMO Spike Detection - Automatically monitors Australian wholesale electricity prices and switches to spike tariff during extreme price events (configurable threshold). Includes intelligent operation mode switching - automatically saves your current Powerwall mode and switches to autonomous (TOU) mode during spikes, then restores your original mode when prices normalize
• 🌞 Solar Curtailment - Automatically prevents solar export during negative pricing periods (≤0c/kWh). When Amber feed-in prices go negative, the system sets Powerwall export to "never" to avoid paying to export, then restores to "battery_ok" when prices return to positive
• 🛡️ Spike Protection - Prevents Powerwall from charging from grid during Amber price spikes. Overrides buy prices when Amber detects spike status to eliminate arbitrage opportunities
• 📤 Export Price Boost - Artificially increase export prices to trigger Powerwall exports at lower price points. Useful when prices are in the 20-25c range where Tesla's algorithm may not trigger exports
• 🔌 Flow Power + AEMO Support - Full support for Flow Power and other wholesale electricity retailers using direct AEMO NEM pricing with configurable network tariffs
• 🎯 Custom TOU Schedules - Create and manage custom time-of-use schedules for any electricity provider (not just Amber)
• 💾 Saved TOU Profiles - Backup, restore, and manage multiple tariff configurations
• 📈 Demand Charge Tracking - Monitor and track peak demand for electricity plans with capacity-based fees

Technical Features

• 🔐 Teslemetry Integration - Secure Tesla API access via Teslemetry proxy service (no public domain required)
• 🔒 Secure Credential Storage - All API tokens encrypted at rest using Fernet encryption
• ⏱️ Background Scheduler - Automatic syncing every 5 minutes (aligned with Amber's forecast updates)
• 🔄 Smart Tariff Deduplication - Only syncs to Tesla when tariff actually changes, preventing duplicate rate plan entries in Tesla dashboard
• 🐳 Docker Ready - Pre-built multi-architecture (amd64/arm64) images for easy deployment
• 🏠 Home Assistant Integration - Native HACS integration for seamless HA deployment
• 🌏 Australia-Wide Compatibility - Auto-detects timezone from Amber data, works in all Australian states and territories (QLD, NSW, ACT, VIC, SA, TAS, WA, NT)
• 📊 Intelligent Price Averaging - Averages 5-minute Amber intervals into 30-minute Tesla periods for maximum accuracy
• 🎯 Period Alignment - Correctly aligns with Amber's forecast labels (e.g., "18:00 forecast" → Tesla PERIOD_17_30)
• 🔄 Rolling 24-Hour Window - Always provides Tesla with 9-24 hours lookahead for optimal battery management
• 📡 Real-Time WebSocket - Connects to Amber's WebSocket API for instant price updates (with automatic reconnection)

Key Features Explained

AEMO Spike Detection

This option is disabled by default and is primarily intended for use with VPPs that offer AEMO Spike exports (GLOBIRD,AGL,ENGIE) and where Tesla Batteries are not natively supported. Automatically monitors AEMO NEM wholesale electricity prices for your region (NSW1, QLD1, VIC1, SA1, TAS1). When prices exceed your configured threshold (e.g., $300/MWh), the system:

• Saves your current tariff configuration
• Saves your current Powerwall operation mode (self_consumption, autonomous, or backup)
• Automatically switches to autonomous (TOU) mode (required for TOU tariffs to work)
• Uploads a spike tariff with very high sell rates to encourage battery export
• Tesla Powerwall responds by exporting to grid during the spike
• Automatically restores your original operation mode when spike ends
• Restores your normal tariff when prices return to normal

Perfect for maximizing revenue during extreme price events! Works seamlessly regardless of your normal Powerwall mode.

Monitoring Frequency: Checks AEMO prices every 1 minute for responsive spike detection.

Solar Curtailment

Prevents paying to export solar during negative pricing periods common with Amber Electric. The system monitors feed-in prices every minute and:

During Negative Prices (≤0c/kWh):

• Sets Powerwall export rule to "never" to prevent grid export
• Implements Tesla API bug workaround: if already set to "never", toggles to "pv_only" then back to "never" to force the setting to apply
• Protects you from financial penalties during negative price events

During Positive Prices (>0c/kWh):

• Restores export rule to "battery_ok" to allow both solar and battery export
• Enables normal revenue generation from grid export

Configuration:

• Enable/disable in Amber Settings (Flask web interface)
• Enable/disable during Home Assistant integration setup
• Default: Disabled (opt-in feature)

This feature is particularly useful with Amber's wholesale pricing to avoid paying to export your solar during oversupply periods.

Spike Protection (Amber Only)

Prevents your Powerwall from charging from the grid during Amber price spikes. When wholesale prices spike, Tesla may see an arbitrage opportunity and charge from grid - this feature stops that behavior.

The Problem: During price spikes, the Powerwall receives 30-minute averaged forecast prices (~$0.85/kWh) rather than the real-time spike prices ($10-$20/kWh). It doesn't "see" the spike and may decide to charge from grid for later arbitrage.

How It Works: When Amber reports spikeStatus: 'potential' or 'spike' for a period, buy prices are overridden:

override_buy = max(all_sell_prices) + $1.00

This ensures charging from grid is always unprofitable during spikes - eliminating any arbitrage opportunity.

Example:

During a spike event:
  Actual import price: $16.48/kWh
  Actual export price: $14.69/kWh
  Max export in forecast: $21.29/kWh

Without spike protection:
  Tesla sees forecast: ~$0.85/kWh buy
  Powerwall thinks: "Charge now, sell later!"
  Result: Grid charging during $16/kWh spike

With spike protection:
  Override buy: $21.29 + $1.00 = $22.29/kWh
  Powerwall calculates: $22.29 buy - $21.29 sell = $1.00 LOSS
  Result: No grid charging

Key Features:

• Per-period protection - Only affects periods Amber flags as spikes, not your whole day
• Uses Amber's detection - Relies on Amber's spikeStatus field, not arbitrary thresholds
• Works with Export Boost - They complement each other (spike protection = buy prices, export boost = sell prices)

Note for 30-minute billing customers: If you're on 30-minute billing (not 5-minute), spike prices get averaged out in your bill. This feature is most critical for 5-minute billed customers who pay the full spike price.

Configuration:

• Enable/disable in Amber Settings (Flask web interface)
• Enable/disable during Home Assistant integration options flow
• Default: Disabled (opt-in feature)

Export Price Boost

Artificially increases export prices sent to Tesla to trigger Powerwall exports at lower price points. This is useful when Amber export prices are in the 20-25c range where Tesla's algorithm may not trigger exports due to its internal hysteresis.

How It Works: The feature adds a configurable offset to export prices and/or sets a minimum floor price, but only during a specified time window (default 5pm-9pm evening peak).

Configuration Options:

Example Calculation:

With offset=5c, min=20c, and threshold=10c:

Amber export price: 18c/kWh
→ 18 >= 10 (threshold), so boost applies
→ 18 + 5 = 23c (above min, Tesla sees 23c)

Amber export price: 12c/kWh
→ 12 >= 10 (threshold), so boost applies
→ 12 + 5 = 17c (below min, Tesla sees 20c floor)

Amber export price: 5c/kWh
→ 5 < 10 (below threshold), boost skipped
→ Tesla sees 5c (unchanged)

Amber export price: -3c/kWh
→ -3 < 10 (below threshold), boost skipped
→ Tesla sees -3c (unchanged)

Use Cases:

• Force Powerwall to export during evening peak when prices are moderate (20-25c)
• Overcome Tesla's internal decision-making that may not export at certain price points
• Maximize battery revenue during predictable high-demand periods
• Use activation threshold to skip boosting very low or negative prices where exporting doesn't make financial sense

Note: The boosted price is only what Tesla sees for decision-making - you still get paid the actual Amber export rate. This feature tricks the Powerwall into exporting when it otherwise wouldn't.

Configuration:

• Enable/disable in Amber Settings (Flask web interface)
• Enable/disable during Home Assistant integration options flow
• Default: Disabled (opt-in feature)

Force Mode Toggle (Alpha)

An experimental feature that forces the Powerwall to immediately recalculate its behavior after receiving new tariff prices.

The Problem: After Tesla Sync uploads a new tariff, the Powerwall may take several minutes to recognize the price changes and adjust its charging/discharging behavior accordingly.

How It Works: After a successful tariff sync, this feature briefly switches the Powerwall to self-consumption mode, waits 5 seconds, then switches back to Time-Based Control (autonomous mode). This mode toggle forces the Powerwall to immediately recalculate its optimal behavior based on the new prices.

Smart Timing: The toggle only triggers when settled/actual prices are synced (at :35/:60 seconds), not on the initial forecast sync (at :00 seconds). This ensures:

• Only one toggle per 5-minute interval (not two)
• Powerwall recalculates using actual prices, not potentially different forecast prices
• Reduced unnecessary mode switches

Trade-offs:

• May cause a brief interruption (~5 seconds) to battery behavior during the mode switch
• Some users report faster Powerwall response; others see no difference
• Experimental feature - results may vary

Configuration:

• Enable/disable in Amber Settings → Alpha Options (Flask web interface)
• Enable/disable during Home Assistant integration options flow
• Default: Disabled (opt-in feature)

Flow Power + AEMO Wholesale Pricing

Full support for Flow Power and other wholesale electricity retailers that pass through AEMO NEM spot prices.

How It Works: AEMO wholesale prices only include the energy cost - they don't include network (DNSP) charges, environmental fees, or GST. Tesla Sync automatically calculates your total retail price using the aemo_to_tariff library.

Configuration:

1. Select Flow Power as your electricity provider

2. Choose your NEM Region (QLD1, NSW1, VIC1, SA1)

3. Select AEMO NEM Wholesale as the price source

4. Configure your Network Tariff:

   Option A: Automatic (Recommended)

   • Select your Network Distributor (DNSP) from the dropdown:
     • Energex, Ergon, Ausgrid, Endeavour, Essential, SA Power Networks
     • Powercor, CitiPower, AusNet, Jemena, United Energy
     • TasNetworks, Evoenergy
   • Enter your Tariff Code from your electricity bill (e.g., NTC6900, EA025)
   • The system automatically calculates network fees, market charges, and GST

   Option B: Manual Rates

   • Check "Use manual rates instead of automatic lookup"
   • Enter your rates manually:
     • Flat Rate: Single rate all day (e.g., 8c/kWh)
     • Time of Use: Peak/Shoulder/Off-Peak rates with time windows
     • Other Fees: Environmental levies, market charges (~3-4c/kWh typical)
     • GST: Automatically adds 10%

Finding Your Tariff Code: Look on your electricity bill for the network tariff code. Common examples:

Flow Power Happy Hour: Export rates during Happy Hour (5:30pm - 7:30pm daily):

• NSW, QLD, SA: 45c/kWh
• VIC: 35c/kWh
• Outside Happy Hour: 0c/kWh

Total Price Calculation (Automatic): The aemo_to_tariff library handles all calculations:

Total = AEMO Wholesale + Network Charges + Market Fees + Environmental Levies + GST

Note: When using manual rates, enter all values in cents/kWh. If your tariff shows $0.***/kWh, enter 19.367.

Custom TOU Schedules

Not using Amber Electric? No problem! Create custom time-of-use schedules for any Australian electricity provider:

• Define multiple seasonal periods (e.g., Summer, Winter)
• Set different rates for peak, shoulder, and off-peak periods
• Configure weekday/weekend variations
• Upload directly to Tesla Powerwall via Teslemetry

Saved TOU Profiles

Backup and restore your tariff configurations:

• Save current Tesla tariff as named profile
• Restore previous configurations anytime
• Manage multiple tariff setups
• Pre-spike backup for AEMO spike detection

How It Works

Intelligent Price Conversion

Tesla Sync uses sophisticated algorithms to convert Amber Electric's dynamic pricing into Tesla-compatible TOU (Time-of-Use) tariffs:

1. Smart Period Mapping

Amber Electric labels their forecasts using END time convention (e.g., "18:00 forecast" = 17:30-18:00 period), while Tesla uses START time labels (e.g., PERIOD_17_30 = 17:30-18:00). Tesla Sync automatically aligns these conventions so prices match exactly what you see in the Amber app.

2. 5-Minute Averaging

• Recent/Current Prices: Amber provides 5-minute actual intervals with high precision
• Conversion: Tesla Sync averages six 5-minute intervals into each 30-minute Tesla period
• Result: More accurate pricing that captures real market volatility
• Example: Period 20:00-20:30 averages prices from 20:05, 20:10, 20:15, 20:20, 20:25, 20:30

3. Rolling 24-Hour Window

Tesla requires a static 24-hour tariff structure, but Tesla Sync makes it "roll" forward:

• Future periods (not yet reached today): Use today's forecast prices
• Past periods (already passed today): Use tomorrow's forecast prices
• Benefit: Tesla always has 9-24 hours of lookahead for every period, enabling optimal battery decisions

Example at 2:15 PM:

PERIOD_00_00 → Tomorrow's 00:00 forecast (+9h 45m lookahead)
PERIOD_14_00 → Today's 14:30 forecast    (+15m lookahead - current)
PERIOD_23_30 → Tomorrow's 00:00 forecast (+9h 45m lookahead)

4. Timezone Auto-Detection

Works anywhere in Australia without configuration:

• Brisbane (AEST UTC+10:00): No DST
• Sydney/Melbourne/Canberra (AEDT UTC+11:00): DST in summer
• Adelaide (ACDT UTC+10:30): Unique 30-minute offset + DST
• Perth (AWST UTC+8:00): No DST
• Darwin (ACST UTC+9:30): No DST

The system automatically extracts timezone information from Amber's API data, ensuring correct "past vs future" period detection for all locations.

5. Precision Matching

Prices are rounded to 4 decimal places with trailing zeros automatically removed:

• 0.2014191 → 0.2014 (4 decimals)
• 0.*** → 0.199 (3 decimals, trailing zeros dropped)

Sync Frequency

Every 5 minutes - Perfectly aligned with Amber Electric's forecast update schedule for maximum freshness.

Installation Options

Tesla Sync is available in two deployment options:

1. Home Assistant Integration - Native HA custom integration (Recommended for HA users)
2. Docker Application - Standalone web app with dashboard

Both options require Tesla API access - see Tesla API Options below for setup.

---

Tesla API Options

Tesla Sync supports two methods for accessing your Tesla Powerwall. Choose one - you don't need both.

Option 1: Teslemetry (Recommended - ~$4/month)

The easiest setup option. Teslemetry is a third-party proxy service for Tesla API.

Setup:

1. Sign up at [***]
2. Connect your Tesla account
3. Copy your API key
4. Paste into Tesla Sync settings

Option 2: Tesla Fleet API (Free)

Direct OAuth access to Tesla's Fleet API. Completely free but requires more setup.

Setup for Home Assistant:

1. Install the official Tesla Fleet integration in Home Assistant
   • Settings → Devices & Services → Add Integration → "Tesla Fleet"
   • Follow the OAuth login flow
2. Tesla Sync automatically detects your Tesla Fleet credentials
3. Leave the Teslemetry field empty during Tesla Sync setup

Setup for Docker:

1. Register an OAuth app at [***]
2. In Tesla Sync Settings, select "Tesla Fleet API (Direct, Free)"
3. Enter Client ID, Client Secret, and Redirect URI
4. Click "Connect to Tesla Fleet API" to authorize
5. See TESLA_FLEET_SETUP.md for detailed instructions

---

Home Assistant Integration

The easiest way to use Tesla Sync if you're already running Home Assistant.

Features

• ✅ Native HA Integration - Seamless integration with your Home Assistant instance
• ✅ HACS Installation - Install and update via HACS (Home Assistant Community Store)
• ✅ Automatic Discovery - Auto-discovers Tesla energy sites
• ✅ Real-time Sensors - Amber pricing and Tesla energy data as HA sensors
• ✅ Automatic TOU Sync - Background syncing every 5 minutes
• ✅ Manual Services - On-demand sync services for advanced automation

Prerequisites

• Home Assistant installed and running
• HACS (Home Assistant Community Store) installed
• Amber Electric API token (get one here)
• Tesla API access (choose an option above)

Installation Steps

1. Install via HACS

   • Open HACS in Home Assistant
   • Click the three dots in the top right
   • Select "Custom repositories"
   • Add repository URL: [***]
   • Category: Integration
   • Click "Add"
   • Click "Download" on the Tesla Sync integration
   • Restart Home Assistant

2. Add Integration

   • Go to Settings → Devices & Services
   • Click "+ Add Integration"
   • Search for "Tesla Sync"
   • Click to add

3. Configure

   • Enter your Amber API token (get one here)
   • Enter your Tesla API credentials (Teslemetry key or leave empty for Tesla Fleet)
   • Select your Tesla energy site and Amber site
   • Enable automatic TOU schedule syncing (recommended)

4. Verify Setup

   • Check that new sensors appear:
     • sensor.current_electricity_price
     • sensor.solar_power
     • sensor.grid_power
     • sensor.battery_power
     • sensor.home_load
     • sensor.battery_level
   • Check that the switch appears:
     • switch.auto_sync_tou_schedule

Automatic TOU Syncing

The integration automatically syncs your TOU schedule every 5 minutes (aligned with Amber Electric's forecast updates) when the auto-sync switch is enabled.

How it works:

1. Enable the switch.auto_sync_tou_schedule switch (enabled by default during setup)
2. The integration runs a background timer that checks every 5 minutes
3. If auto-sync is enabled, it automatically:
   • Fetches the latest Amber pricing forecast
   • Converts it to Tesla TOU format
   • Sends it to your Powerwall via Teslemetry API
4. If auto-sync is disabled, the timer skips syncing

No automation required! Just leave the switch on and the integration handles everything automatically, just like the Docker version.

You can disable automatic syncing by turning off the switch, and re-enable it anytime.

Available Services (Advanced)

yaml
# Manually sync TOU schedule
service: tesla_sync.sync_tou_schedule

# Refresh data from Amber and Teslemetry
service: tesla_sync.sync_now

Example Automations (Optional)

These are optional automations for advanced users. Auto-sync is automatic and doesn't require any automations.

Force immediate sync on price spike:

yaml
automation:
  - alias: "Force TOU Sync on Price Spike"
    trigger:
      - platform: state
        entity_id: sensor.current_electricity_price
    condition:
      - condition: numeric_state
        entity_id: sensor.current_electricity_price
        above: 0.30
    action:
      - service: tesla_sync.sync_tou_schedule

Disable auto-sync during off-peak hours:

yaml
automation:
  - alias: "Disable Auto-Sync at Night"
    trigger:
      - platform: time
        at: "23:00:00"
    action:
      - service: switch.turn_off
        target:
          entity_id: switch.tesla_sync_auto_sync