Использование EEPROM для сохранения состояния при перезагрузке

Что такое EEPROM и зачем она нужна в умном доме?

> ℹ️ Информация: EEPROM - это "долговременная память" вашего контроллера для самых важных данных, которые должны пережить любую перезагрузку.

В основе отказоустойчивой системы автоматизации лежит способность восстанавливать свое рабочее состояние после непредвиденных событий, таких как сбои питания или плановые перезагрузки. Для решения этой задачи в контроллерах HI, как и во многих промышленных устройствах, используется специальный тип памяти — EEPROM (Electrically Erasable Programmable Read-Only Memory), или электрически стираемое перепрограммируемое постоянное запоминающее устройство.

Давайте разберемся, какое место EEPROM занимает в иерархии памяти контроллера и почему именно она является ключевым элементом для сохранения состояний.

| Тип памяти | Энергозависимость | Скорость | Основное назначение в контроллере HI | Аналогия |

| :--------- | :----------------- | :------- | :----------------------------------------------------------------- | :------------------------- |

| RAM | Да (данные теряются) | Очень высокая | Хранение текущих состояний потоков Node-RED, временных переменных. | Рабочий стол |

| Flash | Нет | Средняя | Хранение операционной системы Debian, приложений, логов, потоков Node-RED. | Жесткий диск компьютера |

| EEPROM | Нет | Низкая | Хранение критически важных, редко изменяемых данных (состояния, уставки). | Сейф с важными документами |

Основное отличие EEPROM от оперативной памяти (RAM) заключается в энергонезависимости. Данные, записанные в EEPROM, сохраняются даже при полном отключении питания контроллера. В отличие от Flash-памяти, которая используется для хранения операционной системы и файлов проекта, EEPROM оптимизирована для побайтовой (или поблочной, но очень мелкими блоками) записи. Flash-память, в свою очередь, оперирует крупными блоками (страницами), что делает её неэффективной для частой записи небольших порций данных.

Роль EEPROM в восстановлении состояния:

Представьте ситуацию: пользователь включил освещение в гостиной, установил комфортную температуру на термостате и активировал режим "Вечер". Через час происходит кратковременный сбой в электросети. Контроллер перезагружается. Что должно произойти дальше?

Без EEPROM: Контроллер загружает операционную систему и Node-RED. Все реле переходят в состояние по умолчанию (обычно "выключено"), а уставки термостатов сбрасываются. Пользователю приходится заново настраивать всю систему. Это неприемлемо для комфортного и надежного умного дома.

С использованием EEPROM: После каждого намеренного изменения состояния (включение света, смена уставки), система записывает новое значение в EEPROM. При перезагрузке специальный сценарий считывает эти сохраненные значения и отправляет команды на соответствующие устройства (реле, диммеры, термостаты). В результате, через несколько секунд после старта контроллера освещение в гостиной снова включается, а термостат возвращается к заданной температуре.

Таким образом, EEPROM обеспечивает персистентность — способность системы "помнить" свои состояния между сессиями работы. Это напрямую связано с концепцией 'Safe-State', которую мы уже рассматривали. Однако, если аварийный 'Safe-State' (как при пожаре) определяет безопасное состояние по умолчанию, то восстановление из EEPROM обеспечивает возврат к последнему штатному, заданному пользователем состоянию, гарантируя непрерывность и комфорт.

---

Архитектура памяти в Wirenboard: работа с утилитой wb-eeprom

> 💡 Подсказка: Используйте `wb-eeprom --help` для просмотра всех доступных опций утилиты прямо на контроллере. Это поможет быстро вспомнить синтаксис без обращения к документации.

На контроллерах HI, работающих под управлением Debian, для взаимодействия с энергонезависимой памятью предусмотрена стандартная утилита командной строки — `wb-eeprom`. Она предоставляет простой, но мощный интерфейс для чтения и записи данных в специально отведенную пользовательскую область EEPROM.

Структура и базовые команды

Пользовательская область в EEPROM организована как простое хранилище пар "ключ=значение". Вы можете задавать произвольные имена ключей и присваивать им строковые значения. Этого достаточно для хранения большинства типов настроек.

Для работы с утилитой необходимо подключиться к контроллеру по SSH.

Чтение всех сохраненных данных:

Команда `-r` (read) без указания ключа выводит все пары, хранящиеся в EEPROM.

root@wirenboard-XXXXXXXX:~# wb-eeprom -r
room_thermostat_setpoint="23.5"
main_light_state="1"

Запись или обновление значения:

Команда `-w` (write) используется для записи. Если ключ уже существует, его значение будет перезаписано. Если нет — будет создана новая запись.

