lnnovationHubTool，用prism+WPF编写的MVVM模式的快速上位机软件开发框架平台 - 教程

目录

• lnnovationHubTool 技术与功能说明文档
• • 一、 引言
  • 二、 UllnnovationHub.ToolKIt (UI组件库)
  • • 2.1 如何使用
    • 2.2 主要UI控件
    • • 2.2.1 `UMessageBox` (自定义消息框)
      • 2.2.2 `Card` (卡片控件)
      • 2.2.3 `UTextBox` (增强文本框)
      • 2.2.4 `SwitchButton` (开关按钮)
      • 2.2.5 `SwitchRadioButton` (开关单选按钮)
      • 2.2.6 其他控件样式
    • 2.3 `Helper` 类
    • • 2.3.1 `UllnnovationHub.ToolKIt.Helper.MessageBox`
  • 三、 lnnovationHubTool.Core (核心库)
  • • 3.1 日志管理 (`IW.Core.Log`)
    • • 3.1.1 `LogManage`
      • 3.1.2 `LogItem`
      • 3.1.3 `LogLevel` (枚举)
    • 3.2 公共工具 (`IW.Core.CommonTool`)
    • • 3.2.1 `PathHelper`
    • 3.3 用户角色管理 (`IW.Core.Services.UserRoleConfigure.Services`)
    • • 3.3.1 `IUserManageService`
    • 3.4 参数服务
    • • 3.4.1 `IParameterService` (接口)
      • 3.4.2 `StringWrapper`
    • 3.5 通信功能 ()
    • • 3.5.1 Modbus通信 (`ModbusTCP`)
      • 3.5.2 TCP/IP 通信 ()
      • 3.5.3 串口通信 ()
    • 3.6 `TaskManager` 流程管理器 ()
  • 四、 lnnovationHubTool (主应用程序)
  • • 4.1 主要视图 (Views)
    • 4.2 Prism 框架集成
    • • 4.2.1 模块注册 (Bootstrapper or App class)
      • 4.2.2 视图注册与导航
    • 4.3 相机集成 (`DeBugView` 相关)
    • • 4.3.1 `ICamera` (接口) 和 `CamFactory`

如果需要源代码请私信我

lnnovationHubTool 技术与功能说明文档

效果：

一、 引言

本文档详细介绍了 lnnovationHubTool 项目套件的各项功能、核心组件以及具体代码用法。该套件主要由三部分组成：

• UllnnovationHub.ToolKIt: 一个WPF UI组件库，提供丰富的自定义控件和样式。
• lnnovationHubTool.Core: 项目的核心库，提供基础服务如日志管理、参数持久化、通信接口等。
• lnnovationHubTool: 主应用程序，集成核心功能和UI组件，实现具体的业务逻辑。

二、 UllnnovationHub.ToolKIt (UI组件库)

UllnnovationHub.ToolKIt 旨在提供一套美观、易用的WPF UI控件和样式。

2.1 如何使用

1. 编译 UllnnovationHub.ToolKIt 项目，生成 UllnnovationHub.ToolKIt.dll。

2. 在您的WPF项目中添加对 UllnnovationHub.ToolKIt.dll 的引用。

3. 在 App.xaml 中引入资源字典：

   <!-- filepath: App.xaml -->
     <Application.Resources>
       <ResourceDictionary>
         <ResourceDictionary.MergedDictionaries>
           <ResourceDictionary Source="pack://application:,,,/UllnnovationHub.ToolKIt;Component/Generic.xaml" />
         </ResourceDictionary.MergedDictionaries>
       </ResourceDictionary>
     </Application.Resources>

4. 在XAML页面中引用命名空间：

   xmlns:ui="clr-namespace:UllnnovationHub.ToolKIt.UI;assembly=UllnnovationHub.ToolKIt"

2.2 主要UI控件

2.2.1 UMessageBox (自定义消息框)

UMessageBox 是一个功能增强的自定义消息框，替代标准的 System.Windows.MessageBox。

功能特性:

• 支持多种消息类型：Info, Error, Warning, Question。
• 支持多种按钮组合：OK, OKCancel, YesNo, YesNoCancel。
• 提供同步 (ShowAndGetResult) 和异步 (Show 带回调) 的调用方式。
• 可自定义标题和内容。
• 窗口可拖动。
• 自动作为活动窗口的子窗口。

C# 使用方法:

