FAQ

Три требования для подключения станции:

• у станции есть стабильное интернет-соединение (предпочтительно проводное);
• у станции есть инструмент администрирования, с помощью которого можно изменить URL CSMS;
• на станции установлена актуальная прошивка до первого подключения к CSMS.

Станцию можно обновлять удалённо только после первого подключения. Внимание: обновление прошивки может вызвать сбои или регрессии. Мы всегда рекомендуем сначала проверять прошивку на тестовой станции.

Если станция использует локальную сеть, ИТ-служба должна разрешить исходящий трафик станций на домен charge-angels.com (TCP-порт 443) и отключить исходящий межсетевой экран либо внести IP-адреса нашего сервера в белый список (их нужно запросить у администратора).

Сеть должна быть проводной, когда это возможно, чтобы избежать ограничений по расстоянию и пропускной способности. Допустимая задержка сети должна быть менее 500 мс.

Станции могут использовать несколько способов связи: LAN (Ethernet) или WAN (Wi-Fi). В большинстве случаев станция по умолчанию обращается к DHCP (Dynamic Host Configuration Protocol) локальной сети и автоматически получает IP-адрес; в противном случае IP-адрес нужно задать на станции вручную. Роутер подключается к интернету через провайдера клиента: ADSL, оптоволокно или GSM.

Если вы предпочитаете сеть 4G, вам понадобятся M2M-SIM-карты (для IoT), желательно с роумингом. По объёму данных рассчитывайте 200 кБ на точку зарядки.

• Настройка APN зависит от оператора.
• Предпочтительны SIM-карты с включённым роумингом: лучшая сеть выбирается в реальном времени. Роуминг может действовать по Франции или по всему миру — в зависимости от ваших потребностей.
• В общем случае при интенсивном использовании закладывайте тарифный план на 200 МБ данных на точку зарядки.
• VPN не нужен, если станция обменивается данными по WSS.

ChargeAngels использует защищённое соединение WebSocket (WSS) между станцией и бэкендом. Мы поддерживаем только TLS 1.3 (TLS 1.2 считается устаревшим). ChargeAngels поддерживает SSL-сертификаты RSA и ECDSA. Для обработки WebSocket мы используем Node.js с библиотекой uWebSockets.js.

• Созданный в 2011 году WebSocket (WS) — сетевой протокол прикладного уровня, «двунаправленный, асинхронный и полнодуплексный» между клиентом и сервером, стандартизированный IETF в RFC 6455 и W3C.
• WebSocket открывает постоянное полнодуплексное соединение между клиентом и сервером: в отличие от HTTP, сервер может по собственной инициативе отправлять данные клиенту.
• WebSocket Security (WSS) использует транспортный уровень TLS, как и HTTPS, для шифрования обмена данными, поэтому он безопаснее.

Как описано в спецификации «OCPP 1.6 security whitepaper edition 3», мы поддерживаем:

• Профиль безопасности 1: WS с базовой аутентификацией (пользователь / пароль или ключ авторизации — на ваш выбор);
• Профиль безопасности 2: базовая аутентификация или WSS TLS с корневым сертификатом сервера (ISRG Root X1);
• Профиль безопасности 3: WSS TLS как на стороне точки зарядки, так и на стороне сервера (протестирован, но официально не используется в эксплуатации).

Тесты OCA: тестовые сценарии TC_085_CSMS (базовая аутентификация, допустимая комбинация имени пользователя / пароля), TC_086_CSMS (TLS, действительный серверный сертификат) и TC_087_CSMS (TLS, действительный клиентский сертификат) пройдены с помощью инструмента тестирования Open Charge Alliance.

Ключ авторизации (Authorization Key): не менее 16 символов и шестнадцатеричная кодировка, от 20 до 40 символов.

Рекомендуем всегда проверять первое подключение станции сначала с профилем безопасности 1 (WS), затем с 2 (WS и WSS), затем с 3 (WSS).

