Introducing the Powerwall Manager SmartApp for SmartThings
After 6 months of operation, I’ve been quite pleased with the new Tesla Powerwall II. The Powerwall coupled with our home solar has almost completely squashed our electric utility peak demand charges and has eliminated all net electric usage during peak hours.
While the Tesla mobile app’s Advanced Time Control settings do a decent job working with my electric utility’s rate structure, I wanted the ability to further monitor and automate the Powerwall’s operation.
I wrote this SmartThings smart app so that I could not only monitor and control the Powerwall through the SmartThings Hub, but could also fully leverage SmartThings to send mobile notifications and to automatically command smart devices and Powerwall functions based on the current status of the Powerwall and other smart devices.
In addition to basic SmartThings integration hooks, the app provides a simple menu for receiving mobile push notifications or text messages based on Powerwall state changes and battery level conditions. The app supports custom schedules for operational mode changes (Backup-Only/Self Powered/Advanced Time Controls) and battery reserve level % settings. The app also provides the option to select devices that should automatically be turned off in the event that a grid/power outage is detected by the Powerwall.
A description of application features and installation instructions are included below.
If you have comments, issues, questions, enhancement suggestions, or wish to provide general feedback, please comment below or use the contact menu selection above.
Update 10-Jan-2020: The latest version v0.2.0e.20200110 of the Powerwall Manager smart app adds initial (basic) cross-platform support for the Hubitat Elevation Home Automation hub
Powerwall Manager SmartApp Features
- Monitor and View Status:
- Battery % level & Reserve % Level
- Current power readings for Solar, Grid, Home, & Powerwall
- Operational Mode Status (Backup-Only/Self Powered/Advanced Time Controls)
- Optimization Strategy (Cost-Saving/Balanced)
- Stormwatch Enabled Status
- Grid/Power Outage Status (added 13-Aug-2019)
- Control:
- Set Reserve % Level
- Set Operational Mode Status (Backup-Only/Self Powered/Advanced Time Controls)
- Set Optimization Strategy (Cost-Saving/Balanced)
- Define Schedules and Automations:
- Schedule the following Powerwall configuration changes to occur at specified times and days of the week:
- Operational Mode (Backup-Only/Self Powered/Advanced Time Controls)
- Reserve %
- Stormwatch enable/disable (added 22-Jan-2020)
- Select smart devices to automatically turn off in the event of a grid outage (added 13-Aug-2019)
- Schedule the following Powerwall configuration changes to occur at specified times and days of the week:
- Customize Built-in Notification Options (receive push and/or text notifications) when:
- Powerwall battery level approaches the reserve level or a user-defined notification % value
- Modes change
- Grid/Power outage status changes (added 13-Aug-2019)
- Firmware version changes
- Integrates Powerwall status and and controls with the SmartThings Hub and ecosystem
- Supports sophisticated monitoring rules and automated control of Powerwall functions through scripting and rule engines such as the phenomenal WebCoRE.
Mobile SmartThings app UI Images
Example Powerwall Manager Dashboard running on the Hubitat Elevation Hub
Installation Instructions
The instructions below assume you have basic familiarity with the SmartThings IDE and custom code installation techniques.
- Powerwall Manager Smart App Code (required)
- Powerwall Manager Device Handler Code (required)
Install the Powerwall Manager Smart App
- Open the Powerwall Manager Smart App code and select edit->select all” followed by “edit -> copy”. Selecting the “Raw” button may make this a bit easier.
- Navigate to the SmartThings IDE “My Smart Apps” tab
- Select “+ New Smart App” (upper right)
- Select “From Code”
- Paste in the Powerwall Manager Smart App code and select “Create” at the bottom
- Select “the Publish” button and select “For Me”
Installing the Powerwall Device Handler
- Open the Powerwall Manager Dashboard Device Handler Code, and select “edit->select all” followed by “edit -> copy”. Selecting the “Raw” button may make this a bit easier.
- Navigate to the SmartThings IDE “My Device Handlers” tab
- Select “+Create New Device Handler” (upper right)
- On the “Create New Device Handler” page, select the tab “From Code”.
- Paste in the code for the Powerwall Manager Dashboard Device Handler code and click the “Create” button at the bottom
- Click the “Publish” button and select “For Me”.
Activate the Powerwall Manager Smart App from the SmartThings Mobile App
- From the SmartThings Classic mobile app on your phone or tablet device, select the Automation -> SmartApps tab
- Scroll to the bottom and select “+Add a SmartApp”
- Scroll to the bottom and select “My Apps”
- Select “Tesla Powerwall Manager” from the list
- Scroll through each of the setting options and menus and select “Save” when done. You can always go back and add/change your settings.
- The Powerwall Manager is now operational and its status can be viewed from the Tesla Powerwall Device on the SmartThings Classic mobile app “Things” tab.
Configuring the App
Once installed, the Powerwall Manager can be configured from the SmartThings mobile UI “SmartApps” tab. Current configuration options include Powerwall mode and reserve % change schedules, notification preferences for device, battery level, and state changes, as well as actions that should be performed during a grid/power outage.
Credentials are currently required to be entered into the app’s preferences to allow interfacing with the Tesla servers. Due to a current limitation with SmartThings support of self-signed certificates, this SmartThings app cannot interface directly with the local Powerwall gateway’s interface at this time.
Changes to Powerwall settings made from this app may not immediately take effect at the time they are commanded. While settings from this app are reflected almost immediately in the Powerwall server settings (and the Tesla native app) after being sent, they are subject to the same Powerwall processing delays as changes made from the Tesla native app.
Warnings and Disclaimer
****** WARNING ****** USE AT YOUR OWN RISK!
This software was developed for my personal use and is provided here in the hopes that it will be useful to others, however, it is beta software and use of this software may result in unforeseen side effects to your equipment and related accounts.
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at: http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Tesla referral code: ERIC78022
Per suggestion from @amphipri0nI, I’ve updated the app and device handler to indicate the grid outage status (onGrid/offGrid) from the Powerwall. I also added grid status push/text notification option as well as an option to select devices to turn off during an outage in the Powerwall manager app itself. If you’ve already installed the prior version, you’ll need to update both the smart app and device handler for all the changes to work properly.
As a side note, the Powerwall performed flawlessly when I cut off grid power to test the update. This is the first test I’ve done on the latest V1.37.1 software version. The Powerwall immediately cut over to power my home, and solar continued charging the battery. I think with a little care and forethought (and unfortunately no air conditioning with just a single Powerwall), my home power could be indefinitely sustainable without grid-power. The Powerwall is just plain awesome.
new to the whole smartThing environment and the basic model – have downloaded your code and have it showing my power wall status – and see a list of switches for when it’s off grid. I have a NuHeat floor heater thermostat – and have installed it in the Smartthings/home/app also – showing status for it also – but the NuHeat Thermostat does not show up as a device that can be switched “off” during a grid outage – I’m requesting some help/tips/pointers as to how we could modify the code to also set the NuHeat thermostats to “off” during an outage also – being new to the IDE and the general model I’m lacking enough context to forge a path forward – the Device Handler for the NuHeat thermostats are listed here https://github.com/ericvitale/ST-NuHeat-Signature-Thermostat – I’m wondering if anyone can take a look and rough out some code or provide me some pointers. I really don’t want to run the electric floor heaters while on battery power.
thank you in advance for any assistance.
Hi David. Looking over the NuHeat device handler code, it doesn’t currently support the Switch on/off capability directly (which the PowerWall Manager currently requires for control), although it does provide on/off command methods. You can add the switch capability by typing in the following line on or around line 49 in the NuHeat device handler code:
capability "Switch"One possible issue with this though is that the NuHeat device handler off() command currently runs a resume function which sets the thermostat to ‘Schedule Mode : 1’. I’m not so sure this is what you want since I’m unfortunately not familiar with the NuHeat device, but maybe it’s a start. Once you add the capability line to the NuHeat code, you should be able to test on and off triggers by using a Smart App like SmartLighting to turn the heater on and off via a physical or virtual switch trigger (if you don’t want to do the full house power down needed to test with the PowerWall Manager).
Hey there – I found you via TMC and I procured a Smartthings hub (the newest one) and was able to install your app into it. Thank You – it’s really awesome and certainly makes the Tesla app much more intelligent in terms of Time management.
In my particular situation, I want to turn off my nest thermostats when there is a grid outage and since Smart Things and NEST don’t talk to each other, I could use IFTTT (which still talks to NEST) if I could set up a trigger from your app that can be used to trigger an IFTTT recipe. Within the IFTTT section of the Classic app, I can only set the powerwall ‘switch’ – it seems that there needs to be some sort of hook from your app to IFTTT. Perhaps the thing to do is to have your app ‘think’ the Powerwall is off when there is a grid outage and then I can use that state to trigger the IFTTT recipe.
Thoughts?
Hi Mark. Thanks for the feedback. What you describe is precisely how the Powerwall manager should currently work. The Powerwall device in SmartThings is considered a switch, and “on” indicates that the Powerwall is connected to the grid and “off” indicates a disconnect/power outage. You should be able to perform IFTTT actions based on this switch state. Please let me know if you run into issues – I can’t say I’ve fully tested the full integration here.
Great! I’ll test once I have a UPS installed for my server.
Here’s another thought- can you set up an internal trigger from the amount of charge in the PW? For example to automate a switch from Backup to Self Power at 75% change, or to Backup at 20%? I don’t trust the Tesla app to figure out how much charge I really need for backup.
You should be able do this with the WebCore Smart App if you’re willing to add it to your SmartThings tool kit. It’s the most sophisticated and simple-to-use (once you get the hang of it) GUI based home automation rules engine that I’m aware of, and you may find it useful for other purposes as well. Here’s a sample WebCore piston that I think would accomplish what you’re looking for:
I agree though, it’s nicer when options like this are directly controllable from the Powerwall Manager, so I’ll try to look at adding more of these types of features in the future.
Interesting – when I have some time I might try that.
In playing around with all the options, it’s not super clear to me how to get the exact behavior I want. I’m TOU in SCE (los angeles) and right now it’s pretty easy to have the PW setup so it’s in backup mode during the off peak times and Self Powered mode (with a high-ish reserve up until Peak) and then at Peak, lower the reserve.
That works fine, but during Peak, ideally I’d want the excess solar going back to the grid. When ever I turn on the Advanced settings, it seems to turn off the powerwall and grab power from the grid which is exactly what I don’t want. 😉
could it be that I have to run in Advanced mode for a few days for it to learn? my biggest concern is that mode won’t reserve enough energy to for TOU peak to end at 8pm or hold on to 10pm when the shoulder is done.
is there a way to force the PW to send to the house during peak and solar to the grid? I figure Advanced/Cost mode would do that but it doesn’t seem to.
I freaking love this, thank you!
You’re welcome! I appreciate the comment.
ok – I have a real feature request. in scheduling, I would like to have finer control of the reserve % amount. 25/50/75 isn’t where I want to set it. for example I was 55 or 60% on backup and 20 or 15% on discharge.
this single thing is the only bit in the tesla app that is better 😉
Yes, I’ll look at changing that so that you can enter any percentage of your choosing. Thank you for the suggestion!
I have a trouble shooting question. I have the schedule set to switch to backup at 10pm and it didn’t do it last night – my pw’s were still on self power at 6am. how do I troubleshoot this?
In the SmartThings IDE, “My Locations” tab, you can select smartapps and devices and view their event history. There might be at least some clue as to what it did or didn’t do last night in either the Powerwall Manager app or the Powerwall device history. You should see the command events in both the smart app and device event history. You can also view the Live Logging tab for more detailed logs, but you can only view real-time logs, there will unfortunately be no history in live logging from last night. The Live Logging information could be useful if you are able to recreate the problem on command.
thanks – I’ll check it out.
In the future, I plan on having the app verify and resubmit the command if it didn’t appear to work – and also then send a notification if the command still doesn’t take after a few retries. It’s been so stable for me, I just hadn’t prioritized that.
yet another feature request – is there a way to automate Storm Watch on and off? We are in a weather service alert and so over night my batteries topped off from the grid (yay!) but during the day I had them in self powered mode and with the batteries dropped below 90% or so it started to pull from the grid. during TOU peak – I’m glad I was watching the tesla app as suddenly I was pulling 10kW. I toggled off storm watch and it stopped. At 10pm when I am off peak, I’ll turn it back on.
Yes – that can be added without too much difficulty. I’ve put that on the list of future potential change requests here: https://github.com/DarwinsDen/SmartThingsPublic/projects/2
Hi Mark. I’ve added Stormwatch enable/disable scheduling in the latest release and I’m now putting it through its paces. I’ve updated my personal Powerwall Manager schedules to disable Stormwatch during peak utility periods and then re-enable it at the start of off-peak. In the year or so I’ve had the Powerwall, Stormwatch has never been triggered on my system, but regardless it would probably cost me a fortune in utility demand charges if Stormwatch ever was triggered during peak hours.
fantastic! I’ve my power wall for like 6 weeks and we’ve had 3 storm watch events since….
I’m getting ‘tesla account issue’ on updating my schedule – what did I do wrong?
Are you seeing any other errors such as “Error verifying Tesla/Powerwall account”? You may need to go back into the Account Information section and verify your credentials. If that fails, can you pull up the ‘Live Logging’ tab in the SmartThings IDE and try running through the app settings again – and let me know if there are any suspicious logs there?
First off, this is awesome! I am loving it! Could we add some more selections to the reserve %? I am using it to defeat my energy company having dual peaks. I need about 15% reserve or I risk running out in the mornings during the peak, but I’d I jump to 25% I take grid power when I don’t need to. Any way that can either be changed to 5% increments or become a box we could insert any percentage? Thanks!
Thanks for the feedback. This has been one of the more common requests. Version v0.1.6 of the smart app now supports reserve percentage options in 5% increments. If your device handler code was already current (v0.1.3 from 12 Aug 2019), then to update, you’ll just need to follow the first section “Install the Powerwall Manager Smart App” of the installation instructions above and you should be good to go.
I saw it yesterday as I happened to be in GitHub updating some other smart apps and I want to give a sincere “Thank you!”
the update works perfectly.
Thanks for the app; it’s working great. But how do I delete the old app version? I now have two versions installed and I get an error trying to delete the first.
This usually means that SmartThings is holding on to a reference to the Powerwall device somewhere. Possibly there’s another smart app referencing it. Try removing the Powerwall device first (select the Powerwall device from the ‘Things’ tab and then select the cog in the upper right) before removing the smartApp.
It was the Alexa app. Deleted that and then could delete the old Version. Thanks!
Hi, this is a great app! thank you for writing it. I’ve been using the app with Smartthings but I’m switching to Hubitat. Do you have any plans to tweak the app so that it works on both platforms?
Thanks! Hubitat support is on the long term roadmap, but I can’t make any promises at this point. I have a Hubitat hub on the shelf right now, but haven’t had a chance to give it a try yet.
Ok, thanks. I was able to get it to load with a couple of edits and create a device but it didn’t pull any data. No problem. I’m happy to wait, I’ve got plenty of other things to migrate across in the meantime 👍
I spoke to soon. I gave it a quick try and was able to get at least initial functionality on Hubitat by updating the async http call for cross-platform support with Hubitat & SmartThings. v0.1.8 of the smart app has this latest update. I did not update the current device handler code. The current Powerwall device is not pretty on Hubitat right now, but it does show the current state and at least the few commands I attempted appear to work.
I’m having a weird problem – the best I can figure out is that my reserve is stuck at 60% regardless of what the tesla app says or what ever mode I am in. The PW’s simply stop discharging whenever I hit 60%. Any ideas how to shake it free?
I have not heard of this issue before, but I have seen the Powerwall occasionally take several hours for a setting to take. Are you still seeing the problem? I would contact Tesla support if it is still occurring.
It’s been like that since last weekend. I’ve sent email to Tesla support but no answer. I’ll call on Monday.
The long and the short of it was the gateway was no longer receiving commands from my app or Smart Things. After two calls with Tesla ‘we’ll get back to you in a few days’ and a call from installer who suggested I hit the reset button on the Gateway (I didn’t know it existed as I wasn’t around when they finished the installation.) and within 20 minutes my PW’s were responding to commands both from ST and the Tesla app.
Good to know. Maybe I should have suggested that, but I’ve seen little information on exactly when the gateway reset button should be used. I hit mine once about a year or so ago after becoming impatient when the Powerwall didn’t seem to be behaving correctly based on the mode I had set several hours prior. Back then, the gateway software version was much slower to respond to commands, so I never gave it much thought as to whether hitting reset somehow helped resolved it or if the change finally just took effect on its own. Sounds like our situations may have been similar after all.
RE:Storm Watch update. I THINK I fixed it. I logged out of the Tesla app and when I went to login I couldn’t. I went to the website and was told that there were too many bad login requests. I had to reset my password, After that I could log back in to the app and then changed my credentials in ST and now it seems to work. The logs are mostly blue now (before there was a whole lot of Red…)