# Сохраняем состояние реле (1 - включено)
root@wirenboard-XXXXXXXX:~# wb-eeprom -w 'main_light_state=1'

# Обновляем уставку термостата
root@wirenboard-XXXXXXXX:~# wb-eeprom -w 'room_thermostat_setpoint=24.0'

Чтение конкретного значения:

Чтобы получить значение только одного ключа, укажите его имя после флага `-r`.

root@wirenboard-XXXXXXXX:~# wb-eeprom -r main_light_state
main_light_state="1"

Формат данных

Важно понимать, что `wb-eeprom` сохраняет все данные в виде строк. Ваша логика в Node-RED должна быть готова к последующему преобразованию этих строк в нужные типы (числа, булевы значения).

• Булево значение (Boolean): Принято использовать `1` для `true` (включено, активно) и `0` для `false` (выключено, неактивно).
• Целое число (Integer): Записывается как строка, например, `scene_id="3"`.
• Число с плавающей точкой (Float): Записывается как строка, например, `setpoint="22.5"`.

> ⚠️ Внимание: Имена ключей не должны содержать пробелов и спецсимволов. Используйте `underscore_case` или `camelCase` для улучшения читаемости, например: `livingRoomLightMain` или `living_room_light_main`.

Работа с `wb-eeprom` напрямую из командной строки — это отличный способ для ручной диагностики и настройки. Однако для полноценной автоматизации нам необходимо научиться вызывать эту утилиту из наших потоков в Node-RED.

---

Практика: Сохранение состояния в EEPROM из Node-RED

Теперь интегрируем `wb-eeprom` в нашу систему автоматизации. Основным инструментом для этого будет узел `exec`, который позволяет выполнять любые команды в операционной системе контроллера.

Задача: Создать поток, который отслеживает состояние реле и автоматически сохраняет его в EEPROM при каждом изменении. Архитектура потока:

[mqtt in] --> [rbe] --> [function] --> [exec] --> [debug]

`mqtt in`: Подписывается на топик состояния реле. Например, для реле K1 модуля WB-MR6C_34 топик будет `/devices/wb-mr6c_34/controls/K1`.

`rbe` (report by exception): Крайне важный узел. Он пропускает сообщение дальше, только если его `msg.payload` отличается от предыдущего. Это предотвращает ненужную запись в EEPROM при каждом периодическом обновлении статуса от устройства и защищает память от износа.

`function`: Формирует команду для `wb-eeprom`.

`exec`: Выполняет сформированную команду.

`debug`: Показывает результат выполнения команды (полезно для отладки).

> 🔗 Связанный материал: Логика фильтрации сообщений с помощью узла `rbe` подробно разбиралась в модуле по основам Node-RED: COURSE-01-M02-L04.

Пошаговая реализация

Шаг 1: Создание потока

Разместите на холсте узлы `mqtt in`, `rbe`, `function`, `exec` и `debug`. Соедините их последовательно.

Шаг 2: Настройка `mqtt in`

• Сервер: Выберите ваш MQTT-брокер.
• Топик: `/devices/wb-mr6c_34/controls/K1` (замените `wb-mr6c_34` на ID вашего устройства).
• Вывод: `строка`.

Шаг 3: Настройка `rbe`

• Режим: `блокировать, если значение не изменилось (report by exception)`.
• Остальные параметры можно оставить по умолчанию.

Шаг 4: Настройка `function` (Формирование команды)

Этот узел — сердце нашей логики. Он принимает "0" или "1" из MQTT и преобразует это в полноценную команду.

• Имя: `Create EEPROM command`
• Код:

// Ключ, под которым мы будем хранить состояние в EEPROM.
// Рекомендуется делать его уникальным и понятным.
const eepromKey = "state_relay_K1_mr6c_34";

// Входящее сообщение от MQTT-узла содержит "0" или "1" в msg.payload.
const state = msg.payload;

// Простая валидация: мы ожидаем только "0" или "1".
if (state !== '0' && state !== '1') {
    node.warn(`Invalid payload received: ${state}. Expected '0' or '1'.`);
    return null; // Останавливаем поток, если данные некорректны.
}

// Формируем команду для утилиты wb-eeprom.
// Формат: wb-eeprom -w 'ключ=значение'
const command = `wb-eeprom -w '${eepromKey}=${state}'`;

// Помещаем команду в msg.payload, так как узел exec по умолчанию
// выполняет именно это значение.
msg.payload = command;

// Для отладки добавим в сообщение исходные данные.
msg.originalState = state;

// Обновляем статус узла для наглядности
node.status({ fill: "blue", shape: "dot", text: `Saving ${eepromKey}=${state}` });

