주요 콘텐츠

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

DataAcquisition

데이터 수집 장치 인터페이스

설명

DataAcquisition 객체는 지정된 공급업체의 장치에 대한 액세스를 제공합니다.

생성

daq 함수를 사용하여 DataAcquisition 객체를 생성합니다.

속성

모두 확장

논리적 true 또는 false로 지정된 DSA 장치를 자동으로 동기화합니다. 이 속성을 사용하여 동일한 DataAcquisition에 있는 DSA(PXI 또는 PCI) 장치 간 자동 동기화를 활성화하거나 비활성화합니다. 기본적으로 자동 동기화 기능은 비활성화되어 있습니다.

예: true

데이터형: logical

읽기 전용 속성입니다.

장치 채널은 채널 객체의 배열로 반환됩니다. addinput, addoutput, addbidirectional 함수를 사용하여 채널을 만듭니다.

예: addinput(d,…)

읽기 전용 속성입니다.

장치 클록 연결은 클록 객체의 배열로 반환됩니다. addclock 함수를 사용하여 클록을 만듭니다.

예: addclock(d,…)

읽기 전용 속성입니다.

장치 디지털 트리거 연결은 DigitalTrigger 객체의 배열로 반환됩니다. addtigger 함수를 사용하여 DataAcquisition에 디지털 트리거를 추가합니다.

예: addtrigger(d,…)

디지털 트리거가 발생하는 데 허용되는 시간은 초 단위의 숫자 값이나 지속 시간으로 지정됩니다.

예: 30

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

오류가 발생할 때 호출할 콜백 함수로, 함수 핸들로 지정됩니다.

예: @mycleanup

데이터형: function_handle

true 또는 false(기본값)로 지정하여 TDMS 파일에 데이터를 기록할지 여부를 제어합니다.

예: dq.LogToDisk = true

데이터형: logical

TDMS 파일에 로깅하기 위한 쓰기 모드로, string형 또는 문자형 벡터로 지정됩니다. 지원되는 값은 다음과 같습니다.

  • "append" — 기존 파일에 데이터를 추가합니다. 기존 데이터는 보존되고, 기존 데이터 다음에 새 데이터가 새 채널 그룹에 추가됩니다.

  • "overwrite" — 기존 파일을 새 데이터로 덮어씁니다. 이전 데이터는 손실됩니다.

  • "new" — 새로운 파일을 만듭니다. 파일이 이미 존재하는 경우 오류가 발생합니다.

예: dq.LogFileMode = "overwrite"

데이터형: char | string

데이터를 기록할 TDMS 파일의 이름으로, string형 또는 문자형 벡터로 지정됩니다. 기본 파일 이름은 "recording_YYYYMMDD-HHMMSS.tdms" 형식입니다.

예: dq.LogFileName = "MyDataFile_2.tdms"

데이터형: char | string

읽기 전용 속성입니다.

실행 중에 남아 있는 디지털 트리거의 수는 double로 반환됩니다.

예: 1

데이터형: double

DataAcquisition 실행 당 디지털 트리거 수는 double로 반환됩니다.

예: 2

데이터형: double

읽기 전용 속성입니다.

마지막 start 이후 백그라운드 작업에서 수집된 데이터 스캔 수를 uint64 값으로 반환합니다. 이 값은 start가 호출될 때마다 재설정되며, 스캔이 MATLAB로 읽혔는지 여부를 반영하지 않습니다.

예: 1000

데이터형: uint64

읽기 전용 속성입니다.

읽을 수 있는 데이터 스캔 수를 uint64 값으로 반환합니다. 이러한 스캔은 백그라운드 작업에서 장치 입력 채널을 통해 수집되었지만 아직 MATLAB로 읽혀지지 않았습니다. 값은 read를 호출할 때마다 감소하고, start를 호출하면 재설정됩니다.

예: 1000

데이터형: uint64

읽기 전용 속성입니다.

장치 출력으로 생성된 스캔 수는 uint64 값으로 반환됩니다.

예: 1024

