1. Home
  2. Knowledge Base
  3. Storage hardware
  4. MPH Spiral Box — storage device setup

MPH Spiral Box — storage device setup

What you can do

Add an MPH Spiral Box vending machine to CRIBWISE: create the coil storage device, enter the coil grid once, and let CRIBWISE create one stock location per coil.


Before you start

  • You need Admin Portal access with permission to edit devices and storage devices.
  • The device the machine is wired to must already exist. See How to create and manage devices.
  • You need the communication port number the machine is connected to.
  • You need the cabinet layout: how many coil lines it has, and how many coils sit in each line. Both are 1–8.

Important: A Spiral Box is a location-controlled machine, so it cannot be added to a cloud device. Saving it there fails with Cannot create location controlled storage device for cloud device. Add it to the device that runs the Shop Floor Interface next to the machine.


How the coil grid becomes stock locations

One cabinet is one storage module, and you describe its coils with two dimension ranges. The 1st dimension is the coil line, the 2nd dimension is the coil within that line. Two coil lines share one shelf level, facing each other, so a cabinet with four levels has eight coil lines.

CRIBWISE then creates one stock location per coil and names it after the storage device, the module and the two numbers.

Diagram of the MPH Spiral Box location structure: eight coil lines stacked in four shelf levels with two lines per level, eight coils in each line, and the resulting stock location name broken into storage device name, storage module name, 1st dimension (coil line) and 2nd dimension (coil in the line)

The coil grid and the name each coil gets. Click the image to open it full size.

Both numbers are always written with two digits, so coil line 3, coil 5 on the storage device Spiral 1 with the module Cabinet becomes Spiral 1-Cabinet-03-05.


Quick start

Experienced users — add the machine in six steps:

  1. Open the device in Data management > Devices and go to the Storage devices tab.
  2. Add a storage device: name it, set Type to Location controlled (Coil) and Manufacturer to MPH Spiral Box.
  3. Enter the Communication port, then Save storage device.
  4. Add one storage module for the cabinet, with Address 0 and both dimension ranges.
  5. Check the generated locations on the Stock locations tab.
  6. Release the storage device.

Need more detail? Follow the full steps below.


Steps

Step 1 — Open the device’s Storage devices tab

  1. Go to Data management > Devices.
  2. Select the device the machine is wired to, then click View detail.
  3. Open the Storage devices tab.
  4. Click + (Add new storage device).

Storage devices tab of a device in the CRIBWISE Admin Portal with step 1 highlighting the Add new storage device button above the storage device list

The Storage devices tab lists everything already attached to this device. + (1) starts a new one.

Step 2 — Fill in the general information

  1. Enter a Name for the machine.
  2. Set Type to Location controlled (Coil).
  3. Set Manufacturer to MPH Spiral Box.
  4. Enter the Communication port.

Communication port only appears once you have chosen a manufacturer — the connection fields change with the machine.

New storage device form in the CRIBWISE Admin Portal with steps 1 to 5 highlighting the Name field, the Location controlled (Coil) type, the MPH Spiral Box manufacturer, the Communication port and the Save storage device button

A new Spiral Box before the first save: Name (1), Type (2), Manufacturer (3), Communication port (4), then Save storage device (5). The three right-hand tabs and Release stay greyed out until you save.

Field Required What to enter
Name Yes The name operators see at the Shop Floor Interface, for example Spiral 1. It becomes the first part of every stock location name.
Type Yes Location controlled (Coil). Plain Location controlled is for drawer cabinets and lifts, not for coil machines.
Manufacturer Yes MPH Spiral Box. MPH AVC-100 is a different machine with a different setup.
Communication port Yes The number of the port the machine is physically connected to, without any COM prefix — enter 4 for COM4.

Note: The Manufacturer list is the same for both location-controlled types, so nothing warns you if the Type is wrong. Check both fields before you save.

Step 3 — Save the storage device

  1. Click Save storage device.

The Storage modules and Stock locations tabs open, and Release becomes available. Location mapping stays greyed out — a Spiral Box does not use it. Type and Manufacturer are now read-only; Name and Communication port can still be edited.

Saved MPH Spiral Box storage device in the CRIBWISE Admin Portal with status New, steps 1 and 2 highlighting the now-enabled Storage modules and Stock locations tabs, step 3 highlighting the Release button, and the Location mapping tab still greyed out

After saving: Storage modules (1) and Stock locations (2) open up, and Release (3) becomes available. Status stays New until you release it.

Warning: To change Type or Manufacturer after this save, you have to delete the storage device and create it again.

