@agentdeck/shared 1.0.22 → 1.0.24
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esp32-boards.d.ts +257 -0
- package/dist/esp32-boards.d.ts.map +1 -0
- package/dist/esp32-boards.js +400 -0
- package/dist/esp32-boards.js.map +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ESP32 board SSOT — the machine-readable half of the board table.
|
|
3
|
+
*
|
|
4
|
+
* WHY THIS FILE EXISTS. The same board set was written out by hand in four
|
|
5
|
+
* places and only one edge had a gate:
|
|
6
|
+
*
|
|
7
|
+
* docs/hardware-compatibility.md (spec sheet — gated into docs/hardware/index.html)
|
|
8
|
+
* .github/workflows/esp32-release.yml (build matrix — enforced by a COMMENT only)
|
|
9
|
+
* bridge/src/cli.ts (ESP32_OTA_BOARDS)
|
|
10
|
+
* docs/esp32.md (alias table)
|
|
11
|
+
*
|
|
12
|
+
* A board missing from the release matrix ships no firmware and nothing fails —
|
|
13
|
+
* which is exactly how `t_embed`, `t_display_pro` and `esp32_c6_147` had no
|
|
14
|
+
* binaries at all in 1.0.1. This file is where those literals stop being
|
|
15
|
+
* literals; `scripts/generate-esp32-board-matrix.mjs` emits the derived copies
|
|
16
|
+
* and cross-checks the rest.
|
|
17
|
+
*
|
|
18
|
+
* DIVISION OF LABOUR with docs/hardware-compatibility.md: that file stays the
|
|
19
|
+
* SSOT for the human columns (display, controller, input, peripherals, status)
|
|
20
|
+
* and this one owns the machine fields. Two SSOTs over DISJOINT column sets,
|
|
21
|
+
* bound by a gate — not a second copy. Drop the cross-check and this file makes
|
|
22
|
+
* the duplication worse, not better.
|
|
23
|
+
*/
|
|
24
|
+
export type Esp32ChipFamily = 'ESP32' | 'ESP32-S3' | 'ESP32-P4' | 'ESP32-C6';
|
|
25
|
+
export type Esp32FlashSize = '4MB' | '8MB' | '16MB';
|
|
26
|
+
/** esptool `--before` values (esptool-js calls this the reset `mode`). */
|
|
27
|
+
export type Esp32ResetBefore = 'default_reset' | 'usb_reset' | 'no_reset' | 'no_reset_no_sync';
|
|
28
|
+
/** esptool `--after` values. */
|
|
29
|
+
export type Esp32ResetAfter = 'hard_reset' | 'soft_reset' | 'no_reset' | 'no_reset_stub';
|
|
30
|
+
/**
|
|
31
|
+
* Whether the browser flasher may offer this board.
|
|
32
|
+
* - `verified` a hardware run connected and both guards agreed
|
|
33
|
+
* - `verified-partial` connected, but something is degraded (see the evidence)
|
|
34
|
+
* - `unverified` never measured — listed, disabled, with the reason shown
|
|
35
|
+
* - `blocked` measured and it cannot work here
|
|
36
|
+
*/
|
|
37
|
+
export type Esp32WebFlashStatus = 'verified' | 'verified-partial' | 'unverified' | 'blocked';
|
|
38
|
+
export interface Esp32BoardSpec {
|
|
39
|
+
/** canonical `device_info.board` — the string every AgentDeck surface addresses */
|
|
40
|
+
id: string;
|
|
41
|
+
/** PlatformIO environment. A DIFFERENT namespace from `id`, deliberately. */
|
|
42
|
+
env: string;
|
|
43
|
+
name: string;
|
|
44
|
+
/** panel summary, mirrored into the release notes table */
|
|
45
|
+
display: string;
|
|
46
|
+
/**
|
|
47
|
+
* Extra CLI spellings accepted for `agentdeck esp32-ota <target>`. This list
|
|
48
|
+
* is the CLI's existing set VERBATIM — adding a spelling here changes what
|
|
49
|
+
* the command accepts, so it is a behaviour change, not bookkeeping.
|
|
50
|
+
* `esp32/scripts/flash.sh` keeps its own friendlier names (`tft_114`,
|
|
51
|
+
* `amoled_18`, …) for the local build path; those are deliberately NOT
|
|
52
|
+
* merged in, because they were never valid daemon targets.
|
|
53
|
+
*/
|
|
54
|
+
aliases: string[];
|
|
55
|
+
chipFamily: Esp32ChipFamily;
|
|
56
|
+
flashSize: Esp32FlashSize;
|
|
57
|
+
flashMode: 'dio';
|
|
58
|
+
flashFreq: '40m' | '80m';
|
|
59
|
+
/**
|
|
60
|
+
* Where the bootloader sits INSIDE the merged image. Audit field only —
|
|
61
|
+
* consumers write the merged image at 0x0 and never branch on this.
|
|
62
|
+
*/
|
|
63
|
+
bootloaderOffset: number;
|
|
64
|
+
uploadBaud: number;
|
|
65
|
+
/** verbatim `upload_flags` from platformio.ini, for the esptool CLI path */
|
|
66
|
+
esptoolFlags: string[];
|
|
67
|
+
/** the reset mode the env's flags imply */
|
|
68
|
+
before: Esp32ResetBefore;
|
|
69
|
+
after: Esp32ResetAfter;
|
|
70
|
+
/** does the flasher stub load on this board? (some envs pin --no-stub) */
|
|
71
|
+
stub: boolean;
|
|
72
|
+
/**
|
|
73
|
+
* Override for the post-write reset (esptool-js `custom_reset` syntax).
|
|
74
|
+
* Omit to take ESP32_POST_WRITE_RESET_SEQUENCE; set to '' to write nothing.
|
|
75
|
+
* See esp32PostWriteResetSequence().
|
|
76
|
+
*/
|
|
77
|
+
postWriteReset?: string;
|
|
78
|
+
/** native-USB CDC/JTAG: entering download mode RE-ENUMERATES the device node */
|
|
79
|
+
nativeUsb: boolean;
|
|
80
|
+
/** has dual-OTA partitions, i.e. `agentdeck esp32-ota` can target it */
|
|
81
|
+
ota: boolean;
|
|
82
|
+
webFlash: boolean;
|
|
83
|
+
webFlashStatus: Esp32WebFlashStatus;
|
|
84
|
+
/**
|
|
85
|
+
* The evidence for `webFlash`. A flag nobody measured is indistinguishable
|
|
86
|
+
* from one a board produced, so this string is what tells them apart — and it
|
|
87
|
+
* is required whenever `webFlash` is true (gated in tests).
|
|
88
|
+
*/
|
|
89
|
+
webFlashVerified: string;
|
|
90
|
+
notes: string[];
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* esptool's own default bootloader offsets. Three values, not two — ESP32-P4 at
|
|
94
|
+
* 0x2000 is the one that gets missed, because every other chip in this fleet is
|
|
95
|
+
* 0x0 or 0x1000 and a "two cases" assumption survives review right up until a
|
|
96
|
+
* P4 is bricked.
|
|
97
|
+
*/
|
|
98
|
+
export declare const ESP32_BOOTLOADER_OFFSET: Record<Esp32ChipFamily, number>;
|
|
99
|
+
/** Ordered as the release matrix builds them, so the generated diff stays small. */
|
|
100
|
+
export declare const ESP32_BOARDS: Esp32BoardSpec[];
|
|
101
|
+
export declare const esp32BoardById: (id: string) => Esp32BoardSpec | undefined;
|
|
102
|
+
/**
|
|
103
|
+
* alias / canonical id / env → the board it means.
|
|
104
|
+
*
|
|
105
|
+
* Built as a declaration rather than a top-level loop: this package is
|
|
106
|
+
* published with `sideEffects: false`, so import-time statements are work a
|
|
107
|
+
* bundler is allowed to delete (gated by shared/src/__tests__/no-side-effects.test.ts).
|
|
108
|
+
*/
|
|
109
|
+
export declare const ESP32_BOARD_BY_TARGET: Record<string, Esp32BoardSpec>;
|
|
110
|
+
/**
|
|
111
|
+
* esptool reports a chip DESCRIPTION, not a family: "ESP32-D0WD (revision 1)",
|
|
112
|
+
* "ESP32-S3 (QFN56) (revision v0.2)". Order matters — every variant string also
|
|
113
|
+
* contains the substring "ESP32", so the classic case has to be the fallback or
|
|
114
|
+
* it swallows the whole family.
|
|
115
|
+
*/
|
|
116
|
+
export declare function esp32ChipFamilyOf(description: string): Esp32ChipFamily | 'other';
|
|
117
|
+
/**
|
|
118
|
+
* esptool-js's `detectFlashSize()` silently returns `"4MB"` when it cannot
|
|
119
|
+
* decode the size id, so "4MB" means either a 4MB part or "no idea". Measured
|
|
120
|
+
* 2026-08-22: a TTGO T-Display read through the ROM loader (no stub) answers
|
|
121
|
+
* `0xffffff` and was reported as 4MB, while the same board with the stub reads
|
|
122
|
+
* `0x1840ef` → 16MB, and esptool.py reads 16MB either way.
|
|
123
|
+
*
|
|
124
|
+
* So the id is checked first and "unknown" is allowed to stay unknown.
|
|
125
|
+
*/
|
|
126
|
+
export declare function esp32FlashIdIsUsable(flashIdHex: string | undefined): boolean;
|
|
127
|
+
/**
|
|
128
|
+
* The flash-size guard is DIRECTIONAL.
|
|
129
|
+
*
|
|
130
|
+
* Declaring MORE flash than the part has is the brick: the bootloader header
|
|
131
|
+
* claims a geometry the chip cannot serve and the partition table is rejected.
|
|
132
|
+
* Declaring LESS is merely conservative — and on InkDeck it is mandatory, since
|
|
133
|
+
* the XIAO ESP32-S3 Plus is physically 16MB but its BSP bakes an 8MB field. An
|
|
134
|
+
* equality test fails that board for doing the correct thing.
|
|
135
|
+
*
|
|
136
|
+
* Returns undefined when the detected size is unknown; that is its own answer,
|
|
137
|
+
* not a pass and not a failure.
|
|
138
|
+
*/
|
|
139
|
+
export declare function esp32FlashSizeIsSafe(declared: string, detected: string | undefined): boolean | undefined;
|
|
140
|
+
/** The `--chip` argument esptool expects for a board's family. */
|
|
141
|
+
export declare const ESP32_ESPTOOL_CHIP: Record<Esp32ChipFamily, string>;
|
|
142
|
+
/** Chip ID `esptool image-info` prints, per family — used to self-check a merged image. */
|
|
143
|
+
export declare const ESP32_IMAGE_CHIP_ID: Record<Esp32ChipFamily, number>;
|
|
144
|
+
/** Where the partition table lives; also where the bootloader region ends. */
|
|
145
|
+
/**
|
|
146
|
+
* The reset that actually boots a board after a write, as an esptool-js
|
|
147
|
+
* `custom_reset` sequence.
|
|
148
|
+
*
|
|
149
|
+
* WHY THIS EXISTS. esptool-js's `after('hard_reset')` cannot boot these boards.
|
|
150
|
+
* Its non-USB-OTG implementation is, in full, `sleep(100); setRTS(false)` — a
|
|
151
|
+
* RELEASE with no ASSERT. That works only when the preceding step left EN
|
|
152
|
+
* asserted, which `--before default-reset` does and a finished `writeFlash`
|
|
153
|
+
* does not. So the chip is left parked in the flasher stub, the firmware never
|
|
154
|
+
* runs, and the post-write `device_info` read-back can never succeed.
|
|
155
|
+
*
|
|
156
|
+
* Measured 2026-08-23 with a non-destructive probe (connect exactly as the
|
|
157
|
+
* flash does, apply a candidate reset, ask the firmware to identify itself),
|
|
158
|
+
* with a firmware-identity guard so a concurrent write on the same board aborts
|
|
159
|
+
* the run instead of producing a confident wrong answer:
|
|
160
|
+
*
|
|
161
|
+
* sequence t_display_pro (0x303a/0x1001, native USB) 86box (0x1a86/0x7523, CH340)
|
|
162
|
+
* after('hard_reset') PARKED PARKED
|
|
163
|
+
* R1|W250|R0 booted PARKED
|
|
164
|
+
* D0|R1|W100|R0 booted (48s -> 5s) booted (39s -> 3s)
|
|
165
|
+
*
|
|
166
|
+
* `D0` IS LOAD-BEARING, and only one of the two boards shows it. Pulsing EN
|
|
167
|
+
* without first driving IO0 high leaves the CH340 board in download mode —
|
|
168
|
+
* indistinguishable, from the outside, from a board that failed to boot. The
|
|
169
|
+
* two adapter classes take different reset strategies inside esptool-js
|
|
170
|
+
* (UsbJtagSerialReset vs ClassicReset), so a sequence verified on one is not
|
|
171
|
+
* evidence for the other; this one is measured on both.
|
|
172
|
+
*
|
|
173
|
+
* Boards whose `after` is `no_reset` are deliberately excluded: ips_10 asks not
|
|
174
|
+
* to be reset and that is a property of the board, not an oversight.
|
|
175
|
+
*/
|
|
176
|
+
export declare const ESP32_POST_WRITE_RESET_SEQUENCE = "D0|R1|W100|R0";
|
|
177
|
+
/**
|
|
178
|
+
* The sequence to run after writing `board`, or undefined when it must not be
|
|
179
|
+
* reset. Per-board override first, so a future board that needs different
|
|
180
|
+
* timing states it in the SSOT rather than in a flasher.
|
|
181
|
+
*/
|
|
182
|
+
export declare function esp32PostWriteResetSequence(board: Esp32BoardSpec): string | undefined;
|
|
183
|
+
export declare const ESP32_PARTITION_TABLE_OFFSET = 32768;
|
|
184
|
+
/** boot_app0 (the OTA-selection blob) offset. Absent, a board can boot a stale slot. */
|
|
185
|
+
export declare const ESP32_BOOT_APP0_OFFSET = 57344;
|
|
186
|
+
/** app0 — the first application slot. Same on every board here. */
|
|
187
|
+
export declare const ESP32_APP0_OFFSET = 65536;
|
|
188
|
+
export type Esp32PreflightCode =
|
|
189
|
+
/** every check the link could answer agreed */
|
|
190
|
+
'ok'
|
|
191
|
+
/** connected, but the flash id was unreadable — chip family is all we verified */
|
|
192
|
+
| 'ok-unknown-flash'
|
|
193
|
+
/** the chip on the wire is not the family this image was built for */
|
|
194
|
+
| 'chip-mismatch'
|
|
195
|
+
/** the image declares more flash than the part reports having */
|
|
196
|
+
| 'flash-too-small'
|
|
197
|
+
/** this SURFACE does not offer the board (browser only — see `surface`) */
|
|
198
|
+
| 'board-not-offered'
|
|
199
|
+
/** the image about to be written was built for different geometry than this board's spec */
|
|
200
|
+
| 'image-geometry-mismatch';
|
|
201
|
+
/**
|
|
202
|
+
* Which tool is asking. It changes exactly one thing, and getting it wrong in
|
|
203
|
+
* either direction is a real defect:
|
|
204
|
+
*
|
|
205
|
+
* - `'browser'` additionally requires `webFlash`, because the page only offers
|
|
206
|
+
* boards a hardware run measured.
|
|
207
|
+
* - `'cli'` does NOT. `webFlash` means "offered in the browser", never "may be
|
|
208
|
+
* written at all" — and `esp32_c6_147` has no OTA slot, so USB is its ONLY
|
|
209
|
+
* update path. A CLI that inherited the browser's list would leave that board
|
|
210
|
+
* with no way to be updated at all.
|
|
211
|
+
*/
|
|
212
|
+
export type Esp32FlashSurface = 'browser' | 'cli';
|
|
213
|
+
export interface Esp32PreflightInput {
|
|
214
|
+
board: Esp32BoardSpec;
|
|
215
|
+
surface: Esp32FlashSurface;
|
|
216
|
+
/** raw `getChipDescription()` output, e.g. "ESP32-S3 (QFN56) (revision v0.2)" */
|
|
217
|
+
detectedChip: string | undefined;
|
|
218
|
+
/** `detectFlashSize()` output, or undefined when the flash id was unusable */
|
|
219
|
+
detectedFlashSize: string | undefined;
|
|
220
|
+
/**
|
|
221
|
+
* What the IMAGE says, read from the release manifest — as opposed to what
|
|
222
|
+
* this build's SSOT says the board is.
|
|
223
|
+
*
|
|
224
|
+
* These are not the same fact and they are deliberately decoupled: the CLI
|
|
225
|
+
* takes its manifest from a release tag (`--tag`, or the newest published
|
|
226
|
+
* one) while its board spec is bundled, and the browser page ships from
|
|
227
|
+
* master while its manifest comes from whichever release Pages deployed. So
|
|
228
|
+
* the value the guard checks and the value actually written into the
|
|
229
|
+
* flash-params header can differ, and the guard would be validating a number
|
|
230
|
+
* nobody writes.
|
|
231
|
+
*
|
|
232
|
+
* Omit when writing a hand-supplied image (`--firmware`), where there is no
|
|
233
|
+
* manifest to disagree with.
|
|
234
|
+
*/
|
|
235
|
+
imageGeometry?: {
|
|
236
|
+
chipFamily: string;
|
|
237
|
+
flashSize: string;
|
|
238
|
+
};
|
|
239
|
+
}
|
|
240
|
+
export interface Esp32PreflightVerdict {
|
|
241
|
+
code: Esp32PreflightCode;
|
|
242
|
+
/** the only field a caller may branch on to start a write */
|
|
243
|
+
mayWrite: boolean;
|
|
244
|
+
/** what was compared, for the UI to show detected-vs-expected */
|
|
245
|
+
detectedFamily?: Esp32ChipFamily | 'other';
|
|
246
|
+
}
|
|
247
|
+
/**
|
|
248
|
+
* There is deliberately no `force` parameter.
|
|
249
|
+
*
|
|
250
|
+
* Writing a 16MB-header image to an 8MB part, or an S3 image to a classic
|
|
251
|
+
* ESP32, is precisely how these boards are bricked — and the recovery for a
|
|
252
|
+
* bricked board is the very tool that refused. An override switch would make
|
|
253
|
+
* the guard advisory, and an advisory guard is the one that gets clicked
|
|
254
|
+
* through at 2am. Callers that legitimately need to bypass have esptool.
|
|
255
|
+
*/
|
|
256
|
+
export declare function esp32PreflightVerdict(input: Esp32PreflightInput): Esp32PreflightVerdict;
|
|
257
|
+
//# sourceMappingURL=esp32-boards.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"esp32-boards.d.ts","sourceRoot":"","sources":["../src/esp32-boards.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,400 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ESP32 board SSOT — the machine-readable half of the board table.
|
|
3
|
+
*
|
|
4
|
+
* WHY THIS FILE EXISTS. The same board set was written out by hand in four
|
|
5
|
+
* places and only one edge had a gate:
|
|
6
|
+
*
|
|
7
|
+
* docs/hardware-compatibility.md (spec sheet — gated into docs/hardware/index.html)
|
|
8
|
+
* .github/workflows/esp32-release.yml (build matrix — enforced by a COMMENT only)
|
|
9
|
+
* bridge/src/cli.ts (ESP32_OTA_BOARDS)
|
|
10
|
+
* docs/esp32.md (alias table)
|
|
11
|
+
*
|
|
12
|
+
* A board missing from the release matrix ships no firmware and nothing fails —
|
|
13
|
+
* which is exactly how `t_embed`, `t_display_pro` and `esp32_c6_147` had no
|
|
14
|
+
* binaries at all in 1.0.1. This file is where those literals stop being
|
|
15
|
+
* literals; `scripts/generate-esp32-board-matrix.mjs` emits the derived copies
|
|
16
|
+
* and cross-checks the rest.
|
|
17
|
+
*
|
|
18
|
+
* DIVISION OF LABOUR with docs/hardware-compatibility.md: that file stays the
|
|
19
|
+
* SSOT for the human columns (display, controller, input, peripherals, status)
|
|
20
|
+
* and this one owns the machine fields. Two SSOTs over DISJOINT column sets,
|
|
21
|
+
* bound by a gate — not a second copy. Drop the cross-check and this file makes
|
|
22
|
+
* the duplication worse, not better.
|
|
23
|
+
*/
|
|
24
|
+
/**
|
|
25
|
+
* esptool's own default bootloader offsets. Three values, not two — ESP32-P4 at
|
|
26
|
+
* 0x2000 is the one that gets missed, because every other chip in this fleet is
|
|
27
|
+
* 0x0 or 0x1000 and a "two cases" assumption survives review right up until a
|
|
28
|
+
* P4 is bricked.
|
|
29
|
+
*/
|
|
30
|
+
export const ESP32_BOOTLOADER_OFFSET = {
|
|
31
|
+
ESP32: 0x1000,
|
|
32
|
+
'ESP32-S3': 0x0,
|
|
33
|
+
'ESP32-C6': 0x0,
|
|
34
|
+
'ESP32-P4': 0x2000,
|
|
35
|
+
};
|
|
36
|
+
const EV = '2026-08-22 · esptool-js 0.6.1 · Node 26.5 serialport adapter · ';
|
|
37
|
+
/** Ordered as the release matrix builds them, so the generated diff stays small. */
|
|
38
|
+
export const ESP32_BOARDS = [
|
|
39
|
+
{
|
|
40
|
+
id: '86box', env: 'box_86', name: '86 Box', display: '4" 480x480 ST7701',
|
|
41
|
+
aliases: ['box_86', 'box_40'],
|
|
42
|
+
chipFamily: 'ESP32-S3', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
|
|
43
|
+
bootloaderOffset: 0x0, uploadBaud: 460800, esptoolFlags: [],
|
|
44
|
+
before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: false,
|
|
45
|
+
ota: true,
|
|
46
|
+
webFlash: true, webFlashStatus: 'verified',
|
|
47
|
+
webFlashVerified: EV +
|
|
48
|
+
'default_reset/stub · ESP32-S3 (QFN56) rev v0.2 · flash 16MB · 460800 ok. ' +
|
|
49
|
+
'Writes and MD5-verifies from the released merged image (4 runs, esp32-v1.0.7). ' +
|
|
50
|
+
'POST-WRITE RESET DOES NOT WORK ON THIS BOARD: it stays parked in the flasher stub — silent for 200s ' +
|
|
51
|
+
'with exclusive port access — after every write, and comes up in 2.0s only once python esptool pulses EN. ' +
|
|
52
|
+
'A serialport RTS pulse, a DTR pulse, an RTS pulse through the Transport shim, and ' +
|
|
53
|
+
'main(default_reset)+after(hard_reset) were each measured and none reboot it; esptool-js HardReset is a ' +
|
|
54
|
+
'release with no assert. The firmware written is correct — the user must power-cycle.',
|
|
55
|
+
notes: ['CH340 USB-serial bridge.'],
|
|
56
|
+
},
|
|
57
|
+
{
|
|
58
|
+
id: 'ips_35', env: 'ips35', name: 'IPS 3.5"', display: '3.5" 480x320 AXS15231B',
|
|
59
|
+
aliases: ['ips35'],
|
|
60
|
+
chipFamily: 'ESP32-S3', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
|
|
61
|
+
bootloaderOffset: 0x0, uploadBaud: 460800,
|
|
62
|
+
esptoolFlags: ['--before', 'no_reset', '--no-stub'],
|
|
63
|
+
before: 'no_reset', after: 'hard_reset', stub: false, nativeUsb: true,
|
|
64
|
+
ota: true,
|
|
65
|
+
webFlash: false, webFlashStatus: 'unverified',
|
|
66
|
+
webFlashVerified: '2026-08-22 · owned and live on Wi-Fi, but not USB-attached during the spike, and still not attached on 2026-08-23. Untested, not failing — nothing on this board has been measured either way.',
|
|
67
|
+
notes: [
|
|
68
|
+
'esptool misdetects the flash as 8MB during a bootloop — 16MB must be explicit.',
|
|
69
|
+
"`stub: false` here is INHERITED from platformio's --no-stub, never measured. That pin arrived in 2cf5fc754, a commit about displays and connectivity whose message does not mention the stub at all — the same shape as the TTGO pin that turned out to be wrong. So this board's stub axis is UNKNOWN, and it cannot be cited as evidence that stubless writing is broken.",
|
|
70
|
+
],
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
id: 'round_amoled', env: 'amoled', name: 'Round AMOLED', display: '1.8" 360x360 ST77916',
|
|
74
|
+
// `amoled_18` was documented in docs/esp32.md but absent from the CLI, so
|
|
75
|
+
// a user following the docs got "No online WiFi ESP32 target matches". The
|
|
76
|
+
// CLI already accepts the other flash.sh friendly names (box_40, ips_101,
|
|
77
|
+
// knob, ticker, s3pro), so this was a gap, not a deliberate exclusion.
|
|
78
|
+
aliases: ['amoled', 'amoled_18'],
|
|
79
|
+
chipFamily: 'ESP32-S3', flashSize: '8MB', flashMode: 'dio', flashFreq: '80m',
|
|
80
|
+
bootloaderOffset: 0x0, uploadBaud: 460800,
|
|
81
|
+
esptoolFlags: ['--before', 'no_reset', '--no-stub'],
|
|
82
|
+
before: 'no_reset', after: 'hard_reset', stub: false, nativeUsb: true,
|
|
83
|
+
ota: true,
|
|
84
|
+
webFlash: false, webFlashStatus: 'unverified',
|
|
85
|
+
webFlashVerified: '2026-08-22 · owned and live on Wi-Fi, but not USB-attached during the spike, and still not attached on 2026-08-23. Untested, not failing.',
|
|
86
|
+
notes: [
|
|
87
|
+
"`stub: false` here is INHERITED from platformio's --no-stub, never measured — same commit (2cf5fc754) and same caveat as ips_35.",
|
|
88
|
+
],
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
id: 'ips_10', env: 'ips10', name: 'IPS 10.1"', display: '10.1" 800x1280 JD9365',
|
|
92
|
+
aliases: ['ips10', 'ips_101'],
|
|
93
|
+
chipFamily: 'ESP32-P4', flashSize: '16MB', flashMode: 'dio', flashFreq: '40m',
|
|
94
|
+
bootloaderOffset: 0x2000, uploadBaud: 115200,
|
|
95
|
+
esptoolFlags: ['--before', 'no_reset', '--after', 'no_reset', '--no-stub'],
|
|
96
|
+
before: 'no_reset', after: 'no_reset', stub: false, nativeUsb: false,
|
|
97
|
+
ota: true,
|
|
98
|
+
webFlash: false, webFlashStatus: 'blocked',
|
|
99
|
+
webFlashVerified: '2026-08-23 · reaches download mode and then never answers SYNC. NOT a stub problem: SYNC precedes stub loading in both tools, so `stub: true` cannot reach this failure. Both serial directions are proven up (see notes); what does not answer is the ROM loader itself.',
|
|
100
|
+
notes: [
|
|
101
|
+
'ESP32-P4: the bootloader lives at 0x2000, not 0x0.',
|
|
102
|
+
'Download mode IS reached: `boot:0x307 (DOWNLOAD(USB/UART0/SPI))` followed by `waiting for download`, read over this same CH340 UART. So chip->host is UP in download mode — the banner arrived on it. esptool.py says "The serial TX path seems to be down"; that sentence is esptool guessing from a failed round trip, and it is wrong here. It was carried in this field as a finding until 2026-08-23; do not carry it again.',
|
|
103
|
+
'host->chip is up too: the identical open-and-write path gets 1403 bytes back from the running app. That contrast is the measurement, not the write itself — `drain()` times out on this adapter in BOTH states, so the timeout is a node-serialport/CH340 artifact and is evidence of nothing. Reading it as "the bytes never left" is a wrong answer this board hands out for free.',
|
|
104
|
+
'Yet SYNC returns ZERO bytes: 5 tries from esptool.py 5.2.0, 3 more from a hand-built SYNC frame on a port already proven to be in download mode. The remaining suspect is the ROM download channel itself. The banner lists USB first, and this board has no cable on the P4 native USB port — that is where the next attempt goes.',
|
|
105
|
+
'Only esptool.py UnixTightReset reaches download mode here; ClassicReset reads 0 bytes at either delay. esptool-js implements ClassicReset and UsbJtagSerialReset ONLY, so no built-in esptool-js strategy can get this board there at all. Its CustomReset CAN: `D0|R0|D1|R1|D0|W100|D1|R0|W50|D0` reached download mode reproducibly. The load-bearing part is the PREAMBLE, not atomicity — a preamble-less atomic IO0+EN edge reads 0 bytes, which is the opposite of what the "set both lines together" rule predicts. Deliberately NOT wired up: entering download mode does not make the board writable while SYNC still fails, and a field claiming a capability nobody has is worse than an absent one.',
|
|
106
|
+
],
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
id: 'inkdeck', env: 'inkdeck', name: 'InkDeck', display: '7.5" 800x480 e-ink UC8179',
|
|
110
|
+
aliases: [],
|
|
111
|
+
chipFamily: 'ESP32-S3', flashSize: '8MB', flashMode: 'dio', flashFreq: '80m',
|
|
112
|
+
bootloaderOffset: 0x0, uploadBaud: 460800, esptoolFlags: [],
|
|
113
|
+
before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: true,
|
|
114
|
+
ota: true,
|
|
115
|
+
webFlash: true, webFlashStatus: 'verified',
|
|
116
|
+
webFlashVerified: EV +
|
|
117
|
+
'default_reset/stub · ESP32-S3 (QFN56) rev v0.2 · flash 16MB detected vs 8MB declared (BSP-correct) · 460800 ok. Connected on the DOWNLOAD-MODE node, which is a different device node from the running one.',
|
|
118
|
+
notes: [
|
|
119
|
+
'The XIAO ESP32-S3 Plus is physically 16MB, but its BSP bakes an 8MB flash-size field — 8MB is the correct declaration, not a mistake.',
|
|
120
|
+
'Pick the download-mode port, not the running one.',
|
|
121
|
+
],
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
id: 'ttgo_t_display', env: 'ttgo', name: 'TTGO T-Display', display: '1.14" 240x135 ST7789',
|
|
125
|
+
aliases: ['ttgo'],
|
|
126
|
+
chipFamily: 'ESP32', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
|
|
127
|
+
bootloaderOffset: 0x1000, uploadBaud: 115200, esptoolFlags: ['--no-stub'],
|
|
128
|
+
before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: false,
|
|
129
|
+
ota: true,
|
|
130
|
+
webFlash: true, webFlashStatus: 'verified',
|
|
131
|
+
webFlashVerified: EV +
|
|
132
|
+
'default_reset/stub · ESP32-D0WDQ6 rev 1 · 460800 not used (115200 pinned). ' +
|
|
133
|
+
'FULL END-TO-END on 2026-08-23: wrote agentdeck-ttgo_t_display-merged.bin from ' +
|
|
134
|
+
'esp32-v1.0.7 in 138.1s, MD5 verified against the chip, and the board reported ' +
|
|
135
|
+
'itself as ttgo_t_display 1.0.7 (1958da41) — the first post-write boot check in ' +
|
|
136
|
+
'this fleet to pass. Both --no-stub and stub CONNECT here, which is why it was ' +
|
|
137
|
+
'pinned --no-stub; connecting is not writing, and stubless it could not be ' +
|
|
138
|
+
'written at all. With the stub the flash id reads 16MB, so the size guard is ' +
|
|
139
|
+
'available rather than degraded.',
|
|
140
|
+
notes: [
|
|
141
|
+
'stub: true while esptoolFlags still carries --no-stub, and that is deliberate. '
|
|
142
|
+
+ 'The two describe DIFFERENT TOOLS: `stub` drives esptool-js (the browser flasher '
|
|
143
|
+
+ 'and `agentdeck esp32 flash`), esptoolFlags mirrors esp32/platformio.ini upload_flags '
|
|
144
|
+
+ 'for esptool.py, and the board-matrix gate cross-checks only the latter pair. '
|
|
145
|
+
+ 'Stubless, esptool-js CANNOT WRITE this board at all: compressed dies at "Failed to '
|
|
146
|
+
+ 'enter compressed flash mode" and uncompressed one step later at "Failed to enter '
|
|
147
|
+
+ 'Flash download mode", both before a byte lands (measured 2026-08-23). With the stub '
|
|
148
|
+
+ 'it writes and boots end-to-end. The platformio pin is left alone because an '
|
|
149
|
+
+ 'esptool.py upload was NOT re-measured — changing it on evidence from another tool '
|
|
150
|
+
+ 'is the guess this note exists to avoid.',
|
|
151
|
+
'Stubless SPI flash-id reads return 0xffffff on this board, degrading the size guard '
|
|
152
|
+
+ 'to chip-family only; with the stub the id reads 16MB and the guard is available.',
|
|
153
|
+
],
|
|
154
|
+
},
|
|
155
|
+
{
|
|
156
|
+
id: 'ulanzi_tc001', env: 'led8x32', name: 'Ulanzi TC001', display: '32x8 WS2812B matrix',
|
|
157
|
+
aliases: ['led8x32'],
|
|
158
|
+
chipFamily: 'ESP32', flashSize: '8MB', flashMode: 'dio', flashFreq: '80m',
|
|
159
|
+
bootloaderOffset: 0x1000, uploadBaud: 115200, esptoolFlags: [],
|
|
160
|
+
before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: false,
|
|
161
|
+
ota: true,
|
|
162
|
+
webFlash: true, webFlashStatus: 'verified',
|
|
163
|
+
webFlashVerified: EV + 'default_reset/stub · ESP32-D0WD rev 1 · flash 8MB',
|
|
164
|
+
notes: [
|
|
165
|
+
'Flash size MUST be 8MB — the 4MB default leaves the bootloader misbehaving (GPIO15 buzzer stuck HIGH, no display).',
|
|
166
|
+
'This board does NOT answer device_info_request: its CH340 TX is hardware-broken. Verify a flash by the matrix render plus Wi-Fi registration, never by a serial probe.',
|
|
167
|
+
],
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
id: 't_embed', env: 't_embed', name: 'T-Embed CC1101', display: '1.9" 320x170 ST7789',
|
|
171
|
+
aliases: ['tembed', 'knob'],
|
|
172
|
+
chipFamily: 'ESP32-S3', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
|
|
173
|
+
bootloaderOffset: 0x0, uploadBaud: 460800, esptoolFlags: [],
|
|
174
|
+
before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: true,
|
|
175
|
+
ota: true,
|
|
176
|
+
webFlash: false, webFlashStatus: 'unverified',
|
|
177
|
+
webFlashVerified: '2026-08-22 · no auto entry into download mode; esptool.py 5.1.2 (the PlatformIO-vendored tool-esptoolpy build, not a PyPI release) fails identically ("No serial data received"), so this is the board, not esptool-js. Needs a physical BOOT press to verify.',
|
|
178
|
+
notes: [
|
|
179
|
+
'Native USB CDC needs esptool\'s NORMAL reset — copying the no_reset/no-stub flags from the CH340 envs made every upload fail (2026-07-26).',
|
|
180
|
+
],
|
|
181
|
+
},
|
|
182
|
+
{
|
|
183
|
+
id: 't_display_pro', env: 't_display_pro', name: 'T-Display-S3-Pro', display: '2.33" 480x222 ST7796U',
|
|
184
|
+
aliases: ['tdisplaypro', 'ticker', 's3pro'],
|
|
185
|
+
chipFamily: 'ESP32-S3', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
|
|
186
|
+
bootloaderOffset: 0x0, uploadBaud: 230400, esptoolFlags: [],
|
|
187
|
+
before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: true,
|
|
188
|
+
ota: true,
|
|
189
|
+
webFlash: true, webFlashStatus: 'verified',
|
|
190
|
+
webFlashVerified: EV + 'default_reset/stub · ESP32-S3 (QFN56) rev v0.2 · flash 16MB · 230400 ok (the pinned rate held)',
|
|
191
|
+
notes: ['USB CDC corrupts the esptool stream above 230400 — stub + 230400 is the proven-stable combination.'],
|
|
192
|
+
},
|
|
193
|
+
{
|
|
194
|
+
id: 'esp32_c6_147', env: 'esp32_c6_147', name: 'Waveshare C6-LCD-1.47', display: '1.47" 172x320 ST7789',
|
|
195
|
+
aliases: [],
|
|
196
|
+
chipFamily: 'ESP32-C6', flashSize: '4MB', flashMode: 'dio', flashFreq: '80m',
|
|
197
|
+
bootloaderOffset: 0x0, uploadBaud: 460800, esptoolFlags: [],
|
|
198
|
+
before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: true,
|
|
199
|
+
// Single-app 4MB layout: no OTA slot, so USB is this board's ONLY update
|
|
200
|
+
// path. Stated here rather than inferred from an absent line in the CLI's
|
|
201
|
+
// OTA list, which is how it read before.
|
|
202
|
+
ota: false,
|
|
203
|
+
webFlash: false, webFlashStatus: 'unverified',
|
|
204
|
+
webFlashVerified: '2026-08-22 · not present on serial or Wi-Fi during the spike, and the only ESP32-C6 in the fleet, so the entire C6 path is unverified.',
|
|
205
|
+
notes: ['No OTA partitions — USB is the only way to update this board.'],
|
|
206
|
+
},
|
|
207
|
+
];
|
|
208
|
+
export const esp32BoardById = (id) => ESP32_BOARDS.find((b) => b.id === id);
|
|
209
|
+
/**
|
|
210
|
+
* alias / canonical id / env → the board it means.
|
|
211
|
+
*
|
|
212
|
+
* Built as a declaration rather than a top-level loop: this package is
|
|
213
|
+
* published with `sideEffects: false`, so import-time statements are work a
|
|
214
|
+
* bundler is allowed to delete (gated by shared/src/__tests__/no-side-effects.test.ts).
|
|
215
|
+
*/
|
|
216
|
+
export const ESP32_BOARD_BY_TARGET = Object.fromEntries(ESP32_BOARDS.flatMap((b) => [b.id, b.env, ...b.aliases].map((key) => [key, b])));
|
|
217
|
+
/**
|
|
218
|
+
* esptool reports a chip DESCRIPTION, not a family: "ESP32-D0WD (revision 1)",
|
|
219
|
+
* "ESP32-S3 (QFN56) (revision v0.2)". Order matters — every variant string also
|
|
220
|
+
* contains the substring "ESP32", so the classic case has to be the fallback or
|
|
221
|
+
* it swallows the whole family.
|
|
222
|
+
*/
|
|
223
|
+
export function esp32ChipFamilyOf(description) {
|
|
224
|
+
const d = description.toUpperCase();
|
|
225
|
+
if (/ESP32-S3/.test(d))
|
|
226
|
+
return 'ESP32-S3';
|
|
227
|
+
if (/ESP32-P4/.test(d))
|
|
228
|
+
return 'ESP32-P4';
|
|
229
|
+
if (/ESP32-C6/.test(d))
|
|
230
|
+
return 'ESP32-C6';
|
|
231
|
+
if (/ESP32-(S2|C2|C3|C5|C61|H2)/.test(d))
|
|
232
|
+
return 'other';
|
|
233
|
+
if (/ESP32/.test(d))
|
|
234
|
+
return 'ESP32';
|
|
235
|
+
return 'other';
|
|
236
|
+
}
|
|
237
|
+
/* --------------------------------------------------------------- flash guards
|
|
238
|
+
* These two rules decide whether it is safe to write to a board, so the browser
|
|
239
|
+
* flasher and the CLI must apply them IDENTICALLY — which makes them SSOT
|
|
240
|
+
* material, not per-surface helpers.
|
|
241
|
+
*/
|
|
242
|
+
/**
|
|
243
|
+
* esptool-js's `detectFlashSize()` silently returns `"4MB"` when it cannot
|
|
244
|
+
* decode the size id, so "4MB" means either a 4MB part or "no idea". Measured
|
|
245
|
+
* 2026-08-22: a TTGO T-Display read through the ROM loader (no stub) answers
|
|
246
|
+
* `0xffffff` and was reported as 4MB, while the same board with the stub reads
|
|
247
|
+
* `0x1840ef` → 16MB, and esptool.py reads 16MB either way.
|
|
248
|
+
*
|
|
249
|
+
* So the id is checked first and "unknown" is allowed to stay unknown.
|
|
250
|
+
*/
|
|
251
|
+
export function esp32FlashIdIsUsable(flashIdHex) {
|
|
252
|
+
if (!flashIdHex)
|
|
253
|
+
return false;
|
|
254
|
+
const n = Number.parseInt(flashIdHex, 16);
|
|
255
|
+
return Number.isFinite(n) && n !== 0xffffff && n !== 0x000000;
|
|
256
|
+
}
|
|
257
|
+
/**
|
|
258
|
+
* The flash-size guard is DIRECTIONAL.
|
|
259
|
+
*
|
|
260
|
+
* Declaring MORE flash than the part has is the brick: the bootloader header
|
|
261
|
+
* claims a geometry the chip cannot serve and the partition table is rejected.
|
|
262
|
+
* Declaring LESS is merely conservative — and on InkDeck it is mandatory, since
|
|
263
|
+
* the XIAO ESP32-S3 Plus is physically 16MB but its BSP bakes an 8MB field. An
|
|
264
|
+
* equality test fails that board for doing the correct thing.
|
|
265
|
+
*
|
|
266
|
+
* Returns undefined when the detected size is unknown; that is its own answer,
|
|
267
|
+
* not a pass and not a failure.
|
|
268
|
+
*/
|
|
269
|
+
export function esp32FlashSizeIsSafe(declared, detected) {
|
|
270
|
+
const mb = (s) => {
|
|
271
|
+
if (!s)
|
|
272
|
+
return undefined;
|
|
273
|
+
const m = /(\d+)\s*MB/i.exec(s);
|
|
274
|
+
return m ? Number(m[1]) : undefined;
|
|
275
|
+
};
|
|
276
|
+
const want = mb(declared);
|
|
277
|
+
const have = mb(detected);
|
|
278
|
+
if (want === undefined || have === undefined)
|
|
279
|
+
return undefined;
|
|
280
|
+
return want <= have;
|
|
281
|
+
}
|
|
282
|
+
/** The `--chip` argument esptool expects for a board's family. */
|
|
283
|
+
export const ESP32_ESPTOOL_CHIP = {
|
|
284
|
+
ESP32: 'esp32',
|
|
285
|
+
'ESP32-S3': 'esp32s3',
|
|
286
|
+
'ESP32-C6': 'esp32c6',
|
|
287
|
+
'ESP32-P4': 'esp32p4',
|
|
288
|
+
};
|
|
289
|
+
/** Chip ID `esptool image-info` prints, per family — used to self-check a merged image. */
|
|
290
|
+
export const ESP32_IMAGE_CHIP_ID = {
|
|
291
|
+
ESP32: 0,
|
|
292
|
+
'ESP32-S3': 9,
|
|
293
|
+
'ESP32-C6': 13,
|
|
294
|
+
'ESP32-P4': 18,
|
|
295
|
+
};
|
|
296
|
+
/** Where the partition table lives; also where the bootloader region ends. */
|
|
297
|
+
/**
|
|
298
|
+
* The reset that actually boots a board after a write, as an esptool-js
|
|
299
|
+
* `custom_reset` sequence.
|
|
300
|
+
*
|
|
301
|
+
* WHY THIS EXISTS. esptool-js's `after('hard_reset')` cannot boot these boards.
|
|
302
|
+
* Its non-USB-OTG implementation is, in full, `sleep(100); setRTS(false)` — a
|
|
303
|
+
* RELEASE with no ASSERT. That works only when the preceding step left EN
|
|
304
|
+
* asserted, which `--before default-reset` does and a finished `writeFlash`
|
|
305
|
+
* does not. So the chip is left parked in the flasher stub, the firmware never
|
|
306
|
+
* runs, and the post-write `device_info` read-back can never succeed.
|
|
307
|
+
*
|
|
308
|
+
* Measured 2026-08-23 with a non-destructive probe (connect exactly as the
|
|
309
|
+
* flash does, apply a candidate reset, ask the firmware to identify itself),
|
|
310
|
+
* with a firmware-identity guard so a concurrent write on the same board aborts
|
|
311
|
+
* the run instead of producing a confident wrong answer:
|
|
312
|
+
*
|
|
313
|
+
* sequence t_display_pro (0x303a/0x1001, native USB) 86box (0x1a86/0x7523, CH340)
|
|
314
|
+
* after('hard_reset') PARKED PARKED
|
|
315
|
+
* R1|W250|R0 booted PARKED
|
|
316
|
+
* D0|R1|W100|R0 booted (48s -> 5s) booted (39s -> 3s)
|
|
317
|
+
*
|
|
318
|
+
* `D0` IS LOAD-BEARING, and only one of the two boards shows it. Pulsing EN
|
|
319
|
+
* without first driving IO0 high leaves the CH340 board in download mode —
|
|
320
|
+
* indistinguishable, from the outside, from a board that failed to boot. The
|
|
321
|
+
* two adapter classes take different reset strategies inside esptool-js
|
|
322
|
+
* (UsbJtagSerialReset vs ClassicReset), so a sequence verified on one is not
|
|
323
|
+
* evidence for the other; this one is measured on both.
|
|
324
|
+
*
|
|
325
|
+
* Boards whose `after` is `no_reset` are deliberately excluded: ips_10 asks not
|
|
326
|
+
* to be reset and that is a property of the board, not an oversight.
|
|
327
|
+
*/
|
|
328
|
+
export const ESP32_POST_WRITE_RESET_SEQUENCE = 'D0|R1|W100|R0';
|
|
329
|
+
/**
|
|
330
|
+
* The sequence to run after writing `board`, or undefined when it must not be
|
|
331
|
+
* reset. Per-board override first, so a future board that needs different
|
|
332
|
+
* timing states it in the SSOT rather than in a flasher.
|
|
333
|
+
*/
|
|
334
|
+
export function esp32PostWriteResetSequence(board) {
|
|
335
|
+
if (board.postWriteReset !== undefined)
|
|
336
|
+
return board.postWriteReset || undefined;
|
|
337
|
+
return board.after === 'no_reset' ? undefined : ESP32_POST_WRITE_RESET_SEQUENCE;
|
|
338
|
+
}
|
|
339
|
+
export const ESP32_PARTITION_TABLE_OFFSET = 0x8000;
|
|
340
|
+
/** boot_app0 (the OTA-selection blob) offset. Absent, a board can boot a stale slot. */
|
|
341
|
+
export const ESP32_BOOT_APP0_OFFSET = 0xe000;
|
|
342
|
+
/** app0 — the first application slot. Same on every board here. */
|
|
343
|
+
export const ESP32_APP0_OFFSET = 0x10000;
|
|
344
|
+
/**
|
|
345
|
+
* There is deliberately no `force` parameter.
|
|
346
|
+
*
|
|
347
|
+
* Writing a 16MB-header image to an 8MB part, or an S3 image to a classic
|
|
348
|
+
* ESP32, is precisely how these boards are bricked — and the recovery for a
|
|
349
|
+
* bricked board is the very tool that refused. An override switch would make
|
|
350
|
+
* the guard advisory, and an advisory guard is the one that gets clicked
|
|
351
|
+
* through at 2am. Callers that legitimately need to bypass have esptool.
|
|
352
|
+
*/
|
|
353
|
+
export function esp32PreflightVerdict(input) {
|
|
354
|
+
const { board, surface, detectedChip, detectedFlashSize } = input;
|
|
355
|
+
if (surface === 'browser' && !board.webFlash) {
|
|
356
|
+
return { code: 'board-not-offered', mayWrite: false };
|
|
357
|
+
}
|
|
358
|
+
const detectedFamily = detectedChip ? esp32ChipFamilyOf(detectedChip) : undefined;
|
|
359
|
+
if (detectedFamily !== board.chipFamily) {
|
|
360
|
+
return { code: 'chip-mismatch', mayWrite: false, detectedFamily };
|
|
361
|
+
}
|
|
362
|
+
// The guard must check the value that will actually be WRITTEN. Concretely:
|
|
363
|
+
// the SSOT corrects a board down to 4MB, a pinned manifest still says 16MB,
|
|
364
|
+
// the part reports 8MB — `4 <= 8` passes while a 16MB header lands on an 8MB
|
|
365
|
+
// part, which is precisely the brick every other rule here exists to prevent.
|
|
366
|
+
//
|
|
367
|
+
// STRICT EQUALITY, NOT DIRECTIONAL, and deliberately so. Unlike the size rule
|
|
368
|
+
// below, these two values are not "declared vs actual": they are two
|
|
369
|
+
// descriptions of the SAME board from two sources that are supposed to agree
|
|
370
|
+
// (a release manifest, and this build's SSOT). A disagreement in either
|
|
371
|
+
// direction means they describe different boards and there is no way to tell
|
|
372
|
+
// which one is true.
|
|
373
|
+
//
|
|
374
|
+
// It is also the ONLY size check left when the flash id is unreadable — a
|
|
375
|
+
// stubless TTGO answers 0xffffff, `esp32FlashSizeIsSafe` returns undefined,
|
|
376
|
+
// and the size axis goes unchecked. Loosening this to a directional test
|
|
377
|
+
// would remove the sole guard in exactly the case with the least information.
|
|
378
|
+
//
|
|
379
|
+
// The cost is a release-ordering constraint, not a defect: after any SSOT
|
|
380
|
+
// flash-size change, the browser flasher refuses against the previously
|
|
381
|
+
// deployed release until Pages redeploys with the new manifest. Cut the esp32
|
|
382
|
+
// release, then push master. See RELEASING.md.
|
|
383
|
+
const { imageGeometry } = input;
|
|
384
|
+
if (imageGeometry &&
|
|
385
|
+
(imageGeometry.flashSize !== board.flashSize || imageGeometry.chipFamily !== board.chipFamily)) {
|
|
386
|
+
return { code: 'image-geometry-mismatch', mayWrite: false, detectedFamily };
|
|
387
|
+
}
|
|
388
|
+
const sizeSafe = esp32FlashSizeIsSafe(board.flashSize, detectedFlashSize);
|
|
389
|
+
if (sizeSafe === false)
|
|
390
|
+
return { code: 'flash-too-small', mayWrite: false, detectedFamily };
|
|
391
|
+
// Unknown is its own answer, and it is a PASS: the merged image bakes its
|
|
392
|
+
// flash-size field at build time from this same SSOT and CI asserts it with
|
|
393
|
+
// `esptool image-info`, so the geometry is already correct in the bits. What
|
|
394
|
+
// is lost is the runtime cross-check, and that has to be said in the UI
|
|
395
|
+
// rather than quietly downgraded to a full pass.
|
|
396
|
+
if (sizeSafe === undefined)
|
|
397
|
+
return { code: 'ok-unknown-flash', mayWrite: true, detectedFamily };
|
|
398
|
+
return { code: 'ok', mayWrite: true, detectedFamily };
|
|
399
|
+
}
|
|
400
|
+
//# sourceMappingURL=esp32-boards.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"esp32-boards.js","sourceRoot":"","sources":["../src/esp32-boards.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -12,6 +12,7 @@ export * from './pairing-code.js';
|
|
|
12
12
|
export * from './mdns-identity.js';
|
|
13
13
|
export * from './timeline.js';
|
|
14
14
|
export * from './subagent-activity.js';
|
|
15
|
+
export * from './esp32-boards.js';
|
|
15
16
|
export * from './model-provider.js';
|
|
16
17
|
export * from './timeline-icons.js';
|
|
17
18
|
export * from './timeline-label.js';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -12,6 +12,7 @@ export * from './pairing-code.js';
|
|
|
12
12
|
export * from './mdns-identity.js';
|
|
13
13
|
export * from './timeline.js';
|
|
14
14
|
export * from './subagent-activity.js';
|
|
15
|
+
export * from './esp32-boards.js';
|
|
15
16
|
export * from './model-provider.js';
|
|
16
17
|
export * from './timeline-icons.js';
|
|
17
18
|
export * from './timeline-label.js';
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}
|