Тенант — это подпространство основного домена, например cpo1.charge-angels.com.

• Если вы выбрали решение SaaS, вы организуете свой тенант на вкладке «Организация» в CSMS.
• Если вы выбрали решение Full Cloud, у вас есть доступ к «Master Tenant», и вы можете создавать столько «Cloud Tenant», сколько нужно.

У тенанта общая база пользователей, центральный ключ которой — адрес электронной почты. Его можно разбить на несколько иерархических уровней: компании, площадки и зоны.

• Площадки могут быть разными географическими зонами одного и того же клиента (например, автобусными парками).
• Площадки могут также быть разными субклиентами, использующими общую базу пользователей.
• Зона — это группа станций; она определяет физическую топологию площадки: зона может соответствовать главному низковольтному щиту (TGBT) или подключению по мощности (например, на 220 кВА).
• SmartCharging работает отдельно для каждой зоны (максимальная мощность задаётся на главном щите).

«Токен» — это URL подключения по WSS, который станция использует для соединения с серверами CSMS ChargeAngels. Токен уникален и привязан к одной зоне.

Когда ваша структура создана, вы можете создать один или несколько токенов подключения к бэкенду в меню «Станция», затем «Подключить станцию»: создайте токен, добавьте название, срок действия и зону, затем сохраните.

Токен можно скопировать для немедленного или последующего использования (например, «OCPP 1.6 JSON»). Его можно передать командам, которые устанавливают станции на месте. По соображениям кибербезопасности ChargeAngels, в отличие от других CSMS, использует динамические токены со сроком действия.

Токен (или URL) состоит из 4 частей

• префикс: HTTP / HTTPS / WS или WSS;
• «OCPP16» или «OCPP201» — в зависимости от версии OCPP;
• первая часть токена — уникальный идентификатор тенанта;
• вторая часть — идентификатор самого токена, привязанный к зоне;
• последняя часть — имя станции: ChargeBoxID.

wss://charge-angels.com/OCPP16/<tenant-id>/<token-id>/CHARGER-01

Когда токен скопирован в настройки администрирования станции, станция открывает сокет к серверам CSMS. Станция (здесь CHARGER-01) автоматически появляется в панели управления без каких-либо действий на стороне бэкенда. Когда станция стала видна, измените её атрибуты (максимальная мощность, местоположение, разъёмы и т. д.).

В настройках администрирования некоторых станций URL и ChargeBoxID разбиты на несколько полей: «Host», «Port», «Path» и «ChargeBoxID» (имя станции). Иногда нужно проверить собранный таким образом URL (обратите внимание на разные косые черты).

Именование станций

Рекомендуем ввести правило именования станций. ChargeBoxID связан в базе данных со всей информацией о станции и историей зарядок: изменить его позже без потери этой истории нельзя. Пример правила: «ГОРОД-МЕСТО-СТАНЦИЯ-01». Внимание: ChargeBoxID ограничен 48 символами (ограничение Gireve).

После добавления токена и имени станции она указывает на тенант, токен и, следовательно, на нужную зону. Иногда для применения этих настроек станцию нужно перезагрузить. Пока станция не появилась в панели управления, либо URL составлен неверно, либо станция не в сети: проверьте журналы.

Срок действия токена

CHARGER-01 необходимо ввести в эксплуатацию и подключить с созданным токеном до истечения срока его действия, иначе OCPP BootNotification будет отклонён. После того как бэкенд впервые принял станцию, токен сохраняется в базе данных: даже после истечения срока станция может спокойно перезагружаться.

Рекомендуем хранить токены, даже просроченные: для новых вводов в эксплуатацию достаточно продлить срок их действия. Неиспользуемые токены, напротив, можно удалять — это исключает ошибки.

Советуем следить за журналами ChargeAngels во время ввода в эксплуатацию и регулярно их проверять.

