Документ задаёт целевую архитектуру памяти и архивов для одноканального прибора ultra_com, совмещающего регистратор и первичный измерительный преобразователь. Это базовый документ нового набора; остальные файлы детализируют логику, поля, вопросы и карту flash.
Один измерительный канал: NNC = 1.
MCU FM33LG0xx; внешняя SPI NOR ZD25Q32C: 4 MiB, сектор 4096 B, страница 256 B.
Глубины архивов сохраняются по требованиям:
SYSTEM_ARCHIVE — отдельный журнал системных событий с собственной периодикой; он не хранит payload накоплений и не заменяет checkpoint.
STATE_FULL — единый архив контрольных снимков полного runtime-state, необходимых для продолжения расчёта полей старого nak_data, накопителей и незакрытого состояния часа. Отдельный ACCUMULATION_ARCHIVE не создаётся.
Периодическая запись STATE_FULL выполняется не чаще одного раза за 360 секунд. При глубине 100 записей номинальное покрытие составляет около 10 часов.
Миниархив не создаётся отдельным регионом; его необходимые поля покрываются APH/APD или единым STATE_FULL после проверки соответствия полей.
AE рассматривается отдельно; необходимость его сохранения, формат, период и глубина остаются открытым вопросом.
При контрольной записи SYSTEM_ARCHIVE каждые 6 секунд глубина 4800 записей соответствует 8 часам номинальной истории.
Новые записи используют естественно выровненные C-структуры с ABI padding; перед записью буфер обнуляется, перенос во flash — через memcpy.
| Объект | Размер, 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 |
Все архивные операции выполняет один последовательный писатель. Запись считается принятой только после проверки CRC и маркера подтверждения; незавершённая запись не продвигает индекс.
| Что | Значение |
|---|---|
| Когда пишется | На границе нового часа RTCA; одна запись за час |
| Зачем пишется | История часовых срезов для отчётов и восстановления суточных данных |
| Откуда берётся | Накопления часа в RAM: Vnu, Vrab, средние P/T, tnc1/tnc3, Fl_a, Fl_b |
| Для чего читается | Построение отчётов, проверка истории, источник для APD. Внешние команды cmd1 и cmd8 |
| После записи | Накопления часа сбрасываются, индекс APH продвигается |
| Глубина | 2400 |
Ключевое правило: APD строится из окна уже записанных строк APH. Пропущенные строки APH задним числом не создаются.
| Что | Значение |
|---|---|
| Когда пишется | На границе отчётных суток; одна запись за отчётные сутки |
| Зачем пишется | Суточные итоги: конечные счётчики и дельты за сутки, средние P/T, время нештатных состояний, OR флагов |
| Откуда берётся | Окно строк APH за сутки плюс ссылки FirstRecGCA/CountRecGCA и FirstRecCA/CountRecCA |
| Для чего читается | Отчёты за сутки и месяц, внешние команды cmd0 и cmd7 |
| Глубина | 2400 |
| Что | Значение |
|---|---|
| Когда пишется | При смене состава или среды, после подтверждённой проверки; команда cmd5 |
| Зачем пишется | Зафиксировать момент смены, номер среды, компоненты и плотность |
| Откуда берётся | Текущий состав газа и ЧРВ на момент события |
| Для чего читается | Проверка истории состава, восстановление контекста расчёта, отчёты |
| Глубина | 2400 физических строк |
Особенность: при сложном составе запись может занимать две физические строки, поэтому оставшаяся глубина уменьшается на две.
| Что | Значение |
|---|---|
| Когда пишется | При изменении договорных или системных констант после фиксации |
| Зачем пишется | Снимок блока констант и код того, что изменилось |
| Откуда берётся | Текущие настройки и ca_code |
| Для чего читается | Аудит изменений настроек, восстановление контекста отчётов |
| Глубина | 64 |
Коды ca_code и соответствующее содержимое const_change описаны в 02_ARCHIVE_FIELDS.md.
| Что | Значение |
|---|---|
| Когда пишется | Контрольная точка каждые 6 секунд — 10 записей в минуту; фазы перехода входят в точки, не добавляя строк. Глубина 4800 даёт 8 часов номинальной истории |
| Зачем пишется | Журнал системных событий: устойчивые переходы состояния, запуск и потеря питания, изменение конфигурации, сброс и установка времени. Не хранит payload накоплений и не заменяет AE |
| Откуда берётся | mask_prot, mask_dem, T_dem_zad, состояние конфигурации, RTCA |
| Для чего читается | Восстановление устойчивого состояния после запуска и аудит событий |
| Глубина | 4800 |
Защита от дребезга:
BEGIN в очередной записи журнала.END в очередной записи журнала.STEADY.Кратковременные возвраты между BEGIN и END не создают дополнительный поток подтверждённых переходов. Период системного журнала задаётся резервным параметром kratnost_2; он не задаёт период STATE_FULL, который записывается не чаще раза в 360 секунд.
| Что | Значение |
|---|---|
| Когда пишется | Не чаще одного раза за 360 секунд; событийные триггеры не создают дополнительную запись в пределах этого интервала |
| Зачем пишется | Единая точка восстановления полного рабочего состояния, накоплений и незакрытого часа после сброса или потери питания |
| Откуда берётся | Runtime-state, необходимые поля старого nak_data, незакрытое состояние часа и ссылки на поколение конфигурации |
| Для чего читается | Продолжение расчёта и расписания после сбоя по последней записи с валидными CRC и commit |
| Глубина | 100 записей; около 10 часов номинального покрытия при интервале 360 секунд |
Правила:
STATE_FULL объединены payload накоплений и продолжения расчёта, ранее относимые к NAK, и поля полного runtime-снимка; отдельного ACCUMULATION_ARCHIVE нет.BEFORE_RESET или POWER_OFF, если событие ещё можно зафиксировать.STATE_FULL, только если наступил срок не чаще одного раза за 360 секунд.При сбое до подтверждения нового поколения продолжают действовать прежние конфигурация и состояние.
SYSTEM_ARCHIVE хранит календарное RTCA, а не наработку. При установке времени сначала записывается событие со старым временем, затем меняются часы и опорные точки расписания. Пропущенные записи APH/APD задним числом не создаются. После коррекции порядок событий задаётся последовательным номером.
legacy и RS4/Qnc2 различаются заменой отдельных полей при том же размере значимых данных.| Поле | Тип | Байт |
|---|---|---|
seconds |
uint8 |
1 |
minutes |
uint8 |
1 |
hour |
uint16 |
2 |
| Итого | 4 |
Измерено: 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 |
| Поле | Тип | Байт | Смысл |
|---|---|---|---|
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 |
Вместо THC3 используется Qnc2 (младшие два байта), вместо Reserv — третий байт Qnc2. Сумма значимых полей та же — 24 B.
| Вариант | Значимые поля | С padding | Примечание |
|---|---|---|---|
| Legacy | 12 + 24 = 36 | 44 | Календарь выравнивается до 4 B |
| RS4/Qnc2 | 12 + 24 = 36 | 40 | Иная раскладка padding |
Измерено: 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 в целевой модели.
| Поле | Тип | Байт | Смысл |
|---|---|---|---|
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 полезных секторов.
Измерено: 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.
Особая ветка (сложный состав, пользовательская среда с name[20], crc16) в текущем probe не моделировалась. Её размер и необходимость поддержки — открытый вопрос.
Измерено: 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 записывается само значение кода.
Измеренная 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.
Измерено: 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 без необходимости не следует.
| Тип | Размер, B |
|---|---|
nak_data |
512 |
tpg_data |
764 |
justL_data |
16 |
just0_data |
16 |
FlashSP |
3172 |
SystemFlashSP |
320 |
RamSP |
10376 |
globalSP |
4960 |
name[20], crc16) не измерено. Решить, поддерживается ли ветка, и если да — снять полный размер.Fl_a/Fl_b, а также глубину. Legacy-вариант глубиной 24000 интервалов для одного канала занимает около 88 полезных секторов без служебных данных.mask_prot, mask_dem и T_dem_zad.kratnost_2: закрепить номинал для периода 6 секунд и поведение при 0.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 не включается.STATE_FULL: целевая глубина 100 записей даёт около 10 часов номинального покрытия при периоде 360 секунд. Подтвердить достаточность глубины и политику кольцевой записи. Глубина AE определяется отдельно.STATE_FULL: диагностическая запись 536 B при глубине 100 занимает 14 секторов по сырым данным и 15 секторов с учётом заголовка 32 B и запрета разрыва записи. Повторно измерить утверждённый payload вместе с форматом CRC/commit, оценить write amplification и ресурс стирания ZD25Q. Если AE будет принят, рассчитать его регион отдельно.STATE_FULL.STATE_FULL.В проекте есть два разных адресных пространства, которые нельзя складывать напрямую:
FlashSP, служебные структуры и старые области TPG/justL/just0. Их смещения заданы в device_data.h и INI-файлах.| Параметр | Значение |
|---|---|
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 |
Принятые размеры:
| Логический регион | Глубина | Размер записи, 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 после добавления заголовков и служебных данных рассчитан ниже.
Ниже предложен конкретный формат служебных данных и уточнённый расчёт с его учётом.
Пишется один раз при открытии сектора и далее не изменяется. В 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.
Две копии в отдельных секторах. При обновлении стирается и пишется только неактивная копия, затем увеличивается 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. Он с большим запасом помещается в выделенный сектор.
| Архив | Резерв, секторов |
|---|---|
| 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.
Суммируются новые архивы со служебными данными и сохраняемые служебные области, которые используются текущим кодом. Области BEG_Vcode и миниархив в расчёт не включаются: от их использования отказались.
Это не архивы учёта и не journal событий, а накопления служебных режимов:
tpg_data — данные термопрогона: накопленные значения температуры, пути луча, разности времён, периодов, коэффициента усиления и резервного канала по интервалам; нужны для режима термопрогона и сопутствующих метрологических проверок.justL_data — накопления юстировки длины луча: число точек, сумматоры температуры и пути луча; нужны для завершения юстировки длины акустического луча.just0_data — накопления юстировки Δτ: число точек, сумматор разности времён и СКО; нужны для завершения юстировки временной задержки.Эти структуры хранятся по отдельным адресам и записываются во внешнюю 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 |
Для наименьшего варианта границы сдвинутся на пять секторов раньше.
nak_data входят в единый STATE_FULL.STATE_FULL после проверки потребителей.BEG_Vcode и шифрованный объём старой связи устройств не переносятся.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 полезных секторов без служебных данных и резервов. Точный регион зависит от утверждённого формата и глубины.
SYSTEM_ARCHIVE и повторно измерить размер записи после реализации; 20 B — только размер текущей probe-модели.STATE_FULL — один раз за 360 секунд, глубину 100 и допустимость окна потери до одного интервала.Подробный перечень — в 03_OPEN_QUESTIONS.md.