sonnen ecoLinx

Cinegration LLC


Smart energy management using sonnen ecoLinx, Eaton and Control4.  Control4 systems now can control the clean energy stored in ecoLinx batteries dynamically in their smart home.

What is energy automation?

Energy automation is the convergence of home automation and energy management, specifically enabling intelligent energy storage to manage how smart homes are powered including the addition of clean energy.  The ecoLinx “energy ecosystem” augments Control4 systems by integrating them with residential solar and energy storage, bringing clean tech to smart homes and enabling the ecoLinx to manage how energy is consumed and devices are powered throughout the home.  

The operation of a smart home can be significantly enhanced by properly controlling how homes use energy. Traditional use cases center the home automation experience on providing the ultimate comfort and convenience to the homeowner by tailoring each system to their specific needs and wants. Smart homes, with energy automation, take this experience to another level by managing the energy consumption of the home without requiring the owner to plan or react to changes in energy availability, e.g., power outages or peak times of day.

How to build a Control4 ecoLinx ecosystem


The ultimate, clean energy smart home is driven by energy automation.  To reap the benefits of energy automation, it is important that the ecoLinx “energy ecosystem” include a combination of the following home automation and clean energy energy devices:

  • sonnen ecoLinx This is your intelligent energy storage system that manages all controllability use cases related to dynamic energy changes.
  • Control4 System using EA class or better technology.
  • Control4 T3 Touchscreens for communication with ecoLinx dashboard.
  • Energy Automation Control Software: The ultra-smart, flexible, user-friendly control system architecture that integrates with ecoLinx and Control4 systems to provide energy automation, developed in partnership with Cinegration.
  • Renewable Energy Source (Typically PV system): On-site alternative source of energy to offset potential loss of grid power and provide access to clean energy.
  • Controllable lights: Allows for the management of lights accordingly during power-relevant events (using devices such as Lutron or Control4 dimmers).
  • Controllable shades: Allows for the management of scenes that could benefit from reducing the exposure to natural light.
  • Controllable thermostats: Efficient link to HVAC systems without the need of complicated control schemes which ties in well with the management of comfort levels during power-relevant events.
  • Eaton's intelligent circuit breaker (Energy Management Circuit Breaker, or EMCB): Provide cloud-based connectivity for efficient load-monitoring and remote communication and smart energy management across the home’s many connected devices. This integration requires an Eaton driver, which was developed by Cinegration.
  • Power control devices like WattBox or Luxul PDU devices (controlled by the Cinegration Power Agent Driver).
  • AV Systems: Allows for Enunciation and Notification of such power-relevant events in a seamless fully integrated solution

The use cases for energy automation

●       Smart Configurable Backup

Users with the ecoLinx, Eaton EMCB or Power devices like WattBox and a Control4 automation system can benefit from the smart configurable backup functionality that provides optimal control over their home automation system.  Using smart power devices like EMCB breakers allows dealers to configure the home for optimal battery strategies for each homeowner.  This allows the ecoLinx to not only focus on managing excess energy production over what is consumed but further tailor the consumption based on need and priority defined by the homeowner.   In the event of a power outage, the ecoLinx will provide backup power to the energized circuits.  The decision as to which circuits get energized is based on the SoC of the ecoLinx and can be a part of predefined profiles set by the user’s home automation dealer.  An example scenario is presented below:

  1. A power outage occurs and the ecoLinx begins providing backup power to the main panel (which is also feeding the home network equipment).
  2. The Control4 driver determines the amount of energy left on the battery based on current consumption then activates the customized backup profile for this event.
    1. Smart Configurable Backup. Intended for normal power outages keeping common use and essential loads and devices on
    2. Smart Configurable Backup Extended. Activated when battery reserves are below 20% and is intended to power only the essential devices in home
  3. The driver will then configure home based on profile selected and continue to monitor power usage.

Dealers also can configure home actions when power is restored, thereby returning devices back on and life back to normal.

●       Smart Weather Forecasting

The sonnen ecoLinx Control4 driver also uses weather forecast data to dynamically modify the ecoLinx’s backup reserve setting.  For example, if the energy automation system detects a severe thunderstorm warning in the user’s area, the system will automatically increase the ecoLinx unit’s energy reserve percentage 100% to prepare the user for the incoming storm and potential loss of grid power.

