LightControllerConfig.cs 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252
  1. using Prism.Mvvm;
  2. using System;
  3. using System.Collections.Generic;
  4. using System.Collections.ObjectModel;
  5. using System.Linq;
  6. using System.Text;
  7. using System.Threading.Tasks;
  8. using TeamAAS_VP.Core.Lights;
  9. using TeamAAS_VP.Enums;
  10. namespace TeamAAS_VP.Models.Lights
  11. {
  12. /// <summary>
  13. /// 表示灯控制器的配置模型。
  14. /// 根据所选的 <see cref="LightModel"/> 执行不同的初始化逻辑(如通道数量、串口或 TCP 配置等)。
  15. /// 该类继承自 Prism 的 <see cref="BindableBase"/>,支持属性变更通知,适用于 WPF MVVM 绑定。
  16. /// </summary>
  17. public class LightControllerConfig : BindableBase
  18. {
  19. private int _Id;
  20. /// <summary>
  21. /// 配置项的唯一标识符。
  22. /// 用于在集合或持久化时区分不同的控制器配置。
  23. /// </summary>
  24. public int Id
  25. {
  26. get { return _Id; }
  27. set { SetProperty(ref _Id, value); }
  28. }
  29. private string _Name;
  30. /// <summary>
  31. /// 控制器的显示名称或别名,便于在 UI 中识别。
  32. /// </summary>
  33. public string Name
  34. {
  35. get { return _Name; }
  36. set { SetProperty(ref _Name, value); }
  37. }
  38. private int _ChannelCount;
  39. /// <summary>
  40. /// 控制器的通道数(例如 4 通道控制器则为 4)。
  41. /// 该值会根据 <see cref="LightModel"/> 的不同在 setter 中被自动设置。
  42. /// </summary>
  43. public int ChannelCount
  44. {
  45. get { return _ChannelCount; }
  46. set { SetProperty(ref _ChannelCount, value); }
  47. }
  48. private LightModel _LightModel;
  49. /// <summary>
  50. /// 灯控制器的型号枚举。设置此属性将触发根据型号进行的配置初始化逻辑(通道、串口、TCP 等)。
  51. /// </summary>
  52. public LightModel LightModel
  53. {
  54. get { return _LightModel; }
  55. set { SetProperty(ref _LightModel, value); }
  56. }
  57. private ObservableCollection<ChannelConfig> _ChannelConfigs;
  58. /// <summary>
  59. /// 表示控制器包含的通道配置集合。
  60. /// 该集合常用于在 UI 中进行通道列表绑定与编辑。
  61. /// </summary>
  62. public ObservableCollection<ChannelConfig> ChannelConfigs
  63. {
  64. get { return _ChannelConfigs; }
  65. set { SetProperty(ref _ChannelConfigs, value); }
  66. }
  67. private TcpConfig _TcpConfig;
  68. /// <summary>
  69. /// 如果控制器通过 TCP/IP 通信,则此属性保存其网络配置(主机、端口等)。
  70. /// 对于串口型号,该值通常为 null。
  71. /// </summary>
  72. public TcpConfig TcpConfig
  73. {
  74. get { return _TcpConfig; }
  75. set { SetProperty(ref _TcpConfig, value); }
  76. }
  77. private SerialPortConfig _SerialPortConfig;
  78. /// <summary>
  79. /// 如果控制器通过串口通信,则此属性保存其串口配置(COM 口、波特率等)。
  80. /// 对于 TCP 型号,该值通常为 null。
  81. /// </summary>
  82. public SerialPortConfig SerialPortConfig
  83. {
  84. get { return _SerialPortConfig; }
  85. set { SetProperty(ref _SerialPortConfig, value); }
  86. }
  87. /// <summary>
  88. /// 默认构造函数:仅初始化通道集合为空集合,具体内容由后续设置 <see cref="LightModel"/> 决定。
  89. /// </summary>
  90. public LightControllerConfig()
  91. {
  92. ChannelConfigs = new ObservableCollection<ChannelConfig>();
  93. }
  94. /// <summary>
  95. /// 带参数的构造函数:使用给定的 id、name 和 model 初始化配置。
  96. /// 根据 <paramref name="model"/> 的不同执行相应的初始化逻辑(与 setter 中的逻辑一致)。
  97. /// </summary>
  98. /// <param name="id">配置的唯一标识符。</param>
  99. /// <param name="name">配置的显示名称。</param>
  100. /// <param name="model">控制器型号,用于决定初始化细节。</param>
  101. public LightControllerConfig(int id, string name, LightModel model)
  102. {
  103. Id = id;
  104. Name = name;
  105. LightModel = model;
  106. switch (LightModel)
  107. {
  108. case LightModel.KCS_KDC_12V60W_4T:
  109. // 该型号为 4 通道的串口控制器(示例)
  110. ChannelCount = 4;
  111. TcpConfig = null;
  112. if (SerialPortConfig == null)
  113. {
  114. SerialPortConfig = new SerialPortConfig();
  115. }
  116. // 调整通道集合,保留已有配置,若不足则追加,若过多则裁剪
  117. ResizeChannelConfigs(ChannelCount);
  118. break;
  119. case LightModel.KCS_KDC3_24V300W_8T:
  120. // 该型号为 8 通道的串口控制器(示例)
  121. ChannelCount = 8;
  122. TcpConfig = null;
  123. if (SerialPortConfig == null)
  124. {
  125. SerialPortConfig = new SerialPortConfig();
  126. }
  127. ResizeChannelConfigs(ChannelCount);
  128. break;
  129. default:
  130. // 未知型号:初始化空集合并清空通信配置
  131. ChannelCount = 0;
  132. if (ChannelConfigs == null)
  133. ChannelConfigs = new ObservableCollection<ChannelConfig>();
  134. else
  135. ResizeChannelConfigs(0);
  136. SerialPortConfig = null;
  137. TcpConfig = null;
  138. break;
  139. }
  140. }
  141. public LightControllerConfig Init()
  142. {
  143. // 当 LightModel 发生变化时,根据不同型号初始化相关字段与集合。
  144. switch (LightModel)
  145. {
  146. case LightModel.KCS_KDC_12V60W_4T:
  147. // 该型号为 4 通道的串口控制器(示例)
  148. ChannelCount = 4;
  149. TcpConfig = null;
  150. if (SerialPortConfig == null)
  151. {
  152. SerialPortConfig = new SerialPortConfig();
  153. }
  154. ResizeChannelConfigs(ChannelCount);
  155. break;
  156. case LightModel.KCS_KDC3_24V300W_8T:
  157. // 该型号为 8 通道的串口控制器(示例)
  158. ChannelCount = 8;
  159. TcpConfig = null;
  160. if (SerialPortConfig == null)
  161. {
  162. SerialPortConfig = new SerialPortConfig();
  163. }
  164. ResizeChannelConfigs(ChannelCount);
  165. break;
  166. default:
  167. // 对于未知或未实现的型号,清理所有特定配置并使用默认空集合
  168. ChannelCount = 0;
  169. if (ChannelConfigs == null)
  170. ChannelConfigs = new ObservableCollection<ChannelConfig>();
  171. else
  172. ResizeChannelConfigs(0);
  173. SerialPortConfig = null;
  174. TcpConfig = null;
  175. break;
  176. }
  177. return this;
  178. }
  179. /// <summary>
  180. /// 调整 ChannelConfigs 的数量以匹配 desiredCount:
  181. /// - 保留已有前段配置;
  182. /// - 若不足则追加新配置;
  183. /// - 若过多则从末尾裁剪;
  184. /// - 最后规范化每个通道的 LocalIndex/GlobalIndex,并在 Name/Description 为空时填默认值。
  185. /// </summary>
  186. /// <param name="desiredCount">期望的通道数量</param>
  187. private void ResizeChannelConfigs(int desiredCount)
  188. {
  189. if (ChannelConfigs == null)
  190. {
  191. ChannelConfigs = new ObservableCollection<ChannelConfig>();
  192. }
  193. int current = ChannelConfigs.Count;
  194. if (current < desiredCount)
  195. {
  196. for (int i = current; i < desiredCount; i++)
  197. {
  198. ChannelConfigs.Add(new ChannelConfig()
  199. {
  200. LocalIndex = i,
  201. GlobalIndex = i,
  202. Name = $"Channel {i + 1}",
  203. Description = $"Description for Channel {i + 1}",
  204. DefaultBrightness = 100
  205. });
  206. }
  207. }
  208. else if (current > desiredCount)
  209. {
  210. // 从末尾删除多余通道,保留前面的配置
  211. for (int i = current - 1; i >= desiredCount; i--)
  212. {
  213. ChannelConfigs.RemoveAt(i);
  214. }
  215. }
  216. // 规范化索引与默认文本(不覆盖已有非空 Name/Description)
  217. for (int i = 0; i < ChannelConfigs.Count; i++)
  218. {
  219. var cfg = ChannelConfigs[i];
  220. if (cfg == null)
  221. continue;
  222. cfg.LocalIndex = i;
  223. cfg.GlobalIndex = i;
  224. if (string.IsNullOrWhiteSpace(cfg.Name))
  225. cfg.Name = $"Channel {i + 1}";
  226. if (string.IsNullOrWhiteSpace(cfg.Description))
  227. cfg.Description = $"Description for Channel {i + 1}";
  228. // 如果需要可以在此处保留或调整 DefaultBrightness 等字段,但默认不覆盖已有值
  229. if (cfg.DefaultBrightness <= 0)
  230. cfg.DefaultBrightness = 100;
  231. }
  232. }
  233. }
  234. }