FlybeatController 1.0.0

FlybeatController

用于控制相机和光源的命令构建和通信库。支持串口和TCP通信协议，提供流畅的链式API来构建命令。

功能特点

• 支持相机和光源命令的构建
• 支持串口和TCP通信
• 链式API设计
• 异步操作支持
• 类型安全的枚举值
• 资源自动管理

安装

<PackageReference Include="System.IO.Ports" Version="7.0.0" />

使用示例

1. 相机命令

// 构建相机命令
var command = CameraCommandBuilder.CAM()
    .SetStation("Station1")              // 设置工位
    .SetEnabled(true)                    // 设置启用状态
    .SetTriggerPosition("Pos1")         // 设置触发位置
    .Build();

// 使用串口发送命令
using (var sender = new SerialCommandSender("COM1", 9600))
{
    await sender.ConnectAsync();
    await sender.SendCommandAsync(command);
}

// 或使用TCP发送命令
var tcpSender = new TcpCommandSender("localhost", 8080);
await tcpSender.ConnectAsync();
await tcpSender.SendCommandAsync(command);

2. 光源命令

// 构建光源命令
var command = LightCommandBuilder.LIGHT()
    .SetLightId("Light1")                // 设置光源ID
    .SetLightTriggerSource("Source1")    // 设置触发源
    .SetWorkMode(LightWorkMode.LightMode) // 设置工作模式（使用枚举）
    .SetBrightness("200")               // 设置亮度
    .SetLightingTime("1000")            // 设置亮起时间
    .SetEnabled(true)                    // 设置启用状态
    .SetLightSignal(true)               // 设置点亮信号
    .Build();

// 发送命令
using (var sender = new SerialCommandSender("COM1", 9600))
{
    await sender.ConnectAsync();
    await sender.SendCommandAsync(command);
}

3. 从数据行构建命令

// 假设有一个包含配置的字典
Dictionary<string, object> rowData = new Dictionary<string, object>
{
    { "工位", "Station1" },
    { "启用状态", true },
    { "相机触发源", "Pos1" }
};

// 构建相机命令
var cameraCommand = CameraCommandBuilder.CAM()
    .SetStation(rowData["工位"].ToString())
    .SetEnabledFromDataRow(rowData["启用状态"])
    .SetTriggerPosition(rowData["相机触发源"].ToString())
    .Build();

// 光源配置数据
var lightData = new Dictionary<string, object>
{
    { "光源标识", "Light1" },
    { "光源触发源", "Source1" },
    { "启用状态", true },
    { "亮度", "200" },
    { "亮起时间", "1000" },
    { "工作模式", "点亮模式" },
    { "点亮状态", true }
};

// 构建光源命令（完整方式）
var lightCommand = LightCommandBuilder.LIGHT()
    .SetLightId(lightData["光源标识"].ToString())
    .SetLightTriggerSource(lightData["光源触发源"].ToString())
    .SetEnabledFromDataRow(lightData["启用状态"])
    .SetBrightnessIfExists(lightData["亮度"])
    .SetLightingTimeIfExists(lightData["亮起时间"])
    .SetWorkModeFromDataRow(lightData["工作模式"])
    .SetLightSignalFromDataRow(lightData["点亮状态"])
    .Build();

// 或使用简洁方式
var lightCommandConcise = LightCommandBuilder.LIGHT()
    .SetLightId(lightData["光源标识"].ToString())
    .SetLightTriggerSource(lightData["光源触发源"].ToString())
    .SetWorkMode(LightWorkMode.LightMode)  // 直接使用枚举
    .SetBrightness("200")
    .Build();

注意事项

1. 串口通信使用了 SerialPortHelper 类进行封装，提供了更好的异步支持和资源管理
2. 所有的通信操作都是异步的，请使用 await 等待操作完成
3. 使用 using 语句确保资源正确释放
4. 工作模式使用枚举类型 LightWorkMode 提供类型安全
5. 支持从数据行直接构建命令，提供了多种便捷方法

错误处理

try
{
    using (var sender = new SerialCommandSender("COM1", 9600))
    {
        await sender.ConnectAsync();
        await sender.SendCommandAsync(command);
    }
}
catch (InvalidOperationException ex)
{
    // 处理串口未打开等错误
    Console.WriteLine($"操作错误: {ex.Message}");
}
catch (Exception ex)
{
    // 处理其他错误
    Console.WriteLine($"发生错误: {ex.Message}");
}

扩展性

该库设计时考虑了扩展性，您可以：

1. 实现自己的 ICommandSender 来支持其他通信协议
2. 创建新的命令类型，继承 BaseCommand
3. 添加新的命令构建器，继承 BaseCommandBuilder

贡献

欢迎提交问题和改进建议！

许可证

MIT License