GateKeeper Conveyor - UI States¶
The GateKeeper application moves through several states during normal operation. This guide describes each state, what the screen looks like, what actions are available, and how the system transitions between states.
State Overview¶
| State | Status Bar Color | Status Text | Validation Toggle |
|---|---|---|---|
| Starting Up | Orange | "Initializing hardware..." | Off |
| Ready (Idle) | Green or Black | "Hardware initialized - Ready" | Off |
| Hardware Warning | Orange | "Hardware warnings: [device list]" | Off |
| Validation Active | Green | "Validation Active - [Mode]" | On (green LED) |
| Pass Result | Black | "Status: Ready" | On (green LED) |
| Fail Result | Black | "Status: Ready" | On (green LED) |
| Error | Red | "Status: Error: [message]" | On (green LED) |
| Validation Stopped | Gray | "Validation Stopped" | Off |
| Shutting Down | Orange | "Shutting down..." | Off |
Detailed State Descriptions¶
Starting Up¶
When: The application has just launched and is connecting to hardware.
What you see: - Status bar color: Orange - Status text: "Status: Initializing hardware..." - Validation toggle: Off - History list: Empty - Totals: All zeros - Center panel: No scan data
What happens during this state: 1. The application connects to all configured cameras 2. The application connects to the RFID reader (if configured) 3. The application connects to the Arduino controller (if configured) 4. Import services start monitoring their respective directories or network connections
What you can do: Wait for initialization to complete. This typically takes 5-15 seconds.
Transitions to: - Ready (Idle) if all hardware connects successfully - Hardware Warning if some devices fail to connect - Error if hardware initialization fails completely
Ready (Idle)¶
When: Hardware is initialized and the system is waiting for validation to be turned on.
What you see: - Status bar color: Green (all devices online) or Black (ready) - Status text: "Status: Hardware initialized - Ready" - Validation toggle: Off - Mode label: "Mode: Off" - Center panel: "Ready to scan" in gray text
What you can do: - Turn validation on by tapping the validation toggle - Open the diagnostics panel to test hardware - Open settings (requires PIN)
Transitions to: - Validation Active when you turn the toggle on
Hardware Warning¶
When: The application started, but one or more hardware devices did not connect.
What you see: - Status bar color: Orange - Status text: "Status: Hardware warnings: [list of offline devices]" - Validation toggle: Off
What you can do: - Open the diagnostics panel to check which devices are offline - Attempt to start validation (it may work with reduced functionality depending on which device is offline) - Check physical hardware connections and restart the application
Common causes: - A camera is powered off or disconnected from the network - The RFID reader is unreachable - The Arduino controller USB cable is disconnected
Transitions to: - Validation Active if you turn the toggle on (validation will attempt to work with available hardware) - Ready (Idle) after restarting the application with hardware issues resolved
Validation Active¶
When: The validation toggle is on and the system is actively scanning items.
What you see: - Status bar color: Green - Status text: "Status: Validation Active - [Mode name]" - Validation toggle: On (green LED) - Mode label: "Mode: [current mode]" (e.g., "Mode: Teasdale") - Stack lights: Typically yellow (idle/waiting for next item) -- pattern depends on site configuration
What happens: - The system is waiting for items to trigger the photoeye sensor - When an item is detected, the scan and validation process runs automatically - Results appear in the history list and center panel
What you can do: - Monitor scan results as items pass through - Tap history items to review previous results - Turn validation off by tapping the toggle - Reset counts
Transitions to: - Pass Result when an item passes validation - Fail Result when an item fails validation - Validation Stopped when you turn the toggle off
Pass Result¶
When: An item has just been validated and passed.
What you see: - Status bar color: Black (returns to "Ready") - Last Scan result: "PASS" in green text, with processing time in milliseconds - Last Scan timestamp: Time of the scan - Center panel: Large "PASS" text in green - History list: New green entry at the top - Stack light: Green (briefly, depending on configuration) - Totals: Pass count incremented by 1
What you can do: - No action needed -- the system returns to waiting for the next item automatically - Tap the entry in the history list to review the details
Transitions to: - Validation Active (returns to waiting for the next item) - Pass Result or Fail Result when the next item is scanned
Fail Result¶
When: An item has just been validated and failed.
What you see: - Status bar color: Black (returns to "Ready") - Last Scan result: "FAIL" in red text, with processing time in milliseconds - Last Scan timestamp: Time of the scan - Center panel: Large "FAIL" text in red, followed by the specific failure reason - History list: New red entry at the top - Stack light: Red (briefly, depending on configuration) - Totals: Fail count incremented by 1
Failure reason examples: - "GTIN mismatch: expected 00012345, found 00098765" - "Missing UCC-128 barcode" - "No matching RFID data" - "Expiration date mismatch: expected 2026-06-15, found 2026-07-01"
If reject is enabled at the site, the reject mechanism also fires to divert the item off the line.
What you can do: - Note the failure reason for troubleshooting - If failures are repeating, check if the correct production job is loaded - If failures persist, escalate to a supervisor or check the troubleshooting guide
Transitions to: - Validation Active (returns to waiting for the next item) - Consecutive Failure Stop if the failure threshold is reached (see below)
Consecutive Failure Stop¶
When: The system has seen too many failures in a row (the threshold is configured per site, typically 5-10 consecutive failures).
What you see: - The conveyor may stop (if stop signal is enabled) - An alert or horn may sound - The validation toggle may turn off automatically
What this means: Something is likely wrong -- the wrong job is loaded, a label is repeatedly incorrect, or hardware is malfunctioning.
What you can do: 1. Investigate the failure reasons in the history list 2. Verify the correct production data is loaded 3. Check that labels are printing correctly 4. Once the issue is resolved, turn validation back on with the toggle
Transitions to: - Validation Active when you turn the toggle back on after resolving the issue
Error¶
When: An unexpected error occurred during validation or hardware communication.
What you see: - Status bar color: Red - Status text: "Status: Error: [error message]"
What you can do: - Note the error message - Check the diagnostics panel for hardware status - If the error persists, restart the application - If restarting does not help, check the log file and escalate
Transitions to: - Validation Active if validation continues despite the error (non-fatal) - Validation Stopped if the error was fatal and validation stopped
Validation Stopped¶
When: The validation toggle was turned off (manually or due to consecutive failure threshold).
What you see: - Status bar color: Gray - Status text: "Status: Validation Stopped" - Validation toggle: Off - Mode label: "Mode: Off" - Stack light: Typically off or in idle pattern
What you can do: - Review the history for recent results - Turn validation back on when ready - Open diagnostics to test hardware
Transitions to: - Validation Active when you turn the toggle on
Shutting Down¶
When: The application is being closed.
What you see: - Status bar color: Orange - Status text: "Status: Shutting down..."
What happens: The application gracefully disconnects from all hardware, stops all services, and saves any pending state.
Scan In Progress (Teasdale mode)¶
In Teasdale mode, the DS9908 hybrid scanner collects three pieces of data for each item: a DataMatrix barcode, a UCC-128 barcode, and an RFID tag read. A progress panel shows which components have been received:
| Component | Indicator |
|---|---|
| UCC-128 barcode | Check mark when received |
| DataMatrix barcode | Check mark when received |
| RFID tag | Check mark when received |
| Countdown timer | Time remaining before scan timeout |
The progress panel appears when a scan begins and hides after the result is displayed.
Where to Go Next¶
- Daily Operations -- What to do during normal operation
- Diagnostics Panel Guide -- Testing hardware
- UI Guide -- Full control reference