拆包流程概覽#

1
#!/bin/bash
2

3
FILE="$1"
4
TARGET_DIR="extracted_devmaps"
5

6
if [ -z "$FILE" ]; then
7
    echo "用法: $0 <firmware.bin>"
8
    exit 1
9
fi
10

11
# 檢查工具
12
for cmd in binwalk unsquashfs dd grep awk; do
13
    if ! command -v $cmd &> /dev/null; then
14
        echo "錯誤: 缺少必要工具 $cmd"
15
        exit 1
16
    fi
17
done
18

19
echo "[*] 正在掃描 $FILE (僅讀取表頭，不解壓)..."
20

21
# 讀取 binwalk 輸出
22
binwalk "$FILE" | grep "Squashfs filesystem" | while read -r line; do
23

24
    # 1. 抓取 Offset (十進位)
25
    OFFSET=$(echo "$line" | awk '{print $1}')
26

27
    # 2. 抓取 Size (使用嚴格 Regex 避開 blocksize)
28
    SIZE=$(echo "$line" | grep -oP '\bsize: \K[0-9]+' | head -n 1)
29

30
    if [ -z "$OFFSET" ] || [ -z "$SIZE" ]; then
31
        continue
32
    fi
33

34
    echo "---------------------------------------------------"
35
    echo "[+] 發現 SquashFS -> Offset: $OFFSET, Size: $SIZE"
36

37
    IMG_NAME="rootfs_${OFFSET}.sqfs"
38

39
    # 3. 使用 dd 切割檔案 (高效能模式)
40
    # bs=1M: 每次讀寫 1MB，大幅降低 I/O overhead
41
    # iflag=skip_bytes,count_bytes: 告訴 dd 雖然 bs=1M，但 skip/count 的單位是 bytes
42
    echo "[*] 正在切割檔案 (高效能 dd)..."
43

44
    dd if="$FILE" bs=1M skip="$OFFSET" count="$SIZE" iflag=skip_bytes,count_bytes of="$IMG_NAME" status=none
45

46
    if [ $? -ne 0 ]; then
47
        echo "[-] dd 切割失敗，請檢查 dd 版本是否支援 iflag (GNU dd)"
48
        rm -f "$IMG_NAME"
49
        continue
50
    fi
51

52
    # 4. 解壓 SquashFS
53
    echo "[*] 正在解壓 SquashFS..."
54
    TEMP_EXTRACT_DIR="sqfs_out_${OFFSET}"
55

56
    # 加上 -no-xattrs 避免 WSL 下的權限屬性報錯
57
    unsquashfs -d "$TEMP_EXTRACT_DIR" -f -no-xattrs "$IMG_NAME" > /dev/null 2>&1
58

59
    if [ ! -d "$TEMP_EXTRACT_DIR" ]; then
60
        echo "[-] 解壓失敗 (可能是缺少 sasquatch)，跳過..."
61
        rm -f "$IMG_NAME"
62
        continue
63
    fi
64

65
    # 5. 搜尋並提取 devmaps
66
    FOUND_PATH=$(find "$TEMP_EXTRACT_DIR" -type d -name "devmaps" | head -n 1)
67

68
    if [ -n "$FOUND_PATH" ]; then
69
        echo "[!] 成功在 $IMG_NAME 中找到 devmaps！"
70
        echo "[*] 路徑: $FOUND_PATH"
71

72
        mkdir -p "$TARGET_DIR"
73
        cp -r "$FOUND_PATH/"* "$TARGET_DIR/"
74
        echo "[ok] 已複製到: $TARGET_DIR"
75

76
        # 清理暫存
77
        rm -rf "$TEMP_EXTRACT_DIR" "$IMG_NAME"
78
        echo "[*] 已清理暫存檔案，任務完成。"
79

80
        exit 0
81
    else
82
        echo "[-] 此分區未找到 devmaps，清理並繼續搜尋下一個..."
83
        rm -rf "$TEMP_EXTRACT_DIR" "$IMG_NAME"
84
    fi
85

86
done
87

88
echo "---------------------------------------------------"
89
if [ -d "$TARGET_DIR" ]; then
90
    echo "掃描結束。請檢查 $TARGET_DIR"
91
else
92
    echo "掃描結束。未在任何 SquashFS 分區中找到 devmaps。"
93
fi

1
import os
2
import json
3
import argparse
4

5
def generate_models_json(target_dir, output_file):
6
    models_list = []
7

8
    # 確保目標目錄存在
9
    if not os.path.exists(target_dir):
10
        print(f"錯誤: 找不到目錄 '{target_dir}'")
11
        return
12

13
    print(f"[*] 正在掃描目錄: {target_dir} ...")
14

15
    # 遞迴遍歷目錄 (os.walk)
16
    for root, dirs, files in os.walk(target_dir):
17
        for file in files:
18
            # 只處理 xml 檔案，並忽略 empty.xml
19
            if file.endswith(".xml") and file != "empty.xml":
20

21
                # 取得完整路徑 (例如: ./extracted_devmaps/MZ93/R183-Z90.xml)
22
                full_path = os.path.join(root, file)
23

24
                # 取得檔名不含副檔名 (ID)
25
                # os.path.splitext("R183.xml") -> ("R183", ".xml")
26
                file_id = os.path.splitext(file)[0]
27

28
                # 取得所在的資料夾名稱 (例如 MZ93)，這是主板系列代號
29
                series_folder = os.path.basename(root)
30

31
                # 建立 JSON 物件結構
32
                model_entry = {
33
                    "id": file_id,
34
                    "name": file_id,
35
                    "file": os.path.relpath(full_path, target_dir),
36
                    # "series": series_folder,       # (可選) 主板系列
37
                    # "path": os.path.relpath(full_path, target_dir) # (可選) 相對路徑
38
                }
39

40
                models_list.append(model_entry)
41

42
    # 根據 ID 排序，讓 JSON 比較整齊
43
    models_list.sort(key=lambda x: x['id'])
44

45
    # 寫入 JSON 檔案
46
    try:
47
        with open(output_file, 'w', encoding='utf-8') as f:
48
            json.dump(models_list, f, indent=2, ensure_ascii=False)
49

50
        print(f"---------------------------------------------------")
51
        print(f"[OK] 成功生成: {output_file}")
52
        print(f"[+] 總共找到 {len(models_list)} 個機型定義檔")
53
        print(f"---------------------------------------------------")
54

55
    except IOError as e:
56
        print(f"寫入檔案錯誤: {e}")
57

58
if __name__ == "__main__":
59
    # 設定參數解析
60
    parser = argparse.ArgumentParser(description="掃描目錄並生成 models.json")
61
    parser.add_argument("directory", nargs="?", default="extracted_devmaps", help="要掃描的 devmaps 資料夾路徑 (預設: extracted_devmaps)")
62
    parser.add_argument("-o", "--output", default="models.json", help="輸出檔案名稱 (預設: models.json)")
63

64
    args = parser.parse_args()
65

66
    generate_models_json(args.directory, args.output)