Overview

Gallagher Command Centre (CC) 8.x integrates with KNX building automation to create unified smart building responses — card reader events trigger lighting and HVAC scenes, while KNX pushbuttons release doors from reception panels.

REST API OAuth2 Authentication

CC REST API v8 uses OAuth2 client credentials: POST 'https://{cc-server}/api/access_control/rest/v1/oauth2/token' with body 'grant_type=client_credentials&client_id={id}&client_secret={secret}'. Returns JSON with 'access_token' and 'expires_in' (3600). Client credentials configured in CC server: Configuration > REST Clients > add client, assign read-events and command-doors permissions.

Node-RED Implementation

Node-RED (Raspberry Pi 4 or mini-PC on building LAN): install node-red via npm.

Flow 1 (events): HTTP request node polls 'GET https://{cc-server}/api/access_control/rest/v1/events?after={last_timestamp}' with bearer token every 2s. Parse JSON response via switch node: filter 'eventType = cardReadValid'. For each valid event: extract door name and cardholder, then write to KNX node (Weinzierl IP Interface) targeting scene GA matching door. Door 'Main Entrance' cardReadValid triggers KNX scene 1 (lobby full lighting, HVAC occupied). Door 'Server Room' cardReadValid triggers KNX GA 9/1/1 (IT room STULZ precision cooling mode change).

Flow 2 (door release from KNX): KNX read node subscribes to GA '8/5/1' (reception door release button). On value=1: HTTP POST 'https://{cc-server}/api/access_control/rest/v1/doors/{door_id}/access' with bearer token triggers Gallagher to unlock door for standard grant duration.

Gallagher Webhooks

CC 8.10+ supports webhooks: configure webhook endpoint 'http://{nodered-ip}:1880/gallagher-event' in CC. Node-RED HTTP input node receives real-time push events — eliminates 2s polling latency. Preferred for time-critical security applications.

Anti-Passback Integration

Gallagher anti-passback violation generates 'accessDeniedAntiPassback' event: KNX GA 8/0/5 ON (security alert, sounds audible alert at security desk, PTZ camera to door position).

Multi-Floor Occupancy Management

Card reader zones map to KNX HVAC zones. When last person leaves floor 2 (Gallagher last-person-out zone event): KNX HVAC zone 2 setback (18 degrees C heating, no cooling) plus lights off. Saves 20-30% HVAC energy in variable occupancy offices.