Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController 클래스 참조

더 자세히 ...

Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController에 대한 상속 다이어그램 :

Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController에 대한 협력 다이어그램:

Public 멤버 함수
	FastechEthernetIoController (FastechEthernetIoOptions options)
	FastechEthernetIoController (FastechEthernetIoOptions options, IFastechEthernetIoProtocol protocol)
	FastechEthernetIoController (FastechEthernetIoOptions options, IFastechEthernetIoTransport transport, IFastechEthernetIoProtocol protocol)
async Task< IoResult >	ConnectAsync (CancellationToken cancellationToken=default)
async Task< IoResult >	DisconnectAsync (CancellationToken cancellationToken=default)
async ValueTask	DisposeAsync ()

속성
FastechEthernetIoOptions	Options [get]
IoConnectionState	State = IoConnectionState.Disconnected [get, private set]
IDigitalInputChannel	DigitalInputs [get]
IDigitalOutputChannel	DigitalOutputs [get]
IAnalogInputChannel	AnalogInputs [get]
IAnalogOutputChannel	AnalogOutputs [get]

이벤트
EventHandler< IoConnectionState >?	StateChanged

Private 멤버 함수
async Task< IoResult< TValue[]> >	SendReadAsync< TPoint, TValue > (IReadOnlyList< TPoint > points, Func< IReadOnlyList< TPoint >, byte[]> buildRequest, Func< IReadOnlyList< byte >, IoResult< TValue[]> > parseResponse, CancellationToken cancellationToken)
async Task< IoResult >	SendWriteAsync< TKey, TValue > (IReadOnlyDictionary< TKey, TValue > values, Func< IReadOnlyDictionary< TKey, TValue >, byte[]> buildRequest, Func< IReadOnlyList< byte >, IoResult > parseResponse, CancellationToken cancellationToken)
async Task< IoResult< byte[]> >	SendAsync (byte[] request, CancellationToken cancellationToken)
void	SetState (IoConnectionState state)
void	ThrowIfDisposed ()

정적 Private 멤버 함수
static IFastechEthernetIoTransport	CreateTransport (FastechEthernetIoOptions options)

Private 속성
readonly FastechEthernetIoOptions	_options
readonly IFastechEthernetIoTransport	_transport
readonly IFastechEthernetIoProtocol	_protocol
bool	_disposed

상세한 설명

전송과 장치 프로토콜을 조합하여 Fastech Ethernet I/O 채널을 제공하는 컨트롤러입니다.

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

생성자 & 소멸자 문서화

FastechEthernetIoController() [1/3]

Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.FastechEthernetIoController ( FastechEthernetIoOptions options )

inline

옵션에 맞는 기본 전송과 검증된 16점 DIO 프로토콜로 컨트롤러를 초기화합니다.

매개변수

options

Fastech 연결 옵션입니다.

예외

ArgumentNullException	options 가 null인 경우 발생합니다.
ArgumentOutOfRangeException	전송 형식이 지원되지 않는 경우 발생합니다.

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

        : this(
            options,
            CreateTransport(options),
            new FastechPlusE16PointProtocol())
    {
    }

다음을 참조함 : CreateTransport().

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

FastechEthernetIoController() [2/3]

Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.FastechEthernetIoController ( FastechEthernetIoOptions options, IFastechEthernetIoProtocol protocol )

inline

옵션에 맞는 기본 전송과 지정한 프로토콜로 컨트롤러를 초기화합니다.

매개변수

options	Fastech 연결 옵션입니다.
protocol	장치 프로토콜 구현입니다.

예외

ArgumentNullException	인수 중 하나가 null인 경우 발생합니다.
ArgumentOutOfRangeException	전송 형식이 지원되지 않는 경우 발생합니다.

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

        : this(options, CreateTransport(options), protocol)
    {
    }

다음을 참조함 : CreateTransport().

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

FastechEthernetIoController() [3/3]

Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.FastechEthernetIoController ( FastechEthernetIoOptions options, IFastechEthernetIoTransport transport, IFastechEthernetIoProtocol protocol )

inline

지정한 옵션, 전송 및 프로토콜로 컨트롤러와 네 채널을 초기화합니다.

매개변수

options	Fastech 연결 옵션입니다.
transport	요청/응답 전송입니다.
protocol	장치 프로토콜 구현입니다.

예외