// filepath: ExampleViewModel.cs
using UllnnovationHub.ToolKIt.UI;
using System.Windows;
// For MessageBoxResult
using System.Threading.Tasks;
// ...
public void ShowInfoMessage()
{
var messageBox = new UMessageBox();
messageBox.Show("这是一条信息提示。", "提示", UMessageBox.MessageBoxType.Info, UMessageBox.ButtonType.OK, result =>
{
if (result == MessageBoxResult.OK)
{
// 用户点击了确定
System.Diagnostics.Debug.WriteLine("用户点击了确定。");
}
});
}
public void ShowErrorMessageSync()
{
var messageBox = new UMessageBox();
MessageBoxResult result = messageBox.ShowAndGetResult("发生了一个错误。", "错误", UMessageBox.MessageBoxType.Error, UMessageBox.ButtonType.OK);
if (result == MessageBoxResult.OK)
{
// 用户点击了确定
System.Diagnostics.Debug.WriteLine("错误消息框，用户点击了确定。");
}
}
public void ShowQuestionMessage()
{
var messageBox = new UMessageBox();
MessageBoxResult result = messageBox.ShowAndGetResult("您确定要执行此操作吗？", "请确认", UMessageBox.MessageBoxType.Question, UMessageBox.ButtonType.YesNo);
if (result == MessageBoxResult.Yes)
{
// 用户点击了“是”
System.Diagnostics.Debug.WriteLine("问题消息框，用户点击了是。");
}
else if (result == MessageBoxResult.No)
{
// 用户点击了“否”
System.Diagnostics.Debug.WriteLine("问题消息框，用户点击了否。");
}
else if (result == MessageBoxResult.Cancel)
{
// 用户点击了“取消”（如果按钮类型包含取消）
System.Diagnostics.Debug.WriteLine("问题消息框，用户点击了取消。");
}
}
// ...

2.2.2 Card (卡片控件)

Card 控件用于将内容分组显示在一个具有视觉吸引力的卡片界面中。

XAML 使用方法:

<!-- filepath: YourView.xaml -->
  <
    ui:Card Margin="10" Padding="15">
  <StackPanel>
    <TextBlock Text="卡片标题" FontSize="16" FontWeight="Bold"/>
    <TextBlock Text="这里是卡片的内容区域。"/>
  </StackPanel>
</ui:Card>

2.2.3 UTextBox (增强文本框)

UTextBox 是一个带有附加功能的文本框，例如水印提示 (Placeholder)。其样式定义在 Themes/UTextBox.xaml 中。

XAML 使用方法:

<!-- filepath: YourView.xaml -->
  <!-- 假设 UTextBox 通过其 Style 或附加属性支持 Placeholder -->
      <TextBox Margin="5" ui:ControlAttach.Placeholder="请输入用户名..." Text="{Binding Username}" Style="{StaticResource UTextBoxBaseStyle
    }" />
    <!-- 或者如果 UTextBox 是一个完全自定义的控件 -->
      <!-- <ui:UTextBox Margin="5" Placeholder="请输入用户名..." Text="{Binding Username}" /> -->

注意: ControlAttach.Placeholder 是一个常见的附加属性命名方式，具体请参照 UTextBox.xaml 或相关附加属性类的定义。如果 UTextBox 是一个派生控件，它可能有自己的 Placeholder 属性。

2.2.4 SwitchButton (开关按钮)

提供一个视觉上类似拨动开关的布尔型输入控件。

XAML 使用方法:

<!-- filepath: YourView.xaml -->
  <!-- 假设 SwitchButton 是一个自定义控件 -->
    <
      ui:SwitchButton Margin="5" IsChecked="{Binding IsFeatureEnabled}" />

2.2.5 SwitchRadioButton (开关单选按钮)

结合了开关和单选按钮的功能，通常用于一组选项中。

XAML 使用方法:

<!-- filepath: YourView.xaml -->
  <StackPanel>
    <
      ui:SwitchRadioButton Content="选项 A" GroupName="MyOptionsGroup" IsChecked="{Binding OptionASelected}" />
    <
      ui:SwitchRadioButton Content="选项 B" GroupName="MyOptionsGroup" IsChecked="{Binding OptionBSelected}" />
  </StackPanel>

2.2.6 其他控件样式

Generic.xaml 合并了多个资源字典，为WPF原生控件提供了自定义样式。

• Button.xaml: 按钮样式 (e.g., BaseButtonStyle, PrimaryButtonStyle)
• RadioButton.xaml: 单选按钮样式
• TabControl.xaml: 选项卡控件样式
• GroupBox.xaml: 分组框样式 (e.g., BaseGroupBoxStyle, SqureShadowHeaderGroupBoxStyle, RoundedShadowHeaderGroupBoxStyle)
• Expander.xaml: 折叠面板样式
• ComboBox.xaml: 下拉框样式
• PasswordBox.xaml: 密码框样式
• CheckBox.xaml: 复选框样式
• ListBox.xaml: 列表框样式
• TreeView.xaml & TreeViewItem.xaml: 树视图样式
• MenuItem.xaml: 菜单项样式
• ImageButton.xaml: 图像按钮样式
• Slider.xaml: 滑动条样式
• ListView.xaml: 列表视图样式
• DataGrid.xaml: 数据网格样式
• HorizontolSeparator.xaml & VerticalSeparator.xaml: 分隔线样式

