View Categories

11.2 ハードウェアを制御する

11.2 ハードウェアを制御する #

ハードウェアを制御するには、amctrlコマンドを使用します。

11.2.1 ハードウェア制御コマンドの基本 #

ax30 ax11 ax21 ag10 ag20 ar10 ar20

amctrlコマンドの基本書式について説明します。

書式
amctrl COMMAND [--help]
設定項目
項目内容
COMMANDハードウェアを制御するためのコマンドを指定します。
※1を参照
--helpコマンドのあとに「--help」または「-h」を付けて実行すると、コマンドの詳細情報が表示されます。
例：
admin@amnimo:~$ amctrl di --help ⮠
※1
コマンド内容
information機器固有情報などのハードウェアの情報を表示します。
dip-switchDIPスイッチの状態を表示します。
push-switchPUSHスイッチの状態を表示します。
boot起動エリアを制御します。
ledLEDを制御します。
poePoEコントローラーを制御します。
usbUSBポートを制御します。
diデジタル入力を制御します。
doデジタル出力を制御します。
rebootリブート処理を実行します。
aiアナログ入力値を表示します。
ax30
センサー接続ゲートウェイのみ使用が可能です。
pcパルスカウント処理を実行します。
ax30
センサー接続ゲートウェイのみ使用が可能です。
versionamctrlコマンドのバージョン情報を表示します。
helpamctrlコマンドのヘルプを表示します。
note
この表で説明しているコマンドの情報が表示されます。
コマンド共通オプション

pc, ai 以外のコマンドには、以下の共通オプションが存在します。

オプション内容
-S、--syslog LOG_LEVELLOG_LEVELに、メッセージのコンソール出力レベルを指定します。
-V、--verbose LOG_LEVELLOG_LEVELに、メッセージのメッセージ出力レベルを指定します。
LOG_LEVELLOG_LEVELに、ログレベルを数値で指定します。
ここで指定したログレベル以下のログが表示されます。
デフォルトでは、「informational」が設定されています。
※2を参照
※2
設定内容
emergシステムが不安定な状態を示すログです。
alert即対処が必要なレベルのログです。
crit致命的なエラーを示すログです。
errエラーログです。
warning警告ログです。
infoインフォメーションログです。
debugデバッグレベルのログです。

11.2.2 ハードウェアの情報を表示する #

ax30 ax11 ax21 ag10 ag20 ar10 ar20

ハードウェアの情報を表示するには、amctrl informationコマンドを実行します。

書式
amctrl information
実行例

以下に、エッジゲートウェイでの実行例を示します。

admin@amnimo:~$ amctrl information ⮠
manufacturer 	amnimo
board 		AG10
series 		G
model 		AG10-010JP-10-512G
serial 		012345
revision 	0
date: 		2020-01-01T00:00:00Z
note機種が異なる場合、board、series、modelに、機種に固有の内容が表示されます。

11.2.3 DIPスイッチの状態を表示する #

ax30 ax11 ax21 ag10 ag20 ar10 ar20

DIPスイッチの状態を取得するには、amctrl dip-switchコマンドを実行します。

書式
amctrl dip-switch
出力フォーマット
DSW-1: DSW-STATUS
DSW-2: DSW-STATUS
DSW-3: DSW-STATUS
DSW-4: DSW-STATUS
出力項目
項目内容
DSW-STATUS各DIPスイッチの状態が表示されます。
※3を参照
※3
表示内容
ONON状態
OFFOFF状態
実行例

DIPスイッチの状態を取得するには、sudoコマンドを使用する必要があります。

admin@amnimo:~$ sudo amctrl dip-switch ⮠
DSW-1: OFF
DSW-2: ON
DSW-3: ON
DSW-4: ON
ax30image37
センサー接続ゲートウェイのDIPスイッチは1,2のみとなります。
※4を参照
※4
admin@amnimo:~$ sudo amctrl dip-switch ⮠
DSW-1: OFF
DSW-2: ON

