AOS Simulator

1. Architecture Overview

AOS Simulator는 충전 인프라 테스트를 위한 통합 플랫폼입니다. CSMS(Charging Station Management System), 충전기 시뮬레이터, 테스트 자동화 엔진이 하나의 서버에 통합되어 있습니다. AOS Simulator is an integrated platform for EV charging infrastructure testing. It combines a CSMS (Charging Station Management System), charger simulator, and test automation engine into a single server.

Core Components

2. Operating Modes

시뮬레이터는 3가지 모드로 동작합니다: The simulator operates in 3 modes:

Mode Comparison

Proxy Mode Flow

Standalone Mode Flow

OCPP Protocol Versions (1.6 / 2.0.1 Dual Support)

시뮬레이터의 모든 모드(LOCAL/Proxy/Standalone)가 OCPP 1.6 과 2.0.1 을 듀얼 지원합니다. SIM connect 시 protocol 옵션으로 선택 (default 2.0.1). All modes (LOCAL/Proxy/Standalone) support both OCPP 1.6 and 2.0.1. Select via the protocol option when connecting (default 2.0.1).

3. Quick Start

Local Development

# Install dependencies
npm install

# Run in local CSMS mode
node server.js

# Run in proxy mode (upstream CSMS required)
UPSTREAM_CSMS_URL=ws://cpos-websocket:8080 node server.js

서버가 시작되면 http://localhost:3000에서 Web UI에 접속할 수 있습니다. Once the server starts, access the Web UI at http://localhost:3000.

테스트 시나리오 실행Run a Test Scenario

# Run a single test scenario
curl -X POST 'http://localhost:3000/api/test/run' \
  -H 'Content-Type: application/json' \
  -d '{"scenarioId":"TC_B_01","chargerId":"CP001"}'

# Response: {"runId":"run-...","status":"passed"}

4. Configuration

Environment Variables

5. Web UI Guide

AOS의 Web UI는 3개 섹션으로 구성됩니다: AOS Web UI consists of 3 sections:

CSMS Section

OCPP 2.0.1 표준 기능을 제공하는 기본 제품 영역입니다. Core product area providing OCPP 2.0.1 standard features.

• Dashboard — 연결된 충전기, 트랜잭션, 시스템 상태 실시간 모니터링Real-time monitoring of chargers, transactions, system status
• Chargers — 충전기 목록/상태 관리, Proxy Mode 동적 설정 (외부 CSMS 연결 → 역제어), Auto Discovery(Redis), CSMS/SIM/Backend 소스 구분Charger list/status, dynamic Proxy Mode (connect to external CSMS for remote control), Auto Discovery via Redis, CSMS/SIM/Backend source badges
• Remote Control — Simulator/Backend 탭으로 29가지 OCPP 명령 실행Execute 29 OCPP commands via Simulator/Backend tabs
• Smart Charging — 충전 프로파일, 전력 분배(DLM)Charging profiles, power distribution (DLM)
• Authorization — 인증 토큰 관리, Local Authorization ListToken management, Local Authorization List
• Reservations — 충전기 예약 관리Charger reservation management
• Configuration — GetVariables, SetVariables, GetBaseReportGetVariables, SetVariables, GetBaseReport
• Security — 인증서 관리, Basic Auth 설정Certificate management, Basic Auth settings
• Firmware — 펌웨어 업데이트 관리Firmware update management
• Meter Values — 실시간 미터 데이터 (에너지, 전력, 전압, 전류, SoC)Real-time meter data (energy, power, voltage, current, SoC)
• Diagnostics — 변수 모니터링, 진단Variable monitoring, diagnostics
• Display Messages / Tariff & Cost / Data Transfer

AOS Testing Section

충전기 시뮬레이션 및 테스트 자동화 도구입니다. Charger simulation and test automation tools.

