- MES 新增损耗台账 loss_ledger,差异确认损耗接口 ConfirmReceiveLoss(按工单归集) - 备料清单 preparation:MES 按 日计划×工单×工位×物料 实时计算,WMS 只读展示 PreparationList - 退料闭环:N5 工位托盘守卫(未完成禁止退料)、退料 AGV 自动派车(JBT21 空位判定 + 托盘回收链路)、退料参考剩余量接口(应剩余=实备-已耗-已退-已损) - 新增 AGV 车辆状态表 agv_vehicle_state 及查询 - 整合接驳台/叫料池/库存锁既有闭环,清理 sql 目录注释生成脚本与 catalog,更新文档
191 lines
6.6 KiB
Go
191 lines
6.6 KiB
Go
package plc
|
||
|
||
import (
|
||
"context"
|
||
"errors"
|
||
"strconv"
|
||
"strings"
|
||
"sync"
|
||
"time"
|
||
|
||
"bj_power_mes/internal/config"
|
||
)
|
||
|
||
// Client PLC 对接抽象。
|
||
// 生产对接西门子 S7:写入工序码寄存器,读完成信号位;未收到完成信号不下发下一条。
|
||
// mock 模式下直接模拟:下发后置发送状态,可主动标记完成。
|
||
type Client interface {
|
||
// SendProcessCode 下发工位组合(如 "1,3,5"),返回已下发工位码
|
||
SendProcessCode(ctx context.Context, processCombination string) ([]int, error)
|
||
// QueryDone 查询最近一次下发是否收到完成信号,完成则返回 true
|
||
QueryDone(ctx context.Context) (bool, error)
|
||
// AckDone 标记完成(mock 使用,也可由 PLC 信号轮询写入)
|
||
AckDone(ctx context.Context, ok bool)
|
||
// QueryDockPallet 查询某接驳台(DOCK01..21)当前是否有托盘(读 PLC 托盘传感器信号)。
|
||
// 用于 AGV 到达目的地前确认接驳台空闲。暂未接真实 PLC 时 mock 返回 false(默认无托盘)。
|
||
QueryDockPallet(ctx context.Context, dockCode string) (bool, error)
|
||
// QueryStationPallet 查询某工位(stationNo)托盘位是否有件(读 PLC 工位托盘传感器信号)。
|
||
// 用于 PLC↔MES 对账(#8):PLC 说有位、MES 说无工件 ⇒ mismatch。
|
||
// 暂未接真实 PLC 时 mock 按置位返回(默认无件);真实 S7 对接(G1~G10→M895.0~M896.1、C15→M898.2)
|
||
// 后由 tcp 实现补读寄存器逻辑。
|
||
QueryStationPallet(ctx context.Context, stationNo int) (bool, error)
|
||
// ReadBits 读取 48 位点位信号(产线布局说明.md §4.1),返回顺序固定:
|
||
// [0..11] G1..G12 工位托盘位
|
||
// [12..26] C1..C15 主线缓存位
|
||
// [27..46] DOCK01..DOCK20 工位接驳台托盘位
|
||
// [47] JBT21 库房接驳台
|
||
// 用于 PLC 手动监控页(一次性读取,不轮询)。
|
||
ReadBits(ctx context.Context) ([]bool, error)
|
||
// ReadMW 读取 16 位寄存器(MW)当前值(大端)。用于监控页读 MW800~MW886。
|
||
ReadMW(ctx context.Context, addr int) (int, error)
|
||
// ReadMWBlock 批量读取连续 MW 寄存器(大端),返回 [start..start+count-1] 每地址的 16 位值。
|
||
// 真实 S7 一次 AGReadMB 读 count*2 字节;看板快照用它一次取 MW800..MW887(44 个路由寄存器),
|
||
// 避免 44 次 ReadMW = 88 次 TCP 往返阻塞 PLC 连接。
|
||
ReadMWBlock(ctx context.Context, start, count int) ([]int, error)
|
||
// WriteMW 向 16 位寄存器(MW)写入值(大端)。用于手动下发路径指令、在途指令清零。
|
||
WriteMW(ctx context.Context, addr, value int) error
|
||
}
|
||
|
||
// Manager 管理 PLC 客户端实例
|
||
type Manager struct {
|
||
client Client
|
||
mock bool
|
||
onRecover func(ctx context.Context)
|
||
mu sync.Mutex
|
||
consecFails int
|
||
mockOffline bool // mock 模式:模拟 PLC 离线(拍板2 联调/自测用,真实 PLC 忽略)
|
||
}
|
||
|
||
func NewManager(c config.PlcConf, mock bool) (*Manager, error) {
|
||
m := &Manager{mock: mock}
|
||
if mock {
|
||
m.client = newMockClient()
|
||
} else {
|
||
m.client = newTcpClient(c)
|
||
}
|
||
return m, nil
|
||
}
|
||
|
||
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)。
|
||
// mock 模式下可经 SetMockOffline 模拟离线(读失败),验证拍板2「PLC 离线提示+人工强行确认」链路。
|
||
func (m *Manager) QueryStationPallet(ctx context.Context, stationNo int) (bool, error) {
|
||
m.mu.Lock()
|
||
off := m.mock && m.mockOffline
|
||
m.mu.Unlock()
|
||
if off {
|
||
err := errors.New("PLC 离线(mock 模拟)")
|
||
m.track(err)
|
||
return false, err
|
||
}
|
||
v, err := m.client.QueryStationPallet(ctx, stationNo)
|
||
m.track(err)
|
||
return v, err
|
||
}
|
||
|
||
// ReadBits 读 48 位点位信号(带恢复检测)。
|
||
func (m *Manager) ReadBits(ctx context.Context) ([]bool, error) {
|
||
v, err := m.client.ReadBits(ctx)
|
||
m.track(err)
|
||
return v, err
|
||
}
|
||
|
||
// ReadMW 读 16 位寄存器(带恢复检测)。
|
||
func (m *Manager) ReadMW(ctx context.Context, addr int) (int, error) {
|
||
v, err := m.client.ReadMW(ctx, addr)
|
||
m.track(err)
|
||
return v, err
|
||
}
|
||
|
||
// ReadMWBlock 批量读连续 MW 寄存器(带恢复检测)。
|
||
func (m *Manager) ReadMWBlock(ctx context.Context, start, count int) ([]int, error) {
|
||
v, err := m.client.ReadMWBlock(ctx, start, count)
|
||
m.track(err)
|
||
return v, err
|
||
}
|
||
|
||
// WriteMW 写 16 位寄存器(带恢复检测)。
|
||
func (m *Manager) WriteMW(ctx context.Context, addr, value int) error {
|
||
err := m.client.WriteMW(ctx, addr, value)
|
||
m.track(err)
|
||
return 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 {
|
||
return
|
||
}
|
||
if mc, ok := m.client.(*mockClient); ok {
|
||
mc.SetDockPallet(dockCode, has)
|
||
}
|
||
}
|
||
|
||
// SetMockStationPallet 仅在 mock 模式下生效:手动置位某工位托盘位是否有件(PLC↔MES 对账联调用)。
|
||
func (m *Manager) SetMockStationPallet(stationNo int, has bool) {
|
||
if !m.mock {
|
||
return
|
||
}
|
||
if mc, ok := m.client.(*mockClient); ok {
|
||
mc.SetStationPallet(stationNo, has)
|
||
}
|
||
}
|
||
|
||
// SetMockOffline 仅在 mock 模式下生效:模拟 PLC 离线(拍板2 2026-11-04 联调/自测用)。
|
||
// 离线期间 QueryStationPallet 返回错误(模拟读失败);真实 PLC 模式忽略。
|
||
func (m *Manager) SetMockOffline(off bool) {
|
||
m.mu.Lock()
|
||
defer m.mu.Unlock()
|
||
if m.mock {
|
||
m.mockOffline = off
|
||
}
|
||
}
|
||
|
||
// parseCombination 解析工位组合 "1,3,5" / "10,11,12" -> [1,3,5] / [10,11,12]
|
||
func parseCombination(s string) []int {
|
||
var out []int
|
||
for _, p := range strings.Split(s, ",") {
|
||
p = strings.TrimSpace(p)
|
||
if p == "" {
|
||
continue
|
||
}
|
||
n, err := strconv.Atoi(p)
|
||
if err != nil || n < 1 {
|
||
continue
|
||
}
|
||
out = append(out, n)
|
||
}
|
||
return out
|
||
}
|
||
|
||
// Sleep 简化轮询间隔(供 logic 使用)
|
||
func Sleep(d time.Duration) {
|
||
time.Sleep(d)
|
||
} |