Некоторым станциям нужен корневой сертификат нашего сервера: ISRG Root X1 (Let’s Encrypt). Мы можем предоставить его по запросу, но вы можете получить его и в командной строке Linux или macOS следующей командой:

curl https://letsencrypt.org/certs/isrgrootx1.pem

Скопируйте сертификат, показанный в ответе (ISRG Root X1), вставьте его в текстовый файл и сохраните как «ISRG Root X1.crt». Сохраните его локально и на станции: при перезапуске станция будет использовать этот сертификат и URL WSS для подключения к бэкенду.

Этот сертификат используется в OCPP с профилем безопасности 2 и серверным сертификатом.

Когда станция подключена к бэкенду, вы можете удалённо изменять все параметры OCPP. Некоторые параметры стандартизированы в спецификации OCPP, другие — необязательные или даже собственные.

Список параметров для проверки в зависимости от ваших потребностей:

У некоторых станций есть поле «CSMS URL» и «ChargeBoxID»: оно позволяет удалённо изменить URL бэкенда или имя станции, не заходя в конфигурацию станции на месте.

Вы можете экспортировать все параметры OCPP, чтобы потом сравнить их с параметрами других станций. Некоторые ключи доступны только для чтения.

Первое, за чем нужно следить при вводе в эксплуатацию, — стабильность WebSocket. Открытие WebSocket — исключительно инициатива станции, а не CSMS.

Журналы доступны в разделе «Журнал» CSMS, где можно фильтровать по станции, уровню важности и действию. Полезны два семейства журналов: журналы WebSocket (соединение) и журналы OCPP (обмен сообщениями), подробно описанные в двух следующих вопросах.

Если WebSocket нестабильны (нежелательные открытия и закрытия), станция не может нормально загрузиться по OCPP и оказывается в неопределённом состоянии.

В разделе «Журнал» отфильтруйте действия WsServerConnectionOpen и WsServerConnectionClose.

• WsServerConnectionClose означает, что сокет был закрыт со стороны станции (по её инициативе), например: Close > WS Connection ID 'FsRi9' closed with code '1000', reason: 'Normal closure'.
• У CSMS нет дополнительной информации о причине этого отключения. Чаще всего оно вызвано сбоем сети (время закрытия и открытия тогда одинаково для всех станций) или отключением питания.
• Вы можете следить за числом событий WsServerConnectionClose: их должно быть не больше нескольких в сутки.

CSMS отправляет станции «ping» каждые 60 секунд; если 2 ping-запроса не проходят, мы закрываем WebSocket. Станция также отправляет ping нашему серверу каждые 30 секунд. Частоту ping можно настроить параметром OCPP WebSocketPingInterval.

В разделе «Журнал» можно отфильтровать записи по вашей станции и по нескольким простым действиям, например: OcppBootNotification, OcppStatusNotification, OcppStartTransaction, OcppStopTransaction, OcppMeterValues. Журналы читаются снизу вверх (самая свежая запись — в первой строке).

Существует четыре уровня важности, как и в любой ИТ-системе:

• ERROR: критическая ошибка, не должна появляться никогда;
• WARNING: серьёзное, но без последствий для работы;
• INFO: читаемая (текстовая) информация;
• DEBUG: отладочная информация с запросами и ответами JSON.

В режиме DEBUG детали сообщений включают направление запросов по следующему соглашению:

• << = запрос / ответ от станции к бэкенду;
• >> = запрос / ответ от бэкенда к станции.

То же соглашение действует для JSON-сервера, OCPI, OICP, Batch и внешних API (бэкенд — справа).

Журналы, соответствующие командам OCPP JSON, можно читать и на ещё более низком уровне, просматривая соседние сообщения WebSocket: WsClientMessage для запроса и WsServerMessage для ответа, с уникальным идентификатором (UID) каждого сообщения на стороне CSMS и станции. Например:

Message > Send WS Message Request: '[2,"f3f0e8b8-59a2-4f4c-816a-fce3b059f0a0","ClearChargingProfile",{"connectorId":1}]'

