입문

다음은 기계 트럭 회사의 라즈베리 파이용 고정밀 A/D 변환 모듈'ADPi Pro'의adpictl 명령을 어떻게 사용하는지 소개한다.adpictl 명령은 ADPi 작업을 수행하는 도구adpi-utils의 일부로 제공됩니다.

ADPi Pro에 대한 adpictl 명령 설정

adpictl 명령의 문법은 ADPi Pro에서 사용하는 SPI 장치와 IIO 서브시스템 두 인터페이스에 공통되어 있으며, 명령은 폴더'/usr/sbin/adpictl'에 설정되어 있습니다.설치는 SPI 디바이스, SPI를 사용하여 라즈베리 파이용 고정밀 A/D 변환 모듈 "ADPi Pro" 설정, IIO 서브시스템 및 IIO 서브시스템을 사용하여 딸기 파이용 고정밀 A/D 변환 모듈 "ADPi Pro" 설정 을 참조하십시오.

adpictl 명령 자습서

adpictl 명령은 ADPi의 샘플링 빈도와 이득 배율 등을 설정/표시하는 명령으로, 설정을 통해 폴더'/usr/sbin/adpictl'에 명령을 만듭니다.명령줄의 구문은 다음과 같습니다.

adpictl [OPTION] COMMAND ...
  COMMAND： サンプリング周波数等の表示および設定
  OPTION：  デバイス等の構成の設定

COMMAND에 지정할 수 있는 매개변수

COMMAND를 통해 미리 정해진 명령의 문법을 사용하여 설정된 샘플링 주파수 등의 표시, 샘플링 주파수 등의 재설정, 도움말 및 버전의 표시를 수행할 수 있습니다.

설정된 데이터 "get PARAMETER" 표시

다음 구문에 따라 지정된 PARAMETER를 사용하여 ADPi Pro 설정에 대한 다음 데이터가 표시됩니다.

adpictl get PARAMETER
  PARAMETER： サンプリング周波数「frequency」 
              ゲイン倍率「gain」 
              電源端子の出力状態「output」 
              分解能「scale」 
              温度「temperature」 
              測定した電圧「voltage」 

샘플링 주파수 "frequency"

설정된 샘플링 빈도를 Hz 단위로 표시합니다.

$ adpictl get frequency
470

이득 배율 "gain"

설정된 전압 범위에 대응하는 이득 배율을 표시합니다.

$ adpictl get gain
1

전원 단자의 출력 상태 "output"

대상 채널에 연결된 전원 단자의 출력 상태를 표시합니다.또한 표시되는 채널 번호를 매개 변수로 제공합니다.

$ adpictl get output 1
off
$ adpictl get output 2
off
$ adpictl get output 3
off
$ adpictl get output 4
off

해상도

설정된 전압 범위에 해당하는 해상도를 mV 단위로 표시합니다.

$ adpictl get scale
0.000596040

온도

ADC 내부의 온도를 표시합니다.단위는 ℃이다.

$ adpictl get temperature
30.073874834

전압 측정

연결 대상 CH에서 측정한 전압을 mV 단위로 표시합니다.또한 표시되는 채널 번호를 매개 변수로 제공합니다.

$ adpictl get voltage 1
311.746205160
$ adpictl get voltage 2
312.664702800
$ adpictl get voltage 3
312.180718320
$ adpictl get voltage 4
311.541763440

데이터 설정 "set PARAMETER..."

다음 구문에 따라 지정된 PARAMETER를 사용하여 ADPi Pro에서 다음 데이터를 설정합니다.

adpictl set PARAMETER ...
  PARAMETER： サンプリング周波数「frequency」 
              ゲイン倍率「gain」 
              電源端子の出力状態「output」 
              分解能「scale」 

샘플링 주파수 "frequency"

"Hz"단위로 샘플링 주파수를 설정합니다.설정할 수 있는 샘플링 주파수는 다음과 같다.

설정 가능한 샘플링 주파수: 470 242 123 62 50 39 33 19 17 16 12 10 8 6 4

$ adpictl set frequency 242
$ adpictl get frequency
242
$ adpictl set frequency 470
$ adpictl get frequency
470

이득 배율 "gain"

전압 범위에 대응하는 이득 배율을 설정하다.설정할 수 있는 이득 배율은 다음과 같다.

이득 배율 설정: 1 128 16 2 32 4 64 8

$ adpictl set gain 128
$ adpictl get gain
128
$ adpictl set gain 1
$ adpictl get gain
1

전원 단자의 출력 상태 "output"

대상 CH에 연결된 전원 단자의 출력 상태를 설정합니다.또한 설정된 채널 번호와 출력 상태를 매개 변수로 "on"또는 "off"를 부여합니다.

$ adpictl set output 1 on
$ adpictl get output 1
on
$ adpictl set output 1 off
$ adpictl get output 1
off
$ adpictl set output 2 on
$ adpictl get output 2
on
$ adpictl set output 2 off
$ adpictl get output 2
off
$ adpictl set output 3 on
$ adpictl get output 3
on
$ adpictl set output 3 off
$ adpictl get output 3
off
$ adpictl set output 4 on
$ adpictl get output 4
on
$ adpictl set output 4 off
$ adpictl get output 4
off

해상도

단위 "mV"로 전압 범위에 대응하는 해상도를 설정합니다.설정할 수 있는 해상도는 다음과 같다.

해상도 설정 가능: 0.000596040 0.000298020 0.000149010 0.000074500 0.000037250 0.000018620 0.000009310 0.000004650

$ adpictl set scale 0.000298020
$ adpictl get scale
0.000298020
$ adpictl set scale 0.000596040
$ adpictl get scale
0.000596040