• Virtual Chargers — 사내 서버에 영구 저장되는 가상 충전기 프로필 (chargerId, csmsUrl, OCPP 버전, 자격증명). 한 번 등록하면 SIM/Test Runner에서 즉시 재사용. data/charger-profiles.json 공유.Persistent virtual charger profiles stored on internal server (chargerId, csmsUrl, OCPP version, credentials). Register once and reuse from SIM/Test Runner. Shared via data/charger-profiles.json.
• Charger Simulator — 단일 충전기 수동 테스트 (WebSocket 연결, Quick Actions, Transaction Events). OCPP 1.6/2.0.1 토글 + 프로필 즉시 불러오기/저장.Single charger manual testing (WebSocket, Quick Actions, Transaction Events). OCPP 1.6/2.0.1 toggle + instant load/save profile.
• Test Runner — 테스트 시나리오 자동 실행 (개별/배치), 카테고리 필터링. 혼용 batch 자동 분할: OCPP 1.6과 2.0.1 시나리오가 섞여 있으면 버전별 그룹으로 자동 분리해 순차 실행 (그룹 경계에서 disconnect → reconnect로 protocol 전환).Test scenario automation (individual/batch), category filtering. Mixed-version batch auto-split: when OCPP 1.6 and 2.0.1 scenarios are mixed, auto-split into per-version groups and run sequentially (protocol switches via disconnect → reconnect at group boundaries).
• AOS Console — OCPP 메시지 편집/전송, 실시간 로그 뷰어, 방향/소스별 필터링OCPP message composer, real-time log viewer, direction/source filtering

AOS Demo Section

데모 시연 및 시각화 도구입니다. Demo and visualization tools.

• Demo Dashboard — 1~500대 다중 충전기 시뮬레이션, 9가지 시나리오 자동 실행1-500 multi-charger simulation, 9 scenario types
• Scenario Flowchart — 충전 시나리오 Swimlane 흐름도Charging scenario Swimlane diagrams
• Mobile App Mock — 모바일 앱 시뮬레이터 (미오픈)Mobile app simulator (not yet available)

6. Standalone CS Mode

How It Works

1. Test Runner가 connectMode: "standalone"으로 시나리오 시작Test Runner starts a scenario with connectMode: "standalone"
2. 시뮬레이터가 ws://cpos-websocket:8080/ocpp201/{chargerId}에 WebSocket 클라이언트로 연결Simulator connects as WebSocket client to ws://cpos-websocket:8080/ocpp201/{chargerId}
3. Basic Auth 헤더 자동 첨부 (사전 설정된 비밀번호 사용)Basic Auth header automatically attached (using pre-configured password)
4. cs_send 스텝으로 CS→CSMS 메시지 전송 (BootNotification, StatusNotification 등)cs_send steps send CS→CSMS messages (BootNotification, StatusNotification, etc.)
5. CSMS 응답 수신 및 검증Receive and validate CSMS responses
6. CSMS에서 보내는 명령 (TriggerMessage 등)에 자동 응답Auto-respond to CSMS commands (TriggerMessage, etc.)
7. 시나리오 완료 후 자동 연결 해제Automatic disconnection after scenario completion

cs_send Step Type

cs_send는 충전기(CS)가 CSMS에 보내는 메시지를 시뮬레이션합니다. cs_send simulates messages sent from charger (CS) to CSMS.

{
  "type": "cs_send",
  "description": "Send BootNotification to CSMS",
  "action": "BootNotification",
  "params": {
    "model": "OCPP-Simulator",
    "vendorName": "Autocrypt",
    "serialNumber": "SIM-001",
    "firmwareVersion": "1.0.0"
  },
  "validate": { "status": "Accepted" },
  "storeAs": "bootResult"
}

Supported CS→CSMS Actions

Standalone Scenario Example

Standalone 시나리오는 connectMode: "standalone"을 지정하고 cs_send 스텝으로 CS→CSMS 메시지를 전송합니다. Standalone scenarios specify connectMode: "standalone" and use cs_send steps to send CS→CSMS messages.

