Open Dynamic Export is a Node/TypeScript project implementing dynamic export control/solar curtailment of inverters. It aims to solve these use cases:

• dynamic connection requirements (CSIP-AUS/SEP2/IEEE 2030.5) of various Australian energy distributors (DNSPs)
• fixed/zero export limitations (e.g. 1.5kW export limit)
• two-way tariffs (e.g.time based) export limitation
• negative feed-in (e.g. Amber) export limitation

Architecture

Setpoints

The system uses one or more “setpoints” to set the operating envelope of the site. All setpoints are restrictive, that is a combination of multiple setpoints will evaluate all setpoints and enforce the most prohibitive value of each control type at any one time. Learn more about configuring setpoints.

Inverters

The system supports one or more inverters to measure the site’s generation metrics and control the power output. Learn more about configuring inverters.

Site meter

The system supports one site meter to measure the site’s load and export metrics. Learn more about configuring site meter.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam venenatis mauris sit amet ex varius viverra. Curabitur malesuada sed enim tincidunt dignissim.

Install

1. Clone Git repo
2. Copy .env.example and rename it to .env and change the values to suit your environment
3. In the /config folder, make a copy of the config.example.json file and rename it to config.json. Update it with the relevant values, see the “Configuration” section for more details.

Use Node or Docker to run the project.

{
    "inverters": [ // (array) required: list of inverters
        {
            "type": "sma", // (string) required: the type of inverter
            "model": "core1", // (string) required: the model of the inverter
            "connection": {
                "type": "tcp", // (string) required: the type of connection (tcp, rtu)
                "ip": "192.168.1.6", // (string) required: the IP address of the inverter
                "port": 502 // (number) required: the Modbus TCP port of the inverter
            },
            "unitId": 1 // (number) required: the Modbus unit ID of the inverter,
            "pollingIntervalMs":  // (number) optional: the polling interval in milliseconds, default 200
        }
    ],
    ...
}

{
    "inverters": [ // (array) required: list of inverters
        {
            "type": "sma", // (string) required: the type of inverter
            "model": "core1", // (string) required: the model of the inverter
            "connection": {
                "type": "tcp", // (string) required: the type of connection (tcp, rtu)
                "ip": "192.168.1.6", // (string) required: the IP address of the inverter
                "port": 502 // (number) required: the Modbus TCP port of the inverter
            },
            "unitId": 1 // (number) required: the Modbus unit ID of the inverter,
            "pollingIntervalMs":  // (number) optional: the polling interval in milliseconds, default 200
        }
    ],
    ...
}

Node

You can run the Node project directly with the Node.js runtime.

1. Install dependencies with npm install
2. Build the project with npm run build
3. Run the project with npm start

Docker compose

1. Run docker compose up -d to use from the Docker Hub image (optionally run docker compose up -d --build to build the image from the source code)
2. Optionally uncomment the influxdb service in the docker-compose.yml file to enable logging to InfluxDB

Web UI

You can view the dashboard at http://localhost:3000 (or the server port you specified in the .env file).