slmm/docs/features/UI_UPDATE.md

Standalone UI Update: Get ALL Settings Button

What Was Added

A new "Get ALL Settings" button has been added to the standalone web UI at templates/index.html.

Location

The button is located in the Measurement Settings fieldset, at the top before the individual frequency and time weighting controls.

Visual Layout

┌─────────────────────────────────────────────────────┐
│ Measurement Settings                                 │
├─────────────────────────────────────────────────────┤
│                                                      │
│  [Get ALL Settings]  ← NEW BUTTON (bold styling)    │
│                                                      │
│  Frequency Weighting:                               │
│  [Get] [Set A] [Set C] [Set Z]                      │
│                                                      │
│  Time Weighting:                                    │
│  [Get] [Set Fast] [Set Slow] [Set Impulse]          │
│                                                      │
└─────────────────────────────────────────────────────┘

Functionality

When clicked, the button:

1. Shows loading message: "Retrieving all device settings (this may take 10-15 seconds)..."

2. Calls API: GET /api/nl43/{unit_id}/settings

3. Displays results in two places:

   • Status area (top): Shows formatted JSON with all settings
   • Log area (bottom): Shows each setting on a separate line

Example Output

Status Area Display

{
  "measurement_state": "Stop",
  "frequency_weighting": "A",
  "time_weighting": "F",
  "measurement_time": "00:01:00",
  "leq_interval": "1s",
  "lp_interval": "125ms",
  "index_number": "0",
  "battery_level": "100%",
  "clock": "2025/12/24,20:45:30",
  "sleep_mode": "Off",
  "ftp_status": "On"
}

Log Area Display

Retrieving all device settings (this may take 10-15 seconds)...
=== ALL DEVICE SETTINGS ===
measurement_state: Stop
frequency_weighting: A
time_weighting: F
measurement_time: 00:01:00
leq_interval: 1s
lp_interval: 125ms
index_number: 0
battery_level: 100%
clock: 2025/12/24,20:45:30
sleep_mode: Off
ftp_status: On
===========================

Code Changes

HTML Changes (Line 60)

<button onclick="getAllSettings()" style="margin-bottom: 12px; font-weight: bold;">
  Get ALL Settings
</button>

JavaScript Changes (Lines 284-305)

async function getAllSettings() {
  const unitId = document.getElementById('unitId').value;
  log('Retrieving all device settings (this may take 10-15 seconds)...');

  const res = await fetch(`/api/nl43/${unitId}/settings`);
  const data = await res.json();

  if (!res.ok) {
    log(`Get All Settings failed: ${res.status} - ${data.detail || JSON.stringify(data)}`);
    return;
  }

  // Display in status area
  statusEl.textContent = JSON.stringify(data.settings, null, 2);

  // Log summary
  log('=== ALL DEVICE SETTINGS ===');
  Object.entries(data.settings).forEach(([key, value]) => {
    log(`${key}: ${value}`);
  });
  log('===========================');
}

Usage Flow

1. Configure device using the "Unit Config" section
2. Click "Get ALL Settings" to retrieve current configuration
3. Review settings in the Status and Log areas
4. Verify critical settings match requirements before starting measurements

Benefits

✓ Quick verification - One click to see all device settings ✓ Pre-measurement check - Ensure device is configured correctly ✓ Debugging - Identify misconfigured settings easily ✓ Documentation - Copy settings from status area for records ✓ Comparison - Compare settings across multiple devices

Error Handling

If the request fails:

• Error message is displayed in the log
• Status code and details are shown
• Previous status display is preserved

Example error output:

Retrieving all device settings (this may take 10-15 seconds)...
Get All Settings failed: 502 - Failed to communicate with device

Testing the Feature

1. Start the SLMM server:

   cd /home/serversdown/slmm
   uvicorn app.main:app --reload --port 8100
   

2. Open the standalone UI:

   http://localhost:8100
   

3. Configure a device:

   • Enter Unit ID (e.g., "nl43-1")
   • Enter Host IP (e.g., "192.168.1.100")
   • Enter Port (e.g., "80")
   • Click "Save Config"

4. Test the new button:

   • Click "Get ALL Settings"
   • Wait 10-15 seconds for results
   • Review settings in Status and Log areas

Related Files

• templates/index.html - Standalone UI (updated)
• app/routers.py - Settings endpoint
• app/services.py - Client implementation
• README.md - Main documentation
• SETTINGS_ENDPOINT.md - API documentation