Contrôle d'accès · Paxton Net2 · SDK OEM · OSDP v2 · KNX · 10 min de lecture

Paxton Net2 Contrôle d'accès vers KNX : SDK OEM et automatisation des événements de porte

Paxton Net2 est l'un des systèmes de contrôle d'accès les plus installés dans les bâtiments commerciaux, hôtels et écoles au Royaume-Uni. Connecter les événements de porte Net2 à KNX permet le CVC piloté par l'occupation, les réponses d'éclairage automatiques aux événements d'accès et l'intégration de la carte énergétique de chambre d'hôtel – en utilisant le SDK OEM Net2, la sortie série RS232 ou le protocole de lecteur OSDP v2.

Aperçu de Paxton Net2 et options d'intégration

Le logiciel Paxton Net2 Pro et Net2 Access Control s'exécute sur un PC Windows servant de serveur de contrôle d'accès. Les unités de contrôle d'accès Net2 ACU se connectent au serveur via un réseau RS485 dédié ou Ethernet, gérant les lecteurs, les gâches électriques et les points d'entrée/sortie dans tout le bâtiment. Trois voies d'intégration existent pour la connectivité KNX :

Méthode	Prérequis	Latence	Meilleur pour
SDK OEM (API COM)	Net2 Pro, service Windows C#, bibliothèque knxdotnet	1-2 secondes	Accès complet aux événements, multi-portes
Sortie série RS232	Port RS232 de Net2 ACU, nœud série Node-RED	1 à 3 secondes	Configurations simple porte unique
OSDP v2 + Beckhoff	ACU compatible OSDP, TwinCAT + EL6700 RS485	Moins de 500 ms	Enterprise, pas de serveur PC nécessaire

Le SDK OEM Net2 est une API basée sur COM disponible sur le portail développeur Paxton – un NDA et une inscription sont requis. Le SDK est principalement utilisé par les intégrateurs de systèmes construisant des logiciels de gestion personnalisés. Pour l'intégration KNX, un service Windows léger en C# utilisant le SDK est l'approche la plus performante, donnant accès à tous les types d'événements Net2 et aux commandes de contrôle de porte.

Service d'intégration C# pour le SDK OEM Net2

Le service Windows C# s'abonne aux événements COM Net2 et transmet les événements pertinents à KNX via l'interface KNX IP. La bibliothèque knxdotnet (disponible sur NuGet) fournit l'envoi natif .NET de télégrammes de groupe KNX. Le mappage ID de porte / adresse de groupe KNX est stocké dans un fichier de configuration XML ou JSON, facilitant les mises à jour sans recompilation.

Abonnement aux événements du SDK Net2 en C# (simplifié)

// Install: Paxton.Net2.OemClientLibrary (COM reference)
// Install: KNXLib (NuGet) — knxdotnet KNX IP Interface

var net2 = new Paxton.Net2.OemClient();
net2.Connect("localhost", Net2Port);
net2.OnEventReceived += OnNet2Event;

void OnNet2Event(Net2Event evt) {
  switch (evt.EventType) {
    case EventType.AccessGranted:
      var mapping = config.GetKnxMapping(evt.DoorId);
      if (mapping != null) {
        knx.Action(mapping.GroupAddress, true); // DPT 1.001
        knx.Action(mapping.HvacGroupAddress, true); // HVAC occupied
      }
      break;
    case EventType.AccessDenied:
      // optional: write to security alert GA
      break;
    case EventType.AlarmActivated:
      knx.Action("8/0/1", true); // alarm relay
      break;
  }
}

// config.json mapping example:
// { "doorId": 101, "ga": "3/0/1", "hvacGa": "4/0/1" }
// { "doorId": 102, "ga": "3/1/1", "hvacGa": "4/1/1" }

Alternative de sortie série RS232

Pour les installations plus simples où le SDK complet n'est pas nécessaire, le port série RS232 du Net2 ACU émet des chaînes d'événements ASCII à chaque événement d'accès. Cette approche ne nécessite pas de licence SDK et peut être traitée par Node-RED avec le nœud série – utile lorsque l'installation utilise déjà Node-RED pour d'autres fonctions d'automatisation du bâtiment.

Format d'événement série RS232 et analyse Node-RED

Net2 ACU RS232 output (9600 baud, 8N1):
  ASCII string per event: "DOOR:101,EVENT:ACCESS_GRANTED,USER:Smith
"

Node-RED serial in node:
  Port: /dev/ttyUSB0 (or COM3 on Windows)
  Baud: 9600, 8N1
  Split: on newline character

Function node — parse and route:
  const parts = msg.payload.split(",");
  const doorId = parts[0].split(":")[1];
  const event = parts[1].split(":")[1];
  if (event === "ACCESS_GRANTED" && doorId === "101") {
    msg.knxGA = "3/0/1";
    msg.knxValue = true;
  }
  return msg;

KNX write node → IP Interface → KNX bus

Limitation: RS232 event format is not officially documented
  by Paxton — verify exact format with your ACU firmware version
  before building production automation on this approach

Scénario pratique d'un immeuble de bureaux britannique

Un immeuble de bureaux britannique typique avec Net2 à l'entrée principale et à la sortie de secours utilise le service SDK pour piloter l'automatisation KNX basée sur l'occupation. Le modèle last-user-out élimine le besoin de plannings horaires et répond à l'utilisation réelle du bâtiment.

Bureau britannique – événement d'accès vers le contrôle du bâtiment KNX

Morning arrival (first AccessGranted at main entrance):
  → KNX GA 3/0/0 = true (lobby lights ON)
  → KNX GA 4/0/0 = true (HVAC building occupied mode)
  → KNX GA 5/0/0 = false (disable night setback)

