Setpoints

One or more setpoints can be configured 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.

• Control modes
• CSIP-AUS dynamic connection
• Fixed limit
• MQTT
• Negative feed-in
• Two-way tariffs

Control modes

The software supports 6 control modes mapped to the CSIP-AUS Dynamic Operating Envelope (DOE) modes.

Mode	Description	Overlap resolution	Default value
opModConnect	Connection to the grid	Prioritize disconnect	Connect
opModEnergize	Generate or consume energy (in practice for most inverters this is the same as opModConnect)	Prioritize de-energize	Energized
opModExportLimW	Maximum site export limit (in watts)	Lower limit	Unlimited
opModGenLimW	Maximum inverter generation limit (in watts)	Lower limit	Unlimited
opModImpLimW	Maximum site import limit (in watts)	Lower limit	Unlimited
opModLoadLimW	Maximum controllable load limit (in watts)	Lower limit	Unlimited

CSIP-AUS dynamic connection

Apply dynamic limits from an Australian energy utility CSIP-AUS server using a setpoint.

IMPORTANT

This CSIP-AUS client cannot run without device certificates (and manufacturer certificates). See the CSIP-AUS section for more information.

To use the CSIP-AUS provided limits as a setpoint, add following property to config.json

{
    "setpoints": {
        "csipAus": {
            "host": "https://sep2-test.energyq.com.au", // (string) required: the CSIP-AUS server host
            "dcapUri": "/api/v2/dcap", // (string) required: the device capability discovery URI
            "nmi": "1234567890", // (string) optional: for utilities that require in-band registration, the NMI of the site
            "fixedDefault": // (object) optional: the default limits in case CSIP-AUS server is unreachable and there is no default control which may be defined in the connection agreement
            {
                "exportLimitWatts": 1500, // (number) the default export limit in watts
                "importLimitWatts": 1500, // (number) the default import limit in watts
            }
        }
    }
    ...
}

The nmi is not required for Energex/Ergon Energy/Energy Queensland.

Fixed limit

To use a setpoint to specify fixed limits (such as for fixed export limits), add the following property to config.json

{
    "setpoints": {
        "fixed": {
            "connect": true, // (true/false) optional: whether the inverters should be connected to the grid
            "exportLimitWatts": 5000, // (number) optional: the maximum export limit in watts
            "generationLimitWatts": 10000, // (number) optional: the maximum generation limit in watts
            "importLimitWatts": 5000, // (number) optional: the maximum import limit in watts (not currently used)
            "loadLimitWatts": 10000 // (number) optional: the maximum load limit in watts (not currently used)
        }
    }
    ...
}

MQTT

To specify setpoint limits based on a MQTT topic, add the following property to config.json

{
    "setpoints": {
        "mqtt": {
            "host": "mqtt://192.168.1.123",
            "topic": "setpoints"
        }
    }
    ...
}

The MQTT topic must contain a JSON message that meets the following schema

{
    // MQTT control payload for inverter operating mode / limits.
    // All fields are optional: omit fields you are not setting.
    //
    // Units:
    // - *LimW fields are watts (W)
    // - opModConnect/opModEnergize are booleans
    //
    // Typical intent (aligning with earlier docs):
    // - opModConnect: connect/disconnect inverter (or enable/disable grid connection mode)
    // - opModEnergize: energize/enable inverter operation
    // - opModGenLimW: generation limit (W)
    // - opModExpLimW: export limit (W)
    // - opModImpLimW: import limit (W)
    // - opModLoadLimW: load limit (W)

    "opModConnect": true,
    "opModEnergize": true,
    "opModExpLimW": 0,
    "opModGenLimW": 5000,
    "opModImpLimW": 3000,
    "opModLoadLimW": 3500,
}

Negative feed-in

To set a zero export limit setpoint based on negative feed-in, add the following property to config.json

For Amber Electric:

{
    "setpoints": {
        "negativeFeedIn": {
            "type": "amber", // (string) required: the source of the negative feed-in data
            "apiKey": "asdf", // (string) required: the Amber API key
            "siteId": "12345" // (string) optional: the Amber site ID. If not supplied, it will automatically select the first site in the account (will error if there are multiple sites)
        }
    }
    ...
}

Two-way tariffs

To set a zero export limit setpoint based on two-way tariffs, add the following property to config.json

For Ausgrid solar tariff EA029:

{
    "setpoints": {
        "twoWayTariff": {
            "type": "ausgridEA029"
        }
    }
    ...
}

For SAPN RELE2W tariff:

{
    "setpoints": {
        "twoWayTariff": {
            "type": "sapnRELE2W"
        }
    }
    ...
}