HARMONIZE-wave1
Wave 1 harmonization
Done 2026-10-10 over the 13 wave-1 pages, from manuals/REVIEW-wave1.md sections 1 to 4. The three descriptor-* pages were not edited. Line numbers are those of the page before this pass, as in the review (cat -n). Quotes are shortened with "..." where the cell would otherwise run long. Rules applied throughout: no em-dashes, no names, no chat quotes, exact firmware strings, and the new STYLE.md Vocabulary rule (the machine engraves; jobs are restarted or resumed).
Single statements and where they live
| Item (REVIEW section 2) | The one statement | Owner page | Basis |
|---|---|---|---|
| 1 Power | The firmware starts only on a PD offer of 20 V to 28 V at 3 A or more; buy 20 V or 28 V at 5 A (100 W or 140 W), as the company recommends. Check: whether a 20 V 3 A supply runs a full job | power-and-first-start#power | research/BRIEF.md power correction; device-screen-map 1.1 and 5 item 4; SYNTHESIS F10 |
| 2 " (UNLOCKED)" | Added unless secure boot is on and the SeedHammer key is the only valid boot key | security-faq#unlocked | gui/gui.go:2370-2373, platform_sh2.go:712-739 (security-faq bench block) |
| 3 Reproducible builds | README: "designed to be deterministic", "should match"; Check: not yet run for v1.4.3 | security-faq#reproduce | firmware README "Reproducible builds" |
| 4 Power draw | One owner's 1 s meter recollection, "says nothing about the supply you need" | hardware-and-spares#heat-noise | SYNTHESIS Q42 (community) |
| 5 Board plugs | Check: which plugs and how many (company: three; repo PCB has more) | hardware-and-spares#board | SYNTHESIS Q45; mainboard.kicad_pcb (security-faq bench note) |
| 6 Test plate | "the test plate that came with the machine, if yours came with one"; Check: whether v1.4.3-era units ship one | engraving-quality#dry-run | SYNTHESIS Q40; TEAM 1038 hedged |
| 7 Restart on a partly engraved plate | Check: whether the restarted job lands on the first strikes, or a blank plate is needed | troubleshooting#retry | no source settles it (REVIEW section 5 item 8) |
| 8 Retry after "Engraving failed." | In the source a retry homes the head and continues the job; Check: on a machine | troubleshooting#retry | device-screen-map 1.7 (gui/engraver.go:148-157) |
| 9 NFC Tools error at the end of a write | Emulated tag advertises FWI 8 (about 77 ms); "An error shown by NFC Tools after the write is harmless when the machine shows the next screen" | nfc-tools-transfer#troubleshooting | research/BRIEF.md bench fact (owner bench, stock v1.4.3) plus nfc/type4/type4.go |
| 10 Desktop NFC writer | Owners report a scan error and a beep every second and attribute it to the tag ID changing; cause not confirmed; Check | capability-sheet#tags | SYNTHESIS D row "Desktop NFC writer", status open |
11 Sparrow ?bh= workaround |
Delete everything from ? to the end; a Coldcard-format export avoids the suffix but engraves no child path |
nfc-tools-transfer#prepare (step), multisig-and-fit#differences (cost) | research/BRIEF.md ("Manuals must say: remove everything from ?"); hardware-signers key finding 7 |
| 12 SeedQR form | Standard numeric form per the source; Check: on a plate | titles-and-plate-layout#seed | device-screen-map 3 (seedqr.go); SYNTHESIS F18 |
| 13 codex32 over NFC | Per the firmware source: straight to "Engrave Plate", no way back, silent return if it cannot be laid out; Check: on a machine | capability-sheet#shares | research/BRIEF.md; device-screen-map 1.6; SYNTHESIS F19 |
| 14 Passphrase and seed-to-descriptor check | Nothing compares a seed with a descriptor in the source; Check: on a machine | multisig-and-fit#descriptor | SYNTHESIS F1, F2 |
| 15 Status line position | "for about one second"; Check: where it sits | power-and-first-start#start-screen | device-screen-map 1.2 ("above the version") disagrees with the code reading (bottom centre) |
| 16 What v1.4.1 and v1.4.2 left out of the QR | The master fingerprints and the origin paths before each key; like v1.4.3, no checksum | multisig-and-fit#differences | v1.4.3 release note "The checksum is still stripped" (research/hardware-signers.md section 4) |
| 17 v1.4.2 downgrade | Mentioned once, with its Check | firmware-upgrade#troubleshooting | SYNTHESIS F (downgrade note) |
| 18 Hardware version example | "Hardware: v1.5" as the example on every page | power-and-first-start#start-screen | device-screen-map 1.2 (HardwareVersion "v1." + board version) |
| 19 Dice, last word | Compute only the last (checksum) word with an offline device you trust | security-faq#seeds | SYNTHESIS Q31 |
Changes
| Page | Line | Before | After | Source |
|---|---|---|---|---|
| power-and-first-start | 25-27 | gate paragraph only | same, plus "It tests the supply again when the engraver starts ("engraver: not enough power available")." | device-screen-map 1.1, 5 item 4 |
| power-and-first-start | 29-30 | "It must list 20V or 28V at 5 A (100 W or 140 W). The watt figure on the box does not prove either..." |
"it must list 20V or 28V at 5 A. Some cheap chargers sold as 95 W or 28 V never deliver them." |
REVIEW 4 (length) |
| power-and-first-start | 34 | "use the port that offers 28 V or 20 V at 5 A" | "use the port that offers 20 V or 28 V at 5 A"; "cut power" became "drop power" | REVIEW 2.1; STYLE Vocabulary |
| power-and-first-start | 36-39 | cable bullet with fallback detail; separate mains and computer-port bullets | cable bullet shortened (fallback stays in troubleshooting); mains and computer port merged | REVIEW 4 |
| power-and-first-start | 41-47 | Important: Apple 140 W paragraph; "Check: the firmware accepts a 20 V offer at 3 A (60 W)... plan on 5 A." | "Buy a supply that offers 20 V or 28 V at 5 A (100 W or 140 W), as the company recommends. Check: whether a 20 V 3 A (60 W) supply... runs a full job."; Apple charger as a one-line pointer to troubleshooting | REVIEW 2.1; BRIEF power correction; SYNTHESIS F10 |
| power-and-first-start | 51-52 | "Plug the cable into the supply, then into the USB-C port of the machine. Check: where the port sits..." | two bullets, one action each; port and switch Check kept in the bench block | REVIEW 4 (one action per bullet) |
| power-and-first-start | 54-55 | "The screen can come up before or while the head moves." | removed (bench item kept) | REVIEW 4 |
| power-and-first-start | 67-68 | "A board without secure boot adds " (UNLOCKED)"..." | "The firmware adds " (UNLOCKED)" to the hardware line unless secure boot is on and the SeedHammer key is the only valid boot key, see Read the lock mark" | REVIEW 2.2, 3 |
| power-and-first-start | 69 | "...Upgrade it to v1.4.3." | "...not a newer release, see Firmware upgrade#version" | REVIEW 3 (version row) |
| power-and-first-start | 75-76 | "a status line shows near the bottom centre of the screen for about one second" | "a status line shows for about one second... Check: where the status line sits." | REVIEW 2.15; device-screen-map 1.2 |
| power-and-first-start | 80 | "Every control is on the touchscreen: the three tab positions..." | removed (the bullets say it) | REVIEW 4 |
| power-and-first-start | 91 | "Insert a blank plate and close the lock. Check: how the lock opens..." | bullet without Check; Check moved into the section intro | REVIEW 4 |
| power-and-first-start | 95-97 | countdown bullet and screen saver bullet | merged: "The screen saver can cover it; the machine keeps engraving." | REVIEW 4 |
| power-and-first-start | 100 | "To continue from where it stopped, hold the hammer tab." | adds "The back arrow on a paused job drops the stop point, see Retry and restart" | device-screen-map 1.7; REVIEW 3 row 1 |
| power-and-first-start | after 103 | none | bullet: "Engraving failed." with "Hold button to retry." means the job stopped, links troubleshooting#retry and #engraving | task 1 (retry owned by troubleshooting) |
| power-and-first-start | before 108 | none | new section "What to read next {#next}": firmware, power, seed, descriptor, rehearse a restore, with links. Placed before #troubleshooting so troubleshooting stays last (STYLE rule 5) | REVIEW 1 (Q01); task 4 |
| power-and-first-start | 110-140 | fixes "20 V or 28 V at 5 A (100 W or 140 W)", "28 V or 20 V" | every fix reads "a supply that offers 20 V or 28 V at 5 A"; items shortened | REVIEW 2.1 |
| power-and-first-start | 122-125 | "...Check: whether a second run on the same plate lands on the first strikes." ("cut power") | "...see Retry and restart" ("dropped power") | REVIEW 2.7; task 1; STYLE Vocabulary |
| power-and-first-start | 132-134 | "Error: stepper: homing timed out" item | removed (troubleshooting#engraving and engraving-quality#pulleys own it) | REVIEW 3 |
| power-and-first-start | 139-140 | "shallower than the sample plate... Use a port that offers 28 V" | "shallower than the test plate that came with the machine... 28 V at 5 A" | REVIEW 2.6 |
| power-and-first-start | bench | items as drafted | 60 W item notes the gate and advice; start-screen item notes the v1.5 example and the status-line disagreement; re-run item points to troubleshooting#retry; new item: test plate in the box; "Power cut" became "Power loss" | REVIEW 2, 5 |
| nfc-tools-transfer | 3, 9 | long description and intro | shortened | REVIEW 4 (202 lines) |
| nfc-tools-transfer | 11 | alert explaining the clipboard risk of NFC seed words | "Use NFC Tools for descriptors only; for seeds see Enter a seed on the touchscreen." | REVIEW 4 |
| nfc-tools-transfer | 13 | note with the multisig loss sentence | "...Keep it out of email, chat and cloud notes." | REVIEW 4 |
| nfc-tools-transfer | 19 | "...Current on 2026-10-10: NFC Tools 3.4... Check: the labels on these versions." | "Check: the labels on NFC Tools 3.4 (iOS) and 9.8 (Android)." | REVIEW 4 |
| nfc-tools-transfer | 20, 106-110 | wallet links; section "Other ways in" (tags, emulation, Coldcard) | requirements bullet "No phone? A Coldcard sends on its own: Coldcard. Tags and desktop writers: capability sheet."; section removed | REVIEW 3 (tags row: 2-line pointer) |
| nfc-tools-transfer | 29 | bare key bullet with xpub, zpub, ypub detail | "Never send a bare key such as an xpub: send a descriptor with key origins (why)" |
REVIEW 3 (bare key row) |
| nfc-tools-transfer | 34-36 | whitespace, ? and airplane bullets |
same steps, shorter; the ? step stays here as the owner |
REVIEW 3 (?bh= row) |
| nfc-tools-transfer | 47, 53-54, 66 | "Tap OK. Check: whether OK or < Write keeps the record."; "Check: the sheet's exact wording."; "Tap the back arrow. Check: ..." | bullets without Check; covered by the requirements Check and the bench block | REVIEW 4 (one action per bullet) |
| nfc-tools-transfer | 80-84 | five #hold bullets (Samsung path, distance Check) | three bullets; distance stays in bench | REVIEW 4 |
| nfc-tools-transfer | 93 | "The title is shown, not engraved." | "...shown, not engraved (why)" linking titles#titles | REVIEW 3 (titles row) |
| nfc-tools-transfer | 101 | "...NFC Tools can also report an error at the end of a write although the machine got the data..." | "Phone success only means the bytes arrived. Trust the machine..."; error statement moved to the troubleshooting item | REVIEW 2.9 |
| nfc-tools-transfer | 102-103 | layout list; plate spelling detail | links to multisig-and-fit#fit and #differences | REVIEW 3 (fit, differences rows) |
| nfc-tools-transfer | 104 | "...Check: the delete control on each platform." | Check moved to bench | REVIEW 4 |
| nfc-tools-transfer | 114-116 | two items (never finishes; Android nothing) | one item | REVIEW 4 |
| nfc-tools-transfer | 122-129 | full "Unknown format" cause list | page-specific causes (URL record, whitespace) and a link to troubleshooting#nfc | REVIEW 3 row 2 |
| nfc-tools-transfer | 131 | "Two causes are reported for stock v1.4.3... Check: which cause applies on stock firmware." | "...on stock v1.4.3 its emulated tag promises an answer within about 77 ms (FWI 8), and one step of a large write sometimes takes longer while the screen redraws. An error shown by NFC Tools after the write is harmless when the machine shows the next screen, "Engrave Descriptor"." | REVIEW 2.9; research/BRIEF.md bench fact; type4.go |
| nfc-tools-transfer | 133, 135 | "Scan error" overflow detail; "Too Large" explanation | one sentence each with a link (troubleshooting#nfc, multisig-and-fit#fit) | REVIEW 3 row 4 |
| nfc-tools-transfer | 139 | desktop writer item | removed (capability-sheet#tags owns it; pointer in requirements) | REVIEW 2.10, 3 |
| nfc-tools-transfer | bench | "Write error cause on stock firmware... tell an early session end... apart" | "Write error frequency..."; cause now stated from BRIEF; tag, emulation and writer items marked as moved to capability-sheet#tags | REVIEW 2.9 |
| seed-entry | 9 | intro | shortened | REVIEW 4 (169 lines) |
| seed-entry | after 11 | none | alert: "A Coldcard can send its seed words and codex32 shares over NFC, and the v1.4.3 source accepts them into the seed flow. The secret would then travel over radio. Never tap a signer to the machine to engrave a seed. For a Coldcard descriptor, see Coldcard." | task 4; research/BRIEF.md direct signer tap; hardware-signers key finding 9 |
| seed-entry | 16, 18 | separate plate and hearing-protection bullets | merged | REVIEW 4 |
| seed-entry | 20 | "let a signing device compute the last (checksum) word first" | "compute only the last (checksum) word with an offline device you trust" | REVIEW 2.19; SYNTHESIS Q31 |
| seed-entry | 22 | "The machine has no physical buttons for its menus..." | "There are no physical menu buttons: the controls are the screen keys and three touch buttons on the right edge." | REVIEW 4 |
| seed-entry | 28 | "Tap the checkmark (bottom right). The back arrow (top right) returns to the start screen." | bullet with one action; back arrow as a sentence below | REVIEW 4 (one action per bullet) |
| seed-entry | 66-81 | full "Engrave Plate" procedure, pause, back-from-paused Check, failure and retry Check | two bullets, the seed-specific back arrow, link to power-and-first-start#plate | REVIEW 3 row 1; 2.7; 2.8 |
| seed-entry | 83-93 | plate anatomy bullets incl. "SeedQR... standard numeric form... Check" | two lines and a link to titles-and-plate-layout#seed | REVIEW 3 (seed plate row); 2.12 |
| seed-entry | 97 | "A passphrase does not stop the engraving, but..." | sentence removed; the descriptor bullet keeps its Check | REVIEW 2.14 |
| seed-entry | 99-101 | Electrum, aezeed and word-count bullets | shorter; aezeed and word counts merged | REVIEW 4 |
| seed-entry | 102 | "...never send one from a phone to get around the menu. Check: what v1.4.3 does with a codex32 share sent over NFC." | "...never send one over NFC to get around the menu, see Shares" | REVIEW 2.13, 3 (codex32 row) |
| seed-entry | 117, 119, 123 | troubleshooting items | shortened | REVIEW 4 |
| seed-entry | 121 | "...engrave from the beginning. See Troubleshooting#power. Check: whether the partly engraved plate can be used..." | "...type the seed again and restart the job, see Retry and restart" | REVIEW 2.7; task 1; STYLE Vocabulary |
| seed-entry | bench | stop/pause item; codex32 item "Until this passes the page states none of it" | stop/pause points to troubleshooting#retry; codex32 points to capability-sheet#shares; new Coldcard seed-direction item (hardware-signers bench 19) | REVIEW 2.7, 2.13; task 5 |
| firmware-upgrade | 9, 11, 16, 20 | intro; note with "The maker states..."; cable bullet; Mac paragraph | shortened; Mac reasoning kept once in the troubleshooting item as a company statement | REVIEW 4 (165 lines) |
| firmware-upgrade | 18 | "a USB-C PD supply that offers 20 V or 28 V at 3 A or more. None comes in the box..." | "the machine's USB-C PD supply, see Choose the power supply" | REVIEW 2.1 |
| firmware-upgrade | 32 | beta numbering with full release list | shortened, same facts | REVIEW 4 |
| firmware-upgrade | 33 | "leave the master fingerprints and the derivation paths before each key out..." | "leave the master fingerprints and the origin paths before each key out..." | REVIEW 2.16 |
| firmware-upgrade | 34 | "...secure boot is off, or a second key has been added." | security-faq definition, word for word | REVIEW 2.2 |
| firmware-upgrade | 49, 53, 61 | upgrade-mode, no-button and button paragraphs; "maker's white-label data" | shortened; "company's"; pre-v1.4.2 Check kept in troubleshooting | REVIEW 4 |
| firmware-upgrade | 69, 71-72 | "The control board has two buttons... The maker has described... lower left... upper right above the NFC area." | "controller board"; labels kept; "The company places the firmware button on the underside near the hammerhead. Check: labels and positions on a shipped board." (left/right detail stays in the bench item) | REVIEW 4 (terminology, length) |
| firmware-upgrade | 76, 85, 89 | copy bullet; drive reappears; note | shortened | REVIEW 4 |
| firmware-upgrade | 91-95 | own-key paragraph; README "should match... bit for bit" | one paragraph linking security-faq#own-key and #reproduce | REVIEW 2.3, 3 (UNLOCKED row) |
| firmware-upgrade | 99 | "the maker says... The maker's workaround" | "The company states... Its workaround" | REVIEW 4 (terminology) |
| firmware-upgrade | 103 | "Check: whether firmware older than v1.4.2 also shows the start screen..." | "...so the firmware started normally. Check: what firmware older than v1.4.2 does." | REVIEW 4 |
| firmware-upgrade | 105 | "...a USB-C PD supply that offers 20 V or 28 V at 3 A or more: connect one." | "Connect the power supply, see Power faults" | REVIEW 3 (power row) |
| firmware-upgrade | 107 | "Use a USB-C PD supply that offers 20 V or 28 V at 3 A or more... The maker recommends 100 W..." | "The supply does not offer 20 V to 28 V at 3 A or more. Use one that offers 20 V or 28 V at 5 A, see Choose the power supply." | REVIEW 2.1 |
| firmware-upgrade | 111 | connector-lock steps and screen saver note | link to troubleshooting#screen | REVIEW 3 (garbled display row) |
| firmware-upgrade | 113 | "The maker suggests v1.4.2..." | "The company suggests v1.4.2..."; QR wording as item 16; the only page that mentions the downgrade, with its Check | REVIEW 2.16, 2.17 |
| firmware-upgrade | bench | "control board", "maker" | "controller board", "company"; UNLOCKED and garbled-display owner notes | REVIEW 4 |
| multisig-and-fit | 3, 9, 13, 17-18, 21-22, 26, 28 | description, intro, descriptor note, requirements, plan text | shortened, same facts | REVIEW 4 (177 lines) |
| multisig-and-fit | 39-46 | six seed-entry steps incl. the X warning | one sentence and a link to seed-entry | REVIEW 3 row 1; 4 |
| multisig-and-fit | 52 | "If it contains ? (Sparrow adds...), delete everything from ? to the end..." |
"Prepare the text: nothing from ? on, no line break after it (how)" linking nfc-tools-transfer#prepare |
REVIEW 3 (?bh= row) |
| multisig-and-fit | 60 | "If NFC Tools reports an error after the write but the machine shows "Engrave Descriptor", the data arrived." | "An error shown by NFC Tools after the write is harmless when the machine shows the next screen, "Engrave Descriptor"." | REVIEW 2.9 |
| multisig-and-fit | 67 | "...Check: how an engraved plate sits face down in the lock, and whether the seed face takes marks." | "For the back of a seed plate, turn it over. Check: how it sits face down, and whether the seed face is damaged." | REVIEW 4; STYLE Vocabulary |
| multisig-and-fit | 67-69 | "Engrave Plate" steps | one bullet linking power-and-first-start#plate | REVIEW 3 row 1 |
| multisig-and-fit | 71 | "...A descriptor plate can be made on its own, and a seed that does not belong... does not stop either job. Check: both" | shorter, same Check | REVIEW 2.14 |
| multisig-and-fit | 73 | bare xpub detail | "Never send a key alone: a bare key loses its script and origin (why)" | REVIEW 3 (bare key row) |
| multisig-and-fit | 77-82 | fit intro and bullets incl. title detail | shorter; title bullet links titles#titles | REVIEW 3 (titles row) |
| multisig-and-fit | 100 | "Their QR code left out fingerprints, derivation paths and the checksum." | "Their QR code left out the master fingerprints and the origin paths before each key; like v1.4.3, it carried no checksum." | REVIEW 2.16; v1.4.3 release note via hardware-signers section 4 |
| multisig-and-fit | 106-116 | troubleshooting items; "Unknown format" list; write-error item | shorter; "Unknown format" keeps page-specific causes and links troubleshooting#nfc; write-error item removed (procedure bullet and nfc owner cover it) | REVIEW 3 row 2; 2.9 |
| multisig-and-fit | bench | fit, old-QR, bare-key and write-error items | ownership and wording notes added | REVIEW 2.16, 3 |
| capability-sheet | 10 and 23 other lines | **Check:** |
Check: ("Items marked "Check:" still need a test") |
REVIEW 4 (markup) |
| capability-sheet | 24, 27, 30 | At-a-glance rows | links added to multisig-and-fit#fit, #shares, titles#titles | REVIEW 3 (fit row: At-a-glance stays) |
| capability-sheet | 38-41 | "...offers 20 V to 28 V at 3 A or more... Check: which chargers boot and engrave reliably" | "a USB-C PD supply that offers 20 V or 28 V at 5 A (100 W or 140 W). The firmware itself starts on an offer of 20 V to 28 V at 3 A or more, see Choose the power supply." | REVIEW 2.1 |
| capability-sheet | 54-55 | "If the supply cannot offer 20 V to 28 V at 3 A, the screen stays black..." | "Power faults: Power supply and first start" | REVIEW 3 (power row) |
| capability-sheet | 81 | "...each for about one second, above the version text." | "...each for about one second." | REVIEW 2.15 |
| capability-sheet | 104-116 | six bare-key bullets | the same facts as a three-column table, owner of the bare-key hazard | REVIEW 4 (structure) |
| capability-sheet | 120 | "Do not send seed words from a phone; see the warning at the top." | "Do not send seed words from a phone or a signer, see Enter a seed on the touchscreen." | research/BRIEF.md direct signer tap |
| capability-sheet | 145-147 | ?bh= removal steps with Check |
link to nfc-tools-transfer#prepare | REVIEW 3 (?bh= row) |
| capability-sheet | 168-179 | second fit table by key count with Check | two-sentence summary and a link to multisig-and-fit#fit | REVIEW 3 (fit table row) |
| capability-sheet | 189-199 | bullets on h, child path, Coldcard import, titles |
three link bullets (titles#seed, multisig-and-fit#differences, titles#titles) | REVIEW 3 (differences, titles rows) |
| capability-sheet | 204-213 | codex32 bullets: decode Check on one line, silent return as fact; alert states no way back as fact; "cutting the power" | one bullet: "Per the firmware source... no way back; a share that cannot be laid out returns to "Backup Wallet" without a message. Check: all of this on a machine."; alert says "In the source, the back arrow... does not leave"; "unplugging the machine" | REVIEW 2.13; STYLE Vocabulary |
| capability-sheet | 224-227 | "A Coldcard push to stock v1.4.3 has not been tested here." | desktop-writer bullet (owner-reported, cause not confirmed, Check); Coldcard bullet links descriptor-coldcard | REVIEW 2.10; 1 (Q17 pointer) |
| capability-sheet | 231-233 | wallet table intro | adds links to the three wave-2 pages; table kept because descriptor-mobile-wallets links to #wallets | REVIEW 4; wave-2 link check |
| capability-sheet | 238 | "wallet name, cut to 20 characters" | "wallet name, shortened to 20 characters" | STYLE Vocabulary |
| capability-sheet | 254-304 | 13-item troubleshooting section | three items linking troubleshooting#nfc, multisig-and-fit#fit, troubleshooting and power#troubleshooting | REVIEW 3 (last row) |
| capability-sheet | bench | desktop writer, codex32, links, Coldcard, 60 W items; "cut at "?"" | owner notes added; "trimmed at "?"" | REVIEW 2.10, 2.13 |
| troubleshooting | 19-20 | link to firmware-upgrade | link to firmware-upgrade#version | REVIEW 3 (version row) |
| troubleshooting | 26-55 | five power paragraphs with bullets; fixes "28 V or 20 V", "a supply that offers 28 V"; "engrave again from the start on a blank plate" | gate and buying advice once, then a symptom, cause and fix table linking power-and-first-start#troubleshooting; every fix "20 V or 28 V at 5 A"; mid-job stop: "Restart the job, see Retry and restart" | REVIEW 2.1, 2.7, 3 (power row), 4 (tables) |
| troubleshooting | 59-69 | "Nothing happens" with five bullets | short paragraph and a link to nfc-tools-transfer | REVIEW 4 |
| troubleshooting | 75-81 | "The machine tells the phone to wait about 77 ms..."; separate part-way item | "An error shown by NFC Tools after the write is harmless when the machine shows the next screen..." with a link to the nfc owner; part-way item folded into the owner | REVIEW 2.9 |
| troubleshooting | 83-104 | "Unknown format" bullets; ?bh= bullet "For multisig, a Coldcard-format text export avoids this." |
cause and fix table (owner); ?bh= row: delete from ?, link nfc-tools-transfer#prepare; added rows for Format: P2SH-P2WSH and two-line receive and change descriptors |
REVIEW 2.11, 3 row 2; research/BRIEF.md; hardware-signers key finding 3; nfc-tools-transfer and capability lists |
| troubleshooting | 109-116 | "Scan error" with steps as bullets | one paragraph, same steps | REVIEW 4 |
| troubleshooting | 124-129 | "Too Large" full explanation | two sentences and a link to multisig-and-fit#fit | REVIEW 3 row 4 |
| troubleshooting | 137-145 | TEXT + QR, bare xpub and title items | one sentence each with links (multisig-and-fit#fit, capability-sheet#formats, titles#titles) | REVIEW 3 |
| troubleshooting | 150-152 | "...Update the Coldcard firmware. A phone with NFC Tools works as a fallback." | removed; link to descriptor-coldcard kept | REVIEW 3 (Coldcard details live on the wave-2 page) |
| troubleshooting | 154-159 | "The reported cause is that the machine changes its tag ID every second." and tag list | one sentence and a link to capability-sheet#tags | REVIEW 2.10, 3 (tags row) |
| troubleshooting | 163-172 | "Invalid Seed" fix as five bullets | one paragraph with a link to seed-entry#check | REVIEW 4 |
| troubleshooting | 187-190 | "Cut the power and start again" | "Unplug the power and start again" | STYLE Vocabulary |
| troubleshooting | 202-204 | paused-job paragraph | new subsection "Retry, resume and restart {#retry}": resume and leaving a paused job (source, device-screen-map 1.7); retry "In the firmware source a retry homes the head and continues the job. Check: on a machine..."; restart on a partly engraved plate "Check: whether the restarted job lands on the first strikes, or a blank plate is needed." | task 1; REVIEW 2.7, 2.8 |
| troubleshooting | 206-231 | homing, x/y-axis, buffer underrun items with bullets; "Hold the hammer button to retry; the job continues where it stopped." | error table; buffer underrun row "Retry, see above. Check: the exact text owners see"; "engraver unavailable" row moved here from engraving-quality | REVIEW 2.8, 3, 4 |
| troubleshooting | 233-271 | full repair procedures (cables, needle, dry run, belts, brass nut) and "engrave over the shipped test plate" | symptom, cause and a link each to engraving-quality (#needle, #dry-run, #belts, #brass-nut, #pulleys) | REVIEW 2.6, 3 (mechanics, dry-run rows), 4 |
| troubleshooting | 277-281 | codex32 behaviour as fact with Check at the end; "cut the power" | "Per the firmware source... no way back. Finish the engraving or unplug the machine. Check: on a machine." and a link to capability-sheet#shares | REVIEW 2.13; STYLE Vocabulary |
| troubleshooting | 299-304 | how-to-ask-for-help paragraph | "Your symptom is not on this page, or the fix did not help." cause and fix in the same format | REVIEW 4 |
| troubleshooting | bench | retry item; desktop writer; codex32; dry test; "job runs with no marks" | #retry ownership and re-run items; ?bh= note; Format: P2SH-P2WSH item; owner notes; "job runs without striking" |
task 1, 5 |
| recovery-from-plates | 3, 9, 11, 13, 17 | description, intro, alert, note, first bullet | shortened ("Look at both faces...") | REVIEW 4 (192 lines) |
| recovery-from-plates | 28 | "The QR code is a SeedQR (standard numeric form)." | "A SeedQR, standard numeric form per the source (Check: on a plate). Layout" | REVIEW 2.12 |
| recovery-from-plates | 35-36 | layout and title bullets | shorter; titles bullet links titles#titles | REVIEW 3 (titles row) |
| recovery-from-plates | 38-45 | four bullets on h, QR checksum, child path, old plates |
one paragraph for heirs and a link to multisig-and-fit#differences | REVIEW 3 (differences row: 2 lines and a link) |
| recovery-from-plates | 51-63 | scan remedies and typing bullets | same remedies, shorter | REVIEW 4 |
| recovery-from-plates | 67-72 | "Check: the menu label..."; "click Edit... and paste or type... Sparrow names this route itself: ..."; button and tab Checks | Edit and paste as two bullets; the three Checks in one line below the steps | REVIEW 4 (one action per bullet) |
| recovery-from-plates | 77, 82-85 | coordinator paragraph with Sparrow quote; signer bullets | shorter | REVIEW 4 |
| recovery-from-plates | 91 | "left out the master fingerprints, the origin paths before each key and the checksum... Reports differ on whether text plates... were shortened too" | "left out the master fingerprints and the origin paths before each key; like v1.4.3, it carried no checksum. The addresses are the same. Whether text plates were shortened is not settled." | REVIEW 2.16 |
| recovery-from-plates | 93-95 | old-plate bullets incl. "The path is right when..." | shorter | REVIEW 4 |
| recovery-from-plates | 100 | ?bh= explanation, Sparrow page link, "Larger quorums may no longer fit" |
"...replace every 00000000 first, or that key loses its origin. Prepare the export as in Prepare the text." |
REVIEW 3 (?bh= row) |
| recovery-from-plates | 104 | "The machine prints steel and nothing more" | "The machine engraves steel and nothing more" | STYLE Vocabulary |
| recovery-from-plates | 106-126 | rehearsal and troubleshooting items | shorter, same facts | REVIEW 4 |
| recovery-from-plates | all | **Check:** (8) |
Check: |
REVIEW 4 (markup) |
| security-faq | 79-80 | ""Hardware: v1.N"" | "a hardware line such as "Hardware: v1.5"" | REVIEW 2.18 |
| security-faq | 118-119 | "...physical NFC tags (ISO 15693 and ISO 14443A Type 2). Check: reading a physical tag on a machine." | "...see NFC tags, cards and desktop writers" | REVIEW 3 (tags row) |
| security-faq | 131 | "20 to 28 V at 3 A or more" | "20 V to 28 V at 3 A or more" | REVIEW 2.1 |
| security-faq | 133-150 | "Cut the NFC link {#nfc-cut}", "treat the cut as permanent", "after the cut", "Cut the thin link", "uncut" | "Disconnect the NFC chip {#nfc-off}" (no page linked the old anchor), "treat this as permanent", "with the jumpers open", "Sever the thin link", "intact"; the silkscreen text "NFC CUT HERE" is quoted unchanged | STYLE Vocabulary |
| security-faq | 172-173 | "Do not send seed words from a phone..." | "Do not send seed words from a phone or a signer... or travel over radio from a signer such as a Coldcard." | task 4; research/BRIEF.md direct signer tap |
| security-faq | 181-182, 243-245 | "compute only the last word with a separate offline tool you trust" | "compute only the last (checksum) word with an offline device you trust" | REVIEW 2.19 |
| security-faq | 203-204 | "Check: a codex32 share sent as NFC text is accepted on v1.4.3." | "What the machine does with one: Shares" | REVIEW 2.13 |
| security-faq | 235-238 | "On a computer port without a 20 V USB-PD offer the machine restarts into upgrade mode. Connect the machine's own power supply." | "First rule out power: connect the machine's own supply, see Power supply and first start." | REVIEW 3 (power row) |
| security-faq | 240 | "after the NFC cut" | "with the NFC jumpers open" | STYLE Vocabulary |
| security-faq | all | **Check:** (16) |
Check: |
REVIEW 4 (markup) |
| security-faq | notes, bench | "Left out on purpose: sending a seed straight from a signer..."; codex32 and tag items; "after the cut" | note records the seed-entry warning; owner notes; "with the jumpers open" | task 4, 5 |
| hardware-and-spares | 9, 11, 17-18 | intro, alert, requirements | shortened | REVIEW 4 (185 lines) |
| hardware-and-spares | 16 | "as "Hardware: v1." and a number" | "for example "Hardware: v1.5"" | REVIEW 2.18 |
| hardware-and-spares | 25, 73, 104 | "The team aimed...", "as the team advises", "The maintainers have said" | "The company..." | REVIEW 4 (terminology) |
| hardware-and-spares | 28-29 | needle-sticking steps | merged into one bullet linking engraving-quality#mechanics | REVIEW 3 (mechanics row) |
| hardware-and-spares | 35 | "...The machine starts only on a USB-C supply that offers 20 to 28 V at 3 A or more, see..." | "...says nothing about the supply you need (power)" | REVIEW 2.1, 2.4 |
| hardware-and-spares | 36 | "To cut the noise, one owner..." | "One owner reduced the noise..." | STYLE Vocabulary |
| hardware-and-spares | 54-61 | "It comes out by three plugs"; "Disconnect the three plugs"; "Check: ...the three plugs are J1, J5, J8" | "It unplugs..."; "Disconnect the plugs from the board."; "Check: which plugs, and how many. The company describes three; the repo design has two 4-pin motor plugs (J1 X, J5 Y), the 2-pin solenoid plug (J8), the display's flat cable and two 3-pin connectors." |
REVIEW 2.5; SYNTHESIS Q45; security-faq bench note |
| hardware-and-spares | 63-64 | alt and capture "its three plugs" | "its plugs"; capture lists every plug | REVIEW 2.5 |
| hardware-and-spares | 69 | button label note | "The two buttons on the board are described under the firmware button." | REVIEW 3 (button row) |
| hardware-and-spares | 75 | "Push each of the three plugs fully home." | "Push each plug fully home." | REVIEW 2.5 |
| hardware-and-spares | 78-85 | dry-run bullets, "the test plate from the box, if your machine came with one" | one paragraph linking engraving-quality#unplug | REVIEW 2.6, 3 (dry-run row) |
| hardware-and-spares | 87-95 | keep, swap or destroy bullets; "When secure boot is not enabled on a board, the start screen adds " (UNLOCKED)"" | one paragraph linking security-faq#lending and #storage | REVIEW 2.2, 3 |
| hardware-and-spares | 107 | "Release builds are reproducible bit for bit, except for the signature." | "...build from source and compare it with the release (Rebuild a release)" | REVIEW 2.3 |
| hardware-and-spares | 112-118 | black screen, garbled, head, homing items with fixes "a supply that offers 28 V" | symptom, cause and a link each (power#troubleshooting, troubleshooting#screen, engraving-quality#needle, #pulleys); "2-pin engraving solenoid plug" | REVIEW 2.1, 3, 4 (terminology) |
| hardware-and-spares | 120 | "Secure boot is not enabled on this board... fit a board you trust." | "Secure boot is off, or a boot key other than the SeedHammer key is valid. If you did not add a key, see Read the lock mark." | REVIEW 2.2 |
| hardware-and-spares | bench | plug, button, J8, 30 W, test plate, links items; "the team's lists"; "bom.csv marks" | owner and wording notes; "the company's lists"; "bom.csv lists"; new reproducible-build note | REVIEW 2.3 to 2.6 |
| plates | 41 | capture "on a cutting mat" | "on a desk mat" | STYLE Vocabulary |
| plates | 76-89 | test job "on the back of the test plate from the box"; six dry-run steps; "Check: with the solenoid unplugged..."; "control board" | "...the test plate that came with the machine, if yours came with one... Check: whether v1.4.3-era units ship a test plate."; steps replaced by a link to engraving-quality#unplug; "controller board" | REVIEW 2.6, 3 (dry-run row), 4 |
| plates | 93-97 | four bullets incl. "Lay the plate in the holder and close the lock. Check: which way up..." | intro with the Check; two bullets; link to power-and-first-start#plate | REVIEW 3 row 1; 4 (one action per bullet) |
| plates | 110-111 | "makes the marks slightly deeper... Check: whether a second job on v1.4.3 lands exactly on the first." | "makes the engraving slightly deeper and wider... Check: whether a second job lands exactly on the first, see Retry and restart." | REVIEW 2.7; STYLE Vocabulary |
| plates | bench | dry-run and depth items; "laser cut" | owner notes; "laser-profiled" | REVIEW 2.7, 3 |
| engraving-quality | 3, 9, 11, 15 | "how to test a job without marking a plate"; intro "test runs that leave the plate unmarked"; "Real seed words" | shortened; intro adds the wear link; "Seed words" | STYLE Vocabulary; REVIEW 4 |
| engraving-quality | 16-17 | "...28 V at 5 A..., or at least 20 V at 5 A... Check: whether a 20 V port at only 3 A (60 W) runs a full job" | "A USB-C PD port with 20 V or 28 V at 5 A, preferably 28 V (power)" | REVIEW 2.1 |
| engraving-quality | 19 | "the test plate that came with the machine or a plate you no longer need" | "a spare plate and a public test descriptor" | REVIEW 2.6 |
| engraving-quality | 23 | "The needle hammers marks about 0.3 to 0.4 mm deep... The needle works over about 4 mm of travel" | "The needle engraves about 0.3 to 0.4 mm deep..." | STYLE Vocabulary; REVIEW 4 |
| engraving-quality | 25 | gate restated ("If that one offer gives less than 3 A, the machine does not start..."); "deeper, crisper marks" | strike-strength sentence only; "deeper, crisper engraving" | REVIEW 2.1; STYLE Vocabulary |
| engraving-quality | 31 | "The test plate that came with the machine can look deeper... A second pass makes the marks slightly deeper and wider. Check: whether a second job on v1.4.3 lands exactly on the first." | "The test plate from the box, if yours came with one, was engraved at 28 V and may have run twice, so it can look deeper."; second-pass Check left to plates and troubleshooting#retry | REVIEW 2.6, 2.7 |
| engraving-quality | 38-50 | "Engrave Plate" procedure, stop and resume bullets, demo times, "Holding the hammer button homes the head again and continues the job. Check: ..." | link to power-and-first-start#plate, two quality bullets, homing paragraph, "After "Engraving failed.", see Retry and restart" | REVIEW 2.8, 3 row 1 |
| engraving-quality | 52-58 | error table | link to troubleshooting#engraving (owner of message meanings); "engraver unavailable" row moved there | REVIEW 3 (avoids a second error table) |
| engraving-quality | 63-65 | "Test a job without marking a plate"; dry-run paragraph with "Check: that v1.4.3 units still ship with that test plate" | "Test a job without engraving a plate"; shorter paragraph, "if any... Check: whether v1.4.3-era units ship one" | STYLE Vocabulary; REVIEW 2.6 |
| engraving-quality | 70, 75, 77-78 | "circuit board... Check: how to reach the board."; "Plug the solenoid back in. Check: ..." | "controller board" (reach Check in bench); Check moved out of the step bullet into a paragraph | REVIEW 4 (terminology, one action per bullet) |
| engraving-quality | 130-131 | "Use a port that offers 28 V, or at least 20 V at 5 A." | "Use a port that offers 28 V at 5 A." | REVIEW 2.1 |
| engraving-quality | 133-138 | wear section incl. "draws about 30 W on average" and "cuts the noise" | section removed; link to hardware-and-spares#wear in the intro | REVIEW 2.4, 3 (wear row); STYLE Vocabulary |
| engraving-quality | 142-150 | troubleshooting items | shorter, same causes and links | REVIEW 4 |
| engraving-quality | bench | retry, buffer and test-plate items | retry owner note; error table moved; test plate and 30 W notes | REVIEW 2.4, 2.6, 2.8 |
| titles-and-plate-layout | 3, 9, 11, 16, 22-23, 29 | description, intro, alert ("A seed plate gives full access...", "so treat a descriptor plate as private too"), common bullets, fingerprint | shortened | REVIEW 4 (199 lines) |
| titles-and-plate-layout | 31 | "The standard SeedQR... Check: confirm the QR form on an engraved plate." | "Standard (4 digits per word), not compact, per the source; error correction M. Check: on a plate." | REVIEW 2.12 |
| titles-and-plate-layout | 39, 42, 87, 94 | long image alt texts | shorter alt texts (captures unchanged) | REVIEW 4 |
| titles-and-plate-layout | 45-47 | plate bullets and lettering details | shorter (heights kept, widths and stroke left to the bench item) | REVIEW 4 |
| titles-and-plate-layout | 51-57 | fit sentence; text, QR, h and no-title bullets |
link to multisig-and-fit#fit; h and child path as a link to multisig-and-fit#differences; no-title links #titles |
REVIEW 3 (fit, differences rows) |
| titles-and-plate-layout | 68 | child-path paragraph | removed (multisig-and-fit#differences) | REVIEW 3 |
| titles-and-plate-layout | 70 | bare-key paragraph | "Send a descriptor with key origin, never a bare key (why)" | REVIEW 3 (bare key row) |
| titles-and-plate-layout | 72 | codex32 layout "For reference... Check: untested on hardware." | "A share is secret: never send one over NFC (Shares)" | REVIEW 2.13, 3 |
| titles-and-plate-layout | 81, 83 | ColdCard-file note; "cut the name to 20 characters" | shorter; "shorten the name to 20 characters" | STYLE Vocabulary |
| titles-and-plate-layout | 85 | "...Sparrow's Coldcard-format exports carry no descriptor string and are not affected." | "...remove it. Its Coldcard-format exports have no suffix and no child path (why)." | REVIEW 2.11 |
| titles-and-plate-layout | 90 | "It is not cut to 18 characters, not changed to capitals and not filtered." | "shows the whole title, wrapped, case kept, no 18-character limit" | STYLE Vocabulary |
| titles-and-plate-layout | 92, 99, 101, 111 | FAQ, passphrase and labelling bullets | shorter | REVIEW 4 |
| titles-and-plate-layout | 100 | "The maker has said custom text is planned." | "The company has said..." | REVIEW 4 (terminology) |
| titles-and-plate-layout | 115 | "...Send the JSON or a Coldcard-format export... The title is still not engraved." | "The export carried no name, see Titles." | REVIEW 4 |
| titles-and-plate-layout | 117 | full Coldcard-format cause list | page-specific causes (Name:, Format: BIP45) and a link to troubleshooting#nfc |
REVIEW 3 row 2 |
| titles-and-plate-layout | 119 | "For a multisig, send a Coldcard-format export instead. For a plain descriptor, delete everything from ?..." |
"A ?bh= or ?gl= suffix: remove it" linking nfc-tools-transfer#prepare |
REVIEW 2.11 |
| titles-and-plate-layout | 121-127 | fingerprint, differences, child-path items | shorter; differences item links multisig-and-fit#differences | REVIEW 3 |
| titles-and-plate-layout | 129 | "left out fingerprints and origin paths to save space" | "left out the master fingerprints and the origin paths before each key" | REVIEW 2.16 |
| titles-and-plate-layout | bench, sources | "no 18-character cut", "cut at ?", "Name cut to 20" |
"not shortened to 18 characters", "trimmed at ?", "Name shortened to 20"; ?bh= decision noted |
STYLE Vocabulary; REVIEW 2.11 |
| all 13 | sources line | as drafted | each now cites manuals/REVIEW-wave1.md and this file | task 5 |
Measured after the pass (120-column wrap of front matter and visible text, capture comments and the maintenance block left out; this count equals or exceeds the review's by one line): every how-to page is at or under 140 lines (power 139, nfc 139, seed-entry 140, firmware-upgrade 140, multisig 137, recovery 140, hardware 138, plates 122, engraving-quality 140, titles 140). The longer pages are capability sheet 279, troubleshooting 245 and security FAQ 264, now mostly tables and short paragraphs.
Decided, not changed
- Line wrapping: the upstream firmware-upgrade.md (fetched from website-content 2026-10-10) puts each bullet or paragraph on one line and has no line over 106 characters, so it settles neither style. The pages keep their current wrapping. Upstream also uses the title "Firmware Upgrade", so that title stays.
- The silkscreen text "NFC CUT HERE" on security-faq is quoted as printed on the board; every prose use of the word was replaced.
- The capability-sheet wallet table stays: descriptor-mobile-wallets links to capability-sheet#wallets.
- Terminology for the right-edge controls ("tab", "touch buttons", "touch slots") and the machine's name ("SH II" or "SeedHammer II") was not unified; "company", "controller board" and "engraving solenoid plug" were.
Still bench checks (one hedging level on every page)
Charger list and the 3 A (60 W) job; status-line position; restart on a partly engraved plate; whether a retry continues from the stop; buffer-underrun wording; test plate in the box; board plugs and whether the display leaves with the board; SeedQR form on a plate; codex32 over NFC (decode, no way back, silent return, layout); Coldcard seed direction (seed-entry warning rests on source at both ends); desktop NFC writer cause; seed-to-descriptor comparison; reproducible build of v1.4.3; shipped units without " (UNLOCKED)"; the v1.4.2 downgrade; power draw trace.