ArgumentNullException

인수 중 하나가 null인 경우 발생합니다.

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

    {
        _options = options ?? throw new ArgumentNullException(nameof(options));
        _transport = transport ?? throw new ArgumentNullException(nameof(transport));
        _protocol = protocol ?? throw new ArgumentNullException(nameof(protocol));
 
        DigitalInputs = new FastechDigitalInputChannel(this);
        DigitalOutputs = new FastechDigitalOutputChannel(this);
        AnalogInputs = new FastechAnalogInputChannel(this);
        AnalogOutputs = new FastechAnalogOutputChannel(this);
    }

다음을 참조함 : _options, _protocol, _transport, AnalogInputs, AnalogOutputs, DigitalInputs, DigitalOutputs.

멤버 함수 문서화

ConnectAsync()

async Task< IoResult > Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.ConnectAsync ( CancellationToken cancellationToken = default )

inline

전송을 연결하고 상태를 Connecting에서 Connected 또는 Faulted로 전환합니다.

매개변수

cancellationToken

연결 취소 토큰입니다.

반환값

전송 연결 결과입니다.

예외

ObjectDisposedException

컨트롤러가 해제된 경우 발생합니다.

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

    {
        ThrowIfDisposed();
        SetState(IoConnectionState.Connecting);
 
        var result = await _transport.ConnectAsync(cancellationToken).ConfigureAwait(false);
        SetState(result.IsSuccess ? IoConnectionState.Connected : IoConnectionState.Faulted);
 
        return result;
    }

다음을 참조함 : _transport, SetState(), ThrowIfDisposed().

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

CreateTransport()

IFastechEthernetIoTransport Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.CreateTransport ( FastechEthernetIoOptions options )

inlinestaticprivate

옵션의 전송 형식에 맞는 UDP 또는 TCP 전송을 만듭니다.

매개변수

options

전송 구성 옵션입니다.

반환값

새 전송 구현입니다.

예외

ArgumentNullException	options 가 null인 경우 발생합니다.
ArgumentOutOfRangeException	전송 형식이 지원되지 않는 경우 발생합니다.

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

    {
        ArgumentNullException.ThrowIfNull(options);
 
        return options.TransportType switch
        {
            FastechEthernetIoTransportType.Udp => new UdpFastechEthernetIoTransport(options),
            FastechEthernetIoTransportType.Tcp => new TcpFastechEthernetIoTransport(options),
            _ => throw new ArgumentOutOfRangeException(nameof(options), options.TransportType, "Unsupported Fastech Ethernet I/O transport type.")
        };
    }

다음을 참조함 : Dreamine.IO.Fastech.Ethernet.Options.Tcp, Dreamine.IO.Fastech.Ethernet.Options.FastechEthernetIoOptions.TransportType, Dreamine.IO.Fastech.Ethernet.Options.Udp.

다음에 의해서 참조됨 : FastechEthernetIoController(), FastechEthernetIoController().

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

DisconnectAsync()

async Task< IoResult > Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.DisconnectAsync ( CancellationToken cancellationToken = default )

inline

전송 연결을 해제하고 상태를 Disconnecting에서 Disconnected 또는 Faulted로 전환합니다.

매개변수

cancellationToken

연결 해제 취소 토큰입니다.

반환값

전송 연결 해제 결과입니다.

예외

ObjectDisposedException

컨트롤러가 해제된 경우 발생합니다.

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

    {
        ThrowIfDisposed();
        SetState(IoConnectionState.Disconnecting);
 
        var result = await _transport.DisconnectAsync(cancellationToken).ConfigureAwait(false);
        SetState(result.IsSuccess ? IoConnectionState.Disconnected : IoConnectionState.Faulted);
 
        return result;
    }

다음을 참조함 : _transport, SetState(), ThrowIfDisposed().

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

DisposeAsync()

async ValueTask Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.DisposeAsync ( )

inline

전송을 비동기 해제하고 컨트롤러를 Disconnected 상태로 전환합니다.

반환값

비동기 해제 작업입니다.

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

    {
        if (_disposed)
        {
            return;
        }
 
        await _transport.DisposeAsync().ConfigureAwait(false);
        _disposed = true;
        SetState(IoConnectionState.Disconnected);
 
        GC.SuppressFinalize(this);
    }

다음을 참조함 : _disposed, _transport, SetState().

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

