Базовая архитектура архивов ultra_com

Назначение

Документ задаёт целевую архитектуру памяти и архивов для одноканального прибора ultra_com, совмещающего регистратор и первичный измерительный преобразователь. Это базовый документ нового набора; остальные файлы детализируют логику, поля, вопросы и карту flash.

Исходные решения

Фактические размеры из IAR ICCARM

Объект Размер, B Выравнивание, B Примечание
RamSP 10376 4 Текущая RAM-структура
FlashSP 3172 4 Текущая область конфигурации
SystemFlashSP 320 4 Служебная flash-структура
globalSP 4960 8 Текущая runtime-структура
nak_data 512 4 Только RAM-структура накоплений; отдельного NAK-региона нет
tpg_data 764 — Размер одного блока TPG
justL_data 16 — Размер одного блока justL
just0_data 16 — Размер одного блока just0

Измеренные модели архивных записей

Запись Размер, B Статус
APH legacy 44 Probe-модель естественного выравнивания
APH RS4 / Qnc2 40 Probe-модель естественного выравнивания
APD legacy 68 Измерена целая модель календаря + канала
APD RS4 / Qnc2 72 Измерена целая модель календаря + канала
GCA normal 76 Probe-модель обычной ветки
CA 32 Probe-модель
SYSTEM_ARCHIVE natural 20 Фактический natural-размер модели
STATE_FULL diagnostic 536 Кандидат записи с payload NAK/runtime-state, не утверждённый рабочий тип

Для SYSTEM_ARCHIVE измеренная probe-модель с естественным выравниванием занимает 20 B. Это оценка размещения текущего набора полей; окончательная структура записи определяется реализацией. Периодика журнала не меняет интервал STATE_FULL.

Условная оценка отдельного legacy AE: одна запись на шестиминутный интервал для одного канала занимает 15 B — календарная строка 12 B и строка ПП 3 B. При глубине 24 000 интервалов это около 360 000 B, или 88 секторов без служебных метаданных. Это только оценка возможного варианта, не решение о реализации AE.

Секторные ёмкости по целевым глубинам

Архив / область Глубина Размер записи, B Данные, B Секторов 4096 B
APH legacy 2400 44 105 600 26
APH RS4 2400 40 96 000 24
APD legacy 2400 68 163 200 40
APD RS4 2400 72 172 800 43
GCA normal 2400 76 182 400 45
CA 64 32 2 048 1
SYSTEM_ARCHIVE natural 4800 20 96 000 24
STATE_FULL diagnostic 100 536 53 600 14

Сырой итог без служебных данных: от 148 до 153 секторов в зависимости от выбора APH/APD. Включён один STATE_FULL глубиной 100 и размером диагностической записи 536 B; отдельный регион накоплений не добавляется.

С предложенным форматом служебных данных — заголовок сектора 32 B, манифест A/B на 2 сектора, по одному резервному сектору на архив — новые архивы и служебные данные занимают 164 сектора для наибольшего варианта (APH legacy + APD RS4) и 159 секторов для наименьшего (APH RS4 + APD legacy).

Полный бюджет внешней flash включает сохраняемые служебные области, которые код пишет через Flash_int_*: конфигурацию, TPG, юстировки и NAK — ещё 5 секторов. BEG_Vcode и миниархив в расчёт не входят, так как от их использования отказались. Поэтому полный расход без AE составляет 169 секторов (692 224 B, 16,5 %) для наибольшего варианта и 164 сектора (671 744 B, 16,0 %) для наименьшего. AE в расчёт не включён. Подробности и проверка сумм — в 04_FLASH_MAP.md.

Ключевые смещения конфигурации

Параметр Значение
UniFlash StartOffset 0x288B (10379)
sizeof(FlashSP) 3172 B
FlashSP от StartOffset 3166 B
offsetof(FlashSP, data.num_v_save) 6
offsetof(FlashSP, data.kratnost_2) 2362
kratnost_2 от StartOffset 2356
offsetof(FlashSP, data.conf_area) 2404

