RobotManager Module / Module Quản lý Robot

📋 Overview / Tổng quan

RobotManager Module quản lý state, order, và action của robots, cung cấp APIs cho các module khác và ScriptEngine.

🎯 Mục đích / Purpose

Quản lý toàn bộ thông tin về robots bao gồm state hiện tại, orders đang thực hiện, và actions.

🔧 Chức năng chính / Main Features

1. State Management / Quản lý Trạng thái

Quản lý state mới nhất mà robot gửi lên (không lưu history)
Cập nhật state real-time từ VDA 5050 state messages
Expose state cho các module khác (TrafficControl, ScriptEngine)

2. Order Management / Quản lý Order

Quản lý orders đã yêu cầu xuống robot
Quản lý orders đang thực hiện
Order timeout handling → order failed
Quản lý order theo từng robot

3. Action Management / Quản lý Action

Quản lý instant actions đã gửi
Quản lý actions đang thực hiện
Track action status

⏱️ Order Timeout Handling / Xử lý Timeout Order

flowchart TD
    Start[Robot has active order] --> CheckConnection{Robot<br/>connected?}
    
    CheckConnection -->|Yes| UpdateState[Update state from<br/>VDA 5050 messages]
    CheckConnection -->|No| CheckTimeout{Last state<br/>timeout?}
    
    UpdateState --> HasOrder{Order still<br/>active?}
    HasOrder -->|Yes| Continue[Continue monitoring]
    HasOrder -->|No| Completed[Order completed]
    
    CheckTimeout -->|Yes| OrderFailed[Order failed<br/>Notify modules]
    CheckTimeout -->|No| Wait[Wait for reconnect]
    
    style OrderFailed fill:#ffe6e6
    style Completed fill:#e6ffe6

🔌 APIs cho ScriptEngine

RobotManager expose các APIs cho ScriptEngine thông qua FleetScriptGlobals:

GetRobotById(string robotId): Lấy thông tin robot
GetRobotBySerial(string serialNumber): Lấy robot theo serial number
GetAvailableRobots(): Lấy danh sách robot available
GetRobotState(string robotSerial): Lấy state hiện tại của robot
MoveToNode(string robotSerial, string nodeId): Tạo order di chuyển đến node
MoveToStation(string robotSerial, string stationId): Tạo order di chuyển đến station

🔗 Integration với RobotConnections

Nhận thông báo từ RobotConnections về connection status
Xử lý order timeout dựa trên connection status và last state timestamp

📡 VDA 5050 Protocol Handler

RobotManager cũng xử lý VDA 5050 protocol:

Order Generation: Tạo VDA 5050 orders từ TrafficControl
Order Updates: Tạo OrderUpdate khi TrafficControl yêu cầu
State Processing: Xử lý state messages từ robots
Action Generation: Tạo instant actions

FleetManager Overview - Tổng quan FleetManager
RobotConnections Module - Cung cấp connection status
TrafficControl Module - Sử dụng RobotManager để check robot state
ScriptEngine Module - Sử dụng RobotManager APIs
VDA 5050 Integration - Chi tiết về VDA 5050 protocol

Last Updated: 2025-11-13

3.3 KiB Raw Blame History