Energy Monitoring from Edge Silicon to Cloud Analytics

# 1. Navigate to cloud dashboard directory
cd cloud-dashboard

# 2. Install backend dependencies (Node.js 18+)
npm install

# 3. Export mandatory JWT secret
export JWT_SECRET=$(openssl rand -hex 32)
export PORT=3000
export MQTT_HOST="messages.currentusage.com"

# 4. Start the hybrid Express + DuckDB server
npm start

# Server active at:
# User Portal:  http://localhost:3000/
# Admin Office: http://localhost:3000/admin

// Topic: cu100/<SERIAL_NUMBER>/state
// Status (LWT): cu100/<SERIAL_NUMBER>/status -> "online" | "offline"
{
  "serial": "a4cf1289b0c4",
  "v_rms": 230.5,
  "i_rms1": 1.25,   // Channel 1 Current (Amperes RMS)
  "i_rms2": 0.45,   // Channel 2 Current
  "i_rms3": 3.80,   // Channel 3 Current
  "i_rms4": 0.12,   // Channel 4 Current
  "p_active": 1295.4, // Total Active Power (Watts)
  "temp": 28.5,     // DS18B20 Ambient Temp (°C)
  "rssi": -62,      // Wi-Fi Signal Strength (dBm)
  "uptime": 3600    // Device Uptime (seconds)
}

# Query downsampled time-series telemetry from DuckDB
curl -X GET \
  "http://localhost:3000/api/devices/a4cf1289b0c4/history?range=24h&resolution=5m" \
  -H "X-API-Key: cu100_sk_your_generated_secret_token" \
  -H "Accept: application/json"

# Supported Ranges: 1h, 24h, 7d, 30d
# Supported Rollup Resolutions: raw, 1m, 5m, 1h, 1d

# Direct offline access over local network or Access Point (No cloud or internet needed)
# Web Browser UI: Open http://<device-ip>/ or http://cu100.local/ in any browser

# Query real-time CT sensor telemetry via the on-device REST API:
curl -s http://192.168.1.120/api/sensors

# Live JSON Response:
{
  "v_rms": 230.15,      // Calibrated Grid Voltage (Volts RMS)
  "i_rms1": 1.42,       // CT Channel 1 Current (Amperes RMS)
  "i_rms2": 0.38,       // CT Channel 2 Current
  "i_rms3": 0.00,       // CT Channel 3 Current
  "i_rms4": 0.00,       // CT Channel 4 Current
  "p_active": 414.27,   // Total Active Power (Watts)
  "temp": 28.4,         // DS18B20 Ambient Temp (°C)
  "rssi": -58,          // Wi-Fi Signal Strength (dBm)
  "uptime": 14400       // Device Uptime (seconds)
}

# Add to your Home Assistant configuration.yaml (Works 100% offline via local LAN)
sensor:
  - platform: rest
    name: "CU100 Main Power"
    resource: "http://192.168.1.120/api/sensors"
    value_template: "{{ value_json.p_active }}"
    unit_of_measurement: "W"
    device_class: power
    state_class: measurement

  - platform: rest
    name: "CU100 Grid Voltage"
    resource: "http://192.168.1.120/api/sensors"
    value_template: "{{ value_json.v_rms }}"
    unit_of_measurement: "V"
    device_class: voltage

# Generate and print QR code asset labels for CU100 devices
# 1. Batch generate printable SVG QR labels for all registered devices:
cd cloud-dashboard
npm run labels

# Output directory: ./labels/
# Generated: qrcode-e83dc19c35c0.svg
# Encoded URL: https://dashboard.currentusage.com/?device=e83dc19c35c0

# 2. Dynamic QR Code API endpoint (SVG):
curl -s "http://localhost:3000/api/devices/e83dc19c35c0/qrcode" > device-label.svg

# 3. Print directly in browser:
# Navigate to User Dashboard > "My Registered Devices"
# Click "QR Code" icon to preview and print formatted 300 DPI sticker