XAML 使用方法 (应用样式):

<!-- filepath: YourView.xaml -->
  <Button Content="默认样式按钮" Margin="5" />
    <Button Content="主按钮样式" Margin="5" Style="{StaticResource PrimaryButton
  }" /> <!-- 假设样式Key为 PrimaryButton -->
      <GroupBox Header="测试基础样式" Margin="10" Style="{StaticResource BaseGroupBoxStyle
    }"/>
      <GroupBox Header="方形阴影标题" Margin="10" Style="{StaticResource SqureShadowHeaderGroupBoxStyle
    }"/>
      <GroupBox Header="圆形阴影标题" Margin="10" Style="{StaticResource RoundedShadowHeaderGroupBoxStyle
    }"/>
      <DataGrid Margin="5" Style="{StaticResource DataGridStyle1
    }"> <!-- 假设样式Key为 DataGridStyle1 -->
      <!-- Columns and ItemsSource -->
      </DataGrid>

注意: 具体的样式键名 (Style Key) 取决于各个 Themes/*.xaml 文件中的定义。

2.3 Helper 类

2.3.1 UllnnovationHub.ToolKIt.Helper.MessageBox

这是一个静态辅助类，封装了对 UMessageBox 的调用，简化了消息框的显示。

C# 使用方法:

// filepath: ExampleViewModel.cs
using MessageBox = UllnnovationHub.ToolKIt.Helper.MessageBox;
// 为方便使用设置别名
using System.Windows;
// For MessageBoxResult
// ...
public void ShowSimplifiedInfo()
{
// 假设 Helper.MessageBox 内部会创建和配置 UMessageBox 实例
MessageBox.Info("操作已成功完成。", "成功");
}
public void ShowSimplifiedError()
{
MessageBox.Error("保存配置时发生错误。", "错误");
}
public void ShowSimplifiedWarning()
{
MessageBox.Warning("这是一个警告信息。", "警告");
}
public MessageBoxResult ShowSimplifiedConfirm()
{
// 假设 Confirm 方法返回 MessageBoxResult
return MessageBox.Confirm("您确定要删除这条记录吗？", "请确认");
}
// 示例：如果 Helper.MessageBox 提供了直接返回 UMessageBox.MessageBoxType 的方法
public void ShowMessageWithSpecificType()
{
// 假设 Show 方法签名类似：
// static void Show(string message, string caption, UMessageBox.MessageBoxType type, UMessageBox.ButtonType buttonType)
// MessageBox.Show("这是一条询问消息", "询问", UMessageBox.MessageBoxType.Question, UMessageBox.ButtonType.YesNoCancel);
}
// ...

三、 lnnovationHubTool.Core (核心库)

lnnovationHubTool.Core 提供了应用程序的基础服务和核心逻辑。

3.1 日志管理 (IW.Core.Log)

3.1.1 LogManage

静态类，提供全局的日志记录功能。

功能特性:

• 异步日志记录，避免阻塞主线程。
• 支持多种日志级别: Info, Procedure, Warn, Error。
• 可自定义日志文件路径 (CustomLogPath) 和文件名 (CustomLogFileName)。
• 可自定义日志格式 (LogFormatter)。
• 自动清理旧日志文件 (可配置 SaveDays)。
• 提供日志读取功能 (Read)。
• 日志写入事件回调 (OnWriteLog)，用于实时显示日志。
• 可关联用户管理服务 (IUserManageService) 以记录操作员信息。

C# 初始化与配置:

// filepath: App.xaml.cs or a Bootstrapper class
using IW.Core.Log;
using IW.Core.CommonTool;
// For PathHelper
using IW.Core.Services.UserRoleConfigure.Services;
// For IUserManageService (假设接口路径)
using System;
using System.IO;
using System.Windows;
// For Application
public partial class App
: Application
{
private IUserManageService _userManageService;
// 示例：用户服务实例
protected override void OnStartup(StartupEventArgs e)
{
base.OnStartup(e);
// 示例：初始化用户服务 (具体实现依赖于您的项目)
// _userManageService = new YourUserManageServiceImplementation();
// LogManage.SetUserManageService(_userManageService);
LogManage.Init();
// 应用默认配置和自定义格式化器
// 可选：在Init之后覆盖或补充配置
LogManage.CustomLogPath = () => Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "ApplicationLogs");
LogManage.CustomLogFileName = () =>
$"AppLog_{
DateTime.Now:yyyy-MM-dd
}.log";
LogManage.SaveDays = 60;
// 保留60天日志
// 示例：订阅日志写入事件 (LogManage.Init 中可能已有默认的控制台输出)
LogManage.OnWriteLog += (logItem) =>
{
// 在UI上显示日志，注意线程调度
Application.Current?.Dispatcher?.Invoke(() =>
{
// 例如：添加到ObservableCollection<LogItem> 以更新UI
  // LogViewModel.LogEntries.Add(logItem);
  });
  System.Diagnostics.Debug.WriteLine($"实时日志回调: [{
  logItem.Level
  }] {
  logItem.Message
  }");
  };
  }
  protected override void OnExit(ExitEventArgs e)
  {
  LogManage.Close(5);
  // 程序退出前关闭日志，等待最多5秒完成写入
  base.OnExit(e);
  }
  }

C# 日志记录方法:

// filepath: ExampleService.cs
using IW.Core.Log;
using System;
public class ExampleService
{
public void PerformDatabaseOperation(string connectionString)
{
LogManage.Info("数据库操作开始。");
try
{
LogManage.Procedure($"尝试连接到数据库: {
connectionString
}");
// ... 执行数据库操作 ...
if (string.IsNullOrEmpty(connectionString))
{
LogManage.Warn("连接字符串为空，操作可能失败。");
}
// 模拟操作
System.Threading.Thread.Sleep(100);
LogManage.Procedure("数据库操作步骤1完成。");
LogManage.Info("数据库操作成功完成。");
}
catch (TimeoutException tex)
{
LogManage.Error("数据库操作超时。", tex);
}
catch (Exception ex)
{
LogManage.Error($"数据库操作发生未知错误: {
ex.Message
}", ex);
}
}
}

C# 日志读取方法:

// filepath: LogViewModel.cs
using IW.Core.Log;
using System;
using System.Collections.Generic;
using System.Linq;
// using System.Collections.ObjectModel; // For ObservableCollection if binding to UI
public class LogViewModel
// : YourViewModelBaseClass
{
// public ObservableCollection<LogItem> DisplayedLogs { get; } = new ObservableCollection<LogItem>();
  public void LoadLogsForToday(LogLevel logLevelFilter)
  {
  DateTime startTime = DateTime.Today;
  DateTime endTime = DateTime.Now;
  // 或者 DateTime.Today.AddDays(1).AddTicks(-1) 表示到今天结束
  List<LogItem> logs = LogManage.Read(startTime, endTime, logLevelFilter);
    // DisplayedLogs.Clear();
    if (logs != null)
    {
    // foreach (var log in logs)
    // {
    // DisplayedLogs.Add(log);
    // }
    }
    }
    }

3.1.2 LogItem

表示单条日志记录的数据结构。

主要属性:

• Time: string (在 LogManage.Read 中解析为 DateTime 前的原始字符串) - 日志记录时间。
• Level: string - 日志级别 (如 “Info”, “Error”)。
• ThreadId: string - 记录日志的线程ID。
• UserName: string - 操作用户名。
• UserRole: string - 操作用户角色。
• Message: string - 日志消息内容。

3.1.3 LogLevel (枚举)

定义日志的严重级别，用于记录和筛选。

• Info: 普通信息。
• Warn: 警告信息。
• Error: 错误信息。
• Procedure: 流程/调试信息 (在 LogManage.Debug 方法中被映射为 LogLevel.Procedure 进行记录)。
• All: 用于 LogManage.Read 时，表示读取所有级别的日志。

3.2 公共工具 (IW.Core.CommonTool)

3.2.1 PathHelper

静态类，用于管理应用程序中常用的路径。

主要属性 (示例):

• G_LogPath: string - 日志文件的存储路径。由 LogManage.CustomLogPath 委托确定，PathHelper 可能提供默认值或被 LogManage 使用。
• G_Parameters: string - 参数文件的存储路径 (基于 功能说明.md 推断)。

C# 使用方法:

// filepath: ConfigurationService.cs
using IW.Core.CommonTool;
// Assuming PathHelper is here
using System.IO;
public class ConfigurationService
{
public string GetParameterFilePath(string fileName)
{
// 假设 PathHelper.G_Parameters 提供了参数文件夹的根路径
// string parametersDirectory = PathHelper.G_Parameters;
// if (!Directory.Exists(parametersDirectory))
// {
// Directory.CreateDirectory(parametersDirectory);
// }
// return Path.Combine(parametersDirectory, fileName);
return Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Parameters", fileName);
// Fallback example
}
public string GetLogDirectory()
{
return PathHelper.G_LogPath;
// G_LogPath is set by LogManage.CustomLogPath
}
}

3.3 用户角色管理 (IW.Core.Services.UserRoleConfigure.Services)

3.3.1 IUserManageService

接口，定义用户登录、权限检查等用户管理相关操作。LogManage 通过 SetUserManageService 方法接收此接口的实例，以在日志中记录当前用户信息。

接口方法示例 (概念性):

// filepath: IUserManageService.cs (Conceptual)
// namespace IW.Core.Services.UserRoleConfigure.Services;
// public interface IUserManageService
// {
// CurrentUser CurrentUser { get; } // Represents the logged-in user's details
// bool Login(string username, string password);
// void Logout();
// bool HasPermission(string permissionKey);
// }
// public class CurrentUser
// {
// public string UserName { get; set; }
// public string Role { get; set; } // Or an enum for roles
// }

在 LogManage 中的使用:
LogManage 内部在格式化日志时，如果 _userManageService 实例不为空，会尝试调用 _userManageService.CurrentUser 来获取用户名和角色。

3.4 参数服务

3.4.1 IParameterService (接口)

定义参数持久化（保存和加载）的方法，通常使用XML或JSON序列化。

接口定义 (推断自 功能说明.md):

// filepath: IParameterService.cs (Conceptual, likely in IW.Core.Services namespace)
public interface IParameterService
{
void SaveParameter<T>(T parameter, string fileName) where T : class
  ;
  T LoadParameter<T>(string fileName) where T : class,
    new();
    }

C# 使用方法 (假设已实现并注入 _parameterService):

// filepath: SettingsViewModel.cs
// using IW.Core.Services; // For IParameterService
// public class AppSettings { /* ... properties ... */ }
// private IParameterService _parameterService;
// public AppSettings CurrentSettings { get; set; }
public void LoadApplicationSettings()
{
// CurrentSettings = _parameterService.LoadParameter<AppSettings>("ApplicationSettings.xml");
  // if (CurrentSettings == null)
  // {
  // CurrentSettings = new AppSettings(); // Load defaults or create new
  // }
  }
  public void SaveApplicationSettings()
  {
  // if (CurrentSettings != null)
  // {
  // _parameterService.SaveParameter(CurrentSettings, "ApplicationSettings.xml");
  // }
  }

