이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

serialport

직렬 포트 연결

설명

serialport 객체는 직렬 포트와 통신하기 위한 직렬 클라이언트를 나타냅니다. 객체를 생성한 후 점 표기법을 사용하여 속성을 설정합니다.

생성

구문

s = serialport(port,baudrate)

s = serialport(port,baudrate,Name,Value)

s = serialport

설명

s = serialport(port,baudrate)는 전송 속도가 baudrate인 port에 지정된 직렬 포트에 연결됩니다.

s = serialport(port,baudrate,Name,Value)는 직렬 포트에 연결하고 선택적 이름-값 쌍의 인수를 사용하여 추가 속성을 설정합니다.

s = serialport는 마지막으로 지운 serialport 객체 인스턴스의 속성 설정을 사용하여 인수 없이 직렬 포트에 연결합니다. 유지되는 속성은 Port, BaudRate, ByteOrder, FlowControl, StopBits, DataBits, Parity, Timeout, Terminator입니다. 속성 항목을 참조하십시오.

입력 인수

port — 직렬 포트 이름

string형 | 문자

직렬 포트 이름으로, string형이나 문자형 벡터로 지정됩니다. serialportlist를 사용하여 연결된 포트 목록을 가져옵니다.

예: "COM2"

baudrate — 전송 속도

double형

직렬 통신의 전송 속도로, double형으로 지정됩니다.

예: 9600

이름-값 쌍의 인수

선택적으로 Name,Value 인수가 쉼표로 구분되어 지정됩니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. Name은 따옴표 안에 표시해야 합니다. Name1,Value1,...,NameN,ValueN과 같이 여러 개의 이름-값 쌍의 인수를 어떤 순서로든 지정할 수 있습니다.

이름-값 쌍을 사용하여 DataBits, Parity, StopBits, FlowControl, ByteOrder, Timeout 객체 속성을 설정할 수 있습니다. 데이터형 및 허용되는 값은 속성 항목을 참조하십시오.

예: "Timeout",30

속성

Port — 연결할 직렬 포트

string형

이 속성은 읽기 전용입니다.

연결할 직렬 포트로, string형이나 문자형 벡터로 반환됩니다.

예: "COM1"

데이터형: string

BaudRate — 통신 속도

double형

초당 비트 수 단위로 지정된 통신 속도로, double형 양의 정수로 반환됩니다.

예: 14400

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Parity — 패리티

"none" (디폴트 값) | "even" | "odd"

데이터가 손실 또는 기록되었는지 확인하기 위한 패리티로, "none", "even" 또는 "odd"로 반환됩니다.

예: "odd"

데이터형: char | string

DataBits — 데이터의 한 문자를 표현하기 위한 비트 수

8 (디폴트 값) | 7 | 6 | 5

데이터의 한 문자를 표현하기 위해 사용되는 비트 수로, 8, 7, 6 또는 5로 반환됩니다.

예: 8

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

StopBits — 문자의 끝을 나타내는 비트 패턴

1 (디폴트 값) | 1.5 | 2

문자의 끝 또는 전체 전송의 끝을 나타내는 비트 패턴으로, 1, 1.5 또는 2로 반환됩니다.

예: 1

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

FlowControl — 데이터 전송 속도 관리 모드

"none" (디폴트 값) | "hardware" | "software"

데이터 전송 속도 관리 모드로, "none", "hardware" 또는 "software"로 반환됩니다.

예: "software"

데이터형: char | string

ByteOrder — 바이트의 순차적 순서

"little-endian" (디폴트 값) | "big-endian"

여러 바이트를 배열해 더 큰 숫자형 값을 만들 때의 순차적 순서로, "little-endian" 또는 "big-endian"으로 반환됩니다.

예: "little-endian"

데이터형: char | string

Timeout — 작업을 완료하는 데 허용된 시간

10 (디폴트 값) | 숫자형

읽기 및 쓰기 작업을 완료하는 데 허용된 시간(단위: 초)으로, 숫자형 값으로 반환됩니다.

예: 60

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

NumBytesAvailable — 읽을 수 있는 바이트 수

숫자형

이 속성은 읽기 전용입니다.

읽을 수 있는 바이트 수로, 숫자형 값으로 반환됩니다.

예: 1024

데이터형: double

NumBytesWritten — 직렬 포트에 기록된 바이트 수

0 (디폴트 값) | 숫자형

이 속성은 읽기 전용입니다.

직렬 포트에 기록된 바이트 수로, 숫자형 값으로 반환됩니다.

예: 512

데이터형: double

Terminator — 라인의 종결자 문자

"LF" (디폴트 값) | "CR" | "CR/LF"

라인 읽기 및 쓰기를 위한 종결자 문자로, "LF", "CR" 또는 "CR/LF"로 반환됩니다. configureTerminator (Instrument Control Toolbox) 함수를 사용하여 이 속성을 설정합니다.

예: "CR"

데이터형: char | string

BytesAvailableFcn — 가용 바이트 콜백 함수

함수 핸들

사용 가능한 바이트에 대한 콜백 함수로, 함수 핸들로 반환됩니다. 콜백은 특정 개수만큼의 바이트를 수신하거나 종결자를 수신하여 트리거됩니다. configureCallback (Instrument Control Toolbox) 함수를 사용하여 이 속성을 설정합니다.

예: @myFun

데이터형: function_handle

BytesAvailableFcnCount — 콜백을 트리거할 데이터 바이트 수

64 (디폴트 값) | 숫자형 값

콜백을 트리거할 데이터 바이트 수로, double형으로 반환됩니다. 이 값은 BytesAvailableFcnMode 속성이 "byte"인 경우에만 사용할 수 있습니다. configureCallback (Instrument Control Toolbox) 함수를 사용하여 이러한 속성을 설정합니다.

예: 128

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

BytesAvailableFcnMode — 가용 바이트 콜백 트리거 모드

"off" (디폴트 값) | "byte" | "terminator"

사용 가능한 바이트에 대한 콜백의 트리거 모드로, "off", "byte" 또는 "terminator"로 반환됩니다. 이 설정은 콜백이 꺼져 있는지, 바이트 개수에 의해 트리거되는지, 종결자에 의해 트리거되는지를 결정합니다. configureCallback (Instrument Control Toolbox) 함수를 사용하여 이 속성을 설정합니다.

예: "off"

데이터형: char | string

ErrorOccurredFcn — 오류에 의해 트리거되는 콜백 함수

함수 핸들

오류에 의해 트리거되는 콜백 함수로, 함수 핸들로 반환됩니다.

예: @myErrFun

데이터형: function_handle

UserData — 사용자 데이터의 범용 속성

모든 유형

사용자 데이터에 대한 범용 속성으로, 모든 유형으로 반환됩니다.

예: datetime()

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | table | cell | function_handle | categorical | datetime | duration | calendarDuration | fi
복소수 지원 여부: 예

객체 함수

read	Read data from serial port
readline	Read line of ASCII string data from serial port
write	Write data to serial port
writeline	Write line of ASCII data to serial port
flush	Clear serial port device buffers
configureTerminator	Set terminator for ASCII string communication with serial port
configureCallback	Set callback function and trigger condition for communication with serial port device
getpinstatus	Get serial pin status
setRTS	Set serial RTS pin
setDTR	Set serial DTR pin

예제

직렬 포트에서 데이터 읽어 들이기

COM3 직렬 포트에서 16개의 uint32 데이터 값을 읽습니다.

s = serialport("COM3",9600,"Timeout",5);
data = read(s,16,"uint32");

참고 항목

함수

• serialportlist

R2019b에 개발됨