Victron

Introduction

Les appareils Victron Energy sont un composant essentiel de l'écosystème de surveillance des tours GCXONE, fournissant une surveillance en temps réel de l’alimentation et de l’énergie pour les sites de tours distants. Ils suivent les performances de charge solaire, l’état de santé de la batterie et la tension globale du système DC — garantissant que le système énergétique fonctionne dans des seuils de sécurité et offrant une alerte précoce en cas d’anomalies de batterie ou de solaire.

Ce guide décrit les étapes nécessaires pour intégrer un appareil Victron Energy dans GCXONE — couvrant la configuration des identifiants et l’activation des règles d’alarme. Une fois terminé, votre appareil diffusera des télémétries en direct et déclenchera des alertes automatisées lorsque les seuils de tension ou d’état de charge seront dépassés.

Ce que les appareils Victron surveillent

Une fois connectés à GCXONE, les appareils Victron signalent en continu les catégories de télémétrie suivantes :

• Niveaux de tension de batterie sur le système DC
• Courant de charge solaire et puissance d’entrée des contrôleurs PV
• État de charge de la batterie (SOC) en pourcentage
• Statut de fonctionnement du chargeur et de l’onduleur
• État de santé global du système et états d’alarme

Note :Victron est le système principal de surveillance de l’alimentation de la tour. Sans lui, GCXONE ne peut pas détecter l’épuisement de la batterie, la sous‑performance solaire ou les anomalies de tension DC pouvant entraîner une perte d’alimentation du site.

Prérequis

Avant de commencer l’intégration de l’appareil, assurez‑vous que les informations et accès suivants sont disponibles :

Avertissement :Les identifiants du portail VRM fournis doivent disposer de privilèges administratifs. Les comptes en lecture seule n’autoriseront pas GCXONE à récupérer l’ensemble complet des données de télémétrie requis pour la surveillance.

Guide de configuration Victron avec GCXONE

Suivez ces étapes pour ajouter un appareil Victron à GCXONE. L’appareil sera enregistré sous un site existant et commencera à signaler la télémétrie immédiatement après la configuration.

Étape 1 : Accéder au site

Dans GCXONE, accédez au site où l’appareil Victron est physiquement installé. Il s’agit de l’entité parent sous laquelle l’appareil sera enregistré.

• Aller à Configuration → Sites
• Localiser et ouvrir le site cible
• Cliquer sur Edit pour ouvrir le panneau de configuration du site

Étape 2: ouvrir le dialogue Appareil

Dans la configuration du site, naviguer vers le Appareils section et cliquer sur Ajouter nouveau pour ouvrir le dialogue de création d'appareil.

Étape 3: Sélectionner le Type d'appareil

Dans le dialogue Appareil, ouvrir le Type d'appareil menu déroulant et sélectionner Victron pour charger les champs de configuration appropriés.

Étape 4: Saisir les détails de l'appareil

Remplir tous les champs obligatoires pour établir une connexion sécurisée entre GCXONE et le portail Victron VRM. Chaque champ est décrit en détail ci‑dessous.

Étape 5: En dessous des champs de connexion, le dialogue possède également un Sélectionner le groupe d'entités menu déroulant, un champ obligatoire Fuseau horaire, un Configuration de l'Appareil section (Configuration Site Pulse), un Paramètres avancés section (Interrogation des événements, Configurer le Masque Heatmap, Bilan de santé périodique, Temps rétention de l’événement — 30 jours par défaut), et un Emplacement section (Latitude, Longitude, Plus Code, What3Words).

Étape 6 : Enregistrer et vérifier la Connexion

Après avoir saisi tous les champs, cliquer sur Enregistrer. GCXONE tentera immédiatement de se connecter à l'API Victron VRM en utilisant les informations d'identification et le numéro de série fournis.

Une connexion réussie entraîne :

• L’appareil apparaissant dans la liste des appareils du site avec un indicateur d’état actif
• GCXONE détecte automatiquement les éléments disponiblesContrôleur PV et le Gestionnaire de batterie
• Les données de télémétrie en direct commencent à circuler vers GCXONE (voltage de batterie, courant de charge, entrée solaire, SOC)
• L'Appareil devient disponible pour la configuration des règles d'Alarme

Avertissement : Si la connexion échoue, vérifier que le numéro de série correspond à l'appareil dans le Portail VRM, que les informations d'identification disposent de privilèges administratifs, et que l'API Victron VRM est accessible depuis le serveur GCXONE.

Configuration des règles d'Alarme

GCXONE utilise une configuration de règle d'Alarme basée sur JSON pour définir quels paramètres de télémétrie sont surveillés, quels seuils déclenchent des Alertes, et comment ces Alertes sont identifiées dans les intégrations CMS.

Les règles d'Alarme peuvent être configurées au niveau Niveau du site ou Niveau de l’appareil. Les règles Victron Energy sont généralement appliquées au niveau Appareil pour un contrôle précis.

Comment appliquer les règles d'Alarme