{
  "id": "TC_CUSTOM_01",
  "name": "Custom Standalone Test",
  "category": "Custom",
  "connectMode": "standalone",
  "steps": [
    {
      "type": "cs_send",
      "action": "BootNotification",
      "params": { "model": "Simulator", "vendorName": "Autocrypt" },
      "validate": { "status": "Accepted" }
    },
    {
      "type": "cs_send",
      "action": "StatusNotification",
      "params": { "status": "Available", "evseId": 1 }
    }
  ]
}

7. API Reference - CSMS

GET /api/csms/chargers

연결된 충전기 목록 조회List connected chargers

POST /api/csms/send/:chargerId

CSMS→CS 명령 전송Send CSMS→CS command

// Request Body
{ "action": "TriggerMessage", "params": { "requestedMessage": "BootNotification" } }

// Response
{ "success": true, "response": { "status": "Accepted" } }

POST /api/csms/auth/password/:chargerId

충전기 Basic Auth 비밀번호 설정Set charger Basic Auth password

{ "password": "your-secret" }

POST /api/csms/disconnect/:chargerId

충전기 연결 강제 해제Force disconnect charger

GET /api/csms/proxy

현재 프록시 모드 상태 조회 (default upstream + per-charger routes 포함)Get current proxy mode status (includes default upstream and per-charger routes)

// Response
{
  "proxyMode": true,
  "upstreamUrl": "wss://default-csms-host",
  "routes": [
    { "chargerId": "CP001", "upstreamUrl": "wss://customer-a-csms" },
    { "chargerId": "CP002", "upstreamUrl": "wss://customer-b-csms" }
  ]
}

POST /api/csms/proxy

Default upstream CSMS URL 동적 설정/해제. 매핑되지 않은 충전기는 이 URL로 fallback.Set/clear the default upstream CSMS URL. Unmapped chargers fall back to this URL.

// Set default upstream
{ "upstreamUrl": "wss://default-csms-host" }

// Clear default (mapped chargers still proxy via their routes)
{ "upstreamUrl": "" }

GET /api/csms/proxy/routes

충전기별 라우팅 매핑 전체 조회List all per-charger upstream routes

// Response
{ "routes": [
  { "chargerId": "CP001", "upstreamUrl": "wss://customer-a-csms" }
] }

POST /api/csms/proxy/routes

충전기별 라우팅 추가/갱신. 해당 chargerId가 접속하면 default 대신 이 URL로 forward됨.Add or update a per-charger route. The given chargerId will be forwarded to this URL instead of the default upstream.

// Request
{ "chargerId": "CP001", "upstreamUrl": "wss://customer-a-csms" }

// Response
{ "success": true, "chargerId": "CP001", "upstreamUrl": "wss://customer-a-csms" }

DELETE /api/csms/proxy/routes/:chargerId

특정 chargerId 라우팅 매핑 제거. 이후 default upstream으로 fallback.Remove a per-charger route. The chargerId will fall back to the default upstream.

// Response
{ "success": true, "chargerId": "CP001", "deleted": true }

8. API Reference - Test Runner

GET /api/test/scenarios

전체 시나리오 목록 조회 (카테고리별 그룹)List all scenarios (grouped by category)

POST /api/test/run

단일 시나리오 실행Run a single scenario

{
  "scenarioId": "TC_B_01",
  "chargerId": "CP001",
  "connectMode": "proxy"  // "proxy" (default) or "standalone"
}

// Response
{ "runId": "run-1770886031263", "status": "passed" }

GET /api/test/run

현재 실행 중인 테스트 상태 조회 (스텝별 결과 포함)Get current test execution status (includes per-step results)

POST /api/test/run/abort

실행 중인 테스트 중단Abort running test

GET /api/test/history

최근 50건 테스트 실행 이력Last 50 test execution history

9. API Reference - Standalone

POST /api/csms/standalone/connect

수동으로 upstream CSMS에 충전기로 연결Manually connect as charger to upstream CSMS

{
  "chargerId": "CP001",
  "password": "your-password",  // optional (uses saved password if not provided)
  "upstreamUrl": "ws://cpos-websocket:8080"  // optional (uses UPSTREAM_CSMS_URL)
}

