简介:这是一套面向工业与物流领域的C#无人值守地磅称重系统源码包,针对称重依赖人工、效率低、数据易错等痛点,提供完整的自动化解决方案,适用于仓储、矿业、化工、港口等场景。资源共243个文件,包含100个C#源码文件、47个DLL动态库、19个XAML界面文件、13个PDF说明文档、11个配置文件、10个报表文件及可执行程序等,压缩包约148MB,结构清晰,便于按模块学习和二次开发。内容上覆盖自动称重流程、数据采集与存储、报表生成、硬件设备对接等关键环节,支持SQLite数据库和报告生成器,并附带使用手册与维护文档,有助于开发者快速掌握整套系统的设计思路与实现细节。目前已有259人学习下载,适合具备一定C#基础的开发人员、自动化项目工程师及物流信息化从业者参考使用。
1. 无人值守地磅称重系统:C# 源码能复现到什么程度
地磅称重这行当,只要经历过一次半夜被叫起来去补手工单,就会明白无人值守不是锦上添花,是刚需。这套基于 C# 的无人值守地磅称重系统设计源码,解决的核心问题就一句话:把原来需要司磅员盯着的「车牌识别 → 上磅 → 稳定读数 → 保存 → 抬杆放行」全流程,改成由上位机软件自动判断、自动执行、自动留痕。它适合正在做工厂物流信息化改造的人,也适合接定制项目需要快速出原型的 C# 上位机开发者。这套源码不是给你看 UI 的,是给你拆业务逻辑的——从串口通信到数据库落库,从信号灯控制到红外防作弊,链路是完整的。我拆完之后的结论是:它是一个能直接跑的骨架,业务流很真实,但现场坑也不少,下面逐层说。
2. 称重系统的整体架构:先看数据怎么流动
2.1 硬件链路:摄像头、红外对射、仪表、道闸是怎么串起来的
无人值守地磅不是软件自己在那干活,软件只是大脑,四肢是外围设备。这套 C# 系统里,设备通信用了串口和网络两种方式。我拆的时候重点关注了设备接入层的抽象方式——它把每种设备封装成了一个独立的服务类,比如相机服务、仪表服务、道闸服务、红外服务,主程序只管调用,不关心底层协议细节。这样的好处是现场换设备品牌时,只需要替换对应的服务类,主流程不用动。
典型链路是这样工作的:车辆驶入地磅区域,触发地感线圈后,入口道闸处的车牌识别相机抓拍并识别车牌号。上位机拿到车牌后,检查数据库里有没有预约信息或白名单,来决定是否允许上磅。车辆上磅停稳后,红外对射检测车辆是否完全位于磅台范围内,防止半车压边作弊。确认到位后,称重仪表通过串口持续发送重量数据,上位机判断重量稳定后锁存读数,拍照留存,然后抬杆放行。
2.2 仪表串口通信:解析重量数据的核心代码
仪表通信是这套系统的命脉。多数地磅仪表用的是 RS232 串口输出连续重量流,波特率常见是 9600 或 19200,数据格式通常是 ASCII 字符串,每条以回车换行结尾。下面是典型的串口数据读取和解析代码:
private SerialPort _serialPort; private void InitializeScalePort(string portName, int baudRate) { _serialPort = new SerialPort(portName, baudRate, Parity.None, 8, StopBits.One); _serialPort.DataReceived += SerialPort_DataReceived; _serialPort.Open(); } private StringBuilder _weightBuffer = new StringBuilder(); private void SerialPort_DataReceived(object sender, SerialDataReceivedEventArgs e) { var data = _serialPort.ReadExisting(); _weightBuffer.Append(data); // 按换行符切分完整帧 string fullData = _weightBuffer.ToString(); int newLineIndex; while ((newLineIndex = fullData.IndexOf('\n')) >= 0) { string line = fullData.Substring(0, newLineIndex).Trim(); fullData = fullData.Substring(newLineIndex + 1); ProcessWeightFrame(line); } _weightBuffer.Clear(); _weightBuffer.Append(fullData); } private void ProcessWeightFrame(string frame) { // 常见格式: "ST,GS, 12.345,kg,ST" if (frame.StartsWith("ST") && frame.Contains("kg")) { var parts = frame.Split(','); if (parts.Length >= 4 && decimal.TryParse(parts[2], NumberStyles.Float, CultureInfo.InvariantCulture, out decimal weight)) { CurrentWeight = weight; OnWeightUpdated?.Invoke(weight); } } }这段代码的关键逻辑在于用StringBuilder做缓冲拼接,而不是单次读多少算多少。串口数据是流式的,一个完整帧可能分两次到达,直接解析会出现半帧错乱。DataReceived事件触发的频率和到达的数据量不一定一一对应,所以用换行符做帧边界判断,帧不完整就留在缓冲区等下一波数据。参数上有几个要注意的点:ReadExisting()一次性读取当前缓冲区全部内容,比ReadLine()更稳,因为ReadLine()遇到超时或空行会异常;Decimal.TryParse必须指定CultureInfo.InvariantCulture,否则在某些系统区域设置下小数点会被当成千分位,解析直接失败。
稳定重量判断的策略是轮询式:比如每 200ms 记录一次重量值,连续 5 次差值都在 ±5kg 以内,就判定重量稳定,才允许保存和抬杆。这套逻辑在源码里的实现是定时器加滑动窗口,实际现场使用效果不错,但需要注意地磅自身的机械振荡,空磅和满载时的稳定时间不一样,后面避坑章会细说。
3. 从源码到能跑:环境准备与数据库初始化
3.1 开发运行环境与依赖组件
这套源码是基于 .NET Framework 还是 .NET Core 写的,决定了你能不能在 Linux 上跑、能不能跨平台部署。我拆包的时候看到项目文件结构是典型的 WinForms/上位机工程,引用的依赖主要是串口通信库、MySQL 或 SQL Server 的驱动,以及第三方 JSON 库。
环境清单大致如下:
| 组件 | 建议版本 | 说明 |
|---|---|---|
| Visual Studio | 2019 或 2022 | 打开解决方案后直接编译 |
| .NET Framework | 4.6.1 及以上 | 如果源码用的是旧版,4.6.1 兼容性最好 |
| 数据库 | MySQL 5.7 或 SQL Server 2016 | 看源码里的连接字符串指向哪里 |
| 串口调试工具 | VSPD / 虚拟串口助手 | 没有真实仪表时用来模拟数据 |
源码里如果自带了.sln和.csproj,直接双击就能编译。但我遇到过不少下载的源码缺少 NuGet 包还原信息,编译时满屏报错。遇到这种情况,先看packages.config或.csproj里的PackageReference节点,把缺失的依赖手动装回来。
3.2 数据库表结构与初始化脚本
无人值守称重系统最怕数据丢了说不清,所以数据库设计是这个源码的亮点。默认库名一般是weighbridge或scale_db,核心表有两张:称重记录主表和车辆/白名单表。称重记录表至少包含以下字段:
CREATE TABLE `t_weigh_record` ( `id` INT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键', `plate_no` VARCHAR(20) NOT NULL COMMENT '车牌号', `weight_in` DECIMAL(10,3) DEFAULT NULL COMMENT '毛重(kg)', `weight_out` DECIMAL(10,3) DEFAULT NULL COMMENT '皮重(kg)', `net_weight` DECIMAL(10,3) GENERATED ALWAYS AS (weight_in - weight_out) STORED COMMENT '净重', `weigh_time` DATETIME NOT NULL COMMENT '称重时间', `operator` VARCHAR(50) DEFAULT 'system' COMMENT '操作员,无人值守填system', `image_path` VARCHAR(255) DEFAULT NULL COMMENT '抓拍图片路径', `is_manual` TINYINT(1) DEFAULT 0 COMMENT '是否人工干预', PRIMARY KEY (`id`), KEY `idx_plate_no` (`plate_no`), KEY `idx_weigh_time` (`weigh_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='称重记录表';初始化时注意两点。第一,MySQL 8.0 的GENERATED ALWAYS AS ... STORED语法没问题,但 5.7 也支持,只是列名和表达式里不能有歧义;第二,utf8mb4是必须的,车牌号可能包含新能源车牌的特殊字符,utf8会报字符集错误。部署时先手动执行建库脚本,再用源码里的连接字符串配置文件修改库名和密码。
3.3 配置文件修改与首次启动
源码里的连接字符串一般集中在App.config或appsettings.json里。常见写法是:
<connectionStrings> <add name="ScaleDb" connectionString="server=127.0.0.1;port=3306;database=weighbridge;user=root;password=your_password;CharSet=utf8mb4;" /> </connectionStrings>修改完配置后,用虚拟串口工具创建一对虚拟串口 COM3 和 COM4,把仪表服务指向 COM3,用串口调试助手往 COM4 发送模拟的重量数据帧,比如:
ST,GS, 10.235,kg,ST ST,GS, 10.238,kg,ST如果界面上重量数字跟着跳动,说明串口通路是通的。这一步验证完,再连真实的仪表和红外对射。整套系统首次启动时,建议先用手动模式跑一遍流程:手动输入车牌、手动保存重量,确认数据库写入正常,再切换到自动模式。
4. 无人值守的业务核心:称重流程状态机设计
4.1 状态定义与转移条件
无人值守最忌讳的是把流程写成一条直线。车辆不是每次都规规矩矩走的,可能倒车、可能压边、可能车牌识别失败。这套源码里的称重流程控制器是用状态机实现的,这一点我觉得做得比较务实。我拆出来的核心状态如下:
Idle:空闲,等待车辆触发PlateRecognized:车牌识别成功,等待上磅确认VehicleOnScale:车辆上磅,红外对射检测到位WeightStable:重量稳定,等待锁存Saving:保存记录和图片GateOpen:抬杆放行Error:异常拦截
状态转移的条件是复合的。比如VehicleOnScale到WeightStable,必须同时满足红外对射为遮挡状态、重量大于某个阈值(防止空车跳变)、连续 N 次重量采样偏差小于允许误差。源码里状态转移的判定代码大致长这样:
public void EvaluateStateMachine() { switch (_currentState) { case WeighState.Idle: if (_cameraService.LastPlateNumber != null) TransitionTo(WeighState.PlateRecognized); break; case WeighState.PlateRecognized: if (_infraredService.IsOccupied) TransitionTo(WeighState.VehicleOnScale); break; case WeighState.VehicleOnScale: if (_infraredService.IsOccupied && _scaleService.IsWeightStable(5, 5)) TransitionTo(WeighState.WeightStable); break; case WeighState.WeightStable: if (_scaleService.CurrentWeight > 100) // 防抖阈值 { _recordService.SaveRecord(_cameraService.LastPlateNumber, _scaleService.CurrentWeight); TransitionTo(WeighState.Saving); } break; case WeighState.Saving: if (_recordService.IsSaveComplete) { _gateService.OpenGate(); TransitionTo(WeighState.GateOpen); } break; } }为什么要用状态机而不是从头写到尾的顺序代码,是因为状态机能处理「中断和回退」。比如车辆在VehicleOnScale状态时突然倒车退出红外区域,状态机会自动回到PlateRecognized等待下一辆车,而顺序代码需要人为加一堆if判断来处理这种回退。另外状态机的每个转移点都是天然的日志埋点——哪一步出错,看状态记录日志就知道卡在哪了。
4.2 超时与重试:防止流程死锁
现场最容易出现的问题是流程死锁。比如红外对射一直处于遮挡状态,系统就一直停在WeightStable不抬杆,后面堵一排车。这个源码里加了超时机制:每个状态都有最大持续时间,超时后进入Error状态,同时声光报警提醒人工介入。
超时参数的设置是有讲究的。Idle状态的超时可以长一些,比如 10 分钟;但VehicleOnScale到WeightStable的超时建议设置在 3 到 5 分钟,因为车辆停稳和仪表稳定通常不需要更久。如果设短了,载重车辆移动慢,还没停稳就被判超时抬杆,容易出安全事故。源码里超时单位是秒,修改时要看清类型。
重试逻辑里最值得学习的是车牌识别失败的处理。相机识别置信度低于阈值时,源码的策略是进入Error状态后重新抓拍,最多重试 3 次,仍失败则转人工。这里有个细节:重试期间道闸不能抬,车不能放行,这是防止有人用假车牌反复尝试。日志里要打上重试次数和每次的置信度,方便事后排查是相机角度问题还是光线问题。
4.3 数据落库时机与图片关联
无人值守和人工过磅最大的区别是证据链。这套系统在重量稳定、保存记录时,会同步抓拍车辆正面、侧面和磅表三个角度的照片,路径存到image_path字段。这个设计我比较认可,因为后续如果要和货运单对账,或者司机投诉重量不对,照片是唯一的回溯凭证。
保存的时机也有讲究:不是进入WeightStable就立刻保存,而是等抬杆指令发出并收到道闸到位信号后再置位完成标记。这样能保证记录和放行动作的一致,避免程序在保存过程中崩溃导致「车放走了但记录没保存」。源码里如果做了事务处理——把记录插入和图片文件移动放在同一个 try-catch 里——这个设计是合格的;如果只是单独插入数据库,你需要自己补上事务保护。
5. 无人值守系统常见问题排查:五个高发故障的处理记录
5.1 串口数据偶发乱码导致重量跳变
现象:运行几小时后,界面重量偶尔跳成 -0.001 或 999999,过一会儿又恢复正常。后台日志里能看到帧解析异常的记录。
原因:地磅仪表到电脑的 RS232 线缆过长或布线靠近动力电缆,电磁干扰导致信号波形畸变,偶发一位数据位错误。这种问题在夏天开大功率设备时更明显。
解决:把串口线换成屏蔽双绞线,两端做好接地。如果距离超过 15 米,改走 RS485 转串口模块。软件层面,在ProcessWeightFrame里增加帧格式校验逻辑,比如重量值必须大于 -50 且小于 200000,否则丢弃该帧不更新界面。这两层叠加,基本能滤掉 99% 的干扰帧。
5.2 红外对射误报遮挡导致流程卡死
现象:磅台上没车,但系统状态一直停在VehicleOnScale,红外状态显示遮挡。
原因:不是真的被挡,是红外对射的接收端被蜘蛛网、灰尘或雨水遮挡,接收信号强度下降导致误判。还有一种情况是两对红外安装距离过近,光路交叉干扰。
解决:软件里不要直接读红外传感器的开关量,而是读它的模拟量信号强度,低于某阈值才判定为遮挡,灰度区间设为报警但不触发状态变化。现场安装时,每对红外之间至少要隔 1.5 米,角度稍微错开。定期清理接收端护罩,频率建议每周一次。
5.3 车牌识别率正常但车牌号保存为空
现象:日志里识别结果有车牌,但在线查询记录时plate_no字段是空的。
原因:这是个典型的异步 bug。摄像头的车牌识别回调线程和主流程保存在不同线程,识别结果写到了一个共享字段,但没加锁。主流程保存记录时读到的可能是旧值或空值。
解决:给车牌号字段加上锁,或者干脆用volatile加lock。更推荐的写法是识别线程把结果放进一个ConcurrentQueue,主流程从队列取出再保存。这样既保证顺序,也避免读写冲突。修复后需要重新编译部署,不改硬件就能解决。
5.4 系统长时间运行后界面假死
现象:运行 3 到 5 天后,界面点按钮没反应,称重数据停止刷新,任务管理器显示程序无响应。
原因:最常见的元凶是 UI 线程被耗时操作阻塞。这个源码里如果所有数据库操作都在 UI 线程同步执行,那么当数据量大或数据库连接池耗尽时,UI 就会被卡住。串口 DataReceived 事件虽然在新线程触发,但调用了 UI 控件更新,会跨线程投递到 UI 线程排队,一堵全堵。
解决:改造思路是把数据库操作全部改成异步,用await Task.Run()或async/await配合ConfigureAwait(false)。如果不想大改,至少把保存记录这种高频操作丢到后台线程。排查时先开任务管理器看 CPU 和线程数,再在关键方法入口加日志,看卡在哪个调用上。
5.5 数据库连接数持续上涨导致写入失败
现象:运行一段时间后,日志出现Too many connections错误,入库失败。
原因:代码里的数据库连接没有正确释放。要么是SqlConnection没放在using块里,要么是每一条称重记录都新建连接但部分路径异常没关闭。时间长了 MySQL 的连接数被耗尽。
解决:统一用using块包裹连接,或者在项目里引入一个数据库访问帮助类,把连接字符串管理和连接释放集中处理。修改后监控 MySQL 的max_connections和processlist,把峰值连接数压到 20 以内。这个改造是必须做的,不然后面上线跑不了一个月就会复现。
6. 数据审计与防作弊:报表对账和数据库层面的深度校验
6.1 利用数据库记录重建过磅时序
无人值守称重系统上线后,最大的管理需求不是「能称重」,而是「能解释清楚每一笔记录」。手工过磅时代,出了问题可以找司磅员问,无人值守时代,你只能问数据库。
我在这个源码基础上做的第一个升级,是给每一条称重记录补充一个「过磅时序」字段。也就是说,数据库中不仅保存毛重和皮重,还要保存车辆从触发PlateRecognized到抬杆放行的完整时间轴。这个逻辑很简单:在状态机的每一次转移处,往一张t_weigh_trace表里追加一行记录,包括状态名、时间戳和关键参数快照。
CREATE TABLE `t_weigh_trace` ( `id` INT UNSIGNED NOT NULL AUTO_INCREMENT, `record_id` INT UNSIGNED NOT NULL COMMENT '关联的称重记录', `state_name` VARCHAR(30) NOT NULL COMMENT '状态名', `event_time` DATETIME(3) NOT NULL COMMENT '转移时间,精确到毫秒', `weight_value` DECIMAL(10,3) DEFAULT NULL COMMENT '转移时的重量', `remark` VARCHAR(255) DEFAULT NULL, PRIMARY KEY (`id`), KEY `idx_record` (`record_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;对账时,把同一辆车相邻两次的过磅记录做关联,如果毛重和皮重的差值小于一个阈值(比如 500kg),系统自动报警提示异常。这个逻辑用在煤炭、沙石行业特别有效——如果有人用套牌车一车两过,时序数据会清楚地暴露出两笔记录间隔时间异常短,或者记录的车牌虽然一样但抓拍照片的车辆特征不同。
6.2 图片取证与数据库记录的完整性校验
最后分享一个我最推荐的实践:把每一笔称重记录的数据库写入和现场照片归档绑定成一个事务来验证。具体做法是,在保存称重记录时,同时计算抓拍照片文件的 SHA256 哈希值,写入数据库。后续对账时,重新计算文件哈希,和库里的值对比,不一致就说明照片被替换过。
private string ComputeFileHash(string filePath) { using (var stream = File.OpenRead(filePath)) { using (var sha256 = SHA256.Create()) { var hashbytes = sha256.ComputeHash(stream); return Convert.ToHexString(hashbytes); } } }这段代码不复杂,但它把「改记录」和「改照片」的成本提高了一个量级。纯数据库记录可改,改完哈希对不上照样露馅。实际部署时我还会加一个定时任务,每天凌晨扫描前一天的照片文件和数据库哈希是否匹配,发现异常就汇总成报表发到管理员邮箱。
从那以后我每次做无人值守地磅的项目,都会强制把时序追溯和哈希校验走一遍。这不是被谁要求的,是吃过亏才长记性——有一回客户拿着两笔重复过磅的记录来找我理论,说系统乱记,最后靠时序数据证明是同牌照的不同车,才把问题解释清楚。数据键不健全的时候,所有问题都变成玄学,健全之后才变成工程问题。希望帮到你。
本文还有配套的精品资源,点击获取