1. Naviguer vers le site ou l’appareil cible dans GCXONE.
2. Cliquer sur Modifier et accéder à la section Propriétés supplémentairessection.
3. Localiser la propriété nommée Règles d'Alarme personnalisées.
4. Ouvrir les trois points de la propriété (⋮) et sélectionner Appliquer par défaut pour charger l’ensemble de règles préconfigurées. Toutes les règles sont inactives par défaut.
5. Modifier le JSON pour activer des règles spécifiques en définissant "active": true pour les paramètres concernés.
6. Définir vos seuils, codes d’événement et codes de groupe selon les besoins.
7. Cliquer Enregistrer. GCXONE commencera immédiatement à évaluer la télémétrie entrante par rapport aux règles configurées.

Remarque : Par défaut, toutes les règles d’alarme sont inactives. Vous devez explicitement définir "active": true pour chaque règle que vous souhaitez que GCXONE surveille. Cela évite les alertes accidentelles lors de la configuration initiale.

Structure de la règle

Chaque règle d’alarme suit une structure JSON cohérente. Comprendre les champs communs facilite la personnalisation des règles :

Règles d’alarme Victron Energy

Les règles d’alarme suivantes sont disponibles pour les appareils Victron dans la section Surveillance énergétiquesection du JSON des règles d’alarme personnalisées. Chaque règle surveille un aspect spécifique de la santé et des performances du système électrique.

Règle de Voltage de batterie

Surveille la tension du système DC du banc de batteries. Une tension hors de la plage acceptable peut indiquer un défaut de charge, une charge excessive ou une dégradation de la batterie.

Configuration JSON par défaut

"voltage": {
  "active": false,
  "low": 12,
  "high": 14,
  "eventCode": "battery.voltage.warning",
  "groupCode": "tower.solar.voltage.alert"
}

Comportement d'exemple

• Lorsque la tension descend en dessous de 12 V, une Alerte est déclenchée indiquant que la batterie se décharge au-delà des niveaux sûrs.
• Lorsque la tension dépasse 14 V, une Alerte est déclenchée indiquant une possible surcharge.
• L'Alerte se désactive automatiquement lorsque la tension revient dans la plage 12 V–14 V.
• Ajuster les seuils en fonction de la chimie spécifique de votre batterie — les systèmes lithium fonctionnent généralement dans une plage de tension différente de celle des batteries au plomb.

Règle d'État de charge de la batterie (SOC)

Surveille le pourcentage de charge restant dans la banque de batteries. Le SOC est un indicateur plus fiable de l'énergie utilisable restante que la tension seule, surtout sous charge.

Configuration JSON par défaut

"stateOfCharge": {
  "active": false,
  "low": 15,
  "eventCode": "battery.soc.warning",
  "groupCode": "tower.battery.soc.alert"
}

Comportement d'exemple

• GCXONE déclenche une Alerte lorsque le SOC de la batterie descend en dessous de 15 %.
• L'Alerte se désactive automatiquement lorsque le SOC dépasse le seuil configuré.
• Définir faible plus élevé (par ex., 25–30 %) sur les sites avec une production solaire limitée ou une forte consommation afin de donner aux opérateurs plus de marge avant une éventuelle panne.

Résumé des codes d'événement et des codes de groupe

Référence rapide pour tous les codes d'événement et codes de groupe Victron Energy :

Référence de configuration

JSON complet des règles d’Alarme Victron Energy

Copiez ceci dans la propriété Règles d’Alarme Personnalisées et modifiez-le selon les besoins de votre déploiement.

"energyMonitoring": {
  "voltage": {
    "active": false,
    "low": 12,
    "high": 14,
    "eventCode": "battery.voltage.warning",
    "groupCode": "tower.solar.voltage.alert"
  },
  "stateOfCharge": {
    "active": false,
    "low": 15,
    "eventCode": "battery.soc.warning",
    "groupCode": "tower.battery.soc.alert"
  }
}

Bonnes pratiques de configuration

• Commencer toujours par Appliquer par défaut pour charger l’ensemble complet de règles préconfigurées avant d’apporter des modifications.
• Activer les deux règles simultanément — Voltage et SOC se complètent et offrent ensemble une vue complète de la santé de la batterie.
• Définir bas pour le SOC à 25–30 % sur les sites avec une exposition solaire limitée ou pendant les mois d’hiver lorsque l’apport solaire est réduit.
• Ajuster les seuils de tension en fonction de la chimie de votre batterie — les systèmes lithium ont des plages de fonctionnement sûres différentes de celles des batteries au plomb.
• Tester les règles d’alarme sur un seul appareil avant de les déployer sur tous les sites.
• Documenter vos codes d’événement et codes de groupe dans la configuration de votre CMS afin d’assurer un routage correct des alarmes.

Dépannage

L’appareil ne se connecte pas

Les règles d’Alarme ne se déclenchent pas

Pour un support supplémentaire, contactez votre représentant NXGEN ou consultez le Guide complet de configuration du suivi de la tour GCXONE, qui couvre la surveillance des piles à combustible EFOY, de Teltonika IoT ainsi que de Victron Energy.