11.2.4 PUSHスイッチの状態を表示する #

ax30 ax11 ax21 ag10 ag20 ar10 ar20

PUSHスイッチの状態を表示するには、push-switchコマンドを実行します。

書式
amctrl push-switch
出力フォーマット
PSW: PSW-STATUS
出力項目
項目内容
PSW -STATUSPUSHスイッチの状態が表示されます。
※5を参照
※5
表示内容
ONON状態
OFFOFF状態
実行例

PUSHスイッチの状態を表示するには、sudoコマンドを使用する必要があります。

admin@amnimo:~$ sudo amctrl push-switch ⮠
PSW: OFF

11.2.5 起動エリアを制御する #

ax30 ax11 ax21 ag10 ag20 ar10 ar20

起動エリアを制御するには、amctrl bootコマンドを実行します。

書式
amctrl boot
出力フォーマット
AREA: AREA_NO
出力項目
項目内容
AREA_NO起動エリアの番号が表示されます。
※6を参照
※6
表示内容
0エリア0
設定保存領域： /dev/mmcblk0boot0
rootfs： /dev/mmcblk0p1
userfs： /dev/mmcblk0p3
1エリア1
設定保存領域： /dev/mmcblk0boot1
rootfs： /dev/mmcblk0p2
userfs： /dev/mmcblk0p4
設定項目
項目内容
--set AREA_NO起動エリアを切り替えます。
※7を参照
※7
表示内容
AREA_NO起動エリア
実行例

起動エリアを制御するには、sudoコマンドを使用する必要があります。

admin@amnimo:~$ sudo amctrl boot –set 1⮠
admin@amnimo:~$ sudo amctrl boot ⮠
AREA: 1

11.2.6 LEDの点灯を制御する #

ax30 ax11 ax21 ag10 ag20 ar10 ar20

LEDの点灯を制御するには、amctrl ledコマンドにオプションを付けて実行します。

書式
amctrl led [--number <1-5>] 
	[--color <green | red>]
	[--trigger <none | timer >]
	[--brightness <off | on>]
	[--delay <125 | 500>]
	[-h]
設定項目
項目内容
--number制御対象のLEDの番号を、1～5の範囲で指定します。
warning
1と2はシステムに予約されているため、使用しないでください。
※8を参照
--color制御対象のLED色を指定します。
※9を参照
--triggerLED制御のトリガーを指定します。
※10を参照
--brightnessLEDの点灯制御をします。
※11を参照
--delayLEDの点滅制御の点灯周期を指定します。
※12を参照
※8
設定内容
1ANT
2MOB
3ST1
4ST2
5ST3
※9
設定内容
green緑
red赤
※10
設定内容
noneなし
timer--delayで指定した周期で点滅します。
※11
設定内容
on点灯
off消灯
※12
設定内容
125125ms周期
500500ms周期
noteオプションを省略すると、すべてのLEDの制御設定が表示されます。
実行例

LEDの点灯を制御するには、sudoコマンドを使用する必要があります。以下に、エッジゲートウェイでの実行例を示します。

admin@amnimo:~$ sudo amctrl led ⮠
LED-1: color=green,trigger=none,brightness=on,delay=125
LED-1: color=red,trigger=none,brightness=off,delay=125
LED-2: color=green,trigger=none,brightness=off,delay=125
LED-2: color=red,trigger=none,brightness=off,delay=125
LED-3: color=green,trigger=none,brightness=off,delay=125
LED-3: color=red,trigger=none,brightness=off,delay=125
LED-4: color=green,trigger=none,brightness=off,delay=125
LED-4: color=red,trigger=none,brightness=off,delay=125
LED-5: color=green,trigger=none,brightness=off,delay=125
LED-5: color=red,trigger=none,brightness=off,delay=125

11.2.7 PoEコントローラーを制御する #

