Zum Hauptinhalt springen

Storage System

info

This documentation is of a pre-release feature and will be available only in version 0.6

Introduction​

SpoolEase provides a powerful system to organize, track, and manage 3D printing filament spools.
Using a combination of structured storage, optional free-text locations, and NFC-based location tags, you can efficiently monitor where each spool is stored, track its location, and quickly tell where it's located.

This guide explains how locations work in SpoolEase, how to configure your storage system, how to use it and how to use NFC location tags to simplify managing your spools even more.

What is Location in SpoolEase​

SpoolEase supports two types of locations. They can be used together for maximum flexibility.

  • Managed location - A structured storage system defined in advance. Using managed locations enables advanced SpoolEase features.
  • Unmanaged location - Free text. Useful for temporary or informal locations, for example "Loaned to John Doe".

Managed Location​

A managed location follows a predefined structure.

A storage system consists of one or more racks.
Each rack is divided into levels (Bay → Shelf → Position → Container), defining the hierarchy of the storage system.

Each level can be:

  • Not included
  • Included with a value of 1 (expressing it exists, but just one)
  • Included with any other positive number

For each included level you also define its numbering order.
For containers, you additionally define their capacity (how many spools they can hold).

Hierarchy Rules​

Each rack can have a different structure.

  • Each level defines how many items exist within the level above it.
  • If a level is not included, the next included level applies to the closest existing parent level.
  • Example: If Bay, Shelf, and Position are not included, then the number of Containers defines how many containers exist directly in the rack.

This flexibility allows many possible structures, but you should define a structure that matches how you actually think about and use your storage.

Current Limitations​

  • A rack cannot have variable counts at different hierarchy branches.
  • Example: You cannot define one bay with 5 shelves and another with 7 shelves.
  • Therefore, use the maximum needed value.
  • This may be supported in the future.

Partial Locations​

When assigning a location, not all defined levels must be specified.

Example:

  • Even if a rack supports Bay, Shelf, Position, and Container, a location can be defined as only "Bay 1, Shelf 2".

This is useful for some workflows but can lead to ambiguity if used carelessly.

Spool Locations​

Each spool can has two locations fields:

  • Assigned Location
  • Actual Location

Both are optional.

  • Assigned location represents where the spool is supposed to be stored.
  • Actual location represents where the spool currently is.

Each location can independently be either managed or unmanaged.

Example:

  • Assigned location: Rack "Under Printer, Shelf 2, Position 3"
  • Actual location: "Loaned to John Doe" or "Office, Container 5"

Basic Operations​

With the concepts above, you can already perform the following:

  • Define storage configuration (racks and their structure) - in the Inventory application.
  • Set or clear assigned and actual locations per spool using either managed locations or free text - in the inventory application.
  • When a spool is loaded into AMS, its actual location is automatically cleared, and the inventory will display its location in the printer.
  • Manually mark a spool as removed from storage by scanning it to staging and selecting Picked from Storage.
  • When a spool is in staging and has an assigned location, select Placed in Assigned Spot to copy the assigned location into the actual location.

This covers basic needs, but assigning arbitrary locations manually through the inventory application is not always convenient. This is where location tags come in.

Location Tags​

Location tags add an additional interaction layer on top of the location system.

After configuring your storage system, you can create NFC location tags and attach them to your storage.

A location tag can represent:

  • A full location (Rack, Bay, Shelf, Position, Container)
  • A partial location (for example only Rack and Shelf)

Once placed, you can scan these tags with your mobile phone to access that location and perform actions in SpoolEase.

Currently, location tags are mainly used to assign locations to the spool that is loaded in the staging area.

Typical Use Cases​

Placing an Arbitrary Spool in Storage​

  1. Scan a spool on SpoolEase to load it into staging.
  2. Take the spool to the desired storage location.
  3. Scan the location tag using your mobile phone.
  4. Assign the location to the spool.
  5. Before step 4 you can also optionally refine the location (for example add position or container if the tag represents only a shelf).

Returning a Spool from AMS​

  1. Remove the spool from AMS (it is automatically loaded into staging).
  2. (Optionally weight it on the scale.)
  3. Continue from step 2 of the previous scenario to put it back in place.

More capabilities will be added in the future.

Location Tag Technical Details​

To use an NFC tag as a location tag, it must be encoded. This needs to take place only once per tag.

  • The tag is not tied to a specific location.
  • After encoding, you can set and later change the location it represents without re-encoding.

Encoding a Location Tag​

(Current flow may change)

  1. Swipe left on the main screen.
  2. Select Encode Location Tag.
  3. Place the NFC tag near the reader.

After a confirmation is displayed, the tag is now a location tag.

Mobile Configuration​

No mobile application is required.

When scanning a location tag for the first time, you will be prompted to configure:

  • SpoolEase console address
  • Optional - the console security key

The same configuration screen is available at:

https://tag.spoolease.io/config

The configuration is stored locally on the device and must be repeated for each mobile device and browser. If the site data is cleared these settings will be cleared as well.

Technical Notes​

  1. The console address can be an set as IP address (in this case it is required to be fixed IP in the router) or {consolename}.local if mDNS is supported by your mobile/network.

  2. On iPhone:

    • Using Safari with a hostname is slower.
    • Chrome is fast with both hostname and IP.
    • Using an IP address is always fast.

    On Android:

    • Still no information, using IP should work.

  3. Configuration is browser-specific. If using two browsers, need to configure in each.

  4. Data is stored locally on the mobile and accessible only to applications loaded from tag.spoolease.io.

    • The application is fully client-side.
    • No server is involved.
    • Still, do not use a sensitive password you use elsewhere as your console security key.

  5. If no security key is configured, you will be prompted for it on every scan.

  6. The security key is never exposed over the network when using HTTP.

After configuration, selecting Continue will open the location tag application. This will take place automatically on future scans and configuration will only be required in case of issues.

Technical Side Note​

Due to constraints of local HTTP-based devices, scanning a tag is implemented using a short sequence of client-side redirects. This is normal and done for flexibility and reliability. This is too technical to explain here.

If the console is unavailable (for example powered off), scanning the tag will reach a page-not-found, and scanning again will bring you back to the configuration screen to verify settings (for the case where console IP has changed for example).

Using the Location Tag Application​

  • If a scanned tag is not yet set to a location, you will be prompted to do so.
  • On subsequent scans of the tags, the location tag application page will open directly.

On the location page:

  • The scanned tag is shown.
  • The represented location is loaded as Selected Location.
  • You can edit the selected location using the pencil icon. This does not modify the tag but only the location selected for current operations.
  • If a spool is loaded in staging, it will be shown with its assigned and actual locations.
  • You can set or clear the assigned and actual locations based on the selected location.
  • If no spool is in staging, the view will appear empty.

Closing​

With SpoolEase location management and NFC tags, you can streamline your filament workflow, reduce errors, and always know where your spools are.

Whether you use simple managed locations, free-text unmanaged locations, or NFC tags for fast assignment, SpoolEase provides flexibility to match your workflow and storage setup.

As the system evolves, more features will be added to enhance tracking, reporting, and additional (really cool) integrations to make storage management even simpler.