fwrite (serial)
(제거될 예정임) 장치에 이진 데이터 쓰기
이 serial
객체 함수는 향후 릴리스에서 제거될 예정입니다. serialport
객체 함수를 대신 사용하십시오. 코드 업데이트에 대한 자세한 내용은 호환성 관련 고려 사항 항목을 참조하십시오.
구문
fwrite(obj,A)
fwrite(obj,A,'precision
')
fwrite(obj,A,'mode
')
fwrite(obj,A,'precision
','mode
')
설명
fwrite(obj,A)
는 직렬 포트 객체 obj
에 연결된 장치에 이진 데이터 A
를 씁니다.
fwrite(obj,A,'
은 precision
')precision
으로 지정된 정밀도로 이진 데이터를 씁니다.
precision
에 따라 각 값에 대한 비트 수가 정해지고, 비트를 정수, 부동소수점, 문자 값 중 어떤 값으로 해석해야 하는지가 결정됩니다. precision
이 지정되지 않은 경우 uchar
(8비트 부호 없는 문자)가 사용됩니다. precision
에 사용할 수 있는 값은 팁에 나와 있습니다.
fwrite(obj,A,'
는 mode
')mode
로 지정된 명령줄 액세스 방식으로 이진 데이터를 씁니다. mode
가 sync
이면 A
가 동기식으로 기록되고 명령줄이 차단됩니다. mode
가 async
이면 A
가 비동기식으로 기록되고 명령줄이 차단되지 않습니다. mode
가 지정되지 않으면 쓰기 작업이 동기화됩니다.
fwrite(obj,A,'
는 precision
','mode
')precision
으로 지정된 정밀도와 mode
로 지정된 명령줄 액세스 방식으로 이진 데이터를 씁니다.
팁
장치에 데이터를 쓰려면
함수를 사용하여 fopen
obj
에 장치가 연결되어 있어야 합니다. 연결된 직렬 포트 객체는 Status
속성값으로 open
을 갖습니다. obj
가 장치에 연결되어 있지 않은 상태에서 쓰기 작업을 수행하려고 하면 오류가 반환됩니다.
fwrite
가 실행될 때마다 쓰여진 값 개수만큼 ValuesSent
속성값이 증가합니다.
출력 버퍼가 기록되는 데이터를 모두 수용하지 못하면 오류가 발생합니다. OutputBufferSize
속성으로 출력 버퍼의 크기를 지정할 수 있습니다.
직렬 객체에서 FlowControl
속성을 hardware
로 설정할 경우 하드웨어 연결이 감지되지 않으면 fwrite
가 오류 메시지를 반환합니다. 이는 장치가 연결되어 있지 않거나, 연결된 장치가 데이터를 수신할 준비가 되었음을 어설션하지 않을 경우에 발생합니다. 원격 장치의 상태와 흐름 제어 설정을 확인하여 하드웨어 흐름 제어로 인해 MATLAB®에서 오류가 발생하는지 여부를 알아보십시오.
참고
장치가 데이터를 수신할 준비가 되었음을 어설션하고 있는지 확인하려면 FlowControl
을 none
으로 설정하십시오. 장치에 연결되면 PinStatus
구조체에서 ClearToSend
를 확인하십시오. ClearToSend
가 off
이면 원격 장치 쪽에 문제가 있는 것입니다. ClearToSend
가 on
이면 데이터 수신을 위해 준비된 하드웨어 FlowControl
장치가 있는 것으로, fwrite
를 실행할 수 있습니다.
동기 쓰기 작업과 비동기 쓰기 작업 비교
기본적으로 쓰기 작업을 하면 데이터는 장치에 동기적으로 기록되며, 작업이 완료될 때까지 명령줄이 차단됩니다. mode
입력 인수를 async
로 구성하여 비동기 쓰기를 수행할 수 있습니다. 비동기 쓰기의 특징은 다음과 같습니다.
출력 버퍼의 바이트 수가 반영되도록
BytesToOutput
속성값이 계속 업데이트됩니다.출력 버퍼가 비어 있으면
OutputEmptyFcn
속성에 지정된 콜백 함수가 실행됩니다.
TransferStatus
속성을 통해 비동기 쓰기 작업이 진행 중인지 여부를 확인할 수 있습니다.
fwrite를 사용한 쓰기 작업 완료 규칙
다음과 같은 경우 fwrite
를 사용한 이진 쓰기 작업이 완료됩니다.
지정된 데이터가 다 기록되었을 때
Timeout
속성으로 지정된 시간이 경과하면참고
이진 쓰기 작업에는
Terminator
속성이 사용되지 않습니다.
지원되는 정밀도
다음 표에는 precision
에 사용할 수 있는 값이 나와 있습니다.
데이터형 | 정밀도 | 해석 방식 |
---|---|---|
문자 |
| 8비트 부호 없는 문자 |
| 부호 있는 8비트 문자 | |
| 부호 있는 8비트 문자 또는 부호 없는 문자 | |
정수 |
| 8비트 정수 |
| 16비트 정수 | |
| 32비트 정수 | |
| 8비트 부호 없는 정수 | |
| 16비트 부호 없는 정수 | |
| 32비트 부호 없는 정수 | |
| 16비트 정수 | |
| 32비트 정수 | |
| 32비트 또는 64비트 정수 | |
| 16비트 부호 없는 정수 | |
| 32비트 부호 없는 정수 | |
| 32비트 또는 64비트 부호 없는 정수 | |
부동소수점 |
| 32비트 부동소수점 |
| 32비트 부동소수점 | |
| 32비트 부동소수점 | |
| 64비트 부동소수점 | |
| 64비트 부동소수점 |