/// <summary>
/// 使用指定的类型写入指定的节点数据 -> Writes the specified node data with the specified type
/// </summary>
/// <param name="address">节点的名称 -> Name of the node </param>
/// <param name="typeCode">类型代码，详细参见<see cref="AllenBradleyHelper"/>上的常用字段 -> Type code, see the commonly used Fields section on the <see cref= "AllenBradleyHelper"/> in detail</param>
/// <param name="value">实际的数据值 -> The actual data value </param>
/// <param name="length">如果节点是数组，就是数组长度 -> If the node is an array, it is the array length </param>
/// <returns>是否写入成功 -> Whether to write successfully</returns>
public OperateResult WriteTag(string address, ushort typeCode, byte[] value, int length = 1)
{
OperateResult <byte[]> command = BuildWriteCommand(address, typeCode, value, length);
if (!command.IsSuccess)
{
return(command);
}
OperateResult <byte[]> read = ReadFromCoreServer(command.Content);
if (!read.IsSuccess)
{
return(read);
}
OperateResult check = CheckResponse(read.Content);
if (!check.IsSuccess)
{
return(OperateResult.CreateFailedResult <byte[]>(check));
}
return(AllenBradleyHelper.ExtractActualData(read.Content, false));
}
/// <summary>
/// 批量读取数据信息，数据长度为读取的数组长度信息 -> Bulk read data information, data length for read array length information
/// </summary>
/// <param name="address">节点的名称 -> Name of the node </param>
/// <param name="length">如果是数组，就为数组长度 -> In the case of arrays, the length of the array </param>
/// <returns>带有结果对象的结果数据 -> Result data with result object </returns>
public OperateResult <byte[]> Read(string[] address, int[] length)
{
// 指令生成 -> Instruction Generation
OperateResult <byte[]> command = BuildReadCommand(address, length);
if (!command.IsSuccess)
{
return(command);
}
// 核心交互 -> Core Interactions
OperateResult <byte[]> read = ReadFromCoreServer(command.Content);
if (!read.IsSuccess)
{
return(read);
}
// 检查反馈 -> Check Feedback
OperateResult check = CheckResponse(read.Content);
if (!check.IsSuccess)
{
return(OperateResult.CreateFailedResult <byte[]>(check));
}
// 提取数据 -> Extracting data
return(AllenBradleyHelper.ExtractActualData(read.Content, true));
}
/// <summary>
/// Create a written message instruction
/// </summary>
/// <param name="address">The address of the tag name </param>
/// <param name="typeCode">Data type</param>
/// <param name="data">Source Data </param>
/// <param name="length">In the case of arrays, the length of the array </param>
/// <returns>Message information that contains the result object</returns>
public OperateResult <byte[]> BuildWriteCommand(string address, ushort typeCode, byte[] data, int length = 1)
{
byte[] cip = AllenBradleyHelper.PackRequestWrite(address, typeCode, data, length);
byte[] commandSpecificData = AllenBradleyHelper.PackCommandSpecificData(Slot, cip);
return(OperateResult.CreateSuccessResult(AllenBradleyHelper.PackRequestHeader(0x6F, SessionHandle, commandSpecificData)));
}
/// <summary>
/// Build a read command bytes
/// </summary>
/// <param name="address">the address of the tag name</param>
/// <param name="length">Array information, if not arrays, is 1 </param>
/// <returns>Message information that contains the result object </returns>
public OperateResult <byte[]> BuildReadCommand(string[] address, int[] length)
{
if (address == null || length == null)
{
return(new OperateResult <byte[]>("address or length is null"));
}
if (address.Length != length.Length)
{
return(new OperateResult <byte[]>("address and length is not same array"));
}
List <byte[]> cips = new List <byte[]>( );
for (int i = 0; i < address.Length; i++)
{
cips.Add(AllenBradleyHelper.PackRequsetRead(address[i], length[i]));
}
byte[] commandSpecificData = AllenBradleyHelper.PackCommandSpecificData(Slot, cips.ToArray( ));
return(OperateResult.CreateSuccessResult(AllenBradleyHelper.PackRequestHeader(0x6F, SessionHandle, commandSpecificData)));
}
/// <summary>
/// 获取卸载一个已注册的会话的报文 ->
/// Get a message to uninstall a registered session
/// </summary>
/// <returns>字节报文信息 -> BYTE message information </returns>
public byte[] UnRegisterSessionHandle( )
{
return(AllenBradleyHelper.PackRequestHeader(0x66, SessionHandle, new byte[0]));
}
/// <summary>
/// 向PLC注册会话ID的报文 ->
/// Register a message with the PLC for the session ID
/// </summary>
/// <returns>报文信息 -> Message information </returns>
public byte[] RegisterSessionHandle( )
{
byte[] commandSpecificData = new byte[] { 0x01, 0x00, 0x00, 0x00, };
return(AllenBradleyHelper.PackRequestHeader(0x65, 0, commandSpecificData));
}
