Files
bj_power/bj_power_mes/internal/plc/plc.go
T
SunYF 9aaa768e6c feat(mes): AGV挂起动作引擎 + 智能跟车流转 + PLC快照缓存(2026-11-19 主控拍板)
一、AGV 挂起动作引擎(弃显式任务队列、弃并发硬拒)
- 新增 internal/logic/agv_pending.go:待发动作直接挂任务(pending_action + pending_since),
  CONTINUE_LIFT(举升完成→continueTask#1)/ WAIT_DROP_CONFIRM(人工确认放下→continueTask#2)
  / FREE_ROBOT(末组完成→freeRobot);系统动作超 60s 未触发转预警人工重试,绝不自动重发
- Client 新增 ContinueTask(RCS 2.1.2) / FreeRobot(3.1.2),仅点名释放指定车,禁止释放全部
- agv_task 增 pending_action/pending_since 字段,ent 重生成 + db.go 幂等迁移补丁 + migrateonce
- 回调按 B01/B02/C01 模板编排:业务流转到位即自动放行放下、回调自动放车;
  仅人工派车(MANUAL)挂 WAIT_DROP_CONFIRM;新增 /agv/confirm-drop、/agv/pending/retry
- 前端 AgvManual/Agv 确认放下、挂起重试按钮与等待提示联动

二、智能跟车 + 动态目标截断流转引擎
- 新增 internal/logic/flow_engine.go:事件驱动(报工/扫码),读 48 位物理快照,从下游往上游算,
  前方占用则动态截断到最近空闲缓存位;IN_TRANSIT 在途闭锁防重复下发,MW=0 才确认到位落台账;
  主线占用=台账 OR 传感器,工位 G 位只认台账;在途超 5s 落预警
- workpiece 增 flow_transit_mw/target/at 字段,ent 重生成 + 迁移补丁

三、PLC 读取优化与诊断
- 新增 internal/plc/snapshot_cache.go:2s TTL + singleflight + 写失效,合并 SSE/PLC监控/流转引擎
  的重复点位读取;tcp.go 读块重构、localip.go 多网卡、plcdiag 诊断工具、plc_monitor/logging 配套

四、文档与前端
- help.js 重写「工位下发」帮助:明确报工自动驱动流转 vs 下发路线码的定位、缺料/握手/撤回边界
- 案例.md 补充定稿说明;public/index.html 构建指纹更新
2026-11-19 23:08:46 +08:00

227 lines
8.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"
"net"
"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
}
// plcSnapshotTTL 48 位快照缓存有效期(2026-11-19 智能跟车):
// 2 秒内对 PLC 的多次全量读合并为一次;写 MW 后立即失效重建,兼顾负载与实时性。
const plcSnapshotTTL = 2 * time.Second
// Manager 管理 PLC 客户端实例
type Manager struct {
client Client
mock bool
onRecover func(ctx context.Context)
onFail func(ctx context.Context, err error) // 2026-11-16:连续失败首次沿触发(通信异常预警),恢复后重置
mu sync.Mutex
consecFails int
mockOffline bool // mock 模式:模拟 PLC 离线(拍板2 联调/自测用,真实 PLC 忽略)
snap *snapshotCache // 48 位快照缓存(读合并 + 写失效)
}
func NewManager(c config.PlcConf, mock bool) (*Manager, error) {
m := &Manager{mock: mock, snap: newSnapshotCache(plcSnapshotTTL)}
// 日志前缀按实际连接目标做路由探测,精确显示连 PLC 走的是哪块网卡的 IP。
target := net.JoinHostPort(c.Host, strconv.Itoa(c.Port))
if mock {
m.client = newLogClient(newMockClient(), target)
} else {
m.client = newLogClient(newTcpClient(c), target)
}
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()
}
// SetOnFail 设置 PLC 通讯失败回调(2026-11-16):连续失败首次沿触发一次(落预警中心),
// 恢复成功后重置——下次再断再触发;持续断连期间不重复触发(防轮询风暴,预警侧另有窗口去重)。
func (m *Manager) SetOnFail(f func(ctx context.Context, err error)) {
m.mu.Lock()
m.onFail = 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
}
// ReadBitsCached 读 48 位快照(2 秒 TTL + singleflight 合并 + 写失效)。
// 看板/监控/流转引擎的"看一眼全量点位"走这里,避免高频轮询打死 PLC;
// 进站、到位等精细业务确认必须走 ReadBits/ReadMW 穿透,拿实时值。
func (m *Manager) ReadBitsCached(ctx context.Context) ([]bool, error) {
return m.snap.get(ctx, m.ReadBits)
}
// 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 位寄存器(带恢复检测)。
// 2026-11-19:写入成功后立即失效 48 位快照——下一条指令/判定读到的是下发后的真实物理状态,
// 杜绝"下发了却仍吃 2 秒前旧缓存"造成误判(用户拍板的写即失效兜底)。写失败不失效(状态未变)。
func (m *Manager) WriteMW(ctx context.Context, addr, value int) error {
err := m.client.WriteMW(ctx, addr, value)
if err == nil {
m.snap.invalidate()
}
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++
// 2026-11-16:连续失败首次沿触发 onFail(通信异常落预警);持续断连不重复触发。
if m.consecFails == 1 && m.onFail != nil {
f := m.onFail
failErr := err
go f(context.Background(), failErr)
}
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)
}