ax30 ax11 ax21 ag10 ag20 ar20

PoEコントローラーを制御するには、amctrl poeコマンドにパラメーターを付けて実行します。

書式（エッジゲートウェイ、AIエッジゲートウェイ）
amctrl poe <power [-i <lan0-lan3>] [-p <on|off>] |
	 reset [-i <lan0-lan3>] [-d <0-3600> |
	 status |
	 shutdown [-p <on|off>] |
	 limitcurrent [-i <lan0-lan3>] [-L <110|204|374|592|645|754|920|auto>] >
書式（屋外版IoTルーター）
amctrl poe <power [-i <eth0-eth1>] [-p <on|off>] |
	 reset [-i <eth0-eth1>] [-d <0-3600> |
	 status |
	 shutdown [-p <on|off>] |
	 limitcurrent [-i <eth0-eth1>] [-L <110|204|374|592|645|754|920|auto>] >
書式（センサー接続ゲートウェイ）
amctrl poe <power [-i lan1] [-p <on|off>] |
	 reset [-i lan1] [-d <0-3600> |
	 status |
	 shutdown [-p <on|off>] |
	 limitcurrent [-i <lan1>] [-L <110|188|375|500|625|650|920|auto>] >
設定項目
項目内容
power※13を参照
reset各PoEポートをリセットします。
※14を参照
statusPoEの制御状態を取得します。
shutdownPoEコントローラーをシャットダウンします。
※15を参照
limitcurrent※16を参照
※13

各PoEポートへの給電を制御します。

設定内容
-iPoEのインターフェイスを指定します。
-p電力のON／OFFを指定します。

PoEのインターフェイスは機種ごとに設定できる値の範囲が異なります。

機種インターフェイス
ax11ax21ag10ag20lan0, lan1, lan2, lan3
ar20eth0, eth1
ax30lan1
※14
設定内容
-iPoEのインターフェイスを指定します。指定範囲はpowerのインターフェイスと同じです。
-d起動ディレイ時間（秒）を、0～3600の範囲で指定します。
※15
設定内容
-pシャットダウンのON／OFFを指定します。
・ on
シャットダウン出力を有効化します（PoEデバイスが動作）。
・ off
シャットダウン出力を無効化します（PoEデバイスが停止）。
※16
設定内容
-iPoEのインターフェイスを指定します。指定範囲はpowerのインターフェイスと同じです。
-LPoEポートへの給電時の電流制限値を変更します。

電流制限値は機種ごとに設定できる値の範囲が異なります。

機種値説明
ax21
ax11
ag20
ag10
ar20		110電流制限値110mA（PoEPlus無効）
同上204電流制限値204mA（PoEPlus無効）
同上374電流制限値374mA（PoEPlus無効）
同上592電流制限値592mA（PoEPlus有効）
同上645電流制限値645mA（PoEPlus有効）
同上754電流制限値754mA（PoEPlus有効）
同上920電流制限値920mA（PoEPlus有効）
同上auto自動設定モード
ax30110電流制限値110mA（PoEPlus無効）
同上188電流制限値188mA（PoEPlus無効）
同上375電流制限値375mA（PoEPlus無効）
同上500電流制限値500mA（PoEPlus有効）
同上625電流制限値625mA（PoEPlus有効）
同上650電流制限値650mA（PoEPlus有効）
同上920電流制限値920mA（PoEPlus有効）
同上auto自動設定モード

note
各 PoE ポートへの給電時の電流制限値を変更する際に、limitcurrent 実行時にポートの電源供給が一旦停止します。

実行例

PoEコントローラーを制御するには、sudoコマンドを使用する必要があります。以下はlan0,lan2にClass1の受電機器(PD)を接続した例です。

admin@amnimo:~$ sudo amctrl poe status
state           0:1,1:0,2:1,3:0
class           0:Class1,1:Unknown,2:Class1,3:Unknown
poeplus         0:0,1:0,2:0,3:0
limit-current   0:204mA,1:592mA,2:754mA,3:920mA
Voltage         0:53.293V,1:0.000V,2:53.432V,3:0.000V
Current         0:43.765mA,1:0.000mA,2:45.169mA,3:0.000mA
Watt            0:2.332W,1:0.000W,2:2.413W,3:0.000W
Temperature     52.8deg

11.2.8 USBポートを制御する #

ax30 ax11 ax21 ag10 ag20

USBポートを制御するには、amctrl usbコマンドを実行します。

書式
amctrl usb [<-b|--bus> <1-2>] [<-w|--wait> <1s-3600s|<1m-60m>] USB-CTRL
設定項目
項目内容
-b
--bus		USBのバス番号を指定します。
範囲は1または2です。
-w
--wait		リセット制御時のOFF時間を指定します。
デフォルトは10秒です。
秒指定（s）の場合： 1秒から3600秒
時間指定（m）の場合： 1分から60分
USB-CTRLUSBポート制御を指定します。
※17を参照
※17
設定内容
onUSBポートをONにします。
offUSBポートをOFFにします。
resetUSBポートをリセットします。
実行例

USBポートを制御するには、sudoコマンドを使用する必要があります。

admin@amnimo:~$ sudo amctrl usb -–bus 1 -–wait 10m reset ⮠

11.2.9 デジタル入力を制御する #

ax30 ax11 ax21 ag10 ag20

デジタル入力を制御するには、amctrl diコマンドを実行します。

書式
amctrl di [-p] [-h]
設定項目
項目内容
-p、--permanentデジタル入力変化を継続的に出力するモードになります。
出力フォーマット（エッジゲートウェイ、AIエッジゲートウェイ）
DI-1: DI-STATUS
DI-2: DI-STATUS
DI-3: DI-STATUS
DI-4: DI-STATUS
出力フォーマット（センサー接続ゲートウェイ）
DI-0: DI-STATUS
DI-1: DI-STATUS
DI-2: DI-STATUS
DI-3: DI-STATUS
出力項目
項目内容
DI-STATUSデジタル入力の状態が表示されます。
※18を参照
※18
表示内容
ONON状態
OFFOFF状態
noteオプションを省略すると、すべてのデジタル入力の状態が表示されます。
実行例

デジタル入力を制御するには、sudoコマンドを使用する必要があります。

admin@amnimo:~$ sudo amctrl di ⮠
DI-1: OFF
DI-2: OFF
DI-3: OFF
DI-4: OFF

11.2.10 デジタル出力を制御する #

ax30 ax11 ax21 ag10 ag20

デジタル出力を制御するには、amctrl doコマンドを実行します。

書式
amctrl do [--set HEX]
	[--set-bit HEX]
	[--clr-bit HEX]
	[--on <1|2>]
	[--off <1|2>]
	-h
設定項目
項目内容
--set16進数値で、デジタル出力の複数ビットを同時に制御します。
※19を参照
--set-bit複数ビットを指定して、デジタル出力をON制御します。
1を指定すると、DO-1のデジタル出力をON制御します。
2を指定すると、DO-2のデジタル出力をON制御します。
3を指定すると、DO-1とDO-2のデジタル出力をON制御します。
--clr-bit複数ビットを指定して、デジタル出力をOFF制御します。
1を指定すると、DO-1のデジタル出力をOFF制御します。
2を指定すると、DO-2のデジタル出力をOFF制御します。
3を指定すると、DO-1とDO-2のデジタル出力をOFF制御します。
--onデジタル出力番号（1または2）を指定して、デジタル出力をON制御します。
--offデジタル出力番号（1または2）を指定して、デジタル出力をOFF制御します。
※19
設定内容
1ON
0OFF
出力フォーマット（エッジゲートウェイ、AIエッジゲートウェイ）
DO-1: DO-STATUS
DO-2: DO-STATUS
出力フォーマット（センサー接続ゲートウェイ）
DO-0: DO-STATUS
出力項目
項目内容
DO-STATUSデジタル出力の状態が表示されます。
※20を参照
※20
表示内容
ONON状態
OFFOFF状態
noteオプションを省略すると、すべてのデジタル出力の状態が表示されます。
実行例

デジタル出力を制御するには、sudoコマンドを使用する必要があります。

admin@amnimo:~$ sudo amctrl do --set 0x03 ⮠
admin@amnimo:~$ sudo amctrl do ⮠
DO-1: ON
DO-2: ON
admin@amnimo:~$ sudo amctrl do --set 0x0 ⮠
admin@amnimo:~$ sudo amctrl do ⮠
DO-1: OFF
DO-2: OFF
admin@amnimo:~$ sudo amctrl do --set-bit 1 ⮠
admin@amnimo:~$ sudo amctrl do ⮠
DO-1: ON
DO-2: OFF
admin@amnimo:~$ sudo amctrl do --set-bit 2 ⮠
admin@amnimo:~$ sudo amctrl do ⮠
DO-1: ON
DO-2: ON
admin@amnimo:~$ sudo amctrl do --clr-bit 1 ⮠
admin@amnimo:~$ sudo amctrl do ⮠
DO-1: OFF
DO-2: ON
admin@amnimo:~$ sudo amctrl do --on 1 ⮠
admin@amnimo:~$ sudo amctrl do ⮠
DO-1: ON
DO-2: ON
admin@amnimo:~$ sudo amctrl do --off 2 ⮠
admin@amnimo:~$ sudo amctrl do ⮠
DO-1: ON
DO-2: OFF

11.2.11 リブート処理を制御する #

ax30 ax11 ax21 ag10 ag20

リブート処理を制御するには、amctrl rebootコマンドを実行します。

書式
amctrl reboot -t <soft | hard> [--wait SEC] [-h]
設定項目
項目内容
-t再起動タイプを指定します。
※21を参照
--waitリセットまでの待ち時間（秒）を指定します。デフォルトでは、「3(秒)」が設定されています。
※22を参照
※21
設定内容
softソフトウェアリブートを実行します。
デフォルト値として設定されています。
hardハードウェアリブートを実行します。
ハードウェア全体の電源をOFFからONにします。
※22
設定内容
soft0秒から3600秒
hard3秒から3600秒
実行例

リブート処理を制御するには、sudoコマンドを使用する必要があります。

admin@amnimo:~$ sudo amctrl reboot ⮠

11.2.12 コマンドのバージョンを表示する #

ax30 ax11 ax21 ag10 ag20

amctrlコマンドのバージョンを表示するには、amctrl versionを実行します。

実行例
admin@amnimo:~$ amctrl version ⮠
amnimo Inc.
amnimo G series control program version 1.0.0

11.2.13 アナログ入力値を表示する #

ax30

amctrlコマンドでアナログ入力値を表示するには、amctrl aiを実行します。アナログ値は1秒に複数取得し、本コマンドではその平均値を表示します。

書式
amctrl ai [-T <ch0_thresh_high>,<ch1_thresh_high>] [-t <ch0_thresh_low>,<ch1_thresh_low>] [-{0,1}] [-s <multiple_of_sampling_period>] [-v]
設定項目
項目内容
-T
--thresh-high		上限しきい値を小数点の数値で指定します。しきい値を超えた場合はその旨を表示します。デフォルト値は「40000」です。本設定は、全チャネルで共通の設定になります。
-T <ch0_thresh_high>,<ch1_thresh_high>
※23を参照
-t
--thresh-low		下限しきい値を小数点の数値で指定します。しきい値を超えた場合はその旨を表示します。デフォルト値は「10」です。本設定は、全チャネルで共通の設定になります。
-t <ch0_thresh_low>,<ch1_thresh_low>
※24を参照
-0
--channel-0		アナログ値を取得するチャネルをチャネル0のみ指定します。デフォルト（未指定）では0,1両方のチャネルを表示します。
-1
--channel-1		アナログ値を取得するチャネルをチャネル1のみ指定します。デフォルト（未指定）では0,1両方のチャネルを表示します。
-s
--sampling-period		アナログ値を表示する周期（秒）を指定します。デフォルト値は「1」(秒)です。
-s <multiple_of_sampling_period>
※25を参照
-v
--print-elapsed-time		アナログ値とともに経過時間を表示。デフォルトは無効。
※23
設定内容
ch0_thresh_highチャネル0の上限しきい値
ch1_thresh_highチャネル1の上限しきい値
※24
設定内容
ch0_thresh_lowチャネル0の下限しきい値
ch1_thresh_lowチャネル1の下限しきい値
※25
設定内容
multiple_of_sampling_periodアナログ値を表示する周期（秒）
実行例

チャネル0の上限値、下限値をそれぞれ1376、1372とし、チャネル1の上限値、下限値をそれぞれ4854、4851とし、5秒間隔でアナログ値を表示し、経過時間も表示します。

admin@amnimo:~$ amctrl ai -T 1376,4854 -t 1372,4851 -s 5 -v ⮠
An undershoot occurred on channel 0, count:5
An overshoot occurred on channel 1, count:11
[5.196934] 1371.921875,4854.171875,
An undershoot occurred on channel 0, count:3
An overshoot occurred on channel 1, count:13
[10.296342] 1371.953125,4854.203125,

11.2.14 パルスカウントを表示する #

ax30

amctrlコマンドでパルスカウントを表示するには、amctrl pcを実行します。アナログ値は1秒に複数取得し、本コマンドではその平均値を表示します。

書式
amctrl pc < enable -p <pin0|pin1|pin2|pin3|all> [-d DEBOUNCE_TIME | -m <high|low> ] > | disable -p <pin0|pin1|pin2|pin3|all> | get [-i COUNT_TIME] | -h >
設定項目
項目内容
enableパルスカウントを行うピンの有効化および設定値を指定します。デフォルトではすべてのピンのパルスカウントは無効になっています。
warning
パルスカウントを有効化しているピンは、デジタル入力として使用できません。パルスカウントを無効化すると、デジタル入力として再度使用可能になります。すべてのピンを有効化した場合、show din [permanent] を実行してもデジタル入力の状態は何も表示されません。
※26を参照
disableパルスカウントを行うピンの無効化します。
※27を参照
getカウント値を表示します。
※28を参照
※26
設定内容
-p
--pin		有効化するピンを指定します。ピンを個別指定する場合は、pin0,pin1,pin2,pin3、すべてのピンを指定する場合はallを指定します。
note
必須設定です。
-d
--debounce		デバウンス時間（マイクロ秒）を指定。デフォルト値は「200」です。
-m
--mode		カウントモードを指定。high,lowを指定できます。デフォルト値は「high」です。
※27
設定内容
-p
--pin		無効化するピンを指定します。ピンを個別指定する場合は、pin0,pin1,pin2,pin3、すべてのピンを指定する場合はallを指定します。
note
必須設定です。
※28
設定内容
-i
--interval		カウント表示周期（秒）を指定します。デフォルト値は「1」です。
実行例

全ピンを有効化、debounceは200usec、High状態が連続した際にカウントアップするパルスカウント設定を設定し、5秒間隔で全ピンのカウント値を取得する。その後、カウントアップを停止するパルスカウント設定を実施する。

admin@amnimo:~$ amctrl pc enable --debounce=200 --mode=high --pin all ⮠
admin@amnimo:~$ amctrl pc get –-interval 5
0:0
1:0
2:1
3:0
0:0
1:1
2:1
3:0
admin@amnimo:~$ amctrl pc disable –-pin all
What are your Feelings
上部へスクロール