Связь документов


01_ARCHIVE_LOGIC.md — логика работы архивов

Общий принцип

Все архивные операции выполняет один последовательный писатель. Запись считается принятой только после проверки CRC и маркера подтверждения; незавершённая запись не продвигает индекс.

APH — почасовой архив

Что Значение
Когда пишется На границе нового часа RTCA; одна запись за час
Зачем пишется История часовых срезов для отчётов и восстановления суточных данных
Откуда берётся Накопления часа в RAM: Vnu, Vrab, средние P/T, tnc1/tnc3, Fl_a, Fl_b
Для чего читается Построение отчётов, проверка истории, источник для APD. Внешние команды cmd1 и cmd8
После записи Накопления часа сбрасываются, индекс APH продвигается
Глубина 2400

Ключевое правило: APD строится из окна уже записанных строк APH. Пропущенные строки APH задним числом не создаются.

APD — суточный архив

Что Значение
Когда пишется На границе отчётных суток; одна запись за отчётные сутки
Зачем пишется Суточные итоги: конечные счётчики и дельты за сутки, средние P/T, время нештатных состояний, OR флагов
Откуда берётся Окно строк APH за сутки плюс ссылки FirstRecGCA/CountRecGCA и FirstRecCA/CountRecCA
Для чего читается Отчёты за сутки и месяц, внешние команды cmd0 и cmd7
Глубина 2400

GCA — архив изменения состава газа

Что Значение
Когда пишется При смене состава или среды, после подтверждённой проверки; команда cmd5
Зачем пишется Зафиксировать момент смены, номер среды, компоненты и плотность
Откуда берётся Текущий состав газа и ЧРВ на момент события
Для чего читается Проверка истории состава, восстановление контекста расчёта, отчёты
Глубина 2400 физических строк

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

CA — архив изменения констант

Что Значение
Когда пишется При изменении договорных или системных констант после фиксации
Зачем пишется Снимок блока констант и код того, что изменилось
Откуда берётся Текущие настройки и ca_code
Для чего читается Аудит изменений настроек, восстановление контекста отчётов
Глубина 64

Коды ca_code и соответствующее содержимое const_change описаны в 02_ARCHIVE_FIELDS.md.

SYSTEM_ARCHIVE — системный журнал

Что Значение
Когда пишется Контрольная точка каждые 6 секунд — 10 записей в минуту; фазы перехода входят в точки, не добавляя строк. Глубина 4800 даёт 8 часов номинальной истории
Зачем пишется Журнал системных событий: устойчивые переходы состояния, запуск и потеря питания, изменение конфигурации, сброс и установка времени. Не хранит payload накоплений и не заменяет AE
Откуда берётся mask_prot, mask_dem, T_dem_zad, состояние конфигурации, RTCA
Для чего читается Восстановление устойчивого состояния после запуска и аудит событий
Глубина 4800

Защита от дребезга:

  1. Каждые 6 секунд снимается текущее значение контролируемого состояния для системного журнала.
  2. Детектор хранит историю выборок и применяет голосование большинством.
  3. При первом обнаружении отличия фиксируется фаза BEGIN в очередной записи журнала.
  4. При подтверждении нового состояния фиксируется фаза END в очередной записи журнала.
  5. Если перехода нет, по периодике журнала пишется фаза STEADY.

Кратковременные возвраты между BEGIN и END не создают дополнительный поток подтверждённых переходов. Период системного журнала задаётся резервным параметром kratnost_2; он не задаёт период STATE_FULL, который записывается не чаще раза в 360 секунд.

STATE_FULL — единый архив checkpoint-снимков

Что Значение
Когда пишется Не чаще одного раза за 360 секунд; событийные триггеры не создают дополнительную запись в пределах этого интервала
Зачем пишется Единая точка восстановления полного рабочего состояния, накоплений и незакрытого часа после сброса или потери питания
Откуда берётся Runtime-state, необходимые поля старого nak_data, незакрытое состояние часа и ссылки на поколение конфигурации
Для чего читается Продолжение расчёта и расписания после сбоя по последней записи с валидными CRC и commit
Глубина 100 записей; около 10 часов номинального покрытия при интервале 360 секунд

