homebridge-tesla-powerwall2 4.2.4-beta.0

package/CHANGELOG.md

@@ -0,0 +1,171 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [4.2.4] - 2026-06-??
+
+Plugin renamed from homebridge-tesla-powerwall to homebridge-tesla-powerwall2 and maintainer changed to @dkerr64
+- To disquinguish from the legacy plugin that no longer works
+- To allow us to publish this new plugin on [npmjs](https://www.npmjs.com/) as maintainer of original plugin is not responding to outreach on whether he would accept a pull request and update the published plugin
+- And reflects that the plugin is only tested with Powerwall 2
+
+### Changed
+
+- Name of grid sensor changed from _Online_ to _Offline_ for consistency with other sensors that trigger when the state changes to the named state
+- Name of home/load sensor changed from _Load_ to _Home_ for consistency with Tesla's own app
+
+## [4.2.3] - 2026-06-11
+
+### Fixed
+- Power meters (solar/grid/load) now report the **actual watts** instead of
+  one-tenth of the reading. The previous `power / 10` scaling was removed;
+  HomeKit's ambient-light (lux) characteristic accepts up to 100000, which
+  comfortably covers any residential Powerwall. (#18)
+- Battery level and the battery lightbulb brightness now **round down**
+  (`Math.floor`) instead of to the nearest integer, matching the Tesla and
+  Apple Home apps and the HomeKit integer 0–100 spec. (#19)
+
+### Changed
+- `tsconfig.json` now uses `"module"`/`"moduleResolution": "nodenext"`
+  (the previous `"node"` value is deprecated), matching the current
+  homebridge-plugin-template. Relative dynamic imports were given explicit
+  `.js` extensions as required by `nodenext`. (#17)
+- Added a `lint` script (`eslint . --max-warnings=0`) and made
+  `prepublishOnly` run lint before build, matching the plugin template.
+  Fixed the existing lint errors (switch-case indentation, unused import)
+  and renamed `eslint.config.js` → `eslint.config.mjs` to clear the
+  `MODULE_TYPELESS_PACKAGE_JSON` warning. (#16)
+
+### Documentation
+- Expanded the README's power-meter description to spell out what each
+  meter shows (Solar = generation, Grid = utility flow, Load = household
+  consumption) and to note that the lux value equals actual watts.
+
+## [4.2.2] - 2026-06-10
+
+### Changed (breaking for existing automations)
+- Inverted the contact-sensor polarity for the `Exporting` and `Importing`
+  sensors so it now matches HomeKit's door-sensor convention: **Closed
+  while idle, Open while active**. Previously the sensors reported
+  `Closed` whenever export/import was actively flowing, which left both
+  tiles showing `Open` at rest and made automations read backwards. If you
+  built automations on the old polarity (triggering on "detects contact"
+  while flow was active), flip them to trigger on the sensor opening
+  instead. The `Grid Online` sensor is unchanged — it was already
+  Closed-at-rest.
+- Renamed the three grid contact sensors to action-oriented labels so the
+  tile name alone conveys the meaning:
+  - `Tesla Powerwall Grid Status` → `Tesla Powerwall Grid Online`
+  - `Tesla Powerwall Grid Feeding` → `Tesla Powerwall Exporting`
+  - `Tesla Powerwall Grid Pulling` → `Tesla Powerwall Importing`
+  Accessory UUIDs are seeded by stable strings, so existing installs keep
+  their HomeKit identity; only new installs see the new defaults, and any
+  Home-app rename overrides the plugin label anyway. Config keys
+  (`enableGridStatus`, `enableGridPowerSensors`) are unchanged.
+- `AccessoryInformation.Model` strings updated to match the new names.
+- Homebridge UI titles/descriptions in `config.schema.json` reworded for
+  the new names (underlying property names unchanged).
+
+### Documentation
+- README "Accessories Provided" section rewritten with the new names and
+  explicit Open/Closed state mapping for each contact sensor, plus a note
+  on HomeKit's door-sensor terminology (Open = event, Closed = idle).
+- Automation examples updated to reference the new accessory names and the
+  new "sensor opens" trigger phrasing.
+
+## [4.2.1] - 2026-06-10
+
+### Fixed
+- Inverted Powerwall charging state (#10). The Tesla aggregates API reports
+  `battery.instant_power` as positive when discharging and negative when
+  charging; the comparison in `getChargingState` had the polarity reversed,
+  so HomeKit saw `CHARGING` during discharge and vice versa.
+
+### Tests
+- Added unit coverage for `PowerwallAccessory.getChargingState` around the
+  charging/discharging/noise-band cases.
+
+## [4.2.0] - 2026-06-09
+
+### Changed
+- Replaced `node-fetch` with `undici` and Node's native fetch
+- Bumped Homebridge dev dependency to 2.x (matches `engines` field)
+- Updated `@types/node`, `typescript-eslint`, `mocha`, `nock`, `tough-cookie` to latest
+- Switched coverage tooling from `nyc` to `c8` (no instrumentation, no vulnerable transitives)
+- Shared cache window (3s default) on all Powerwall API calls so concurrent accessory polls share a single network request
+- `HttpClient` interface now strongly typed in `TeslaPowerwallPlatformInterface` (was `any`)
+
+### Removed
+- Unused runtime deps: `moment`, `fakegato-history`, `node-fetch`, `@types/node-fetch`
+- Unused dev deps: `chalk`, `tough-cookie`, `events`
+- Orphaned `src/configUI.ts` (never wired up)
+- Orphaned `src/helper/` JS files (pre-TypeScript-rewrite leftovers)
+- Dead `createAccessoryHandler` method in `platform.ts`
+- Legacy `.eslintrc.json` (superseded by flat `eslint.config.js`)
+- `README.md.old`
+- `enableHistory` config option (no implementation existed)
+
+### Security
+- Reduced `npm audit` findings from 12 → 0 by adding `overrides` for the
+  remaining mocha transitives (`diff` → `^9.0.0`, `serialize-javascript` →
+  `^7.0.5`). Mocha's runtime usage (`diffWordsWithSpace`, `createPatch`) is
+  stable across these majors; the test suite passes unchanged.
+
+### Tests
+- Replaced the legacy mocha suite (which targeted the pre-TypeScript static-platform shape with `0_powerwall`/`1_solar`/`PowerMeterService` etc.) with focused tests for the current `DynamicPlatformPlugin`: plugin registration, platform construction error paths, and HttpClient auth/401-retry/cache behaviour exercised through `undici.MockAgent`
+- `HttpClient` now accepts an optional `dispatcher` and `autoStartLogin` flag so its HTTP layer is unit-testable
+- Migrated `test/integration/*.js` scripts off `node-fetch`/`tough-cookie` onto `undici`
+
+## [4.1.0] - 2026-01-16
+
+### Added
+- **Grid Power Sensors** (addresses Issue #35)
+  - New "Grid Feeding" sensor triggers when exporting power to grid
+  - New "Grid Pulling" sensor triggers when importing power from grid
+  - Configurable threshold (default 50W) to prevent false triggers
+  - Perfect for HomeKit automations and energy management
+  - Validation script for testing sensor behavior
+
+- **Testing Tools**
+  - Grid sensor validation script (`test/integration/validate-grid-sensors.js`)
+  - Real-time power flow visualization
+  - Sensor state evaluation
+
+- **Documentation**
+  - Comprehensive automation examples (4 use cases)
+  - API limitation documentation for operation mode control
+  - Testing instructions
+  - Configuration examples
+
+### Changed
+- Updated all dependencies to latest compatible versions
+  - @eslint/js: 9.8.0 → 9.39.2
+  - @types/node: 20.5.0 → 20.19.30
+  - eslint: 9.8.0 → 9.39.2
+  - homebridge: 1.8.0 → 1.11.1
+  - typescript: 5.2.2 → 5.9.3
+  - And more...
+
+### Fixed
+- Memory leaks in all accessories (added proper cleanup methods)
+- Type safety improvements across the codebase
+- Nullish coalescing for numeric config values (allows 0 as valid threshold)
+- Parameter validation in validation script
+
+### Security
+- Fixed 4 npm audit vulnerabilities (6→2 remaining low-severity dev dependencies)
+- CodeQL security scan: 0 alerts
+
+### Documented
+- **Operation Mode Control Limitations** (Issue #54)
+  - Local API does not support changing operation modes
+  - Requires Tesla Fleet API (cloud-based)
+  - Provided alternatives and future roadmap
+
+## [4.0.1] - Previous Version
+- TypeScript rewrite
+- Homebridge 2.0 compatibility
+- Modern dependency updates
+
+[4.1.0]: https://github.com/nmuldoon/homebridge-tesla-powerwall/compare/v4.0.1...v4.1.0
+[4.0.1]: https://github.com/nmuldoon/homebridge-tesla-powerwall/releases/tag/v4.0.1

package/LICENSE

@@ -0,0 +1,15 @@
+Copyright (c) 2018 Marvin Dostal, Timo Dostal
+Copyright (c) 2020, 2021 Marvin Dostal
+Copyright (c) 2021 Additional contributors
+
+Permission to use, copy, modify, and/or distribute this software for any 
+purpose with or without fee is hereby granted, provided that the above 
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH 
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND 
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, 
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM 
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR 
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,380 @@
+# homebridge-tesla-powerwall2
+[![npm](https://badgen.net/npm/v/homebridge-tesla-powerwall2/latest?icon=npm&label)](https://www.npmjs.com/package/homebridge-tesla-powerwall2)
+[![npm](https://badgen.net/npm/dt/homebridge-tesla-powerwall2?label=downloads)](https://www.npmjs.com/package/homebridge-tesla-powerwall2)
+
+**Unofficial** Homebridge Plugin for the Tesla Powerwall - **Now Updated for Homebridge 2.0!**
+
+Communication with the Tesla Powerwall is according to https://github.com/vloschiavo/powerwall2 .
+
+This plugin has been completely modernized with TypeScript, updated dependencies, and Homebridge 2.0 compatibility while maintaining all original functionality.  With thanks to @nmuldoon
+
+See [CHANGELOG.md](https://github.com/dkerr64/homebridge-tesla-powerwall2/blob/master/CHANGELOG.md) for latest updates and history
+
+## Requirements
+
+- **Node.js**: 18.15.0 or higher
+- **Homebridge**: 1.6.0 or higher
+
+# Installation
+
+## Recommended: Homebridge UI
+1. Install [Homebridge](https://github.com/homebridge/homebridge): see the [Homebridge wiki](https://github.com/homebridge/homebridge/wiki)
+2. In the Homebridge Web-GUI, search for the "Tesla Powerwall" plugin and install it.
+3. Configure the plugin using the config UI interface.
+
+## Command Line Installation
+```bash
+npm install -g homebridge-tesla-powerwall2
+```
+
+## Testing Your Connection
+
+Before configuring the plugin, test your connection to ensure everything works:
+
+```bash
+# Navigate to the plugin directory (if installed globally)
+cd $(npm root -g)/homebridge-tesla-powerwall2
+
+# Run the connection test
+node test/integration/test-connection.js <ip-address> <password>
+
+# Example:
+node test/integration/test-connection.js 192.168.1.50 your-password-here
+```
+
+The test script will:
+- ✅ Verify authentication
+- ✅ Test battery status retrieval
+- ✅ Test power flow data
+- ✅ Test grid connectivity status
+- 📋 Provide configuration template for Homebridge
+
+### Testing Grid Power Sensors ⭐ **NEW**
+
+To validate that the grid power sensors will work correctly:
+
+```bash
+# Run the grid sensor validator
+node test/integration/validate-grid-sensors.js <ip-address> <password> [threshold]
+
+# Example with 50W threshold:
+node test/integration/validate-grid-sensors.js 192.168.1.50 your-password-here 50
+```
+
+The validator will:
+- ✅ Show current power flow (grid, solar, battery, home)
+- ✅ Display grid sensor states based on your threshold
+- ✅ Provide recommendations for automation setup
+- 💡 Help you tune the threshold for your system
+
+## Configuration
+
+### Basic Configuration
+```json
+{
+    "platforms": [
+        {
+            "platform": "TeslaPowerwall",
+            "name": "Tesla Powerwall",
+            "ip": "192.168.1.50",
+            "password": "your-password-here",
+            "pollingInterval": 15,
+            "enableGridPowerSensors": true,
+            "gridSensorThreshold": 50
+        }
+    ]
+}
+```
+
+### Required Parameters
+- `platform`: Must be "TeslaPowerwall"
+- `name`: Display name for your Powerwall
+- `ip`: IP address of your Tesla Powerwall
+- `password`: Your Powerwall password
+
+### Optional Parameters
+```json
+{
+    "platform": "TeslaPowerwall",
+    "name": "Tesla Powerwall",
+    "ip": "192.168.1.50",
+    "password": "your-password-here",
+    "port": "443",
+    "pollingInterval": 15,
+    "enableGridStatus": true,
+    "enableGridPowerSensors": true,
+    "gridSensorThreshold": 50,
+    "enablePowerMeters": true,
+    "enableHistory": false,
+    "debug": false
+}
+```
+
+### Configuration Options Explained
+
+#### Connection Settings
+- `ip`: **Required** - The IP address of your Tesla Powerwall on your local network
+- `password`: **Required** - Your Tesla Powerwall password (set via the Tesla app)
+- `port`: Port number (default: "443")
+
+#### Monitoring Settings
+- `pollingInterval`: How often to poll the Powerwall for updates in seconds (default: 15, min: 5, max: 300)
+- `enableGridStatus`: Show grid connectivity status as a Contact Sensor (default: true)
+- `enableGridPowerSensors`: Show sensors for grid power flow detection (default: true) ⭐ **NEW**
+- `gridSensorThreshold`: Power threshold in watts for sensor activation (default: 50W, helps avoid false triggers) ⭐ **NEW**
+- `enablePowerMeters`: Show power flow meters (Solar, Grid, Home, Battery) as Light Sensors (default: true)
+- `enableHistory`: Enable historical data logging for Eve app (default: false)
+
+#### Troubleshooting
+- `debug`: Enable detailed debug logging (default: false)
+
+## Features
+
+### Accessories Provided
+
+1. **Battery Status** - Shows battery charge level, charging state, and low battery alerts
+2. **Grid Offline Sensor** (`Tesla Powerwall Grid Offline`) - Contact sensor reflecting whether the Powerwall is grid-tied
+   - **Closed** = grid connected (`grid_status: SystemGridConnected`)
+   - **Open** = grid disconnected / islanded (`SystemIslandedActive` or similar)
+3. **Exporting Sensor** (`Tesla Powerwall Exporting`) - Contact sensor that opens when you are exporting to the grid
+   - **Open** = exporting to the grid (site `instant_power` < -`gridSensorThreshold`)
+   - **Closed** = idle / not exporting
+4. **Importing Sensor** (`Tesla Powerwall Importing`) - Contact sensor that opens when you are importing from the grid
+   - **Open** = importing from the grid (site `instant_power` > +`gridSensorThreshold`)
+   - **Closed** = idle / not importing
+5. **Power Meters** - Light sensors showing instantaneous power flow, in watts
+   (the lux value equals watts). Three are provided:
+   - `Tesla Powerwall Solar` - power your panels are generating
+   - `Tesla Powerwall Grid` - power flowing to/from the utility grid
+   - `Tesla Powerwall Home` - total power your home is consuming
+   - `Tesla Powerwall Battery` - power flowing to/from the Powerwall battery
+
+   > HomeKit has no native power-sensor type, so watts are carried on a light
+   > sensor's lux value (range 0–100000, which covers any residential system).
+   > Values are reported as actual watts.
+
+> **A note on "Open" vs "Closed"**: HomeKit contact sensors only have two
+> labels — "Open" and "Closed" — borrowed from door/window sensors. The
+> convention is **Closed = quiescent / resting state, Open = the noteworthy
+> event** (which is what you usually build automations on). For these
+> sensors:
+> - `Grid Offline` is **Closed** while everything is normal (grid connected)
+>   and **Opens** when the Powerwall islands.
+> - `Exporting` and `Importing` are **Closed** while idle and **Open** while
+>   that flow direction is actively above the threshold.
+>
+> If you'd prefer different labels, you can rename the accessories in the
+> Home app (long-press → Settings → rename); your automations will keep
+> working under the new names.
+
+### Grid Power Sensors - Automation Examples
+
+The grid power sensors enable powerful HomeKit automations:
+
+#### Example 1: Get notified when exporting power to the grid
+```
+When: Tesla Powerwall Exporting opens
+Then: Send notification "You're selling power to the grid! 💰"
+```
+
+#### Example 2: Notify when importing expensive peak power
+```
+When: Tesla Powerwall Importing opens
+AND Time is between 4:00 PM and 9:00 PM
+Then: Send notification "Using peak power from grid ⚡"
+```
+
+#### Example 3: Turn off non-essential loads when pulling from grid
+```
+When: Tesla Powerwall Importing opens
+Then: 
+  - Turn off pool pump
+  - Turn off EV charger
+  - Send notification "Reducing load to minimize grid usage"
+```
+
+#### Example 4: Start charging devices when exporting to grid
+```
+When: Tesla Powerwall Exporting opens
+AND Battery level > 80%
+Then: 
+  - Start EV charging
+  - Turn on pool pump
+  - Send notification "Free solar power available! ☀️"
+```
+
+### Sensor Threshold Configuration
+
+The `gridSensorThreshold` setting (default 50W) prevents false triggers from minor power fluctuations:
+- **50W (default)**: Good balance for most installations
+- **100W+**: Recommended for systems with frequent small fluctuations
+- **0W**: Maximum sensitivity, may cause false triggers
+
+## Legacy Configuration (from v3.x)
+
+For users upgrading from version 3.x, the plugin has been simplified. The old `additionalServices` configuration is no longer needed. Simply use the new boolean flags:
+- `enableGridStatus` - replaces gridstatus options
+- `enableGridPowerSensors` - NEW feature for grid power flow detection
+- `enablePowerMeters` - replaces individual meter options
+- `enableHistory` - replaces eveHistory options
+
+## API Limitations
+
+### Operation Mode Control (Issue #54)
+
+**Important Note**: Due to recent Tesla Powerwall firmware updates, **operation mode control (switching between Self-Powered, Time-based, or changing Backup Reserve) is NOT available via the local API**. 
+
+According to Tesla's architecture:
+- The **local API** (used by this plugin) provides read-only access to system status and power flow data
+- **Operation mode changes** require the Tesla Fleet API, which needs cloud authentication
+
+If you need to automate operation mode changes, you have these options:
+1. Use the Tesla mobile app manually
+2. Integrate with Tesla's Fleet API (requires developer account and cloud access)
+3. Use a separate automation system that supports the Tesla Fleet API
+
+This plugin focuses on what's possible with the local API:
+- Real-time monitoring of battery, grid, solar, and home
+- Grid power flow detection (feeding/pulling sensors)
+- Grid connectivity status
+- Triggering HomeKit automations based on power flow
+
+We may add Tesla Fleet API support in a future version if there's sufficient demand and if it can be implemented without compromising security or requiring complex cloud setups.
+
+## Example Configurations
+
+### Minimal Configuration
+```json
+{
+    "platform": "TeslaPowerwall",
+    "name": "Tesla Powerwall",
+    "ip": "192.168.1.50",
+    "password": "your-password-here",
+    "pollingInterval": 10
+}
+```
+
+### Full Configuration with All Features
+```json
+{
+    "platform": "TeslaPowerwall",
+    "name": "Tesla Powerwall",
+    "ip": "192.168.1.50",
+    "password": "your-password-here",
+    "pollingInterval": 15,
+    "enableGridStatus": true,
+    "enableGridPowerSensors": true,
+    "gridSensorThreshold": 50,
+    "enablePowerMeters": true,
+    "enableHistory": false,
+    "debug": false
+}
+```
+
+### Configuration with Disabled Sensors
+```json
+{
+    "platform": "TeslaPowerwall",
+    "name": "Tesla Powerwall",
+    "ip": "192.168.1.50",
+    "password": "your-password-here",
+    "pollingInterval": 15,
+    "enableGridStatus": false,
+    "enableGridPowerSensors": false,
+    "enablePowerMeters": false
+}
+```
+
+## Troubleshooting
+
+### 🔧 Connection Testing
+
+Always start with the connection test script:
+```bash
+node test/integration/test-connection.js <ip> <username> <password>
+```
+
+### ❌ Login Errors
+
+If you get login errors (403, authentication failed):
+1. Verify your password is correct
+2. Check if your Powerwall requires re-registration
+3. Try the connection test script for detailed debugging
+
+### 🔄 Plugin Stopped Working After Powerwall Update
+
+- Ensure you're using the latest plugin version (4.1.0+)
+- Verify the `password` field is correctly configured
+
+### ⚡ Grid Power Sensors Not Triggering
+
+If the new grid power sensors aren't working as expected:
+1. Check the `gridSensorThreshold` setting - you may need to adjust it
+2. Use debug logging to see actual power values: `"debug": true`
+3. Verify your Powerwall is actually feeding/pulling power above the threshold
+4. Check the Homebridge logs for sensor state changes
+
+### 📊 For Older Powerwall Versions (< 20.49.0)
+
+If your Powerwall firmware is older than 20.49.0, you may need to use the legacy version:
+```bash
+npm install -g homebridge-tesla-powerwall@1.1.0
+```
+
+## Development
+
+### Building from Source
+```bash
+git clone https://github.com/dkerr64/homebridge-tesla-powerwall2.git
+cd homebridge-tesla-powerwall2
+npm install
+npm run build
+```
+
+### Running Tests
+```bash
+npm test
+npm run lint
+```
+
+## Migration from v3.x to v4.1.0
+
+The v4.x updates include major improvements:
+
+1. **Node.js Requirement**: Now requires Node.js 18.15.0+
+2. **Simplified Configuration**: The complex `additionalServices` object has been simplified to simple boolean flags
+3. **New Features**: Grid power sensors for automation triggers
+4. **Dependencies**: All dependencies updated to latest versions
+5. **Testing**: Use the new test script to verify connectivity
+
+### Breaking Changes from v3.x
+- Configuration format has been simplified (old format still works but is deprecated)
+- Some advanced Eve features may not be available in v4.x
+
+Simply update the plugin and restart Homebridge. Your existing configuration should continue to work, but consider migrating to the new simpler format.
+
+## Contributing
+
+Contributions are welcome! Please:
+1. Fork the repository
+2. Create a feature branch
+3. Add tests if applicable
+4. Submit a pull request
+
+## Feature Requests / Bug Reports
+
+Please create an [Issue](https://github.com/dkerr64/homebridge-tesla-powerwall2/issues/new) with:
+- Plugin version
+- Homebridge version
+- Node.js version
+- Powerwall firmware version
+- Detailed description of the issue
+- Log output if applicable
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+---
+
+**Disclaimer**: This is an unofficial plugin and is not associated with Tesla, Inc. in any way.

package/config.schema.json

@@ -0,0 +1,119 @@
+{
+  "pluginAlias": "TeslaPowerwall",
+  "pluginType": "platform",
+  "singular": true,
+  "headerDisplay": "A Homebridge plugin for Tesla Powerwall that provides battery status, power flow, and grid connectivity monitoring in HomeKit.",
+  "footerDisplay": "For help and support visit the [plugin repository](https://github.com/dkerr64/homebridge-tesla-powerwall2).",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Tesla Powerwall",
+        "required": true,
+        "description": "The name that will appear in HomeKit for your Tesla Powerwall"
+      },
+      "ip": {
+        "title": "IP Address",
+        "type": "string",
+        "default": "192.168.1.100",
+        "required": true,
+        "format": "ipv4",
+        "description": "The IP address of your Tesla Powerwall on your local network"
+      },
+      "port": {
+        "title": "Port",
+        "type": "string",
+        "default": "443",
+        "required": false,
+        "description": "Port number (leave as 443 unless you've changed it)"
+      },
+      "password": {
+        "title": "Password",
+        "type": "string",
+        "required": true,
+        "description": "Your Tesla Powerwall password (set via the Tesla app)"
+      },
+      "pollingInterval": {
+        "title": "Polling Interval (seconds)",
+        "type": "integer",
+        "default": 15,
+        "minimum": 5,
+        "maximum": 300,
+        "required": false,
+        "description": "How often to poll the Powerwall for updates (5-300 seconds)"
+      },
+      "enableGridStatus": {
+        "title": "Enable Grid Offline Sensor",
+        "type": "boolean",
+        "default": true,
+        "required": false,
+        "description": "Show grid connectivity as a Contact Sensor (Closed = grid connected, Open = islanded)"
+      },
+      "enableGridPowerSensors": {
+        "title": "Enable Exporting / Importing Sensors",
+        "type": "boolean",
+        "default": true,
+        "required": false,
+        "description": "Show separate Contact Sensors that close while you are exporting to or importing from the grid (for automation triggers)"
+      },
+      "gridSensorThreshold": {
+        "title": "Grid Sensor Threshold (watts)",
+        "type": "integer",
+        "default": 50,
+        "minimum": 0,
+        "maximum": 1000,
+        "required": false,
+        "description": "Power threshold in watts for grid sensor activation (helps avoid false triggers from noise)"
+      },
+      "enablePowerMeters": {
+        "title": "Enable Power Meters",
+        "type": "boolean",
+        "default": true,
+        "required": false,
+        "description": "Show power flow meters (Solar, Grid, Load) as Light Bulbs with brightness representing power"
+      },
+      "debug": {
+        "title": "Debug Logging",
+        "type": "boolean",
+        "default": false,
+        "required": false,
+        "description": "Enable detailed debug logging for troubleshooting"
+      }
+    }
+  },
+  "layout": [
+    {
+      "type": "fieldset",
+      "title": "Connection Settings",
+      "expandable": false,
+      "items": [
+        "name",
+        "ip",
+        "port",
+        "password"
+      ]
+    },
+    {
+      "type": "fieldset",
+      "title": "Monitoring Settings",
+      "expandable": true,
+      "items": [
+        "pollingInterval",
+        "enableGridStatus",
+        "enableGridPowerSensors",
+        "gridSensorThreshold",
+        "enablePowerMeters"
+      ]
+    },
+    {
+      "type": "fieldset",
+      "title": "Troubleshooting",
+      "expandable": true,
+      "items": [
+        "debug"
+      ]
+    }
+  ]
+}