Skip to content

Commit 88b649c

Browse files
committed
[green] Publish hardware-tested beta status
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
1 parent f331967 commit 88b649c

15 files changed

Lines changed: 240 additions & 49 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,9 @@ are released independently from this monorepo.
1010
documentation.
1111
- Selected firmware agent `0.4.2` for fresh reproducible builds and
1212
two-profile qualification from the canonical public history.
13+
- Validated production Chrome installation, deliberate interruption, recovery,
14+
and reset on real `esp32-4mb` and `esp32-s3-n16r8` hardware, and corrected
15+
public beta copy to describe that completed scope.
1316

1417
## App 0.1.0-beta — 2026-07-30
1518

‎README.md‎

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -62,15 +62,17 @@ BLE GATT peripheral. It supports:
6262
- board naming and identify support; and
6363
- upstream MicroPython’s standard `neopixel` module.
6464

65-
The public browser installer currently offers the exact v0.4.2 unqualified beta
66-
for both current profiles. The exact bytes pass the audited-candidate release
67-
gate, but full project HIL is pending:
68-
69-
| Installer profile | Exact target constraint | Public status |
70-
| ----------------- | ------------------------------------------------------------ | --------------------------------------------------- |
71-
| `esp32-4mb` | Classic ESP32, 4 MiB external SPI flash; no PSRAM assumed | Unqualified v0.4.2 beta; HIL pending |
72-
| `esp32-s3-n16r8` | ESP32-S3, 16 MiB flash / 8 MiB Octal PSRAM; N16R8-class only | Unqualified v0.4.2 beta; HIL pending |
73-
| `esp32-c3-4mb` | ESP32-C3, 4 MiB external SPI flash; no PSRAM assumed | Planned; unavailable; no public image |
65+
The public browser installer currently offers the exact v0.4.2 hardware-tested
66+
beta for both current profiles. Production Chrome erase/install and deliberately
67+
interrupted-flash recovery passed on real hardware for both exact profiles.
68+
Complete release qualification continues across the app, PBLE/1, resource, and
69+
remaining firmware matrices:
70+
71+
| Installer profile | Exact target constraint | Public status |
72+
| ----------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
73+
| `esp32-4mb` | Classic ESP32, 4 MiB external SPI flash; no PSRAM assumed | v0.4.2 hardware-tested beta; browser install/recovery passed |
74+
| `esp32-s3-n16r8` | ESP32-S3, 16 MiB flash / 8 MiB Octal PSRAM; N16R8-class only | v0.4.2 hardware-tested beta; browser install/recovery passed |
75+
| `esp32-c3-4mb` | ESP32-C3, 4 MiB external SPI flash; no PSRAM assumed | Planned; unavailable; no public image |
7476