POST /api/csms/standalone/disconnect

standalone 연결 해제Disconnect standalone connection

{ "chargerId": "CP001" }

POST /api/csms/standalone/send

수동으로 CS→CSMS 메시지 전송Manually send CS→CSMS message

{
  "chargerId": "CP001",
  "action": "BootNotification",
  "params": { "model": "Test", "vendorName": "Autocrypt" }
}

// Response
{ "success": true, "response": { "status": "Accepted", "interval": 300 } }

10. API Reference - Batch

POST /api/test/batch

여러 시나리오 순차 실행 (배치)Run multiple scenarios sequentially (batch)

{
  "scenarioIds": ["TC_B_01", "TC_B_02", "TC_B_03"],
  "chargerId": "CP001",
  "options": {
    "connectMode": "proxy",
    "stopOnFail": false,
    "resetBetween": true
  }
}

GET /api/test/batch

현재 배치 실행 상태 (시나리오별 결과, 진행률)Current batch execution status (per-scenario results, progress)

POST /api/test/batch/abort

배치 실행 중단Abort batch execution

11. Scenario Format

테스트 시나리오는 test-scenarios/ 디렉토리에 JSON 파일로 저장됩니다. Test scenarios are stored as JSON files in the test-scenarios/ directory.

{
  "id": "TC_X_01",            // Unique ID (filename without .json)
  "name": "Test Case Name",    // Display name
  "category": "X",              // Category letter (A-P)
  "categoryName": "Category",   // Category display name
  "description": "...",         // Description
  "connectMode": "standalone",  // Optional: "proxy" (default) or "standalone"
  "steps": [ ... ]              // Array of step objects
}

12. Step Types

send - CSMS→CS Command

CSMS에서 충전기로 명령 전송. Proxy/Local 모드에서 사용. Send command from CSMS to charger. Used in Proxy/Local modes.

{
  "type": "send",
  "action": "RequestStartTransaction",
  "params": { "idToken": "AABBCCDD", "evseId": 1 },
  "validate": { "status": "Accepted" },
  "viaBackend": true,  // Optional: route through csms-backend API
  "storeAs": "startResult"
}

cs_send - CS→CSMS Message

충전기에서 CSMS로 메시지 전송. Standalone 모드 전용. Send message from charger to CSMS. Standalone mode only.

{
  "type": "cs_send",
  "action": "BootNotification",
  "params": { "model": "Sim", "vendorName": "Test" },
  "validate": { "status": "Accepted" },
  "storeAs": "bootResult"
}

wait - Wait for Message

특정 메시지 수신 대기. 양쪽 모드 모두 사용 가능. Wait for a specific message. Available in all modes.

{
  "type": "wait",
  "match": {
    "action": "StatusNotification",
    "payload": { "connectorStatus": "Available" }  // partial match
  },
  "timeout": 30000,
  "triggerMessage": "StatusNotification",  // Optional: send TriggerMessage to prompt CS
  "triggerDelay": 10000,  // Optional: delay before TriggerMessage (default: 10s proxy, 0s local)
  "storeAs": "statusAvailable"
}

triggerMessage Mechanism

triggerMessage가 설정되면, 먼저 wait 리스너를 등록한 후 TriggerMessage 명령을 CSMS→CS로 발송하여 충전기가 해당 메시지를 보내도록 유도합니다. When triggerMessage is set, a wait listener is registered first, then a TriggerMessage command is sent CSMS→CS to prompt the charger to send the expected message.

1. wait 리스너 등록 (레이스 컨디션 방지를 위해 먼저 등록)Register wait listener first (to prevent race conditions)
2. triggerDelay 만큼 대기 (프록시 모드 기본 10초 — 자연 발생 기회 부여)Wait for triggerDelay (default 10s in proxy mode — allows natural occurrence)
3. TriggerMessage(requestedMessage) CSMS→CS 전송Send TriggerMessage(requestedMessage) CSMS→CS
4. CS가 해당 메시지 발송 → wait 매칭 → 스텝 성공CS sends the message → wait matches → step passes

