HomeInterfacesRecipesChangelogFAQ
Log In
Interfaces

Port Process

šŸ“˜

Ports controlled through the Port Interface should be configured with the port type CUSTOM.

Cells Allocation

To deliver/retrieve bins to/from a Custom Port, the WMS must allocate a port cell. This allocation allows AutoStore to plan bin and robot movements before the port is physically ready.

Cell Allocation Rules

  • Each cell can have only one pending allocation.
  • A new allocation replaces the previous one.
  • The WMS typically sends the next allocation immediately after AutoStore confirms a bin operation (bintoport and/or binfromport).
ā—ļø

Port Interface does not support ports with multiple port cells.

Returning Bins To Grid

  • Usually, a bin delivered to a port is returned using the same cell.
  • If separate cells are used for returning bins, the WMS must allocate those cells as well.
  • Delivery and return allocations are independent processes and help AutoStore plan empty robot movement.

Allocation Message

  • The WMS allocates a port cell by sending portcellallocate to AutoStore.

Exchange Bins To/From Grid

Cell allocation alone does not allow physical bin movement. The WMS must explicitly permit it:

  • Deliver bin to cell → portlocationready
  • Retrieve bin from cell → portbinready

The portlocationready message includes the getbin parameter, which indicates whether:

  • Only a bin should be delivered, or
  • A bin exchange (deliver and retrieve) should occur.

Log Publisher Confirmation

AutoStore confirms physical operations indirectly via the Log Publisher Interface:

  • bintoport: delivered as an ordinary BL segment (new bin location), confirms a bin has been delivered to the port cell. AutoStore releases control of the cell.
  • binfromport: delivered as an ordinary BL segment (new bin location or bin on robot), confirms a bin has been retrieved from the port cell. AutoStore releases control of the cell.
šŸ“˜

The binfromport confirmation may:

  • Show the bin on a robot (BL,bin_id,grid_id), or
  • Directly specify a new grid position (BL,bin_id,grid_id,xpos,ypos,depth).

Both cases mean the bin was successfully retrieved from the port.


Examples

Custom Port Picking | Outbound

Moving bins from AS grid to the outside.

METHOD
WMS → AS
LOGICAL MESSAGE
AS → WMS
ACTIONMODELOG PUBLISHER SEGMENT
openportCustom port mode opened with categoryOPENPM,20,O
portcellallocate (getbin=0)Bin on robot towards port locationBL,24240,1
openbinIn custom port bin mode OPEN is not set
portlocationready (getbin=0)Cell allocated for bin deliveryCI,28,5,1
bintoportBin delivered to custom outbound portPORTBL,24240,1,28,5,1,P
removebinBin removed from gridOUTSIDEBM,24240,X

Custom Port Picking | Inbound

Moving bins from the outside to the AS grid.

METHOD
WMS → AS
LOGICAL MESSAGE
AS → WMS
ACTIONMODELP SEGMENT
openportCustom port openedINSERTPM,21,I
portcellallocate (getbin=1)Cell allocated for bin pickupCI,32,7,0
portbinreadyBin (with content code) ready for pickup
binfromportBin at the top of custom portGRIDBL,24240,1,32,7,4421,G,10,330
Bin on robotBL,24240,1
Only at this point is the port ready to retrieve the next bin using the portbinready method. Otherwise, error 1128 – BIN_IN_CELL_AWAITING_GET will be returned by the interface.
Bin dropped at top locationGRIDBL,24240,1,30,8,141,G
closeportCLOSEDPM,21,C