OcppTool 2.0 -- Användarmanual

Vad är OcppTool?

OcppTool är ett diagnostikverktyg för EV-laddstationer. Det agerar som en OCPP Central System-simulator -- din laddstation ansluter till verktyget via WebSocket, och du kan övervaka och styra stationen i realtid.

Protokoll som stöds: OCPP 1.6 JSON.

Komma igång

Ansluta en laddstation

Konfigurera din laddstation att ansluta till OcppTools WebSocket-endpoint:

<protocol>://ocpptool.waybler.com/ocpp16/<ChargeBoxIdentity>

| Parameter | Värde | |-----------|-------| | <protocol> | wss (krypterat) eller ws (okrypterat) | | <ChargeBoxIdentity> | Stationens unika identifierare, t.ex. MAC-adress |

Exempel:

wss://ocpptool.waybler.com/ocpp16/AA:BB:CC:DD:EE:FF

När stationen ansluter dyker den upp som ett kort i sidofältet.

Gränssnittet

Appbar

Överst finns en appbar med:

  • Hem -- Tillbaka till dashboarden
  • Temaväljare -- Växla mellan ljust och mörkt tema
  • Inställningar -- Backend-inställningar (RFID, endpoints)
  • Hjälp -- Denna manual
  • Version -- Visas bredvid appnamnet

Dashboard

Huvudvyn har tre möjliga paneler:

  • Vänster sidofält -- Listar alla anslutna stationer som kort med ID, tillverkare/modell och konnektorstatus. Klicka på ett kort för att välja station. Sidofältet kan fällas ihop med pilen.
  • Huvudyta -- Visar vald stations översikt, meddelanden och drill-down-vyer.
  • Höger inspektörspanel -- Visas när ett meddelande inspekteras och låses fast (se Meddelanden nedan).

Stationer kan döljas via ögon-ikonen på kortet. Dolda stationer visas längst ner i sidofältet och kan tas fram igen.

Vald station och dolda stationer sparas i webbläsarens lokala lagring.

Stationsvyn

När en station är vald visas allt i en sammanhängande vy utan flikar.

Stationskortet

Överst visas stationsinformation och kommandon:

  • Status -- Stationens övergripande status med felkod om tillämpligt
  • Stationsinformation -- Tillverkare, modell, serienummer, ICCID och anslutningstid. Om inget BootNotification har mottagits visas en varning.
  • Kugghjulsikon -- Öppnar stationens konfigurationsvy
  • Stationskommandon -- Soft Reset, Hard Reset och Koppla från
  • Skicka meddelanden-länk -- Navigerar till vyn för att skicka valfria OCPP-meddelanden

Konnektorkort

Under stationskortet visas kompakta kort för varje fysisk kontakt (C1, C2, ...). Korten placeras sida vid sida och svämmar över till nya rader vid behov.

Varje konnektorkort visar:

  • Status -- Available, Charging, Faulted etc. med färgkodad kant
  • Aktiv transaktion -- Visas när laddning pågår
  • Live-mätvärden -- Effekt, ström, spänning och energiförbrukning
  • Grafer -- Linjediagram för mäthistorik. Klicka på grafen för att öppna detaljerad mätdatavy.
  • Laddkontroll -- Ställ in effektgräns (ampere eller watt) och antal faser
  • Snabbknappar:

| Knapp | Beskrivning | |-------|-------------| | Starta | Startar en laddtransaktion (RemoteStartTransaction) | | Stoppa | Stoppar pågående transaktion (RemoteStopTransaction) | | Ändra effekt | Sätter effektgräns via laddprofil (SetChargingProfile) | | Lås upp | Låser upp konnektorn (UnlockConnector) |

Meddelanden

Under stationskortet visas en fullständig meddelandetabell med tidsstämpel, riktning, meddelandetyp och payload.

Heartbeat-meddelanden döljs som standard via en checkbox.

Export -- Nedladdningsmeny (ikon uppe till höger) med tre format:

| Format | Användning | |--------|-----------| | JSON | Maskinläsbart, med timestamp, direction, payload och rå OCPP-frame | | CSV | Öppnas direkt i Excel, semikolonseparerad med UTF-8 BOM | | Text | Dokumentationsvänligt, med stationsinfo och formaterad payload |

Inspektör -- Klicka på ett meddelande för att öppna inspektören som en panel utmed hela högerkanten. Visar formaterad JSON-payload och rå OCPP-frame.

Inspektören kan låsas fast med nål-ikonen. Då blir den en permanent höger-sidebar bredvid allt innehåll, liksom stationslistan till vänster. Klicka nålen igen för att lossa den.

Riktningsindikatorer:

| Symbol | Betydelse | |--------|-----------| | ◂ | Inkommande (CP -> CS) | | ▸ | Utgående (CS -> CP) | | ✕ | Fel |

Drill-down-vyer

Från översikten kan du navigera till detaljvyer via länkar och ikoner. En tillbaka-pil i headern tar dig tillbaka.

Skicka meddelanden

Skicka valfria OCPP 1.6-meddelanden till stationen. Editorn validerar mot OCPP-schemat.

