Files
bj_power/bj_power_mes/internal/plc/plc.go
T
SunYF 46fcb59079 feat: 退料闭环定稿(损耗台账/备料清单/退料AGV自动派车/剩余量参考)+ 工位托盘守卫
- MES 新增损耗台账 loss_ledger,差异确认损耗接口 ConfirmReceiveLoss(按工单归集)
- 备料清单 preparation:MES 按 日计划×工单×工位×物料 实时计算,WMS 只读展示 PreparationList
- 退料闭环:N5 工位托盘守卫(未完成禁止退料)、退料 AGV 自动派车(JBT21 空位判定 + 托盘回收链路)、退料参考剩余量接口(应剩余=实备-已耗-已退-已损)
- 新增 AGV 车辆状态表 agv_vehicle_state 及查询
- 整合接驳台/叫料池/库存锁既有闭环,清理 sql 目录注释生成脚本与 catalog,更新文档
2026-11-04 19:06:03 +08:00

191 lines
6.6 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 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)
}