delay - Time Delay

{ "type": "delay", "duration": 2000 }

reusable_state - Expand Reusable State

{ "type": "reusable_state", "state": "BootedAndAvailable" }

13. Reusable States

test-scenarios/_reusable-states.json에 정의된 재사용 가능한 스텝 시퀀스: Reusable step sequences defined in test-scenarios/_reusable-states.json:

14. Docker Build

# Build for Linux/AMD64 (AKS)
docker build --platform linux/amd64 \
  -t csmsdevacr.azurecr.io/ocpp-simulator:latest .

# Login to ACR (if auth expired)
az acr login --name csmsdevacr

# Push image
docker push csmsdevacr.azurecr.io/ocpp-simulator:latest

15. AKS Deployment

# Rolling restart
kubectl rollout restart deployment/ocpp-simulator -n ceer-ocpp

# Check status
kubectl rollout status deployment/ocpp-simulator -n ceer-ocpp

# View logs
kubectl logs deployment/ocpp-simulator -n ceer-ocpp --tail=50

# Verify scenarios loaded
kubectl logs deployment/ocpp-simulator -n ceer-ocpp | grep "Loaded"
# [TEST] Loaded 11 reusable states
# [TEST] Loaded 240 test scenarios (v2.0.1: 231, v1.6: 9)

K8s Environment (k8s-deploy.yaml)

env:
  - name: UPSTREAM_CSMS_URL
    value: "ws://cpos-websocket:8080"
  - name: UPSTREAM_REDIS_URL
    value: "rediss://:PASSWORD@redis-host:6380"
  - name: CSMS_BACKEND_URL
    value: "http://csms-backend.csms.svc.cluster.local:8000"
  - name: BASE_PATH
    value: "/simulator/"

Ingress Configuration

WebSocket 프록시를 위해 다음 Nginx Ingress 어노테이션이 필요합니다: The following Nginx Ingress annotations are required for WebSocket proxy:

annotations:
  nginx.ingress.kubernetes.io/proxy-http-version: "1.1"
  nginx.ingress.kubernetes.io/proxy-read-timeout: "3600"
  nginx.ingress.kubernetes.io/proxy-send-timeout: "3600"
  nginx.ingress.kubernetes.io/websocket-services: ocpp-simulator

16. Scenario Compatibility

총 240개 시나리오 (OCPP 2.0.1: 231개 + OCPP 1.6: 9개)의 Smart Charger(로컬 CSMS 모드) 호환성 분류입니다. Total 240 scenarios (OCPP 2.0.1: 231, OCPP 1.6: 9). Smart Charger (Test용 CSMS API Server mode) compatibility breakdown.

물리적 한계 시나리오 (19개)Physical Limitation Scenarios (19)

CS 자율 Authorize 필요 (12개)CS-initiated Authorize Required (12)

RFID 카드 태그, PIN 입력, eMAID 등 사용자 물리 행위로 CS가 자발적으로 Authorize를 전송해야 합니다. OCPP 스펙에 TriggerMessage(Authorize)가 없어 CSMS에서 유도할 수 없습니다. CS must autonomously send Authorize via physical user actions (RFID card tap, PIN input, eMAID). OCPP spec lacks TriggerMessage(Authorize), so CSMS cannot trigger it.

기타 물리적 한계 (7개)Other Physical Limitations (7)

Smart Charger 자동 동작Smart Charger Auto Behavior

Smart Charger(charger-client.js)는 CSMS 명령에 대해 자동으로 응답하고 후속 메시지를 전송합니다: Smart Charger (charger-client.js) auto-responds to CSMS commands and sends follow-up messages:

데모 시뮬레이션 Demo Simulation

구성 Architecture

