Feedstock Hopper
A parametric, printable bulk hopper for pellets and shredded regrind, with quick-release couplings and a small adapter per machine.
Overview
Section titled “Overview”A gravity bulk hopper sized from what it has to pass, not from a capacity. You state the feedstock (virgin pellets or shredded regrind) and the largest particle, and the funnel angle, outlet and bin follow from bulk-solids flow rules; capacity is whatever that leaves, and every render reports it.
It is modular at three interfaces: the body twists into a bolted-down hub (A), an outlet twists into the hub’s other end (B, varies with the hose or throat it feeds), and the hub bolts to a plate (C, varies with the machine). A new machine needs a plate and perhaps an outlet, not a new hopper. The machine’s own feed opening is a registry row, and the report checks the whole path against it.
Used on:
- The GreenBoy3D pellet extruder on a Prusa MK3S, in service in the lab,
feeding the toolhead through its 1 m conveyor tube from the MK3S frame mount.
The machine and its firmware are in
uwo-fast/Prusa-Firmware-GB3DPE. - A filament recycling extruder, planned: an outlet that bolts to the extruder barrel’s feed pad.
Status. Printed and in service. Every part compiles and holds its asserts
under just check, and geometry is regression-tested against a committed
baseline. The funnel angles are design targets the built hopper appears to
satisfy, not measurements; open work is in the
issues.
Repository layout
Section titled “Repository layout”cad/hopper/– the hopper: body, cap, hub, outlet, the feedstock, hose and target registries, and the plate in its universal, MK3S-frame and panel variantsdocs/– interfaces, design notes, feedstock, loads and printingdev/– the design log and the review of the imported designexamples/– one file per configuration, each rendering standalonescripts/,tests/– geometry regression harness and its baseline
Getting started
Section titled “Getting started”Requires OpenSCAD (tested on 2021.01),
just, and
bayonet-lock-scad at its
v0.12.0 tag (0.9.1 or later is required), which scadman.lock pins. With
scadman installed, run just setup, which
puts it in .scadman/env/, where every recipe looks first. Without scadman, install it as
an OpenSCAD library at that tag:
git clone https://github.com/CameronBrooks11/bayonet-lock-scad \ ~/.local/share/OpenSCAD/libraries/bayonet-lock-scadgit -C ~/.local/share/OpenSCAD/libraries/bayonet-lock-scad checkout v0.12.0just # list recipesjust check # compile every part at every size, any diagnostic failsjust geom # check rendered geometry against the committed baselinejust render # write STLs for every part and size to build/just edit # open the assembly in the OpenSCAD GUI CustomizerThe design is driven from cad/hopper/pellet_hopper.scad, which holds every
tunable parameter and hands them to the part modules. Pick a part with
render_part, a footprint with hopper_size, and what it will hold with
feedstock_type.
The funnel angle is an input, not a consequence. Set funnel_angle in degrees
from horizontal and the drop is solved from it; capacity is then whatever falls
out, and is echoed on every render along with a build-volume fit report. The
angle is measured on the diagonal corner, which on a rectangular funnel runs
further out than either flat face over the same drop and is therefore the
shallowest surface and the one pellets bridge on. Each feedstock carries the
shallowest angle it will still flow at, and a render below it is an error rather
than a quiet under-performing hopper.
Note that the presets are named for their footprint rather than a capacity. The imported design worked the other way round – capacity first, wall angle whatever was left – which is how it ended up at 27 to 36 degrees at the corner.
Each of the other files under cad/hopper/ defines one part or one concern and
renders on its own, so you can open hopper_hub.scad directly and iterate on
the hub without the rest of the model in the way.
examples/ holds worked configurations that drive the modules directly rather
than through the Customizer: the two feedstocks side by side, each split into
the segments its funnel height demands, and the MK3S frame mount with the hub
and outlet around it. They are covered by just check, so they cannot drift
away from the API they demonstrate.
just geom exists because OpenSCAD does not emit STL facets in a stable order,
so a mesh cannot be compared by hash. It compares signed volume, bounding box
and triangle count instead, which is enough to prove a refactor changed
nothing. Re-baseline with just geom-baseline only after an intended geometry
change.
Documentation
Section titled “Documentation”- Interfaces – the three couplings, and what a new machine needs
- Design notes – why the geometry is the way it is, where the numbers came from, and known limits
- Feedstock – measured bulk density and provenance
- Printing and assembly – parts, orientations, hardware, order
- Load cases – hand calculations and what they do not cover
- Design log and review of the imported design
Contributing
Section titled “Contributing”Contributions are welcome. See the organization contribution guide.
Citation
Section titled “Citation”If you use this project in your work, please cite it. Use the Cite this
repository button on GitHub, or see CITATION.cff.
Acknowledgements
Section titled “Acknowledgements”The bulk hopper was initially designed by Hadden Christ,
whose body, roof mount, cap and bayonet coupling are the basis of cad/hopper/.
License
Section titled “License”Copyright © 2026 feedstock-hopper and its contributors.
This project is free software: you may redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later version.
Hardware design files and the outputs generated from them are licensed instead
under CERN-OHL-S-2.0, and the parametric CAD source
under both. See LICENSING.md for what applies where, and the
organization
licensing policy for
why.
This project is not affiliated with GreenBoy3D or Prusa Research.
Contact
Section titled “Contact”Maintained by the FAST research group. For research collaboration inquiries, contact Dr. Joshua Pearce (joshua.pearce@uwo.ca).
