Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcBinary3EFrameBuilder에 대한 협력 다이어그램:

Public 멤버 함수
	MitsubishiMcBinary3EFrameBuilder ()
	MitsubishiMcBinary3EFrameBuilder (MitsubishiMcDeviceCodeMapper deviceCodeMapper)
PlcResult< byte[]>	BuildBatchReadFrame (MitsubishiMcConnectionOptions options, PlcAddress address, int count, bool isBitAccess)
PlcResult< byte[]>	BuildBatchWriteWordsFrame (MitsubishiMcConnectionOptions options, PlcAddress address, IReadOnlyList< short > values)
PlcResult< byte[]>	BuildBatchWriteBitsFrame (MitsubishiMcConnectionOptions options, PlcAddress address, IReadOnlyList< bool > values)

정적 Private 멤버 함수
static List< byte >	BuildBatchAccessPayload (MitsubishiMcCommand command, MitsubishiMcSubCommand subCommand, PlcAddress address, int count, MitsubishiMcDeviceCode deviceCode)
static byte[]	BuildFrame (MitsubishiMcConnectionOptions options, IReadOnlyCollection< byte > payload)

Private 속성
readonly MitsubishiMcDeviceCodeMapper	_deviceCodeMapper

정적 Private 속성
const ushort	SubHeader = 0x5000

상세한 설명

Mitsubishi MC 프로토콜 Binary 3E 요청 프레임을 만듭니다.

MitsubishiMcBinary3EFrameBuilder.cs 파일의 16 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

◆ MitsubishiMcBinary3EFrameBuilder() [1/2]

Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcBinary3EFrameBuilder.MitsubishiMcBinary3EFrameBuilder ( )

inline

기본 디바이스 매퍼로 프레임 빌더를 초기화합니다.

MitsubishiMcBinary3EFrameBuilder.cs 파일의 45 번째 라인에서 정의되었습니다.

        : this(new MitsubishiMcDeviceCodeMapper())
    {
    }

◆ MitsubishiMcBinary3EFrameBuilder() [2/2]

Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcBinary3EFrameBuilder.MitsubishiMcBinary3EFrameBuilder ( MitsubishiMcDeviceCodeMapper deviceCodeMapper )

inline

지정한 디바이스 매퍼로 프레임 빌더를 초기화합니다.

매개변수

deviceCodeMapper 디바이스 코드 매퍼입니다.

예외

ArgumentNullException 매퍼가 null인 경우 발생합니다.

MitsubishiMcBinary3EFrameBuilder.cs 파일의 74 번째 라인에서 정의되었습니다.

    {
        _deviceCodeMapper = deviceCodeMapper ?? throw new ArgumentNullException(nameof(deviceCodeMapper));
    }

다음을 참조함 : _deviceCodeMapper.

멤버 함수 문서화

◆ BuildBatchAccessPayload()

List< byte > Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcBinary3EFrameBuilder.BuildBatchAccessPayload	(	MitsubishiMcCommand	command,
		MitsubishiMcSubCommand	subCommand,
		PlcAddress	address,
		int	count,
		MitsubishiMcDeviceCode	deviceCode )

inlinestaticprivate

일괄 접근 명령 헤더 페이로드를 만듭니다.

매개변수

command	명령입니다.
subCommand	하위 명령입니다.
address	주소입니다.
count	항목 수입니다.
deviceCode	디바이스 코드입니다.

반환값: 명령 페이로드입니다.

MitsubishiMcBinary3EFrameBuilder.cs 파일의 420 번째 라인에서 정의되었습니다.

    {
        const int batchAccessHeaderLength = 10;
        var payload = new List<byte>(batchAccessHeaderLength);
 
        MitsubishiMcEndian.WriteUInt16LittleEndian(payload, (ushort)command);
        MitsubishiMcEndian.WriteUInt16LittleEndian(payload, (ushort)subCommand);
        MitsubishiMcEndian.WriteUInt24LittleEndian(payload, address.Offset);
        payload.Add((byte)deviceCode);
        MitsubishiMcEndian.WriteUInt16LittleEndian(payload, checked((ushort)count));
 
        return payload;
    }

