# Luciai Multiconnector — Complete Technical Specification & LLM Reference Developer: Luciai Tecnologia Product Website: https://multiconnector.luciai.com.br Corporate Website: https://www.luciai.com.br Contact: comercial@luciai.com.br Release Version: 2026.1 Languages: Portuguese (pt-BR), English (en-US), Spanish (es-ES) --- ## 1. Executive Summary & Architecture Luciai Multiconnector is a high-performance industrial data bridge and edge gateway software. It solves interoperability fragmentation across plant floors by reading telemetry and control variables from disparate industrial sources, applying mathematical transformations and type conversion in memory, and writing to target destinations. ### Architectural Principles: 1. **100% On-Premise Execution**: Runs inside the plant network (OT domain). The web server, configuration store, and execution engine do not depend on external cloud connectivity. 2. **Deterministic Processing**: Features dedicated scan groups, configurable poll rates, worker concurrency controls, write throttling, and batch commits. 3. **Hardware-Locked Cryptographic Security**: Activation licenses are cryptographically generated from the physical host machine fingerprint (.request file to .license file). 4. **Resilience & High Availability**: Native background service integration with Active/Standby failover topology using distributed database leases. --- ## 2. Industrial Protocol Compatibility Matrix | Protocol | Category | Supported Direction | Operating System | Typical Industrial Use Case | |---|---|---|---|---| | OPC UA | Industrial OPC | Source / Destination / Bidirectional | Windows & Linux | SCADA, DCS, and modern PLC integration with x509 cryptographic security | | OPC DA | Industrial Classic | Source / Destination / Bidirectional | Windows | Direct bridging of legacy COM/DCOM OPC servers into modern systems | | MQTT | IoT / Cloud / Edge | Source / Destination / Bidirectional | Windows & Linux | Publish and subscribe integration with enterprise brokers and IoT platforms | | Siemens S7 | PLC Automation | Source / Destination | Windows & Linux | Direct S7 Ethernet protocol to S7-300, S7-400, S7-1200, and S7-1500 controllers | | Modbus TCP | Field Bus | Source / Destination | Windows & Linux | Communication with power meters, RTUs, and distributed industrial transmitters | | CSV / DAT | Batch / Files | Source / Destination | Windows & Linux | Automated ingestion or scheduled generation of structured delimited flat files | | PI SDK | Historian | Source / Destination | Windows | Native bi-directional streaming to/from OSIsoft PI Data Archive servers | | PI SDK-COM | Legacy Historian | Source / Destination | Windows | Access to OSIsoft PI infrastructure through legacy Windows COM automation | | BridgeLink | Inter-Node Relay | Bidirectional (Relay) | Windows & Linux | Cross-plant encrypted WSS relay with egress queueing and zero tag-by-tag remap | --- ## 3. Protocol Deep Dive & Communication Details ### 3.1 OPC UA (Unified Architecture) - **Role**: Client interface connecting to local or networked OPC UA servers. - **Direction**: Source (Read), Target (Write), or Bidirectional. - **Features**: Subnet server discovery, hierarchical node namespace browsing, subscription monitoring, batch reading/writing, x509 certificate security profiles (Basic256Sha256, Aes128_Sha256_RsaOaep). ### 3.2 OPC DA (Data Access Classic) - **Role**: Native Windows COM/DCOM client for legacy OPC servers. - **Direction**: Source, Target, or Bidirectional. - **Features**: Direct integration on Windows machines without wrapper drivers, bridging legacy SCADA/DCS systems into modern infrastructure. ### 3.3 MQTT - **Role**: MQTT client communicating with local brokers (e.g. Mosquitto, EMQX, HiveMQ) or cloud endpoints. - **Direction**: Source (Subscribe), Target (Publish), or Bidirectional. - **Features**: Configurable topic hierarchies, dynamic JSON or plain-text payload templating, QoS 0/1/2 settings, retain flags, TLS/SSL encryption. ### 3.4 Siemens S7 - **Role**: Direct Ethernet ISO-on-TCP driver for Siemens SIMATIC PLCs. - **Direction**: Source (Read), Target (Write). - **Features**: Compatible with S7-300, S7-400, S7-1200, and S7-1500 controllers. Direct access to Data Blocks (DB), Merkers (M), Inputs (I), and Outputs (Q) via IP, rack, and slot targeting. ### 3.5 Modbus TCP - **Role**: Industrial Ethernet master/client for Modbus field devices. - **Direction**: Source (Read), Target (Write). - **Features**: Holding Registers, Input Registers, Coils, and Discrete Inputs with configurable slave unit IDs, register offsets, and byte-swapping order. ### 3.6 CSV / DAT - **Role**: Scheduled batch file ingestion and export driver. - **Direction**: Source (Ingest), Target (Generate). - **Features**: Monitored filesystem directories, custom delimiter support (comma, semicolon, tab), timestamp format parsing, automated periodic file dumping. ### 3.7 OSIsoft PI SDK & PI SDK-COM - **Role**: High-speed connector to enterprise OSIsoft PI Data Archive servers. - **Direction**: Source (Read recorded/snapshot values), Target (Write points). - **Features**: Hierarchical tag searching on Windows hosts, native point metadata extraction, batch archive queries. ### 3.8 BridgeLink (Multi-Node Encrypted WSS Tunnel) - **Role**: Peer-to-peer relay connecting separate Luciai Multiconnector installations. - **Direction**: Bidirectional relay. - **Features**: Operates over WebSocket Secure (WSS), transfers tag streams across plants or network boundaries without tag-by-tag mapping at intermediate hops. Features local egress queue buffering and bandwidth metering. Pairing is manual with certificate fingerprint authentication. --- ## 4. In-Flight Transformation Engine Every mapped tag pair passes through an in-memory transformation pipeline: - **Linear Scaling**: Output = (Input * Multiplier) + Offset. - **Data Type Casting**: Conversion between Integer, Float, Double, Boolean, String, and DateTime. - **Digital Bit Enumeration**: Maps discrete integer/bit states to descriptive strings (e.g., 0 -> "OFF", 1 -> "RUNNING", 2 -> "FAULT"). - **Bitwise Extraction**: Extracts individual boolean bits from 16-bit or 32-bit registers. - **Payload Synthesis**: Assembles multiple tag values into structured JSON envelopes for MQTT destinations. --- ## 5. Deployment, Services & High Availability ### 5.1 Operating Systems - **Windows**: Windows 10, Windows 11, Windows Server 2016, 2019, 2022. Installs as a Windows Service via `services.msc` with optional designated service credentials. - **Linux**: Ubuntu 20.04+, Debian 11+, RHEL 8+, CentOS 8+. Installs as a systemd background daemon. ### 5.2 High Availability (Active / Standby) - Two instances share access to a central or mirrored SQLite/relational database. - Leader election is governed through a deterministic lease mechanism. - If the active node fails to renew its lease, the standby node assumes execution and resumes reading and writing without data loss. --- ## 6. Industrial Use Cases & Integration Architectures ### 6.1 Plant Floor to Cloud & IIoT Gateways via MQTT - **Source**: Siemens S7 (DBs) / Modbus TCP / OPC UA - **Transformation**: In-flight linear scaling, type conversion, and JSON payload synthesis - **Target**: Enterprise MQTT Broker (AWS IoT, Azure, HiveMQ, Viziodata) - **Benefit**: Direct controller communication eliminating costly intermediate OPC servers or dedicated gateway boxes. Independent poll rates isolate critical fast points from slow monitors. ### 6.2 Native OSIsoft PI System Direct Bidirectional Bridge - **Source**: OSIsoft PI Data Archive via native Windows PI SDK - **Transformation**: Drag-and-drop point mapping, name auto-mapping, engineering unit casting - **Target**: MQTT / OPC UA / Local SCADA / Databases - **Benefit**: Native Windows throughput avoiding sluggish third-party COM wrappers. Allows bidirectional snapshot/archive reads and setpoint writes. ### 6.3 Secure Cross-Plant Tunneling (BridgeLink) - **Source**: Local Luciai Multiconnector Instance (Plant A) - **Transformation**: Mutual certificate-authenticated encrypted WSS tunnel with disk store-and-forward - **Target**: Remote Luciai Multiconnector Instance (Plant B / Central Datacenter) - **Benefit**: Zero data loss during WAN network disconnects via local disk queue buffer. Stream-level forwarding eliminates repetitive tag-by-tag remaps at intermediate hops. ### 6.4 Legacy Modernization: Classic OPC DA to OPC UA & Cloud - **Source**: Classic OPC DA Servers (COM/DCOM local on Windows) - **Transformation**: x509 cryptographic certificate wrapping and structured JSON formatting - **Target**: OPC UA / MQTT / REST API - **Benefit**: Eliminates fragile remote Windows DCOM network configurations. Non-disruptive integration preserving working PLC programs and running SCADA. ### 6.5 Industrial CSV / DAT Batch Ingestion and Automated Export - **Source**: Monitored CSV / DAT flat files in local or network shared folders - **Transformation**: Flexible delimiter parsing, column-to-tag extraction, ISO timestamping - **Target**: Real-time tags in OPC UA / MQTT / OSIsoft PI System - **Benefit**: Complete automation of quality laboratory benches, weighing balances, and dosing systems without manual human data entry. --- ## 7. Canonical Frequently Asked Questions (FAQ) **Q: Does Luciai Multiconnector require an active Internet connection?** A: No. It operates 100% locally on the plant floor. All configurations, databases, and web dashboards remain internal. **Q: Can I bridge Siemens S7 PLC tags directly to MQTT without an intermediate OPC server?** A: Yes. Luciai Multiconnector communicates directly with Siemens S7-300, S7-400, S7-1200, and S7-1500 controllers over TCP/IP and publishes the values directly to any MQTT broker. **Q: How is the software licensed?** A: Licensing is per host machine, locked to the local hardware fingerprint. Each license governs allowed protocols, maximum connection limits, and active tag quotas. **Q: How can I request an evaluation or commercial proposal?** A: Contact the engineering sales team directly at comercial@luciai.com.br or visit https://multiconnector.luciai.com.br/contato.