chore: update version tag to v1.5.5

Author: FASTSHIFT

Source/fpbinject_version.h

@@ -13,8 +13,8 @@
 
 #define FPBINJECT_VERSION_MAJOR 1
 #define FPBINJECT_VERSION_MINOR 5
-#define FPBINJECT_VERSION_PATCH 4
+#define FPBINJECT_VERSION_PATCH 5
 
-#define FPBINJECT_VERSION_STRING "v1.5.4"
+#define FPBINJECT_VERSION_STRING "v1.5.5"
 
 #endif /* FPBINJECT_VERSION_H */

Tools/WebServer/fb_fill.py

@@ -0,0 +1,251 @@
+#!/usr/bin/env python3
+"""Framebuffer fill script - writes color patterns via fpb_cli mem-write"""
+
+import subprocess
+import sys
+import os
+import time
+import argparse
+
+# 默认参数
+DEFAULT_PORT = "/dev/ttyACM1"
+DEFAULT_BAUDRATE = 921600
+DEFAULT_FB_ADDR = 0x2005E000
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+CLI_PATH = os.path.join(SCRIPT_DIR, "cli", "fpb_cli.py")
+
+# 常用颜色 (RGB565 big-endian)
+COLORS = {
+    "red":     "F800",
+    "green":   "07E0",
+    "blue":    "001F",
+    "white":   "FFFF",
+    "black":   "0000",
+    "yellow":  "FFE0",
+    "cyan":    "07FF",
+    "magenta": "F81F",
+    "orange":  "FD20",
+}
+
+
+def mem_write(port, baudrate, addr, data_hex):
+    """调用 CLI 写内存"""
+    cmd = [
+        sys.executable, CLI_PATH,
+        "--port", port,
+        "--baudrate", str(baudrate),
+        "mem-write", hex(addr), data_hex,
+    ]
+    env = os.environ.copy()
+    env["PYTHONPATH"] = SCRIPT_DIR + os.pathsep + env.get("PYTHONPATH", "")
+    result = subprocess.run(cmd, capture_output=True, text=True, timeout=10,
+                            cwd=SCRIPT_DIR, env=env)
+    if result.returncode != 0:
+        print(f"  FAIL @ {hex(addr)}: {result.stderr.strip()}")
+        return False
+    return True
+
+
+def fill_solid(port, baudrate, fb_addr, width, height, color_hex):
+    """纯色填充"""
+    # 每次写 128 像素 = 256 字节 = 512 hex chars
+    chunk_pixels = 128
+    chunk_hex = color_hex * chunk_pixels
+    total_pixels = width * height
+    addr = fb_addr
+
+    print(f"Filling {width}x{height} with #{color_hex} ({total_pixels} pixels)...")
+    written = 0
+    while written < total_pixels:
+        n = min(chunk_pixels, total_pixels - written)
+        data = color_hex * n
+        if not mem_write(port, baudrate, addr, data):
+            return
+        addr += n * 2  # 2 bytes per pixel
+        written += n
+        pct = written * 100 // total_pixels
+        print(f"\r  Progress: {pct}% ({written}/{total_pixels})", end="", flush=True)
+    print("\n  Done!")
+
+
+def fill_stripes_h(port, baudrate, fb_addr, width, height, colors, stripe_h=16):
+    """水平条纹"""
+    chunk_pixels = 128
+    total_pixels = width * height
+    addr = fb_addr
+
+    print(f"Filling {width}x{height} horizontal stripes (h={stripe_h})...")
+    written = 0
+    for y in range(height):
+        color_idx = (y // stripe_h) % len(colors)
+        color = colors[color_idx]
+        row_written = 0
+        while row_written < width:
+            n = min(chunk_pixels, width - row_written)
+            data = color * n
+            if not mem_write(port, baudrate, addr, data):
+                return
+            addr += n * 2
+            row_written += n
+        written += width
+        if y % 8 == 0:
+            pct = written * 100 // total_pixels
+            print(f"\r  Progress: {pct}% (row {y}/{height})", end="", flush=True)
+    print("\n  Done!")
+
+
+def fill_stripes_v(port, baudrate, fb_addr, width, height, colors, stripe_w=32):
+    """垂直条纹"""
+    chunk_pixels = 128
+    total_pixels = width * height
+    addr = fb_addr
+
+    print(f"Filling {width}x{height} vertical stripes (w={stripe_w})...")
+    written = 0
+    for y in range(height):
+        # 构建一行像素
+        row = ""
+        for x in range(width):
+            color_idx = (x // stripe_w) % len(colors)
+            row += colors[color_idx]
+        # 分块写入
+        offset = 0
+        while offset < len(row):
+            chunk = row[offset:offset + chunk_pixels * 4]  # 4 hex chars per pixel
+            byte_len = len(chunk) // 2
+            if not mem_write(port, baudrate, addr, chunk):
+                return
+            addr += byte_len
+            offset += len(chunk)
+        written += width
+        if y % 8 == 0:
+            pct = written * 100 // total_pixels
+            print(f"\r  Progress: {pct}% (row {y}/{height})", end="", flush=True)
+    print("\n  Done!")
+
+
+def fill_gradient(port, baudrate, fb_addr, width, height):
+    """红绿渐变"""
+    chunk_pixels = 128
+    total_pixels = width * height
+    addr = fb_addr
+
+    print(f"Filling {width}x{height} gradient...")
+    written = 0
+    for y in range(height):
+        row = ""
+        for x in range(width):
+            r = (x * 31) // width        # 0-31
+            g = (y * 63) // height        # 0-63
+            b = 0
+            rgb565 = (r << 11) | (g << 5) | b
+            row += f"{rgb565:04X}"
+        offset = 0
+        while offset < len(row):
+            chunk = row[offset:offset + chunk_pixels * 4]
+            byte_len = len(chunk) // 2
+            if not mem_write(port, baudrate, addr, chunk):
+                return
+            addr += byte_len
+            offset += len(chunk)
+        written += width
+        if y % 8 == 0:
+            pct = written * 100 // total_pixels
+            print(f"\r  Progress: {pct}% (row {y}/{height})", end="", flush=True)
+    print("\n  Done!")
+
+
+def fill_checkerboard(port, baudrate, fb_addr, width, height, c1="F800", c2="001F", block=16):
+    """棋盘格"""
+    chunk_pixels = 128
+    total_pixels = width * height
+    addr = fb_addr
+
+    print(f"Filling {width}x{height} checkerboard (block={block})...")
+    written = 0
+    for y in range(height):
+        row = ""
+        for x in range(width):
+            if ((x // block) + (y // block)) % 2 == 0:
+                row += c1
+            else:
+                row += c2
+        offset = 0
+        while offset < len(row):
+            chunk = row[offset:offset + chunk_pixels * 4]
+            byte_len = len(chunk) // 2
+            if not mem_write(port, baudrate, addr, chunk):
+                return
+            addr += byte_len
+            offset += len(chunk)
+        written += width
+        if y % 8 == 0:
+            pct = written * 100 // total_pixels
+            print(f"\r  Progress: {pct}% (row {y}/{height})", end="", flush=True)
+    print("\n  Done!")
+
+
+PATTERNS = {
+    "solid":    "纯色填充",
+    "hstripe":  "水平条纹",
+    "vstripe":  "垂直条纹",
+    "gradient": "红绿渐变",
+    "checker":  "棋盘格",
+    "all":      "依次执行所有图案",
+}
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Framebuffer fill via FPB CLI")
+    parser.add_argument("--port", default=DEFAULT_PORT)
+    parser.add_argument("--baudrate", type=int, default=DEFAULT_BAUDRATE)
+    parser.add_argument("--addr", default=hex(DEFAULT_FB_ADDR),
+                        help=f"帧缓冲区地址 (default: {hex(DEFAULT_FB_ADDR)})")
+    parser.add_argument("--width", type=int, default=466, help="屏幕宽度 (pixels)")
+    parser.add_argument("--height", type=int, default=466, help="屏幕高度 (pixels)")
+    parser.add_argument("--color", default="red", choices=list(COLORS.keys()),
+                        help="纯色填充的颜色")
+    parser.add_argument("pattern", choices=list(PATTERNS.keys()),
+                        help="填充图案: " + ", ".join(f"{k}={v}" for k, v in PATTERNS.items()))
+
+    args = parser.parse_args()
+    fb_addr = int(args.addr, 16)
+
+    print(f"Port: {args.port} @ {args.baudrate}")
+    print(f"FB addr: {hex(fb_addr)}, size: {args.width}x{args.height}")
+    print()
+
+    patterns_to_run = []
+    if args.pattern == "all":
+        patterns_to_run = ["solid", "hstripe", "vstripe", "gradient", "checker"]
+    else:
+        patterns_to_run = [args.pattern]
+
+    for pat in patterns_to_run:
+        t0 = time.time()
+        if pat == "solid":
+            fill_solid(args.port, args.baudrate, fb_addr,
+                       args.width, args.height, COLORS[args.color])
+        elif pat == "hstripe":
+            fill_stripes_h(args.port, args.baudrate, fb_addr,
+                           args.width, args.height,
+                           ["F800", "07E0", "001F", "FFFF"], stripe_h=16)
+        elif pat == "vstripe":
+            fill_stripes_v(args.port, args.baudrate, fb_addr,
+                           args.width, args.height,
+                           ["F800", "07E0", "001F", "FFE0"], stripe_w=32)
+        elif pat == "gradient":
+            fill_gradient(args.port, args.baudrate, fb_addr,
+                          args.width, args.height)
+        elif pat == "checker":
+            fill_checkerboard(args.port, args.baudrate, fb_addr,
+                              args.width, args.height)
+        elapsed = time.time() - t0
+        print(f"  Time: {elapsed:.1f}s\n")
+
+        if len(patterns_to_run) > 1:
+            time.sleep(2)
+
+
+if __name__ == "__main__":
+    main()