How to Use?
From meters to dashboard in 30 minutes — installation, push notifications, reactive alerts, AI chatbot, member invites and more. Step-by-step guide.
System Architecture
Energy Meter
Modbus RTU/TCP
Telegraf
Data collection
InfluxDB
Time series DB
WattSkor
Cloud platform
Dashboard
Real-time
GETTING STARTED
Start in 5 Steps
Total ~20 minutes. No technical knowledge needed.
Create an Account
2 minSign up with email or log in with Google/GitHub. Your 14-day free trial starts immediately.
- Go to wattskor.com/register
- Sign up with email and password (min 6 characters)
- Click the link in the verification email
- Log in — the onboarding wizard starts
Organization & Facility
3 minSet your company name and settings password. Enter your facility name and coordinates.
- Enter your company / organization name
- Set a settings password (used for changing parameters)
- Enter the facility name (e.g. 'Main Factory')
- Enter facility coordinates (for weather and energy analysis)
InfluxDB Connection
5 minEnter your InfluxDB server details and test the connection. Meters are discovered automatically.
- InfluxDB URL (e.g. https://influx.yourcompany.com)
- API Token (create in InfluxDB > Data > API Tokens)
- Enter the Organization and Bucket name
- Verify with the 'Test Connection' button
- View live values of discovered meters in the preview table
Meter Configuration
10 minSelect your meter brand/model and connection type. Build the trafo, line, panel hierarchy.
- Select brand and model for each meter (ENTES, Schneider, Siemens, Janitza...)
- Connection type: Modbus RTU (serial port) or Modbus TCP (Ethernet)
- Set the device type: transformer, main line, line, panel
- Link line / panel meters to their parent transformer (parent map)
Explore the Dashboard
Ready!Real-time monitoring begins. Manage your facility with 18 different analysis tabs.
- Dashboard: Live power, efficiency score, transformer status
- Alerts: Automatic threshold alarms and notifications
- Trafo / Harmonic / Cost / EPIAS / Yearly Analysis tabs
- Reporting: PDF and Excel report downloads
FEATURE GUIDES
New Features — Step by Step
Connector, push notifications, reactive alerts, per-device thresholds, yearly analysis, AI chatbot and multi-tenant — usage guide for each.
Connector Installation (MSI)
WattSkor connector running as a Windows service — Telegraf + heartbeat + alerts + daily cost calculation, all in one package.
Download the MSI Package
Download the signed MSI package from Settings → Devices. No antivirus warnings.
- Dashboard → Settings → Devices (Connector) tab
- Click 'Download Setup Package'
- Double-click wattskor-connector-x.y.z.msi
- Install path: C:\wattskor (default)
Paste the Activation Code
Paste your facility-specific collector token into the installer. One facility = one token.
- Settings → Devices → 'Copy Activation Code'
- Paste into the 'Activation Token' field in the installer
- Token auto-links the facility and InfluxDB settings
- Wrong token = installation fails (security)
# Aktivasyon kodunu kopyaladıktan sonra: msiexec /i wattskor-connector.msi TOKEN="ck_xxx..." /qb
Start the Service
After installation, 2 services start automatically: wattskor-connector and wattskor-telegraf.
- wattskor-connector → heartbeat + jobs (every 60s)
- wattskor-telegraf → Modbus polling + InfluxDB write
- Within 30 seconds the green 'online' badge appears in the dashboard
- Logs: in C:\wattskor\logs\ folder
# Durum kontrolü (PowerShell): Get-Service wattskor-connector, wattskor-telegraf
Push Notification Setup
Get alarm notifications even when the browser is closed. Chrome / iPhone PWA / Android — subscribe in one click.
PC Chrome / Edge — One-click Subscribe
Push notifications on desktop browsers — fastest way. Chrome, Edge, and Firefox all supported.
- Dashboard → Notification icon (top right, 🔔)
- Click 'Enable Push Notifications'
- Click 'Allow' in the browser permission popup
- Test notification arrives instantly — subscription confirmed
iPhone PWA — Add to Home Screen
iOS 16.4+iOS 16.4+ Safari supports push notifications — but you must add to home screen first (PWA).
- Open wattskor.com in Safari (not Chrome!)
- Share icon (bottom center, square + arrow) → 'Add to Home Screen'
- Open the app from the WattSkor icon on home screen
- Tap 'Allow' when notification permission popup appears
Android Chrome — Works Natively
No extra steps on Android. Chrome supports push notifications natively.
- Open wattskor.com in Chrome
- Notification icon → 'Enable Push Notifications'
- System notification permission → 'Allow'
- Optional: Menu → 'Add to home screen' (run as PWA)
Configure Reactive Alarm Thresholds
EPDK reactive limit rule: 20% inductive, 15% capacitive vs active consumption. Auto-alert on breach.
Open Alarm Thresholds Tab
Go to the Settings page, authenticate with the settings password.
- Dashboard → Settings (left menu)
- Enter the settings password (set during onboarding)
- Switch to 'Alarm Thresholds' tab
- Open the 'Reactive Limit' section
Set Inductive / Capacitive Percentages
EPDK defaults: 20% inductive, 15% capacitive. Adjust to your contract.
- Inductive Limit (%): active kWh × 0.20 = max inductive kVarh
- Capacitive Limit (%): active kWh × 0.15 = max capacitive kVarh
- For headroom: 18% inductive / 12% capacitive recommended
- Save values → global rule for all transformers
Set Time Windows
Alerts trigger in 3 windows: 1 hour, 6 hours, 24 hours. Separate minute threshold for each.
- 1-hour window: 5-15 min continuous breach → warning
- 6-hour window: 30-60 min accumulated breach → alert
- 24-hour window: 120-180 min accumulated → critical
- Dedup window after breach ends (default 30 min)
# Önerilen başlangıç: 1h → 10 dk 6h → 45 dk 24h → 150 dk
Per-Transformer Threshold Override
One transformer might run at 2x load — define a custom threshold for it without changing the global rule.
Open Device List
Settings → Alarm Thresholds → 'Per-Device Override' section.
- All transformers / lines / panels appear in the list
- Click + icon to add a new override
- Empty fields inherit the global rule
- Override = 'this rule is different for this device'
Enter Custom Thresholds
Loading, PF, THD, current imbalance — custom value for each metric.
- Loading warn %: e.g. 85% (instead of global 80%)
- Loading critical %: e.g. 95%
- PF threshold: 0.92 (instead of global 0.95)
- Voltage/current THD: independent values
Line / Panel Current Thresholds
For line (breaker) meters use current-based thresholds instead of loading: % of nominal current.
- Line-type meters evaluated by nominal current
- Nominal current: from panel diagram (e.g. 250A)
- Current warn %: 80% (200A) — critical %: 95% (237A)
- ana_hat type: like a transformer (kVA-based loading)
Use the Yearly Analysis Tab
Year selector + 12-month heatmap + YoY comparison — go back up to 6 years.
Use the Year Selector
Use arrow keys at top right to navigate years. Current year tagged 'Current'.
- Cost tab → Yearly Analysis sub-tab
- ← / → keys change year (2020-today)
- Current year shows green 'CURRENT' badge
- Empty state shown if no data (connector might be offline)
Read the Calendar Heatmap
12 months × daily intensity heatmap. Dark green = high consumption, light = low.
- Each cell is a month (daily detail within each month)
- Current month highlighted with amber border
- Hover for monthly total + daily average
- Spot consumption trends visually
YoY Comparison
Year-over-year % change — separate chips for bill, kWh, PTF. Color: green good, red bad.
- Total Bill YoY: TL difference vs previous year
- Total kWh YoY: consumption trend
- Weighted PTF YoY: market price change
- Peak month / Most expensive / Cheapest month sub-KPIs
Ask Questions to the AI Chatbot
Internal AI that reads your facility data — ask things like 'which transformer was most loaded last 7 days?'.
Open the Chatbot
Floating chat icon at bottom right — accessible from any page.
- Blue chat bubble icon at bottom right
- Click to open the chat window
- Welcome message + example questions
- Mobile-friendly: scales to your screen
Ask in Natural Language
Turkish or English, no technical jargon required. AI queries data and summarizes.
- 'When did I consume most today?' → hourly analysis
- 'How do I improve Trafo 1 efficiency?' → recommendations
- 'Did I pay reactive penalty last month?' → bill breakdown
- 'When are peak market hours?' → EPIAS analysis
Convert to Action
AI responses link to relevant dashboard tabs via 'View Details'.
- Suggested action → link to relevant tab
- Chart suggestion → Trend / Cost tab
- Alert suggestion → Settings / Alarm Thresholds
- Chat history stored in browser (local)
Invite Members & Share Facilities
Grant multiple users access to a facility. Admin, viewer, alert recipients — separate roles.
Send Invitation by Email
Settings → Members tab → 'Invite Member' button. Even unregistered users can be invited.
- Dashboard → Settings → Members tab
- Click 'Invite Member'
- Email address + role (Admin / Viewer)
- Invitation link sent automatically by email
Set Role and Permissions
Admin: full access. Viewer: read-only. Alert recipient: pick from notification list.
- Admin: changes settings, invites members
- Viewer: sees only dashboard, can't change settings
- Alert recipients: email + push notification
- Permissions editable later (with Admin role)
Switch Between Facilities
Users with access to multiple facilities → switch via top-left selector.
- Top-left facility name → dropdown
- All accessible facilities listed
- Selection → all tabs refresh for new facility
- Facility auto-added to list when invitation accepted
TECHNICAL REFERENCE
Field Names Table
Standard field names expected by the WattSkor system. The automatic setup package configures these based on your meter template.
Voltage Measurements
| Field Name (InfluxDB) | Description | Unit | Scale |
|---|---|---|---|
| voltage_L1N_V | L1-N Phase Voltage | V | 0.1 |
| voltage_L2N_V | L2-N Phase Voltage | V | 0.1 |
| voltage_L3N_V | L3-N Phase Voltage | V | 0.1 |
| voltage_L1L2_V | L1-L2 Line-to-Line | V | 0.1 |
| voltage_L2L3_V | L2-L3 Line-to-Line | V | 0.1 |
| voltage_L3L1_V | L3-L1 Line-to-Line | V | 0.1 |
Current Measurements
| Field Name (InfluxDB) | Description | Unit | Scale |
|---|---|---|---|
| current_L1_A | L1 Phase Current | A | 0.001 |
| current_L2_A | L2 Phase Current | A | 0.001 |
| current_L3_A | L3 Phase Current | A | 0.001 |
| current_Neutral_A | Neutral Current | A | 0.001 |
Power Measurements
| Field Name (InfluxDB) | Description | Unit | Scale |
|---|---|---|---|
| power_L1_W | L1 Active Power | W | 1.0 |
| power_L2_W | L2 Active Power | W | 1.0 |
| power_L3_W | L3 Active Power | W | 1.0 |
| power_total_W | Total Active Power | W | 1.0 |
| reactive_L1_var | L1 Reactive Power | var | 1.0 |
| reactive_L2_var | L2 Reactive Power | var | 1.0 |
| reactive_L3_var | L3 Reactive Power | var | 1.0 |
| reactive_total_var | Total Reactive Power | var | 1.0 |
| apparent_L1_VA | L1 Apparent Power | VA | 1.0 |
| apparent_L2_VA | L2 Apparent Power | VA | 1.0 |
| apparent_L3_VA | L3 Apparent Power | VA | 1.0 |
| apparent_total_VA | Total Apparent Power | VA | 1.0 |
Power Factor & Cos Phi
| Field Name (InfluxDB) | Description | Unit | Scale |
|---|---|---|---|
| pf_L1 | L1 Power Factor | 0.001 | |
| pf_L2 | L2 Power Factor | 0.001 | |
| pf_L3 | L3 Power Factor | 0.001 | |
| pf_total | Total Power Factor | 0.001 | |
| cos_L1 | L1 Cos Phi | 0.001 | |
| cos_L2 | L2 Cos Phi | 0.001 | |
| cos_L3 | L3 Cos Phi | 0.001 | |
| cos_total | Total Cos Phi | 0.001 |
THD (Total Harmonic Distortion)
| Field Name (InfluxDB) | Description | Unit | Scale |
|---|---|---|---|
| thd_voltage_L1_percent | L1 Voltage THD | % | 0.1 |
| thd_voltage_L2_percent | L2 Voltage THD | % | 0.1 |
| thd_voltage_L3_percent | L3 Voltage THD | % | 0.1 |
| thd_current_L1_percent | L1 Current THD | % | 0.1 |
| thd_current_L2_percent | L2 Current THD | % | 0.1 |
| thd_current_L3_percent | L3 Current THD | % | 0.1 |
| thd_current_neutral_percent | Neutral Current THD | % | 0.1 |
Energy & Frequency
| Field Name (InfluxDB) | Description | Unit | Scale |
|---|---|---|---|
| active_consumed_total_Wh | Total Active Energy | Wh | 1.0 |
| reactive_q1_total_varh | Reactive Energy Q1 (Inductive) | varh | 1.0 |
| reactive_q4_total_varh | Reactive Energy Q4 (Capacitive) | varh | 1.0 |
| frequency_Hz | Grid Frequency | Hz | 0.01 |
Individual Harmonics (n = 2,3,4,5,6,7,8,9,10,11,12,13,15)
| Field Name (InfluxDB) | Description | Unit | Scale |
|---|---|---|---|
| h_IL1_{n}_percent | L1 Current {n}th Harmonic | % | 0.1 |
| h_IL2_{n}_percent | L2 Current {n}th Harmonic | % | 0.1 |
| h_IL3_{n}_percent | L3 Current {n}th Harmonic | % | 0.1 |
| h_ILN_{n}_percent | Neutral Current {n}th Harmonic | % | 0.1 |
| h_V1_{n}_percent | L1 Voltage {n}th Harmonic | % | 0.1 |
| h_V2_{n}_percent | L2 Voltage {n}th Harmonic | % | 0.1 |
| h_V3_{n}_percent | L3 Voltage {n}th Harmonic | % | 0.1 |
Automatic Configuration
When you select your meter brand and model, WattSkor automatically maps these field names to your meter's Modbus register addresses. No manual configuration needed.
FAQ
Frequently Asked Questions
Which energy meters are supported?
All energy meters that support Modbus RTU or Modbus TCP protocol. Popular brands like ENTES MPR60S/63S, Schneider PM5xxx, ABB M4M, Siemens PAC, and Janitza UMG series are directly supported.
Where should the Connector be installed?
On the Windows computer physically connected to the meters, or a server on the same network. For Modbus RTU, the meter's serial port must be connected to this computer. For Modbus TCP, being on the same network is sufficient. The WattSkor MSI package installs everything automatically.
Do push notifications work on iPhone?
Yes, iOS 16.4+ supports them. But first you must add the app to your home screen via Safari (PWA). Chrome push does not work on iOS — Safari is required.
Reactive alarm triggers incorrectly — what should I do?
Loosen the time windows and minute thresholds in Settings → Alarm Thresholds → Reactive Limit. EPDK defaults are 20% inductive / 15% capacitive but can differ by contract. Use per-device override to target only the affected transformer.
Member invitation link doesn't work — why?
Invitation links expire after 7 days. Re-send from Settings → Members. If the invitee is already registered, just logging in with their main email is enough — middleware auto-accepts the invitation.
How accurate is the AI chatbot?
The chatbot queries your facility data in real time — runs Flux queries on InfluxDB. Responses are based on actual consumption/cost/alert history, not generic knowledge. For complex cross-analysis it links to the relevant dashboard tab.
What happens during an internet outage?
InfluxDB runs locally — no data loss. Even if connector heartbeat is interrupted, Telegraf keeps writing. When online, dashboard re-reads all data. Push notifications aren't queued offline — but email alerts are sent when connector reconnects.
Get Started Now
Try free for 14 days. No credit card required. All features unlocked, including connector.