Правила:

Порядок при совпадении событий

  1. Завершить начатые архивные транзакции и установить их результат.
  2. Записать BEFORE_RESET или POWER_OFF, если событие ещё можно зафиксировать.
  3. При изменении конфигурации записать и проверить новое поколение, затем связать с ним STATE_FULL.
  4. Записать APD на границе отчётных суток.
  5. Записать APH на границе часа.
  6. Сформировать STATE_FULL, только если наступил срок не чаще одного раза за 360 секунд.
  7. Записать прочие устойчивые события в порядке поступления.

При сбое до подтверждения нового поколения продолжают действовать прежние конфигурация и состояние.

Коррекция RTCA

SYSTEM_ARCHIVE хранит календарное RTCA, а не наработку. При установке времени сначала записывается событие со старым временем, затем меняются часы и опорные точки расписания. Пропущенные записи APH/APD задним числом не создаются. После коррекции порядок событий задаётся последовательным номером.

Связанные документы


02_ARCHIVE_FIELDS.md — состав полей архивов и вариации

Общие правила

OperTime (общий компонент)

Поле Тип Байт
seconds uint8 1
minutes uint8 1
hour uint16 2
Итого 4

APH — почасовой архив

Измерено: 44 B legacy, 40 B RS4.

Календарь часа

Поле Тип Байт
Minutes uint8 1
Hour uint8 1
Day uint8 1
Month uint8 1
Year uint8 1
oper_time OperTime 4
Reserv[3] uint8[3] 3
Итого значимых 12

Строка канала legacy

Поле Тип Байт Смысл
Vnu uint32 4 Объём при стандартных условиях нарастающим итогом
Vrab uint32 4 Объём при рабочих условиях или теплота
P float 4 Среднее давление за час
T float 4 Средняя температура за час
THC1 uint16 2 Время НС1 за час, секунды
THC3 uint16 2 Время НС3 за час, секунды
Fl_a uint8 1 Общие флаги регистратора за час
Fl_b uint16 2 Флаги ПП за час с маской архива
Reserv uint8 1 Ноль
Итого значимых 24

Отличие RS4/Qnc2

Вместо THC3 используется Qnc2 (младшие два байта), вместо Reserv — третий байт Qnc2. Сумма значимых полей та же — 24 B.

Полная запись

Вариант Значимые поля С padding Примечание
Legacy 12 + 24 = 36 44 Календарь выравнивается до 4 B
RS4/Qnc2 12 + 24 = 36 40 Иная раскладка padding

APD — суточный архив

Измерено: 68 B legacy, 72 B RS4 — целые записи календаря и канала, а не сумма компонентов.

Календарь суток

Поле Тип Байт
hour, day, month, year uint8 ×4 4
time_on float 4
oper_time OperTime 4
THC2 uint16 2
ReportHour uint8 1
FirstRecAPH uint16 2
RoundRecAPH uint8 1
CountRecAPH uint8 1
first_sequence uint16 2
sequence_count uint16 2

Поля first_sequence и sequence_count заменяют прежние байтовые ссылки на AE в целевой модели.

Строка канала legacy

Поле Тип Байт Смысл
Vnu uint32 4 Накопленный объём при стандартных условиях на конец суток
Vrab uint32 4 Накопленный объём при рабочих условиях
Qnu uint32 4 Расход за сутки при стандартных условиях
Qrab uint32 4 Расход за сутки при рабочих условиях
P float 4 Среднее давление за сутки
T float 4 Средняя температура за сутки
THC1 uint16 2 Сумма НС1 за сутки, минуты
THC3 uint16 2 Сумма НС3 за сутки, минуты
Vnc uint32 4 Объём при НС
Fl_a uint8 1 OR флагов за сутки
Fl_b uint16 2 OR флагов ПП за сутки
FirstRecGCA, RoundRecGCA, CountRecGCA uint8 ×3 3 Окно GCA за сутки
FirstRecCA, RoundRecCA, CountRecCA uint8 ×3 3 Окно CA за сутки

