Skip to content

CH348 0.1.0 build 12 — Development preview

Pre-release
Pre-release

Choose a tag to compare

@idy idy released this 02 Nov 00:04
95bf5cb

Looking for the PKG installer? Download the newer unsigned PKG or open the PKG preview release. This older preview's original downloads are ZIP archives.

Development preview: 0.1.0, build 12

This release publishes the CH348 macOS driver source and a universal unsigned build from merged commit 95bf5cb7129dc452b56ca2b0d2bd2a3f988ee290.

The attached app is an unsigned build for inspection and development. It is not an installable, notarized driver distribution. Build and sign the source using the documented development flow on an Apple-registered development Mac. Do not disable SIP or system extension validation to install this preview.

Changes

  • Verify channels 0–7 independently for each CH348 adapter instead of requiring exactly eight ports across the entire Mac.
  • Report missing channels, invalid port names, and runtime-build mismatches, with regression coverage for multiple adapters.
  • Add a shared icon for the installer app and DriverKit extension, with a reproducible Swift drawing script.
  • Advance the build number to 12 so macOS replaces an existing build 11 extension.

Assets

  • CH348-v0.1.0-dev.12-macos-universal-unsigned.zip: unsigned Release build of CH348.app, containing the driver extension; both executables support Apple Silicon and Intel. No provisioning profiles are included.
  • CH348-v0.1.0-dev.12-source.zip: complete tracked source, including build, signing, installation and verification tools.
  • SHA256SUMS: SHA-256 checksums for both ZIP archives.

Validation and limits

  • Pull request idy/ch348-macos#1 passed all three checks before merging.
  • Protocol and serial-ring tests passed with ASan/UBSan; all 18 Python tests passed.
  • Unsigned and local development-signed builds passed. Local development installation and a physical reconnect produced eight native serial ports, all reporting build 12.
  • The unmodified H2Loader CLI completed a status exchange through UART7 with a BK7258 board running H2Loader 0.7.0. Other channels timed out during that scan.
  • Multiple adapters have synthetic regression coverage, but have not been physically tested together. Intel runtime, sleep/wake, restart, sustained traffic and the icon in System Settings remain unqualified.
  • Bluetooth-inclusive H2Loader scanning is blocked by that CLI's missing NSBluetoothAlwaysUsageDescription; the successful serial scan used --no-ble.

A non-development build compiled locally, but failed the installation signing check because its restricted USB signature did not match the available development wildcard profile. The existing local installation uses a device-scoped Apple Development profile. A production installation release still requires suitable Developer ID signing and Apple-approved DriverKit USB/Serial distribution grants, followed by notarization. A successful GitHub upload does not establish production installation eligibility.