Features

OctoScale Features

NFC filament scale for OctoPrint and SpoolManagerExtended. This page summarizes the device capabilities and supported tag formats. See the Assembly Guide for hardware, wiring, enclosure, firmware, setup, and maintenance.

Scale

• HX711 and 5 kg load cell with live readout on the TFT and web UI.
• One-point quick calibration and two-point linearity-checked calibration.
• Calibration factor stored in NVS and retained across reboots and OTA updates.

NFC

The PN5180 reads and writes NFC-A/NTAG/Ultralight, NFC-V/ISO 15693, and Mifare Classic 1K tags. Supported payload formats are auto-detected:

Format	Tag	Notes
octoscaleExtended	Mifare Classic 1K	Custom binary layout with CRC-8 commit marker
ntagExtended	NTAG	Same layout with NTAG page addressing
nfcvExtended	NFC-V	Same layout with NFC-V blocks
openSpool / nfcvOpenSpool	NTAG / NFC-V	OpenSpool NDEF/JSON, readable by third-party apps
nfcvOpenPrintTag	NFC-V	OpenPrintTag CBOR, including drying data
tigerTag	NTAG	TigerTag Standard, unsigned, big-endian 80-byte payload

Foreign tags such as Snapmaker tags fall back to a UID lookup in SpoolManagerExtended. NFC writes report droppedFields when fields do not fit and unsupportedFields when the selected format has no representation. Unknown tags can be inspected with a raw sector/block dump.

Interface and connectivity

• ST7789 320x240 TFT with EC11 encoder menu mirroring the spool workflow.
• Boot splash, locked OTA progress screen, and independent light/dark display theme.
• Three idle stages: dim, bouncing-logo screensaver, and display/backlight off.
• Hidden device test menu: hold PUSH for 3 seconds on the System info screen.
• Web UI themes: OctoScale and OctoPrint, each with light/dark mode.
• Web UI covers weighing, calibration, NFC, OctoPrint instances, system, WiFi, and test points.
• Passive buzzer with event tones and mirrored onboard/external WS2812 status LEDs.
• Optional browser debug console for NFC and HTTP activity.
• WiFiManager provisioning with AP fallback and captive portal.
• OTA through espota or web upload/URL update.
• Multiple OctoPrint instances with database failover when instances share an external database.
• AES-256-CBC encrypted JSON backup of the full configuration, including all display, buzzer, and LED settings; API keys are never exported in plaintext.

Continue with the Hardware & Printing Guide to gather components and print the enclosure parts.