Message > Received WS Message: '[3,"f3f0e8b8-59a2-4f4c-816a-fce3b059f0a0",{"status":"Unknown"}]'

Этот формат иногда нужен для общения с производителями станций при отладке.

В ChargeAngels общая база пользователей на каждый тенант. У пользователей три уровня прав (роли):

• Администратор: все права на тенанте;
• Стандартный: права для конечных клиентов, заряжающих электромобили;
• Администратор площадки: «стандартный» пользователь с правами администрирования одной или нескольких площадок.

Подробное описание прав по ролям приведено в документации по интеграции, доступной по запросу.

Есть также четвёртая роль — «Демо» — для анонимизированного публичного отображения. Для обмена данными между серверами (API) существует отдельная роль: её можно включить у универсального пользователя — «технического пользователя», — который не может входить через фронтенд (веб- или мобильное приложение).

Следующие три вопроса подробно описывают общие правила, назначение на площадки и состояния учётной записи.

Новые пользователи могут создать учётную запись:

• через веб-интерфейс, прямо на странице https://<поддомен>.charge-angels.com/auth/register;
• через мобильное приложение — после сканирования QR-кода организации для клиентов «SaaS» или сразу при открытии приложения для клиентов «Full Cloud».

В обоих случаях они должны принять «Лицензионное соглашение с конечным пользователем» (EULA), как это определено в GDPR (Общий регламент по защите данных).

