Connect a charger
Point a charge point at the GridOS OCPP endpoint and verify BootNotification through a test session.
Use this checklist when bringing a real charge point (or a production-like simulator) onto the GridOS OCPP gateway.
Before you start
- Station exists in the Dashboard with a stable charge point identity
- You know the org’s OCPP endpoint URL and security profile
- Network path allows outbound WebSocket (TLS recommended)
Never paste live OCPP passwords, OCPI tokens, or client certificates into tickets, chat, or public issues. Rotate anything that may have been exposed and use Dashboard or your secret store for operational credentials.
Steps
Collect connection values
Pull identity and endpoint values from the Dashboard before you touch the station UI.
Item Source Charge point id Dashboard charger record (must match device config) CSMS / OCPP URL Dashboard or platform runbook for your environment Auth / certificates Org security profile (basic auth, client cert, etc.) Configure the station
On the charger UI or config interface:
- Set protocol to OCPP JSON (1.6 or 2.0.1 as supported)
- Set the CSMS URL to the GridOS endpoint
- Apply the same security profile Dashboard expects
- Reboot or reconnect so the station opens a new WebSocket
wss://ocpp.example.com/<env>/<charge-point-id>Verify BootNotification
Expected path:
- WebSocket connects
- Station sends
BootNotification - Central system accepts (or pending → accept after config)
- Dashboard shows the station online
If BootNotification is rejected or missing, check identity mismatch, TLS trust, and firewall rules first.
Status and heartbeat
Confirm
StatusNotification(or 2.0.1 status path) and heartbeats so the station stays green in the Dashboard after idle periods.Authorization and a test session
- Authorize with a test idTag (or remote start if enabled)
- Start and stop a short session
- Confirm the session in the Dashboard with sane meter data
Protocol references
| Version | Entry |
|---|---|
| OCPP 1.6 | Overview · Actions · Test cases |
| OCPP 2.0.1 | Overview · Actions |
The left sidebar lists Overview, Actions, and Test cases only (not every message). Open the index pages below or use ⌘K search — hit labels include the protocol version (for example · OCPP 1.6) so same-named actions stay distinct.