return msg;

Шаг 5: Настройка `exec`

• Команда: Оставьте это поле пустым. Узел будет выполнять команду из `msg.payload`.
• Тайм-аут: `10` секунд (более чем достаточно).
• Имя: `Write to EEPROM`

Теперь, каждый раз, когда вы будете включать или выключать реле K1 (через интерфейс или физической кнопкой, если она настроена), его новое состояние (`0` или `1`) будет надежно сохранено в энергонезависимой памяти.

---

Практика: Восстановление состояния при загрузке системы

Сохранять состояние — это половина дела. Теперь нам нужно научить систему восстанавливать его после перезагрузки. Для этого мы создадим отдельный поток, который будет запускаться один раз при старте Node-RED.

Задача: Создать поток, который при старте системы считывает сохраненное состояние реле из EEPROM и отправляет соответствующую команду в MQTT. Архитектура потока:

[inject] --> [exec] --> [function] --> [mqtt out]

`inject`: Срабатывает один раз после запуска Node-RED, инициируя процесс восстановления.

`exec`: Выполняет команду `wb-eeprom` на чтение нужного ключа.

`function`: "Парсит" (разбирает) текстовый вывод от `exec` и формирует сообщение для MQTT.

`mqtt out`: Публикует команду на включение/выключение в управляющий топик реле.

Пошаговая реализация

Шаг 1: Создание потока восстановления

Разместите на холсте узлы `inject`, `exec`, `function` и `mqtt out`, соединив их.

Шаг 2: Настройка `inject`

• `Payload` и `Topic` можно оставить пустыми.
• Установите галочку "Запускать один раз при запуске/развертывании".
• Установите задержку, например, `10` секунд. Это важно, чтобы дать время всем системным службам, включая драйвер wb-mqtt-serial, полностью запуститься.

Шаг 3: Настройка `exec` (Чтение из EEPROM)

• Команда: `wb-eeprom -r state_relay_K1_mr6c_34` (используйте тот же ключ, что и в потоке сохранения).
• Имя: `Read from EEPROM`

Шаг 4: Настройка `function` (Парсинг ответа)

Вывод от `exec` — это строка вида `state_relay_K1_mr6c_34="1"`. Нам нужно извлечь из нее значение `1`.

• Имя: `Parse EEPROM response`
• Код:

/*
  Узел exec возвращает результат своей работы в msg.payload.
  Обычно это строка, например: 'state_relay_K1_mr6c_34="1"\n'
  Нам нужно извлечь значение после знака "=".
*/

const rawOutput = msg.payload;

// Проверяем, что вывод не пустой. Пустой вывод означает, что ключ не найден.
if (!rawOutput || rawOutput.trim() === '') {
    node.warn("EEPROM key not found. No state to restore.");
    return null; // Ничего не делаем, если состояние еще не было сохранено.
}

// Используем регулярное выражение для надежного извлечения значения в кавычках
const match = rawOutput.match(/="([^"]*)"/);

if (match && match[1]) {
    const state = match[1]; // Извлеченное значение, например, "1"

    // Передаем извлеченное состояние дальше.
    // Управляющий топик ожидает "0" или "1".
    msg.payload = state;

    // Формируем правильный управляющий топик для MQTT.
    // Обратите внимание на суффикс "/on".
    msg.topic = "/devices/wb-mr6c_34/controls/K1/on";

    node.status({ fill: "green", shape: "dot", text: `Restoring state: ${state}` });
    return msg;

} else {
    node.error("Failed to parse EEPROM output: " + rawOutput, msg);
    return null; // Останавливаем поток в случае ошибки парсинга.
}

Шаг 5: Настройка `mqtt out`

• Сервер: Выберите ваш MQTT-брокер.
• Топик: Оставьте поле пустым, так как топик будет взят из `msg.topic`, который мы сформировали в узле `function`.
• QoS: `1`
• Retain: `false` (очень важно, так как мы хотим отправить команду, а не сохранить ее на брокере).

После развертывания этих двух потоков ваша система станет по-настоящему отказоустойчивой. Состояние реле будет переживать перезагрузки, обеспечивая предсказуемое поведение и высокий уровень комфорта. Эту же логику можно применить к диммерам, уставкам термостатов и любым другим важным параметрам.

---

Ограничения и лучшие практики использования EEPROM

> ⚠️ Внимание: Частая перезапись ячеек EEPROM (например, несколько раз в минуту) может привести к их физическому износу и выходу из строя в течение нескольких месяцев. Всегда минимизируйте количество операций записи!

