96 lines
3.0 KiB
Python
96 lines
3.0 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""
|
||
log_decode.py — 将 K1 LOG.BIN（W25Q 日志分区镜像）解码为可读时间线
|
||
|
||
布局:
|
||
[0x0000 .. 0x0FFF] header (magic K1LG ...)
|
||
[0x1000 .. end] 文本环形区，行以 \\n 结束
|
||
|
||
用法:
|
||
python log_decode.py LOG.BIN -o problem.log
|
||
python log_decode.py LOG.BIN --write-off 1234 --wrap 1 -o problem.log
|
||
"""
|
||
from __future__ import annotations
|
||
|
||
import argparse
|
||
import struct
|
||
|
||
MAGIC = 0x4B314C47 # 'K1LG'
|
||
HDR_SIZE = 0x1000
|
||
|
||
|
||
def unpack_header(blob: bytes) -> dict:
|
||
if len(blob) < 36:
|
||
return {"valid": False}
|
||
magic = struct.unpack_from("<I", blob, 0)[0]
|
||
ver = struct.unpack_from("<H", blob, 4)[0]
|
||
boot = struct.unpack_from("<I", blob, 8)[0]
|
||
write_off = struct.unpack_from("<I", blob, 12)[0]
|
||
wrap = struct.unpack_from("<I", blob, 16)[0]
|
||
lines = struct.unpack_from("<I", blob, 20)[0]
|
||
overflow = struct.unpack_from("<I", blob, 24)[0]
|
||
seq = struct.unpack_from("<I", blob, 28)[0]
|
||
return {
|
||
"valid": magic == MAGIC,
|
||
"magic": magic,
|
||
"ver": ver,
|
||
"boot_count": boot,
|
||
"write_off": write_off,
|
||
"wrap_count": wrap,
|
||
"line_count": lines,
|
||
"overflow": overflow,
|
||
"seq": seq,
|
||
}
|
||
|
||
|
||
def extract_text(data: bytes, write_off: int, wrapped: bool) -> str:
|
||
"""Linearize ring: if wrapped, [write_off..end) + [0..write_off); else [0..write_off)."""
|
||
if not data:
|
||
return ""
|
||
if write_off > len(data):
|
||
write_off = len(data)
|
||
if wrapped and write_off < len(data):
|
||
raw = data[write_off:] + data[:write_off]
|
||
else:
|
||
raw = data[:write_off] if write_off else data
|
||
text = raw.decode("utf-8", errors="replace")
|
||
text = text.replace("\xff", "")
|
||
return text
|
||
|
||
|
||
def decode_file(bin_path: str, out_path: str, write_off=None, wrap_count=None) -> None:
|
||
with open(bin_path, "rb") as f:
|
||
blob = f.read()
|
||
hdr = unpack_header(blob)
|
||
data = blob[HDR_SIZE:] if len(blob) > HDR_SIZE else b""
|
||
|
||
wo = write_off if write_off is not None else hdr.get("write_off", 0)
|
||
wrap = wrap_count if wrap_count is not None else hdr.get("wrap_count", 0)
|
||
|
||
text = extract_text(data, wo, wrap > 0)
|
||
lines = [ln for ln in text.splitlines() if ln.strip()]
|
||
|
||
with open(out_path, "w", encoding="utf-8", newline="\n") as f:
|
||
f.write(
|
||
f"# K1 log decode magic_ok={hdr.get('valid')} ver={hdr.get('ver')} "
|
||
f"boot={hdr.get('boot_count')} write_off={wo} wrap={wrap} "
|
||
f"line_count={hdr.get('line_count')} decoded_lines={len(lines)}\n"
|
||
)
|
||
for ln in lines:
|
||
f.write(ln.rstrip("\r") + "\n")
|
||
print(f"decoded {len(lines)} lines -> {out_path}")
|
||
|
||
|
||
def main():
|
||
ap = argparse.ArgumentParser()
|
||
ap.add_argument("bin")
|
||
ap.add_argument("-o", "--out", default="problem.log")
|
||
ap.add_argument("--write-off", type=int, default=None)
|
||
ap.add_argument("--wrap", type=int, default=None)
|
||
args = ap.parse_args()
|
||
decode_file(args.bin, args.out, args.write_off, args.wrap)
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|