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

aardvark

Total Phase Aardvark 어댑터 연결

R2023a 이후

설명

aardvark 객체는 Total Phase^® Aardvark I2C/SPI™ 호스트 어댑터에 대한 연결을 나타냅니다. Aardvark™ 컨트롤러에는 하나 이상의 I2C 주변 기기를 연결할 수 있습니다. Aardvark 컨트롤러에서 주변 기기를 구성하고 통신하려면 먼저 aardvark 객체를 생성한 다음 device 함수를 사용해야 합니다. 하나의 aardvark 객체로 여러 주변 기기에 연결할 수 있습니다. MATLAB^®의 aardvark 객체는 항상 I2C 컨트롤러 역할을 하며 주변 기기 역할로 사용될 수 없습니다.

참고

aardvark 인터페이스를 사용하려면 Instrument Control Toolbox™ Support Package for Total Phase Aardvark I2C/SPI Interface가 설치되어 있어야 합니다. 자세한 내용은 Install Instrument Control Toolbox Support Package for Total Phase Aardvark I2C/SPI Interface 항목을 참조하십시오.

생성

구문

controller = aardvark(serialNumber)

controller = aardvark(serialNumber,Name=Value)

controller = aardvark

설명

controller = aardvark(serialNumber)는 일련 번호 serialNumber로 지정된 Total Phase Aardvark I2C/SPI 호스트 어댑터에 대한 연결을 만듭니다. aardvarklist 함수를 호출하여 Aardvark 컨트롤러의 일련 번호를 찾을 수 있습니다.

입력 serialNumber는 SerialNumber 속성을 설정합니다.

controller = aardvark(serialNumber,Name=Value)는 Aardvark 컨트롤러 보드에 연결을 생성하고 하나 이상의 이름-값 인수를 사용하여 속성을 설정합니다. 여기서 Name은 속성 이름이고 Value는 해당 값입니다. Name1=Value1,...,NameN=ValueN과 같은 이름-값 인수를 사용하여 EnablePullupResistors 및 EnableTargetPower 속성을 설정합니다. 여기서 Name은 속성 이름이고 Value는 해당 값입니다. 이름-값 인수들은 다른 인수 뒤에 나와야 하지만 이들 인수의 순서는 중요하지 않습니다.

controller = aardvark는 인수가 없는 경우 마지막으로 성공적으로 연결된 Aardvark 컨트롤러 보드에 대한 연결을 생성하려고 시도합니다. 이전에 Aardvark 컨트롤러에 연결한 적이 없다면 이 구문을 사용하면 aardvarklist 출력에서 사용 가능한 첫 번째 컨트롤러에 대한 연결이 생성됩니다.

속성

Model — 컨트롤러 보드 모델

읽기 전용: Total Phase Aardvark (디폴트 값)

읽기 전용 속성입니다.

컨트롤러 보드 모델로, Total Phase Aardvark로 지정됩니다.

예: controller.Model는 모델 Total Phase Aardvark를 반환합니다.

데이터형: string

SerialNumber — Aardvark 컨트롤러 보드의 고유 식별자

읽기 전용: string형 스칼라

읽기 전용 속성입니다.

Total Phase Aardvark 컨트롤러 보드의 고유 숫자 식별자로, string형 스칼라로 지정됩니다. 이 속성은 객체 생성 시에만 설정할 수 있습니다.

예: controller.SerialNumber는 Aardvark 컨트롤러의 고유 식별자를 반환합니다.

데이터형: string

Tag — 연결 식별을 위한 레이블

"" (디폴트 값) | string

R2024a 이후

연결 식별을 위한 레이블로, string형으로 지정됩니다. Tag를 사용하여 연결에 레이블을 적용하면 나중에 aardvarkfind에 이 레이블을 사용하여 연결에 액세스할 수 있습니다. 이렇게 하면 한 함수에서 연결을 열고 다른 함수를 사용하여 이 연결에서 작업을 수행할 때 유용할 수 있습니다. 앱 콜백에서 연결을 찾아 액세스하는 데에도 유용합니다.

예: controller.Tag = "pSupply"

데이터형: string

AvailableDigitalPins — Aardvark 컨트롤러에서 사용 가능한 디지털 핀

읽기 전용: ["Pin1" "Pin3" "Pin5" "Pin7" "Pin8" "Pin9"] (디폴트 값) | string형 배열

