アットマークテクノ社製 Armadillo 用
アナログ入力 4ch アドオンモジュール
MTAA-AI04-00
取扱説明書
この度は、MTT 製品をご採用いただき、誠に有難うございます。
現品をお受け取りになりましたら、まず、本機の仕様がご注文通りのものであることを、現品の表示ラベルの記載でご確認下さい。万一、仕様の誤りや、輸送上、その他の原因による損傷などが発見されました場合には、速やかに、当社営業所またはお買い求め先にご連絡下さいますようお願い申し上げます。
当社製品はすべて、厳格な品質管理基準に基づいて製造されておりますので、安心の上、お使いいただけるものと存じます。
1. はじめに本機を正しくお使いいただくために、この「取扱説明書」をよくお読みください。またご使用後は本書を必ず保管し、必要に応じて参照してください。製品仕様書も併せてご参照ください。
また、アットマークテクノ社の Armadillo の製品マニュアル、標準ガイド等も併せて参照してください。
2. 安全にご使用いただくために本機の使用にあたっては下記の安全注意事項を必ずお守りください。
以下の注意に反した使用により生じた障害については、当社は責任と保証を負いかねます。

！ 警告
！ 注意

この表示の記載内容を守らないと、火災・感電などにより人が死亡または重傷を負う可能性があります。
この表示の記載内容を守らないと、感電・その他の事故により人が障害を負ったり物的損害を招く可能性があります。

！ 警告■ 本機への配線は端子台に対して行い、配線・離線は必ず電源が供給されていないことを確認して行ってください。これを守らないと感電する恐れがあります。
■ 本機を分解、改造、及び本機のヒューズを交換しないでください。
これを守らないと、火災、感電のおそれがあります。
■ 万一、異物（金属片、水、液体）が本機の内部に入った場合や、基板表面に付着した場合は、すぐに電源供給を停止し、販売店または当社までご連絡ください。
■ 運送機器、通信機器、発電制御機器、医療機器など高度の信頼性・安全性が求められる用途で使用する場合は、組込まれるシステム装置全般として、誤動作防止設計などの安全設計を施す必要があります。
■ 可燃性ガスや粉塵のあるところでは使用しないでください。これを守らないと爆発のおそれがあります。
■ 設置した本機の付近、及び下方に燃えるものを置かないでください。