RS4-вариант заменяет THC3 на Qnc2 плюс третий байт.

APD агрегирует часовые флаги из APH. Это не заменяет шестиминутную историю AE: отдельно требуется решить, нужен ли AE, какой формат записи выбрать, как обрабатывать Fl_a/Fl_b и CountRecAE, а также какой период и глубину обеспечить. Условный legacy-вариант на 24 000 интервалов для одного канала требует около 88 полезных секторов.

GCA — архив изменения состава газа

Измерено: 76 B для обычной ветки.

Поле Тип Байт
Календарь ЧРВ uint8[5] 5
oper_time OperTime 4
NSredy uint8 1
NumComp[12] uint8[12] 12
Components[12] float[12] 48
Density float 4
Итого значимых 74

В legacy-описании дополнительно присутствует Reserv[14], что даёт около 88 B значимых полей. Целевая модель без этого резерва измерена как 76 B.

GCA special branch

Особая ветка (сложный состав, пользовательская среда с name[20], crc16) в текущем probe не моделировалась. Её размер и необходимость поддержки — открытый вопрос.

CA — архив изменения констант

Измерено: 32 B.

Поле Тип Байт
Календарь ЧРВ uint8[5] 5
oper_time OperTime 4
const_change uint16 2
contract_T, contract_P uint16 ×2 4
Q_dog, Vday_ptp uint32 ×2 8
report_hour, begin_month, byte_other uint8 ×3 3
flag_set_1 uint8 1
steam_dryness uint8 1
Итого значимых 28

Reserv[4] из legacy sStringConstAll в компактный состав не включён.

Коды ca_code

Код Смысл
1 Договорная температура
2 Договорное давление
3 Договорной расход
4 Суточные производственно-технологические потери
5 Контрактный час
6 Контрактный день, начало месяца
7 Способ учёта при плохом сигнале Q
8 Блокировка изменения состава газа
9 Установка часов и даты
10 Очистка архива
11 Блокировка изменения типа среды

При ca_code < 16 в const_change выставляется бит с номером кода; при ca_code >= 16 записывается само значение кода.

SYSTEM_ARCHIVE — системный журнал

Измеренная probe-модель с естественным выравниванием занимает 20 B. Это оценка для указанного ниже набора полей; окончательный состав и формат записи могут быть адаптированы под реализацию.

Смещение Размер Поле
0 5 Упакованное RTCA
5 3 Padding до 4 B
8 4 Флаги или контролируемое состояние
12 2 Последовательный номер
14 1 Тип события
15 1 Причина
16 2 CRC-16/Modbus
18 1 Маркер подтверждения
19 1 Padding до выравнивания 4 B

Состав событий:

Причина Условие Время записи
PROT_TRANSITION Изменение устойчивого mask_prot Текущее RTCA
DEM_TRANSITION Изменение устойчивого mask_dem или T_dem_zad Текущее RTCA
POWER_OFF Успела завершиться запись по сигналу питания Последнее доступное RTCA
POWER_ON Запуск после сброса или подачи питания RTCA после запуска
CONFIG_CHANGE Успешное изменение конфигурации или состава RTCA после фиксации
BEFORE_RESET Событие перед сбросом или установкой времени RTCA до действия

Фазы записи: BEGIN, END, STEADY.

STATE_FULL — единый checkpoint и диагностическая модель

Измерено: 536 B для ProbeStateFullRecord. Это диагностический кандидат записи STATE_FULL, а не утверждённый рабочий тип.

Модель включает динамический NAK payload (t_nar, рабочее время, vnak_i[10], vnak_f[10], t_flag[160], flag_6min[10], dt_otn_6m[10], sum_izm_dt_otn_6m[10]), рабочие накопления канала (ProbeDfsVArhDataMeaningful channel) и метаданные продолжения (report_hour, begin_month, schedule_sequence, archive_generation, CRC, маркер).

