Files
2026-05-20 09:41:27 +02:00

9.7 KiB
Raw Permalink Blame History

title, type, sources, related, last_compiled
title type sources related last_compiled
AGV — Automated Guided Vehicles module
areas/agvs/index.md
areas/agvs/agv.md
areas/agvs/monitoring/monitoring.md
areas/agvs/monitoring/agv_tasks.md
areas/agvs/monitoring/status_messages.md
areas/agvs/monitoring/cancel_order.md
areas/agvs/monitoring/terminate_order.md
areas/agvs/monitoring/export_messages.md
areas/agvs/monitoring/import_messages.md
areas/agvs/manage_errors/manage_errors.md
areas/agvs/manage_errors/communication_errors.md
areas/agvs/manage_errors/configuration_errors.md
areas/agvs/manage_errors/execution_errors.md
areas/agvs/manage_errors/extraction_error.md
areas/agvs/manage_errors/putaway_error.md
areas/agvs/manage_errors/locktype.md
areas/agvs/manage_errors/trf_movements.md
areas/agvs/configuration/initial_configuration.md
areas/agvs/notificationevents.md
areas/agvs/views/agv_stations_view.md
areas/agvs/views/agv_tasks_view.md
areas/agvs/views/agv_export_view.md
areas/agvs/views/agv_import_view.md
areas/agvs/views/agv_status_view.md
modules/pallet-shuttle.md
concepts/task.md
concepts/location.md
concepts/container.md
concepts/stations.md
2026-04-10

AGV — Automated Guided Vehicles

Overview

An Automated Guided Vehicle (AGV) is a warehouse transport machine similar to a forklift truck that moves automatically along pre-planned paths. AGVs integrate with Easy WMS to execute container transport tasks autonomously, eliminating the need for human operators on repetitive movement routes.

AGVs are created and configured in EasyS or EasyAssistant as station-type elements, assigned to an AGV equipment group. Easy WMS communicates with the AGV system through a database-table-based messaging interface, sending transport orders and receiving execution confirmations. AGVs dramatically improve throughput in automatic warehouses by handling putaway, replenishment, shipping preparation, and cross-location transfers continuously.

The AGV module also supports Pallet Shuttle movements — AGVs can transport pallet shuttle carts between compact rack channels, eliminating the need for manual forklift intervention.

Key capabilities

  • Autonomous container movements: floor → inbound conveyor (PIE), conveyor → storage, storage → stage/dock, storage → storage, AGV → storage
  • Pallet shuttle transport: move PS carts between compact rack channels (with electromagnet attachment)
  • Task prioritization: urgent orders are assigned first; priority can be modified before AGV assignment
  • RFT fallback: when AGVs are unavailable, operators can execute AGV tasks manually via radio frequency terminal
  • Order cancellation and relocation: if an order is canceled mid-execution, Easy WMS searches for a valid putaway location for any loaded container
  • Full message exchange monitoring: export (WMS→AGV) and import (AGV→WMS) message queues are visible and auditable

Architecture

Communication protocol

Easy WMS and the AGV system exchange messages via database tables (not REST or direct API calls). The standard execution flow for a transport order:

Phase Direction Meaning
WMS sends order WMS → AGV Transport order request created
00 AGV → WMS Order accepted
03 AGV → WMS Vehicle assigned
04 AGV → WMS Load permission request (if Can Pick = false)
WMS sends load auth WMS → AGV Load authorization with AGV assignment
06 AGV → WMS Load confirmed
08 AGV → WMS Unload permission request (if Can Drop = false)
WMS sends unload auth WMS → AGV Unload authorization
10 AGV → WMS Unload confirmed — order complete
255 AGV → WMS Order canceled by AGV

AGV station attributes

Field Description
Code Unique AGV station identifier
Control status Current status: available, breakdown, loading, etc.
Number Unique per station type per warehouse
Brand / Model AGV hardware identification

AGV task attributes (key fields)

Field Description
Task number WMS-generated unique order number
Load type 0 = Container, 1 = Pallet Shuttle
Load location / Unload location WMS station code or location
Can pick / Can drop Whether AGV system must request load/unload permission from WMS
Load aisle / Unload aisle Mandatory in FIFO compact racks; optional in LIFO
Priority Execution priority — most urgent tasks dispatched first
Previous task Chained task dependency

