SetNetworkProfile

Configuration CSMS->CS OCPP 2.0.1

Sent by the CSMS to configure a network connection profile on the Charging Station, including CSMS URL, security settings, and network interface parameters.

Quick Reference

Required Fields

configurationSlot integer

Slot number for this network profile (used to select which profile to use)

connectionData NetworkConnectionProfileType

Network connection parameters including CSMS URL and security settings

connectionData.ocppVersion OCPPVersionEnumType

OCPP version: OCPP12, OCPP15, OCPP16, or OCPP20

connectionData.ocppTransport OCPPTransportEnumType

Transport: JSON or SOAP

connectionData.ocppCsmsUrl string(2000)

CSMS WebSocket URL (wss:// for secure)

connectionData.messageTimeout integer

Message response timeout in seconds

connectionData.securityProfile integer

Security profile: 0 (no security), 1 (unsecured + basic auth), 2 (TLS), 3 (TLS + client cert)

Optional Fields

connectionData.ocppInterface OCPPInterfaceEnumType

Network interface: Wired0, Wired1, Wired2, Wired3, Wireless0, Wireless1, Wireless2, Wireless3

connectionData.vpn VPNType

VPN connection parameters

connectionData.apn APNType

Mobile network APN parameters

Example Payload

{
  "configurationSlot": 1,
  "connectionData": {
    "ocppVersion": "OCPP20",
    "ocppTransport": "JSON",
    "ocppCsmsUrl": "wss://csms.example.com/ocpp",
    "messageTimeout": 30,
    "securityProfile": 3
  }
}

Example Full Frame

[
  2,
  "msg-001",
  "SetNetworkProfile",
  {
    "configurationSlot": 1,
    "connectionData": {
      "ocppVersion": "OCPP20",
      "ocppTransport": "JSON",
      "ocppCsmsUrl": "wss://csms.example.com/ocpp",
      "messageTimeout": 30,
      "securityProfile": 3
    }
  }
]

Format: [MessageType, MessageId, Action, Payload]

Open in Builder Go to Validator

Overview

SetNetworkProfile is a powerful message that lets the CSMS reconfigure the Charging Station’s CSMS connection parameters — including the CSMS URL itself, security profile, and network interface.

When to Send

During provisioning to configure the initial CSMS connection
To migrate a station to a new CSMS
To upgrade from security profile 1 to 3 (add TLS client certificates)
To configure a backup CSMS URL in a different slot

Expected Response

status: Accepted, Rejected, or Failed

Security Profiles

Level	Description
0	No security — HTTP Basic Auth only
1	Basic Auth over unsecured WebSocket
2	TLS (server certificate validated by station)
3	Mutual TLS (both server and client certificates)

Usage Notes

configurationSlot allows multiple profiles — the station selects which to use via NetworkConfigurationPriority variable
Changing the CSMS URL will cause the station to reconnect to the new URL
Security profile 3 requires client certificates installed via InstallCertificate

Testing Tips

Set a new CSMS URL in slot 2 and verify the station can connect to it
Test security profile upgrade from 1 to 2 and verify TLS is used after reconnect

Common Errors

`TypeConstraintViolation`

Cause: ocppVersion uses an invalid value

Solution: Use OCPP12, OCPP15, OCPP16, or OCPP20

`PropertyConstraintViolation`

Cause: ocppCsmsUrl exceeds 2000 characters

Solution: Keep the CSMS URL under 2000 characters