This further enhances the level of flexibility as it then can reserve the battery capacity for backup when it is really needed. In a static configuration this can lead to losing the optimization range when the likelihood of a power outage is very low.

This is currently only available for US based customers.

●       Smart Demand Control and Load Management

Control4 dealers can customize load shedding and load shifting principles via Composer programming actions.  What this means is that the ecoLinx works with the home automation system to decrease load usage and discharge the battery when appropriate.

Let’s say a customer wants to employ their ecoLinx in daily cycling during their peak time-of-use (TOU) window to effectively “flood the peak”.  In a TOU scenario, the energy automation system employs load shedding to maximize the amount of energy the ecoLinx provides during the peak period.  If, for example, the energy automation system lowered the shades, dimmed the lights, increased the thermostat by 1-2 degrees, and turned off non-essential loads that could decrease consumption by say 2,000W.  On a 10 kWh ecoLinx, that is an additional 2 hours’ worth of energy that can be used to “flood the peak” instead of contributing to the peak.

Most importantly, the sonnen ecoLinx discharges its stored off-peak power and locally-generated stored sunlight, to meet the majority of the home’s load during this expensive, dirty peak time, rendering the home invisible to the grid, while saving money.

The future of energy automation

With the smart demand control and load management capabilities now available to Control4 systems, the natural extension of this feature would be to allow for utility demand response program integration.  Thus, providing ecoLinx owners and utilities benefits from programs in place to utilize the ecoLinx’s dynamic clean energy capacity that would be dispatchable on demand.

As the energy and home automation ecosystems expand the ecoLinx will remain the link that allows for the application of other use cases the can leverage further management of loads for the better optimization of the operation of a smart home.

Driver Features:

  • See battery state from any Control4 MyHome interface
  • Launch sonnen Dashboard via T3 touchscreens
  • Multiple Event and Conditional abilities to create custom scenes and macros for homeowners

Control4 Programming Features:

  • Events:
    • State changes to profiles
    • When AC Frequency, Voltage changes
    • When Battery Voltage Changes
    • When Battery Level changes
    • When Grid Offline/Online
    • When generating PV (solar) energy.
  • Composer Variables
    • AC_Frequency (number)
    • AC_Voltage (number)
    • Battery_Level (number) %
    • Battery_Voltage (number)
    • House_Consumption_Watts (number) -> amount of energy being consumed right now by the home
    • PV_Consumption_Watts (number) -> amount of energy being produced right now by the solar array
  • Conditionals
    • Battery Level (High, Medium, Low)
    • Grid Power Connected (Online = grid power on)
    • Generating Solar (is/is not)
    • Battery Charging (is/is not)
    • Active Profile (Time of Use, Self Consumption, etc...)
ecoLinx Offline Time of Use Self Consumption Utility Demand Response
Smart Configurable Backup Smart Configurable Backup Extended Weather Alert  
sonnen%20scb2.png?1535670078956 sonnen%20weather.png?1535669858310  

Contacts for additional information and assistance:

ecoLinx Sizing and System Design - sonnen  

sonnen Applications Engineering Team

Energy automation with Control4 - Cinegration

Cinegration Development LLC

6425 W 52nd Ave., Suite 1

Arvada, CO 80002


For more information on Eaton EMCBs:

General information:  

Support and contact information:


No posts found

 sonnen ecoLinx driver


The ecoLinx is an intelligent energy storage system for smart homes. Control and improve the quality of life of any home by incorporating Control4 smart home technology with smart energy. Use power efficiently by configuring home ‘profiles’ for maximum energy savings and lifestyle improvement. These profiles are triggered during power outages, critical weather events, and utility demand alerts, configuring the home automatically without homeowner interaction. Dealers can customize the profiles via Cinegration’s fast configuration tool in the driver properties.  With a T3 touchscreen, the customer will receive custom reports and access to the sonnen dashboard. The customer can remotely see the current profile and battery levels. Clicking on the icon will send a popup of the same custom report.  All reports and popups are pre-designed and no additional programming is required! The Cinegration sonnen ecoLinx Control4 Driver creates the perfect platform for smart home technology and energy storage.

Compatible Devices

  • sonnen ecoLinx (ecoLinx10,12,16,18,20)
  • Eaton EMCB intelligent breaker (for dynamic load control)
  • Wattbox, Pakedge PDU, Luxul PDU devices (using Cinegration Power Agent Driver)

