Set Static Chargestation Power Limits

Introduction

Operators may prefer to set a default power limit for chargestations. This allows them to have a power ceiling in place for installations that may be power constrained.

eDRV allows admins and developers to set/clear power limits on a chargestation or connectors.

Set a Power Limit for a Chargestation or a Connector

Your application can alter the maximum power or current delivered to an EV (applies to all connectors). You can do this via:

• chargestations/{id}/set_default_power_limit (for a chargestation)
• connectors/{id}/set_default_power_limit (for a connector)

📘

Chargestation vs Connector Power Limits

Chargestation power limits have a higher priority than connector power limits.

Example 1
The following example limits the default max power available to the EV to 75kW.

{
	unit: 'power',
	limit: 75000
}

Example 2
The following example sets the default max current available to the EV to 40 Amperes.

{
	unit: 'current',
	limit: 40
}

Expected Response
A successful API call returns an Actions id as the result._id.

{
    "ok": true,
    "message": "Chargestation Set Default Power Requested",
    "result": {
        "_id": "6401c837dcd98625f00393ed",
        "type": "chargestation.set_power_limit",
        "status": "APIRequested",
        "chargestation": "5f72f55431a6770a131db277",
        "data": {
            "unit": "current",
            "limit": 10,
        },
        "createdAt": "2023-03-03T10:13:11.895Z",
        "updatedAt": "2023-03-03T10:13:11.895Z"
    }
}

{
    "ok": true,
    "message": "Connector Set Default Power Requested",
    "result": {
        "_id": "6401c837dcd98625f00393ed",
        "type": "chargestation.set_power_limit",
        "status": "APIRequested",
        "connector": "5f72f55431a6770a131db277",
        "data": {
            "unit": "current",
            "limit": 10,
        },
        "createdAt": "2023-03-03T10:13:11.895Z",
        "updatedAt": "2023-03-03T10:13:11.895Z"
    }
}

Checking Power Limits

Power limits are reported via webhooks and can be retrieved via:

• GET chargestations/{id}

The following report the set power limits:

• chargestation.configuration.default_power_limit(for a chargestation)
• chargestation.connectors[].configuration.default_power_limit (for a connector)

Clear Power Limits

If your application wants to remove the power / current limit (that you may have set previously) on a chargestation or connector, you can do so via

• chargestations/{id}/clear_default_power_limit (for a chargestation)
• connectors/{id}/clear_default_power_limit (for a connector)

Expected Response

{
    "ok": true,
    "message": "",
    "result": {
        "_id": "630cc4efb8d8867b16ca693b",
        "type": "chargestation.clear_power_limit",
        "status": "requested",
        "chargestation": "601d3fbd50189514b894676e",
        "data": {},
        "createdAt": "2022-08-29T13:53:51.784Z",
        "updatedAt": "2022-08-29T13:53:51.784Z"
    }
}

{
    "ok": true,
    "message": "",
    "result": {
        "_id": "630cc4efb8d8867b16ca693b",
        "type": "connector.clear_power_limit",
        "status": "requested",
        "connector": "601d3fbd50189514b894676e",
        "data": {},
        "createdAt": "2022-08-29T13:53:51.784Z",
        "updatedAt": "2022-08-29T13:53:51.784Z"
    }
}

Webhooks

Your application should monitor the following Webhook Events when using set_power_limit or clear_power_limit for a chargestation or a connector.

chargestation.set_power_limit.requested or chargestation.clear_power_limit.requested

A request has been sent to the chargestation

chargestation.set_power_limit.completed or chargestation.clear_power_limit.completed

The chargestation accepted the request and has begun processing it

chargestation.set_power_limit.failed or chargestation.clear_power_limit.failed

The chargestation rejected the request. See response data for any error details reported by the chargestation

📘

Do you need help with Smart Charging?

Do reach out to the eDRV team via chat or email for help for your specific Smart Charging use case.