Ce document est basé sur le protocole OCPP 1.6 JSON et décrit les directives pour le bon fonctionnement du serveur Wellborne OCPP et le contrôle de l’implémentation du chargeur. Ce document contient toutes les commandes des chargeurs AC et DC, les différences de modèle de chargeur, et elles ne s’appliquent pas toutes.
Ce document est destiné à l’usage des développeurs internes de Wellborne pour les opérations de développement et de débogage, et tout problème ou perte causé par l’utilisation de ce document par des personnes autres que celles habilitées par Wellborne ne saurait engager la responsabilité de Wellborne pour tout dommage direct, indirect, spécial ou consécutif causé par les circonstances suivantes:
Ce document ne doit pas être reproduit ni partagé sans autorisation;
Wellborne n’est pas responsable des conséquences découlant d’une mauvaise utilisation des informations de ce document;
Dans le cas d’une diffusion ou d’une reproduction de ce document n’ayant pas été expessément autorisée par la société Wellborne, la société Wellborne pourra décider d’engager des poursuites à sa discrétion.
« Response » est la commande que le point de charge/serveur central répond au serveur central/point de charge après avoir reçu la commande correspondante. Seule la commande « Operations Initiated by Central System » peut être opérée, à l’exception de « Response ».
Pour qu’un véhicule électrique soit chargé par un Point de Charge, il doit dans un premier temps d’autentifier l’usager pour pouvoir démarrer la charge. Si L’usager est autorisé, le Point de Charge informe le Système Central que la session de charge a commencé.
Lorsqu’un usager souhaite débrancher son véhicule électrique du Point de Charge, le Point de Charge doit vérifier que l’usager est soit celui qui a initié la session de charge, soit qu’il appartient au même groupe, et a donc l’autorisation de mettre fin à la session de charge. Une fois l’autorisation obtenue, le Point de Charge informe le Système Central que la session de charge a été arrêtée.
Après votre connexion, la page suivante s’affiche:
1. Entrez le numéro de série de la borne et cliquez sur « Search » pour vérifier le statut de la borne.
2. Cliquez d’abord sur « charger ID », puis cliquez sur « Start debug »
3. Cliquez sur la liste de commandes à gauche et entrez les clés de configurations requises
Description de la commande :
Un Point de Charge envoie une notification au Système Central pour l’informer d’un changement de statut ou d’une erreur dans le Point de Charge.
État occupé : Preparing, Charging, SuspendedEV, SuspendedEVSE et Finishing
Autres états : Available, Unavailable, Reserved, Faulted, SuspendedEV, SuspendedEVSE
Nom de champ
Type de champ
Carte
Description
connectoId
integer connectorID ≥ 0
1..1
Obligatoire. L’id du connecteur dont le statut est rapporté. L’id « 0 » est utilisé si le statut est celui du contrôleur principal du Point de Charge.
errorCode
ChargePointErrorCode
1..1
Obligatoire. Contient le code erreur rapporté par le Point de Charge.
info
CiString50Type
0..1
Optionnel. Information additionnelle relative à une erreur.
status
ChargePointStatus
1..1
Obligatoire. Contient le statut actuel du Point de Charge.
timestamp
dateTime
0..1
Optionnel. Heure à laquelle le statut est reporté. Si absent, l’heure de réception du message sera utilisée.
Description de la commande :
Le Point de Charge doit envoyer une commande StartTransaction.req au Système Central pour l’informer qu’une transaction a démarré. Si la transaction met fin à la réservation, la commande StartTransaction.req doit contenir la reservationId.
À la réception de la commande StartTransaction.req, le Système Central doit répondre une commande StartTransaction.conf. Cette commande doit inclure l’ID de la transaction et le statut de l’autorisation.
Nom de champ
Type de champ
Carte
Description
connectoId
integer connectorID > 0
1..1
Obligatoire. Identifie quel connecteur du Point de Charge est utilisé.
idTag
IdToken
1..1
Obligatoire. Contient l’identifiant avec lequel la transaction a démarré.
meterStart
integer
1..1
Obligatoire. Contient la valeur du connecteur en Wh au début de la transaction.
reservationId
integer
0..1
Optionnel. Contient l’ID de la réservation qui s’achève en conséquence de la transaction.
timestamp
dateTime
1..1
Obligatoire. Heure à laquelle la transaction débute.
Description de la commande :
Le Système Central peut demander au Point de Charge d’effacer le cache d’autorisation. Le Système Central doit envoyer une commande ClearCach.req pour effacer le cache d’autorisation du Point de Charge.
À la réception de la commande ClearCach.req, le point de charge doit répondre par une commande ClearCache.conf. La commande de réponse doit indiquer si le Point de Charge a pu effacer le cache d’autorisation.
Description de la commande :
Après le démarrage, le Point de Charge doit envoyer une requête au Système Central avec les informations de sa configuration (version e.g., vendeur, etc.). Le Système Central doit répondre pour indiquer si il accepte le Point de Charge.
Le Point de Charge doit envoyer une commande BootNotification.req à chaque fois qu’il démarre ou redémarre. Entre le démarrage physique et l’achèvement du BootNotification, où le Système Central répond Accepted ou Pending, le Point de Charge ne doit pas envoyer une autre requête au Système Central. Cela inclut les messages cache déjà présents dans le Point de Charge.
Nom de champ
Type de champ
Carte
Description
chargeBoxSerialNumber
CiString25Type
0..1
Optionnel. Contient une valeur qui identifie le numéro de série du Bloc de Charge dans le Point de Charge. Sera retiré dans une version future
chargePointModel
CiString20Type
1..1
Obligatoire. Contient une valeur qui identifie le modèle du Point de Charge
Nom de champ
Type de champ
Carte
Description
chargePointSerialNumber
CiString25Type
0..1
Optionnel. Contient une valeur qui identifie le numéro de série du Point de Charge.
chargePointVendor
CiString20Type
1..1
Obligatoire. Contient une valeur qui identifie le vendeur du Point de Charge.
firmwareVersion
CiString50Type
0..1
Optionnel. Contient la version du firmware du Point de Charge.
iccid
CiString20Type
0..1
Optionnel. Contient l’ICCID de la carte SIM du modem.
imsi
CiString20Type
0..1
Optionnel. Contient l’IMSI de la carte SIM du modem.
meterSerialNumber
CiString25Type
0..1
Optionnel. Contient le numéro de série du compteur principal du Point de Charge.
meterType
CiString25Type
0..1
Optionnel. Contient le type du compteur principal du Point de Charge.
Description de la commande :
Un Point de Charge envoie une notification pour informer le Système Central de la progression de la mise à jour du firmware. Le Point de Charge envoie une commande FirmwareStatusNotification.req pour informer le Système Central de la progression du téléchargement et de l’installation de la mise à jour du firmware. Le Point de Charge doit uniquement communiquer le statut « Idle » après réception du TriggerMessage pour la notification du statut du firmware, quand il n’est pas en train de télécharger ou d’installer le firmware.
À la réception de la commande FirmwareStatusNotification.req, le Système Central doit répondre par une commande FirmwareStatusNotification.conf.
Description de la commande :
Si un Point de Charge a besoin d’envoyer une information au Système Central pour une fonction non supportée par OCPP, il doit utiliser la commande DataTransfer.req.
Nom de champ
Type de champ
Carte
Description
vendorId
CiString25Type
1..1
Obligatoire. Identifie l’implémentation du vendeur spécifique.
messageId
CiString50Type
0..1
Obligatoire. Champ d’identification additionnel.
data
Text Length undefined
0..1
Optionnel. Donnée sans longueur ou format spécifique.
Description de la commande :
Le Système Central peut demander au Point de Charge de déconnecter un connecteur. Pour ce faire, le Point de Charge doit envoye rune commande UnlockConnector.req.
Le but de ce message est d’aider les conducteurs de véhicules électriques ayant du mal à débrancher leur câble du Point de Charge en cas de disfonctionnement de la rétension du câble. Quand l’usager appelle le SAV, un opérateur peut déclencher la commande UnlockConnector.req au Point de Charge, forçant une nouvelle tentative de déverrouiller le connecteur.
La commande UnlockConnector.req ne doit pas être utilisée pour arrêter une transaction à distance, cette opération doit être effectuée avec la commane RemoteStop.
Après réception de la commande UnlockConnector.req, le Point de Charge doit répondre par une commande UnlockConnector.conf. La réponse doit indiquer si le Point de charge a réussi à déverrouiller son connecteur.
Si une transaction était en cours sur un connecteur spécifique, alors le Point de Charge doit d’abord terminer la transaction comme décrit sous StopTransaction.
Note: UnlockConnector peut seulement être utilisée pour les chargeurs équipés d’une prise AC.
Nom de champ
Type de champ
Carte
Description
connectorId
integer connectorId > 0
1..1
Obligatoire. Contient l’identité du connecteur à déverrouiller.
Entrez le numéro correspondant au connecteur que vous souhaitez déverrouiller et cliquez sur « send ».
NB: Il est interdit d’utiliser cette commande pour mettre un terme à une transaction en cours.
Description de la commande :
Le Point de Charge envoie une notification pour informer le Système Central du statut de téléchargement d’un diagnostic. Le Point de Charge envoie une commande DiagnosticsStatusNotification.req pour informer le Système Central que le téléchargement du diagnostic est en cours, ou bien s’est soldé par un échec ou un succès. Le Point de Charge doit seulement envoyer le status « Idle » après réception du TriggerMessage de la DiagnosticsStatusNotification, lorsqu’il n’est pas en train de télécharger le diagnostic.
À la réception de la commande DiagnosticsStatusNotification.req, le Système Central doit répondre par une commande DiagnosticsStatusNotification.conf.
Description de la commande :
Pour annuler une réservation le Système Central envoie une commande CancelReservation.req au Point de Charge.
Si le Point de Charge a une réservation qui correspond à celle citée par la commande CancelReservation.req, il doit répondre par un statut « Accepted », ou « Rejected ».
La reservationId de la cancelReservation doit être identique à la reservationId. Si l’ID parent est réglée, la reservationId est la même que la parentId.
Description de la commande :
Le Système Central peut envoyer une Local Authorization List qu’un Point de Charge peut utiliser pour l’autorisation des idTags. La liste peut être soit une liste complète pour remplacer la liste actuellement dans le Point de Charge, soit une liste différente avec des mises à jour pour être appliquée à la liste actuellement dans le Point de Charge.
Description de la commande :
Le Système Central peut demander au Point de Charge de reporter le Composite Charging Schedule en envoyant une commande GetCompositeSchedule.req. Le planning rapporté, dans la commande GetCompositeSchedule.conf, est le résultat du calcul de tous les plannings actifs et des possibles limites locales présentes dans le Point de Charge.
Description de la commande :
Le Système Central peut demander les informations de diagnostic du Point de Charge. Le Système Central doit envoyer une commande GetDiagnostics.req pour obtenir les informations de diagnostic du Point de Charge avec l’emplacement où le Point de Charge doit télécharger les données de diagnostic, et potentiellement une heure de début et de fin des données de diagnostic.
À la réception de la commande GetDiagnostics.req, et si les informations de diagnostic sont disponibles, alors le Point de Charge doit répondre par une commande GetDiagnostics.conf qui donne le nom du fichier qui sera téléchargé et qui contient les informations de diagnostic. Le Point de Charge doit envoyer une seul fichier. Il n’y a pas de format de fichier obligatoire. Si le fichier de diagnostic n’est pas disponible, alors la commande GetDiagnostics.conf ne doit pas contenir de nom de fichier.
Nom de champ
Type de champ
Carte
Description
location
anyUR1
1..1
Obligatoire. Contient l’emplacement (annuaire) où le fichier de diagnostic doit être téléchargé.
retries
integer
0..1
Optionnel. Spécifie combien de fois le Point de Charge doit essayer le télécharger le diagnostic avant d’abandonner. Si ce champ n’est pas renseigné, le Point de Charge décide combien de tentatives il fait.
retryInterval
0..1
Optionnel. Intervalle en secondes entre chaque tentative. Si ce champ n’est pas renseigné, le Point de Charge décide de la durée des intervalles.
startTime
0..1
Optionnel. Date et heure de l’information la plus ancienne à inclure dans le diagnostic.
stopTime
0..1
Optionnel. Date et heure de l’information la plus récente à inclure dans le diagnostic.
Entrez le chemin d’accès où envoyer le rapport et cliquez sur « send ». Vous pouvez également entrer l’heure de début et de fin du diagnostic, et le chargeur téléchargera les informations de diagnostic correspondant à la plage horaire définie.
NB: Avant tout, vous devez insérer une carte SD avec au mojns 8GB d’espace dans l’emplacement du chargeur. La plage horaire d’un rapport de diagnostic ne peut pas dépasser une journée.
Description de la commande :
Le Système Central peut demander au Point de Charge pour changer sa disponibilité. Un Point de Charge est considéré comme disponible (« operative ») quand il est en train de charger ou prêt à charger. Un Point de Charge est considéré comme indisponible quand il ne permet aucune charge. Le Système Central doit envoyer une comande ChangeAvailability.req au Point de Charge pour changer sa disponibilité. Le Système Central peut changer la disponibilité de disponible à indisponible.
À la réception de la commande ChangeAvailability.req, le Point de Charge doit répond avec une commande ChangeAvailability.conf. La réponse doit indiquer si le Point de Charge peut passer au statut de disponibilité requis. Quand une transaction est en cours le Point de Charge doit répondre par le statut « Scheduled » pour indiquer que le changement de disponibilité doit se passer à la fin de la transaction.
Dans le cas où le Système Central demande au Point de Charge de passer à un statut dans lequel il se trouve déjà, le Point de Charge doit répondre par le statut de disponibilité « Accepted ».
Quand le changement de disponibilité demandé avec la commande ChangeAvailability.req est opérant, le Point de Charge doit informer le Système Central de son nouveau statut de disponibilité avec une commande StatusNotification.req comme décrit ici.
Nom de champ
Type de champ
Carte
Description
connectorId
integer connectorId ≥ 0
1..1
Obligatoire. L’ID du connecteur dont on doit changer la disponibilité. « 0 » est utilisé si la disponibilité du Point de Charge et de tous ses connecteurs doit changer.
type
AvailabilityType
1..1
Obligatoire. Contient le type de changement de disponibilité que le Point de Charge doit opérer.
Cette commande est utilisée pour modifier le statut du chargeur, souvent pour les opérations de maintenance sur site. Une fois la commande « out of service » transmise au chargeur, le chargeur ne peut être réinitialisé qu’une fois son statut réstauré dans cette interface.
0: le chargeur complet
1: connecteur A (DC)
2: connecteur B (DC)
3: connecteur C (AC)
4: connecteur D (AC)
Inoperative: le chargeur est en maintenance (hors service)
Operative: état normal, le chargeur est disponible
Entrer l’ID du connecteur concerné dans le champ dédié, en tapant « 1 » par exemple, et remplisser le champ d’état du connecteur, comme par exemple « Inoperative ».
Description de la commande :
Si le Système Central veut effacer certains ou tous les profils de charge précédemment envoyés au Point de Charge, il doit envoyer une commande ClearChargingProfile.req.
Le Point de Charge doit répondre par une comande ClearChargingProfile.conf spécifiant s’il a pu appliquer la requête.
Nom de champ
Type de champ
Carte
Description
id
integer
0..1
Optionnel. L’ID du profil de charge à effacer.
connectorId
integer
0..1
Optionnel. Spécifie l’ID du connecteur dont on veut effacer les profils de charge. L’ID « 0 » correspond au profil de charge de tout le Point de Charge. L’absence de ce paramètre signifie que l’effacement s’applique à tous les profils de charge correspondant à la requête.
chargingProfilePurpose
ChargingProfilePurposeType
0..1
Optionnel. Spécifie le but des profils de charge à effacer, s’ils correspondent à la commande.
stackLevel
integer
0..1
Optionnel. Spécifie le stackLevel pour lequel les profils de charge seront effacés, s’ils correspondent à la commande.
Entrez le profil de charge que vous souhaitez nettoyer et lancez la commande. Si vous voulez nettoyer un des connecteurs, entrez le code connecteur correspondant.
NB: n’oubliez pas de vérifier le profil de charge actuel via « GetCompositeSchedule ».
Description de la commande :
Lors d’une opération normale, le Point de Charge informe le Système Central de son état lorsque cela est nécessaire. S’il n’y a rien à déclarer, le Point de Charge envoie au moins un heartBeat à intervalles réguliers.
Si le Système Central a des raisons de douter de l’exactitude des informations transmises, ou si le temps de transmission semble trop long, la commande TriggerMessage.req lui permet de demander au Point de Charge d’envoyer des messages.
Pour chaque message demandé, le Système Central peut optionnellement indiquer quel message il souhaite recevoir. Pour chacune de ces requêtes, le Système Central peut optionnellement indiquer à quel connecteur la requête s’adresse.
Nom de champ
Type de champ
Carte
Description
requestedMessage
MessageTrigger
1..1
Obligatoire.
connectorId
integer connectorId > 0
0..1
Optionnel. Rempli uniquement lorsque la requête s’adresse à un connecteur spécifique.
Description de la commande :
Le Système Central peut envoyer une commande SetChargingProfile.req à un Point de Charge pour définir un profil de charge dans les situations suivantes:
Au début d’une transaction, pour régler le profril de charge pour la transaction: Si le Système Central reçoit une commande StartTransaction.req, il doit répondre par une commande StartTransaction.conf. S’il y a besoin d’un profil de charge, le Système Central peut choisir d’envoyer une commande SetChargingProfile.req au Point de Charge. Il est recommandé de vérifier le marqueur temps (timestamp) dans la commande StartTransaction.req avant d’envoyer le profil de charge pour vérifier si la transaction a des chances d’être toujours en cours. La commande StartTransaction.req peut avoir été placée en cache pendant le temps hors ligne.
Lors d’une commande RemoteStartTransaction envoyée à un Point de Charge: Le Système Central peut inclure un profil de charge dans une commande RemoteStartTransaction. Si le Système Central inclut un profil de charge, le ChargingProfilePurpose doit être réglé sur TxProfile.
Lors d’une transaction, pour changer le profil actif de la transaction: Le Système Central peut envoyer un profil de charge au Point de Charge afin de mettre à jour le profil de charge pour cette transaction. Pour cela, le Système Central doit utiliser une commande SetChargingProfile.req. Si un profil de charge avec le même ID, ou la même combinaison de stackLevel / ChargingProfilePurpose, existe dans le Point de Charge, le nouveau profil de charge doit remplacer le profil de charge existant, dans le cas contraire, le nouveau profil de charge doit être ajouté. Le Point de Charge doit alors ré-évaluer son catalogue de profils de charge pour déterminer lequel doit être actif. Afin de s’assurer que le profil de charge mis à jour s’applique seulement à la transaction en cours, le chargingProfilePurpose du profil de charge doit être réglé sur TxProfile.
Hors du contexte d’une transaction en tant que message à part entière pour régler un profil de charge sur un contrôleur local, un Point de Charge, ou un profil de charge par défaut à un connecteur: Le Système Central peut envoyer des profils de charge par défaut à un Point de Charge. Pour cela, le Système Central doit utiliser la commande SetChargingProfile.req. Ces profils de charge peuvent être envoyés à n’importe quel moment. Si un profil de charge avec le même ID, ou la même combinaison de stackLevel / ChargingProfilePurpose, existe dans le Point de Charge, le nouveau profil de charge doit remplacer le profil de charge existant, dans le cas contraire, le nouveau profil de charge doit être ajouté. Le Point de Charge doit alors ré-évaluer son catalogue de profils de charge pour déterminer lequel doit être actif.
Nom de champ
Type de champ
Carte
Description
connectorId
integer
1..1
Obligatoire. Le connecteur auquel le profil s’applique. Si connectorId = 0, le message contient une limite globale pour le Point de Charge.
csChargingProfiles
ChargingProfile
1..1
Obligatoire. Le profil de charge à appliquer au Point de Charge.
Description de la commande :
Un Point de Charge peut échantillonner le compteur électrique ou un autre capteur/transducteur pour fournir des informations supplémentaires à propos des valeurs mesurées. C’est au Point de Charge de décider quand envoyer les valeurs du compteur. Ceci peut être configuré en utilisant la commande ChangeConfiguration.req en spécifiant les données à récolter et les intervalles entre les rapports.
Nom de champ
Type de champ
Carte
Description
connectorId
integer connectorId ≥ 0
1..1
Obligatoire. Contient un nombre (>0) désignant un connecteur du Point de Charge. « 0 » est utilisé pour désigner le compteur principal.
transactionId
integer
1..1
Optionnel. Les transactions auxquelles ces valeurs échantillons sont miées.
meterValue
MeterValue
1..*
Obligatoire. Les valeurs échantillon du compteur avec les marqueurs temps.
Description de la commande :
Le Système Central peut demander au Point de Charge de démarrer une transaction en envoyant une commande RemoteStartTransaction.req. À la réception de la commande, le Point de Charge doit répondre par une commande RemoteStartTransaction.conf et un staut indiquant s’il est capable de démarrer ou non la transaction.
La commande RemoteStartTransaction.req doit contenir un identificateur (idTag), que le Point de Charge doit utiliser, indiquer s’il est capable de démarrer la transaction, pour envoyer une commande RemoteStartTransaction.req au Système Central.
La transaction démarre de la même façon que décrite au chapitre StartTransaction. La commande RemoteStartTransaction.req peut contenir un ID de connecteur si la transaction doit démarrer sur un connecteur spécifique. Lorsque l’ID du connecteur est fourni,e le Point de Charge contrôle la sélection du connecteur. Un Point de Charge peut rejeter une commande RemoteStartTransaction.req sans ID de connecteur.
Le Système Central peut inclure un profil de charge à la commande RemoteStartTransaction.req. Le but de ce profil de charge doit être réglé sur TxProfile. Le Point de Charge doit utiliser ce profil de charge pour la transaction.
Nom de champ
Type de champ
Carte
Description
connectorId
integer
0..1
Optionnel. Nombre de connecteurs sur lesquels démarrer la transaction. L’ID du connecteur doit être > 0
idTag
IdToken
1..1
Obligatoire. L’identificateur que le Point de Charge doit utiliser pour démarrer la transaction.
chargingProfile
ChargingProfile
0..1
Optionnel. Le Profil de Charge à utiliser par le Point de Charge pour la transaction demandée. ChargingProfilePurpose doit être réglé sur TxProfile.
Entrez le connectorId et idTag pour démarrer la transaction. L’idTag peut être personnalisé. Si vous souhaitez interrompre la transaction à distance, allez à RemoteStopTransaction et vous verrez que l’ID a été renseigné, cliquez sur « send » pour interrompre la charge.
Description de la commande :
Lorsque la transaction est interrompue, le Point de Charge doit envoyer une commande StopTransaction.req, notifiant le Système Central que la transaction est arrêtée.
Une commande StopTransaction.req peut contenir un élément optionnel TransactionData pour fournir davantage de détails concernant l’utilisation de la transaction. Cet élément est un conteneur d’un cartain nombre de MeterValues, utilisant la même structure de données que les éléments MeterValue de la commande MeterValues.req.
À la réception de la commande StopTransaction.req, le Système Central doit répondre par une commande StopTransaction.conf.
Nom de champ
Type de champ
Carte
Description
idTag
IdToken
0..1
Optionnel. Contient l’identificateur requis pour arrêter la charge. Optionnel car le Point de Charge peut mettre fin à la charge sans la présence d’un idTag en cas de réinitialisation. Un Point de Charge doit envoyer l’idTag s’il est connu.
meterStop
integer
1..1
Obligatoire. Contient la valeur du compteur du connecteur en Wh à la fin de la transaction.
timestamp
dateTime
1..1
Obligatoire. Contient la date et l’heure auxquelles la transaction s’arrête.
transactionId
integer
1..1
Obligatoire. Contient l’ID de la transaction telle que reçue par la commande StartTransaction.conf.
reason
Reason
0..1
Optionnel. Contient la raison pour laquelle la transaction a été arrêtée. Peut seulement être omis lorsque la raison est « locale ».
transactionData
MeterValue
0..*
Optionnel. Contient les détails d’utilisation de la transaction pertinents pour la facturation.
Description de la commande :
Le Système Central peut notifier un Point de Charge d’un besoin de mise à jour du firmware. Le Système Central doit envoyer une commande UpdateFirmware.req pour demander au Point de Charge d’installer un nouveau firmware. La commande doit contenir un horodatage après lequel le Point de Charge est autorisé à récupérer le nouveau firmware et l’emplacement où il peut être téléchargé.
À la réception de la commande UpdateFirmware.req, le Point de Charge doit répondre par une commande UpdateFirmware.conf. Le Point de Charge devrait commencer à récupérer le firmware aussi tôt que possible après l’horodatage indiqué.
Nom de champ
Type de champ
Carte
Description
location
anyURL
1..1
Obligatoire. Contient le fil d’ariane incluant l’URL désignant l’emplacement où récupérer le firmware.
retries
integer
0..1
Optionnel. Spécifie combien de fois le Point de Charge doit essayer de télécharger le firmware avant d’abandonner. Si ce champ n’est pas renseigné, c’est la Point de Charge qui décide combien d’essais il fait.
retrieveDate
dateTime
1..1
Obligatoire. Contient l’horodatage après lequel de Point de Charge peut récupérer le nouveau firmware.
retryinterval
integer
0..1
Optionnel. L’intervalle en secondes après lequel un nouvel essai peut être fait. Si ce champ n’est pas renseigné, c’est le Point de Charge qui détermine la durée des intervalles.
Entrez l’emplacement où le firmware est stocké sous « Location ». Les autres options peuvent être renseignées selon les besoins. La mise à jour prend environ de 1 à 3 minutes.
NB: La version de l’ancien firmware doit absolument être de la même série.
Description de la commande :
Le Point de Charge envoie une notification pour informer le Système Central à propos du statut de téléchargement des diagnostics. Le Point de Charge doit envoyer une commande DiagnosticsStatusNotification.req pour informer le Système Central que le téléchargement du des diagnostics est en cours, fini, ou a échoué. Le Point de Charge doit envoyer une statut « Idle » après la réception d’un TriggerMessage, lorsqu’il n’est pas en train de télécharger les diagnostics.
À la réception de la commande DiagnosticsStatusNotification.req, le Système Central doit répondre par une commande DiagnosticsStatusNotification.conf.
Description de la commande :
Affin de supporter la synchronisation de la Local Authorization List, le Système Central peut demander au Point de Charge le numéro de version de la Local Authorization List. Le Système Central doit envoyer une commande GetLocalListVersion.req.
À la réception de la commande GetLocalListVersion.req, le Point de Charge doit répondre avec une commande GetLocalListVersion.conf contenant le numéro de version de la Local Authorization List. Un numéro de version 0 doit être utilisé pour indiquer que la de la Local Authorization List est vide, et un numéro de version -1 doit être utilisé pour indiquer que le Point de Charge ne supporte pas la de la Local Authorization List.
Description de la commande :
Pour obtenir la valeur des réglages de la configuration, le Système Central doit envoyer une commande GetConfiguration.req au Point de Charge.
Si la liste de clés de configuration est vide ou manquante (optionnel), le Point de Charge doit répondre par une liste de tous les réglages de la configuarion dans sa commande GetConfiguration.conf. Dans le cas contraire, le Point de Charge doit répondre par une liste des clés reconnues et de leurs valeurs respectives en mode lecture uniquement, les clés non reconnues doivent être placées dans la commande de réponse comme faisant partie de la liste de clés inconnues optionnelles au sein de la commande GetConfiguration.conf.
Le nombre de clés de configuration demandées dans une seule commande peut être limité par le Point de Charge. Le maximum peut être obtenu en lisant la clé de configuration GetConfigurationMaxKeys.
Nom de champ
Type de champ
Carte
Description
key
CiString50Type
0..*
Optionnel. Liste des clés pour lesquelles la valeur de la configuration est demandée.
Entrez n’importe quelle valeur dans le champ « key », et la barre d’information affichera toutes les valeurs clés, trouvez celle dont vous avez besoin.
Description de la commande :
Le Système Central peut demander au Point de Charge d’interrompre une transaction en lui envoyant une commande RemoteStopTransaction.req contenant l’identificateur de la transaction. Le Point de Charge doit répondre par une commande RemoteStopTransaction.conf pour indiquer s’il a pu interrompre la transaction ou non.
Cette requête d’interruption de la transaction à distance est équivalente à une action locale pour arrêter une transaction. Ainsi, la transaction doit être arrêtée, et le Point de Charge doit envoyer une commande StopTransaction.req et si possible déverrouiller le connecteur.
Les principales raisons d’utiliser cette commande sont:
Pour permettre à l’opérateur CPO d’aider un usager qui ne parvient pas à mettre fin à une transaction.
Pour permettre aux applications mobiles de contrôler les transactions de charge via le Système Central.
Nom de champ
Type de champ
Carte
Description
transactionId
integer
1..1
Oligatoire. L’identificateur de la transaction qu’on demande au Point de Charge d’interrompre.
Description de la commande :
Le Système Central peut envoyer une commande ReserveNow.req au Point de Charge pour réserver un connecteur à l’usage d’un idTag spécifique.
Pour requérir une réservation, le Système Central doit émettre une commande au Point de Charge. Le Système Central peut spécifier quel connecteur doit être réservé. À la réception de la commande ReserveNow.req, le Point de Charge doit répondre avec une commande ReserveNow.conf.
Si la reservationId de la requête correspond à la réservation du Point de Charge, alors celui-ci doit remplacer la réservation par la nouvelle réservation de la requête.
Si la reservationId ne correspond pas à la réservation dans le Point de Charge, alors celui-ci doit répondre par la valeur de statut « Accepted » s’il parvient à réserver le connecteur. Le Point de Charge doit répondre « Occupied » si lui ou le connecteur spécifié sont occupés. Le Point de Charge doit aussi répondre « Occupied » lorsque lui ou le connecteur ont été réservés pour un idTag, qu’il soit identique ou différent. Le Point de Charge doit répondre « Faulted » si lui ou le connecteur sont en état de défaut. Le Point de Charge doit répondre « Unavailable » si lui ou le connecteur sont indisponibles. Le Point de Charge doit répondre « Rejected » s’il n’est pas configuré pour accepter les réservations.
Si le Point de Charge accepte la demande de réservation, il doit alors refuser de charger n’importe quel idTag avec le connecteur réservé, mis à part celui correspondant à l’idTag de la réservation. Lorsque la clé de configuration « ReserveConnectorZeroSupported » est réglée sur « true », le Point de Charge accepte les réservations du connecteur 0. Si le connectorId dans la réservation est 0, alors le Point de Charge ne doit pas réserver un connecteur spécifique, mais doit s’assurer que pendant toute la durée de la réservation un connecteur demeure disponible pour l’idTag. Si la clé de configuration « ReserveConnectorZeroSupported » n’est pas réglée, ou réglée sur « false », le Point de Charge doit répondre « Rejected ». Si l’idTag de la réservation a une valeur (optionnel), alors afin de déterminer l’idTag parent associé avec l’idTag approchant, le Point de Charge peut le rechercher dans la LocalAuthorizationList ou l’AuthorizationCache. S’il n’est pas trouvé à ces emplacements, le Point de Charge doit envoyer une commande Authorize.req pour l’idTag approchant au Système Central. La réponse Authorize.conf contient l’ID parent.
La réservation doit se terminer soit lorsqu’une transaction commence pour l’idTag ou l’idTag parent avec le Point de Charge ou le connecteur spécifique réservé, soit lorsque le délai spécifié dans « expireDate » est atteint, soit lorsque le Point de Charge ou le connecteur sont réglés sur « Faulted » ou « Unavailable ».
Si la transaction pour l’idTag démarre, alors le Point de Charge doit envoyer un reservationId dans la commande (StartTransaction.req) pour notifier le Système Central que la réservation est achevée.
Lorsque la réservation expire, le Point de Charge doit mettre fin à la réservation et rendre le connecteur disponible. Le Point de Charge doit envoyer une notification de statut pour informer le Système Central que le connecteur réservé est désormais disponible.
Si le Point de Charge a implémenté un AuthorizationCache, alors à la réception de la commande ReserveNow.conf, il doit mettre à jour l’entrée du cache, si l’idTag ne figure pas sur la LocalAuthorizationList, avec la valeur IdTagInfo provenant de la réponse comme décrit sous AuthorizationCache.
Nom de champ
Type de champ
Carte
Description
connectorId
integer connectorId ≥0
1..1
Obligatoire. Contient l’ID du connecteur à réserver. Une valeur 0 signifie que la réservation n’est pas pour un connecteur spécifique.
expiryDate
dateTime
1..1
Obligatoire. Contient l’horodatage de la fin de la réservation.
idTag
IdToken
1..1
Obligatoire. L’identificateur pour lequel le Point de Charge doit réserver le connecteur.
Renseignez la période de temps pour laquelle la charge doit être réservée, d’autres champs peuvent être personnalisés, par exemple idTag:1234567890123456.
Description de la commande :
Le Système Central peut demander au Point de Charge de modifier la configuration des paramètres. pour cela, il envoie une commande ChangeConfiguration.req. Cette commande contient une « key-value », où « key » est le nom de la configuration dont le réglage doit changer et « value » est le nouveau réglage pour cette configuration?
À la réception de la commande ChangeConfiguration.req, le Point de Charge doit répondre par une commande ChangeConfiguration.conf indiquant s’il a pu exécuter ou non la modification demandée. Le détail du contenu de « key » et de « value » n’est pas prescrit. Si « key » ne correspond pas à une configuration supportée par le Point de Charge, celui-ci doit répondre par un statut NotSupported. Si la modification est exécutée avec succès, le Point de Charge doit répondre par un statut Accepted. Si la modification est exécutée avec succès, mais qu’un redémarrage est requis, le Point de Charge doit répondre avec un statut RebootRequired. En cas d’échec de la configuration, le Point de Charge doit répondre par un statut Rejected.
Si une valeur « key » est définie en CSL, il peut être accompagné avec une clé [KeyName]MaxLength, indiquant la longueur maximale du CSL. Si la « key » n’est pas définie, une valeur sure de 1 doit être présumée.
Nom de champ
Type de champ
Carte
Description
key
CiString50Type
1..1
Obligatoire. Le nom de la configuration à modifier. Recherchez les noms des clés de configuration standard et les valeurs associées.
value
CiString500Type
1..1
Obligatoire. La nouvelle valeur du réglagle. Recherchez les noms des clés de configuration standard et les valeurs associées.
Entrez la valeur de la clé sous « key » comme G_ChargerID, et entrer le ChargerID que vous voulez modifier sous « value », comme NBGZG49235. Les champs d’information affichent le statut des modifications, qui peut également être consultée dans « Getconfiguration ».
Description de la commande :
Avant que l’utilisateur d’un véhicule électrique ne puisse démarrer ou arrêter la charge, le Point de Charge doit autoriser l’opération. Le Point de Charge doit seulement fournir de l’énergie après l’autorisation. Lorsqu’on arrête une transaction, le Point de Charge doit uniquement envoyer une commande Authorize.req lorsque l’identificateur utilisé pour arrêter la transaction est différent de celui qui l’a commencée.
La commande Authorize.req ne doit être utilisée que pour l’autorisation d’un identificateur de commencer ou d’arrêter la charge.
Le Point de Charge peut autoriser l’identificateur localement sans impliquer le Système Central, comme décrit sous LocalAuthorizationList. Si l’IdTag présenté par l’utilisateur est absent de la LocalAuthorizationList ou du AuthorizationCache, alors le Point de Charge doit envoyer une command Authorize.req au Système Central.
À la réception de cette comande, le Système Central doit répondre par une commande Authorize.conf. Cette commande doit indiquer si l’IdTag est accepté ou non par le Système Central. Si le Système Central accepte l’IdTag alors la réponse doit inclure un parentIdTag et une valeur de statut indiquant l’acceptation ou la raison du rejet.
Si le Point de Charge a implémenté un AuthorizationCache, alors à la réception de la commande Authorize.conf, il doit mettre à jour sa liste de caches, si l’IdTag ne figure pas dans la LocalAuthorizationList, avec la valeur IdTagInfo de la réponse comme décrit sous AuthorizationCache.
Nom de champ
Type de champ
Carte
Description
idTag
IdToken
1..1
Obligatoire. Contient l’identificateur qui doit être autorisé.
Description de la commande :
Afin de laisser le Système Central savoir qu’il est toujours connecté, le Point de Charge envoie un heartbeat à intervalles configurables.
Le Point de Charge doit envoyer une commande Heartbeat.req pour s’assurer que le Système Central sait que le Point de Charge est toujours actif.
À la réception de la commande, le Système Central doit répondre par une commande Heartbeat.conf. La réponse doit contenir l’heure du Système Central, qu’il est recommandé d’utiliser pour le Point de Charge afin de synchroniser son horloge interne.
Le Point de Charge peut sauter l’envoi de la commande Heartbeat.req lorsqu’une autre commande a été envoyée au Système Central durant l’intervalle configuré. Cela implique que le Système Central doit présumer de la disponibilité du Point de Charge au moment où la commande a été reçue, de la même manière qu’il l’aurait fait en recevant la commande Heartbeat.req.
Description de la commande :
Le Système Central doit envoyer une commande Reset.req pour demander au Point de Charge de se réinitialiser. Le Système Central peut requérir une réinitialisation en force ou classique. À la réception de la commande, le Point de Charge doit répondre par une commande Reset.conf. La réponse doit inclure si le Point de Charge va tenter de se réinitialiser.
À la réception d’une demande de réinitialisation classique, le Point de Charge doit retourner à un état similaire à s’il venait d’être démarré. Si une transaction est en cours, elle doit s’arrêter normalement, avant la réinitialisation, comme sous StopTransaction.
À la réception d’une demande de réinitialisation forcée, le Point de Charge doit tenter de mettre fin à toute transaction en cours normalement, comme sous StopTransaction, puis commencer la réinitialisation.
Nom de champ
Type de champ
Carte
Description
type
ResetType
1..1
Obligatoire. Contient le type de réinitialisation que le Point de Charge doit opérer.
AC : Anglais, Thaïlandais, Italien, Hongrois, Slovaque, Français, Espagnol
DC : Anglais, Français
Non
Oui
Oui
G_MaxCurrent
Courant max. du chargeur
Caractères numériques
Non
Oui
Oui
G_ChargerMode
Mode de charge
1, 2, 3 (1 : APP, 2 : RFID, 3 : Plug & Charge)
Non
Oui
Oui
G_CardPin
Mot de passe RFID
Par défaut : 242007
6 chiffres
Oui
Oui
G_ChargerNetIP
IP du chargeur
Vide
<16
Oui
Oui
G_ChargerNetGateway
Passerelle du chargeur
Vide
<16
Oui
Oui
G_ChargerNetMac
MAC
Vide
17 chiffres
Oui
Oui
G_ChargerNetMask
Masque
Vide
<16
Oui
Oui
G_ChargerNetDNS
DNS
Vide
<16
Oui
Oui
G_Authentification
Clé d’autorisation de connexion
Par défaut : 12345678
<21
Oui
Oui
G_HeartbeatInterval
Temps de pulsation de l’OCPP en secondes
Nombres
Non
Oui
Oui
G_WebSocketPngInterval
Intervalle en secondes des pings du protocole websocket
Nombres
Non
Oui
Oui
G_MeterValueInterval
Intervalle en secondes de la commande metervalues pour le protocole OCPP
Nombres
Non
Oui
Oui
G_MaxTemperature
Valeur de la température maximum de la protection du chargeur
Nombres, par défaut : 85
Non
Oui
Oui
G_ExternalLimitPower
Limite puissance externe pour la balance de charge
Nombres
Non
Oui
Oui
G_ExternalLimitPowerEnable
Autoriser la balance de charge
0 : off / 1 : on
Non
Oui
Oui
G_ExternalSamplingCurWring
Courant d’échantillonnage externe, méthode de câblage
0 : CT2000
1 : Compteur
2 : CT3000
Non
Oui
Oui
G_SolarMode
Charge solaire
Format de transfert, chaîne : n° de prise > régler valeur (NB : le réglage ATESS ne requiert pas de n° de prise)
N° de prise : 0, 1, 2, 3
0 : chargeur complet
Modes de charge = 0 : FAST, 1 : ECO, 3 : ECO+
Non
Oui
Oui
G_SolarlimitPower
Limite de la puissance de charge solaire (affecte seulement le mode ECO+)
Unité : kWh, supporte les décimales
Non
Oui
Oui
G_PeakValleyEnable
Fonction pic-vallée
0 : off / 1 : on
Non
Oui
Oui
G_AutoChargeTime
Bouton marche / arrêt, permettre le temps de charge
Format de transfert, chaîne : time1 = 00:00-01:00 / price1 = 0.01 / time2 = 00:00-02:00 / price1 = 0.01 / etc.
Supporte un maximum de 5 configurations de tarif par période
Non
Oui
Oui
G_NetworkMode
Modification du mode réseau
DHCP : IP dynamique
STATIC : IP statique
Non
Oui
Oui
G_TimeZone
Réglage du fuseau horaire
East 8 : UTC+08:00 West 8 : UTC-08:00
Non
Oui
Oui
G_DebugEnable
Le chargeur lance une commande DataTransfer pour rapporter les informations de débogage au serveur
Enable : on
Disable : off
Non
Oui
Oui
G_SolarBoost
Commutateur de fonction de boost solaire
Format de transfert, chaîne : n° de prise > régler valeur (NB : le réglage ATESS ne requiert pas de n° de prise)
N° de prise : 0, 1, 2, 3
0 : chargeur complet
Valeur du réglage = Disable, ManualBoost, SmartBoost
Non
Oui
Oui
G_OffPeakEnable
Commutateur de fonction pic-vallée
Format de transfert, chaîne : n° de prise > régler valeur (NB : le réglage ATESS ne requiert pas de n° de prise)
N° de prise : 0, 1, 2, 3
0 : chargeur complet
Valeur du réglage = Disable, Enable
Non
Oui
Oui
G_PeriodTime
Configuration des plages horaires de la fonction manualBoost et de la plage horaire de la charge de pointe
Format de transfert, chaîne : n° de prise > régler valeur. Supporte un maximum de 5 plages horaires (NB : le réglage ATESS ne requiert pas de n° de prise)
N° de prise : 0, 1, 2, 3
0 : chargeur complet
Non
Oui
Oui
LightIntensity
La luminosité de la respiration
Valeur, pourcentage : 0-100. NB : actuellement non supporté
Non
Oui
Oui
G_WorkingMode
Vérifier le mode de travail
Valeurs en lecture seule / Valeurs du mode ECO / PVlink ManualBoost / PVlink SmartBoost / PVlink / Mode ECO+ / PVlink+ ManualBoost / PVlink+ SmartBoost / PVlink+ / Valeur de balance de charge / Distribution de Puissance / Valeur pic-vallée / Off peak / Mode FAST
Non
Oui
Oui
G_FullContinueChargeEnable
Fonction préchauffage
Enable : on
Disable : off
Non
Oui
Oui
G_PhaseWringMethod
Type de grille
TN-1-fase
TN-3-fase
IT-1-fase
IT-3-fase
Non
Oui
Oui
G_ForceL2RelayEnable
Contrôle du relai de la phase 2
Description : l’interrupteur de commande électrique séquentiel L2 ferme ou déconnecte de force la sortie de courant de phase L2 lors de la charge
Enable : on
Disable : off
Non
Oui
Oui
G_SolarThresholdCurr
Réglage du seuil de courant solaire
Unité : A
Non
Oui
Oui
G_DaylightSavingTime
Délai de la mise en veille
Une valeur supérieure à 0 indique que le seuil est activé et la valeur réelle définie.
Une valeur égale à 0 indique que la fonction de seuil est désactivée.
Non
Oui
Oui
G_OffPeakCurr
Temps de charge durant les heures pic-vallée
Correspond à la durée du pic-vallée, si l’option n’est pas réglée, la charge par défaut se cale sur le courant nominal. Fomrat : n° de prise & curr1 = 10 & curr2 = 20 & curr3 = 30, etc. (supporte jusqu’à 5 réglages).
Non
Oui
Oui
G_RandDelayChargeTime
Délai du temps de charge
Unité : secondes. Lorsque la valeur est de 0, cette fonction est désactivée.
Non
Oui
Oui
G_OffPeakTime
Temps de charge pic-vallée
Format de configurationd es paramètres : heure = courant & n° prise.
Par exemple : 00:00-01:00=9&1
Non
Oui
Oui
GWMaxPower
La puissance de sortie maximale du chargeur
Seulement pour les chargeurs DC
Non
Oui
Oui
GWMaxPowerA
La puissance de sortie du connecteur A
Seulement pour les chargeurs DC
Non
Oui
Oui
GWMaxPowerB
La puissance de sortie du connecteur B
Seulement pour les chargeurs DC
Non
Oui
Oui
GWServerURL2
URL2 du serveur
Seulement pour les chargeurs DC, en cours de développement
Non
Oui
Oui
GWServerDURLFunction
Commutateur URL2
Seulement pour les chargeurs DC, en cours de développement
Non
Oui
Oui
G_ServerQRCode
QR code du serveur
Seulement pour les chargeurs DC
Non
Oui
Oui
G_FreeIdTag
« freevenIdTag » modifié dans le mode Plug & Charge