SendAsync()

async Task< IoResult< byte[]> > Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.SendAsync ( byte[] request, CancellationToken cancellationToken )

inlineprivate

연결 상태를 확인하고 구성된 횟수만큼 요청/응답 교환을 재시도합니다.

매개변수

request	전송할 요청 프레임입니다.
cancellationToken	교환 취소 토큰입니다.

반환값

첫 성공 응답 또는 마지막 실패 결과입니다.

예외

ObjectDisposedException

컨트롤러가 해제된 경우 발생합니다.

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

    {
        ThrowIfDisposed();
 
        if (State != IoConnectionState.Connected || !_transport.IsConnected)
        {
            return IoResult<byte[]>.Failure("The Fastech Ethernet I/O controller is not connected.");
        }
 
        IoResult<byte[]>? lastResult = null;
 
        for (var attempt = 0; attempt <= _options.RetryCount; attempt++)
        {
            lastResult = await _transport.SendAndReceiveAsync(
                request,
                _options.ReceiveTimeoutMs,
                _options.ExpectedResponseLength,
                cancellationToken).ConfigureAwait(false);
 
            if (lastResult.IsSuccess)
            {
                return lastResult;
            }
        }
 
        return lastResult ?? IoResult<byte[]>.Failure("The Fastech Ethernet I/O request was not sent.");
    }

다음을 참조함 : _options, _transport, State, ThrowIfDisposed().

다음에 의해서 참조됨 : SendReadAsync< TPoint, TValue >(), SendWriteAsync< TKey, TValue >().

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

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

SendReadAsync< TPoint, TValue >()

async Task< IoResult< TValue[]> > Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.SendReadAsync< TPoint, TValue > ( IReadOnlyList< TPoint > points, Func< IReadOnlyList< TPoint >, byte[]> buildRequest, Func< IReadOnlyList< byte >, IoResult< TValue[]> > parseResponse, CancellationToken cancellationToken )

inlineprivate

읽기 요청 생성·전송·파싱 단계의 예외를 I/O 실패 결과로 변환합니다.

템플릿 파라메터

TPoint	I/O 지점 형식입니다.
TValue	파싱할 값 형식입니다.

매개변수

points	요청할 지점입니다.
buildRequest	요청 프레임 생성기입니다.
parseResponse	응답 파서입니다.
cancellationToken	요청 취소 토큰입니다.

반환값

파싱된 값 배열 또는 실패 결과입니다.

예외

ArgumentNullException

points 가 null인 경우 발생합니다.

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

    {
        ArgumentNullException.ThrowIfNull(points);
 
        if (points.Count == 0)
        {
            return IoResult<TValue[]>.Failure("At least one I/O point is required.");
        }
 
        byte[] request;
        try
        {
            request = buildRequest(points);
        }
        catch (Exception ex)
        {
            return IoResult<TValue[]>.Failure(ex.Message);
        }
 
        var response = await SendAsync(request, cancellationToken).ConfigureAwait(false);
        if (!response.IsSuccess || response.Value is null)
        {
            return IoResult<TValue[]>.Failure(response.Message ?? "Failed to receive the Fastech Ethernet I/O response.", response.ErrorCode);
        }
 
        try
        {
            return parseResponse(response.Value);
        }
        catch (Exception ex)
        {
            return IoResult<TValue[]>.Failure(ex.Message);
        }
    }

다음을 참조함 : SendAsync().

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

SendWriteAsync< TKey, TValue >()

async Task< IoResult > Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.SendWriteAsync< TKey, TValue > ( IReadOnlyDictionary< TKey, TValue > values, Func< IReadOnlyDictionary< TKey, TValue >, byte[]> buildRequest, Func< IReadOnlyList< byte >, IoResult > parseResponse, CancellationToken cancellationToken )

inlineprivate

쓰기 요청 생성·전송·파싱 단계의 예외를 I/O 실패 결과로 변환합니다.

템플릿 파라메터

TKey	출력 키 형식입니다.
TValue	출력 값 형식입니다.

매개변수

values	쓸 키별 값입니다.
buildRequest	요청 프레임 생성기입니다.
parseResponse	쓰기 응답 파서입니다.
cancellationToken	요청 취소 토큰입니다.

반환값

쓰기 성공 또는 실패 결과입니다.

예외

ArgumentNullException

values 가 null인 경우 발생합니다.