3.4.2 StringWrapper

用于序列化单个字符串值，当需要将字符串作为独立的XML文件内容或者需要一个对象根进行序列化时使用。

类定义 ():

// filepath: StringWrapper.cs (Conceptual, likely in IW.Core.Models or Common namespace)
using System;
[Serializable]
public class StringWrapper
{
public string Value {
get;
set;
}
public StringWrapper() { Value = string.Empty;
}
public StringWrapper(string value) { Value = value;
}
public static implicit operator string(StringWrapper wrapper) => wrapper?.Value;
public static implicit operator StringWrapper(string value) =>
new StringWrapper(value);
}

C# 使用方法:

// filepath: DeviceConfigurationService.cs
// using IW.Core.Services; // For IParameterService
// using IW.Core.Models; // For StringWrapper
// private IParameterService _parameterService;
public void SaveDeviceIdentifier(string deviceId)
{
// StringWrapper wrapper = deviceId; // Implicit conversion from string
// _parameterService.SaveParameter(wrapper, "DeviceIdentifier.xml");
}
public string LoadDeviceIdentifier()
{
// StringWrapper wrapper = _parameterService.LoadParameter<StringWrapper>("DeviceIdentifier.xml");
  // string deviceId = wrapper; // Implicit conversion to string
  // return deviceId ?? "DefaultDeviceID";
  return "DefaultDeviceID_Placeholder";
  // Placeholder
  }

