mashgin

Kiosk

How to Calibrate your kiosk

Guide for calibrating the kiosk’s cameras

⚠️

Missing calibration board?

Print this PDF and attach it to thick cardboard. Must be straight and flat.

📸

Camera Calibration Documentation

⚠️ All cameras must be online before calibrating. If any are stuck or missing, refer to theHow do I resolve a Possible Blocked Cam alert? guide

📸 What is Camera Calibration?


Calibration updates the software to tell the kiosk where it's supposed to look! Without it, item recognition and transactions can fail. Cameras drift over time from temperature changes or impacts during use/cleaning.

🏁 How to Calibrate 🏁


Step 1. Camera Checks

  1. Go to Manager Mode > Advanced > Calibration
  1. Confirm all 8 cameras are showing, and not stuck
  1. Check lenses for film or dust
Notion image

Step 2. Required items

  1. Calibration board
  1. Item 3-4 inches tall ( 7-10 cm )
  1. Item 5-8 inches tall ( 13-23 cm )

💡 TIP: Select items with a flat top!

Notion image

Step 3. Empty + Flat Poses

  1. Take one pose of the base completely empty
  1. Place the board on the base and take 7-10 poses
  1. Move the board between poses
  1. The goal it to cover the base with poses, usually this can be done with a 3x3 grid
Notion image

Step 4. Short Item Poses

  1. Place the calibration board on top of the tall item ( 3-4 in / 7-10 cm )
  1. Take 7-10 poses
    1. Move the board between poses
    2. Take poses until you have covered the base
    3. Make sure the board is not extending past the black line around the base
Notion image

Step 5. Tall Item Poses

  1. Place the calibration board on top of the tall item ( 5-8 in / 13-23 cm )
  1. Take 7-10 poses
    1. Move the board between poses
    2. Take poses until you have covered the base
    3. Make sure the board is not extending past the black line around the base
Notion image

Step 6. Shallow Angle Poses

  1. Lean the board horizontally against your item
  1. Take 7-10 poses
    1. Move the board between poses
    2. Always face the board to the center of the base.
Notion image

Step 7. Steep Angle Poses

  1. Lean the board Vertically against an item
  1. Take 7-10 poses
    1. Move the board between poses
    2. Always face the board to the center of the base.
Notion image

Step 8. Complete & verify

  1. Remove all items from the base
  1. Press the green Calibrate button — do not interrupt
  1. Press ‘Cancel’
  1. Confirm Ok shows for each camera
Notion image

🛠️ Troubleshooting 🛠️


Pattern Not Visible Alerts

Issue: Pattern not visible during calibration.

Fix:

  1. Clear camera views of obstructions
  1. Clean base surface
  1. Check lenses for film/dust
  1. Remove the calibration board from the base
 
Notion image
Notion image

Calibration Fails Repeatedly

Issue: Calibration won't complete after multiple attempts.

Fix:

  1. Confirm all cameras online (Advanced > Cams)
  1. Ensure 40–50 poses captured across all heights/angles
  1. Check that board isn't slipping and hands are off the base
  1. Confirm first pose was an empty base
  1. Restart from scratch if any pose was bad

Cameras Offline or Missing

Issue: Cameras not detected, can't start calibration.

Fix:

  1. Power cycle the kiosk
  1. Check camera cable connections
  1. See Missing / Stuck Cam Alert guide

🔗 Related Articles


🖐️

Need help? Contact support at 📧 help@mashgin.com or call (855) 475-0889

Did this answer your question?
😞
😐
🤩