rbAmp
FR
Boutique
Docs
Mis à jour le · Modifier sur GitHub (Edit on GitHub)

03 · Choix du capteur de courant

Installation de la pince CT : pincez uniquement le fil L, flèche orientée vers la charge

rbAmp mesure le courant par une pince CT externe (transformateur de courant) et la tension par un transformateur de tension intégré (sur les références UI*). Ce chapitre explique comment choisir la pince pour votre charge et comment indiquer au module, via YAML, le modèle installé.

Famille de capteurs (sensor_class:)

La révision matérielle du module détermine la famille de capteurs de courant prise en charge. Sur les références actuelles, une seule est disponible :

Classe Valeur YAML État
SCT-013 (CT à noyau fendu) SCT_013 Disponible maintenant, par défaut
WIRED_CT (module avec sa propre pince filaire montée) WIRED_CT Appairé en usine : étalonné avec son capteur
BUILTIN_CT (module avec capteur intégré) BUILTIN_CT Appairé en usine : étalonné avec son capteur

La classe est définie une seule fois et stockée dans la flash du module :

YAML
rbamp:
  id: meter1
  sensor_class: SCT_013   # defaults to SCT_013, can be omitted

Sur le firmware v1.2+, cette valeur devient une condition préalable à l'écriture du modèle CT : le module refusera si la classe n'est pas définie. Le composant n'écrit jamais une classe que le module possède déjà.

Garde-fous d'écriture : lecture-comparaison-écriture (v1.3+) et protection d'usine (v1.8.1+)