3.5 通信功能 ()

3.5.1 Modbus通信 (ModbusTCP)

用于与支持Modbus TCP协议的设备（如PLC）通信。

C# 使用方法 (概念性, 基于 功能说明.md):

// filepath: ModbusDeviceService.cs
// Assuming a ModbusTCP class exists, e.g., from a third-party library or custom implementation
// Example: using EasyModbus; // If using EasyModbusTCP .NET package
public class ModbusDeviceService
{
// private ModbusClient _modbusClient; // Example using EasyModbus
public ModbusDeviceService(string ipAddress, int port)
{
// _modbusClient = new ModbusClient(ipAddress, port);
}
public bool Connect()
{
// try
// {
// _modbusClient.Connect();
// return _modbusClient.Connected;
// }
// catch (Exception ex)
// {
// LogManage.Error("Modbus连接失败", ex);
// return false;
// }
return false;
// Placeholder
}
public int[] ReadHoldingRegisters(int startAddress, int quantity)
{
// if (!_modbusClient.Connected) return null;
// try
// {
// return _modbusClient.ReadHoldingRegisters(startAddress, quantity);
// }
// catch (Exception ex)
// {
// LogManage.Error($"读取Modbus保持寄存器失败 (地址:{startAddress},数量:{quantity})", ex);
// return null;
// }
return null;
// Placeholder
}
public bool WriteSingleRegister(int address, int value)
{
// if (!_modbusClient.Connected) return false;
// try
// {
// _modbusClient.WriteSingleRegister(address, value);
// return true;
// }
// catch (Exception ex)
// {
// LogManage.Error($"写入Modbus单个寄存器失败 (地址:{address},值:{value})", ex);
// return false;
// }
return false;
// Placeholder
}
public void Disconnect()
{
// _modbusClient?.Disconnect();
}
}