타입 한정자들

TKey

:

notnull

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

                   : notnull
    {
        ArgumentNullException.ThrowIfNull(values);
 
        if (values.Count == 0)
        {
            return IoResult.Failure("At least one I/O value is required.");
        }
 
        byte[] request;
        try
        {
            request = buildRequest(values);
        }
        catch (Exception ex)
        {
            return IoResult.Failure(ex.Message);
        }
 
        var response = await SendAsync(request, cancellationToken).ConfigureAwait(false);
        if (!response.IsSuccess || response.Value is null)
        {
            return IoResult.Failure(response.Message ?? "Failed to receive the Fastech Ethernet I/O response.", response.ErrorCode);
        }
 
        try
        {
            return parseResponse(response.Value);
        }
        catch (Exception ex)
        {
            return IoResult.Failure(ex.Message);
        }
    }

다음을 참조함 : SendAsync().

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

SetState()

void Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.SetState ( IoConnectionState state )

inlineprivate

연결 상태가 달라진 경우 갱신하고 상태 변경 이벤트를 발생시킵니다.

매개변수

state

새 연결 상태입니다.

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

    {
        if (State == state)
        {
            return;
        }
 
        State = state;
        StateChanged?.Invoke(this, state);
    }

다음을 참조함 : State, StateChanged.

다음에 의해서 참조됨 : ConnectAsync(), DisconnectAsync(), DisposeAsync().

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

ThrowIfDisposed()

void Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.ThrowIfDisposed ( )

inlineprivate

컨트롤러가 이미 해제되었으면 예외를 발생시킵니다.

예외

ObjectDisposedException

컨트롤러가 해제된 경우 발생합니다.

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

    {
        ObjectDisposedException.ThrowIf(_disposed, this);
    }

다음을 참조함 : _disposed.

다음에 의해서 참조됨 : ConnectAsync(), DisconnectAsync(), SendAsync().

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

멤버 데이터 문서화

_disposed

bool Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController._disposed

private

disposed 값을 보관합니다.

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

다음에 의해서 참조됨 : DisposeAsync(), ThrowIfDisposed().

_options

readonly FastechEthernetIoOptions Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController._options

private

options 값을 보관합니다.

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

다음에 의해서 참조됨 : FastechEthernetIoController(), SendAsync().

_protocol

readonly IFastechEthernetIoProtocol Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController._protocol

private

protocol 값을 보관합니다.

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

다음에 의해서 참조됨 : FastechEthernetIoController().

_transport

readonly IFastechEthernetIoTransport Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController._transport

private

transport 값을 보관합니다.

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

다음에 의해서 참조됨 : ConnectAsync(), DisconnectAsync(), DisposeAsync(), FastechEthernetIoController(), SendAsync().

속성 문서화

AnalogInputs

IAnalogInputChannel Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.AnalogInputs

get

아날로그 입력 채널을 가져옵니다.

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

{ get; }

다음에 의해서 참조됨 : FastechEthernetIoController().

AnalogOutputs

IAnalogOutputChannel Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.AnalogOutputs

get

아날로그 출력 채널을 가져옵니다.

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

{ get; }

다음에 의해서 참조됨 : FastechEthernetIoController().

DigitalInputs

IDigitalInputChannel Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.DigitalInputs

get

디지털 입력 채널을 가져옵니다.

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

{ get; }

다음에 의해서 참조됨 : FastechEthernetIoController().

DigitalOutputs

IDigitalOutputChannel Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.DigitalOutputs

get

디지털 출력 채널을 가져옵니다.

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

{ get; }

다음에 의해서 참조됨 : FastechEthernetIoController().

Options

FastechEthernetIoOptions Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.Options

get

현재 Fastech Ethernet I/O 옵션을 가져옵니다.

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

State

IoConnectionState Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.State = IoConnectionState.Disconnected

getprivate set

현재 연결 상태를 가져옵니다.

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

{ get; private set; } = IoConnectionState.Disconnected;

다음에 의해서 참조됨 : SendAsync(), SetState().

이벤트 문서화

StateChanged

EventHandler<IoConnectionState>? Dreamine.IO.Fastech.Ethernet.Controllers.FastechEthernetIoController.StateChanged

연결 상태가 변경될 때 발생합니다.

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

다음에 의해서 참조됨 : SetState().

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• FastechEthernetIoController.cs