Displaying Your First Equipment Data
Starting from a blank Platform, we will go through the entire process until equipment values are visible on the screen.
No installation is required — you can follow along right now using the public demo. You can set this up on your own server after completing this walkthrough. The sequence is Site Registration → Edge Connection → Model Configuration. Once this path is established, the rest is repetitive.
- A web browser. No installation is required — you can follow along using the public demo below.
- To use our server → One-line Installation and Initial Password Change must be completed.
- Estimated time: 15 minutes. There are 5 steps, and each step utilizes the result of the previous one.
A public demo is available — https://demo-platform.plantpulse.io (admin / admin123!).
All screens shown below are captured from this demo. For the Edge side, please use https://demo-edge.plantpulse.io.
Short, silent videos are attached to each step. Scanning them before reading the text will help you get familiar with the screens.
The demo is displayed in the default locale (en). To use Korean, install with PP_LANG=ko.
In the descriptions below, English names visible on the screen are written in bold, followed by their Korean meanings.
Step 1 — Register the Site
Go to Factory > Model (/model/index) in the left menu. If nothing is registered, it will look like this.
The guidance box explains the sequence — "Register a factory (site) → complete the physical model by connecting to OPC or other protocols → map the physical model to the logical model."
Click Add Site on the right to open the registration form.
| Input | Required | Description |
|---|---|---|
| Enterprise Name | ✱ | Select the enterprise (one per installation) |
| Site ID | ✱ | Starts with SITE_. Only alphanumeric characters and _ |
| Site Name | ✱ | Human-readable name (e.g., DAEJEON PLANT 1) |
| Location | ✱ | Select coordinates via Pick on Map |
| Description | ✱ | Description |
Location and Description are also required (✱). You cannot proceed without selecting a location on the map.
This ID is embedded throughout tags, APIs, and reports. Define your naming convention before registration → Domain ID Rules.
Step 2 — Connect the Edge
Data is pushed up by the Edge gateway. Instead of creating tags manually on the Platform, the data collected from the Edge is uploaded. Therefore, connection must precede the model.
For gateway-side settings, follow the Edge Tutorial. Once the Platform address and token are entered into the gateway, it will appear in Connectivity > Edge (/edge/index) on the Platform.
The six cards at the top represent the first milestone.
| Card | Meaning |
|---|---|
| Total | Number of Edges being monitored |
| Connected | Edges reachable from the Platform |
| Disconnected | Edges unreachable or never observed |
| PLC Normal | PLCs connected and collecting data |
| PLC Not Collecting | PLCs connected but not collecting data |
| PLC Disconnected | Disconnected PLCs |
You have passed this stage when Total 1 · Connected 1 · PLC Normal 1.
The Edge Help box at the bottom provides guidance — for disconnected Edges, check the physical environment, network, or Edge OS; for warnings, check software errors during collection; for CPU, memory, or disk usage exceeding 80%, check system resources.
The list columns are CONNECTION · EDGE_ID · EDGE · RESOURCES · NETWORK · PLC THROUGHPUT. For detailed instructions on how to read these, refer to Connection Management.
Step 3 — Configure the Model
Once values begin arriving, attach them to the equipment structure. Without this, you have data but no context as to «which equipment it belongs to».
Go to Factory > Asset (/asset/tree/index).
The tree structure is Site › Area › Line › Equipment (the top-level Enterprise of the data hierarchy does not appear in the tree). Create them from the top down.
| Hierarchy | Meaning | ID Example |
|---|---|---|
| Site | Factory/Plant | Created in Step 1 |
| Area | Area | AREA_000001 |
| Line | Line | LINE_000001 |
| Equipment | Actual Equipment | EQUIPMENT_000001 |
Selecting an asset displays details and the Timeline (connection and health trends) in the Asset Info pane on the right.
Final Mandatory Step — Confirm Factory Model
Click Confirm Factory Model in the top right.
This step reflects the registered sites, assets, and tags into the event rule engine. If not clicked, state and aggregation event rules will not be created, leaving dashboards and alarms empty.
⚠️ Conversely, do not click this too frequently — there is a cost associated with rule re-registration. It is best to click it once after all modification work is complete.
If new rules appear in CEP > Statement after clicking, the process is normal.
Step 4 — Verify Data Flow
This is the second milestone. Success is achieved when tag values are updated in Equipment > Data Inquiry (/asset/data/index) or Data > Trend (/storage/index).
If data is not visible, narrow down the cause in this order:
| Check | If No |
|---|---|
| 1. Are values visible on the Edge side? | Go to Edge Tutorial Step 5 |
| 2. Is it PLC Normal in Connectivity > Edge? | Issue between gateway and PLC |
| 3. Is the tag attached to the equipment? | Check in Factory > Tag (/tag/index) |
| 4. Was Confirm Factory Model clicked? | Return to Step 3 and click |
Most cases of «everything is registered but the screen is empty» are due to this.
Step 5 — Set up a Sample Alarm
Once data is flowing, set a condition. Configure threshold values in Alarm > Alarm (/alarm/index) → Alarm Management.
Reaching this point means you have completed the full cycle of collection → storage → monitoring.
After Completion
| Next Steps | Documentation |
|---|---|
| How to operate within an organization | Work Process |
| Adding more equipment | Factory Management |
| Processing and integrating data | Flow |
| Connecting with external systems | API User Manual |
| Pre-handover inspection | Initial Password Change |