각 충전기는 실제 OCPP 2.0.1 메시지를 전송합니다. CSMS WebSocket 서버를 거쳐 CSMS Backend에 트랜잭션, 미터값이 기록되므로 CSMS Frontend에서 세션 이력을 조회할 수 있습니다. Each charger sends real OCPP 2.0.1 messages. Transactions and meter values are recorded in CSMS Backend via CSMS WebSocket server, so session history is viewable in CSMS Frontend.

충전기 모델 분류 (20대 기준) Charger Model Distribution (20 units)

9가지 충전 시나리오 9 Charging Scenarios

시나리오별 OCPP 메시지 흐름 OCPP Message Flow per Scenario

SC-01 RFID

SC-06 Error

SC-08 Suspended EV

데모 대시보드 사용법 Demo Dashboard Guide

시작하기Getting Started

사이드바 → Demo → Demo Dashboard에서 실행합니다. Navigate to Demo → Demo Dashboard in the sidebar.

Start 버튼 클릭 → 충전기가 배치로 접속 → 시나리오 자동 실행 → Stop으로 중지. Click Start → chargers connect in batches → scenarios run automatically → Stop to halt.

대시보드 구성Dashboard Layout

Demo API Reference Demo API Reference

POST /api/demo/start

데모 시뮬레이션 시작Start demo simulation

// Request body (all optional, defaults shown)
{
  "count": 20,
  "csmsUrl": "wss://your-csms-host/ocpp201",
  "batchSize": 10,
  "maxMsgPerSec": 20
}

POST /api/demo/stop

데모 중지 및 전체 충전기 접속 해제Stop demo and disconnect all chargers

GET /api/demo/status

현재 데모 상태 (running, 충전기 수, 시나리오 카운트 등)Current demo status (running, charger counts, scenario stats)

GET /api/demo/chargers

전체 충전기 상태 목록 (status, scenario, energy, power, SoC)All charger states (status, scenario, energy, power, SoC)

GET /api/demo/charger/{id}

개별 충전기 상세 상태Individual charger detail

POST /api/demo/remote-start

모바일 앱 Mock에서 원격 충전 시작Remote start from Mobile App Mock

{ "chargerId": "DEMO-011", "userId": "USER-001" }

POST /api/demo/remote-stop

원격 충전 종료Remote stop charging

{ "chargerId": "DEMO-011" }

GET /api/demo/users

생성된 데모 사용자 목록 (userId, name, rfidToken, emaId)Generated demo users list

GET /api/demo/nearby

위치 기반 주변 충전기 검색Location-based nearby charger search

// Query params
?lat=37.4979&lng=127.0276&radius=5

실기 충전기 접속 가이드 Real Charger Connection Guide

1. WebSocket 접속 정보 1. WebSocket Connection Details

2. 접속 예시 2. Connection Example

WebSocket 클라이언트 (Python)WebSocket Client (Python)

# pip install websockets
import asyncio, websockets, json

async def connect():
    uri = "wss://your-csms-host/ocpp/MY_CHARGER_001"
    async with websockets.connect(uri, subprotocols=["ocpp2.0.1"]) as ws:
        # Send BootNotification
        boot = [2, "msg001", "BootNotification", {
            "chargingStation": {
                "model": "ModelX",
                "vendorName": "YourCompany"
            },
            "reason": "PowerUp"
        }]
        await ws.send(json.dumps(boot))
        response = await ws.recv()
        print("Boot response:", response)

        # Send Heartbeat every 60s
        while True:
            hb = [2, "hb001", "Heartbeat", {}]
            await ws.send(json.dumps(hb))
            await asyncio.sleep(60)

asyncio.run(connect())

필수 메시지 시퀀스Required Message Sequence

3. 접속 확인 방법 3. Verifying Connection

충전기가 접속되면 시뮬레이터 웹 UI에서 확인할 수 있습니다. Once connected, you can verify via the simulator web UI.

자동 발견 API 응답 예시Auto-discovery API Response Example

// POST /api/backend/chargers/discover
{
  "success": true,
  "chargers": [
    {
      "chargerId": "TD_CHARGER_001",
      "protocol_version": "2.0.1",
      "connected_at": "2026-03-20T04:38:30.626Z",
      "last_heartbeat": "2026-03-20T04:58:37.500Z",
      "pod_name": "cpos-websocket-69896b7988-57v8b"
    }
  ]
}

