Guardar datos en flash con Settings de DeviceScript

Los settings de DeviceScript permiten guardar valores en la memoria flash para recuperarlos después de un reinicio.

Esto es normal, ya que la memoria RAM es volátil. Pero en casi cualquier proyecto real (“en producción”), necesitamos guardar ciertos datos de forma permanente:

• Un contador de cuántas veces se ha encendido la máquina.
• La configuración de brillo preferida por el usuario.
• El último estado del relé para recuperarlo al volver la luz.

En el mundo Arduino clásico, usábamos la librería EEPROM o, más recientemente en ESP32, Preferences.

En DeviceScript, tenemos un mecanismo unificado y mucho más amigable: el paquete Settings.

Leer y escribir valores

Para usarlo, necesitamos importar readSetting y writeSetting desde @devicescript/settings.

Escribir un dato

import { writeSetting } from "@devicescript/settings"

// Guardamos un número
await writeSetting("brillo", 80)

// Guardamos un texto
await writeSetting("nombre", "Luis")

La llamada lleva await porque escribir en flash es una operación asíncrona.

Leer un dato

Aquí hay un detalle importante: ¿Qué pasa si el dato no existe? (Por ejemplo, la primera vez que encendemos la placa). Podemos pasar un valor por defecto a readSetting.

import { readSetting } from "@devicescript/settings"

// Leemos el valor
const brilloGuardado = (await readSetting<number>("brillo")) ?? 50

console.log(`Valor recuperado: ${brilloGuardado}`) 

Ejemplo: contador de reinicios

El “Hola Mundo” de la persistencia es contar cuántas veces ha arrancado nuestro dispositivo. Esto nos demuestra que el dato sobrevive al apagado.

import { readSetting, writeSetting } from "@devicescript/settings"
import { delay } from "@devicescript/core"

async function gestionarContador() {
    console.log("Iniciando sistema...")

    // 1. Leemos el valor actual. Si no existe, empieza en 0.
    let contador = (await readSetting<number>("boot_count")) ?? 0

    console.log(`Este dispositivo se ha reiniciado ${contador} veces.`)

    // 3. Incrementamos y guardamos para la próxima
    contador++
    await writeSetting("boot_count", contador)
    
    console.log("Nuevo valor guardado. ¡Reiníciame!")
}

gestionarContador()

Guardar objetos como JSON

El servicio de Settings guarda tipos básicos. Pero, ¿y si quiero guardar toda la configuración de mi dispositivo de golpe?

const config = {
    modo: "auto",
    umbrales: { min: 20, max: 30 },
    activo: true
}

No podemos guardar un objeto JS directamente. Pero tenemos un viejo amigo que nos ayuda: JSON.

Convertimos el objeto a texto (stringify) para guardar, y lo reconvertimos a objeto (parse) al leer.

import { readSetting, writeSetting } from "@devicescript/settings"

const CLAVE_CONFIG = "config"

// --- GUARDAR ---
async function guardarConfig(cfg: any) {
    const texto = JSON.stringify(cfg)
    await writeSetting(CLAVE_CONFIG, texto)
    console.log("Configuración guardada.")
}

// --- CARGAR ---
async function cargarConfig() {
    const texto = (await readSetting<string>(CLAVE_CONFIG)) ?? ""
    
    if (!texto) {
        // Devolvemos una configuración por defecto si no hay nada guardado
        return { modo: "manual", umbrales: { min: 0, max: 100 } }
    }
    
    // Convertimos el texto de vuelta a objeto
    return JSON.parse(texto + "")
}

Borrar datos

A veces necesitamos hacer un “Factory Reset” y borrar todo. Para eso, lo más cómodo es usar la propia extensión de VS Code.

Ejecuta DeviceScript: Clear Device Settings... para borrar los ajustes del dispositivo conectado.

Diferencia entre settings y secretos

Una distinción importante en DeviceScript:

• Settings: Para datos de tu aplicación (colores, contadores, preferencias). Se pueden leer y escribir desde código fácilmente.
• Secretos de WiFi o MQTT: Van en .env.local, no se suben a Git y se transfieren al dispositivo al desplegar. No los muestres en la consola.