Skip to content

docs: list BambuTagger among the community integrations - #23

Merged
BenGlut merged 1 commit into
mainfrom
docs/bambutagger-integration
Sep 5, 2026
Merged

docs: list BambuTagger among the community integrations#23
BenGlut merged 1 commit into
mainfrom
docs/bambutagger-integration

Conversation

@BenGlut

@BenGlut BenGlut commented Sep 5, 2026

Copy link
Copy Markdown
Collaborator

Adds §6.4 for bambutagger.de — the first
third-party hardware in this list; everything else in §6 is software.

What it is

  • BT-Touch — a handheld reader, writer and cloner. ESP32-S3, 5"
    touchscreen, one RC522, battery, local storage for 2 000+ tags.
  • BT-AMS-C — a four-slot reader that mounts on a Bambu Lab AMS,
    displays live slot data and pushes tag data to the printer/BMCU. Web
    configuration, OTA updates.

Both are DIY from off-the-shelf modules with printed cases and published
PCB files. AGPL-3.0.

The compatibility claim was verified, not repeated

The product page says "TigerTag" among the formats it handles. Rather
than take that at face value, the parser in
src/main.cpp
was read against §2 of this specification. Every offset matches:

Field Spec offset Theirs
ID TigerTag +0, u32 BE
ID Material +8, u16 BE
Aspect 1 / 2 +10 / +11
ID Diameter +13
ID Brand +14, u16 BE
Colour 1 RGB +16
Measure +20, u24 BE
ID Unit +23 ✅ (kg ×1000, mg ÷1000 — matches id_measure_unit.json)
Nozzle min / max +24 / +26
Dry temp / time +28 / +29
Bed min / max +30 / +31

It accepts both 0x5BF59264 and 0xBC0FCB97, which is correct.

And the limits are stated

Because someone reading §6 may be deciding whether to build one:

  • It does not read Transmission Distance, the custom message, or the
    signature — so it makes no authenticity claim, and none should be read
    into it.
  • Its reference tables are compiled in as a snapshot, not synced from
    database/, so newly catalogued brands and materials
    resolve only after a firmware update.

Cloning gets a line as well, since the device offers it and a reader of
§3 may wonder: copying a signed chip reproduces the payload, not the
signature's validity — the attestation-not-a-lock property this project
already documents.

The section's existing disclaimer covers it: community projects, not
maintained or endorsed by TigerTag Project.

Two open-hardware ESP32 builds that read and write TigerTag: a handheld
reader/writer/cloner with a touchscreen, and a four-slot reader that sits
on a Bambu Lab AMS and feeds the printer. They are the first third-party
hardware in this list — everything else here is software.

The compatibility claim was checked against the source rather than taken
from the product page. Their parser reads the user block at the offsets
this specification defines — material at +8, aspects at +10 and +11,
diameter at +13, brand at +14, colour at +16, measure at +20 with the
unit conversion, temperatures from +24 to +31 — and accepts both type
ids, which is right.

What it does not read is worth stating for anyone deciding whether to
build one: no Transmission Distance, no custom message, no signature, so
the device makes no authenticity claim, and its reference tables are
compiled in as a snapshot rather than synced, so new brands need a
firmware update. Cloning gets a line too, since the device offers it and
a reader of §3 may wonder: copying a signed chip reproduces the payload,
not the signature's validity.
@BenGlut BenGlut added the documentation Improvements or additions to documentation label Sep 5, 2026
@BenGlut
BenGlut merged commit 09f0cea into main Sep 5, 2026
1 check passed
@BenGlut
BenGlut deleted the docs/bambutagger-integration branch September 5, 2026 23:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant