Piekļuves kontrole · Paxton Net2 · OEM SDK · OSDP v2 · KNX · 10 min lasīšanai

Paxton Net2 un KNX: integrācija ar OEM SDK un durvju notikumu automatizācija

Paxton Net2 ir viena no visplašāk izmantotajām piekļuves kontroles sistēmām Apvienotās Karalistes komerciālajās ēkās, viesnīcās un skolās. Savienojot Net2 durvju notikumus ar KNX, iespējams vadīt apkuri un ventilāciju atkarībā no cilvēku klātbūtnes, automātiski ieslēgt apgaismojumu pēc piekļuves notikumiem un integrēt enerģijas taupīšanas kartes viesnīcās — izmantojot OEM SDK, RS232 seriālo izeju vai OSDP v2 lasītāju protokolu.

Paxton Net2 pārskats un integrācijas iespējas

Paxton Net2 Pro un Net2 Access Control programmatūra darbojas uz Windows datora, kas kalpo kā piekļuves kontroles serveris. Net2 ACU (piekļuves kontroles iekārtas) savienojas ar serveri caur atsevišķu RS485 tīklu vai Ethernet, pārvaldot lasītājus, durvju slēdzenes un ieejas/izejas punktus visā ēkā. KNX savienojumam ir trīs integrācijas ceļi:

MetodePrasībasKavējumsVislabāk piemērots
OEM SDK (COM API)Net2 Pro, C# Windows serviss, knxdotnet bibliotēka1-2 sekundesPilna notikumu piekļuve, vairākas durvis
RS232 seriālā izejaNet2 ACU RS232 ports, Node-RED seriālais mezgls1-3 sekundesVienkāršas vienas durvju iekārtas
OSDP v2 + BeckhoffOSDP saderīgs ACU, TwinCAT + EL6700 RS485Zem 500 msUzņēmuma līmenis, bez datora servera

Net2 OEM SDK ir COM bāzēts API, kas pieejams Paxton izstrādātāju portālā — nepieciešams NDA un reģistrācija. SDK galvenokārt izmanto sistēmu integratori, veidojot pielāgotu pārvaldības programmatūru. KNX integrācijai visefektīvākā pieeja ir viegls C# Windows serviss, kas izmanto SDK un nodrošina piekļuvi visiem Net2 notikumu veidiem un durvju vadības komandām.

C# integrācijas serviss ar Net2 OEM SDK

C# Windows serviss abonē Net2 COM notikumus un nosūta atbilstošos notikumus uz KNX caur KNX IP interfeisu. knxdotnet bibliotēka (pieejama NuGet) nodrošina .NET grupas telegrammu sūtīšanu KNX. Durvju ID un KNX grupas adreses kartējums tiek glabāts XML vai JSON konfigurācijas failā, atvieglojot atjaunināšanu bez pārkompilēšanas.

C# Net2 SDK notikumu abonēšana (vienkāršoti)

// 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" }

Alternatīva caur RS232 seriālo portu

Vienkāršākām instalācijām, kur nav nepieciešams pilns SDK, Net2 ACU RS232 seriālais ports izvada ASCII notikumu virknes pie katra piekļuves notikuma. Šī pieeja neprasa SDK licenci un to var apstrādāt ar Node-RED un seriālo mezglu — noderīgi, ja instalācijā jau tiek izmantots Node-RED citām ēkas automatizācijas funkcijām.

RS232 seriālo notikumu formāts un parsēšana 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

Praktisks scenārijs: biroju ēka Apvienotajā Karalistē

Tipiska Apvienotās Karalistes biroju ēka ar Net2 pie galvenās ieejas un avārijas izejas durvīm izmanto SDK servisu, lai vadītu KNX automatizāciju, pamatojoties uz noslogojumu. Modelis “pēdējais lietotājs izgājis” novērš nepieciešamību pēc laika grafikiem un reaģē uz faktisko ēkas izmantošanu.

Birojs Apvienotajā Karalistē — no piekļuves notikumiem līdz ēkas vadībai caur 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

OSDP v2 integrācija ar Beckhoff TwinCAT

Net2 ACU atbalsta OSDP v2 pa RS485 savienojumam ar OSDP saderīgiem karšu lasītājiem. KNX projektiem ar jau esošu Beckhoff TwinCAT kontrolleri panelī, EL6700 RS485 EtherCAT terminālis kopā ar OSDP bibliotēku ļauj vienam kontrollerim apstrādāt gan OSDP lasītāja datus, gan KNX TP kopni — novēršot nepieciešamību pēc Windows datora servera.

Beckhoff TwinCAT OSDP + KNX pieslēgums

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

Viesnīcas istabas kartes integrācija ar KNX enerģijas slēdzi

Paxton Net2 bieži izmanto viesnīcu istabu ieejā ar karšu lasītājiem. Kartes ievietošanas notikums iedarbina istabas sagaidīšanas ainu caur KNX, bet kartes izņemšana uzsāk laika noteiktu enerģijas samazināšanas secību, kad istaba nav aizņemta.

No viesnīcas istabas kartes līdz KNX sagaidīšanas ainai

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

Net2 noslogojuma datu un KNX enerģijas skaitītāju datu apvienošana

Net2 atskaites eksportē noslogojuma žurnālus — lietotāju skaits stāvā stundā — CSV formātā. Apvienojot ar KNX enerģijas skaitītāju datiem no Modbus skaitītājiem (SOCOMEC Countis, ABB B24), tas ļauj korelēt noslogojumu un enerģijas patēriņu. Šī datu apvienošana sniedz pierādījumus BREEAM Hea 04 novērtējumam par iemītnieku labklājību.

Noslogojuma un enerģijas datu korelācijas process

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

Paxton izstrādātāja piekļuve: Lai izmantotu Net2 OEM SDK, jāreģistrējas Paxton izstrādātāju portālā vietnē developer.paxton.co.uk. Pirms SDK dokumentācijas un bibliotēku saņemšanas jāparaksta NDA līgums. Piekļuve portālam parasti tiek apstiprināta 2–5 darba dienu laikā. SDK ir bezmaksas — licences maksa netiek piemērota.

Vajadzīgs KNX panelis ar iebūvētu Paxton Net2 integrāciju?

Mēs projektējam un izgatavojam zemsprieguma paneļus ar Net2 SDK Windows servisu, KNX IP interfeisa konfigurāciju, OSDP v2 Beckhoff TwinCAT integrāciju un pilnu nodošanas dokumentāciju, kas tiek piegādāta uz jūsu objektu pēc testēšanas.

Pieprasīt cenu →
Ielādējas...
Uz augšu