Getting Started
KaroonaX is an AI-Powered Digital Twin Engine that lets you model, monitor, and control a smart factory from a virtual workspace.
1
Place Components
Double-click or drag a component from the Component Library (left panel) onto the Digital Twin Workplace canvas.
2
Connect to Database
Right-click a node → select "Connect to Server DB", or click the blue port dot on the right edge of the node.
3
Adjust Telemetry
Left-click a node to select it. Use the sliders in the Property Panel (right side) to adjust live telemetry values.
4
Setup Alerts
Right-click a node → "Setup Alerts" to create threshold-based rules that trigger Email, SMS, WhatsApp, or Voice Call notifications.
5
Send Commands
Select a node and use the Twin Command Operations buttons in the Property Panel to send commands from the Digital Twin to the Physical Factory.
Switch to the "Datastore Log" tab on the right panel to watch live JSON telemetry data streaming from connected components into the DT Server DB.
Component Reference
Conveyor Belt
Transports items across the factory floor. Tracks Belt Speed, Conveyor Load, and Belt Width.
- Safety E-Stop — Command button to immediately halt the conveyor
- Speed slider directly controls the physical factory simulation speed
- Load values stream with simulated sensor jitter to the datastore
Robotic Arm
Picks and sorts items. Tracks X/Y Displacement and Joint Rotation.
- Pick Missed Item — Command that triggers a 6-stage animated pickup sequence in the physical factory
- The arm lowers, grabs the defective box, lifts it, swings to waste bin, drops it, and returns
IOT Gateway
Aggregates sensor data streams to the DT server. Tracks Sensor Count and Scan Rate.
- Connect it to the DB to see periodic telemetry data flowing in the Datastore Log
Pneumatic Press
Shapes raw metal with hydraulic pressure. Tracks Press Pressure and Cycle Rate.
- Pressure values stream with simulated sensor noise
- Great for demoing alert threshold triggers (e.g. pressure > 8 bar)
Alarm Beacon
Provides visual & sound alerts on the factory floor. Tracks Light Level and Flash Speed.
- Test Strobe Flash — Toggles the beacon intensity and triggers a red flash animation in the simulation panel
- Automatically activates when any alert rule fires
DT Server DB (pre-placed)
The central database that stores all telemetry streams. Connect other components to it via pipeline links.
- Always present on the canvas — cannot be removed
- Pipeline connections show animated data flow pulses
Demo Scenarios
DEMO 1 Defective Box Sorting (Full Pipeline)
This demonstrates the complete Digital Twin → Physical Factory command loop.
- Double-click Conveyor Belt and Robotic Arm from the Component Library to place them on the canvas
- In the bottom Physical Smart Factory Floor panel, click "Inject Missed / Defective Box"
- Watch the red box move along the conveyor belt → scanner detects it → box continues to the robotic arm station → conveyor halts
- Click the Robotic Arm node on the canvas to select it
- Click "Pick Missed Item" in the right panel
- Watch the robotic arm pick, sort, and dispose of the defective box
- The conveyor automatically resumes!
DEMO 2 Alert Notifications (Multi-Channel)
Demonstrates threshold-based alerts with Email, SMS, WhatsApp, and Voice Call mockups.
- Double-click Pneumatic Press to place it on the canvas
- Right-click the node → "Setup Alerts"
- Set: Parameter = Press Pressure, Operator = GT, Value = 8
- Check all notification channels (Email, SMS, WhatsApp, Voice)
- Enter a contact (e.g. operator@factory.com) and click "Create Alert Rule"
- Left-click the node, then drag the Press Pressure slider above 8 bar
- Watch notifications appear: Email card, phone with WhatsApp/SMS, and a ringing phone call!
- Click Accept on the call to hear a TTS voice readout of the alert
DEMO 3 Live Telemetry Data Streaming
Shows real-time sensor data flowing from the factory to the digital twin database.
- Place any component (e.g. Conveyor Belt) on the canvas
- Right-click → "Connect to Server DB"
- Right-click → "Setup Parameters" → set at least one parameter to "Store & Stream"
- Switch to the "Datastore Log" tab in the right panel
- Watch live JSON telemetry records appear every 1.5 seconds with simulated sensor jitter
DEMO 4 Emergency Stop & Beacon Alert
Demonstrates command signals from the Digital Twin to the physical factory.
- Place a Conveyor Belt and an Alarm Beacon on the canvas
- Select the Conveyor Belt → click "Safety E-Stop" in the right panel
- The conveyor speed drops to zero and the factory simulation freezes
- Select the Alarm Beacon → click "Test Strobe Flash"
- The factory panel header icon flashes red rapidly
Alert System
KaroonaX supports threshold-based alert rules that fire real-time notifications when telemetry values cross safety limits.
Setting Up Alerts
- Right-click any placed component → "Setup Alerts"
- Select a Target Parameter (only active parameters appear)
- Choose an Operator: GT, GE, LT, LE, or Between
- Set a Threshold Value
- Select one or more Notification Channels
- Enter a Contact (email or phone number)
- Click "Create Alert Rule"
Notification Channels
EmailOutlook-style email mockup with full alert details
SMSiMessage-style text notification
WhatsAppWhatsApp dark mode chat with alert message
Voice CallRinging phone with accept/decline — plays TTS voice alert on accept
Parameter Configurations
Each parameter can be configured via Right-click → "Setup Parameters":
DeactivateParameter is hidden from telemetry controls
DisplayShown on dashboard but not stored to DB
StoreValues stream to DB with sensor noise simulation
CommandReceives control signals from the Digital Twin
Alerts auto-reset when values return below the threshold, so they can fire again if the limit is crossed again.