Hexagon Lidar

Hexagon Lidar

ID: uniflow.plugin.hexagonlidar Category: Security & Sensors Version: v1.3.0 Min Uniflow Version: Uniflow ≥ v1.4.0

Hexagon Lidar Plugin Reference Manual

1. Overview

Plugin Name: Hexagon Lidar

Type: Security & Sensors

Identifier: uniflow.plugin.hexagonlidar

Description

Integration with Hexagon Lidar devices via gRPC API.


2. Technical Architecture

The Hexagon Lidar plugin connects to Hexagon Leica 3D Lidar sensors and spatial processing engines over gRPC stream channels. It streams real-time 3D point cloud telemetry, processes zone intrusion alarms and object detection bounding boxes, monitors sensor connectivity health, and dispatches spatial alert events into the Uniflow catalog.

System Interaction & Exposed Catalog Routes

The Hexagon Lidar plugin connects via gRPC to Leica / Hexagon 3D perception hardware. It receives real-time spatial point cloud object detections, intrusion boundary alarms, and 3D bounding box coordinates.

Catalog Routes & Node Integration

Input Event Triggers (Input Nodes):

  • hexagon.object_detected - Fired when a 3D spatial object is classified.
  • hexagon.zone_intrusion - Fired on perimeter zone intrusion.
  • hexagon.telemetry_stream - Real-time point cloud telemetry.
  • Executable Actions (Action Nodes):

  • hexagon.set_active_zone - Configures active detection zone mask.
  • hexagon.recalibrate_sensor - Triggers sensor recalibration.
  • hexagon.request_snapshot - Requests a 3D point cloud frame.
  • Architecture Diagram

    VISUAL ARCHITECTURE FLOW DIAGRAM
    Rendering Flow Architecture Diagram...

    3. Configuration Parameters

    The following configuration fields are available in the User Interface for this plugin:

    Configuration SettingDescription
    Host Address / IPSpecifies the host address / ip.
    PortNumeric value specifying the port.
    UsernameSpecifies the username.
    PasswordSpecifies the password (secure).
    Reconnect Interval (ms)Numeric value specifying the reconnect interval (ms).

    4. Exposed Routes & Data Types

    This plugin exposes catalog fields across the following rule graph nodes:

    Input Source

    The Input Source node reads 3D object detection state and zone alarm outputs.

    Human-Readable Field NameData TypeDescription
    Zone Alarm Point  Json
    Live zone intrusion/alarm state object containing zone ID, alarm ID, and action state.
    Detected Object Point  Json
    Live tracked 3D object state containing object type, AI class, 3D position coordinates, extent, and velocity.

    Event Input

    The Event Input node listens for real-time gRPC perimeter alarm streams and 3D point cloud object tracking events.

    Human-Readable Field NameData TypeExposed Event Fields & Data TypesDescription
    Perimeter Alarm Event  Event Object
    id (String)
    zone_id (String)
    action (String)
    Real-time event triggered when a perimeter zone breach occurs.
    Object Tracked Event  Event Object
    id (String)
    type (String)
    activity (String)
    points_count (Int32)
    zone_id (String)
    position (Array)
    extent (Array)
    velocity (Array)
    ai_detected_class (String)
    Real-time streaming event for 3D point-cloud object detection and spatial tracking.

    5. Usage Examples

    Scenario A: Hexagon LiDAR 3D Zone Intrusion Triggers Avigilon PTZ Preset & Media Snapshot

    Workflow Overview:

    When Hexagon 3D LiDAR detects perimeter intrusion in Zone_A (hexagon.zone_intrusion / Perimeter Alarm Event), Uniflow intercepts the gRPC alarm payload, moves Avigilon camera CAM-04 to PTZ Preset 2, and triggers an automated image snapshot download.

    Rule Node Configuration:

    1. Event Input Node: Hexagon LiDAR Listener

  • Filter Event: Perimeter Alarm Event (hexagon.zone_intrusion)
  • Exposed Fields: zone_id (String), id (String), action (String)
  • 2. Logic Condition Node: Equal

  • Expression: zone_id == "Zone_A"
  • 3. Output Target Node A: Avigilon ACC PTZ

  • Action Target: PTZ Preset Action
  • CameraGuid: CAM-04_GUID
  • PresetId: 2
  • 4. Output Target Node B: Avigilon ACC Media

  • Action Target: Get Media (GET_MEDIA)
  • CameraGuid: CAM-04_GUID
  • Logic Flow Diagram:

    VISUAL ARCHITECTURE FLOW DIAGRAM
    Rendering Flow Architecture Diagram...

    Scenario B: 3D LiDAR Tracked Object Triggers Modbus Security Gate Barrier Relay

    Workflow Overview:

    When Hexagon LiDAR tracks a moving vehicle object (ai_detected_class == "Vehicle") inside restricted access zone Zone_B, Uniflow sets a Modbus TCP relay coil (Coil 7 = True) to close the physical security gate barrier.

    Rule Node Configuration:

    1. Event Input Node: Hexagon LiDAR Listener

  • Filter Event: Object Tracked Event (hexagon.object_detected)
  • Exposed Fields: ai_detected_class (String), zone_id (String), velocity (Array)
  • 2. Logic Filter Node: And Condition

  • Expression: ai_detected_class == "Vehicle" AND zone_id == "Zone_B"
  • 3. Output Target Node: Modbus Client Writer

  • Action Target: Direct Access
  • Type: Coils
  • Address: 7
  • Value: True
  • Logic Flow Diagram:

    VISUAL ARCHITECTURE FLOW DIAGRAM
    Rendering Flow Architecture Diagram...
    Architecture Flow Diagram — Full Preview