Таким образом, STATE_FULL содержит необходимые поля NAK и полный runtime checkpoint.

Соответствие полей nak_data

Текущий nak_data (512 B) — legacy-снимок накоплений и продолжения расчёта. Поля, нужные для восстановления, входят в единый payload STATE_FULL; отчётные часовые/суточные значения продолжают храниться в APH/APD:

Поле nak_data Назначение Целевое размещение
t_nar Наработка, основа периодических операций STATE_FULL
real_tim_l, real_tim_h Накопленный счётчик реального времени В STATE_FULL, если нужен для продолжения; календарь получать из RTCA
vnak_i[10], vnak_f[10] До 10 целых и дробных накопительных счётчиков STATE_FULL; отчётные производные — APH/APD
flag_6min[10] Флаги незакрытых 6-минутных окон часа STATE_FULL как незакрытое состояние; не путать с AE
t_flag[160] Накопленная длительность флагов с дискретой 4 с STATE_FULL, если требуется после восстановления
dt_otn_6m[10] Среднее относительное время для незакрытых 6-минутных окон STATE_FULL для продолжения текущего часа
sum_izm_dt_otn_6m[10] Накопленное изменение среднего за окна STATE_FULL для продолжения текущего часа
rezerv_nak[8] Резерв Не переносить без подтверждённого потребителя
crc_sum CRC старого snapshot-формата Заменить CRC и маркером commit единой записи STATE_FULL

Периодическая запись выполняется не чаще одного раза за 360 секунд; глубина 100 записей даёт около 10 часов номинального покрытия. Это допускает потерю изменений после последнего подтверждённого checkpoint-а в пределах интервала; приемлемость такого окна нужно подтвердить.

Вывод: единый STATE_FULL заменяет отдельный регион checkpoint-ов накоплений и содержит выбранные для восстановления поля NAK. SYSTEM_ARCHIVE остаётся журналом системных событий. APH/APD хранят отчётные срезы, но не заменяют произвольные накопители vnak_i/vnak_f.

Рабочий состав нужно подтвердить аудитом читателей полей и после исключения ненужных legacy-полей повторно измерить; копировать резерв и старый CRC без необходимости не следует.

Legacy-типы, размеры из IAR

Тип Размер, B
nak_data 512
tpg_data 764
justL_data 16
just0_data 16
FlashSP 3172
SystemFlashSP 320
RamSP 10376
globalSP 4960

Связанные документы


03_OPEN_QUESTIONS.md — открытые вопросы и проверки

Форматы архивных записей

  1. Выбор APH: legacy 44 B или RS4/Qnc2 40 B. Оба варианта измерены; выбрать один для целевой карты.
  2. Выбор APD: legacy 68 B или RS4/Qnc2 72 B. Измерены целые записи, а не только компоненты.
  3. SYSTEM_ARCHIVE: IAR probe измерил natural-модель в 20 B.
  4. GCA special branch: legacy-описание пользовательской среды (name[20], crc16) не измерено. Решить, поддерживается ли ветка, и если да — снять полный размер.
  5. STATE_FULL: диагностическая модель 536 B не является утверждённым рабочим типом. Собрать минимальный рабочий состав и повторно измерить.

Логика SYSTEM_ARCHIVE

  1. Требуемая история системного журнала: при контрольной записи каждые 6 секунд глубина 4800 записей равна 8 часам. Подтвердить, достаточно ли этого срока.
  2. Семантика AE: решить, нужен ли отдельный архив AE. Если нужен — определить формат, период записи (legacy: 6 минут), состав календарной строки и строки ПП, обработку Fl_a/Fl_b, а также глубину. Legacy-вариант глубиной 24000 интервалов для одного канала занимает около 88 полезных секторов без служебных данных.
  3. Порог дребезга: подтвердить число выборок и правило большинства для mask_prot, mask_dem и T_dem_zad.
  4. Значение kratnost_2: закрепить номинал для периода 6 секунд и поведение при 0.
  5. RTCA: проверить поведение при переводе часов и при первом включении без достоверного RTCA. При коррекции календаря порядок событий задаётся последовательным номером.