Auto Update

Step-by-step tutorial available at

To enable automatic updates for this driver, ensure you have connected your cloud driver and the Automatic Updates property field is set to “On”.



  • Install driver (c4z) file in your Control4 driver’s folder.
  • Load driver into project
  • When driver first loads, it will scan network for sonnen battery. If multiple batteries are at home, dealer must choose which one this driver controls via the Driver List property
  • Select sonnen battery and driver will link automatically to battery
  • Customize home’s energy profiles for customer

Clean Energy Profile Options

  • Smart Configurable Backup Profile (normal, extended and essential)
    1. Activates when home loses grid power
    2. 3 different profiles are available depending on the current battery power reserve. (profile executed automatically)
    3. Dealer can define which devices, loads, and rooms turn off, have announcements fire automatically and configure smart home when power is lost.
  • Weather Alert Profile
    1. Dealer defined weather types
    2. When a severe weather alert happens, the driver will send an alert to Touchscreens and mobile devices via push notification. When customer clicks on sonnen icon, this profile will execute.  Double tapping icon will cancel request.  If customer does not click on icon after 5 minutes profile will execute automatically.
    3. List is comma delimited, so a , MUST be the final character. Removing Warning at the end of keyword will have both Watch and Warnings trigger.  Example, Customer may want to be notified of both Thunderstorm Watch AND Warning events.  In this case, the dealer would remove the word Warning from Thunderstorm Warning.
    4. Common use case for weather alert is to increase the power reserved for emergencies to 100% (when not in a weather event, power reserve is typically set to 20%).

  • Utility Demand Response
    1. Used when utility company requests excess energy from battery or Utility demand response.
    2. Requires customer to accept profile activation
  • Time of Use/Self Consumption
    1. Standard profiles for home
    2. Normally a home will either be in Self Consumption (meaning the battery will discharge its energy into the home as the home requests. If there is solar, the battery will charge).
    3. Time of Use is used with TOU utility rate plans and allows customers to configure when the power in the battery is distributed in home. Dealer can also build scheduled events to configure home for proper TOU period. 


Step-by-step tutorial available at

1) Create your project in the project portal. This will generate your project token.

2) Download and load the cloud driver into your project, you only need one per a project.

3) Use your project token that you have from step one and input it into the “Project Token” properties field within the cloud driver in your Control4 project.

4) Once you have your project connected with your driver will be automatically licensed, and auto update will be active.



  • Cloud Status - This is the current status of your cloud driver connectivity.
  • Driver Version - This is the current version of your driver.
  • Automatic Updates – Turn automatic updates on or off for this driver.
  • Driver Status - Shade information will prompt you if you have missed any of the steps involved with setup off the driver.
  • Driver Actions - This tab will give you selections for a range of different settings to customize your installation
  • UIButton: Single Tap – This option determines what happens when the icon on navigator is single tapped
  • UIButton: Double Tap – This option determines what happens when the icon on navigator is double tapped
  • Icon Style – This option contains different icons that can be used on the driver.
  • Use Push Notification – Enable this to have push notifications be sent automatically (see push table for list of automatic notifications)
  • Touchscreen Control – Choose which touchscreens the driver will interact with (default is all)
  • Weather and Polling Timers– The check in time for weather data and device communication.
  • Energy Log: Save Time and Days – The internal driver recording system for energy usage. Adjust these per data storage requirements.

Composer Programming – Using Events, Conditionals and Commands

 The driver supports many different events or ‘When’ as in ‘When this happens’.   Use these as triggers to do something in the smart home when they happen. 

  Conditional programming can be added in easily.  Use these for customizing a ‘when’.  If more discrete control is needed, use driver variables.  Get creative and really make the home smart.  Events, Conditional and Commands are the gateways to customizing the Control4 system for every homeowner. 


Here is an example of a conditional in practice.  In this example, when a Winter Storm weather alert is received for the area, the Control4 system will turn on the snow melt on the driveway. 

Change Log

Version 1007 - Release



     Cinegration strives to provide fully working drivers without defects.  However, changes and bugs may be found.  Because of this, any bug/maintenance update to this driver will be free of charge.  However, due to the ever-changing nature of computer and audio/video systems, if a new version of the Control4® software creates issues with this driver, or feature enhancements, an upgrade version will be provided.


Cinegration Development


  • 1007
    • Initial Release