EEPROM — мощный инструмент, но он не является универсальным решением для хранения любых данных. Главное ограничение этой технологии — ограниченный ресурс циклов перезаписи. Каждая ячейка памяти рассчитана на определенное количество операций записи, обычно от 100 000 до 1 000 000. После превышения этого порога ячейка может перестать надежно хранить данные.

Представим, что мы решили сохранять показания датчика температуры каждую секунду.

`60 (записей в минуту) 60 (минут) 24 (часа) = 86 400` записей в сутки.

При ресурсе в 100 000 циклов, память выйдет из строя чуть больше чем за сутки. Это наглядно демонстрирует, почему критически важно подходить к использованию EEPROM осознанно.

Какие данные можно и нельзя хранить в EEPROM

| ✅ Можно и нужно сохранять | ❌ Категорически нельзя сохранять |

| :----------------------------------------------------------- | :-------------------------------------------------------------- |

| Состояния реле и диммеров (вкл/выкл, яркость) | Текущие показания датчиков (температура, влажность, CO2) |

| Уставки термостатов (желаемая температура) | Значения счетчиков электроэнергии, воды, газа |

| Режимы работы системы (авто/ручной, день/ночь) | Высокочастотные события (каждое нажатие кнопки в процессе "диммирования") |

| Выбранная пользователем сцена освещения (ID сцены) | Временные метки (timestamps) событий |

| Положение приводов (шторы, ворота, клапаны) | Любые данные, обновляющиеся чаще, чем раз в несколько минут |

Стратегии минимизации операций записи

Чтобы продлить срок службы EEPROM до десятков лет, необходимо применять следующие практики:

Использование узла `rbe` (Report by Exception): Это самая первая и самая важная линия защиты. Как мы уже показали на практике, этот узел отфильтровывает все повторяющиеся значения, разрешая запись только при реальном изменении состояния.

Задержка записи (Debounce/Delay): Часто пользователь может быстро несколько раз изменить параметр. Например, регулируя яркость диммера или температуру на термостате. Вместо того чтобы записывать каждое промежуточное значение, можно использовать узел `trigger`.

* Логика: При поступлении нового значения узел `trigger` запускает таймер (например, на 5 секунд). Если в течение этого времени приходит еще одно значение, таймер сбрасывается и запускается заново. Запись в EEPROM происходит только после того, как в течение 5 секунд не было новых изменений.

Запись только по явному действию пользователя: Если состояние устройства может меняться и по логике автоматизации, и по действию пользователя в интерфейсе, настройте запись в EEPROM только на второе. Это гарантирует, что сохранено будет именно то состояние, которое "захотел" человек.

Групповая запись: Если у вас есть несколько связанных параметров (например, яркость, цвет и цветовая температура лампы), лучше объединить их и записывать одним действием по нажатию кнопки "Сохранить сцену", а не при каждом изменении ползунка.

Соблюдение этих простых правил гарантирует, что EEPROM вашего контроллера прослужит весь срок эксплуатации устройства, обеспечивая надежное хранение самых важных параметров вашей системы автоматизации.

Итоги урока

В этом уроке мы сделали важный шаг к построению по-настоящему профессиональных и отказоустойчивых систем автоматизации. Мы изучили один из ключевых компонентов аппаратного обеспечения контроллера — энергонезависимую память EEPROM — и научились использовать ее для сохранения и восстановления состояний.

Ключевые выводы:

• EEPROM — это энергонезависимая память, предназначенная для хранения небольших объемов критически важных данных, которые должны "пережить" перезагрузку или сбой питания.
• Основным инструментом для работы с EEPROM на контроллерах HI является утилита командной строки `wb-eeprom`.
• С помощью узла `exec` в Node-RED мы можем легко интегрировать `wb-eeprom` в наши потоки автоматизации, создавая логику сохранения состояний при их изменении.
• Используя узел `inject`, настроенный на однократный запуск, мы можем реализовать надежный механизм восстановления состояний при старте системы.
• Самым главным ограничением EEPROM является ограниченный ресурс циклов перезаписи. Экономия этого ресурса с помощью таких техник, как фильтрация дублей (`rbe`) и задержка записи (`trigger`), является обязательным требованием для создания долговечных систем.

Освоив эти принципы, вы сможете гарантировать, что ваш умный дом всегда будет возвращаться в предсказуемое и комфортное для пользователя состояние, независимо от внешних обстоятельств.

Что дальше?

В следующих уроках мы продолжим изучать продвинутые сценарии обеспечения безопасности и отказоустойчивости. Мы рассмотрим, как организовать резервные каналы управления и оповещения, например, через GSM-модем, чтобы система оставалась на связи даже при полном отказе локальной сети.