데이터형: uint64

읽기 전용 속성입니다.

장치 출력 채널에 대기 중인 스캔 수를 uint64 값으로 반환합니다.

예: 4000

데이터형: uint64

초당 샘플의 숫자 값으로 지정되는 데이터 스캔 속도입니다.

예: 44100

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

읽기 전용 속성입니다.

최소 및 최대 스캔 속도 제한은 초당 샘플 수로 허용되는 최소 및 최대 스캔 속도를 나타내는 1x2 벡터로 반환됩니다. 스캔 속도 제한은 하드웨어와 구성에 따라 달라집니다. 채널을 변환기로 다중화하는 장치에서는 속도 제한이 사용하는 채널 수의 영향을 받습니다. 자세한 내용은 Sampling 항목을 참조하십시오.

예: [8000 192000]

데이터형: double

읽기 전용 속성입니다.

DataAcquisition 실행 표시, true 또는 false로 반환됩니다.

예: true

데이터형: logical

입력 채널에서 스캔이 사용 가능할 때 실행할 콜백 함수(함수 핸들로 지정됨)

예: @read

데이터형: function_handle

ScansAvailableFcn를 트리거하기 위한 수집된 스캔 수를 숫자 값으로 지정합니다. ScansAvailableFcn에 지정된 함수 핸들은 입력 채널에서 ScansAvailableFcnCount 스캔이 수집될 때마다 실행됩니다. 기본값은 해당 DataAcquisition 객체의 비율의 1/10이고, 하한값은 1/20입니다.

예: 8000

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

장치 출력 채널에 스캔 데이터가 필요할 때 실행할 콜백 함수로, 함수 핸들로 지정됩니다.

예: @write

데이터형: function_handle

ScansRequiredFcn를 트리거하기 위한 대기 중인 스캔 수이며, 숫자 값이나 "auto"로 지정됩니다. ScansRequiredFcn에 지정된 함수 핸들은 NumScansQueued가 이 속성에 지정된 값보다 낮아지면 실행됩니다. 기본값은 해당 DataAcquisition 객체의 속도의 1/2이고, 하한값은 1/20입니다. 이 속성을 "auto"로 설정하면 기본값으로 재설정됩니다.

예: 2000

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

사용자 정의 데이터는 MATLAB® 데이터 유형 및 형식으로 지정됩니다.

예: datetime('now')

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | table | cell | function_handle | categorical | datetime | duration | calendarDuration | fi

읽기 전용 속성입니다.

데이터 수집 하드웨어 공급업체 정보는 다음 속성을 가진 공급업체 객체로 반환됩니다.

ID
FullName
AdaptorVersion
DriverVersion
IsOperational

이 객체는 daqvendorlist 함수가 반환하는 해당 공급업체 객체와 동일합니다.

읽기 전용 속성입니다.

디지털 트리거 대기 표시는 논리적으로 반환됩니다.

예: true

데이터형: logical

객체 함수

addinput장치 인터페이스에 입력 채널 추가
read하드웨어로 수집한 데이터 읽기
readwrite장치 채널 데이터를 동시에 읽고 쓰기
startDataAcquisition 백그라운드 작업 시작
stop백그라운드 작업 중지
removechannelRemove channel from device interface
flushDataAcquisition 입력 및 출력 버퍼 플러시
write하드웨어 채널에 출력 스캔 쓰기
preload장치 출력을 위한 대기열 스캔 데이터
addoutputAdd output channel to device interface
addbidirectionalAdd digital bidirectional channel to device interface
resetcountersReset hardware scan count for all counter inputs
addclockAdd clock connection to device interface
removeclockRemove clock from device interface
addtrigger장치 인터페이스에 트리거 연결 추가
removetriggerRemove trigger from device interface

예제

모두 축소

National Instruments™ 장치와의 인터페이스를 위해 DataAcquisition 객체를 생성하고 구성합니다.

d = daq("ni")
d.Rate = 20000;

버전 내역

R2020a에 개발됨

참고 항목

함수