应用配置说明

应用配置文件用于调整少量用户体验型数量、新建 HMI 页面的默认尺寸，以及 PLC 配置窗口的串口初值。工程内容仍保存在 JSON 工程文件中，两类文件互不替代。

文件位置与生效方式

配置文件固定在程序可执行文件同级目录下：

config/application.ini

文件统一使用 UTF-8，可带或不带 BOM
程序每次启动只读取一次，运行期间不热更新
修改后必须完全退出并重新启动程序
程序不会覆盖已有配置，也不会把界面里的临时修改自动写回文件
字段名和分区名区分大小写，应按示例原样填写

首次运行找不到文件时，程序会自动创建 config 目录和默认文件，本次运行直接使用代码默认值，并在主界面底部输出创建结果。创建目录或文件失败时，程序仍会使用默认值启动，同时在底部输出原因并弹出一次警告。

默认配置

[Config]
Version=1

[ProjectLimits]
MaxHmiPages=32
MaxHmiControlsPerPage=128
MaxAlarmDefinitions=256
MaxControlLogics=32
MaxRungsPerLogic=256
MaxOutputMessages=1000

[HmiDefaults]
DefaultPageWidth=800
DefaultPageHeight=400

[PlcDefaults]
PortName=COM3
ServerAddress=1
BaudRate=9600
DataBits=8
Parity=2
StopBits=1

字段说明

分区与字段	默认值	允许值	实际作用
`Config.Version`	1	当前只接受 `1`	配置格式版本，必填
`ProjectLimits.MaxHmiPages`	32	`1~32`	单工程 HMI 页面上限
`ProjectLimits.MaxHmiControlsPerPage`	128	`1~128`	单页 HMI 控件上限
`ProjectLimits.MaxAlarmDefinitions`	256	`0~256`	单工程报警定义上限，`0` 表示禁止添加报警
`ProjectLimits.MaxControlLogics`	32	`1~32`	单工程控制逻辑组上限
`ProjectLimits.MaxRungsPerLogic`	256	`0~256`	单组逻辑网络上限，`0` 表示逻辑组只能保持空网络
`ProjectLimits.MaxOutputMessages`	1000	`1~1000`	主界面底部输出保留条数
`HmiDefaults.DefaultPageWidth`	800	`320~1600`	新建 HMI 页面的默认宽度，像素
`HmiDefaults.DefaultPageHeight`	400	`200~800`	新建 HMI 页面的默认高度，像素
`PlcDefaults.PortName`	COM3	非空，最多 128 个 UTF-8 字节	打开 PLC 配置窗口时优先选择的端口
`PlcDefaults.ServerAddress`	1	`1~247`	Modbus 从站地址
`PlcDefaults.BaudRate`	9600	`9600/19200/38400/57600/115200`	串口波特率
`PlcDefaults.DataBits`	8	`7/8`	串口数据位
`PlcDefaults.Parity`	2	`0/2/3`	`0` 无校验、`2` 偶校验、`3` 奇校验
`PlcDefaults.StopBits`	1	`1/2`	串口停止位

页面宽高配置只影响之后新建的页面。已经保存在工程 JSON 中的页面继续使用自身宽高，不会因为修改 INI 被批量改变。

PLC 默认配置只负责填充 PLC 配置窗口。若 PortName 对应串口当前不存在，端口列表仍只显示 Windows 实际检测到的可用串口，不会人为加入一个无效端口。用户在窗口里搜索或修改参数后，结果只在本次程序运行期间保留。

校验与回退

普通字段缺失时，该字段使用代码默认值，其他合法字段继续生效；未知字段会被忽略。这两种情况都会在主界面底部输出提示，但不会弹警告。

以下情况属于严重错误：

Config.Version 缺失或不是 1
任意整数包含其他字符、低于最小值或超过代码硬上限
波特率、校验位等枚举值不受支持
任意字段重复出现，包括在重复分区中再次出现同名字段
文件不是有效 UTF-8、INI 行格式错误或文件无法读取

出现任一严重错误时，整份配置都不生效。本次运行全部使用代码默认值，主界面底部会输出字段、原值、允许范围和最终处理结果，并弹出一次警告；程序不会修改原配置文件。

调低上限后的工程

程序加载工程时使用与编辑入口相同的启动配置。已有工程超过新上限时会整体拒绝加载，错误信息会给出超限数组、实际数量和当前上限；当前工程不会被部分替换，原 JSON 文件也不会被修改。

全工程 HMI 控件上限 2048、全工程网络上限 2048、M/D 地址范围、16 位数值范围、梯形图结构、表达式安全限制、Modbus 通信限制和工程文件容量仍是代码硬限制，不允许通过 INI 修改。

4.4 KiB Raaka Blame Historia