도움말 표시 "help"

ADPi Pro에 대한 도움말을 표시합니다.

$ adpictl help

Usage: adpictl [OPTION] COMMAND ...|

Commands:
    get {frequency|gain|output <CH>|scale|temperature|voltage <CH>}
    set {frequency|gain|output <CH>|scale} <VALUE>
    help                        display help and exit
    version                     display version and exit

Options:
    --config, -c <FILE>         read config from FILE
    --spi, -s <DEVICE_NUMBER>   specify device number by SPI
    --iio, -i <DEVICE_NUMBER>   specify device number by IIO (When using IIO)

버전 뷰

ADPi Pro 버전을 표시합니다.

$ adpictl version
adpictl 2.0

OPTION에 지정할 수 있는 매개변수

-c, --config

지정된 FILE에서 설정을 읽습니다.다음 실행 예에서 defult의 설정 파일'/etc/adpi.conf'를 지정하고 채널 1과 연결된 아날로그 전압 값을 입력하십시오.또한 본 OPTION은 현재 adpi-utils 2.0으로 adpi-utils 1.0의 호환성을 유지하기 위해 설정된 OPTION입니다.

$ adpictl  -c /etc/adpi.conf get voltage 1
299.226384960

-s, --spi

DEVICE_NUMBER에 지정된 장치를 사용합니다.DEVICE_NUMBER는 연결된 SPI 버스의 CS 번호 "0"또는 "1"을 지정합니다.다음 예제에서 CS0을 지정하고 채널 2에 연결된 아날로그 전압 값을 입력합니다.

$ adpictl  -s 0 get voltage 2
283.789545000

다음 예제에서 CS1을 지정하고 채널 1에 연결된 아날로그 전압 값을 입력합니다.

$ adpictl  -s 1 get voltage 1
284.006503560

-i, --iio

DEVICE_NUMBER에 지정된 장치를 사용합니다.DEVICE_NUMBER 식별된 iio:device 번호를 지정합니다.또한 IIO 서브시스템의 인터페이스에서만 이 옵션을 지정할 수 있습니다.다음 실행 예에서 식별된 iio:device0을 지정하고 채널 1에 연결된 아날로그 전압 값을 입력하십시오.

$ adpictl  -i 0 get voltage 1
278.875195200

다음 예시에서 식별된 iio:device1을 지정하고 채널 2에 연결된 아날로그 전압 값을 입력하십시오.

$  adpictl  -i 1 get voltage 2
278.584327680

ADPi Pro 2개 사용 시 설정

ADPi Pro는 최대 1개의 Raspberry Pi에 2개까지 설치할 수 있습니다.ADPi Pro의 바느질 소켓'CN3'를 사용하여 Raspberry Pi에 쌓고 다른 ADPi Pro의 바느질 소켓'CN3'와 겹칩니다.

ADPi Pro의 하드웨어 설정

ADPi Pro 2장의 기판에 있는 다이얼 핀과 깊이 스위치의 각 설정에서 첫 번째 ADPi Pro는 구매할 때의 떨림, 두 번째 ADPi Pro는 다음과 같은 설정으로 설정된다.

JP2:CS1

JP3:GPIO25

DIPSW1: DIP1 ON, DIP2 OFF, DIP3 ON, DIP4OFF(EEPROM: 0x56, GPIO 확장기: 0x26)

ADPi 설정을 설명하는 파일 "/etc/adpi.conf" 변경

ADPi 설정을 설명하는 파일 "/etc/adpi.conf"는 "device"를 "device"로 설정합니다. 이 "device"는 spi0.1에 사용되는 장치 형식을 지정합니다. 기본적으로 빈 열입니다.

[spi0.0]
device=adpipro
eeprom=0x57
gpio=0x27

[spi0.1]
device=adpipro
eeprom=0x56
gpio=0x26

IIO 서브시스템에서 동작하도록 "/boot/config.txt"에 추가

두 개의 ADPi Pro를 IIO 서브시스템으로 실행하려면 장치를 CS0 및 CS1에 연결하는 데 사용되는 Device Tree Overlay 설정을 다음 형식으로 "/boot/config.txt"에 추가합니다.장치 트리 덮어쓰기 설정은 mechatrax/adpi-firmware 을 참조하십시오.

dtoverlay=adpipro-cs1
dtoverlay=adpipro-cs0

"/boot/config.txt"에 Device Tree Overlay 설정이 없으면 adpictl 명령을 실행할 때 다음과 같은 오류 메시지가 나타납니다.

$ adpictl  -i 1 get voltage 1
find: '/sys/bus/spi/devices//iio:device*': そのようなファイルやディレクトリはありません
Command failure

[참조] SPI의 CS1을 ADPi Pro 1장으로만 연결

SPI의 CS1에 ADPi Pro 하나만 연결하려면 파일 "/etc/adpi.conf"를 빈 칸으로 설정하여 [spi0.0]의 "device"에서 사용하는 장치가 존재하지 않음을 나타냅니다.

[spi0.0]
device=
eeprom=0x57
gpio=0x27

[spi0.1]
device=adpipro
eeprom=0x56
gpio=0x26

"device"에서 공백을 설정하지 않으면 다음과 같은 이상이 발생합니다.

TypeError: float() argument must be a string or a number, not 'NoneType'
Command failure

마지막

ADPi Pro에서 제공하는'adpictl 명령'은 SPI 장치와 IIO 서브시스템에서 통용되며 소프트웨어 개발 전 ADPi Pro의 동작 검사에 사용할 수 있으며 명령의 문법은 이해하기 쉽고 매개 변수가 적으며 사용이 편리하기 때문에 추천합니다.