STATE_FULL — единый checkpoint NAK и runtime-state

  1. Payload: подтвердить по аудитам читателей, какие поля nak_data обязательны для восстановления: t_nar, real_tim_l/h, vnak_i/f[10], t_flag[160], flag_6min[10], dt_otn_6m[10], sum_izm_dt_otn_6m[10] и необходимые runtime-поля. AE в текущий payload не включается.
  2. Периодика и окно потери: периодическая запись выполняется не чаще одного раза за 360 секунд. Подтвердить допустимость потери изменений после последнего commit-а в пределах этого интервала; события не должны создавать дополнительные записи чаще заданного ограничения.
  3. Глубина STATE_FULL: целевая глубина 100 записей даёт около 10 часов номинального покрытия при периоде 360 секунд. Подтвердить достаточность глубины и политику кольцевой записи. Глубина AE определяется отдельно.
  4. Секторный ресурс STATE_FULL: диагностическая запись 536 B при глубине 100 занимает 14 секторов по сырым данным и 15 секторов с учётом заголовка 32 B и запрета разрыва записи. Повторно измерить утверждённый payload вместе с форматом CRC/commit, оценить write amplification и ресурс стирания ZD25Q. Если AE будет принят, рассчитать его регион отдельно.
  5. Восстановление при старте: Проверить все стартовые пути и определить источник инициализации счётчиков и порядок восстановления из STATE_FULL.

Карта памяти

  1. Служебные данные: выбрать состав заголовков секторов, индексов последней записи, поколений, CRC и маркеров подтверждения. Их размер пока не включён в секторные ёмкости.
  2. Резервные секторы: определить количество резервных секторов для каждого архива, включая STATE_FULL.

Аппаратные проверки ZD25Q

  1. Повторное программирование страницы: проверить, можно ли перепрограммировать страницу для маркера подтверждения или нужна отдельная запись.
  2. Питание: провести испытания отключения питания во время записи и стирания.

Связанные документы


04_FLASH_MAP.md — карта flash и занимаемое пространство

Области двух типов

В проекте есть два разных адресных пространства, которые нельзя складывать напрямую:

  1. Внутренняя flash MCU / Modbus-карта UniFlash — конфигурация FlashSP, служебные структуры и старые области TPG/justL/just0. Их смещения заданы в device_data.h и INI-файлах.
  2. Внешняя ZD25Q32C — новые архивы APH/APD/GCA/CA/SYSTEM_ARCHIVE и STATE_FULL. Карта внешней flash строится по 4 KiB-секторам.

Измеренные значения внутренней области

Параметр Значение
UniFlash StartOffset 0x288B = 10379
sizeof(FlashSP) 3172 B
FlashSP от StartOffset 3166 B
sizeof(SystemFlashSP) 320 B
offsetof(FlashSP, data.num_v_save) 6
offsetof(FlashSP, data.kratnost_2) 2362
kratnost_2 от StartOffset 2356
offsetof(FlashSP, data.conf_area) 2404
Modbus FLASH begin 10376
Modbus FLASH end 13547
Modbus TPG begin 13548
TPG size 764
Modbus justL begin 14313
justL size 16
Modbus just0 begin 14330
just0 size 16

Секторная карта ZD25Q по целевым глубинам

Принятые размеры:

Логический регион Глубина Размер записи, B Данные, B Секторов Диапазон при последовательном размещении
APH legacy 2400 44 105 600 26 0–25
APH RS4 2400 40 96 000 24 0–23
APD legacy 2400 68 163 200 40 После APH
APD RS4 2400 72 172 800 43 После APH
GCA normal 2400 76 182 400 45 После APD
CA 64 32 2 048 1 После GCA
SYSTEM_ARCHIVE natural 4800 20 96 000 24 После CA
STATE_FULL diagnostic 100 536 53 600 14 После SYSTEM_ARCHIVE; NAK/runtime-state; сырая оценка

