yunsi-toolbox-vue/lib/app-image/ranges.ts

import { readU32 } from '../shared/binary-reader';
import {
  IMAGE_HEADER_SIZE, EXTENDED_HEADER_SIZE, SEGMENT_HEADER_SIZE,
  APP_DESC_MAGIC, APP_DESC_SIZE,
} from './constants';
import {
  SPI_FLASH_MODE_NAMES, SPI_FLASH_SPEED_NAMES, SPI_FLASH_SIZE_NAMES,
} from './types';
import type { AppImageInfo } from './types';

export interface FieldDef {
  label: string;
  start: number;
  end: number;    // exclusive
  value: string;
}

export interface FieldGroup {
  label: string;
  start: number;
  end: number;    // exclusive
  fields: FieldDef[];
}

function h(n: number, pad = 2): string {
  return '0x' + n.toString(16).toUpperCase().padStart(pad, '0');
}

export function computeFieldRanges(data: Uint8Array, info: AppImageInfo): FieldGroup[] {
  const groups: FieldGroup[] = [];

  // ── Image Header (bytes 0–7) ──
  const spiSpeedSize = data[3];
  groups.push({
    label: '镜像头 (Image Header)',
    start: 0,
    end: IMAGE_HEADER_SIZE,
    fields: [
      { label: 'magic',        start: 0, end: 1, value: h(info.header.magic) },
      { label: 'segmentCount', start: 1, end: 2, value: String(info.header.segmentCount) },
      { label: 'spiMode',      start: 2, end: 3, value: SPI_FLASH_MODE_NAMES[info.header.spiMode] ?? h(info.header.spiMode) },
      {
        label: 'spiSpeed / spiSize',
        start: 3,
        end: 4,
        value: `${SPI_FLASH_SPEED_NAMES[info.header.spiSpeed] ?? h(spiSpeedSize & 0x0F)} / ${SPI_FLASH_SIZE_NAMES[info.header.spiSize] ?? h((spiSpeedSize >> 4) & 0x0F)}`,
      },
      { label: 'entryPoint', start: 4, end: 8, value: h(info.header.entryPoint, 8) },
    ],
  });

  // ── Extended Header (bytes 8–23) ──
  const extOff = IMAGE_HEADER_SIZE;
  groups.push({
    label: '扩展头 (Extended Header)',
    start: extOff,
    end: extOff + EXTENDED_HEADER_SIZE,
    fields: [
      { label: 'wpPin',         start: extOff,      end: extOff + 1,  value: h(info.extendedHeader.wpPin) },
      { label: 'spiPinDrv[0]', start: extOff + 1,  end: extOff + 2,  value: h(info.extendedHeader.spiPinDrv[0]) },
      { label: 'spiPinDrv[1]', start: extOff + 2,  end: extOff + 3,  value: h(info.extendedHeader.spiPinDrv[1]) },
      { label: 'spiPinDrv[2]', start: extOff + 3,  end: extOff + 4,  value: h(info.extendedHeader.spiPinDrv[2]) },
      { label: 'chipId',        start: extOff + 4,  end: extOff + 6,  value: `${h(info.extendedHeader.chipId, 4)} (${info.chipName})` },
      { label: 'minChipRev',    start: extOff + 6,  end: extOff + 7,  value: h(info.extendedHeader.minChipRev) },
      { label: 'minChipRevFull',start: extOff + 7,  end: extOff + 9,  value: String(info.extendedHeader.minChipRevFull / 100) },
      { label: 'maxChipRevFull',start: extOff + 9,  end: extOff + 11, value: info.extendedHeader.maxChipRevFull === 0xFFFF ? '不限' : String(info.extendedHeader.maxChipRevFull / 100) },
      { label: 'reserved',      start: extOff + 11, end: extOff + 15, value: '(reserved)' },
      { label: 'hashAppended',  start: extOff + 15, end: extOff + 16, value: info.extendedHeader.hashAppended ? '是' : '否' },
    ],
  });

  // ── Segments ──
  let segOff = IMAGE_HEADER_SIZE + EXTENDED_HEADER_SIZE;
  for (let i = 0; i < info.segments.length; i++) {
    const seg = info.segments[i];
    const hdrEnd = segOff + SEGMENT_HEADER_SIZE;
    const dataEnd = hdrEnd + seg.dataLen;

    groups.push({
      label: `段 ${i} 头 (Segment ${i} Header)`,
      start: segOff,
      end: hdrEnd,
      fields: [
        { label: 'loadAddr', start: segOff,     end: segOff + 4, value: h(seg.loadAddr, 8) },
        { label: 'dataLen',  start: segOff + 4, end: hdrEnd,     value: `${seg.dataLen} 字节` },
      ],
    });

    groups.push({
      label: `段 ${i} 数据 (Segment ${i} Data)`,
      start: hdrEnd,
      end: dataEnd,
      fields: [],
    });

    segOff = dataEnd;
  }

  // ── App Description — walk segments to find the offset ──
  if (info.appDescription) {
    let appDescOff: number | null = null;
    let scanOff = IMAGE_HEADER_SIZE + EXTENDED_HEADER_SIZE;
    for (const seg of info.segments) {
      const dataOff = scanOff + SEGMENT_HEADER_SIZE;
      if (dataOff + 4 <= data.length && readU32(data, dataOff) === APP_DESC_MAGIC) {
        appDescOff = dataOff;
        break;
      }
      scanOff = dataOff + seg.dataLen;
    }

    if (appDescOff !== null) {
      const o = appDescOff;
      const d = info.appDescription;
      groups.push({
        label: '应用信息 (App Description)',
        start: o,
        end: o + APP_DESC_SIZE,
        fields: [
          { label: 'magicWord',     start: o,       end: o + 4,   value: h(d.magicWord, 8) },
          { label: 'secureVersion', start: o + 4,   end: o + 8,   value: String(d.secureVersion) },
          { label: 'version',       start: o + 16,  end: o + 48,  value: d.version },
          { label: 'projectName',   start: o + 48,  end: o + 80,  value: d.projectName },
          { label: 'compileTime',   start: o + 80,  end: o + 96,  value: d.compileTime },
          { label: 'compileDate',   start: o + 96,  end: o + 112, value: d.compileDate },
          { label: 'idfVersion',    start: o + 112, end: o + 144, value: d.idfVersion },
          { label: 'appElfSha256',  start: o + 144, end: o + 176, value: Array.from(d.appElfSha256).map(b => b.toString(16).padStart(2, '0')).join('') },
        ],
      });
    }
  }

  // ── Appended SHA256 ──
  if (info.extendedHeader.hashAppended && data.length >= 32) {
    groups.push({
      label: '附加 SHA256 (Appended Hash)',
      start: data.length - 32,
      end: data.length,
      fields: [
        {
          label: 'sha256',
          start: data.length - 32,
          end: data.length,
          value: Array.from(data.slice(-32)).map(b => b.toString(16).padStart(2, '0')).join(''),
        },
      ],
    });
  }

  return groups;
}