Skip to content

PXA 跨平台开发配套 0.1.0 / PXA Cross-platform Companion 0.1.0

Choose a tag to compare

View all tags
@lucinhu lucinhu released this 13 Oct 21:06
· 10 commits to master since this release
host-tools-v0.1.0
7a88e5b

中文

PXA 跨平台开发配套 0.1.0，配合 DevKit 0.3.0 / Core 2 使用。

  • Linux amd64 DevKit 预构建容器：无需自行编译 LLVM，支持离线构建、签名及真实 Guest 无界面截图。
  • Windows/macOS/Linux 共用的 Python 包装器与宿主机 PXADB：容器内构建，本机 USB 串口安装、启动、截图与输入，无需 USB 转发。
  • 包含中文优先/英文 README、WSL 2 可选路线、固定依赖、源码构建说明、签名与摘要验证脚本。
  • 修复无 os.getuid() 的宿主机串口发现；71 项 PXADB 和 3 项容器参数检查通过。

验证：Linux Podman 实际载入归档，离线初始化含空格路径的 Hello，构建 ESP32-S3、ESP32-S31、x86_64，运行真实 Guest 并检查截图；宿主机连接 pai-touch、SenseCAP Watcher 和 ESP32-S31 Korvo-1。实际安装测试及限制见工作区验证报告。

完整原生 DevKit 仍仅为 Linux x86_64。Windows/macOS 原生机器与 USB 驱动尚未实际验证；Apple Silicon/ARM Windows 采用 amd64 仿真，性能未测。容器模拟器使用 SDL dummy，图像保存到宿主机，不弹出桌面窗口。

下载两个归档、host-tools-0.1.0.json、同名 .sig 和 SHA256SUMS。使用单独可信的发行公钥验证清单与归档，再执行 docker load；工具包内 README 提供完整步骤。现有 DevKit 附件与版本不变。本配套不包含私钥、令牌、设备数据或构建缓存。

容器载入后请添加默认镜像名称（归档保留了 Podman 的 localhost/ 前缀）：

docker load --input pxa-devkit-container-0.3.0-linux-amd64.tar.gz
docker tag localhost/pxa-devkit:0.3.0-linux-amd64 pxa-devkit:0.3.0-linux-amd64

Podman 用户将上述 docker 换为 podman，并给包装器加 --engine podman。该操作只添加名称，不复制镜像层。

安装教程 · 工具源码

实际验证报告

English

PXA Cross-platform Companion 0.1.0 for DevKit 0.3.0 / Core 2.

  • Prebuilt Linux amd64 DevKit container for offline builds, signing and real-Guest headless screenshots, without compiling LLVM.
  • Python wrapper and host-native PXADB for Windows/macOS/Linux: compile in the container and use local USB serial for install, launch, screenshots and input without forwarding USB.
  • Chinese-first and English instructions, optional WSL 2 workflow, pinned dependencies, native-port boundaries and signed manifest verification.
  • Fixed serial discovery on hosts without os.getuid(); 71 PXADB and 3 container argument checks pass.

Validated on Linux Podman: Docker archive loading, offline Hello initialization in a path with spaces, ESP32-S3 / ESP32-S31 / x86_64 packaging, and actual Guest rendering. Native PXADB connects to pai-touch, SenseCAP Watcher and ESP32-S31 Korvo-1; see the workspace validation report for device installation evidence.

The complete native DevKit still targets Linux x86_64. Actual Windows/macOS hosts and USB drivers have not been tested. Apple Silicon/ARM Windows use amd64 emulation with unmeasured performance. SDL dummy saves screenshots on the host without a desktop window.

Download both archives, the JSON manifest, its signature and SHA256SUMS. Verify with a separately trusted PXA release key before loading the image. Existing DevKit assets remain unchanged. No private keys, tokens, device data or build caches are included.

After loading, add the wrapper’s default image name (the archive retains Podman’s localhost/ prefix):

docker load --input pxa-devkit-container-0.3.0-linux-amd64.tar.gz
docker tag localhost/pxa-devkit:0.3.0-linux-amd64 pxa-devkit:0.3.0-linux-amd64

For Podman, replace docker with podman and use --engine podman. Tagging adds a name without copying layers.

Instructions

Validation report (Chinese)

Assets 7
Loading