Files
bj_power/bj_power_mes/internal/agv/client.go
T

210 lines
6.8 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Package agv 海康 AGV 调度系统(RCS-Lite V1.5) 对接客户端(2026-10-17 由 RCS-2000 改为 RCS-Lite 1.5)。
// 能力:生成搬运任务(genAgvSchedulingTask)、查询任务状态(queryTaskStatus)、取消任务(cancelTask)。
// 协议详见《AGV海康litev1.5.md》:无签名;所有参数统一字符串;成功 code=="0"。
// 完整请求路径 = BaseURL(已含 /rCMS/services/rest/hikRpcService) + 业务路径。
// 未配置真实 RCS(BaseURL 为空) 或 EnableMock=true 时走 Mock 客户端。
package agv
import (
"bytes"
"context"
"encoding/json"
"fmt"
"io"
"net/http"
"strings"
"time"
"github.com/google/uuid"
"bj_power_mes/internal/config"
)
// Client AGV 调度客户端抽象
type Client interface {
// SubmitTask 下发搬运任务 fromDock -> toDock。taskCode 为我方任务单号(透传给 RCS 便于回查)。
// 成功返回该 taskCode(RCS-Lite 不下发明文任务码,以我方 taskCode 为唯一追踪键)。
SubmitTask(ctx context.Context, taskCode, fromDock, toDock, carrierCode string) (string, error)
// QueryTask 查询任务状态,返回 RCS 数字状态:"1"已创建/"2"执行中/"5"取消完成/"9"已结束。
QueryTask(ctx context.Context, taskCode string) (string, error)
// CancelTask 取消任务(按 taskCode)。
CancelTask(ctx context.Context, taskCode, reason string) error
// Disable 是否处于 Mock(未接真实 RCS)模式。
Disable() bool
}
// New 依据配置返回真实或 Mock 客户端
func New(cfg config.AgvConf) Client {
if cfg.EnableMock || cfg.BaseURL == "" {
return newMockClient()
}
return newRealClient(cfg)
}
// ---------- 请求与响应(真实海康 RCS-Lite) ----------
type realClient struct {
cfg config.AgvConf
hc *http.Client
carrier string
}
func newRealClient(cfg config.AgvConf) *realClient {
return &realClient{
cfg: cfg,
hc: &http.Client{Timeout: 15 * time.Second},
carrier: cfg.CarrierCode,
}
}
// url 拼接 RCS-Lite 基础地址 + 业务路径(BaseURL 已含 /rCMS/services/rest/hikRpcService)。
func (c *realClient) url(path string) string {
return strings.TrimRight(c.cfg.BaseURL, "/") + path
}
// envelope RCS-Lite 统一响应信封(§1.4):code 必填、message 必填、reqCode 回传、data 选填。
type envelope struct {
Code string `json:"code"`
Message string `json:"message"`
ReqCode string `json:"reqCode"`
Data json.RawMessage `json:"data"`
}
// call POST 到 RCS-Lite 并解析信封。成功判定 code=="0";out 非空时把 data 反序列化进去。
func (c *realClient) call(ctx context.Context, path string, payload map[string]any, out any) error {
if payload == nil {
payload = map[string]any{}
}
payload["reqCode"] = uuid.NewString()
payload["reqTime"] = time.Now().Format("2006-01-02 15:04:05")
body, err := json.Marshal(payload)
if err != nil {
return err
}
req, err := http.NewRequestWithContext(ctx, http.MethodPost, c.url(path), bytes.NewReader(body))
if err != nil {
return err
}
req.Header.Set("Content-Type", "application/json;charset=UTF-8")
resp, err := c.hc.Do(req)
if err != nil {
return err
}
defer resp.Body.Close()
raw, err := io.ReadAll(resp.Body)
if err != nil {
return err
}
if resp.StatusCode >= 400 {
return fmt.Errorf("agv http %d: %s", resp.StatusCode, string(raw))
}
var env envelope
if err := json.Unmarshal(raw, &env); err != nil {
return fmt.Errorf("agv parse envelope: %w", err)
}
// 成功码固定字符串 "0"(§1.5 结果码定义)
if env.Code != "0" {
return fmt.Errorf("agv code=%s message=%s", env.Code, env.Message)
}
if out != nil && len(env.Data) > 0 {
return json.Unmarshal(env.Data, out)
}
return nil
}
// SubmitTask 实现 Client:生成搬运任务(genAgvSchedulingTask)。
// 单段搬运:源点(fromDock) → 目标点(toDock) 用 positionCodePath 两个点(type=00 位置编号)表达。
// 任务类型固定 F01(厂内货架搬运);taskCode 透传我方任务单号。
func (c *realClient) SubmitTask(ctx context.Context, taskCode, fromDock, toDock, carrierCode string) (string, error) {
payload := map[string]any{
"taskTyp": "F01",
"positionCodePath": []map[string]any{
{"positionCode": fromDock, "type": "00"},
{"positionCode": toDock, "type": "00"},
},
"priority": c.cfg.Priority,
"taskCode": taskCode,
}
carrier := carrierCode
if carrier == "" {
carrier = c.carrier
}
if carrier != "" {
payload["podCode"] = carrier // 载具/托盘编号(选填)
}
if err := c.call(ctx, "/genAgvSchedulingTask", payload, nil); err != nil {
return "", err
}
// RCS-Lite 不下发明文任务码,以我方 taskCode 为追踪键
return taskCode, nil
}
// queryTaskData queryTaskStatus 的 data 列表项
type queryTaskData struct {
TaskCode string `json:"taskCode"`
TaskStatus string `json:"taskStatus"`
AgvCode string `json:"agvCode"`
TaskTyp string `json:"taskTyp"`
}
// QueryTask 实现 Client:查询任务状态(queryTaskStatus)。
// 按 taskCode 查询,返回匹配项的 taskStatus(数字字符串);无匹配视为刚创建("1")。
func (c *realClient) QueryTask(ctx context.Context, taskCode string) (string, error) {
payload := map[string]any{
"agvCode": "",
"taskCodes": []string{taskCode},
}
var out struct {
Data []queryTaskData `json:"data"`
}
if err := c.call(ctx, "/queryTaskStatus", payload, &out); err != nil {
return "", err
}
for _, d := range out.Data {
if d.TaskCode == taskCode && d.TaskStatus != "" {
return d.TaskStatus, nil
}
}
return "1", nil
}
// CancelTask 实现 Client:取消任务(cancelTask,按 taskCode)。
func (c *realClient) CancelTask(ctx context.Context, taskCode, reason string) error {
if taskCode == "" {
return fmt.Errorf("缺少任务单号")
}
payload := map[string]any{
"taskCode": taskCode,
"forceCancel": "0", // 0=取消后货架放地上(默认)
}
_ = reason // RCS-Lite 取消任务接口无原因字段,原因仅落本地 agv_tasks.remark
return c.call(ctx, "/cancelTask", payload, nil)
}
// Disable 真实客户端非 Mock 模式
func (c *realClient) Disable() bool { return false }
// ---------- Mock 客户端(未接真实 RCS 时用) ----------
type mockClient struct{}
func newMockClient() *mockClient { return &mockClient{} }
func (m *mockClient) SubmitTask(ctx context.Context, taskCode, fromDock, toDock, carrierCode string) (string, error) {
// 模拟立即成功下发,返回我方 taskCode(与真实客户端一致,HikTaskCode=taskNo)
return taskCode, nil
}
func (m *mockClient) QueryTask(ctx context.Context, taskCode string) (string, error) {
// 模拟:MOCK 任务一律视为已结束,便于离线联调观察"待搬运→已到位"
return "9", nil
}
func (m *mockClient) CancelTask(ctx context.Context, taskCode, reason string) error {
return nil
}
func (m *mockClient) Disable() bool { return true }