Таблица выше — оценка только по полезным данным без служебных заголовков. APH RS4 + APD legacy дают 148 сырых секторов, APH legacy + APD RS4 — 153 сырых сектора. Оба варианта включают один STATE_FULL глубиной 100 и не включают AE; итоговый расход flash после добавления заголовков и служебных данных рассчитан ниже.

Ниже предложен конкретный формат служебных данных и уточнённый расчёт с его учётом.

Служебные данные — предлагаемый формат

Заголовок сектора — 32 B

Пишется один раз при открытии сектора и далее не изменяется. В NOR-flash нельзя надёжно дописывать заголовок после записей, поэтому он содержит только данные, известные на момент открытия; признак завершения сектора определяется по записям при монтировании.

Смещение Размер Поле Назначение
0 4 magic 0x53454348 («SECH»)
4 2 header_version Версия формата заголовка
6 1 archive_id Идентификатор архива
7 1 sector_state OPEN / SEALED / BAD
8 4 sector_seq Порядковый номер сектора в кольце
12 4 erase_count Счётчик стираний для wear-leveling
16 4 open_sequence Номер первой записи в секторе
20 8 reserved Резерв под расширение
28 4 header_crc32 CRC-32 по байтам 0–27

Заголовок занимает первые 32 B каждого архивного сектора; полезная ёмкость сектора уменьшается до 4064 B.

Манифест — 2 сектора, копии A/B

Две копии в отдельных секторах. При обновлении стирается и пишется только неактивная копия, затем увеличивается manifest_sequence. Это обеспечивает атомарность при потере питания и защищает от износа одной страницы.

Заголовок копии — 20 B:

Смещение Размер Поле
0 4 magic (0x4D414E46, «MANF»)
4 2 manifest_version
6 1 archive_count
7 1 copy_id (A/B)
8 4 manifest_sequence
12 4 config_generation
16 4 header_crc32

Дескриптор архива — 48 B, по одному на архив:

Смещение Размер Поле
0 1 archive_id
1 1 state
2 2 record_size
4 2 sector_start
6 2 sector_count
8 2 head_sector
10 2 head_offset
12 2 tail_sector
14 2 tail_offset
16 4 record_count
20 4 first_sequence
24 4 last_sequence
28 4 generation
32 4 erase_total
36 4 payload_crc32
40 8 reserved

Полезный объём одной копии для шести архивов — 20 + 6 × 48 = 308 B. Он с большим запасом помещается в выделенный сектор.

Резерв — 1 сектор на архив

Архив Резерв, секторов
APH 1
APD 1
GCA 1
CA 1
SYSTEM_ARCHIVE 1
STATE_FULL 1
Итого 6

Резервный сектор используется как scratch при переносе записей и при восстановлении после обрыва питания на границе кольца.

Итого внешние служебные данные: 2 сектора манифеста + 6 резервных = 8 секторов (32 768 B). Дополнительно 32 B заголовка расходуются внутри каждого архивного сектора.

Уточнённая ёмкость с учётом заголовков

Запись не разрывается между секторами: в каждом секторе размещается floor(4064 / record_size) целых записей.

Архив Глубина Запись, B Записей в секторе Секторов
APH legacy 2400 44 92 27
APH RS4 / Qnc2 2400 40 101 24
APD legacy 2400 68 59 41
APD RS4 / Qnc2 2400 72 56 43
GCA normal 2400 76 53 46
CA 64 32 127 1
SYSTEM_ARCHIVE 4800 20 203 24
STATE_FULL 100 536 7 15

Отличие от оценки по «сырым» байтам возникает из-за заголовка 32 B и запрета разрыва записи: APH legacy требует 27 вместо 26, APD legacy — 41 вместо 40, GCA — 46 вместо 45, STATE_FULL — 15 вместо 14.

Итоговый расход flash без AE