End of day — last user leaves after 18:00:
  C# service tracks occupancy count per door zone
  When count reaches zero after 18:00:
  → KNX GA 4/0/0 = false (HVAC setback mode)
  → KNX GA 3/0/0 = false (lights off — after 60s delay)
  → KNX GA 5/0/0 = true (night setback active)

Fire alarm integration (Net2 AlarmActivated event):
  → KNX GA 8/0/1 = true (fire alarm relay to KNX PA system)
  → KNX GA 3/0/1 = 255 (emergency lighting full brightness)
  Net2 also releases all doors to fail-safe unlocked state
  KNX door strike outputs (if any) also release via KNX GA

Intégration OSDP v2 avec Beckhoff TwinCAT

Les ACU Net2 prennent en charge OSDP v2 sur RS485 pour la connexion aux lecteurs de cartes conformes OSDP. Pour les projets KNX avec un automate Beckhoff TwinCAT déjà dans l'armoire, le terminal EL6700 RS485 EtherCAT combiné à une bibliothèque OSDP permet à un seul contrôleur de gérer à la fois les données du lecteur OSDP et le bus KNX TP – éliminant ainsi le besoin d'un serveur Windows.

Câblage Beckhoff TwinCAT OSDP + KNX

Hardware:
  Beckhoff CX9020 controller
  EL6700 RS485 EtherCAT terminal → OSDP v2 reader (RS485 bus)
  EL6900 KNX EtherCAT terminal → KNX TP bus

TwinCAT configuration:
  Install OSDP library (Beckhoff TE6730 or third-party)
  Configure EL6700 as OSDP master, reader as slave ID 1
  Map card number data → TwinCAT PLC variable CardNumber

TwinCAT PLC logic (Structured Text):
  IF CardNumber <> 0 AND CardNumber = ValidCard1 THEN
    KNX_WriteGA(GA := '3/0/1', Value := TRUE); // lobby lights
    KNX_WriteGA(GA := '4/0/1', Value := TRUE); // HVAC occupied
  END_IF

Advantage: no Windows PC server required
  DIN-rail controller fits inside LV panel
  KNX EL6900 certified for KNX TP communication
  Single controller, single point of maintenance

Intégration de carte de chambre d'hôtel avec interrupteur énergétique KNX

Paxton Net2 est fréquemment utilisé pour l'entrée des chambres d'hôtel avec des lecteurs de cartes à glisser. L'événement d'insertion de la carte déclenche la scène de bienvenue de la chambre via KNX, tandis que le retrait de la carte lance une séquence de réduction temporisée pour réduire la consommation d'énergie lorsque la chambre est inoccupée.

Carte de chambre d'hôtel vers scène d'accueil KNX

Card inserted into room holder (Net2 AccessGranted):
  → KNX GA 6/R/0 = true (Gira card switch 24V trigger activated)
  → KNX Scene "Room Welcome" fires:
      GA 3/R/0 = 80 (room lights 80% DPT 5.001)
      GA 4/R/0 = true (HVAC room comfort mode)
      GA 9/R/0 = 21 (room thermostat setpoint 21°C)

Card removed from holder (Net2 AccessGranted — out):
  → KNX GA 6/R/0 = false (Gira card switch deactivated)
  → KNX 60-second delay timer starts
  → After 60s:
      GA 3/R/0 = 0 (room lights off)
      GA 4/R/0 = false (HVAC setback mode)
      GA 9/R/0 = 18 (setback setpoint 18°C)

Net2 room door reader also logs entry/exit times
  — useful for housekeeping scheduling and BREEAM evidence

Note: R = room number (1-100) in the GA scheme
  Each room has its own GA sub-group for independent control

Fusion des données d'occupation Net2 et des compteurs d'énergie KNX

Les rapports Net2 exportent les journaux d'occupation — utilisateurs présents par étage par heure — au format CSV. Combinés avec les données des compteurs d'énergie KNX provenant de compteurs connectés Modbus (SOCOMEC Countis, ABB B24), cela permet de corréler l'occupation et la consommation d'énergie. Cette fusion de données fournit des preuves pour les évaluations de bien-être des occupants BREEAM Hea 04.

Workflow de corrélation des données d'occupation et d'énergie

1. Net2 scheduled report: export occupancy_floor_hourly.csv
   Columns: date, hour, floor, user_count
   Automation: Net2 Task Scheduler exports nightly at 01:00

2. KNX energy meter data (SOCOMEC Countis E14):
   Modbus TCP → LOYTEC LROC gateway → KNX GA 6/E/1 (kWh)
   Logged to building energy management system (BEMS) database
   or InfluxDB via Node-RED

3. Python script merges datasets:
   energy_per_hour = InfluxDB query (kWh by floor, by hour)
   occupancy_per_hour = CSV import (users by floor, by hour)
   energy_per_person = energy_per_hour / occupancy_per_hour
   Output: energy_intensity.csv for BREEAM assessor

4. BREEAM Hea 04 evidence:
   Demonstrates energy reduction during low occupancy periods
   Confirms KNX setback automation is effective
   Shows energy-per-person improvement over 12-month period

Accès développeur Paxton : le SDK Net2 OEM nécessite une inscription sur le portail développeur Paxton à developer.paxton.co.uk. Un NDA doit être signé avant que la documentation et les bibliothèques SDK ne soient fournies. Compter 2 à 5 jours ouvrés pour l'approbation de l'accès au portail. Le SDK est gratuit — aucun frais de licence ne s'applique.

Guides associés

Contrôle d'accès et intégration KNX

API REST Gallagher Command Centre vers KNX : Event Bridge avec Node-RED

Contrôle d'accès et intégration KNX

Systèmes de portes en ligne SALTO et ASSA ABLOY : Intégration KNX via OSDP et BACnet

Solutions

Technologies

Knowledge

Company