Au démarrage, le composant lit la classe de capteur de courant du module et la compare à la valeur demandée par le YAML. Si elles correspondent, l'écriture flash n'a pas lieu (une écriture de classe sur le module effacerait aussi les modèles de canaux, donc une valeur inchangée n'est jamais réécrite). Cela signifie que :

  • Le bloc YAML peut garder sensor_class: SCT_013 indéfiniment — un redémarrage répété ne déclenche pas d'effacement flash (~0 ms au lieu de ~700 ms).

  • L'ancien conseil « supprimer sensor_class: du YAML après le premier démarrage » est obsolète — la configuration est idempotente.

Le même comportement s'applique à ct_model: / ct_models: (voir ci-dessous).

Remarque

Modules appairés en usine (WIRED_CT / BUILTIN_CT). Un module fourni avec son propre capteur monté est étalonné en paire avec ce capteur. Le composant protège cet étalonnage : un changement de sensor_class: ou de ct_model: depuis le YAML sur un tel module est refusé avec une ligne de journal explicite (l'écriture remplacerait l'étalonnage individuel par un réglage générique). Omettez ces deux clés du YAML pour ces modules. Pour les pinces SCT-013 (SCT_013, par défaut), les clés fonctionnent comme décrit ci-dessous.

Choix du modèle SCT-013

Le module accepte l'un quelconque des sept modèles de la série SCT-013. Leur sortie électrique diffère, le module doit donc savoir lequel est installé — les coefficients d'usine sont chargés pour le modèle précis.

Quel modèle ai-je ? Lisez le calibre sur l'étiquette du corps de la pince : SCT-013-030 signifie 30 A, donc vous écrivez ct_model: SCT_013_030. Utilisez le modèle dont le calibre correspond à l'étiquette, et non celui qui « ressemble le plus » à votre charge.

Code Nom YAML Calibre nominal Charge typique Maximum à 230 V Statut v1.3
1 SCT_013_005 5 A Éclairage LED, appareils isolés, ordinateurs portables ~1.15 kW production
2 SCT_013_010 10 A PC de bureau, petite climatisation, circuit unique ~2.3 kW production
6 SCT_013_020 20 A Chauffe-eau, dérivations moyennes, ~3-5 kW ~4.6 kW production
3 SCT_013_030 30 A Comptage de toute la maison à la consommation typique ~6.9 kW production (SKU par défaut)
4 SCT_013_050 50 A Recharge de véhicule électrique, grande climatisation, plaque à induction ~11.5 kW production
7 SCT_013_060 60 A Sous-compteur industriel, grosses dérivations ~13.8 kW production
5 SCT_013_100 100 A Entrée principale de service, gros départs ~23 kW production
Installations au-delà de 50 A.

SCT_013_060 (60 A) et SCT_013_100 (100 A) sont acceptés ; choisissez la pince dont le calibre correspond à votre courant maximal.

La résistance de charge (burden) est déjà installée sur la carte du module — il n'y a aucune résistance externe à ajouter entre les fils de sortie de la pince.

Arbre de sélection

Pour choisir une pince SCT-013 : prenez le courant maximal attendu plus 30 %, choisissez la plus petite pince de calibre supérieur, et utilisez son code de modèle.

Règle générale : choisissez la pince au calibre le plus bas dont la valeur maximale mesurable couvre la charge de pointe avec une marge d'environ 30 %. Un calibre surdimensionné sur une petite charge réduit l'amplitude du signal par rapport au bruit — la précision baisse. Une pince dont le calibre est inférieur au pic saturera le noyau magnétique et donnera des relevés grossièrement faux.

Validation de la pince par classe (nouveau en v1.3)

Le validateur de schéma _validate_ct_model_per_class rejette les combinaisons invalides sensor_class: × ct_model: à l'étape esphome config, avant le flash et le démarrage. Les ensembles autorisés ne sont pas contigus — c'est la règle explicite, non un bogue :

sensor_class Codes autorisés Noms YAML Comportement en cas de discordance
SCT_013 {1, 2, 3, 4, 5, 6, 7} SCT_013_005/010/030/050/100/020/060 cv.Invalid avec une indication
WIRED_CT {1–10, 12} WIRED_CT_ (par exemple WIRED_CT_6) cv.Invalid
BUILTIN_CT {} (aucun) — cv.Invalid (tout ct_model est rejeté)
UNSET {} — cv.Invalid (classe non définie)

Specifically:

  • SCT_013 non contigu : les codes acceptés sont {1, 2, 3, 4, 5, 6, 7} (SCT_013_005, _010, _030, _050, _100, _020, _060) ; l'ordre des codes n'est pas l'ordre des calibres.

  • WIRED_CT est la classe des modules fournis avec leur propre pince filaire ; le schéma accepte les codes 1/2/3 pour elle. Le module est étalonné en usine avec ce capteur, donc le composant refuse de changer la classe ou le modèle (voir la remarque sur les modules appairés ci-dessus).

  • BUILTIN_CT est la classe des modules à capteur intégré ; ct_model: n'est ni nécessaire ni accepté par le schéma. Déclarer BUILTIN_CT sans le matériel correspondant n'a aucun sens.

Si le YAML passe le validateur (ancien schéma + nouveau firmware, forçage manuel), le firmware renvoie REG_ERROR = 0xFE DEV_ERR_PARAM — le module n'écrira pas un code non pris en charge : il renvoie DEV_ERR_PARAM et les miroirs restent à la valeur précédente.

Comment reconnaître le module

Il y a deux clés dans le YAML — vous en choisissez une selon que vous avez la même pince sur tous les canaux ou des pinces différentes. La transition syntaxique va d'une valeur scalaire à une liste YAML (tableau) :

Étape 1 — une seule pince pour tous les canaux (ct_model:, valeur unique)

Si vous avez un UI1 (un seul canal de courant) ou un UI3 avec des pinces identiques sur les trois canaux — une seule ligne :

YAML
rbamp:
  id: meter1
  ct_model: SCT_013_030      # ← scalar value, one model for all channels

C'est le cas le plus courant. La plupart des déploiements commencent avec un seul modèle de pince et ne dépassent jamais cette gamme.

Étape 2 — pinces différentes sur des canaux différents (ct_models:, liste)

Si vous avez un UI2 / UI3 et voulez mettre des pinces différentes sur les canaux (par exemple une petite pince sur une ligne de veille, une grande sur l'arrivée principale) — remplacez ct_model: par ct_models: (avec un s final) et utilisez une liste YAML entre crochets :

YAML
rbamp:
  id: meter_ui3
  ct_models: [SCT_013_005, SCT_013_030, SCT_013_020]
  #         ↑                            ↑                           ↑
  #     channel 0                     channel 1                channel 2
  #
  # This is a standard YAML list (1..16 elements; only as many as the module has channels are applied).
  # Order matters: the position in the list = the channel index.
  # Mixed codes such as [1, 3, 6] are each kept on their own channel.

C'est le point où l'on se trompe le plus souvent en modifiant des systèmes multi-canaux. Rappel : ct_model: (sans s) est une valeur scalaire pour un modèle unique ; ct_models: (avec s) est une liste de valeurs entre crochets, une par canal. Seul le nombre d'entrées égal au nombre de canaux du module est appliqué (1 pour UI1, 2 pour UI2, 3 pour UI3) ; les entrées en trop sont ignorées avec un avertissement.

Modules STANDARD (STD).

Les modèles par canal ne sont stockés que par les modules qui les conservent à travers une coupure d'alimentation. Si le module connecté ne le fait pas, le composant refuse bruyamment (avertissement, clés ignorées) plutôt que d'écrire une valeur qui reviendrait silencieusement en arrière — utilisez alors le ct_model: unique.

⚠ Mutuellement exclusifs. Déclarer à la fois ct_model: ET ct_models: est une erreur de validation de schéma (cv.Invalid). N'utilisez qu'une des deux.

Installation UI3 avec pinces de tailles différentes

Le scénario de référence pour un logement avec sa propre production ou avec des types de charges mixtes :

  • Canal 0 — petits consommateurs (éclairage LED, mode veille, électronique). Une pince SCT_013_005 (5 A) offre une résolution maximale à faible courant.
  • Canal 1 — charges principales (plaque, chauffe-eau). Une pince SCT_013_030 (30 A) couvre la pointe domestique typique.
  • Canal 2 — une dérivation de puissance moyenne (chauffe-eau, ~3-5 kW). Une pince SCT_013_020 (20 A) est le bon compromis entre précision et marge pour un sous-compteur typique.

Dans un seul bloc YAML rbamp:, il suffit de déclarer :

YAML
rbamp:
  id: home_meter
  ct_models: [SCT_013_005, SCT_013_030, SCT_013_020]

sensor:
  - platform: rbamp
    rbamp_id: home_meter
    voltage:
      name: "Mains Voltage"
    current:
      name: "Lighting Current"     # SCT_013_005, channel 0
    current_1:
      name: "Appliances Current"   # SCT_013_030, channel 1
    current_2:
      name: "Boiler Current"       # SCT_013_020, channel 2
    # ...power_0/_1/_2, energy_0/_1/_2 likewise

Le composant lui-même attribue le modèle exact à chaque canal au démarrage.

Ce que fait la clé en coulisses

Sur le firmware v1.2+, l'écriture de ct_model: / ct_models: charge de façon atomique les coefficients d'usine (bruit de fond + gain) du modèle choisi dans la RAM du module et les sauvegarde en flash. Aucune étape de calibrage supplémentaire n'est requise côté utilisateur — le module sort d'usine avec toutes les tables de coefficients nécessaires.

Sur un firmware antérieur, la valeur est stockée comme marqueur de modèle.

Lecture-comparaison-écriture (v1.3+) — pourquoi le démarrage est désormais « instantané »

Au démarrage, le composant v1.3 lit les REG_CT_MODEL_CH0/1/2 actuels (miroirs de 0x51-0x53) et les compare aux valeurs demandées dans le YAML. Si elles concordent, l'écriture en flash est ignorée entièrement.

Scénario de démarrage v0.4.0 (écriture systématique) v1.3 (lecture-comparaison-écriture)
Configuration déjà appliquée (les miroirs correspondent) ~700 ms × N canaux d'effacement flash 0 ms (relecture I²C uniquement)
Configuration modifiée (un modèle) ~700 ms ~700 ms (delta uniquement)
UI3 avec trois modèles différents (installation à froid) ~2.8 s de coupure ~2.1 s (3 × 700 ms + vérification)
UI3 avec les mêmes modèles (démarrage à chaud) ~2.8 s de blackout à chaque fois ~0 ms

En pratique : conservez ct_model: / ct_models: dans le YAML en permanence — la configuration est idempotente et n'use pas la mémoire flash aux démarrages répétés.

Changer le calibre SCT conserve la précision

Sur un module STD, ct_model n'est qu'une étiquette et ne règle aucun gain. Le reste de cette section décrit les modules BASIC.

Chaque module SCT est étalonné en usine avec le SCT-013-030. Lorsque vous sélectionnez un autre calibre (ct_model: SCT_013_010, par exemple), courant, puissance et énergie restent précis — l'étalonnage unitaire d'usine est préservé :

  • Sur les firmwares de module jusqu'à 1.4.19, le composant termine l'écriture du modèle avec le redémarrage du module requis par la procédure (sauvegarde, reset, nouvelle identification) et met à l'échelle le courant, les puissances active et réactive et l'énergie vers le capteur sélectionné, à partir du gain réellement appliqué par le module. Le redémarrage apparaît dans le journal et est normal ; les capteurs peuvent sauter un cycle. Un redémarrage ultérieur du module (le vôtre ou externe) est détecté et la mise à l'échelle se recalcule automatiquement.

  • Sur les firmwares plus récents (1.4.20+), le module effectue la bascule lui-même ; le composant le détecte et laisse les relevés intacts (simple écriture de modèle, sans redémarrage).

  • La tension et le facteur de puissance ne sont pas affectés.

  • Si le gain appliqué par le module diffère de la valeur attendue de plus de ±5 %, le composant journalise un avertissement et ne met pas à l'échelle.

Aucune modification YAML n'est nécessaire pour tout cela.

Liaison multi-canaux

Le composant lie les canaux un par un ; l'ordre n'a pas d'importance. Des modèles mixtes sur un même module (par exemple les codes [1, 3, 6] sur un module à trois canaux) sont chacun conservés sur leur propre canal.

Le composant alimente lui-même le chien de garde (App.feed_wdt()) pendant chaque fenêtre d'écriture flash — le budget typique de 15 s de setup() d'ESPHome n'est pas dépassé, même lors d'une installation à froid d'un UI3.

Vérification de l'installation

Après le premier démarrage, vérifiez les relevés sur une charge purement résistive — une ampoule à incandescence, une bouilloire, une résistance chauffante. Une charge résistive donne une forme de signal connue :

  • Le facteur de puissance (power_factor) doit être proche de 1.00 (nettement supérieur à 0.95).
  • La puissance active (power) doit être positive et stable.
  • Le courant efficace (current) doit correspondre à P / U avec une précision raisonnable.

Si les relevés ne concordent pas :

  • current constamment ~0 avec la charge en marche → vérifiez la polarité et que la pince entoure un seul conducteur (voir ci-dessous)
  • power systématiquement négatif → inversez la pince sur le conducteur (flèche dans l'autre sens)
  • power_factor ~0.5..0.7 sur une ampoule à incandescence → une charge réactive est peut-être à proximité, ou la pince est mal installée

Les diagnostics détaillés orientés symptômes figurent dans 10_troubleshooting.md.

Polarité de la pince CT

Le corps de la pince porte une flèche indiquant le sens « normal » du flux d'énergie (consommation, vers la charge). Avec une installation correcte (la flèche orientée dans le sens du courant entrant dans la charge) :

  • P_real > 0 — consommation.
  • P_real < 0 — export (STANDARD (STD) uniquement).

Si la puissance active est négative avec un consommateur en marche — retournez physiquement la pince sur le conducteur. Ne corrigez pas la polarité dans le logiciel : cela masque les erreurs de sens dans les automatisations en aval.

La pince doit se refermer complètement autour d'un seul conducteur. Ne passez jamais L et N dans une même pince — leurs champs magnétiques s'annulent et le capteur lit presque zéro.

Canal de tension

Les références UI* intègrent un transformateur de tension. L'enroulement primaire se connecte aux bornes L et N du secteur par les borniers du module, que celui-ci mesure en interne.

La configuration d'usine du transformateur est figée sur la révision de la carte — l'utilisateur n'a rien à configurer. Le capteur voltage est prêt à fonctionner dès la sortie de boîte.

Les références I seules (I1 / I2 / I3) n'ont pas de canal de tension. Le slot voltage y renvoie 0 et ne doit pas être déclaré avec power: ou energy: (le validateur du schéma contrôle cette dépendance).

Modules multi-canaux

Sur UI2 / UI3, chaque canal est un circuit de mesure distinct et indépendant, et non un noyau magnétique partagé. Cela vous permet de :

  • Mettez un seul modèle de pince sur tous les canaux (ct_model:) — la configuration habituelle pour des charges uniformes.
  • Placez les différents modèles sur des canaux différents (ct_models:) — pour optimiser la précision sur les installations mixtes (voir ci-dessus).
  • Affectez un canal à la consommation et un autre à l'export solaire — la polarité de chaque canal se règle indépendamment selon le sens physique de la pince.

Et ensuite


Source et problèmes : rb-amp/rbamp-esphome · cette page dans le dépôt : docs/03_sensor_selection.md (v1.9.1)