3.5.2 TCP/IP 通信 ()

通用的TCP客户端通信实现。

C# 使用方法 (概念性, 基于 功能说明.md):

// filepath: GenericTcpDeviceService.cs
// Assuming TCPCommunicate class exists
// public class GenericTcpDeviceService
// {
// private TCPCommunicate _tcpComm;
// public event EventHandler<byte[]> DataReceived;
  // public GenericTcpDeviceService(string ipAddress, int port)
  // {
  // _tcpComm = new TCPCommunicate(ipAddress, port);
  // _tcpComm.DataReceivedEvent += OnRawDataReceived;
  // }
  // private void OnRawDataReceived(object sender, byte[] data)
  // {
  // DataReceived?.Invoke(this, data); // Forward the event
  // string receivedString = System.Text.Encoding.UTF8.GetString(data);
  // LogManage.Procedure($"TCP收到数据: {receivedString}");
  // }
  // public bool OpenConnection()
  // {
  // try
  // {
  // _tcpComm.Open();
  // return true; // Assuming Open() throws on failure or returns status
  // }
  // catch (Exception ex)
  // {
  // LogManage.Error("TCP连接打开失败", ex);
  // return false;
  // }
  // }
  // public bool SendMessage(string message)
  // {
  // try
  // {
  // _tcpComm.SendMessage(message);
  // return true;
  // }
  // catch (Exception ex)
  // {
  // LogManage.Error("TCP发送消息失败", ex);
  // return false;
  // }
  // }
  // public void CloseConnection()
  // {
  // _tcpComm?.Close();
  // }
  // }

3.5.3 串口通信 ()

用于与通过串口连接的设备通信。

C# 使用方法 (概念性, 基于 功能说明.md):

// filepath: PowerSupplyService.cs
// Assuming SerialPortData, PowerManager, and an ICommunication (or similar) serial port class exist
// public enum PowerChannel { Power1, Power2 } // Example enum
// public class PowerSupplyService
// {
// private PowerManager _powerManager; // Manages power supply communication instances
// public PowerSupplyService()
// {
// _powerManager = new PowerManager(); // Initialize PowerManager
// }
// public bool ConfigureSerialPort(PowerChannel channel, SerialPortData portConfig)
// {
// // _powerManager.Setting(portConfig, channel); // Configures the serial port for the given channel
// // ICommunication serialComm = channel == PowerChannel.Power1 ? _powerManager.powerComunication1 : _powerManager.powerComunication2;
// // try
// // {
// // serialComm?.Open();
// // return serialComm?.IsOpen ?? false;
// // }
// // catch (Exception ex)
// // {
// // LogManage.Error($"配置并打开串口 {portConfig.PortName} 失败 (通道: {channel})", ex);
// // return false;
// // }
// return false; // Placeholder
// }
// public bool SendSerialCommand(PowerChannel channel, string command)
// {
// // ICommunication serialComm = channel == PowerChannel.Power1 ? _powerManager.powerComunication1 : _powerManager.powerComunication2;
// // if (serialComm == null || !serialComm.IsOpen)
// // {
// // LogManage.Warn($"串口未打开或未配置 (通道: {channel})，无法发送命令: {command}");
// // return false;
// // }
// // try
// // {
// // serialComm.SendMessage(command);
// // return true;
// // }
// // catch (Exception ex)
// // {
// // LogManage.Error($"通过串口发送命令失败 (通道: {channel}, 命令: {command})", ex);
// // return false;
// // }
// return false; // Placeholder
// }
// }

3.6 TaskManager 流程管理器 ()

用于管理和执行定义好的工艺流程或任务序列。

功能特性:

• 初始化工作站列表 (IniStationList)。
• 控制流程的初始化 (Init)、自动运行 (AutoRun)、暂停 (Pause)、继续 (Continue)、停止 (Stop)。
• 通过 OnStationStatusChange 事件回调监控工作站状态变化。

C# 使用方法 (概念性, 基于 功能说明.md):