다음을 참조함 : Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcEndian.WriteUInt16LittleEndian(), Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcEndian.WriteUInt24LittleEndian().

다음에 의해서 참조됨 : BuildBatchReadFrame(), BuildBatchWriteBitsFrame(), BuildBatchWriteWordsFrame().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ BuildBatchReadFrame()

PlcResult< byte[]> Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcBinary3EFrameBuilder.BuildBatchReadFrame	(	MitsubishiMcConnectionOptions	options,
		PlcAddress	address,
		int	count,
		bool	isBitAccess )

inline

일괄 읽기 요청 프레임을 만듭니다.

매개변수

options	연결 옵션입니다.
address	시작 주소입니다.
count	읽을 디바이스 수입니다.
isBitAccess	비트 접근 여부입니다.

반환값: 프레임 바이트 결과입니다.

예외

ArgumentNullException	옵션이 `null`인 경우 발생합니다.
OverflowException	항목 수 또는 프레임 길이가 프로토콜 범위를 벗어난 경우 발생합니다.
ArgumentOutOfRangeException	주소 오프셋이 24비트 범위를 벗어난 경우 발생합니다.

MitsubishiMcBinary3EFrameBuilder.cs 파일의 145 번째 라인에서 정의되었습니다.

    {
        ArgumentNullException.ThrowIfNull(options);
 
        if (count <= 0)
        {
            return PlcResult<byte[]>.Failure("The read count must be greater than zero.");
        }
 
        var deviceCodeResult = _deviceCodeMapper.Map(address.DeviceType);
        if (!deviceCodeResult.IsSuccess)
        {
            return PlcResult<byte[]>.Failure(
                deviceCodeResult.Message ?? "Unsupported Mitsubishi MC device type.",
                deviceCodeResult.ErrorCode);
        }
 
        var payload = BuildBatchAccessPayload(
            MitsubishiMcCommand.BatchRead,
            isBitAccess ? MitsubishiMcSubCommand.Bit : MitsubishiMcSubCommand.Word,
            address,
            count,
            deviceCodeResult.Value);
 
        return PlcResult<byte[]>.Success(BuildFrame(options, payload));
    }

다음을 참조함 : _deviceCodeMapper, BuildBatchAccessPayload(), BuildFrame().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ BuildBatchWriteBitsFrame()

PlcResult< byte[]> Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcBinary3EFrameBuilder.BuildBatchWriteBitsFrame	(	MitsubishiMcConnectionOptions	options,
		PlcAddress	address,
		IReadOnlyList< bool >	values )

inline

일괄 비트 쓰기 요청 프레임을 만듭니다.

매개변수

options	연결 옵션입니다.
address	시작 주소입니다.
values	비트 값입니다.

반환값: 프레임 바이트 결과입니다.

예외

ArgumentNullException	옵션 또는 값이 `null`인 경우 발생합니다.
OverflowException	항목 수 또는 프레임 길이가 범위를 벗어난 경우 발생합니다.
ArgumentOutOfRangeException	주소 오프셋이 24비트 범위를 벗어난 경우 발생합니다.

MitsubishiMcBinary3EFrameBuilder.cs 파일의 330 번째 라인에서 정의되었습니다.

    {
        ArgumentNullException.ThrowIfNull(options);
        ArgumentNullException.ThrowIfNull(values);
 
        if (values.Count == 0)
        {
            return PlcResult<byte[]>.Failure("The bit value collection must not be empty.");
        }
 
        var deviceCodeResult = _deviceCodeMapper.Map(address.DeviceType);
        if (!deviceCodeResult.IsSuccess)
        {
            return PlcResult<byte[]>.Failure(
                deviceCodeResult.Message ?? "Unsupported Mitsubishi MC device type.",
                deviceCodeResult.ErrorCode);
        }
 
        var payload = BuildBatchAccessPayload(
            MitsubishiMcCommand.BatchWrite,
            MitsubishiMcSubCommand.Bit,
            address,
            values.Count,
            deviceCodeResult.Value);
 
        for (var i = 0; i < values.Count; i += 2)
        {
            var high = values[i] ? 0x10 : 0x00;
            var low = i + 1 < values.Count && values[i + 1] ? 0x01 : 0x00;
 
            payload.Add((byte)(high | low));
        }
 
        return PlcResult<byte[]>.Success(BuildFrame(options, payload));
    }

