Skip to content

pnpvision Commands

Run on the Pi from ~/OSHE-PnP/Software/pnpvision:

~/venv-pnp/bin/python -m pnpvision <command> [options]

Add --help after any command for all its options. Every command that moves lifts the nozzle to the safe height before any X/Y move and refuses moves outside the limits in config.toml.

Command Purpose Moves?
Everyday
home visual homing (used by VISION_HOME) yes
align-board JOB --rot 90 find the board from its alignment pads yes
run-job JOB [--dry-run] [--only R1 R2] [--no-feeders] place a job yes
check-board JOB [--only ...] down camera over each footprint: PLACED / MISSING + mm error yes
report [--out DIR] [--since DATE] export the event log (CSV + contact sheets) no
import-jobs [--device DEV] [--from DIR] load job files from SD card / USB stick no
make-launchers PNP_<job>.gcode launcher files for the print list no
Feeders and bin
feed SLOT [--times n] feed a servo feeder no
teach-feeder ID --servo n --package PKG save a feeder's pick spot no
feeder-cycle ID --n 20 pick and drop in the bin, N times, no vision yes
teach-bin [--goto] [--default] reject bin position yes
Calibration
check-lens check the lens calibration files no
snapshot --cam up/down [--lit] save a camera image no
find-dot --cam ... show which round blobs the detector finds no
focus-sweep step Z over the up camera, score sharpness yes
calibrate-motion --cam up/down ... camera pixels -> mm map yes
calibrate-offset / set-offset X Y down camera -> nozzle offset yes / no
repeatability --n 20 go away and back, measure scatter yes
datum [--teach] [--reference] datum grid yes
tip NAME [--board-touch-z Z] [--inspect-z Z] [--current] nozzle tip heights no
inspect-up, light-test inspect a part on the nozzle; test lights yes
place-test pick and place spare parts, measure where they land yes
check-machine [--apply] recovery check after a disturbance yes
hmi-test test dialog on the touchscreen no

Tests that need no hardware: pytest in Software/pnpvision (92 tests).