읽기 전용 속성입니다.

Aardvark 컨트롤러에서 사용할 수 있는 디지털 핀으로, string형 배열로 지정됩니다. 이러한 핀을 사용하여 I2C 주변 기기를 컨트롤러에 연결합니다. 각 핀에 대한 설명은 Aardvark 설명서를 참조하십시오. configureDigitalPin, readDigitalPin, writeDigitalPin을 사용하여 이러한 핀을 구성하고 통신합니다.

예: controller.AvailableDigitalPins는 Aardvark 컨트롤러의 디지털 핀을 반환합니다.

데이터형: string

VoltageLevel — 핀의 전압 레벨

읽기 전용: 3.3 (디폴트 값)

읽기 전용 속성입니다.

볼트 단위의 핀의 전압 레벨로, 3.3으로 지정됩니다. 이것은 Aardvark 컨트롤러의 핀에서 가능한 유일한 전압 레벨입니다.

예: controller.VoltageLevel은 Aardvark 핀의 전압 레벨을 반환합니다.

데이터형: double

EnablePullupResistors — 내부 풀업 저항 활성화

true 또는 1 (디폴트 값) | false 또는 0

I2C 라인에 대한 내부 풀업 저항을 활성화하거나 비활성화하는 설정으로, 숫자 또는 논리 1(true) 또는 0(false)으로 지정됩니다. 각 I2C 라인(SCL 및 SDA)에는 2.2kΩ 저항이 있습니다. 이 기능을 활성화하면 3.3V까지 끌어올려져 약 1.5mA의 풀업 전류가 발생합니다.

예: controller.EnablePullupResistors = false는 내부 풀업 저항을 비활성화합니다.

데이터형: logical

EnableTargetPower — 타깃 전원 허용

false 또는 0 (디폴트 값) | true 또는 1

Aardvark 컨트롤러의 핀 4와 6에서 타깃 전원을 허용하는 설정으로, 숫자 또는 논리 1(참) 또는 0(거짓)으로 지정됩니다.

예: controller.EnableTargetPower = false는 핀 4와 6의 타깃 전원을 비활성화합니다.

데이터형: logical

DigitalPinModes — Aardvark 컨트롤러의 디지털 핀 모드

읽기 전용: 테이블

읽기 전용 속성입니다.

Aardvark 컨트롤러의 디지털 핀 모드로, 테이블로 지정됩니다. 표에는 Pin 및 Mode 열이 있습니다. Pin은 AvailableDigitalPins로 지정된 디지털 핀을 나열하고 Mode는 이러한 각 핀의 핀 모드를 input 또는 output으로 나열합니다.

aardvark 객체를 생성하면 모든 핀이 기본적으로 입력됩니다. configureDigitalPin을 사용하여 핀 모드를 변경합니다. readDigitalPin을 사용하여 입력 핀에서 논리 값을 읽고 writeDigitalPin을 사용하여 출력 핀으로 논리 레벨 값을 전송할 수 있습니다.

예: controller.DigitalPinModes는 Aardvark 컨트롤러의 디지털 핀의 핀 모드를 나타내는 테이블을 반환합니다.

데이터형: table

객체 함수

configureDigitalPin	Set digital pin mode on controller
readDigitalPin	Read logic level value of digital pin on controller
writeDigitalPin	Write logic level value to digital pin on controller
scanI2CBus	Scan for I2C peripheral devices connected to controller board

예제

Total Phase Aardvark I2C/SPI 호스트 어댑터에 연결

컴퓨터에서 Total Phase Aardvark I2C/SPI 호스트 어댑터 컨트롤러 보드를 찾아 연결합니다.

aardvarklist를 사용하면 컴퓨터에 연결된 모든 Total Phase Aardvark I2C/SPI 호스트 어댑터 컨트롤러 보드를 나열할 수 있습니다.

list = aardvarklist

list = 

  1×2 table

                 Model             SerialNumber
         ______________________    ____________

    1    "Total Phase Aardvark"    "2239143731" 

SerialNumber 값을 사용하여 Aardvark에 대한 연결을 만듭니다.

controller = aardvark(list.SerialNumber(1))

controller = 

  Aardvark with properties:

                   Model: "Total Phase Aardvark"
            SerialNumber: "2239143731"
    AvailableDigitalPins: ["Pin1"    "Pin3"    "Pin5"    "Pin7"    "Pin8"    "Pin9"]