7577
These are the initial port targets, not a chip-family allowlist. A future board
7678
is compatible when it has a maintained PyBLE agent port, BLE GATT
@@ -108,9 +110,10 @@ shared conformance corpus, documentation, and CI atomically.
108110
[TestFlight](https://testflight.apple.com/join/yU4e8s6d), or build the
109111
Flutter app locally.
110112
2. Open [pyble.dev/flash](https://pyble.dev/flash) in desktop Chrome or Edge.
111-
The exact v0.4.2 unqualified beta is active while full HIL is pending; please
112-
use it at your own risk. Confirm the active version, your exact profile, and
113-
the enabled install action.
113+
The exact v0.4.2 hardware-tested beta is active. Browser installation and
114+
interrupted-flash recovery passed on both exact profiles; complete release
115+
qualification continues. Confirm the active version, your exact profile,
116+
and the enabled install action.
114117
3. Before flashing, back up the board, confirm its exact memory profile, and
115118
accept every safety acknowledgement before using the one-time wired
116119
installer. Flashing erases the board.

‎docs/ROADMAP.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,14 @@ promising dates; accepted work is tracked through GitHub issues and milestones.
99
- PBLE/1 editing, run/stop, console, and file workflows over BLE
1010
- Offline Blockly with beginner GPIO and NeoPixel examples
1111
- Browser installation for the exact `esp32-4mb` and `esp32-s3-n16r8` profiles
12-
as the v0.4.2 unqualified beta; HIL pending
12+
as the v0.4.2 hardware-tested beta; production Chrome install/recovery passed
13+
on both profiles
1314
- MIT-licensed app, agent firmware, protocol, website, tests, and release tools
1415

1516
## Near term
1617

17-
- Complete full HIL qualification for the exact `esp32-4mb` and
18-
`esp32-s3-n16r8` v0.4.2 bytes
18+
- Complete the app, PBLE/1, resource, and remaining firmware release
19+
qualification for the exact v0.4.2 bytes
1920
- Complete real-hardware qualification before enabling the ESP32-C3 installer
2021
- Expand user-facing setup, recovery, and board-specific wiring guidance
2122
- Open and document the Android beta distribution path

‎tests/publication/test_public_claims.py‎

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -54,10 +54,11 @@ def setUpClass(cls) -> None:
5454

5555
def test_readme_identifies_the_exact_hardware_tested_public_beta(self) -> None:
5656
firmware = markdown_section(self.readme, "What works")
57+
normalized = " ".join(firmware.split())
5758

5859
self.assertIn(
5960
"public browser installer currently offers the exact v0.4.2 hardware-tested beta",
60-
firmware,
61+
normalized,
6162
)
6263
self.assertIn("Production Chrome erase/install", firmware)
6364
self.assertIn("interrupted-flash recovery passed", firmware)
@@ -86,10 +87,14 @@ def test_readme_caption_describes_only_the_visible_app(self) -> None:
8687

8788
def test_readme_try_steps_use_the_hardware_tested_beta_safely(self) -> None:
8889
try_section = markdown_section(self.readme, "Try PyBLE")
90+
normalized = " ".join(try_section.split())
8991

90-
self.assertIn("v0.4.2 hardware-tested beta", try_section)
91-
self.assertIn("Browser installation and interrupted-flash recovery passed", try_section)
92-
self.assertIn("complete release qualification continues", try_section)
92+
self.assertIn("v0.4.2 hardware-tested beta", normalized)
93+
self.assertIn(
94+
"Browser installation and interrupted-flash recovery passed",
95+
normalized,
96+
)
97+
self.assertIn("complete release qualification continues", normalized)
9398
self.assertNotIn("full HIL pending", try_section)
9499
self.assertNotIn("use it at your own risk", try_section)
95100
self.assertIn("exact profile", try_section)
@@ -156,7 +161,10 @@ def test_production_browser_claim_is_bound_to_public_evidence(self) -> None:
156161
self.assertEqual(profile["interruption_fetch_rounds"]["firmware"], 2)
157162
self.assertEqual(profile["recovery_fetch_rounds"]["firmware"], 2)
158163
self.assertTrue(
159-
any("not the formal" in limitation for limitation in evidence["limitations"])
164+
any(
165+
"not the formal" in limitation
166+
for limitation in evidence["limitations"]
167+
)
160168
)
161169

162170
def test_bug_template_collects_the_exact_installer_diagnostics(self) -> None:

‎tools/web/DEPLOYMENT.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ website symlink. Firmware and upload evidence remain available through this
111111
remote verification. A caller-supplied evidence or inventory directory is
112112
never trusted. The helper retrieves every published byte afterward.
113113

114-
For the exact digest-bound v0.4.2 unqualified beta, use the same retained
114+
For the exact digest-bound v0.4.2 hardware-tested beta, use the same retained
115115
license inputs and annotated `firmware-v0.4.2` tag, but select the explicit
116116
public-beta mode:
117117

@@ -133,7 +133,9 @@ deploy/vps/deploy.sh <ssh-user>@<vps-host>
133133
The staging and deployment helpers run the canonical `--audited-candidate`
134134
license gate, require both profile HIL states to remain pending, bind the exact
135135
reviewed `release.json` SHA-256, and keep ESP32-C3 absent. The public site must
136-
label these bytes unqualified, HIL-pending, and at the user's risk.
136+
identify these bytes as a hardware-tested beta, name the completed production
137+
Chrome installation and interrupted-flash recovery scope, and distinguish it
138+
from complete release qualification.
137139

138140
For a pending release candidate, stage with both explicit controls:
139141

‎tools/web/README.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -91,8 +91,10 @@ Enablement requires the release gate frozen in
9191
artifacts for both current exact profiles (`esp32-4mb` and
9292
`esp32-s3-n16r8`), the canonical audited-candidate and license gates, an
9393
annotated provenance tag, HTTPS, capability detection, and recovery
94-
instructions. It remains visibly unqualified while complete real-board HIL is
95-
pending. The S3 profile specifically requires an N16R8 module.
94+
instructions. Production Chrome install and interrupted-flash recovery passed
95+
on real hardware for both exact profiles; complete app, PBLE/1, resource, and
96+
remaining firmware release qualification continues. The S3 profile specifically
97+
requires an N16R8 module.
9698
`esp32-c3-4mb` remains visibly unavailable and has no public release bytes
9799
until a later exact-profile HIL-qualified candidate.
98100

216 KB
Loading
Lines changed: 165 additions & 0 deletions
Loading

‎tools/web/src/app/flash/page.tsx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ export default function FlashPage() {
2727
One-time wired provisioning installs PyBLE-enabled MicroPython. Then
2828
develop over Bluetooth Low Energy from the tablet-first PyBLE app.
2929
{publicBeta
30-
? " The current v0.4.2 installer is an unqualified beta. It passed the audited-candidate release gate, but full hardware-in-the-loop validation is pending; use it at your own risk."
30+
? " The current v0.4.2 installer is a hardware-tested firmware beta. Production Chrome erase/install and deliberately interrupted-flash recovery passed on both exact profiles. Complete release qualification is still pending; this is not a qualified release."
3131
: qualifiedPublic
3232
? ` Qualified v${release.version} firmware is available for both exact current release profiles.`
3333
: " The public install action remains unavailable until the final bytes pass hardware validation on both exact current release profiles."}

‎tools/web/src/app/page.tsx‎

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ export default function HomePage() {
7979
number: "01",
8080
title: "Provision once",
8181
body: publicBeta
82-
? `Use USB once to install the exact matching v${firmwareRelease.version} unqualified beta. Full HIL is pending; use it at your own risk.`
82+
? `Use USB once to install the exact matching v${firmwareRelease.version} hardware-tested beta. Production Chrome install and interrupted-flash recovery passed on both exact profiles; complete release qualification continues.`
8383
: qualifiedPublic
8484
? `Use USB once to install the exact matching qualified v${firmwareRelease.version} firmware.`
8585
: firmwareRelease
@@ -107,10 +107,11 @@ export default function HomePage() {
107107
MicroPython and support Bluetooth Low Energy.{" "}
108108
{publicBeta ? (
109109
<>
110-
Public v{firmwareRelease.version} firmware is an unqualified
111-
beta for the exact esp32-4mb and esp32-s3-n16r8 profiles. Full
112-
hardware-in-the-loop qualification is pending; use it at your
113-
own risk.
110+
Public v{firmwareRelease.version} firmware is a
111+
hardware-tested beta for the exact esp32-4mb and
112+
esp32-s3-n16r8 profiles. Production Chrome install and
113+
interrupted-flash recovery passed on both exact profiles;
114+
complete release qualification continues.
114115
</>
115116
) : qualifiedPublic ? (
116117
<>
@@ -392,9 +393,10 @@ export default function HomePage() {
392393
Install the free iPad beta through Apple TestFlight now.{" "}
393394
{publicBeta ? (
394395
<>
395-
The exact v{firmwareRelease.version} unqualified firmware beta
396-
is available for esp32-4mb and esp32-s3-n16r8 while full HIL
397-
remains pending; use it at your own risk.
396+
The exact v{firmwareRelease.version} hardware-tested firmware
397+
beta is available for esp32-4mb and esp32-s3-n16r8. Production
398+
Chrome install and interrupted-flash recovery passed on both
399+
exact profiles; complete release qualification continues.
398400
</>
399401
) : qualifiedPublic ? (
400402
<>

0 commit comments

Comments
 (0)