Snabbkommandon -- Förprogrammerade makroknappar som fyller i action och payload med ett klick:

| Makro | Kommando | |-------|----------| | Reset | Reset (Soft) | | Clear Cache | ClearCache | | Clear Profiles | ClearChargingProfile | | Trigger | TriggerMessage (BootNotification) | | Set Available | ChangeAvailability (Operative) | | Set Unavailable | ChangeAvailability (Inoperative) | | Composite Schedule | GetCompositeSchedule | | Get Diagnostics | GetDiagnostics (med FTP-URL) | | Update Firmware | UpdateFirmware |

Klicka på ett makro för att fylla i editorn, justera parametrar vid behov, och skicka.

Aktionsväljare -- Välj valfritt OCPP-kommando från grupperade kategorier.

JSON-editor -- Redigera meddelandet i visuellt läge eller som rå JSON.

Kontextchips -- Visar aktiva transaktioner och tillgängliga konnektorer.

Svar -- Stationens svar visas med svarstid i millisekunder. Timeout är 30 sekunder.

Konfiguration

Visa och redigera stationens konfigurationsnycklar. Nås via kugghjulsikonen på stationskortet.

Nycklarna visas grupperade efter OCPP 1.6-profil (Core, Local Auth, Smart Charging, Reservation). Nycklar som inte matchar standarden visas under "Tillverkarspecifikt". Varje standardnyckel har en kort beskrivning.

  • Hämta konfiguration -- Laddar alla nycklar från stationen
  • Sök -- Filtrera på namn, värde eller beskrivning
  • Redigera -- Klicka på pennan för att redigera (read-only markeras med lås)
  • Boolean-värden -- Visas som switch och kan togglas direkt. Formatet (true/false vs True/False) bevaras
  • Exportera -- Ladda ner hela konfigurationen som JSON-fil

Referensjämförelse -- Jämför aktuell konfiguration mot en sparad referens:

  1. Hämta konfiguration och klicka ↔-menyn → "Spara som referens"
  2. Referensen sparas i webbläsaren och laddas automatiskt nästa gång
  3. Nycklar som skiljer sig markeras med gul bakgrund och visar referensvärdet
  4. Klicka synk-ikonen (↻) för att skicka referensvärdet till stationen
  5. Filtrera till "Visa bara skillnader" för att snabbt se vad som avviker
  6. En exporterad JSON-fil kan laddas som referens via "Ladda referens från fil"

Mätdata

Detaljerad vy per konnektor. Nås genom att klicka på graferna i konnektorkortet.

  • Sammanfattningskort -- Energi, delta-energi, effekt, ström, spänning, temperatur, SoC
  • Grafer -- Större linjediagram grupperade per mätkategori med upp till 200 mätpunkter
  • Detaljerad tabell -- Alla mätpunkter med measurand, fas, värde, enhet och kontext

Inställningar

Nås via kugghjulsikonen i appbaren.

RFID-taggar

Hantera taggar för Authorize- och StartTransaction-meddelanden.

Tabellen visar alla taggar som stationerna har använt, med policy (Accepted/Rejected), antal användningar och senast sedd. Klicka på policyn för att växla.

Taggen OcppTool är alltid accepterad och kan inte tas bort. Okända taggar accepteras automatiskt.

BootNotification-svar

Ställ in vilken status och heartbeat-intervall som OcppTool svarar med på BootNotification.

WebSocket-endpoints

Visar de tillgängliga endpoint-sökvägarna.

Så fungerar det

OcppTool agerar som ett OCPP Central System. Stationen initierar en WebSocket-anslutning och skickar meddelanden enligt OCPP 1.6 JSON-protokollet.

Automatiska svar -- OcppTool svarar automatiskt på:

| Meddelande | Svar | |------------|------| | BootNotification | Accepted (heartbeat 30s) | | Heartbeat | Aktuell tid | | StatusNotification | Bekräftelse | | MeterValues | Bekräftelse | | Authorize | Kontrollerar RFID-policy | | StartTransaction | Kontrollerar RFID-policy | | StopTransaction | Accepted |

Manuella kommandon -- Alla kommandon du skickar via Skicka meddelanden eller snabbknapparna går som OCPP Call-meddelanden till stationen.

Felsökning

Stationen ansluter inte

  1. Kontrollera att WebSocket-URL:en är korrekt, inklusive ChargeBoxIdentity
  2. Kontrollera att stationen har nätverksåtkomst till OcppTool-servern
  3. Se till att stationen skickar rätt subprotokoll: ocpp1.6

Stationen kopplar från omedelbart

  • Kontrollera att stationens OCPP-version matchar endpointen (1.6)
  • Kontrollera eventuella TLS/certifikat-problem om wss:// används

Kommandon får inget svar

  • Vissa stationer stödjer inte alla kommandon
  • Kontrollera svarstiden i Skicka meddelanden (timeout 30s)
  • Använd inspektören för att se om ett felmeddelande returnerades

Stationen syns inte i sidofältet

  • Ladda om sidan (F5) — stationer som anslöt innan sidan öppnades visas efter reload
  • Kontrollera att stationen inte är dold (kolla "gömda" längst ner i sidofältet)