이제 device 함수를 사용하여 Aardvark 컨트롤러의 모든 I2C 주변 기기에 연결할 수 있습니다.

Total Phase Aardvark I2C/SPI 호스트 어댑터에서 디지털 핀 모드 설정

Total Phase Aardvark I2C/SPI 호스트 어댑터에 연결하고 핀을 구성합니다.

일련 번호를 사용하여 Total Phase Aardvark에 연결합니다. 이 예에서, 컴퓨터에 연결된 Aardvark 컨트롤러 보드의 일련 번호는 2239143731입니다.

controller = aardvark("2239143731");

DigitalPinModes 속성을 사용하여 컨트롤러에서 사용 가능한 디지털 핀과 해당 핀 모드를 확인합니다.

controller.DigitalPinModes

ans =

  6×2 table

     Pin       Mode  
    ______    _______

    "Pin1"    "input"
    "Pin3"    "input"
    "Pin5"    "input"
    "Pin7"    "input"
    "Pin8"    "input"
    "Pin9"    "input"

핀 5를 출력으로 구성합니다.

configureDigitalPin(controller,"Pin5","output")

핀 5는 출력 핀이므로 이제 writeDigitalPin을 사용하여 논리 High 레벨로 보낼 수 있습니다.

Total Phase Aardvark I2C/SPI 호스트 어댑터에서 I2C 주변 기기 검색

Total Phase Aardvark I2C/SPI 호스트 어댑터에 연결하고 이에 연결된 I2C 주변 기기를 검색합니다.

일련 번호를 사용하여 Total Phase Aardvark에 연결합니다. 이 예에서, 컴퓨터에 연결된 Aardvark 컨트롤러 보드의 일련 번호는 2239143731입니다.

controller = aardvark("2239143731");

I2C 주변 기기가 컨트롤러에 물리적으로 연결되어 있는지 확인하십시오. 연결된 I2C 주변 기기를 스캔합니다. scanI2CBus 함수는 이러한 주변 기기의 I2C 주소 목록을 반환합니다.

i2cAddresses = scanI2CBus(controller)

i2cAddresses = 

  1×2 string array

    "0x38"    "0x50"

이 예제에서는 두 개의 주변 기기가 연결되어 있습니다. 이제 나열된 I2C 주소 중 하나와 함께 device 함수를 사용하여 이들에 대한 하나 이상의 연결을 생성할 수 있습니다. I2C 주소를 확인하려면 주변 기기의 데이터시트를 참조하십시오.

단일 Aardvark 컨트롤러 연결 끊기

스크립트나 MATLAB 명령줄에서 aardvark를 사용하면 결과적으로 MATLAB 작업 공간의 객체로 표현되는 Aardvark 컨트롤러에 연결됩니다.

a1 = aardvark("2239143731")

a1 = 

  Aardvark with properties:

                   Model: "Total Phase Aardvark"
            SerialNumber: "2239143731"
                     Tag: "" 
    AvailableDigitalPins: ["Pin1"    "Pin3"    "Pin5"    "Pin7"    "Pin8"    "Pin9"]

다른 변수에 동일한 연결에 대한 참조가 없는 경우 작업 공간 변수를 지워 컨트롤러와의 연결을 끊을 수 있습니다.

clear(a1)

aardvarkfind를 사용하여 연결이 닫혔는지 확인합니다.

aardvarkfind

ans =

     []

함수 또는 앱 콜백에서 Aardvark 컨트롤러 연결 끊기

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

A = aardvarkfind

A = 

  Aardvark with properties:

                   Model: "Total Phase Aardvark"
            SerialNumber: "2239143731"
                     Tag: ""
    AvailableDigitalPins: ["Pin1"    "Pin3"    "Pin5"    "Pin7"    "Pin8"    "Pin9"]

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

delete(A)

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

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

aardvarkfind

ans =

     []

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

A

A = 

  handle to deleted Aardvark

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

clear A

버전 내역

R2023a에 개발됨

R2024a: Tag 속성이 새로 추가됨

새 Tag 속성을 사용하여 연결에 레이블을 적용하면 나중에 aardvarkfind에 이 레이블을 사용하여 연결에 액세스할 수 있습니다.

참고 항목

aardvarklist | aardvarkfind | ni845x | scanI2CBus | device

도움말 항목

• Transition Your Code to aardvark or ni845x Interface