Step 4 — Add the cabinet as a storage module

  1. Open the Storage modules tab.
  2. Click Add.
  3. Enter a Name for the cabinet.
  4. Enter 0 in Address.
  5. Enter the 1st dimension range — the number of coil lines, from 1 to 8.
  6. Enter the 2nd dimension range — the number of coils in a line, from 1 to 8.
  7. Click Save storage module.

Storage module settings panel in the CRIBWISE Admin Portal with steps 1 to 4 highlighting the module name Cabinet, the address 0, the 1st and 2nd dimension ranges 1 to 8, and the Save storage module button

One module per cabinet: Name (1), Address 0 (2), the two dimension ranges (3), then Save storage module (4).

Field Required What to enter
Name Yes A name for the cabinet, for example Cabinet. It becomes the second part of every stock location name.
Address Yes 0. A Spiral Box module needs no hardware address.
1st dimension Yes The coil lines, counted from the top: 1 to the number of lines, at most 8. Two lines share one shelf level.
2nd dimension Yes The coils in one line: 1 to the number of coils, at most 8.
Description No Free text, for example where the cabinet stands.
Default stock location dimension (mm) No Width, height and depth given to every location this module creates.

Add one module per cabinet. A second Spiral Box cabinet is a second storage device, not a second module.

Important: The dimension ranges are fixed once the module is saved — the four fields are greyed out when you reopen it. Only Name, Description and Address stay editable. To change the grid, remove the module and add it again.

Storage module settings panel in the CRIBWISE Admin Portal reopened after saving, showing the module name and address still editable while the 1st and 2nd dimension ranges are greyed out and cannot be changed

The same module reopened after saving. The dimension ranges are greyed out.

Step 5 — Check the generated stock locations

  1. Open the Stock locations tab.

One location per coil is already there, sorted by coil line and then by coil. Widen the Location name column if the names are cut off.

Stock locations tab in the CRIBWISE Admin Portal highlighting the locations generated for the MPH Spiral Box storage device Spiral 1, starting at Spiral 1-Cabinet-01-01 and running through the coil grid

Ranges 1–8 and 1–8 produced 64 locations, from Spiral 1-Cabinet-01-01 to Spiral 1-Cabinet-08-08. Items Assigned is 0 on every row until you assign items.

You entered You get Named
1st dimension 1–8, 2nd dimension 1–8 64 locations Spiral 1-Cabinet-01-01Spiral 1-Cabinet-08-08
1st dimension 1–2, 2nd dimension 1–3 6 locations Spiral 1-Cabinet-01-01Spiral 1-Cabinet-02-03

Step 6 — Release the storage device

  1. Go back to the General information tab.
  2. Click Release.
  3. Confirm Do you really want to release storage device (name)? with Yes.

Confirmation dialog in the CRIBWISE Admin Portal asking Do you really want to release storage device Spiral 1, with Yes and No buttons, highlighted in red

Release asks for confirmation. There is no way back after Yes, so check the coil grid first.

Success: The status changes from New to Released, Release greys out, and the machine and its coil locations are available at the Shop Floor Interface.


Settings summary

Setting Value
Type Location controlled (Coil)
Manufacturer MPH Spiral Box
Communication port The port the machine is physically connected to
Storage modules One per cabinet, Address 0
1st dimension 1–8, the coil lines — two lines per shelf level
2nd dimension 1–8, the coils in one line
Location mapping Not used

Next steps

  1. Assign items to the coil locations — see How to manage stock locations (Shop Floor Interface).
  2. Add the next cabinet — repeat the steps above, or use Storage device copy and change the name and port.

Troubleshooting

Problem Likely cause Fix
Saving fails with Cannot create location controlled storage device for cloud device The device you picked is a cloud device Add the machine to the device that runs the Shop Floor Interface next to it. Only open storage works on a cloud device.
The Storage modules and Stock locations tabs are greyed out The storage device has not been saved yet Click Save storage device first. Both tabs open on the first save.
Location mapping is greyed out A Spiral Box does not use location mapping Nothing to do — the tab only opens for models that need it.
The dimension fields are greyed out when you reopen the module Dimension ranges are fixed at the first save of the module Remove the module and add it again with the correct ranges.
Too many or too few stock locations were created The dimension ranges do not match the cabinet Count the coil lines (1st dimension) and the coils in one line (2nd dimension), then rebuild the module.
Type and Manufacturer cannot be changed Both are locked from the first save onwards Delete the storage device and create it again. Deleting also removes its modules and stock locations.
Release is greyed out The storage device is already released Nothing to do. Check Status on the General information tab.

Was this article helpful?

Related Articles