feat(app-image): add ESP firmware image parser and viewer with robust
upload handling - add app image parser/types/constants for ESP image header, extended header, segments, and app description - add shared binary read/write utilities and CRC32 helper - add AppImageViewer component to inspect firmware metadata in UI - improve upload UX: accept .bin only and show explicit error for ELF input - prevent status alert timer race by clearing previous timeout before setting a new one - ignore .claude in .gitignore
This commit is contained in:
parent
0f107073bd
commit
8320bf7ab2
GPG Key ID:
5432C10DDCF8DAD5
|
|
@ -0,0 +1,2 @@
|
|||
# AI
|
||||
/.claude
|
||||
|
|
@ -0,0 +1,144 @@
|
|||
<script setup lang="ts">
|
||||
import { ref, watch } from 'vue';
|
||||
import {
|
||||
type AppImageInfo,
|
||||
SPI_FLASH_MODE_NAMES, SPI_FLASH_SPEED_NAMES, SPI_FLASH_SIZE_NAMES,
|
||||
parseAppImage,
|
||||
} from '../../lib/app-image';
|
||||
|
||||
const props = defineProps<{
|
||||
isDark?: boolean;
|
||||
}>();
|
||||
|
||||
const imageInfo = ref<AppImageInfo | null>(null);
|
||||
const statusMessage = ref('');
|
||||
const statusType = ref<'success' | 'error' | 'info'>('info');
|
||||
const fileName = ref('');
|
||||
|
||||
let statusTimer: ReturnType<typeof setTimeout> | null = null;
|
||||
|
||||
function showStatus(msg: string, type: 'success' | 'error' | 'info' = 'info') {
|
||||
if (statusTimer !== null) {
|
||||
clearTimeout(statusTimer);
|
||||
statusTimer = null;
|
||||
}
|
||||
statusMessage.value = msg;
|
||||
statusType.value = type;
|
||||
statusTimer = setTimeout(() => {
|
||||
statusMessage.value = '';
|
||||
statusTimer = null;
|
||||
}, 4000);
|
||||
}
|
||||
|
||||
function formatHex(val: number): string {
|
||||
return '0x' + val.toString(16).toUpperCase();
|
||||
}
|
||||
|
||||
function formatSha256(data: Uint8Array): string {
|
||||
// Check if all zeros (not computed)
|
||||
if (data.every(b => b === 0)) return '(未计算)';
|
||||
return Array.from(data).map(b => b.toString(16).padStart(2, '0')).join('');
|
||||
}
|
||||
|
||||
async function handleOpenFile(file: File): Promise<false> {
|
||||
try {
|
||||
const buffer = await file.arrayBuffer();
|
||||
const data = new Uint8Array(buffer);
|
||||
if (data.length >= 4 &&
|
||||
data[0] === 0x7F && data[1] === 0x45 && data[2] === 0x4C && data[3] === 0x46) {
|
||||
throw new Error('ELF 格式不支持。请使用 esptool.py elf2image 将其转换为 .bin 文件');
|
||||
}
|
||||
imageInfo.value = parseAppImage(data);
|
||||
fileName.value = file.name;
|
||||
showStatus(`已加载 ${file.name} (${data.byteLength} 字节)`, 'success');
|
||||
} catch (e: any) {
|
||||
imageInfo.value = null;
|
||||
showStatus(`加载失败: ${e.message}`, 'error');
|
||||
}
|
||||
return false;
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div>
|
||||
<!-- Status message -->
|
||||
<transition name="el-fade-in">
|
||||
<el-alert
|
||||
v-if="statusMessage"
|
||||
:title="statusMessage"
|
||||
:type="statusType"
|
||||
show-icon
|
||||
closable
|
||||
class="mb-3"
|
||||
@close="statusMessage = ''"
|
||||
/>
|
||||
</transition>
|
||||
|
||||
<!-- Upload -->
|
||||
<div class="mb-4">
|
||||
<el-upload :before-upload="handleOpenFile" :show-file-list="false" accept=".bin">
|
||||
<el-button type="primary">打开固件文件</el-button>
|
||||
</el-upload>
|
||||
</div>
|
||||
|
||||
<template v-if="imageInfo">
|
||||
<!-- App Description -->
|
||||
<template v-if="imageInfo.appDescription">
|
||||
<el-text tag="b" class="block mb-2">应用信息</el-text>
|
||||
<el-descriptions :column="2" border size="small" class="mb-4">
|
||||
<el-descriptions-item label="项目名称">{{ imageInfo.appDescription.projectName }}</el-descriptions-item>
|
||||
<el-descriptions-item label="版本">{{ imageInfo.appDescription.version }}</el-descriptions-item>
|
||||
<el-descriptions-item label="IDF版本">{{ imageInfo.appDescription.idfVersion }}</el-descriptions-item>
|
||||
<el-descriptions-item label="安全版本">{{ imageInfo.appDescription.secureVersion }}</el-descriptions-item>
|
||||
<el-descriptions-item label="编译日期">{{ imageInfo.appDescription.compileDate }}</el-descriptions-item>
|
||||
<el-descriptions-item label="编译时间">{{ imageInfo.appDescription.compileTime }}</el-descriptions-item>
|
||||
<el-descriptions-item label="ELF SHA256" :span="2">
|
||||
<el-text size="small" class="font-mono break-all">
|
||||
{{ formatSha256(imageInfo.appDescription.appElfSha256) }}
|
||||
</el-text>
|
||||
</el-descriptions-item>
|
||||
</el-descriptions>
|
||||
</template>
|
||||
|
||||
<!-- Image Header -->
|
||||
<el-text tag="b" class="block mb-2">镜像头</el-text>
|
||||
<el-descriptions :column="2" border size="small" class="mb-4">
|
||||
<el-descriptions-item label="芯片">{{ imageInfo.chipName }}</el-descriptions-item>
|
||||
<el-descriptions-item label="入口地址">{{ formatHex(imageInfo.header.entryPoint) }}</el-descriptions-item>
|
||||
<el-descriptions-item label="SPI模式">{{ SPI_FLASH_MODE_NAMES[imageInfo.header.spiMode] ?? formatHex(imageInfo.header.spiMode) }}</el-descriptions-item>
|
||||
<el-descriptions-item label="SPI速度">{{ SPI_FLASH_SPEED_NAMES[imageInfo.header.spiSpeed] ?? formatHex(imageInfo.header.spiSpeed) }}</el-descriptions-item>
|
||||
<el-descriptions-item label="Flash大小">{{ SPI_FLASH_SIZE_NAMES[imageInfo.header.spiSize] ?? formatHex(imageInfo.header.spiSize) }}</el-descriptions-item>
|
||||
<el-descriptions-item label="段数">{{ imageInfo.header.segmentCount }}</el-descriptions-item>
|
||||
<el-descriptions-item label="WP引脚">{{ formatHex(imageInfo.extendedHeader.wpPin) }}</el-descriptions-item>
|
||||
<el-descriptions-item label="最小芯片版本">{{ imageInfo.extendedHeader.minChipRevFull / 100 }}</el-descriptions-item>
|
||||
<el-descriptions-item label="最大芯片版本">{{ imageInfo.extendedHeader.maxChipRevFull === 0xFFFF ? '不限' : imageInfo.extendedHeader.maxChipRevFull / 100 }}</el-descriptions-item>
|
||||
<el-descriptions-item label="附加哈希">{{ imageInfo.extendedHeader.hashAppended ? '是' : '否' }}</el-descriptions-item>
|
||||
</el-descriptions>
|
||||
|
||||
<!-- Segments -->
|
||||
<el-text tag="b" class="block mb-2">段列表</el-text>
|
||||
<el-table :data="imageInfo.segments" border stripe size="small" max-height="300">
|
||||
<el-table-column label="#" width="50" type="index" />
|
||||
<el-table-column label="加载地址" width="160">
|
||||
<template #default="{ row }">{{ formatHex(row.loadAddr) }}</template>
|
||||
</el-table-column>
|
||||
<el-table-column label="数据大小">
|
||||
<template #default="{ row }">
|
||||
{{ row.dataLen }} 字节 ({{ (row.dataLen / 1024).toFixed(1) }} KB)
|
||||
</template>
|
||||
</el-table-column>
|
||||
</el-table>
|
||||
</template>
|
||||
|
||||
<el-empty v-else description="请打开一个ESP32固件文件 (.bin)" />
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.font-mono {
|
||||
font-family: 'Courier New', Courier, monospace;
|
||||
}
|
||||
.break-all {
|
||||
word-break: break-all;
|
||||
}
|
||||
</style>
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
/** Magic byte at start of image header */
|
||||
export const IMAGE_MAGIC = 0xE9;
|
||||
|
||||
/** Image header size in bytes (magic, segment_count, spi_mode, spi_speed_size, entry_point, padding) */
|
||||
export const IMAGE_HEADER_SIZE = 8;
|
||||
|
||||
/** Extended header size in bytes */
|
||||
export const EXTENDED_HEADER_SIZE = 16;
|
||||
|
||||
/** Segment header size in bytes */
|
||||
export const SEGMENT_HEADER_SIZE = 8;
|
||||
|
||||
/** Magic word for esp_app_desc_t */
|
||||
export const APP_DESC_MAGIC = 0xABCD5432;
|
||||
|
||||
/** Size of esp_app_desc_t structure */
|
||||
export const APP_DESC_SIZE = 256;
|
||||
|
||||
/** Chip ID to human-readable name */
|
||||
export const CHIP_ID_NAMES: Record<number, string> = {
|
||||
0x0000: 'ESP32',
|
||||
0x0002: 'ESP32-S2',
|
||||
0x0005: 'ESP32-C3',
|
||||
0x0009: 'ESP32-S3',
|
||||
0x000C: 'ESP32-C2',
|
||||
0x000D: 'ESP32-C6',
|
||||
0x0010: 'ESP32-H2',
|
||||
0x0012: 'ESP32-P4',
|
||||
0x0011: 'ESP32-C61',
|
||||
0x0014: 'ESP32-C5',
|
||||
0x0016: 'ESP32-H4',
|
||||
};
|
||||
|
|
@ -0,0 +1,20 @@
|
|||
// Types
|
||||
export type {
|
||||
ImageHeader, ExtendedHeader, SegmentHeader,
|
||||
AppDescription, AppImageInfo,
|
||||
} from './types';
|
||||
|
||||
export {
|
||||
SpiFlashMode, SpiFlashSpeed, SpiFlashSize,
|
||||
SPI_FLASH_MODE_NAMES, SPI_FLASH_SPEED_NAMES, SPI_FLASH_SIZE_NAMES,
|
||||
} from './types';
|
||||
|
||||
// Constants
|
||||
export {
|
||||
IMAGE_MAGIC, IMAGE_HEADER_SIZE, EXTENDED_HEADER_SIZE,
|
||||
SEGMENT_HEADER_SIZE, APP_DESC_MAGIC, APP_DESC_SIZE,
|
||||
CHIP_ID_NAMES,
|
||||
} from './constants';
|
||||
|
||||
// Parser
|
||||
export { parseAppImage } from './parser';
|
||||
|
|
@ -0,0 +1,104 @@
|
|||
import { readU8, readU16, readU32, readNullTermString } from '../shared/binary-reader';
|
||||
import {
|
||||
AppImageInfo, ImageHeader, ExtendedHeader, SegmentHeader, AppDescription,
|
||||
} from './types';
|
||||
import {
|
||||
IMAGE_MAGIC, IMAGE_HEADER_SIZE, EXTENDED_HEADER_SIZE,
|
||||
SEGMENT_HEADER_SIZE, APP_DESC_MAGIC, APP_DESC_SIZE, CHIP_ID_NAMES,
|
||||
} from './constants';
|
||||
|
||||
/**
|
||||
* Parse an ESP32 app image binary.
|
||||
* Read-only parser — extracts headers, segment info, and app description.
|
||||
*
|
||||
* @param data Raw binary data of the app image
|
||||
*/
|
||||
export function parseAppImage(data: Uint8Array): AppImageInfo {
|
||||
if (data.length < IMAGE_HEADER_SIZE + EXTENDED_HEADER_SIZE) {
|
||||
throw new Error(`数据太短: ${data.length} 字节 (最少需要 ${IMAGE_HEADER_SIZE + EXTENDED_HEADER_SIZE} 字节)`);
|
||||
}
|
||||
|
||||
// ── Image Header (8 bytes: magic + segments + spi_mode + spi_speed_size + entry_addr) ──
|
||||
const magic = readU8(data, 0);
|
||||
if (magic !== IMAGE_MAGIC) {
|
||||
throw new Error(`无效的魔数: 0x${magic.toString(16)} (应为 0xE9)`);
|
||||
}
|
||||
|
||||
const segmentCount = readU8(data, 1);
|
||||
const spiModeRaw = readU8(data, 2);
|
||||
const spiSpeedSize = readU8(data, 3);
|
||||
const entryPoint = readU32(data, 4);
|
||||
|
||||
const header: ImageHeader = {
|
||||
magic,
|
||||
segmentCount,
|
||||
spiMode: spiModeRaw,
|
||||
spiSpeed: spiSpeedSize & 0x0F,
|
||||
spiSize: (spiSpeedSize >> 4) & 0x0F,
|
||||
entryPoint,
|
||||
};
|
||||
|
||||
// ── Extended Header (16 bytes at offset 8) ──
|
||||
const extOff = IMAGE_HEADER_SIZE;
|
||||
const wpPin = readU8(data, extOff); // +0 = offset 8
|
||||
const chipId = readU16(data, extOff + 4); // +4 = offset 12
|
||||
const minChipRev = readU8(data, extOff + 6); // +6 = offset 14
|
||||
const minChipRevFull = readU16(data, extOff + 7); // +7 = offset 15 (packed)
|
||||
const maxChipRevFull = readU16(data, extOff + 9); // +9 = offset 17 (packed)
|
||||
const hashAppended = readU8(data, extOff + 15) === 1; // +15 = offset 23
|
||||
|
||||
const extendedHeader: ExtendedHeader = {
|
||||
wpPin,
|
||||
spiPinDrv: [readU8(data, extOff + 1), readU8(data, extOff + 2), readU8(data, extOff + 3)],
|
||||
chipId,
|
||||
minChipRev,
|
||||
minChipRevFull,
|
||||
maxChipRevFull,
|
||||
hashAppended,
|
||||
};
|
||||
|
||||
// ── Segment Headers ──
|
||||
const segments: SegmentHeader[] = [];
|
||||
// Track each segment's data start offset internally (not exposed in public API)
|
||||
const segDataOffsets: number[] = [];
|
||||
let segOff = IMAGE_HEADER_SIZE + EXTENDED_HEADER_SIZE;
|
||||
|
||||
for (let i = 0; i < segmentCount && segOff + SEGMENT_HEADER_SIZE <= data.length; i++) {
|
||||
const loadAddr = readU32(data, segOff);
|
||||
const dataLen = readU32(data, segOff + 4);
|
||||
const dataOffset = segOff + SEGMENT_HEADER_SIZE;
|
||||
if (dataOffset + dataLen > data.length) break; // truncated image
|
||||
segments.push({ loadAddr, dataLen });
|
||||
segDataOffsets.push(dataOffset);
|
||||
segOff = dataOffset + dataLen; // advance past segment data
|
||||
}
|
||||
|
||||
// ── App Description — scan all segments for APP_DESC_MAGIC ──
|
||||
let appDescription: AppDescription | null = null;
|
||||
for (const off of segDataOffsets) {
|
||||
if (off + 4 > data.length) continue;
|
||||
const descMagic = readU32(data, off);
|
||||
if (descMagic === APP_DESC_MAGIC && off + APP_DESC_SIZE <= data.length) {
|
||||
appDescription = {
|
||||
magicWord: descMagic,
|
||||
secureVersion: readU32(data, off + 4),
|
||||
version: readNullTermString(data, off + 16, 32),
|
||||
projectName: readNullTermString(data, off + 48, 32),
|
||||
compileTime: readNullTermString(data, off + 80, 16),
|
||||
compileDate: readNullTermString(data, off + 96, 16),
|
||||
idfVersion: readNullTermString(data, off + 112, 32),
|
||||
appElfSha256: new Uint8Array(data.subarray(off + 144, off + 176)),
|
||||
};
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return {
|
||||
header,
|
||||
extendedHeader,
|
||||
segments,
|
||||
appDescription,
|
||||
valid: segments.length === segmentCount, // false if image was truncated mid-segment
|
||||
chipName: CHIP_ID_NAMES[chipId] ?? `Unknown (0x${chipId.toString(16)})`,
|
||||
};
|
||||
}
|
||||
|
|
@ -0,0 +1,93 @@
|
|||
export enum SpiFlashMode {
|
||||
QIO = 0,
|
||||
QOUT = 1,
|
||||
DIO = 2,
|
||||
DOUT = 3,
|
||||
}
|
||||
|
||||
export enum SpiFlashSpeed {
|
||||
SPEED_40M = 0x0,
|
||||
SPEED_26M = 0x1,
|
||||
SPEED_20M = 0x2,
|
||||
SPEED_80M = 0xF,
|
||||
}
|
||||
|
||||
export enum SpiFlashSize {
|
||||
SIZE_1MB = 0x0,
|
||||
SIZE_2MB = 0x1,
|
||||
SIZE_4MB = 0x2,
|
||||
SIZE_8MB = 0x3,
|
||||
SIZE_16MB = 0x4,
|
||||
SIZE_32MB = 0x5,
|
||||
SIZE_64MB = 0x6,
|
||||
SIZE_128MB = 0x7,
|
||||
}
|
||||
|
||||
export interface ImageHeader {
|
||||
magic: number;
|
||||
segmentCount: number;
|
||||
spiMode: SpiFlashMode;
|
||||
spiSpeed: SpiFlashSpeed;
|
||||
spiSize: SpiFlashSize;
|
||||
entryPoint: number;
|
||||
}
|
||||
|
||||
export interface ExtendedHeader {
|
||||
wpPin: number;
|
||||
spiPinDrv: [number, number, number];
|
||||
chipId: number;
|
||||
minChipRev: number;
|
||||
minChipRevFull: number;
|
||||
maxChipRevFull: number;
|
||||
hashAppended: boolean;
|
||||
}
|
||||
|
||||
export interface SegmentHeader {
|
||||
loadAddr: number;
|
||||
dataLen: number;
|
||||
}
|
||||
|
||||
export interface AppDescription {
|
||||
magicWord: number;
|
||||
secureVersion: number;
|
||||
version: string;
|
||||
projectName: string;
|
||||
compileTime: string;
|
||||
compileDate: string;
|
||||
idfVersion: string;
|
||||
appElfSha256: Uint8Array;
|
||||
}
|
||||
|
||||
export interface AppImageInfo {
|
||||
header: ImageHeader;
|
||||
extendedHeader: ExtendedHeader;
|
||||
segments: SegmentHeader[];
|
||||
appDescription: AppDescription | null;
|
||||
valid: boolean;
|
||||
chipName: string;
|
||||
}
|
||||
|
||||
export const SPI_FLASH_MODE_NAMES: Record<number, string> = {
|
||||
[SpiFlashMode.QIO]: 'QIO',
|
||||
[SpiFlashMode.QOUT]: 'QOUT',
|
||||
[SpiFlashMode.DIO]: 'DIO',
|
||||
[SpiFlashMode.DOUT]: 'DOUT',
|
||||
};
|
||||
|
||||
export const SPI_FLASH_SPEED_NAMES: Record<number, string> = {
|
||||
[SpiFlashSpeed.SPEED_40M]: '40MHz',
|
||||
[SpiFlashSpeed.SPEED_26M]: '26MHz',
|
||||
[SpiFlashSpeed.SPEED_20M]: '20MHz',
|
||||
[SpiFlashSpeed.SPEED_80M]: '80MHz',
|
||||
};
|
||||
|
||||
export const SPI_FLASH_SIZE_NAMES: Record<number, string> = {
|
||||
[SpiFlashSize.SIZE_1MB]: '1MB',
|
||||
[SpiFlashSize.SIZE_2MB]: '2MB',
|
||||
[SpiFlashSize.SIZE_4MB]: '4MB',
|
||||
[SpiFlashSize.SIZE_8MB]: '8MB',
|
||||
[SpiFlashSize.SIZE_16MB]: '16MB',
|
||||
[SpiFlashSize.SIZE_32MB]: '32MB',
|
||||
[SpiFlashSize.SIZE_64MB]: '64MB',
|
||||
[SpiFlashSize.SIZE_128MB]: '128MB',
|
||||
};
|
||||
|
|
@ -0,0 +1,46 @@
|
|||
// ── Little-endian read helpers ─────────────────────────────────────
|
||||
|
||||
export function readU8(buf: Uint8Array, off: number): number {
|
||||
return buf[off];
|
||||
}
|
||||
|
||||
export function readU16(buf: Uint8Array, off: number): number {
|
||||
return buf[off] | (buf[off + 1] << 8);
|
||||
}
|
||||
|
||||
export function readU32(buf: Uint8Array, off: number): number {
|
||||
return (buf[off] | (buf[off + 1] << 8) | (buf[off + 2] << 16) | (buf[off + 3] << 24)) >>> 0;
|
||||
}
|
||||
|
||||
export function readI8(buf: Uint8Array, off: number): number {
|
||||
const v = buf[off];
|
||||
return v > 127 ? v - 256 : v;
|
||||
}
|
||||
|
||||
export function readI16(buf: Uint8Array, off: number): number {
|
||||
const v = readU16(buf, off);
|
||||
return v > 32767 ? v - 65536 : v;
|
||||
}
|
||||
|
||||
export function readI32(buf: Uint8Array, off: number): number {
|
||||
return buf[off] | (buf[off + 1] << 8) | (buf[off + 2] << 16) | (buf[off + 3] << 24);
|
||||
}
|
||||
|
||||
export function readU64(buf: Uint8Array, off: number): bigint {
|
||||
const lo = BigInt(readU32(buf, off));
|
||||
const hi = BigInt(readU32(buf, off + 4));
|
||||
return (hi << 32n) | lo;
|
||||
}
|
||||
|
||||
export function readI64(buf: Uint8Array, off: number): bigint {
|
||||
const v = readU64(buf, off);
|
||||
return v > 0x7FFFFFFFFFFFFFFFn ? v - 0x10000000000000000n : v;
|
||||
}
|
||||
|
||||
/** Read null-terminated ASCII string of max `maxLen` bytes */
|
||||
export function readNullTermString(buf: Uint8Array, off: number, maxLen: number): string {
|
||||
let end = off;
|
||||
while (end < off + maxLen && buf[end] !== 0) end++;
|
||||
const decoder = new TextDecoder('ascii');
|
||||
return decoder.decode(buf.subarray(off, end));
|
||||
}
|
||||
|
|
@ -0,0 +1,50 @@
|
|||
// ── Little-endian write helpers ────────────────────────────────────
|
||||
|
||||
export function writeU8(buf: Uint8Array, off: number, val: number) {
|
||||
buf[off] = val & 0xFF;
|
||||
}
|
||||
|
||||
export function writeU16(buf: Uint8Array, off: number, val: number) {
|
||||
buf[off] = val & 0xFF;
|
||||
buf[off + 1] = (val >> 8) & 0xFF;
|
||||
}
|
||||
|
||||
export function writeU32(buf: Uint8Array, off: number, val: number) {
|
||||
buf[off] = val & 0xFF;
|
||||
buf[off + 1] = (val >> 8) & 0xFF;
|
||||
buf[off + 2] = (val >> 16) & 0xFF;
|
||||
buf[off + 3] = (val >> 24) & 0xFF;
|
||||
}
|
||||
|
||||
export function writeI8(buf: Uint8Array, off: number, val: number) {
|
||||
buf[off] = val < 0 ? val + 256 : val;
|
||||
}
|
||||
|
||||
export function writeI16(buf: Uint8Array, off: number, val: number) {
|
||||
const u = val < 0 ? val + 65536 : val;
|
||||
writeU16(buf, off, u);
|
||||
}
|
||||
|
||||
export function writeI32(buf: Uint8Array, off: number, val: number) {
|
||||
writeU32(buf, off, val < 0 ? val + 0x100000000 : val);
|
||||
}
|
||||
|
||||
export function writeU64(buf: Uint8Array, off: number, val: bigint) {
|
||||
const lo = Number(val & 0xFFFFFFFFn);
|
||||
const hi = Number((val >> 32n) & 0xFFFFFFFFn);
|
||||
writeU32(buf, off, lo);
|
||||
writeU32(buf, off + 4, hi);
|
||||
}
|
||||
|
||||
export function writeI64(buf: Uint8Array, off: number, val: bigint) {
|
||||
const u = val < 0n ? val + 0x10000000000000000n : val;
|
||||
writeU64(buf, off, u);
|
||||
}
|
||||
|
||||
/** Write null-terminated ASCII string padded to `fieldSize` bytes */
|
||||
export function writeNullTermString(buf: Uint8Array, off: number, str: string, fieldSize: number) {
|
||||
buf.fill(0, off, off + fieldSize);
|
||||
const encoder = new TextEncoder();
|
||||
const strBytes = encoder.encode(str);
|
||||
buf.set(strBytes.subarray(0, fieldSize - 1), off); // leave room for null
|
||||
}
|
||||
|
|
@ -0,0 +1,24 @@
|
|||
/**
|
||||
* Pre-computed CRC32 lookup table using reflected polynomial 0xEDB88320.
|
||||
* Compatible with zlib.crc32() used by ESP-IDF.
|
||||
*/
|
||||
const CRC32_TABLE: Uint32Array = (() => {
|
||||
const table = new Uint32Array(256);
|
||||
for (let i = 0; i < 256; i++) {
|
||||
let crc = i;
|
||||
for (let j = 0; j < 8; j++) {
|
||||
crc = (crc & 1) ? ((crc >>> 1) ^ 0xEDB88320) : (crc >>> 1);
|
||||
}
|
||||
table[i] = crc;
|
||||
}
|
||||
return table;
|
||||
})();
|
||||
|
||||
/** Compute CRC32 of a Uint8Array. Returns unsigned 32-bit integer. */
|
||||
export function crc32(data: Uint8Array): number {
|
||||
let crc = 0xFFFFFFFF;
|
||||
for (let i = 0; i < data.length; i++) {
|
||||
crc = (crc >>> 8) ^ CRC32_TABLE[(crc ^ data[i]) & 0xFF];
|
||||
}
|
||||
return (crc ^ 0xFFFFFFFF) >>> 0;
|
||||
}
|
||||
|
|
@ -0,0 +1,3 @@
|
|||
export * from './binary-reader';
|
||||
export * from './binary-writer';
|
||||
export { crc32 } from './crc32';
|
||||
Loading…
Reference in New Issue