！ 注意■ 本機は仕様に記載された使用条件の範囲内で使用してください。
これを守らないと、火災や故障の原因となることがあります。
■ 温度変化が急激で結露するような場所での使用はお避けください。これを守らないと故障のおそれがあります。
■ 腐食性ガスのある場所や薬品が付着する場所での使用および保管は避けてください。
■ 本機の取り付けまたは取り外しは、危険防止のため、電源を遮断して行ってください。
■ 取り付けや結線等は、安全のため、制御盤組立技術者、計装工事、電気工事などの専門の技術を有する人が行ってください。
3. ご使用上の注意
本機の備えているすべての性能を満足させるために下記の注意事項をお守りください。下記の注意事項に反したご使用方法をされた場合、本機の性能が損なわれる可能性があります。
取扱について■ 精密機器のため、落としたり放り投げたりしないでください。
■ 電子部品を使用していますので、水をかけたり・水に浸けたり・結露する場所に設置しないでください。
■ 直射日光の当る場所や、高温、粉塵、湿気もしくは振動の多いところで保管及び設置は避けてください。
■ 静電気対策が施された環境下で取り扱ってください。
設置について■ 屋内に設置してください。
■ ｢9. 取り付け・取り外し｣を参照し、取り付けを行ってください。
■ 使用温度範囲：-20～70℃、高度：2000m 以下でご使用ください。
性能を満足させるために■ ノイズ等の影響を減らすため入出力配線を電源線と同一結束・同一ダクト内で使用することは避け、できるだけ離して配線（目安として 200mm 以上）してください。
■ 使用環境に応じて、シールド線を使用する等のノイズ対策を行ってください。
■ 本機の使用に先立って、約 30 分間のウォーミングアップを行ってください。
■ 本機に接続するセンサ、及び機器は本機の入出力インピーダンスを考慮したものをご使用ください。(製品仕様につきましては｢4.
概要｣、または仕様書を参照してください。仕様書は当社ホームページにてダウンロード可能です。
(URL：https://mtt.co.jp/)「Armadillo」は株式会社アットマークテクノの登録商標です。

https://mtt.co.jp

KRA0002588-H13-1 Rev.1.00

取扱説明書型式：MTAA-AI04-00

アットマークテクノ社製 Armadillo 用 アナログ入力 4ch アドオンモジュール

Armadillo 接続コネクタ（CN1）4. 概要
本機は、アットマークテクノ社製の Armadillo に対応したアドオンモジュールです。
入力する 4 点の直流電圧信号を AD 変換し、変換データを Armadillo に送信します。
アナログ入力回路は 4 点一括絶縁です。（チャネル間は非絶縁で、各 chｎ－端子は内部で接続された AGND 端子です。）
AD コンバータ（以降、ADC）に Texas Instruments 社製の ADS8684を使用しています。
5. 外形寸法6. 各部名称・信号割付

130CN16031TB187654321端子
番号

信号名

端子
番号

信号名

1

GND

31

EEPROM_E0

2

GND

32

NC

3NC

33

NC

4NC

34

NC

5NC

35

SPI_SCLK

6

NC

36

SPI_MISO

7

NC

37

SPI_MOSI

8

NC

38

NC

9

NC

39

NC

10

NC

40

NC

11

NC

41

NC

12

NC

42

NC

13

NC

43

ISO_EN

14

NC

44

NC

15

NC

45

NC

16

NC

46

NC

17

NC

47

NC

18

NC

48

NC

19

NC

49

NC

20

EEPROM_SCL

50

SPI_CS

21

EEPROM_SDA

51

NC

22

NC

52

NC

23

NC

53

NC

24

NC

54

GND

25

NC

55

NC

26

GND

56

NC

27

GND

57

NC

28+3.3V_IO

58

GND

29

NC

59

NC

30+5V

60

NC

7. 端子接続図
1 Ch1＋
入力12

端子
番号

信号名

ADC 対応ピン（ADS8684）

1ch1＋

AIN_0P

2ch1－（AGND）

AIN_0GND

3ch2＋

AIN_1P

4ch2－（AGND）

AIN_1GND

5ch3＋

AIN_2P

6ch3－（AGND）

AIN_2GND

7ch4＋

AIN_3P

8ch4－（AGND）

AIN_3GND

3 Ch2＋

アナログ 入 力 回 路

入力端子台（TB1）

Ch1－

入力2
4

Ch2－

5 Ch3＋入力3
6Ch3－

7 Ch4＋入力48

Ch4－AGND

2
KRA0002588-H13-1

Rev.1.00

取扱説明書型式：MTAA-AI04-00

アットマークテクノ社製 Armadillo 用 アナログ入力 4ch アドオンモジュール

8.1.3. armadillo_iotg_std_addon.c の編集「static struct addon_vendor_name vendor_names[]」の構造体の末尾に 1 行追加します。

8. ドライバの導入（対応カーネルイメージの作成）※ アットマークテクノ社の Armadillo の製品マニュアル、標準ガイドを併せて参照してください。

static struct addon_vendor_name vendor_names[] = {SPI ドライバ・ADS8684 のドライバを有効にした Linux カーネルと、DTB を作成します。標準状態のカーネルのソースコードを元に変更する手順は次の通りです。
1. Device Tree の編集
2. カーネルコンフィギュレーションの変更
3. カーネルと DTB をビルドし Armadillo に書き込み
また、事前にアットマークテクノ社より、Linux カーネルのソースコードと initramfs アーカイブを入手し、Linux カーネルのソースコードアーカイブの展開と initramfs アーカイブへのシンボリックリンク作成を行ってから以降の操作を行ってください。

（省略）
VENDOR_NAME(MTT, "mtt"), //追加行};「static struct addon_product_name product_names[]」の構造体の末尾に 1 行追加します。
static struct addon_product_name product_names[] = {（省略）
PRODUCT_NAME(MTT, AI04, "AI04"), //追加行};

8.1. Device Tree の編集「static int addon_setup(struct addon_device *adev)」の関数の「switch (vendor_id)」の case に「ADDON_VENDOR_ID_MTT」の場合を追加します。

MTAA-AI04-00 ドライバのファイル一式を入手し、コードに追加してください。ファイルは当社ホームページにてダウンロード可能です。(URL：https://mtt.co.jp/)
また、ファイルを適用するため、「armadillo_iotg_std_addon.h」と「armadillo_iotg_std_addon.c」に数行のコードを追加します。

static int addon_setup(struct addon_device *adev){（省略）
switch (vendor_id) {8.1.1. MTAA-AI04-00 ドライバのファイルの追加（省略）
case ADDON_VENDOR_ID_MTT: //追加行
switch (product_id) { //追加行
case ADDON_PRODUCT_ID_MTT_AI04: //追加行
ret = addon_setup_mtt_ai04(adev); //追加行
break; //追加行
default: //追加行
break; //追加行} //追加行
break; //追加行
default:break;}

MTAA-AI04-00 ドライバのファイル一式をカーネルのソースコードの下記にコピーします。
arch/arm/mach-imx/armadillo_iotg_addon
追加するファイルは以下の 4 点です。
ファイル名

内容

addon_mtt_ai04.c

初期化処理等

addon_mtt_ai04_iotg_g3_intf1.dts

G3 CON1 用 dts ファイルaddon_mtt_ai04_iotg_g3_intf2.dts

G3 CON2 用 dts ファイルaddon_mtt_ai04_x1_intf1.dts

X1 用 dts ファイル

8.1.2. armadillo_iotg_std_addon.h の編集（省略）

vendor ID に「#define ADDON_VENDOR_ID_MTT (0x0012)」の 1 行を追加します。

}

return ret;/* EEPROM vendor ID */（省略）#define ADDON_VENDOR_ID_MTT(0x0012) //追加行

product ID に「#define ADDON_PRODUCT_ID_MTT_AI04 (0x0001)」の 1 行を追加します。
/* EEPROM MTT product ID */ //追加行#define ADDON_PRODUCT_ID_MTT_AI04(0x0001) //追加行

ファイルの末尾の「#endif」の前に以下の 1 行を追加します。
int addon_setup_mtt_ai04(struct addon_device *adev) //追加行#endif3
KRA0002588-H13-1

Rev.1.00

取扱説明書型式：MTAA-AI04-00

アットマークテクノ社製 Armadillo 用 アナログ入力 4ch アドオンモジュール

9. 取り付け・取り外し※ 本機の取り付け・取り外しは必ず電源が供給されていないことを確認して行ってください。

8.2. カーネルコンフィギュレーションの変更
8.2.1. コンフィギュレーションの初期化
デフォルトのコンフィギュレーションを読み込みます。
[ATDE ~/[Linux_kernel]]$ make ARCH=arm x1_defconfig「[Linux_kernel]」は展開した Linux カーネルのソースコードのディレクトリに読み替えてください。

本機は、Armadillo-IoT ゲートウェイ G3 の CON1 及び CON2、Armadillo-X1 の CON7 に実装する事が可能です。
実装方法についてはアットマークテクノ社の Armadillo の製品マニュアルを参照して下さい。

8.2.2. SPI と ADS8688 のデバイスドライバ の有効化
menuconfig を使用してカーネルコンフィギュレーションを変更します。

10. 配線の方法※ 本機への配線・離線は必ず電源が供給されていないことを確認して行ってください。

※「[ATDE /]$」は ATDE 上の一般ユーザーで実行を意味し、[ATDE ~/[Linux_kernel]]$ make ARCH=arm menuconfig

下記の電線を使用してください。
適合電線

SPI と ADS8688 のデバイスドライバを有効にします。

単線

Device Drivers --->[*] SPI support ---> ← 有効にする[*] Freescale i.MX SPI controllers ← 有効にする[*] Industrial I/O support ---> ← 有効にする
Analog to digital converters --->[*] Texas Instruments ADS8688 ← 有効にする

撚線棒端子

A

アットマークテクノ社の Armadillo の製品マニュアルを参照し、カーネルをビルドし、生成したイメージファイルを Armadillo に書き込みしてください。
特定のイメージファイルだけを書き換える場合は、「Linux カーネルイメージの書き換え」と「DTB の書き換え」の両方を実施してください。
使用する DTB ファイルは以下の通りです。

Armadillo-X1

0.25 mm2 － 1.5 mm2

スリーブあり0.25 mm2 － 0.75 mm224-16

また、棒端子は下記の形状のものを使用してください。

8.3. カーネルと DTB をビルドし Armadillo に書き込み

Armadillo-IoT
ゲートウェイ G3

0.2 mm2 － 1.5 mm2

スリーブなしAWG※ADS8688 は ADS8684 のチャネル数違いで、デバイスドライバは
TI_ADS8688 の名称で共通のドライバが提供されています。

デバイス

0.2 mm2 － 1.5 mm2B

種類

A

最小1.1mm

最大1.6mm

B10.0mm

電線を直接接続する場合は、電線の先端から 10mm(±1mm)の被覆をむいてください。電線の先端を予備はんだしないでください。
正しい接続ができなくなります。
※棒端子を使用する場合は、使用する棒端子に合わせて電線加工を行ってください。

イメージファイル名

EC25-J 搭載品

armadillo_iotg_g3_m1.dtb

3G/LTE 非搭載品

armadillo_iotg_g3.dtb〈棒端子/単線を使用する場合〉■接続方法
端子接続穴に棒端子を突き当たるまで挿入してください。

armadillo_iotg_x1.dtb

解除穴
端子挿入穴

■取り外し方法
工具を解除穴に挿し棒端子を引き抜きます。
〈撚線を使用する場合〉■接続/取り外し方法
接続するときは工具を解除穴に挿し、電線を入れます。
取り外すときも工具を解除穴に挿し、電線を抜きます。
※工具を挿入する際は端子台に過度な力をかけないでください。
端子台破損の恐れがあります。
■推奨ドライバ
オムロン株式会社製 XW4Z-00B
フェニックス・コンタクト株式会社製SZS 0,4X2,5 VDE

4KRA0002588-H13-1

Rev.1.00

取扱説明書型式：MTAA-AI04-00

アットマークテクノ社製 Armadillo 用 アナログ入力 4ch アドオンモジュール

11. 入力値の取得方法※ アットマークテクノ社の Armadillo の製品マニュアル、標準ガイドを併せて参照してください。

参考

変換データフォーマット

/sys/bus/iio/devices/iio:device1/ディレクトリ以下のファイルから入力電圧を算出することができます。
※ IIO デバイスは、デバイスを認識した順番で iio:deviceN(N は'0'からの連番)となります。そのため本機を 2 台使用した場合などは、iio:deviceN が N=1 以外になる場合もあります。
IIO デバイスは、IIO デバイス名から特定することができます。
絶縁 IO アドオンモジュールに搭載している ADC の IIO デバイ
ス名は "ads8684"です。

(参考：0Vとの差)

入力値(32767)(32000)

65535
64768

(0)

32768

(-32000)

7680000

レンジ±10V±5V±2.5V

本モジュール ch.n の入力値から入力電圧（V）の取得は以下の式になります。
V = (in_voltageX_raw + in_voltageX_offset)×in_voltageX_scale×10-3※ X=n-1 (X=0～3:ADC の ch. ／ n=1～4:本モジュールの ch.)

入力値
65535
64000

/sys/bus/iio/devices/iio:device1/ディレクトリ以下にある、入力電圧の算出に必要なファイルを次に示します。
ファイルR/W

説明

in_voltage0_rawin_voltage1_raw
in_voltage2_raw
in_voltage3_raw

R

ADC 入力 ch.X の AD 変換値

in_voltage0_offset
in_voltage1_offset
in_voltage2_offset
in_voltage3_offset

R/W

ADC 入力 ch.X のオフセット※設定時は「in_voltage_offset_available」から選択

in_voltage0_scale
in_voltage1_scale
in_voltage2_scale
in_voltage3_scale

R/W

ADC 入力 ch.X の AD 変換値の単位電圧（mV）※設定時は「in_voltage_scale_available」から選択

in_voltage_offset_available

R

オフセットの選択肢

in_voltage_scale_available

R

スケールの選択肢

32000

レンジ
0～+10V0～+5V

入力電圧[V]

レンジ設定_offset_scale±10V DC-32768

0.312504320±5V DC-32768

0.156254208±2.5V DC-32768

0.078127104

0～+10V DC

00.156254208

0～+5V DC00.078127104

00052.5

10 10.24
5 5.12

入力[V]

レンジ別入力値±10V±5V±2.5V

0～+10V

0～+5V-10.2400000-10.00
768
0000-5.12
16384
0000-5.00
16768
768
000-2.5624576
16384
000-2.5024768
16768
768
000.00
32768
32768
32768
002.5040768
48768
64768
16000
32000
2.564096049152
65535
16384
32768
5.00
48768
64768
65535
32000
64000
5.12
49152
65535
65535
32768
65535
10.00
64768
65535
65535
64000
65535
10.24
65535
65535
65535
65535
65535
※色付きの条件は上下限値に張り付いています。
※入力断線時の動作は不定です。（+1V～+2V 相当値程度の不定値）各レンジに設定するための「in_voltageX_offset」と「in_voltageX_scale」の設定値を以下に示します。
入力レンジ-10.24 -10-5.12 -5-2.56 -2.5

入力
[V]
10 10.24
5 5.12
2.5 2.56

上記以外は設定不可です。
設定不可の状態を避けるため、他のレンジから「±10V DC」への変
更時は先に「in_voltageX_offset」を変更し、逆に「±10V DC」から他のレンジへ変更時は先に「in_voltageX_scale」を変更してください。

本モジュールが接続されて、ドライバのインストールが正常に行われているとき、Linux カーネルの起動ログに次のように出力されます。（表示されない場合は「8.ドライバの導入（対応カーネルイメージの作成）」や「9.取り付け・取り外し」を参照し、ドライバや取り付け状態を確認してください。）
armadillo_iotg_addon addon: mtt AI04 board detected at Add-On Module
I/F 1(Rev 0, SerialNumber=xxxx).

※本モジュール裏面の S/No.の表記と起動ログに表示される
SerialNumber は以下の関係となっています。
ラベル表記：MYYKXXXXX（M：製造月（1～9、X～Z（10～12）、YY：
製造年、K:区切り文字、XXXXX：連番）
起動ログ：0xMYYXXXXX の 16 進数の 10 進表記（M：製造月（1～C）
、YY：製造年（BCD 表記：0x22=2022 年）、XXXXX：連番（BCD 表記））

5
KRA0002588-H13-1

Rev.1.00

取扱説明書型式：MTAA-AI04-00

アットマークテクノ社製 Armadillo 用 アナログ入力 4ch アドオンモジュール

12. 保守点検
1 年に一度位の程度で特性や設定に異常がないか確認してください。
13. 保証期間と保証範囲〔保証期間〕
納入品の保証期間は、ご注文主のご指定場所に納入後 1 年といたします。
〔製品保証について〕
1) 製品の保証は、部品と構造上及び性能が当社の製品仕様に適合していることを、保証いたします。
2) 適切な品質マネジメントシステムと品質管理のもとで、製品を出荷しておりますが当社の製品保証は、製品の動作、出力や表示が中断されないことや、エラーが皆無であることを保証するものではありません。
当社の保証は、製品の動作、出力又は表示に中断やエラーが発生した場合の、お客様の機器、及び第三者の機器への傷害、パフォーマンス（お客様の機器などへの安全、性能など）に関連した傷害に対する保証や障害に対しては一切応じかねます。
3) 保証期間中、取扱説明書に順じ当社が不具合の認めた製品を保証期間中に手直し又は交換を致します。
4) 当社の保証は、以下に起因する不適合には適用されません。
① 不適切、不完全な保守、校正による場合② 故障の原因が納入品以外の事由による場合③ 当社以外の改造、または修理による場合④ その他、天災、災害などで当社の責にあらざる場合

6
KRA0002588-H13-1

Rev.1.00