using System; using System.Collections.Generic; using System.IO; using System.Linq; using System.Net.Sockets; using System.Text; using System.Text.Json; using System.Threading; using System.Threading.Tasks; namespace YuncangTrace.LocalService.Services.Scan; /// /// 一条扫码通道 = 一台已纳入管理的扫码设备(原 AndroidScanCenter 的 Channel)。 /// /// 绑定键是 **MAC**(设备 DHCP,IP 会变),`LastIp` 只是「最后一次见到」的缓存。 /// 通道**不再区分团购/散单**——团散在「工作台」上区分。 /// public sealed class ScanChannel { /// 设备 MAC(12 位十六进制,大写) public string Mac { get; set; } = string.Empty; /// 通道号(添加时分配最小空号,之后固定;上报时就是 channelId) public int Number { get; set; } /// 显示名(默认取设备 HostName,可改) public string Name { get; set; } = string.Empty; /// 最后一次见到的 IP public string LastIp { get; set; } = string.Empty; /// 设备 TCP 端口(设备当服务端;桌面端用 8087,避开 Android 中控的 8086) public int TcpPort { get; set; } = ScanProtocol.TcpPort; /// /// 设备上我们实际用的 SOCK 条目名。 /// /// 默认是 (packcenter);但设备最多只能放 3 条条目, /// 满了时会**复用一条非保留条目**(把它的名字拿去改成 8087),那时这里记的就是被复用的名字。 /// public string SockName { get; set; } = string.Empty; /// 扫码枪是否静音(现场偏好,暂只记录) public bool Muted { get; set; } public long AddedAtMs { get; set; } = DateTimeOffset.Now.ToUnixTimeMilliseconds(); // ---------------- 运行时状态(不落盘) ---------------- /// TCP 连接状态 [System.Text.Json.Serialization.JsonIgnore] public bool Connected { get; set; } /// 最近一条条码 [System.Text.Json.Serialization.JsonIgnore] public string LastCode { get; set; } = string.Empty; /// 最近条码时间 [System.Text.Json.Serialization.JsonIgnore] public DateTime? LastCodeAt { get; set; } [System.Text.Json.Serialization.JsonIgnore] public string DisplayName => string.IsNullOrWhiteSpace(Name) ? (string.IsNullOrEmpty(Mac) ? "(未知)" : Mac) : Name.Trim(); /// 上报给服务端的 channelId(用通道号,稳定且短) [System.Text.Json.Serialization.JsonIgnore] public string ChannelId => Number.ToString(); } /// 通道配置读写(普通模式 `%LOCALAPPDATA%\YuncangTrace\channels.json`;服务模式 `%ProgramData%\YuncangTrace\channels.json`) public static class ChannelStore { private static string Dir => AgentPaths.DataRoot; private static string FilePath => AgentPaths.ChannelsFile; private static readonly JsonSerializerOptions Options = new() { WriteIndented = true, Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping, }; /// 读通道列表(读不到返回空列表,绝不抛) public static List Load() { try { if (!File.Exists(FilePath)) return new List(); var list = JsonSerializer.Deserialize>(File.ReadAllText(FilePath), Options) ?? new List(); NormalizeNumbers(list); MigratePort(list); return list; } catch (Exception ex) { AppLog.Write($"[scan] 读取通道配置失败:{ex.Message}"); return new List(); } } /// 保存通道列表(只落盘持久字段,运行时状态由 JsonIgnore 排除) public static void Save(IEnumerable channels) { try { Directory.CreateDirectory(Dir); File.WriteAllText(FilePath, JsonSerializer.Serialize(channels.ToList(), Options)); } catch (Exception ex) { AppLog.Write($"[scan] 保存通道配置失败:{ex.Message}"); } } /// 老数据/缺号的数据补齐通道号(分配最小空号,删掉的不复用) private static void NormalizeNumbers(List list) { var used = new HashSet(list.Where(item => item.Number > 0).Select(item => item.Number)); foreach (var channel in list.Where(item => item.Number <= 0)) { var number = 1; while (used.Contains(number)) number++; channel.Number = number; used.Add(number); } } /// 分配最小的空号 public static int NextNumber(IEnumerable channels) { var used = new HashSet(channels.Select(item => item.Number)); var number = 1; while (used.Contains(number)) number++; return number; } /// /// 旧配置里存的是 8086(早期跟 Android 中控共用的端口)→ 改成桌面端自己的端口。 /// 改了之后设备上还没这条条目,靠「连不上时自愈」自动建。 /// private static void MigratePort(List list) { var migrated = list.Where(item => item.TcpPort != ScanProtocol.TcpPort).ToList(); if (migrated.Count == 0) return; foreach (var channel in migrated) { AppLog.Write($"[scan] 通道 {channel.Number} 端口 {channel.TcpPort} → {ScanProtocol.TcpPort}(不再与 Android 中控的 8086 共用)"); channel.TcpPort = ScanProtocol.TcpPort; } Save(list); } /// 通道号上限(与原中控一致:现场是工位号,量级几十) public const int MaxNumber = 50; /// 某个号是否已被别的通道占用( 用于「改自己」时排除自己) public static ScanChannel? FindByNumber(IEnumerable channels, int number, string? exceptMac = null) { return channels.FirstOrDefault(item => item.Number == number && (exceptMac is null || !item.Mac.Equals(exceptMac, StringComparison.OrdinalIgnoreCase))); } } /// 扫码链路用到的常量(与设备固件一致) public static class ScanProtocol { /// UDP 发现 / JCMD 端口(设备监听) public const int UdpPort = 48899; /// /// 设备侧 TCP 监听端口(设备当服务端,把串口数据推给连上来的人)。 /// /// ⚠️ 不用 8086:那是 Android 中控(条目 `scancenter`)在用的。同一台设备上 /// 两条连接都往串口写,设置会互相覆盖(Android 那边重连时会把静音顶掉)。 /// 桌面端用**自己的条目名 + 自己的端口**,互不干扰。 /// public const int TcpPort = 8087; /// 广播报文(`ConnectMode` 必须是 Forbidden:只发现,不改设备服务器配置) public const string BroadcastPayload = "{\"Agent\":0,\"Type\":\"EP_Tool\",\"PasswordEn\":0,\"ServPort\":0,\"Version\":\"3.1.3f\"," + "\"ConnectMode\":\"Forbidden\",\"Zone\":\"EPort\",\"ServEn\":1,\"ServAddr\":\"0.0.0.0\",\"ClientEn\":0}"; // JCMD 命令号 /// 读配置(10003→10004) public const int CidGetConfig = 10003; /// 读运行状态(10001→10002):只有它回来的 SOCK 条目才带 `ClientIP` public const int CidGetState = 10001; /// 写配置(10005→10006,增量;SOCK 段是整条写) public const int CidSetConfig = 10005; /// 把配置落 flash(10017→10018):不落盘的话一次重载就丢(原中控已实测) public const int CidSaveFlash = 10017; public const int CidDoRestart = 20003; /// 桌面端自己的 SOCK 条目名(不能跟 Android 的 `scancenter` 重名) public const string SockName = "packcenter"; /// 条码合法性(与原中控一致:去空白后 4~64 位,不含控制字符) public static string? CleanBarcode(string? raw) { if (string.IsNullOrWhiteSpace(raw)) return null; // 设备每 ~0.7s 推一帧 `04 D0 00 00 FF 2C`:控制字节会被当分帧清掉, // 但结尾那个 0x2C(',')是可打印字符,会粘在紧接着的条码前面, // 现场出现的就是 `,6901028011778`。条码本体不会以非字母数字开头/结尾, // 所以首尾的非字母数字一律削掉(**中间的保留**,GS1 内部可能有 `-` `/`)。 var text = raw.Trim(); text = System.Text.RegularExpressions.Regex.Replace(text, "^[^0-9A-Za-z]+", string.Empty); text = System.Text.RegularExpressions.Regex.Replace(text, "[^0-9A-Za-z]+$", string.Empty); if (text.Length is < 4 or > 64) return null; if (text.Any(ch => char.IsControl(ch))) return null; return text; } /// /// 收一个 UDP 包,带**真实超时**。 /// /// ⚠️ `UdpClient.Client.ReceiveTimeout` 只对**同步** `Receive` 生效, /// `ReceiveAsync` 完全不看它 —— 设备不回应时会一直挂着(自愈/读配置就卡死在那里)。 /// /// 收到返回字节;超时返回 null(调用方据此当“没应答”处理) public static async Task ReceiveWithTimeoutAsync(UdpClient udp, int timeoutMs, CancellationToken ct = default) { using var cts = CancellationTokenSource.CreateLinkedTokenSource(ct); cts.CancelAfter(timeoutMs); try { var received = await udp.ReceiveAsync(cts.Token).ConfigureAwait(false); return received.Buffer; } catch (OperationCanceledException) when (!ct.IsCancellationRequested) { return null; // 超时 } } /// UTF-8 无 BOM 字节(UDP/TCP 报文都用它) public static byte[] Utf8(string text) => new UTF8Encoding(false).GetBytes(text); }