다음을 참조함 : _deviceCodeMapper, BuildBatchAccessPayload(), BuildFrame().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ BuildBatchWriteWordsFrame()

PlcResult< byte[]> Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcBinary3EFrameBuilder.BuildBatchWriteWordsFrame	(	MitsubishiMcConnectionOptions	options,
		PlcAddress	address,
		IReadOnlyList< short >	values )

inline

일괄 워드 쓰기 요청 프레임을 만듭니다.

매개변수

options	연결 옵션입니다.
address	시작 주소입니다.
values	워드 값입니다.

반환값: 프레임 바이트 결과입니다.

예외

ArgumentNullException	옵션 또는 값이 `null`인 경우 발생합니다.
OverflowException	항목 수 또는 프레임 길이가 범위를 벗어난 경우 발생합니다.
ArgumentOutOfRangeException	주소 오프셋이 24비트 범위를 벗어난 경우 발생합니다.

MitsubishiMcBinary3EFrameBuilder.cs 파일의 235 번째 라인에서 정의되었습니다.

    {
        ArgumentNullException.ThrowIfNull(options);
        ArgumentNullException.ThrowIfNull(values);
 
        if (values.Count == 0)
        {
            return PlcResult<byte[]>.Failure("The word value collection must not be empty.");
        }
 
        var deviceCodeResult = _deviceCodeMapper.Map(address.DeviceType);
        if (!deviceCodeResult.IsSuccess)
        {
            return PlcResult<byte[]>.Failure(
                deviceCodeResult.Message ?? "Unsupported Mitsubishi MC device type.",
                deviceCodeResult.ErrorCode);
        }
 
        var payload = BuildBatchAccessPayload(
            MitsubishiMcCommand.BatchWrite,
            MitsubishiMcSubCommand.Word,
            address,
            values.Count,
            deviceCodeResult.Value);
 
        foreach (var value in values)
        {
            MitsubishiMcEndian.WriteUInt16LittleEndian(payload, unchecked((ushort)value));
        }
 
        return PlcResult<byte[]>.Success(BuildFrame(options, payload));
    }

다음을 참조함 : _deviceCodeMapper, BuildBatchAccessPayload(), BuildFrame(), Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcEndian.WriteUInt16LittleEndian().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ BuildFrame()

byte[] Dreamine.PLC.Mitsubishi.MC.Protocol.MitsubishiMcBinary3EFrameBuilder.BuildFrame	(	MitsubishiMcConnectionOptions	options,
		IReadOnlyCollection< byte >	payload )

inlinestaticprivate

라우팅 헤더, 길이, 타이머 및 페이로드를 결합해 Binary 3E 프레임을 만듭니다.

매개변수

options	연결 옵션입니다.
payload	명령 페이로드입니다.

반환값: 완성된 프레임입니다.

MitsubishiMcBinary3EFrameBuilder.cs 파일의 469 번째 라인에서 정의되었습니다.

    {
        const int frameHeaderLength = 11;
        var frame = new List<byte>(frameHeaderLength + payload.Count);
 
        MitsubishiMcEndian.WriteUInt16LittleEndian(frame, SubHeader);
        frame.Add(options.NetworkNumber);
        frame.Add(options.PlcNumber);
        MitsubishiMcEndian.WriteUInt16LittleEndian(frame, options.DestinationModuleIoNumber);
        frame.Add(options.DestinationModuleStationNumber);
 
        var requestDataLength = checked((ushort)(payload.Count + 2));
        MitsubishiMcEndian.WriteUInt16LittleEndian(frame, requestDataLength);
        MitsubishiMcEndian.WriteUInt16LittleEndian(frame, options.MonitoringTimer);
 
        frame.AddRange(payload);
 
        return frame.ToArray();
    }