Суммируются новые архивы со служебными данными и сохраняемые служебные области, которые используются текущим кодом. Области BEG_Vcode и миниархив в расчёт не включаются: от их использования отказались.

TPG, justL и just0

Это не архивы учёта и не journal событий, а накопления служебных режимов:

Эти структуры хранятся по отдельным адресам и записываются во внешнюю flash через Flash_int_*.

Область Байт Секторов 4096 B
Конфигурация: FlashSP, копия во внешней flash 3 172 1
TPG: NNC = 1, NBZ = 1, один блок 764 1
justL_data 16 1
just0_data 16 1
NAK: 6 блоков по 512 B 3 072 1
Сохраняемые служебные области, итого 7 040 5

Код обращается к этим адресам через Flash_int_ReadData() / Flash_int_WriteData(), то есть через драйвер внешней ZD25Q. Адреса областей не выровнены по границам 4096 B (например, BEG_TPG начинается около 13 548), поэтому каждая из них резервирует отдельный сектор; точное физическое размещение нужно сверить с linker map и схемой erase/write.

Вариант Новые архивы, секторов Служебные, секторов Сохраняемые области, секторов Всего, секторов Всего, B Доля от 4 MiB
Наибольший: APH legacy + APD RS4 156 8 5 169 692 224 16,5 %
Наименьший: APH RS4 + APD legacy 151 8 5 164 671 744 16,0 %

Проверка наибольшего варианта: 27 + 43 + 46 + 1 + 24 + 15 = 156 архивных секторов; 2 сектора манифеста, 6 резервных и 5 сохраняемых служебных областей — 169 секторов.

Свободно после наибольшего варианта: 1024 − 169 = 855 секторов, или 3 501 120 B ≈ 3,34 MiB.

Заголовки внутри архивных секторов в наибольшем варианте занимают 156 × 32 = 4 992 B. Полезный объём манифеста — 308 B из 8 192 B выделенных.

Для справки: добавление legacy AE на 88 полезных секторов дало бы 257 секторов, или 1 052 672 B ≈ 1 028 KiB (25,1 % от 4 MiB). AE в базовый расчёт не включён.

Примерная последовательная карта

Ниже — пример для самого большого варианта. Адреса секторов указаны как номер сектора ZD25Q; точные границы нужно подтвердить после выбора APH/APD и служебных данных.

Регион Секторов Диапазон секторов
Сохраняемые служебные области: Config/TPG/just/NAK 5 0–4
APH legacy 27 5–31
APD RS4 43 32–74
GCA normal 46 75–120
CA 1 121
SYSTEM_ARCHIVE 24 122–145
STATE_FULL diagnostic 15 146–160
Манифест служебных данных (копии A/B) 2 161–162
Резервные секторы архивов 6 163–168

Для наименьшего варианта границы сдвинутся на пять секторов раньше.

Что НЕ включается отдельно

STATE_FULL — единый checkpoint-регион

STATE_FULL объединяет полный runtime-снимок, необходимые для восстановления накопления и незакрытое состояние часа из nak_data. Периодическая запись выполняется не чаще одного раза за 360 секунд; при глубине 100 диагностических записей покрытие составляет около 10 часов. Допустимое окно потери данных после последнего подтверждённого снимка — до одного интервала — требует подтверждения.

Сырая полезная ёмкость — 14 секторов для 536 B × 100. С учётом заголовка 32 B в каждом секторе помещается 7 целых снимков, поэтому регион STATE_FULL занимает 15 секторов. Это измеренная диагностическая модель, не финальный размер; служебные данные, commit-метаданные и резерв учтены в уточнённом расчёте выше.

Если отдельный AE будет принят в legacy-варианте для одного канала: 24 000 интервалов × 15 B = 360 000 B, то есть 88 полезных секторов без служебных данных и резервов. Точный регион зависит от утверждённого формата и глубины.

Открытые вопросы

Подробный перечень — в 03_OPEN_QUESTIONS.md.

Связанные документы