Files
bj_power/bj_power_mes/internal/logic/agv_points.go
T

148 lines
5.2 KiB
Go
Raw Normal View History

package logic
import "strings"
// AGV 点位真源(2026-11-14 用户终版;物理布局唯一权威仍是 产线布局说明.md)。
//
// 边界(用户 2026-11-14 三次澄清,逐字对齐):
// - dock(接驳台)与 agv_point(AGV 点位)本来就是两张独立表,不合并、不重命名、不改编码。
// - GW* 只是 agv_point.position_code,是将来调用 AGV/RCS 接口时要传的点位参数;
// 产线布局说明.md 的 GxL/GxR 命名、接驳台 DOCK01~20 / JBT21 编码一律不动。
// - 本文件只负责把「工位 + 物理左右」与「AGV 传参点位码」及「接驳台」对应上。
//
// 命名:Z=左、Y=右(中文简称)。
// 上排单数工位(1/3/5/7/9):地图左台=GWxZ、地图右台=GWxY。
// 下排双数工位(2/4/6/8/10):左右名称互换,地图左台=GWxY、地图右台=GWxZ。
// 与 产线布局说明.md:9「工位2 G2R(地图左)/G2L(地图右)」一一对应:GW2Y↔G2R、GW2Z↔G2L,
// 与 :131「工位2后接驳台1/2 = G2R/G2L」及 seedDocks 的 side 互换规则一致,不是新口径。
// 接驳台序号固定:DOCK(2n-1)=工位n地图左台,DOCK(2n)=工位n地图右台。
//
// 注意:参数 side 指【物理/地图左右】,不是 dock.side(操作员左右,下排工位与地图相反)。
// 对应关系自洽:地图左台 = DOCK(2n-1) = 下排 dock.side=right = GW 码名字带 Y(右);
// 地图右台 = DOCK(2n) = 下排 dock.side=left = GW 码名字带 Z(左)。
// 现有工位终端界面按 dock.side 显示「左/右」,本轮按用户「不是让你改东西」不动界面;
// 若后续要求「界面选左」直接出 GW 码,需先拍板两种左右的换算口径(见回包【异议】)。
// AgvStorePoint 库房收货接驳台(唯一允许人工派车的接驳台点位)。
const AgvStorePoint = "JBT21"
// AgvPointDef 一条 AGV 点位定义。DockSeq:0=虚拟点;1~20=对应 DOCK 序号;21=库房 JBT21。
type AgvPointDef struct {
Code string
Name string
IsDock bool
DockSeq int
}
var agvVirtualPoints = []AgvPointDef{
{"A1", "虚拟点位 A1", false, 0},
{"A2", "虚拟点位 A2", false, 0},
{"A3", "虚拟点位 A3", false, 0},
{"A4", "虚拟点位 A4", false, 0},
{"XW", "线尾虚拟点位 XW", false, 0},
{"XT", "线头虚拟点位 XT", false, 0},
{"KF1", "库房虚拟点位 KF1", false, 0},
}
// AgvPointOf 工位号 + 物理左右 → AGV 接口传参点位码。
// 例:AgvPointOf(2, "left") = "GW2Y"(工位2 地图左台,用户终版)。
// 运行时不用正则:固定格式按字符串比较与拼接解析。
func AgvPointOf(stationNo int, side string) string {
if stationNo < 1 || stationNo > 10 {
return ""
}
if side != "left" && side != "right" {
return ""
}
isEven := stationNo%2 == 0
isLeft := side == "left"
// 单数:左 Z 右 Y;双数:左 Y 右 Z
useZ := (!isEven && isLeft) || (isEven && !isLeft)
suffix := "Y"
if useZ {
suffix = "Z"
}
return "GW" + strconvItoa(stationNo) + suffix
}
// AgvDockSeqOf 工位号 + 物理左右 → 对应接驳台序号(DOCK 编号尾部数字)。
func AgvDockSeqOf(stationNo int, side string) int {
if stationNo < 1 || stationNo > 10 || (side != "left" && side != "right") {
return 0
}
if side == "left" {
return 2*stationNo - 1
}
return 2 * stationNo
}
// AgvAllPoints 全量 28 个点位:20 工位接驳台 + 1 库房接驳台 + 7 虚拟点位。
func AgvAllPoints() []AgvPointDef {
out := make([]AgvPointDef, 0, 28)
for n := 1; n <= 10; n++ {
for _, side := range []string{"left", "right"} {
cn := "左"
if side == "right" {
cn = "右"
}
out = append(out, AgvPointDef{
Code: AgvPointOf(n, side),
Name: "工位" + strconvItoa(n) + cn + "接驳台",
IsDock: true,
DockSeq: AgvDockSeqOf(n, side),
})
}
}
out = append(out, AgvPointDef{Code: AgvStorePoint, Name: "库房收货接驳台", IsDock: true, DockSeq: 21})
out = append(out, agvVirtualPoints...)
return out
}
// IsAgvVirtualPoint 是否 7 个虚拟点位之一(不在物理图上、无接驳台)。
func IsAgvVirtualPoint(code string) bool {
for _, p := range agvVirtualPoints {
if p.Code == code {
return true
}
}
return false
}
// AgvManualAllowed 人工派车白名单硬闸门:只允许 JBT21 和 7 个虚拟点位;
// 所有 GW*(工位接驳台)与 DOCK*(历史业务点位)一律禁止。
func AgvManualAllowed(code string) bool {
if code == "" {
return false
}
if code == AgvStorePoint {
return true
}
if strings.HasPrefix(code, "GW") {
return false
}
return IsAgvVirtualPoint(code)
}
// AgvTemplateOf 目标点 → 送 RCS 的任务模板:JBT21 或 GW* → B01 举升;虚拟点 → B02 移动。
// 返回空串表示历史点位(DOCK*/待命/充电),由调用方按库内 is_dock 兜底,避免动既有派车链路。
func AgvTemplateOf(code string) string {
if code == AgvStorePoint || strings.HasPrefix(code, "GW") {
return "B01"
}
if IsAgvVirtualPoint(code) {
return "B02"
}
return ""
}
// strconvItoa 局部封装:避免为 1~10 的工位号引入正则或 fmt 依赖。
func strconvItoa(n int) string {
if n == 10 {
return "10"
}
if n >= 1 && n <= 9 {
return string(rune('0' + n))
}
return ""
}