// filepath: ProductionControlViewModel.cs
// Assuming TaskManager is a singleton or static accessible class
// using System.Collections.ObjectModel; // For UI binding
// using System.Linq;
// using System.Windows; // For Application.Current.Dispatcher
// public class StationUIModel { public string Id { get; set; } public string Status { get; set; } public string Message { get; set; } }
// public class ProductionControlViewModel // : YourViewModelBase
// {
// // public ObservableCollection<StationUIModel> Stations { get; } = new ObservableCollection<StationUIModel>();
  // public ProductionControlViewModel()
  // {
  // // TaskManager.Instance.OnStationStatusChange += OnStationStatusChanged;
  // }
  // public void InitializeWorkflow(string deviceType)
  // {
  // // TaskManager.IniStationList(deviceType); // Initializes stations based on device type
  // // TaskManager.Instance.Init(); // Initializes the overall task manager/workflow
  // // PopulateStationsFromTaskManager(); // Helper to initially populate UI
  // }
  // private void OnStationStatusChanged(StationData station) // Assuming StationData is the type from TaskManager
  // {
  // // Application.Current.Dispatcher.Invoke(() =>
  // // {
  // // var uiStation = Stations.FirstOrDefault(s => s.Id == station.Id);
  // // if (uiStation != null)
  // // {
  // // uiStation.Status = station.Status;
  // // uiStation.Message = station.Message;
  // // }
  // // else
  // // {
  // // // Stations.Add(new StationUIModel { Id = station.Id, Status = station.Status, Message = station.Message });
  // // }
  // // });
  // }
  // public void StartAutoMode() => TaskManager.Instance.AutoRun();
  // public void PauseAutoMode() => TaskManager.Instance.Pause();
  // public void ContinueAutoMode() => TaskManager.Instance.Continue();
  // public void StopAutoMode() => TaskManager.Instance.Stop();
  // // private void PopulateStationsFromTaskManager() { /* ... */ }
  // }

四、 lnnovationHubTool (主应用程序)

主应用程序集成了 UllnnovationHub.ToolKIt 和 lnnovationHubTool.Core，并使用 Prism 框架构建模块化的WPF应用。

4.1 主要视图 (Views)

• MainView: 应用程序的主窗口或主内容区域，通常包含导航和内容区域。
• LogView: 显示系统日志，提供筛选和查看功能。
• AlarmView: 显示系统报警信息。
• UserManageView: 用户管理界面 (推断)。
• SettingView: 系统设置界面。
• CameraView: 相机图像显示和控制界面。
• DeBugView: 包含各种调试工具和相机调试功能的视图。
• ParameterView: 参数配置界面。
• CustomControls Views (AxisSettingView, DebugCameraView, RecipeView): 特定功能的自定义控件或组合视图，用于更复杂的交互。

4.2 Prism 框架集成

4.2.1 模块注册 (Bootstrapper or App class)

Prism应用通常有一个引导程序（Bootstrapper）或在 App.xaml.cs 中配置模块。

// filepath: App.xaml.cs or YourBootstrapper.cs
// using Prism.DryIoc; // Or Prism.Unity, Prism.Ninject etc.
// using Prism.Ioc;
// using Prism.Modularity;
// using System.Windows;
// using YourMainModule; // Namespace of your module
// public class YourBootstrapper : PrismBootstrapper
// {
// protected override DependencyObject CreateShell()
// {
// return Container.Resolve<ShellWindow>(); // Your main window
  // }
  // protected override void RegisterTypes(IContainerRegistry containerRegistry)
  // {
  // // Register global services, etc.
  // }
  // protected override void ConfigureModuleCatalog(IModuleCatalog moduleCatalog)
  // {
  // moduleCatalog.AddModule<MainModule>(); // Example: Main application module
    // moduleCatalog.AddModule<LoggingModule.LoggingModule>(); // Example: A dedicated logging module
      // // ... other modules
      // }
      // }

4.2.2 视图注册与导航

视图和视图模型在模块中注册，并通过区域管理器 (RegionManager) 进行导航。

// filepath: MainModule.cs (Example Prism Module)
// using Prism.Ioc;
// using Prism.Modularity;
// using Prism.Regions;
// using YourApp.Views; // Namespace for views
// using YourApp.ViewModels; // Namespace for viewmodels
// public class MainModule : IModule
// {
// public void OnInitialized(IContainerProvider containerProvider)
// {
// var regionManager = containerProvider.Resolve<IRegionManager>();
  // // Initial navigation if needed
  // regionManager.RequestNavigate("ContentRegionNameInShell", nameof(MainView));
  // }
  // public void RegisterTypes(IContainerRegistry containerRegistry)
  // {
  // // Register views for navigation
  // containerRegistry.RegisterForNavigation<MainView, MainViewModel>();
    // containerRegistry.RegisterForNavigation<LogView, LogViewModel>();
      // containerRegistry.RegisterForNavigation<AlarmView, AlarmViewModel>();
        // // ... register other views and their viewmodels
        // }
        // }

在 ViewModel 中导航:

