feat: 多系统新增扫码中间件与 AGV 对接,优化拧紧与退库流程

新增扫码中间件支持网络型扫码枪键盘注入,AGV 对接从 WMS 迁至 MES 统一管理;新增拧紧不合格人工处置与 PLC 对账机制,优化退库单关联与工位终端功能,同时清理旧 AGV 任务表,完善数据库与配置项。
This commit is contained in:
SunYF
2026-10-14 17:24:59 +08:00
parent 8e6048c64b
commit f65a52d9e1
170 changed files with 15415 additions and 10572 deletions
+39 -4
View File
@@ -4,6 +4,7 @@ import (
"context"
"strconv"
"strings"
"sync"
"time"
"bj_power_mes/internal/config"
@@ -24,15 +25,18 @@ type Client interface {
QueryDockPallet(ctx context.Context, dockCode string) (bool, error)
// QueryStationPallet 查询某工位(stationNo)托盘位是否有件(读 PLC 工位托盘传感器信号)。
// 用于 PLC↔MES 对账(#8):PLC 说有位、MES 说无工件 ⇒ mismatch。
// 暂未接真实 PLC 时 mock 按置位返回(默认无件);真实 S7 对接待 PLC 点位表
// (G1~G10→M895.0~M896.1、C15→M898.0)后由 tcp 实现补读寄存器逻辑。
// 暂未接真实 PLC 时 mock 按置位返回(默认无件);真实 S7 对接(G1~G10→M895.0~M896.1、C15→M898.2)
// 后由 tcp 实现补读寄存器逻辑。
QueryStationPallet(ctx context.Context, stationNo int) (bool, error)
}
// Manager 管理 PLC 客户端实例
type Manager struct {
client Client
mock bool
client Client
mock bool
onRecover func(ctx context.Context)
mu sync.Mutex
consecFails int
}
func NewManager(c config.PlcConf, mock bool) (*Manager, error) {
@@ -49,6 +53,37 @@ func (m *Manager) Get() Client { return m.client }
func (m *Manager) IsMock() bool { return m.mock }
// SetOnRecover 设置 PLC 通讯恢复回调(#8 T6):连续失败后首次成功沿触发一次全量对账。
// mock 模式查询恒成功、无失败,永不触发;真实 S7 连接恢复时触发 CheckAllMismatch。
func (m *Manager) SetOnRecover(f func(ctx context.Context)) {
m.mu.Lock()
m.onRecover = f
m.mu.Unlock()
}
// QueryStationPallet 读工位托盘位(带恢复检测):查询成功且此前发生过失败 → 触发 OnRecover(T6)。
func (m *Manager) QueryStationPallet(ctx context.Context, stationNo int) (bool, error) {
v, err := m.client.QueryStationPallet(ctx, stationNo)
m.track(err)
return v, err
}
// track 失败计数:连续失败后首次成功沿触发一次 OnRecover(避免阻塞查询调用方,异步触发)。
func (m *Manager) track(err error) {
m.mu.Lock()
defer m.mu.Unlock()
if err != nil {
m.consecFails++
return
}
if m.consecFails > 0 {
m.consecFails = 0
if m.onRecover != nil {
go m.onRecover(context.Background())
}
}
}
// SetMockDockPallet 仅在 mock 模式下生效:手动置位某接驳台是否有托盘(联调用)。
func (m *Manager) SetMockDockPallet(dockCode string, has bool) {
if !m.mock {
+174 -20
View File
@@ -2,41 +2,195 @@ package plc
import (
"context"
"fmt"
"strconv"
"strings"
"sync"
"time"
"github.com/robinson/gos7"
"bj_power_mes/internal/config"
)
// tcpClient 占位:对接西门子 S7 的实现签名。
// 本项目以 mock 为主,真实 S7 对接预留(寄存器写工序码、读完成信号位)。
// 西门子 S7 真读:48 位块(MB895..MB900,6 字节)覆盖产线点位信号。
// 位布局(按业务口径 2026-10 定稿,锚点 C15=M898.2):
//
// 位 0..11 G1..G12 工位托盘位(工位 n 的托盘传感器,QueryStationPallet 读)
// 位 12..26 C1..C15 主线缓存位(C15=M898.2 → 位 26)
// 位 27..46 DOCK01..DOCK20 工位接驳台托盘位(每工位 2 个,共 20)
// 位 47 JBT21 库房接驳台(AGV 取料位)
//
// 注:真实点位表以现场 PLC 工程师确认为准;以下布局由 C15=M898.2 反推,已满足 48 位自洽。
const (
plcBlockStartByte = 895
plcBlockBytes = 6
plcReadTimeout = 30 * time.Second
)
// s7Real 真实西门子 S7 客户端(gos7),持有一条长连接,断线惰性重连。
type s7Real struct {
c config.PlcConf
handler *gos7.TCPClientHandler
client gos7.Client
mu sync.Mutex
}
func newS7Real(c config.PlcConf) *s7Real {
h := gos7.NewTCPClientHandler(c.Host, c.Rack, c.Slot)
h.Timeout = plcReadTimeout
return &s7Real{c: c, handler: h}
}
// ensure 惰性连接 + 断线重连。
func (s *s7Real) ensure() error {
if s.client != nil {
return nil
}
if err := s.handler.Connect(); err != nil {
return err
}
s.client = gos7.NewClient(s.handler)
return nil
}
// readBlock 读取 48 位块(MB895..MB900)原始 6 字节。
func (s *s7Real) readBlock(ctx context.Context) ([]byte, error) {
s.mu.Lock()
cl := s.client
need := cl == nil
if need {
if err := s.ensure(); err != nil {
s.mu.Unlock()
return nil, err
}
cl = s.client
}
s.mu.Unlock()
buf := make([]byte, plcBlockBytes)
done := make(chan error, 1)
go func() { done <- cl.AGReadMB(plcBlockStartByte, plcBlockBytes, buf) }()
select {
case <-ctx.Done():
return nil, ctx.Err()
case err := <-done:
if err != nil {
s.mu.Lock()
_ = s.handler.Close()
s.client = nil
s.mu.Unlock()
return nil, err
}
return buf, nil
}
}
// readByte 读取单个 Merker 字节(用于 48 位块之外的完成信号位等)。
func (s *s7Real) readByte(ctx context.Context, byteOffset int) (byte, error) {
s.mu.Lock()
if err := s.ensure(); err != nil {
s.mu.Unlock()
return 0, err
}
cl := s.client
s.mu.Unlock()
buf := make([]byte, 1)
done := make(chan error, 1)
go func() { done <- cl.AGReadMB(byteOffset, 1, buf) }()
select {
case <-ctx.Done():
return 0, ctx.Err()
case err := <-done:
if err != nil {
s.mu.Lock()
_ = s.handler.Close()
s.client = nil
s.mu.Unlock()
return 0, err
}
return buf[0], nil
}
}
// bit 取块内某位(bitOffset 0..47)。
func bit(buf []byte, offset int) bool {
if offset < 0 || offset >= len(buf)*8 {
return false
}
return buf[offset/8]&(1<<(offset%8)) != 0
}
// dockOffset DOCK 编码 → 块内位偏移;JBT21 单独处理。
func dockOffset(dockCode string) (int, bool) {
dockCode = strings.ToUpper(strings.TrimSpace(dockCode))
if dockCode == "JBT21" {
return 47, true
}
if !strings.HasPrefix(dockCode, "DOCK") {
return 0, false
}
n, err := strconv.Atoi(strings.TrimPrefix(dockCode, "DOCK"))
if err != nil || n < 1 || n > 20 {
return 0, false
}
return 27 + (n - 1), true
}
// tcpClient 真实 S7 对接实现(替换原 mock 占位)。
type tcpClient struct {
c config.PlcConf
c config.PlcConf
real *s7Real
}
func newTcpClient(c config.PlcConf) *tcpClient {
return &tcpClient{c: c}
return &tcpClient{c: c, real: newS7Real(c)}
}
// SendProcessCode 下发工位组合(如 "1,3,5"),返回已下发工位码。
// 真实 S7:应把组合码写入 PLC 工艺寄存器;寄存器地址待现场点位表确认,当前仅解析并打点。
func (t *tcpClient) SendProcessCode(_ context.Context, combination string) ([]int, error) {
return parseCombination(combination), nil
codes := parseCombination(combination)
// TODO(PLC): 待点位表确认后在此 gos7.WriteArea 写入组合码寄存器
return codes, nil
}
func (t *tcpClient) QueryDone(_ context.Context) (bool, error) {
return true, nil
// QueryDone 查询最近一次下发是否收到完成信号。
// 读 DoneByte.DoneBit(待点位表确认);未配置时安全返回 false(不下发下一条,不误进)。
func (t *tcpClient) QueryDone(ctx context.Context) (bool, error) {
if t.c.DoneByte < 0 || t.c.DoneBit < 0 {
return false, nil
}
b, err := t.real.readByte(ctx, t.c.DoneByte)
if err != nil {
return false, err
}
return b&(1<<(t.c.DoneBit%8)) != 0, nil
}
func (t *tcpClient) AckDone(_ context.Context, ok bool) {
_ = ok
// AckDone 真实 S7 下完成由 PLC 自动置位,无需 MES 写;保留接口。
func (t *tcpClient) AckDone(_ context.Context, _ bool) {}
// QueryDockPallet 读接驳台托盘传感器(AGV 到达目的地前确认接驳台空闲)。
func (t *tcpClient) QueryDockPallet(ctx context.Context, dockCode string) (bool, error) {
offset, ok := dockOffset(dockCode)
if !ok {
return false, fmt.Errorf("未知接驳台编码: %s", dockCode)
}
buf, err := t.real.readBlock(ctx)
if err != nil {
return false, err
}
return bit(buf, offset), nil
}
// QueryDockPallet 读接驳台托盘传感器。真实对接:按 DOCK 编码映射 PLC 寄存器(如 DB101.DBX0.0=DOCK01 托盘到位)。
// 信号定义未确认前返回 false(默认无托盘),待现场 PLC 点位表给到后在此处补读寄存器逻辑。
func (t *tcpClient) QueryDockPallet(_ context.Context, _ string) (bool, error) {
return false, nil
// QueryStationPallet 读工位托盘位(PLC↔MES 对账 #8):G{stationNo} 位。
func (t *tcpClient) QueryStationPallet(ctx context.Context, stationNo int) (bool, error) {
if stationNo < 1 || stationNo > 12 {
return false, fmt.Errorf("工位号越界: %d", stationNo)
}
buf, err := t.real.readBlock(ctx)
if err != nil {
return false, err
}
return bit(buf, stationNo-1), nil
}
// QueryStationPallet 读工位托盘位(PLC↔MES 对账)。真实对接:按工位号映射 PLC 寄存器
// (G1~G10→M895.0~M896.1、C15→M898.0)。信号定义未确认前返回 false(默认无件),
// 待现场 PLC 点位表给到后在此处补读寄存器逻辑(与 QueryDockPallet 同为占位实现)。
func (t *tcpClient) QueryStationPallet(_ context.Context, _ int) (bool, error) {
return false, nil
}