이 페이지는 기계 번역을 사용하여 번역되었습니다. 영어 원문을 보려면 여기를 클릭하십시오.

serialportfind

R2026b

직렬 포트 연결 찾기

R2024a 이후

페이지 내 모두 축소

구문

S = serialportfind
S = serialportfind(Name=Value)

설명

S = serialportfind는 기존에 지속되는 직렬 포트 연결을 찾아 각 연결에 해당하는 serialport 객체 배열을 반환합니다.

예제

S = serialportfind(Name=Value)는 하나 이상의 이름-값 인자로 지정된 속성 값과 일치하는 연결을 찾습니다. 예를 들어, S = serialportfind(Tag="Scope")는 Tag 속성이 "Scope"로 설정된 기존 직렬 연결을 반환합니다.

예제

예제

모두 축소

MATLAB® 작업 공간에 존재하거나 클래스 속성 또는 앱 속성으로 저장된 serialport 연결이 있는 경우 다른 함수 또는 앱 콜백에서 serialport 객체에 액세스하지 못할 수 있습니다. 이 경우 serialportfind를 사용하여 연결을 찾아 삭제할 수 있습니다. 

S = serialportfind
S = 

  Serialport with properties:

                 Port: "COM3"
             BaudRate: 9600
                  Tag: ""
    NumBytesAvailable: 0

이 연결을 닫으려면 S를 삭제합니다.

delete(S)

이 명령은 serialport 객체를 삭제하고 장치의 연결을 끊습니다. 장치에 다시 연결하려면 serialport를 사용하여 새 인터페이스를 생성해야 합니다.

삭제 후 serialportfind를 호출하여 기존 연결이 없음을 확인합니다.

serialportfind
ans =

     []

변수 S가 여전히 작업 공간에 존재하지만 이제는 유효하지 않은 핸들입니다. 

S
S = 

  handle to deleted Serialport

serialport는 핸들 객체이므로 인터페이스를 삭제한 후에도 변수가 유지됩니다. (이 유형의 객체에 대한 자세한 내용은 핸들 객체 동작 항목을 참조하십시오.) clear를 사용하여 작업 공간에서 유효하지 않은 핸들을 제거할 수 있습니다.

clear S

연결에 태그를 할당하고 나중에 해당 태그를 serialportfind와 함께 사용하여 연결에 액세스할 수 있습니다. 이러한 태그는 여러 함수에 걸쳐 추적해야 할 다중 시리얼 포트 연결이 있을 때 유용합니다. 태그는 앱 콜백에서 연결을 찾고 액세스하는 데도 유용합니다. 태그 값을 설정하려면 serialport의 Tag 속성을 사용하십시오.

두 개의 직렬 포트 연결을 생성하고, Tag 속성에 값을 할당합니다.

c1 = serialport("COM3",9600,Tag="Arduino");
c2 = serialport("COM5",14400,Tag="Power");

태그 "Arduino"로 연결된 항목을 찾습니다.

S = serialportfind(Tag="Arduino")
S = 

  Serialport with properties:

                 Port: "COM3"
             BaudRate: 9600
                  Tag: "Arduino"
    NumBytesAvailable: 0

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: serialportfind(Tag="Scope",BaudRate=14400)는 Tag 속성이 "Scope"로 설정되고 보드 레이트가 14400인 기존 직렬 연결을 반환합니다.

serialportfind의 경우, serialport 객체의 하나 이상의 속성을 이름-값 인자로 사용하여 찾고자 하는 연결의 특성을 지정할 수 있습니다.

출력 인수

모두 축소

직렬 포트 연결, serialport 객체 또는 serialport 객체 배열로 반환됨. 이름-값 인수 없이 serialportfind를 호출하면 S에는 모든 기존 연결이 포함됩니다. 그렇지 않으면 S에는 이름-값 인수로 지정한 값과 속성이 일치하는 모든 연결이 포함됩니다.

S는 다음의 경우 비어 있습니다:

  • 현재 시리얼 포트 연결이 없습니다.

  • 기존 연결이 지정된 속성 값과 일치하지 않습니다. 예를 들어, Tag="Scope"를 지정하고 Tag 속성이 "Scope"인 기존 연결이 없으면 S는 비어 있습니다.

  • serialport 객체가 가지고 있지 않은 속성을 매칭하려고 합니다. 예를 들어, serialportfind(Speed=14400)는 serialport에 Speed 속성이 없기 때문에 빈 배열을 반환합니다.

팁

  • serialportfind는 기존 serialport 연결을 찾습니다. 연결 여부와 상관없이 사용 가능한 모든 직렬 포트 목록을 얻으려면 serialportlist를 사용하십시오.

버전 내역

R2024a에 개발됨

참고 항목

|