// filepath: ShellViewModel.cs or AnyViewModelWithNavigation.cs
// using Prism.Commands;
// using Prism.Mvvm;
// using Prism.Regions;
// public class ShellViewModel : BindableBase
// {
// private readonly IRegionManager _regionManager;
// public DelegateCommand<string> NavigateCommand { get; private set; }
  // public ShellViewModel(IRegionManager regionManager)
  // {
  // _regionManager = regionManager;
  // NavigateCommand = new DelegateCommand<string>(Navigate);
    // }
    // private void Navigate(string navigationPath)
    // {
    // // navigationPath would be the name of the view registered for navigation, e.g., "LogView"
    // _regionManager.RequestNavigate("ContentRegionNameInShell", navigationPath, navigationResult =>
    // {
    // if (navigationResult.Result == false)
    // {
    // LogManage.Error($"导航到 {navigationPath} 失败: {navigationResult.Error?.Message}");
    // }
    // });
    // }
    // }

4.3 相机集成 (DeBugView 相关)

系统支持多种品牌相机（海康、Basler、大恒），通过工厂模式创建相机实例。

4.3.1 ICamera (接口) 和 CamFactory

• ICamera: 定义相机操作的通用接口 (如初始化、枚举设备、打开/关闭设备、开始/停止抓图、获取/设置参数、注册图像回调)。
• CamFactory: 工厂类，用于根据品牌 (CameraBrand 枚举) 创建具体的相机实例。
• CameraBrand (枚举): HIK, Basler, DaHeng。

C# 使用方法 ():

// filepath: CameraControlService.cs or DebugCameraViewModel.cs
// using IW.Camera; // Assuming camera related classes are in this namespace (ICamera, CamFactory, CameraBrand, ImageEventArgs)
// using System.Collections.Generic;
// using System.Linq;
// using System.Windows.Media.Imaging; // For BitmapSource if image is converted
// public class CameraControlService
// {
// private ICamera _activeCamera;
// public event EventHandler<BitmapSource> NewImageReceived; // Example event for UI
  // public List<string> EnumerateDevices(CameraBrand brand)
    // {
    // // This might be a static method on CamFactory or require a temporary instance
    // // return CamFactory.GetDeviceEnum(brand);
    // // Or, if GetListEnum is instance-based after CreatCamera:
    // ICamera tempCam = CamFactory.CreatCamera(brand);
    // return tempCam?.GetListEnum(); // Ensure to handle tempCam disposal if it opens resources
    // }
    // public bool InitializeCamera(CameraBrand brand, string deviceIdentifier) // deviceIdentifier could be SN or UserDefinedName
    // {
    // if (_activeCamera != null && _activeCamera.IsDeviceOpen())
    // {
    // _activeCamera.CloseDevice();
    // _activeCamera.ImageGrabbed -= OnCameraImageGrabbed; // Unsubscribe
    // }
    // _activeCamera = CamFactory.CreatCamera(brand);
    // if (_activeCamera == null)
    // {
    // LogManage.Error($"创建相机实例失败: {brand}");
    // return false;
    // }
    // if (!_activeCamera.InitDevice(deviceIdentifier)) // InitDevice might take SN or index
    // {
    // LogManage.Error($"初始化相机设备失败: {deviceIdentifier} ({brand})");
    // return false;
    // }
    // _activeCamera.ImageGrabbed += OnCameraImageGrabbed; // Subscribe to image event
    // LogManage.Info($"相机 {deviceIdentifier} ({brand}) 初始化成功。");
    // return true;
    // }
    // public void StartGrabbing()
    // {
    // _activeCamera?.StartGrabbing();
    // }
    // public void StopGrabbing()
    // {
    // _activeCamera?.StopGrabbing();
    // }
    // public void CloseCamera()
    // {
    // if (_activeCamera != null)
    // {
    // _activeCamera.StopGrabbing(); // Ensure grabbing is stopped
    // _activeCamera.CloseDevice(); // This should handle unregistering/releasing resources
    // _activeCamera.ImageGrabbed -= OnCameraImageGrabbed;
    // _activeCamera = null;
    // LogManage.Info("相机已关闭。");
    // }
    // }
    // private void OnCameraImageGrabbed(object sender, ImageEventArgs e) // Assuming ImageEventArgs contains image data
    // {
    // // Process e.Bitmap or e.RawImageData
    // // Example: Convert to BitmapSource for WPF UI
    // // BitmapSource bmpSource = ConvertToBitmapSource(e.Bitmap);
    // // NewImageReceived?.Invoke(this, bmpSource);
    // }
    // // public BitmapSource ConvertToBitmapSource(System.Drawing.Bitmap bitmap) { /* ... conversion logic ... */ return null; }
    // }

心跳机制:
为解决调试时直接中断程序导致相机未注销的问题，网口相机增加了心跳检测。若连接断开超过预设时间（如1000ms），相机会自动注销，方便下次直接连接。此功能通常在相机SDK的特定实现中处理，或由 ICamera 实现类内部管理。

---

>如果需要源代码请私信我