EVSE Profiles¶

When you launch the DER Simulator with --ocpp_enable=yes, the --evse_profile flag tells the simulator which EVSE topology to present: how many connectors, what charging power, AC vs. DC, V2G support, and the backing battery capacity. Six profiles ship in the box; you can also point at any custom JSON file with the same shape.

This page walks each bundled profile with a copy-paste command line you can use against your CSMS.

Bundled profiles¶

The default when you omit --evse_profile is the single-port EVSE-AC-22kW-1port — small and quick to verify your CSMS connectivity before scaling up.

Single AC port — Level 2 (22 kW, 1 connector)¶

Common starting point. Boots fast and exercises the OCPP handshake without any multi-port arbitration noise:

./sim --ocpp_enable yes \
      --ocpp_version ocpp1.6j \
      --ocpp_csms_url ws://localhost:8180/steve/websocket/CentralSystemService \
      --ocpp_csid DERSIM-LAB-1 \
      --evse_profile EVSE-AC-22kW-1port.json

Use case: validating BootNotification, Authorize, StartTransaction, StopTransaction round-trips against a fresh CSMS install.

Dual AC — multi-port arbitration (7.4 kW × 2)¶

The simplest profile that exercises the multi-port power-sharing arbiter. Both ports share a single 14 kWh battery; plug in two vehicles at once and the simulator splits power proportionally to each port's demand:

./sim --ocpp_enable yes \
      --ocpp_version ocpp2.0.1j \
      --ocpp_csms_url ws://localhost:8081/ocpp \
      --ocpp_csid DERSIM-DUAL-1 \
      --evse_profile EVSE-AC-7.4kW-2port.json

Use case: aggregator-side load-balancing tests, OCPP 2.0.1 TransactionEvent ordering across concurrent sessions.

Single DC fast charger (150 kW)¶

Real-world highway-corridor topology. The charging curve from the plugged-in vehicle drives the actual MeterValues, so the SoC ramp mirrors what a real EV would do:

./sim --ocpp_enable yes \
      --ocpp_version ocpp2.0.1j \
      --ocpp_csms_url ws://localhost:8081/ocpp \
      --ocpp_csid DERSIM-DC-1 \
      --evse_profile EVSE-DC-150kW-CCS-1port.json

Use case: SmartCharging conformance — install a TxProfile and watch the simulator honor the limit; observe ChargingState transitions (charging → suspended_evse near full SoC).

Dual DC ultra-fast (350 kW × 2)¶

Truck-stop / fleet topology. Two 350 kW ports sharing a 700 kWh battery. Power-sharing kicks in hard once both ports are active — useful for testing MeterValues.allocated_kw reporting:

./sim --ocpp_enable yes \
      --ocpp_version ocpp2.1 \
      --ocpp_csms_url ws://localhost:8081/ocpp \
      --ocpp_csid DERSIM-DC-MAX-1 \
      --evse_profile EVSE-DC-350kW-CCS-2port.json

Use case: stress-testing CSMS handling of high-volume MeterValues streams; OCPP 2.1 DER control under load.

Hybrid station (2× DC + 1× AC)¶

Mixed-type station modeled on a Tesla Supercharger-style site with an AC option for slower charging. Three connectors sharing a 200 kW group budget and 400 kWh of battery backing:

./sim --ocpp_enable yes \
      --ocpp_version ocpp2.0.1j \
      --ocpp_csms_url ws://localhost:8081/ocpp \
      --ocpp_csid DERSIM-HYBRID-1 \
      --evse_profile EVSE-Hybrid-2DC-1AC.json

Use case: CSMSes that need to support heterogeneous connector types on a single station; per-connector capability reporting.

Bidirectional V2G (50 kW)¶

Vehicle-to-Grid discharge testbed. The profile advertises the DC_BPT energy-transfer mode and the simulator's MeterValues report Power.Active.Export when the EV is discharging:

./sim --ocpp_enable yes \
      --ocpp_version ocpp2.1 \
      --ocpp_csms_url ws://localhost:8081/ocpp \
      --ocpp_csid DERSIM-V2G-1 \
      --evse_profile EVSE-V2G-DC-50kW-bidir.json

Use case: V2G lab work, IEEE 1547-2018 bidirectional grid-support testing, OCPP 2.1 NotifyAllowedEnergyTransfer exercises.

Picking a profile¶

Quick decision tree:

• First time against a new CSMS? Start with EVSE-AC-22kW-1port — smallest surface, fastest to verify the connection.
• Testing multi-port arbitration? EVSE-AC-7.4kW-2port is the smallest dual-port profile.
• Exercising SmartCharging / DER control? EVSE-DC-150kW-CCS-1port for single-port, EVSE-DC-350kW-CCS-2port for multi-port at scale.
• V2G / IEEE 1547 bidirectional? EVSE-V2G-DC-50kW-bidir.
• Mixed-connector deployments? EVSE-Hybrid-2DC-1AC.

Custom profiles¶

You can also point --evse_profile at a JSON file you've written yourself. Use any of the bundled profiles as a starting template — copy and modify. The JSON schema is documented in the dersim repo alongside the EvseProfile Pydantic model.