Fuji 协议驱动

包: Snet.Fuji | 类: FujiOperate | 类型数量: 4

通过富士专用以太网协议提供与富士电机 PLC（SPH/MICREX-SX 系列）的连接。

安装

dotnet add package Snet.Fuji

快速入门

using Snet.Fuji;

var op = await FujiOperate.InstanceAsync(new FujiData.Basics
{
    IpAddress = "192.168.1.100",
    Port = 2310
});

var address = new Address(new List<AddressDetails>
{
    new("读数", "I100", DataType.Int16),
    new("读数2", "Q100", DataType.Int16)
});
var result = await op.ReadAsync(address);
if (result.Status)
{
    var data = result.GetSource<ConcurrentDictionary<string, AddressValue>>();
    foreach (var kv in data)
        Console.WriteLine($"{kv.Key} = {kv.Value.ResultValue}");
}
else
{
    Console.WriteLine($"读取失败: {result.Message}");
}

// 订阅之前 绑定数据事件
op.OnDataEventAsync += async (sender, e) =>
{
    if (e.Status)
    {
        var data = e.GetSource<ConcurrentDictionary<string, AddressValue>>();
        foreach (var kv in data)
            Console.WriteLine($"{kv.Key} = {kv.Value.ResultValue}");
    }
    else
    {
        Console.WriteLine($"{e.Message}");
    }
};

var subAddr = new Address(new List<AddressDetails>
{
    new("读数", "I100", DataType.Int16)
});
await op.SubscribeAsync(subAddr);

// 后续：取消订阅
// await op.UnSubscribeAsync(subAddr);

await op.DisposeAsync();

配置参数

参数	类型	默认值	说明
IpAddress	string	127.0.0.1	PLC IP 地址
Port	int	6688	通信端口
ConnectTimeOut	int	1000	连接超时（毫秒）
ReceiveTimeOut	int	1000	接收超时（毫秒）
ConnectionID	int	1	SPH CPU 连接 ID（默认 CPU0）
DataFormat	enum	CDAB	数据转换字节序
Station	int	1	PLC 站号（SPB 串口）
SerialPortInfo	string	COM3-9600-8-N-1	串口设置（SPB）
DataSwap	bool	false	交换数据字节（Command Setting Type）

支持类型

适用于 SPH 和 MICREX-SX 系列的富士协议，支持 IX/QX/WX/MX/IY/QY/WY/MY/IZ/QZ/WZ/MZ 寄存器。

• FujiSPHNet — 富士 SPH Net 通信
• FujiSPB — 富士 SPB 通信
• FujiSPBOverTcp — 富士 SPB over TCP
• FujiCommandSettingType — 富士命令设置类型

地址格式

驱动自动识别三种寻址风格(SPH / SPB / CommandSettingType)。

风格	区域	地址格式	示例
SPH	M (类型 1/3/10)	M{类型}.{地址}[.{位}]	M1.100, M3.100.5
SPH	I / Q	I{地址}[.{位}] / Q{地址}[.{位}]	I100.5, Q100
SPB	X/Y/M/L/TN/TC/CN/CC/D/R/W	{字母}{地址}[.{位}]	X0, M100, M100.3, D100
CST	TS/TR/CS/CR/BD/WL/B/M/K/F/A/D/S	{前缀}{地址}	D100, K10, BD5
CST	W 区	W{类型}.{地址}	W9.100

支持的数据类型

所有读取按 AddressDetails.DataType 分发 — 别名(Short = Int16、Float = Single、Int = Int32 等)共用同一分支。

数据类型	支持	说明
Bool	✅	位读取 — 线圈 / 字内位
Int16 / Short, UInt16 / Ushort	✅	16 位整数
Int32 / Int, UInt32 / Uint	✅	32 位整数
Int64 / Long, UInt64 / Ulong	✅	64 位整数
Float / Single, Double	✅	32 / 64 位浮点
String / Char	✅	带 length + 编码读取
ByteArray + 全部 10 种 *Array	✅	带 length 的数组读取
Byte	⚠️ 部分	仅 FujiCommandSettingType 支持

地址自动组包与解包

每个数采驱动都实现 IPacker，因此 FujiOperate 可直接将分散地址合并为最小批量读取，并直接解包结果——无需装配处理器（见 IPacker 接口）：

// 组包：将分散地址合并为最少的批量读取
var packed = await op.PackerAsync(address, "FujiSPHNet");
if (!packed.Status) return;                                  // 组包失败
var packedAddr = packed.GetSource<Address>();

// 一次往返读取组包后的批次
var result = await op.ReadAsync(packedAddr);
if (!result.Status) return;                                  // 读取失败
var data = result.GetSource<ConcurrentDictionary<string, AddressValue>>();

// 解包：将每个批次的原始字节解析回各地址的值
var unpacked = await op.UnPackerAsync(data);
if (!unpacked.Status) return;                                // 解包失败
var values = unpacked.GetSource<List<ConcurrentDictionary<string, AddressValue>>>();
foreach (var dict in values)
    foreach (var v in dict)
        Console.WriteLine($"{v.Key} = {v.Value.ResultValue}");

所有支持的协议类型都支持组包。引擎细节：地址自动组包。

位批自 26.235.x 起采用字边界对齐的位流布局（批内偏移 = 与位所在字的字边界的位号差；M100.8 → 字节 1 位 0）。SPB W 区 Bool（W100 无点号）可组包；CST W{类型号} Bool 降级（无位读）；CST 类型号不在 9/21-26/30-109/120-123/125 范围内的不可组包。

订阅

先绑定数据事件，再通过 SubscribeAsync 添加地址；数据通过 OnDataEventAsync 到达：

op.OnDataEventAsync += async (sender, e) =>
{
    if (e.Status)
    {
        var data = e.GetSource<ConcurrentDictionary<string, AddressValue>>();
        foreach (var kv in data)
            Console.WriteLine($"{kv.Key} = {kv.Value.ResultValue}");
    }
    else
    {
        Console.WriteLine($"订阅错误: {e.Message}");
    }
};

var subAddr = new Address(new List<AddressDetails>
{
    new("读数", "I100", DataType.Int16)
});
await op.SubscribeAsync(subAddr);

// 后续：停止监视
// await op.UnSubscribeAsync(subAddr);

支持操作

操作	方法
连接	OnAsync()
断开	OffAsync()
读取	ReadAsync(address)
写入	WriteAsync(values)
订阅	SubscribeAsync(address)
组包 / 解包	PackerAsync(address, protocolTypeKey) / UnPackerAsync(data)

参见

• DaqAbstract 基类
• IDaq 接口