실기 충전기 역제어 (Remote Control) Real Charger Remote Control

접속이 확인된 충전기에 CSMS → 충전기 방향으로 OCPP 명령을 전송할 수 있습니다. You can send OCPP commands from CSMS to connected chargers.

웹 UI 사용법 Using Web UI

사이드바 → Backend (실기) → 역제어 페이지에서 직접 명령을 전송합니다. Navigate to Backend (실기) → 역제어 in the sidebar to send commands.

지원 명령 목록 Supported Commands

역제어 API 사용 예시 Remote Control API Examples

TriggerMessage (StatusNotification 요청)

# 충전기에 StatusNotification 전송 요청
curl -X POST http://20.2.210.133/api/backend/send/TD_CHARGER_001 \
  -H "Content-Type: application/json" \
  -d '{
    "action": "TriggerMessage",
    "params": { "requestedMessage": "StatusNotification" }
  }'

# Response
{ "success": true, "data": "" }

RequestStartTransaction (원격 충전 시작Remote Start)

curl -X POST http://20.2.210.133/api/backend/send/TD_CHARGER_001 \
  -H "Content-Type: application/json" \
  -d '{
    "action": "RequestStartTransaction",
    "params": {
      "idToken": { "idToken": "TESTCARD001", "type": "ISO14443" },
      "remoteStartId": 12345,
      "evseId": 1
    }
  }'

GetVariables (HeartbeatInterval 조회Read HeartbeatInterval)

curl -X POST http://20.2.210.133/api/backend/send/TD_CHARGER_001 \
  -H "Content-Type: application/json" \
  -d '{
    "action": "GetVariables",
    "params": {
      "getVariableData": [{
        "component": { "name": "OCPPCommCtrlr" },
        "variable": { "name": "HeartbeatInterval" }
      }]
    }
  }'

Reset (충전기 재부팅Reboot Charger)

curl -X POST http://20.2.210.133/api/backend/send/TD_CHARGER_001 \
  -H "Content-Type: application/json" \
  -d '{ "action": "Reset", "params": { "type": "Immediate" } }'

Backend API Reference Backend API Reference

실기 충전기 관리를 위한 REST API 목록입니다. REST API reference for real charger management.

충전기 관리Charger Management

GET /api/backend/config

Backend 설정 상태 조회 (CSMS WebSocket, Redis 연결 여부)Check backend configuration status (CSMS WebSocket, Redis connectivity)

POST /api/backend/chargers/discover

Redis에서 접속 중인 충전기 자동 발견 및 등록Auto-discover connected chargers from Redis and register them

// Response
{
  "success": true,
  "chargers": [
    { "chargerId": "TD_CHARGER_001", "connected_at": "...", "last_heartbeat": "..." }
  ]
}

GET /api/backend/chargers

등록된 충전기 목록 + 상태 조회List registered chargers with status

POST /api/backend/chargers

충전기 수동 등록Manually register chargers

// Request body
{ "chargerIds": ["CP001", "CP002"] }

GET /api/backend/chargers/{id}/status

개별 충전기 실시간 상태 조회 (CSMS WebSocket 서버 직접 확인)Check individual charger's real-time status via CSMS WebSocket server

DELETE /api/backend/chargers/{id}

충전기 등록 해제Unregister a charger

역제어 (명령 전송)Remote Control (Send Commands)

POST /api/backend/send/{chargerId}

CSMS WebSocket 서버를 통해 충전기에 OCPP 명령을 전송합니다.Send OCPP commands to charger via CSMS WebSocket server.

// Request body
{
  "action": "TriggerMessage",
  "params": { "requestedMessage": "StatusNotification" }
}

// Success response
{ "success": true, "data": { ... } }

// Error response
{ "success": false, "message": "error description" }

트러블슈팅Troubleshooting