/** * Device cards — settings modal, brightness, power, color. */ import { _deviceBrightnessCache, updateDeviceBrightness, } from '../core/state.js'; import { API_BASE, getHeaders, fetchWithAuth, escapeHtml, isSerialDevice, isMockDevice, isMqttDevice, isWsDevice, isOpenrgbDevice } from '../core/api.js'; import { devicesCache } from '../core/state.js'; import { _fetchOpenrgbZones, _getCheckedZones, _splitOpenrgbZone, _getZoneMode } from './device-discovery.js'; import { t } from '../core/i18n.js'; import { showToast, showConfirm, desktopFocus } from '../core/ui.js'; import { Modal } from '../core/modal.js'; import { ICON_SETTINGS, ICON_STOP_PLAIN, ICON_LED, ICON_WEB, ICON_PLUG, ICON_REFRESH } from '../core/icons.js'; import { wrapCard } from '../core/card-colors.js'; import { TagInput, renderTagChips } from '../core/tag-input.js'; let _deviceTagsInput = null; class DeviceSettingsModal extends Modal { constructor() { super('device-settings-modal'); } deviceType = ''; capabilities = []; snapshotValues() { return { name: this.$('settings-device-name').value, url: this._getUrl(), state_check_interval: this.$('settings-health-interval').value, auto_shutdown: this.$('settings-auto-shutdown').checked, led_count: this.$('settings-led-count').value, led_type: document.getElementById('settings-led-type')?.value || 'rgb', send_latency: document.getElementById('settings-send-latency')?.value || '0', zones: JSON.stringify(_getCheckedZones('settings-zone-list')), zoneMode: _getZoneMode('settings-zone-mode'), tags: JSON.stringify(_deviceTagsInput ? _deviceTagsInput.getValue() : []), }; } _getUrl() { if (isMockDevice(this.deviceType)) { const deviceId = this.$('settings-device-id')?.value || ''; return `mock://${deviceId}`; } if (isWsDevice(this.deviceType)) { const deviceId = this.$('settings-device-id')?.value || ''; return `ws://${deviceId}`; } if (isSerialDevice(this.deviceType)) { return this.$('settings-serial-port').value; } let url = this.$('settings-device-url').value.trim(); // Append selected zones for OpenRGB if (isOpenrgbDevice(this.deviceType)) { const zones = _getCheckedZones('settings-zone-list'); if (zones.length > 0) { const { baseUrl } = _splitOpenrgbZone(url); url = baseUrl + '/' + zones.join('+'); } } return url; } } const settingsModal = new DeviceSettingsModal(); export function createDeviceCard(device) { const state = device.state || {}; const devOnline = state.device_online || false; const devLatency = state.device_latency_ms; const devName = state.device_name; const devVersion = state.device_version; const devLastChecked = state.device_last_checked; let healthClass, healthTitle, healthLabel; if (devLastChecked === null || devLastChecked === undefined) { healthClass = 'health-unknown'; healthTitle = t('device.health.checking'); healthLabel = ''; } else if (devOnline) { healthClass = 'health-online'; healthTitle = `${t('device.health.online')}`; if (devName) healthTitle += ` - ${devName}`; if (devVersion) healthTitle += ` v${devVersion}`; if (devLatency !== null && devLatency !== undefined) healthTitle += ` (${Math.round(devLatency)}ms)`; healthLabel = ''; } else { healthClass = 'health-offline'; healthTitle = t('device.health.offline'); if (state.device_error) healthTitle += `: ${state.device_error}`; healthLabel = ''; } const ledCount = state.device_led_count || device.led_count; // Parse zone names from OpenRGB URL for badge display const openrgbZones = isOpenrgbDevice(device.device_type) ? _splitOpenrgbZone(device.url).zones : []; return wrapCard({ dataAttr: 'data-device-id', id: device.id, topButtons: (device.capabilities || []).includes('power_control') ? `` : '', removeOnclick: `removeDevice('${device.id}')`, removeTitle: t('device.button.remove'), content: `
${device.name || device.id} ${device.url && device.url.startsWith('http') ? `${escapeHtml(device.url.replace(/^https?:\/\//, ''))}${ICON_WEB}` : (device.url && !device.url.startsWith('mock://') && !device.url.startsWith('ws://') && !device.url.startsWith('openrgb://') && !device.url.startsWith('http') ? `${escapeHtml(device.url)}` : '')} ${healthLabel}
${(device.device_type || 'wled').toUpperCase()} ${openrgbZones.length ? openrgbZones.map(z => `${ICON_LED} ${escapeHtml(z)}`).join('') : (ledCount ? `${ICON_LED} ${ledCount}` : '')} ${state.device_led_type ? `${ICON_PLUG} ${state.device_led_type.replace(/ RGBW$/, '')}` : ''} ${state.device_rgbw ? '' : ''}
${(device.capabilities || []).includes('brightness_control') ? `
` : ''} ${renderTagChips(device.tags)}`, actions: ` `, }); } export async function turnOffDevice(deviceId) { try { const setResp = await fetchWithAuth(`/devices/${deviceId}/power`, { method: 'PUT', body: JSON.stringify({ on: false }) }); if (setResp.ok) { showToast(t('device.power.off_success'), 'success'); } else { const error = await setResp.json(); showToast(error.detail || 'Failed', 'error'); } } catch (error) { if (error.isAuth) return; showToast(t('device.error.power_off_failed'), 'error'); } } export async function pingDevice(deviceId) { const btn = document.querySelector(`[data-device-id="${deviceId}"] .card-ping-btn`); if (btn) btn.classList.add('spinning'); try { const resp = await fetchWithAuth(`/devices/${deviceId}/ping`, { method: 'POST' }); if (resp.ok) { const data = await resp.json(); const ms = data.device_latency_ms != null ? data.device_latency_ms.toFixed(0) : '?'; showToast(data.device_online ? t('device.ping.online', { ms }) : t('device.ping.offline'), data.device_online ? 'success' : 'error'); // Refresh device cards to update health dot devicesCache.invalidate(); await window.loadDevices(); } else { const err = await resp.json(); showToast(err.detail || 'Ping failed', 'error'); } } catch (error) { if (error.isAuth) return; showToast(t('device.ping.error'), 'error'); } finally { if (btn) btn.classList.remove('spinning'); } } export function attachDeviceListeners(deviceId) { // Add any specific event listeners here if needed } export async function removeDevice(deviceId) { const confirmed = await showConfirm(t('device.remove.confirm')); if (!confirmed) return; try { const response = await fetchWithAuth(`/devices/${deviceId}`, { method: 'DELETE', }); if (response.ok) { showToast(t('device.removed'), 'success'); devicesCache.invalidate(); window.loadDevices(); } else { const error = await response.json(); showToast(error.detail || t('device.error.remove_failed'), 'error'); } } catch (error) { if (error.isAuth) return; console.error('Failed to remove device:', error); showToast(t('device.error.remove_failed'), 'error'); } } export async function showSettings(deviceId) { try { const deviceResponse = await fetchWithAuth(`/devices/${deviceId}`); if (!deviceResponse.ok) { showToast(t('device.error.settings_load_failed'), 'error'); return; } const device = await deviceResponse.json(); const isAdalight = isSerialDevice(device.device_type); const caps = device.capabilities || []; // Set modal state before populating fields (so async helpers read correct type) settingsModal.deviceType = device.device_type; settingsModal.capabilities = caps; document.getElementById('settings-device-id').value = device.id; document.getElementById('settings-device-name').value = device.name; document.getElementById('settings-health-interval').value = device.state_check_interval ?? 30; const isMock = isMockDevice(device.device_type); const isWs = isWsDevice(device.device_type); const isMqtt = isMqttDevice(device.device_type); const urlGroup = document.getElementById('settings-url-group'); const serialGroup = document.getElementById('settings-serial-port-group'); const urlLabel = urlGroup.querySelector('label[for="settings-device-url"]'); const urlHint = urlGroup.querySelector('.input-hint'); const urlInput = document.getElementById('settings-device-url'); if (isMock || isWs) { urlGroup.style.display = 'none'; urlInput.removeAttribute('required'); serialGroup.style.display = 'none'; } else if (isAdalight) { urlGroup.style.display = 'none'; urlInput.removeAttribute('required'); serialGroup.style.display = ''; _populateSettingsSerialPorts(device.url); } else { urlGroup.style.display = ''; urlInput.setAttribute('required', ''); urlInput.value = device.url; serialGroup.style.display = 'none'; // Relabel for MQTT if (isMqtt) { if (urlLabel) urlLabel.textContent = t('device.mqtt_topic'); if (urlHint) urlHint.textContent = t('device.mqtt_topic.hint'); urlInput.placeholder = t('device.mqtt_topic.placeholder') || 'mqtt://ledgrab/device/living-room'; } else if (isOpenrgbDevice(device.device_type)) { if (urlLabel) urlLabel.textContent = t('device.openrgb.url'); if (urlHint) urlHint.textContent = t('device.openrgb.url.hint'); urlInput.placeholder = 'openrgb://localhost:6742/0'; // Parse zone from URL and show base URL only const { baseUrl, zones: currentZones } = _splitOpenrgbZone(device.url); urlInput.value = baseUrl; } else { if (urlLabel) urlLabel.textContent = t('device.url'); if (urlHint) urlHint.textContent = t('settings.url.hint'); urlInput.placeholder = t('device.url.placeholder') || 'http://192.168.1.100'; } } const ledCountGroup = document.getElementById('settings-led-count-group'); if (caps.includes('manual_led_count')) { ledCountGroup.style.display = ''; document.getElementById('settings-led-count').value = device.led_count || ''; } else { ledCountGroup.style.display = 'none'; } const baudRateGroup = document.getElementById('settings-baud-rate-group'); if (isAdalight) { baudRateGroup.style.display = ''; const baudSelect = document.getElementById('settings-baud-rate'); if (device.baud_rate) { baudSelect.value = String(device.baud_rate); } else { baudSelect.value = '115200'; } updateSettingsBaudFpsHint(); } else { baudRateGroup.style.display = 'none'; } // Mock-specific fields const ledTypeGroup = document.getElementById('settings-led-type-group'); const sendLatencyGroup = document.getElementById('settings-send-latency-group'); if (isMock) { if (ledTypeGroup) { ledTypeGroup.style.display = ''; document.getElementById('settings-led-type').value = device.rgbw ? 'rgbw' : 'rgb'; } if (sendLatencyGroup) { sendLatencyGroup.style.display = ''; document.getElementById('settings-send-latency').value = device.send_latency_ms || 0; } } else { if (ledTypeGroup) ledTypeGroup.style.display = 'none'; if (sendLatencyGroup) sendLatencyGroup.style.display = 'none'; } // WS connection URL const wsUrlGroup = document.getElementById('settings-ws-url-group'); if (wsUrlGroup) { if (isWs) { const wsProto = location.protocol === 'https:' ? 'wss:' : 'ws:'; const apiKey = localStorage.getItem('wled_api_key') || ''; const wsUrl = `${wsProto}//${location.host}/api/v1/devices/${device.id}/ws?token=${encodeURIComponent(apiKey)}`; document.getElementById('settings-ws-url').value = wsUrl; wsUrlGroup.style.display = ''; } else { wsUrlGroup.style.display = 'none'; } } // Hide health check for devices without health_check capability const healthIntervalGroup = document.getElementById('settings-health-interval-group'); if (healthIntervalGroup) { healthIntervalGroup.style.display = caps.includes('health_check') ? '' : 'none'; } // Hide auto-restore for devices without auto_restore capability const autoShutdownGroup = document.getElementById('settings-auto-shutdown-group'); if (autoShutdownGroup) { autoShutdownGroup.style.display = caps.includes('auto_restore') ? '' : 'none'; } document.getElementById('settings-auto-shutdown').checked = !!device.auto_shutdown; // OpenRGB zone picker + mode toggle const settingsZoneGroup = document.getElementById('settings-zone-group'); const settingsZoneModeGroup = document.getElementById('settings-zone-mode-group'); if (settingsZoneModeGroup) settingsZoneModeGroup.style.display = 'none'; if (settingsZoneGroup) { if (isOpenrgbDevice(device.device_type)) { settingsZoneGroup.style.display = ''; const { baseUrl, zones: currentZones } = _splitOpenrgbZone(device.url); // Set zone mode radio from device const savedMode = device.zone_mode || 'combined'; const modeRadio = document.querySelector(`input[name="settings-zone-mode"][value="${savedMode}"]`); if (modeRadio) modeRadio.checked = true; _fetchOpenrgbZones(baseUrl, 'settings-zone-list', currentZones).then(() => { // Re-snapshot after zones are loaded so dirty-check baseline includes them settingsModal.snapshot(); }); } else { settingsZoneGroup.style.display = 'none'; document.getElementById('settings-zone-list').innerHTML = ''; } } // Tags if (_deviceTagsInput) _deviceTagsInput.destroy(); _deviceTagsInput = new TagInput(document.getElementById('device-tags-container'), { placeholder: window.t ? t('tags.placeholder') : 'Add tag...' }); _deviceTagsInput.setValue(device.tags || []); settingsModal.snapshot(); settingsModal.open(); setTimeout(() => desktopFocus(document.getElementById('settings-device-name')), 100); } catch (error) { if (error.isAuth) return; console.error('Failed to load device settings:', error); showToast(t('device.error.settings_load_failed'), 'error'); } } export function isSettingsDirty() { return settingsModal.isDirty(); } export function forceCloseDeviceSettingsModal() { if (_deviceTagsInput) { _deviceTagsInput.destroy(); _deviceTagsInput = null; } settingsModal.forceClose(); } export function closeDeviceSettingsModal() { settingsModal.close(); } export async function saveDeviceSettings() { const deviceId = document.getElementById('settings-device-id').value; const name = document.getElementById('settings-device-name').value.trim(); const url = settingsModal._getUrl(); if (!name || !url) { settingsModal.showError(t('device.error.required')); return; } try { const body = { name, url, auto_shutdown: document.getElementById('settings-auto-shutdown').checked, state_check_interval: parseInt(document.getElementById('settings-health-interval').value, 10) || 30, tags: _deviceTagsInput ? _deviceTagsInput.getValue() : [], }; const ledCountInput = document.getElementById('settings-led-count'); if (settingsModal.capabilities.includes('manual_led_count') && ledCountInput.value) { body.led_count = parseInt(ledCountInput.value, 10); } if (isSerialDevice(settingsModal.deviceType)) { const baudVal = document.getElementById('settings-baud-rate').value; if (baudVal) body.baud_rate = parseInt(baudVal, 10); } if (isMockDevice(settingsModal.deviceType)) { const sendLatency = document.getElementById('settings-send-latency')?.value; if (sendLatency !== undefined) body.send_latency_ms = parseInt(sendLatency, 10); const ledType = document.getElementById('settings-led-type')?.value; body.rgbw = ledType === 'rgbw'; } if (isOpenrgbDevice(settingsModal.deviceType)) { body.zone_mode = _getZoneMode('settings-zone-mode'); } const deviceResponse = await fetchWithAuth(`/devices/${deviceId}`, { method: 'PUT', body: JSON.stringify(body) }); if (!deviceResponse.ok) { const errorData = await deviceResponse.json(); settingsModal.showError(t('device.error.update')); return; } showToast(t('settings.saved'), 'success'); devicesCache.invalidate(); settingsModal.forceClose(); window.loadDevices(); } catch (err) { if (err.isAuth) return; console.error('Failed to save device settings:', err); settingsModal.showError(t('device.error.save')); } } // Brightness export function updateBrightnessLabel(deviceId, value) { const slider = document.querySelector(`[data-device-brightness="${deviceId}"]`); if (slider) slider.title = Math.round(parseInt(value) / 255 * 100) + '%'; } export async function saveCardBrightness(deviceId, value) { const bri = parseInt(value); updateDeviceBrightness(deviceId, bri); try { const resp = await fetchWithAuth(`/devices/${deviceId}/brightness`, { method: 'PUT', body: JSON.stringify({ brightness: bri }) }); if (!resp.ok) { showToast(t('device.error.brightness'), 'error'); } } catch (err) { if (err.isAuth) return; showToast(t('device.error.brightness'), 'error'); } } const _brightnessFetchInFlight = new Set(); export async function fetchDeviceBrightness(deviceId) { if (_brightnessFetchInFlight.has(deviceId)) return; _brightnessFetchInFlight.add(deviceId); try { const resp = await fetchWithAuth(`/devices/${deviceId}/brightness`); if (!resp.ok) return; const data = await resp.json(); updateDeviceBrightness(deviceId, data.brightness); const slider = document.querySelector(`[data-device-brightness="${deviceId}"]`); if (slider) { slider.value = data.brightness; slider.title = Math.round(data.brightness / 255 * 100) + '%'; slider.disabled = false; } const wrap = document.querySelector(`[data-brightness-wrap="${deviceId}"]`); if (wrap) wrap.classList.remove('brightness-loading'); } catch (err) { // Silently fail — device may be offline } finally { _brightnessFetchInFlight.delete(deviceId); } } // LED protocol timing constants const LED_US_PER_BIT = 1.25; // SK6812/WS2812B bit time (μs) const LED_BITS_PER_PIXEL = 32; // RGBW worst case (4 channels × 8 bits) const LED_US_PER_PIXEL = LED_BITS_PER_PIXEL * LED_US_PER_BIT; // 40μs const LED_RESET_US = 80; // reset/latch pulse (μs) const US_PER_SECOND = 1_000_000; // Serial protocol constants const SERIAL_BITS_PER_BYTE = 10; // 8N1: 1 start + 8 data + 1 stop const SERIAL_RGB_BYTES_PER_LED = 3; const ADALIGHT_HEADER_BYTES = 6; // 'Ada' + count_hi + count_lo + checksum const AMBILED_HEADER_BYTES = 1; // FPS hint helpers (shared with device-discovery, targets) export function _computeMaxFps(baudRate, ledCount, deviceType) { if (!ledCount || ledCount < 1) return null; if (deviceType === 'wled') { const frameUs = ledCount * LED_US_PER_PIXEL + LED_RESET_US; return Math.floor(US_PER_SECOND / frameUs); } if (!baudRate) return null; const overhead = deviceType === 'ambiled' ? AMBILED_HEADER_BYTES : ADALIGHT_HEADER_BYTES; const bitsPerFrame = (ledCount * SERIAL_RGB_BYTES_PER_LED + overhead) * SERIAL_BITS_PER_BYTE; return Math.floor(baudRate / bitsPerFrame); } export function _renderFpsHint(hintEl, baudRate, ledCount, deviceType) { const fps = _computeMaxFps(baudRate, ledCount, deviceType); if (fps !== null) { hintEl.textContent = `Max FPS ≈ ${fps}`; hintEl.style.display = ''; } else { hintEl.style.display = 'none'; } } export function updateSettingsBaudFpsHint() { const hintEl = document.getElementById('settings-baud-fps-hint'); const baudRate = parseInt(document.getElementById('settings-baud-rate').value, 10); const ledCount = parseInt(document.getElementById('settings-led-count').value, 10); _renderFpsHint(hintEl, baudRate, ledCount, settingsModal.deviceType); } // Settings serial port population (used from showSettings) async function _populateSettingsSerialPorts(currentUrl) { const select = document.getElementById('settings-serial-port'); select.innerHTML = ''; const loadingOpt = document.createElement('option'); loadingOpt.value = currentUrl; loadingOpt.textContent = currentUrl + ' ⏳'; select.appendChild(loadingOpt); try { const discoverType = settingsModal.deviceType || 'adalight'; const resp = await fetchWithAuth(`/devices/discover?timeout=2&device_type=${encodeURIComponent(discoverType)}`); if (!resp.ok) return; const data = await resp.json(); const devices = data.devices || []; select.innerHTML = ''; let currentFound = false; devices.forEach(device => { const opt = document.createElement('option'); opt.value = device.url; opt.textContent = device.name; if (device.url === currentUrl) currentFound = true; select.appendChild(opt); }); if (!currentFound) { const opt = document.createElement('option'); opt.value = currentUrl; opt.textContent = currentUrl; select.insertBefore(opt, select.firstChild); } select.value = currentUrl; } catch (err) { console.error('Failed to discover serial ports:', err); } } export function copyWsUrl() { const input = document.getElementById('settings-ws-url'); if (input && input.value) { navigator.clipboard.writeText(input.value).then(() => { showToast(t('settings.copied') || 'Copied!', 'success'); }); } } export async function loadDevices() { await window.loadTargetsTab(); } // ===== OpenRGB zone count enrichment ===== // Cache: baseUrl → { zoneName: ledCount, ... } const _zoneCountCache = {}; /** Return cached zone LED counts for a base URL, or null if not cached. */ export function getZoneCountCache(baseUrl) { return _zoneCountCache[baseUrl] || null; } const _zoneCountInFlight = new Set(); /** * Fetch zone LED counts for an OpenRGB device and update zone badges on the card. * Called after cards are rendered (same pattern as fetchDeviceBrightness). */ export async function enrichOpenrgbZoneBadges(deviceId, deviceUrl) { const { baseUrl, zones } = _splitOpenrgbZone(deviceUrl); if (!zones.length) return; // Use cache if available if (_zoneCountCache[baseUrl]) { _applyZoneCounts(deviceId, zones, _zoneCountCache[baseUrl]); return; } // Deduplicate in-flight requests per base URL if (_zoneCountInFlight.has(baseUrl)) return; _zoneCountInFlight.add(baseUrl); try { const resp = await fetchWithAuth(`/devices/openrgb-zones?url=${encodeURIComponent(baseUrl)}`); if (!resp.ok) return; const data = await resp.json(); const counts = {}; for (const z of data.zones) { counts[z.name.toLowerCase()] = z.led_count; } _zoneCountCache[baseUrl] = counts; _applyZoneCounts(deviceId, zones, counts); } catch { // Silently fail — device may be offline } finally { _zoneCountInFlight.delete(baseUrl); } } function _applyZoneCounts(deviceId, zones, counts) { const card = document.querySelector(`[data-device-id="${deviceId}"]`); if (!card) return; for (const zoneName of zones) { const badge = card.querySelector(`[data-zone-name="${zoneName}"]`); if (!badge) continue; const ledCount = counts[zoneName.toLowerCase()]; if (ledCount != null) { badge.innerHTML = `${ICON_LED} ${escapeHtml(zoneName)} · ${ledCount}`; } } }