ShieldSigner / build & use0.0.19-dev

THE KNOWLEDGE BASE

Build knowledge.

Hardware decisions, card compatibility, firmware and assembly—all in one place.

37 guides

Hardware

Display, buttons & first-article electrical checks

HOTHMI initialization, all eight button paths, image readback and pending powered measurements.

↗
Sources

All hardware datasheets

Local PDFs for all 18 factory BOM SKUs, display and host modules.

↗
Build

PCB order readiness & current gates

Four-layer main carrier, factory service points, native checks, matched files and first-article assembly limits.

↗
Hardware

Carrier PCB & firmware compatibility

Exact host/LCD/button maps and why the working bench firmware must not be used unchanged on the carrier.

↗
Software

Firmware images, staging & verification

One canonical image location, immutable named staging, preserved caches and image identity checks.

↗
Software

Current LVGL firmware & test status

Linux, Python, LVGL and Rust camera responsibilities; scoped memory measurements and the tested bench image.

↗
Software

Memory, Python and threads

Measured RAM use, shared Python imports, camera workers, LCD buffers and compressed RAM swap.

↗
Hardware

Luckfox Mini pinout & signal map

All 22 pins, voltage domains, SPI/I2C/UART/PWM alternatives and checked carrier connections.

↗
Build

Switch & USB-C revision

Manufacturer drawings, shared-supplier parts, new lands and measured-height buttons.

↗
Start here

Start here: projects, versions & build paths

How SeedSigner, ShieldSigner, Luckfox firmware and this prototype fit together.

↗
Use

Software features & defaults

Signing, smartcards, optional tools and what the pinned image actually enables.

↗
Use

Wallets, secrets & backups

SeedQR, passphrases, descriptors, card storage, BIP85 and SLIP39 explained.

↗
Support

Troubleshooting

Find the failing layer: boot, display, camera, reader, applet or wallet settings.

↗
Build

Practical build tips

Match variants, inspect LCD pin numbering, isolate camera faults and test the reader in stages.

↗
Use

Practice multisig & missing-key recovery

A 2-of-3 laboratory plan, descriptor backups, all signing pairs and recovery with a key unavailable.

↗
Sources

Useful upstream sources

Reviewed primary sources for hardware profiles, QR formats, smartcards and recovery.

↗
Build

Print and assemble the enclosure

Flat prints, camera fit, button mechanisms, fasteners and exploded 3D assembly.

↗
Build

Assemble the modular carrier

JLC quote, through-hole headers, mounting and staged bring-up.

↗
Build

Modular carrier BOM

43 SMT placements / 18 SKUs with values, ratings and dated JLC sourcing.

↗
Build

Optional DigiKey self-assembly

Separate commodity substitutions and purchase CSV; JLC remains the primary assembly path.

↗
Build

DigiKey self-assembly BOM

Exact order codes for all 35 SMT pieces; shared JLC/DigiKey switches and USB-C.

↗
Hardware

Eight-pin 2.8-inch pill carrier

Pill layout, reference eight-pin interface, dedicated LCD power and simple header assembly.

↗
Software

How this website works

Content sources, local previews, versioning, checks and deployment.

↗
Build

Standard FPC build overview

Earlier standard FPC configuration; current pill has a separate assembly guide.

↗
Start here

Project overview

The Luckfox carrier, current progress and project sources.

↗
Hardware

Historical FPC hardware architecture

Preserved 40-pin FPC circuit; use the main carrier and display/button reviews for the current board.

↗
Hardware

Every component explained

Standard FPC reference: what each of its 53 parts does, why it was chosen and how it connects.

↗
Hardware

KiCad board & tools

Native design, electrical checks and guarded editing tools.

↗
Hardware

Historical FPC electrical review

Earlier FPC circuit review; the main carrier has its own display/button electrical review.

↗
Smartcards

Cards & the Linux reader

Socket wiring, SeedKeeper versus Satochip, and PC/SC over UART.

↗
Build

Standard FPC parts & assembly

Standard FPC reference population and supplier matches; pill files are separate.

↗
Build

Standard FPC component catalog

Reviewed part identities, quantities and supplier links.

↗
Build

Bring-up guide

Shared host/card tests and standard FPC details; start the pill assembly guide first.

↗
Build

Hardware test record

The evidence collected so far and the tests still to run.

↗
Software

Buildroot & firmware

Pinned inputs, successful builds, caches and possible Linux-free work.

↗
Software

The tscircuit experiment

What the port preserves and where its checks stop.

↗
Sources

Datasheets & references

Locally saved supplier drawings and manufacturer documents.

↗