Configuration

Initial setup (minimum required)

  1. Configure warehouse layout in EasyS or EasyAssistant:
    • Create a warehouse station linked to an AGV equipment group
    • Add at least one AGV in the group
    • Configure routes from the AGV station to all allowed movement locations
  2. Valid location types for AGV movements: conventional rack, compact (single/multi), dynamic, pushback, cantilever, stage, dock, PIE (inbound conveyor), ET (deposit/loading conveyor)
  3. Locations that allow AGV movements must have a manual loading aisle configured
  4. Optionally enable/disable the Allow loading and Allow unloading flags per location — when disabled, the AGV system requests permission from WMS before proceeding

Lock type for AGV errors

A dedicated location lock type with the "For AGV" flag must be created to manage extraction/putaway errors on non-conventional or non-APS storage locations. Only one such lock type can exist per warehouse. Configure from: Masters > Lock types > Location lock types via Mark for AGV / Unmark for AGV actions.

Operations

Monitoring (PC — AGVs menu)

View Purpose
AGV Stations List of registered AGVs with control status
AGV Tasks All transport orders with status, priority, load/unload locations
Export Messages Messages sent by WMS to AGV system (order creation, update, cancel, auth)
Import Messages Messages received from AGV system (phases 00/03/04/06/08/10/255)
Status Messages AGV status updates: Ready (green), Failure (red), Waiting (gray), Low battery (yellow), Charging (blue)

Task lifecycle management

  • Cancel task: available in Tasks view (Warehouse menu). Two scenarios: (1) AGV not yet loaded → order removed from queue and AGV system notified; (2) AGV has container loaded → WMS searches for valid putaway location using configured strategies; if none found, user notified for manual action
  • Finish task manually: available when AGV is blocked (e.g., physical obstacle). User confirms the unload location manually.

RFT fallback (AGV Movements menu on RFT)

When AGVs are unavailable, operators use the "AGV Movements" option on RFT. Tasks can be filtered by zone. Order selection follows picking process: confirm container at load location, confirm unload location. Issue types during RFT execution:

  • Loading issues: Container not found (→ Lost & Found), Mark for review (→ creates count for location)
  • Unloading issues: Mark for review (→ count created, enter alternate unload location), Mark as full (blocks location), Other location (change unload destination)

Errors & troubleshooting

Error categories

Category Description
Configuration errors Incorrect load/unload station, duplicate order ID, invalid operation type, unload station modification after phase 03, priority modification after assignment
Execution errors Extraction error (no container at pickup), putaway error (destination occupied), container mismatch, no valid relocation found
Communication errors Failures sending order (2500), priority update (2501), cancellation (2502), destination change (2503)

Extraction error behavior

  • Conventional rack / APS locations: Task canceled; location marked with "Mark for review" lock type
  • Other storage locations: Task canceled; location marked with "For AGV" lock type
  • Non-storage locations (stage/dock): Task NOT canceled; AGV held pending manual action; user notified

Putaway error behavior

  • Conventional rack / APS locations: WMS searches for a relocation; location marked with "Mark for review" lock type
  • Other storage locations: WMS searches for relocation; location marked with "For AGV" lock type
  • Non-storage locations: AGV held pending manual action; user notified

All notification events subscribe under the AGV notification group. Severity: Error for all. Subscribable by: SuperAdmin, Administrators, Managers.

Code Error
1001 Incorrect load station
1002 Incorrect unload station
1003 Duplicate transport order
1004 Invalid operation type
1010 Unload station modification error (phase 03+)
1011 Priority modification error (after assignment)
1012 Inactive transport order
1013 Null task number
1014 Inconsistent AGV movement (e.g., unload when not loaded)
2003 Extraction error at non-storage location
2004 Putaway error at non-storage location
2005 Manual cancellation from AGV interface
25002503 Communication errors (order/priority/cancel/destination)
  • pallet-shuttle — AGVs transport PS carts between compact rack channels; battery management automated via AGV
  • task — AGV orders appear as tasks in the warehouse task system
  • location — Location types compatible with AGV movements; lock types configuration
  • container — Containers are the primary payload of AGV transport orders
  • stations — AGV stations (type code: AGV), routes, fleet manager integration
  • warehouse-designer — AGV equipment groups configured in Warehouse Designer / EasyS