• Адрес электронной почты — уникальный ключ пользователя в базе данных.
• В целях безопасности пароли хранятся в базе данных в зашифрованном виде: они не видны в открытом виде даже администраторам.
• Пользователь, трижды ввёдший неверный пароль, блокируется; разблокировать учётную запись по запросу может только администратор.
• Пользователь, забывший пароль, может запросить автоматический сброс по электронной почте — в веб-приложении (https://<поддомен>.charge-angels.com/auth/reset-password) или в мобильном приложении («Забыли пароль?»).
• Только администратор может повысить права пользователя «Basic» до «Administrator» или «Basic / Site Administrator». Аналогично, администратор площадки может назначить другого администратора площадки на площадках, за которыми он закреплён.

Поскольку база пользователей общая для тенанта, администратор может выбрать стратегию назначения пользователей на площадки: либо флаг «Автоматически назначать новых пользователей на эту площадку» включён на всех площадках, либо отключён.

1. Флаг отключён: новый пользователь после создания учётной записи не видит ни одной станции. Администратор (или администратор площадки) должен назначить его вручную. Тогда пользователь увидит все точки зарядки площадки и сможет начать зарядную сессию.
2. Флаг включён: новый пользователь назначается на все площадки, где флаг активен; он видит все точки зарядки этих площадок и может начать зарядную сессию. Затем администратор (или администратор площадки) должен снять назначение с пользователей, которые не должны видеть соответствующие площадки.

Примечания:

• Все пользователи «Administrator» по умолчанию назначаются на все площадки, созданные в тенанте.
• Администратор может создать пользователя вручную с паролем по своему выбору. В этом случае он должен также вручную назначить пользователя на площадки, права на которые тот будет иметь.
• Флаг «Эта площадка общедоступна» относится только к сценарию роуминга (Gireve / Hubject).

Вы также можете включить или отключить для всего тенанта стратегию создания новых учётных записей в разделе «Технические настройки» / «Пользователи»:

• если включено: все новые пользователи могут создавать учётную запись автоматически;
• если отключено: вам отправляется push-уведомление и электронное письмо, чтобы вы решили, активировать ли учётную запись. Затем нужно проверить автоматическое назначение на площадки или выполнить его вручную — в зависимости от стратегии, заданной выше.

Если клиент решает создать несколько клиентских учётных записей в одном тенанте, он сам отвечает за правильное управление всеми своими пользователями (прежними и новыми).

Учётная запись пользователя может находиться в нескольких состояниях:

• Активна: включена, пользуется всеми функциями сайта;
• Приостановлена: учётная запись деактивирована администратором, позже её можно снова активировать;
• Неактивна: учётная запись не использовалась более 6 месяцев (нет входов на платформу);
• Заблокирована: автоматическая блокировка после трёх неверных попыток ввода пароля;
• Ожидает: ожидает подтверждения учётной записи администратором.

Автоматический механизм проверяет и деактивирует неактивные учётные записи пользователей на платформе ChargeAngels в соответствии с европейским регламентом GDPR.

Как это работает

Задача выполняется каждый понедельник в полночь (Europe/Paris). Она затрагивает только активных пользователей с ролью Basic (технические учётные записи исключены). Процесс состоит из двух шагов:

1. Предупреждение (после 6 месяцев неактивности): пользователи, не входившие в систему 6 месяцев, получают предупреждающее уведомление — у них есть время войти снова и избежать деактивации.
2. Деактивация (после 7 месяцев неактивности): если через месяц после предупреждения пользователь так и не вошёл в систему, учётная запись автоматически переходит в состояние «Неактивна» и отправляется уведомление об изменении статуса.

Проверяемые критерии: дата последнего входа, дата принятия условий (EULA), дата последней зарядной транзакции. Текущая конфигурация: порог неактивности — 6 месяцев, запуск каждый понедельник в 00:00.

Станцию можно сделать полностью открытой или очень защищённой в зависимости от настроек в ChargeAngels (Организация / Зоны), но прежде всего — от настроек самой станции (и её модели).

Когда контроль доступа отключён на стороне ChargeAngels, независимо от настроек станции ChargeAngels принимает все запуски зарядных транзакций, запрошенные станцией. В этом случае невозможно блокировать отдельных пользователей или выставлять счета.

Когда контроль доступа включён, поведение зависит от настроек станции: FreeVending, RFID, Autocharge или Plug&Charge. ChargeAngels может управлять неограниченным числом токенов типа RFID, eMAID или MAC-адрес — автоматически, вручную или через импорт CSV.

• Gireve определяет токен как строку из 4–7 байт, то есть 8–14 шестнадцатеричных символов. Рекомендуем соблюдать это правило, чтобы роуминг работал корректно. Рекомендуются только NFC/RFID-карты типа MIFARE.
• Когда новый пользователь создаёт учётную запись через веб-интерфейс (https://<поддомен>.charge-angels.com/auth/register) или мобильное приложение, автоматически создаётся виртуальная 4-байтовая карта и назначается этому пользователю.
• Токены можно создавать вручную по одному или через импорт CSV. Если токен создан вручную, администратор должен назначить его пользователю.
• У пользователя может быть неограниченное число токенов, включая токен по умолчанию: именно он автоматически предлагается при запуске зарядной сессии.

Данные, запрашиваемые при создании токена

• Badge ID или UID: код, записанный внутри физической RFID-карты;
• номер карты: видимый номер, нанесённый на RFID-карту;
• описание (произвольный текст);
• пользователь, связанный с картой;
• статус карты;
• карта по умолчанию: та, что автоматически предлагается при запуске зарядной сессии;
• разрешить этой карте запускать несколько зарядок одновременно на разных станциях.

Как добавить физическую карту (или виртуальный eMAID), если я не знаю её UID?

1. В разделе «Журналы» добавьте фильтр по вашей станции и уровню важности ERROR.
2. В фильтре «Действие» найдите действие OcppAuthorize.
3. Приложите карту к станции.
4. Появляется запись ERROR с UID (idTag) в деталях ошибки.

Сохраните этот UID для дальнейшего использования или добавьте его в меню «Карта». Все карты также можно экспортировать кнопкой экспорта.

Импорт CSV

Возможен и импорт в формате CSV с запятой в качестве разделителя: создайте файл XLS с обязательными полями id и visualID и необязательными полями description, limitKwh, email, firstName, name, siteIDs, затем сохраните его как CSV. Проведите тест на нескольких картах, прежде чем импортировать список из тысяч карт.

Производители станций обычно предлагают решения с платёжным терминалом (POS), например такие:

Принцип: POS подключается к станции через последовательный порт (MDB).

1. Водитель подносит банковскую карту к платёжному терминалу, встроенному в станцию (Nayax, Ingenico или Payter).
2. Бэк-офис банковского платёжного сервиса проверяет и авторизует зарядную транзакцию.
3. Платёжный терминал отправляет станции заранее заданный токен для запроса авторизации по протоколу MDB.
4. Станция отправляет бэкенду мониторинга запрос авторизации с токеном и начинает зарядку.

Если всё настроено на стороне POS (облако производителя), при касании банковской картой станция отправляет OCPP StartTransaction с idTag. Этот тег необходимо ввести в параметрах OCPP станции: это не стандартный параметр OCPP, и он различается у разных брендов станций.

Этот тег также должен быть зарегистрирован как виртуальная карта и привязан к виртуальному пользователю (администратору), чтобы мониторинг принимал запрос на зарядку. Этого пользователя необходимо также назначить на соответствующие площадки.

Предварительное условие: настройка тарифов и банковский счёт Stripe. Тарифы можно настроить независимо, не включая биллинг.

Для закрытых и корпоративных автопарков вы можете сразу выдать пользователям:

1. URL для доступа к веб-платформе: https://<поддомен>.charge-angels.com/auth/login;
2. QR-коды мобильного приложения:

3. QR-код вашей «Организации», который запрашивается при создании учётной записи. Чтобы найти его, откройте меню «Технические настройки», затем «Показать QR-код». Сохраните его в файл JPG: он понадобится для создания ваших инструкций для пользователей. Шаблон плаката для настройки и размещения на ваших станциях доступен по запросу.
4. QR-код для каждого разъёма: вы можете создать и отдельный код для каждого разъёма, чтобы начинать зарядку, не ища станцию в мобильном приложении. Список QR-кодов можно экспортировать для каждой площадки в меню Организация / Площадка.

Внимание: QR-коды кодируют полный URL станций (ChargeBoxID и идентификатор разъёма). Переименование станции меняет её QR-код: его потребуется заменить.

Первое, за чем нужно следить при вводе в эксплуатацию, — стабильность WebSocket. Открытие WebSocket — исключительно инициатива станции, а не CSMS. Если WebSocket нестабильны (нежелательные открытия и закрытия), станция не может нормально загрузиться по OCPP и оказывается в неопределённом состоянии.

Если станция не отображается в веб-интерфейсе (панели управления), причин может быть много:

• на станцию не подаётся питание (отключение) или она находится в неопределённом состоянии;
• станция не подключена или больше не подключена к сети;
• станция работает через защищённую сеть (исходящий межсетевой экран);
• станция работает через локальную сеть: роутер LAN или WAN;
• подключения к интернету недостаточно;
• прошивка станции устарела.

Порядок диагностики

1. Сторона станции

• Проверьте физические соединения: кабели и роутеры.
• Выключите и снова включите (на 5 минут) станцию и внешние устройства связи (роутеры).
• По возможности проверьте журналы на стороне станции в панели администрирования производителя.

Соединения RJ45 часто неисправны или неправильно обжаты. Лучший тест — подключить вместо станции компьютер с теми же сетевыми настройками (автоматический DHCP или фиксированный IP).

• Для станции с модемом 4G проверьте правильность APN и пользователя / пароля, затем уровень сигнала 4G — его часто можно посмотреть на станции или во внешнем роутере 4G.
• Обновите прошивку до последней официальной версии с сайта производителя.
• Сначала попробуйте сменить токен на WS (без защиты, порт 80).
• Затем, если это работает, вернитесь к WSS (защищённый, порт 443).

2. Сторона мониторинга, если со стороны станции всё в порядке

• Проверьте журналы на стороне мониторинга (желательно в веб-интерфейсе), как описано в вопросах о журналах. Если запрос на открытие WebSocket не поступает, станция передаёт данные некорректно — особенно если другие станции уже подключены в том же облачном пространстве.
• Проверьте также состояние токена (срок действия и отзыв) в меню «Станция / Подключить новую станцию».
• Проверьте, отвечает ли станция на команды OCPP (Reset, StartTransaction…), одновременно просматривая журналы бэкенда.

Когда и как с нами связаться

Если ни одна станция больше не отвечает, а сеть исправна, возможна ошибка на стороне мониторинга. В этом случае свяжитесь с нами (категория «Запрос в службу поддержки») и точно опишите проблему: дата инцидента, воспроизводимость, названия затронутых станций, проведённые тесты и т. д.

Если проблема связана со станциями, с одной конкретной станцией или возникла после обновления прошивки, соберите журналы со стороны станции и мониторинга и откройте обращение у производителя.

Отладка в ChargeAngels — платная услуга, за исключением доказанной и задокументированной ошибки на стороне мониторинга. Договором поддержки покрываются только станции, сертифицированные ChargeAngels. В большинстве случаев ошибки вызваны сбоем станции, проблемой сети или неправильными действиями пользователей.

Рекомендуемые практики

• Лучше всего держать «эталонную» станцию рядом с вашими помещениями — для отладки и воспроизведения сбоев или ошибок. Обновление прошивки — рискованная операция, которая иногда выводит станцию из строя навсегда. Если выделенной тестовой станции нет, проводите тесты на изолированной станции, которая мало используется.
• При вводе в эксплуатацию незнакомых станций проведите пробный ввод в эксплуатацию до окончательной установки.
• Для станций 4G заранее проанализируйте покрытие сети 4G (для этого существуют специальные приборы).
• Для функциональных испытаний существуют имитаторы зарядки для станций AC (Type 2) от Metrel. Мы также рекомендуем проверки с реальным электромобилем.

Чтение журналов JSON или в любом другом формате требует ИТ-навыков. Сообщения OCPP между станциями и нашим сервером стандартизированы в спецификации OCPP, которую мы советуем прочитать в первую очередь: openchargealliance.org/my-oca/ocpp. Мы также проводим обучение по этому протоколу и практическое обучение (чтение журналов и отладка) в дополнение к квалификации IRVE P2/P3.

Чаще всего встречаются три группы проблем. Они подробно описаны в следующих вопросах:

• проблемы с подключением станции к бэкенду;
• проблемы с завершением сессии: StopTransaction не получен;
• проблемы с завершением сессии: StopTransaction получен, но статус неверный.

Симптом: станция не отображается в панели управления CSMS ChargeAngels, хотя сеть работает, либо приходят запросы WS/WSS, но с ошибкой.

Пояснения: открытие WebSocket — исключительно инициатива станции, а не CSMS. Если на стороне мониторинга не приходит ни один запрос WS или WSS, а сеть работает (станция достигает интернета, например DNS Google), то URL, заданный на станции, скорее всего, неверен, содержит ошибку или неполон. У каждого бренда и модели свои особенности, и иногда для задания этого URL нужен специальный инструмент: веб-приложение, мобильное приложение, отдельная программа для Windows и т. д.

Решения: советуем сначала прочитать весь этот FAQ, особенно вопросы о журналах WebSocket. После сети именно настройка URL в 99 % случаев является причиной проблемы, поэтому действуйте последовательно и итеративно.

У неверного URL часто бывает несколько причин:

1. Некоторые станции поддерживают только WS: рекомендуем начать с него (кто может больше, тот может и меньше).
2. Некоторые станции поддерживают WSS только после последнего обновления прошивки.
3. Некоторым станциям требуется первое подключение по WS, затем переход на WSS (Schneider, в зависимости от прошивки).
4. Некоторые станции поддерживают WSS, но только с TLS 1.2, а не с TLS 1.3.
5. Некоторым станциям нужен определённый профиль безопасности: у нас нет специального профиля, но уровень 2 принимается с любым паролем.
6. Некоторым станциям нужен корневой сертификат CSMS (сертификат Root CA).
7. Некоторым станциям нужен порт 80 или 443: в этом случае добавьте его в URL.
8. Некоторые станции разделяют хост, порт, путь и ChargeBoxID, а затем собирают из них URL WSS для исходящих вызовов.
9. У некоторых станций нет поля ChargeBoxID: тогда его нужно добавить в конец URL, иначе вызов будет отклонён с нашей стороны (это поле — первичный ключ в нашей базе данных).
10. Некоторые станции добавляют косую черту в конец URL, другие нет (с нашей стороны ограничений на этот счёт нет).
11. Некоторые станции обрезают URL, потому что он слишком длинный (случается всё реже).

Симптом: в меню «Сессии / История» отображаются «призрачные» сессии, и текущую зарядную сессию невозможно остановить. Запись об ошибке: Remote Stop Transaction has been rejected in 1.52s, reason 'Rejected'.

Последовательность в журналах:

EVSE <- CSMS : remoteStartTransaction with transactionID
EVSE -> CSMS : accepted
EVSE -> CSMS : StartTransaction with tagID
EVSE <- CSMS : accepted
...
EVSE <- CSMS : remoteStopTransaction with the same transactionID
EVSE -> CSMS : rejected   <- error message: you are blocked here
EVSE -> CSMS : StopTransaction with same tagID
EVSE <- CSMS : accepted

Пояснения: сессия остаётся незавершённой на стороне CSMS независимо от реального состояния станции, поскольку мы не знаем её состояния (StopTransaction не получен). Поэтому перезагрузка станции не влияет на незавершённую сессию, пока CSMS не получит от станции StopTransaction с правильным идентификатором транзакции. Запуск другой сессии создаёт другой TransactionID, то есть ещё одну запись в нашей базе данных.

Решение: у вас один вариант: нажать кнопку «Force Stop», доступную для каждой текущей сессии в пользовательском интерфейсе. Это принудительно останавливает сессию на стороне CSMS.

Симптом: в меню «Сессии / История» отображаются «призрачные» сессии или необычный статус станции (отличный от CHARGING / SUSPENDED / FAULTED / RESERVED).

Нормальный случай, когда StopTransaction получен

• StopTransaction + AVAILABLE (FINISHING необязателен): транзакция останавливается и завершается.
• FINISHING не обязателен: проверяются только AVAILABLE или PREPARING (FINISHING используется для времени парковки).
• SUSPENDED, FAULTED и RESERVED не влияют на процесс.

«Необычные» случаи, обрабатываемые автоматически

1. StopTransaction получен, но StatusNotification так и не пришёл через X минут: автоматический «Force Stop» запланированной задачей CSMS (задержка 30 минут).
2. Получен новый StartTransaction без предшествующего StopTransaction: без потребления транзакция удаляется; при наличии потребления применяется автоматический «Force Stop».
3. StatusNotification AVAILABLE без StopTransaction непосредственно перед ним: транзакция остаётся активной (немедленных действий нет). Если Stop приходит позже, завершение проходит нормально; если не приходит, запланированная задача применяет «Force Stop» (30 минут).
4. StatusNotification AVAILABLE до StopTransaction: система искусственно создаёт StatusNotification на основе текущего статуса разъёма (Available) и метки времени StopTransaction, чтобы правильно вычислить дополнительное время простоя.

Пример реальной хронологии:

T1: Available received   -> no action (no StopTransaction)
T2: Stop received        -> detects connector = Available
                          -> creates a synthetic StatusNotification
                          -> finalises the transaction

Решение: во всех случаях, кроме описанных выше, вы можете остановить транзакцию вручную в списке «текущих» сессий кнопкой «Force Stop».