====== ILOGICS内蔵コマンド説明書 ======

ILOGICSボードではILOGICSが開発した内蔵コマンドを使用できます。別途ライブラリをインストールせず、ILOGICSボードを選択するだけで使用できます。

===== 内蔵コマンドの使い方 =====

  - [[https://www.ilogics.net/ko-kr/resources/downloads/software/3|ILOGICSボードパッケージ]]をインストールします。（Arduino SDK）
  - Arduino IDEの**ツール → ボード**で使用するボードを選択します。
  - 内蔵コマンドを使用します。

===== 内蔵コマンド一覧 =====

例に記載された入出力アドレスは製品によって異なります。使用するILOGICS製品のボード定義を選択し、その製品のピンマップでアドレスを確認してください。

**カテゴリ別に探す**

  * [[:ja-jp_commands:digital_filter|デジタル入力フィルタ]] · [[:ja-jp_commands:edge_scale|エッジ検出・範囲変換]] · [[:ja-jp_commands:plc_timer|PLCタイマ]] · [[:ja-jp_commands:callback_timer|コールバックタイマ]]
  * [[:ja-jp_commands:counter_buffer|カウンタ・データバッファ]] · [[:ja-jp_commands:high_speed_counter|高速カウンタ]] · [[:ja-jp_commands:analog_input|アナログ入力]] · [[:ja-jp_commands:temperature|温度入力]]
  * [[:ja-jp_commands:analog_output_pwm|アナログ出力・PWM]] · [[:ja-jp_commands:pid|PID制御]] · [[:ja-jp_commands:display_rtc|表示器・RTC]]
  * [[:ja-jp_commands:debug_watchdog|デバッグ・Watchdog]] · [[:ja-jp_commands:communication|通信]]

^ カテゴリ ^ コマンド ^ 説明 ^
| デジタル入力フィルタ | [[:ja-jp_commands:reference:idigitalread|IdigitalRead()]] | 入力を複数回連続で読み、すべての値が同じ場合だけ状態を更新します。HIGHとLOWが混在すると、前の安定状態を維持します。 |
| ::: | [[:ja-jp_commands:ibounce|Ibounce()]] | 入力のON・OFF両方向にチャタリング除去時間を適用します。 |
| ::: | [[:ja-jp_commands:reference:ibounceon|IbounceOn()]] | 入力がOFFからONに変わるときだけ時間フィルタを適用します。 |
| ::: | [[:ja-jp_commands:reference:ibounceoff|IbounceOff()]] | 入力がONからOFFに変わるときだけ時間フィルタを適用します。 |
| エッジ検出 | [[:ja-jp_commands:reference:iup|Iup()]] | 入力がOFFからONに変わる瞬間だけ''true''を返します。 |
| ::: | [[:ja-jp_commands:reference:idown|Idown()]] | 入力がONからOFFに変わる瞬間だけ''true''を返します。 |
| 状態反転 | [[:ja-jp_commands:reference:ialt|Ialt()]] | 入力の立ち上がりごとに指定した状態をON・OFF反転します。 |
| 範囲変換 | [[:ja-jp_commands:reference:iscale|Iscale()]] | 整数入力値を指定した整数範囲に変換します。 |
| ::: | [[:ja-jp_commands:reference:iscalef|Iscalef()]] | 実数入力値を指定した実数範囲に変換します。 |
| タイマ | [[:ja-jp_commands:reference:iton|Iton()]] | (On Delay Timer) 条件が一定時間ONになって初めて''true''を返します。 |
| ::: | [[:ja-jp_commands:reference:itof|Itof()]] | (Off Delay Timer) 条件がOFFになってから一定時間が経過すると''false''を返します。 |
| ::: | [[:ja-jp_commands:reference:itpl|Itpl()]] | (Pulse Timer) 条件がONになった瞬間から設定時間の間''true''を返します。 |
| ::: | [[:ja-jp_commands:reference:itmon|Itmon()]] | （Monostable Timer）動作中に再入力されても時間が延長されないパルスを出力します。 |
| ::: | [[:ja-jp_commands:reference:itmr|Itmr()]] | （Retentive Timer）条件がONの時間を積算し、Reset入力で初期化します。 |
| タイマ状態 | [[:ja-jp_commands:reference:igettime|IgetTime()]] | 指定したタイマの現在の経過時間を返します。 |
| ::: | [[:ja-jp_commands:reference:igetstate|IgetState()]] | 指定したタイマの現在の出力状態を返します。 |
| コールバックタイマ | [[:ja-jp_commands:reference:itimerset|ItimerSet()]] | 周期とコールバック関数、または使用するハードウェアタイマを設定します。 |
| ::: | [[:ja-jp_commands:reference:itimerstart|ItimerStart()]] | 設定したコールバックタイマを開始します。 |
| ::: | [[:ja-jp_commands:reference:itimerstop|ItimerStop()]] | 既定または指定したコールバックタイマを停止します。 |
| ::: | [[:ja-jp_commands:reference:itimerstopall|ItimerStopAll()]] | 実行中のコールバックタイマをすべて停止します。 |
| ::: | [[:ja-jp_commands:reference:itimerstate|ItimerState()]] | 既定または指定したコールバックタイマの実行状態を返します。 |
| カウンタ | [[:ja-jp_commands:reference:ictu|Ictu()]] | 入力の立ち上がり回数を数え、設定値に達すると''true''を返します。 |
| ::: | [[:ja-jp_commands:reference:ictd|Ictd()]] | 設定値を読み込んだ後、入力の立ち上がりごとに現在値を減らします。 |
| ::: | [[:ja-jp_commands:reference:ictud|Ictud()]] | 増加入力と減少入力を1つのカウンタで処理します。 |
| ::: | [[:ja-jp_commands:reference:igetcount|IgetCount()]] | 指定したカウンタの現在値を返します。 |
| ::: | [[:ja-jp_commands:reference:isetcount|IsetCount()]] | 指定したカウンタの現在値を変更します。 |
| ::: | [[:ja-jp_commands:reference:ictuddownstate|IctudDownState()]] | Up/Downカウンタの下限完了状態を返します。 |
| データバッファ | [[:ja-jp_commands:reference:fifo|FIFO()]] | 先に保存した16ビットデータから順に出力します。 |
| ::: | [[:ja-jp_commands:reference:filo|FILO()]] | 後に保存した16ビットデータから順に出力します。 |
| アナログ入力 | [[:ja-jp_commands:reference:analogreadinit|analogReadInit()]] | アナログ入力モジュールのサンプリング速度を設定します。 |
| ::: | [[:ja-jp_commands:reference:analogread|analogRead()]] | 指定したチャネルの生のアナログ値を読み取ります。 |
| ::: | [[:ja-jp_commands:reference:analogreadavg|analogReadAvg()]] | 複数の入力値の整数平均を返します。 |
| ::: | [[:ja-jp_commands:reference:analogreadavgf|analogReadAvgf()]] | 複数の入力値の実数平均を返します。 |
| アナログ入力フィルタ | [[:ja-jp_commands:reference:ianalogfilter|IanalogFilter()]] | 渡された値を移動平均処理します。 |
| アナログ範囲変換 | [[:ja-jp_commands:reference:ianalogread|IanalogRead()]] | アナログ入力値を指定した整数範囲に変換します。 |
| ::: | [[:ja-jp_commands:reference:ianalogreadf|IanalogReadf()]] | アナログ入力値を指定した実数範囲に変換します。 |
| 4~20mA入力 | [[:ja-jp_commands:reference:analogread2|analogRead2()]] | 指定したチャネルの4~20mA補正入力値を読み取ります。 |
| ::: | [[:ja-jp_commands:reference:analogread2avg|analogRead2Avg()]] | 4~20mA入力値の整数平均を返します。 |
| ::: | [[:ja-jp_commands:reference:analogread2avgf|analogRead2Avgf()]] | 4~20mA入力値の実数平均を返します。 |
| 4~20mA範囲変換 | [[:ja-jp_commands:reference:ianalogread2|IanalogRead2()]] | 4~20mA入力値を指定した整数範囲に変換します。 |
| ::: | [[:ja-jp_commands:reference:ianalogread2f|IanalogRead2f()]] | 4~20mA入力値を指定した実数範囲に変換します。 |
| 温度入力 | [[:ja-jp_commands:reference:ntcread|ntcRead()]] | NTC 3950 10kΩセンサの温度を0.1℃単位の整数で返します。 |
| ::: | [[:ja-jp_commands:reference:ntcreadf|ntcReadf()]] | NTC 3950 10kΩセンサの温度を℃単位の実数で返します。 |
| ::: | [[:ja-jp_commands:reference:pt100read|pt100Read()]] | PT100センサの温度を0.1℃単位の整数で返します。 |
| アナログ出力 | [[:ja-jp_commands:reference:analogwriteinit|analogWriteInit()]] | 出力タイマの分解能と分周比を設定します。 |
| ::: | [[:ja-jp_commands:reference:analogwritefreq|analogWriteFreq()]] | 指定した出力チャネルのPWM周波数を設定します。 |
| ::: | [[:ja-jp_commands:reference:analogwritemax|analogWriteMax()]] | 指定した出力チャネルで使用できる最大値を返します。 |
| ::: | [[:ja-jp_commands:reference:ianalogwriteinit|IanalogWriteInit()]] | MPAINOアナログ出力の最大値・最小値とモードを設定します。 |
| ::: | [[:ja-jp_commands:reference:ianalogwrite|IanalogWrite()]] | ユーザーの整数値をアナログ出力範囲に変換して出力します。 |
| ::: | [[:ja-jp_commands:reference:ianalogwritef|IanalogWritef()]] | ユーザーの実数値をアナログ出力範囲に変換して出力します。 |
| 4~20mA出力 | [[:ja-jp_commands:reference:analogwrite2|analogWrite2()]] | 指定したチャネルに4~20mA変換用の生値を出力します。 |
| ::: | [[:ja-jp_commands:reference:ianalogwrite2|IanalogWrite2()]] | ユーザーの整数値を4~20mA出力範囲に変換します。 |
| ::: | [[:ja-jp_commands:reference:ianalogwrite2f|IanalogWrite2f()]] | ユーザーの実数値を4~20mA出力範囲に変換します。 |
| PWM出力 | [[:ja-jp_commands:reference:pwm|PWM()]] | 指定したピンに8ビットまたは16ビットPWMを出力します。 |
| ::: | [[:ja-jp_commands:reference:fdpwm|FDPWM()]] | 指定した周波数とデューティ比でPWMを出力します。 |
| ::: | [[:ja-jp_commands:reference:pwmoff|PWMOFF()]] | 指定したピンのPWM出力を停止または再許可します。 |
| ::: | [[:ja-jp_commands:reference:pwm_reset|PWM_RESET()]] | コアが管理するPWM状態をすべて初期化します。 |
| パルス出力 | [[:ja-jp_commands:reference:npwm_begin|NPWM_BEGIN()]] | 周波数・デューティ比・出力数を指定してパルス出力を準備します。 |
| ::: | [[:ja-jp_commands:reference:npwm|NPWM()]] | 準備した数だけパルスを出力します。 |
| PID制御 | [[:ja-jp_commands:reference:ipidset|IpidSet()]] | PID係数、計算周期と出力範囲を設定します。 |
| ::: | [[:ja-jp_commands:reference:ipidrun|IpidRun()]] | 現在値と設定値を使ってPID出力を計算します。 |
| ::: | [[:ja-jp_commands:reference:ipidreset|IpidReset()]] | PIDの積分値と内部状態を初期化します。 |
| ::: | [[:ja-jp_commands:reference:ipidreverse|IpidReverse()]] | PIDの正動作または逆動作を選択します。 |
| ::: | [[:ja-jp_commands:reference:ipiditermlimit|IpidItermLimit()]] | PID積分項の最小値と最大値を制限します。 |
| ::: | [[:ja-jp_commands:reference:ipidoutput|IpidOutput()]] | 最後に計算したPID出力値を返します。 |
| TM1637 FND | [[:ja-jp_commands:reference:isegbegin|IsegBegin()]] | TM1637 FNDのCLK・DIOピンと装置番号を設定します。 |
| ::: | [[:ja-jp_commands:reference:isegbrightness|IsegBrightness()]] | 画面の明るさと表示状態を設定します。 |
| ::: | [[:ja-jp_commands:reference:isegclear|IsegClear()]] | FND表示を消去します。 |
| ::: | [[:ja-jp_commands:reference:isegwrite|IsegWrite()]] | 指定位置にセグメントデータを出力します。 |
| ::: | [[:ja-jp_commands:reference:isegdecimal|IsegDecimal()]] | 整数を10進数形式で表示します。 |
| ::: | [[:ja-jp_commands:reference:iseghex|IsegHex()]] | 整数を16進数形式で表示します。 |
| ::: | [[:ja-jp_commands:reference:isegencodedigit|IsegEncodeDigit()]] | 数字1桁をセグメントデータに変換します。 |
| キャラクタLCD | [[:ja-jp_commands:reference:iclcdbegin|IclcdBegin()]] | PCF8574キャラクタLCDのアドレスと画面サイズを設定します。 |
| ::: | [[:ja-jp_commands:reference:iclcdclear|IclcdClear()]] | LCD画面を消去します。 |
| ::: | [[:ja-jp_commands:reference:iclcdhome|IclcdHome()]] | カーソルを先頭位置へ移動します。 |
| ::: | [[:ja-jp_commands:reference:iclcdsetcursor|IclcdSetCursor()]] | カーソルを指定した列と行に移動します。 |
| ::: | [[:ja-jp_commands:reference:iclcddisplay|IclcdDisplay()]] | LCD表示を有効または無効にします。 |
| ::: | [[:ja-jp_commands:reference:iclcdcursor|IclcdCursor()]] | カーソルを表示または非表示にします。 |
| ::: | [[:ja-jp_commands:reference:iclcdblink|IclcdBlink()]] | カーソルの点滅を有効または無効にします。 |
| ::: | [[:ja-jp_commands:reference:iclcdbacklight|IclcdBacklight()]] | LCDバックライトを点灯または消灯します。 |
| ::: | [[:ja-jp_commands:reference:iclcdscrollleft|IclcdScrollLeft()]] | 表示内容を左に1桁移動します。 |
| ::: | [[:ja-jp_commands:reference:iclcdscrollright|IclcdScrollRight()]] | 表示内容を右に1桁移動します。 |
| ::: | [[:ja-jp_commands:reference:iclcdtextdirection|IclcdTextDirection()]] | 文字の入力方向を設定します。 |
| ::: | [[:ja-jp_commands:reference:iclcdautoscroll|IclcdAutoscroll()]] | 自動スクロールを有効または無効にします。 |
| ::: | [[:ja-jp_commands:reference:iclcdcreatechar|IclcdCreateChar()]] | ユーザー定義文字を登録します。 |
| ::: | [[:ja-jp_commands:reference:iclcdwrite|IclcdWrite()]] | 文字コードまたはユーザー定義文字を出力します。 |
| ::: | [[:ja-jp_commands:reference:iclcdcommand|IclcdCommand()]] | LCD制御コマンドを直接送信します。 |
| ::: | [[:ja-jp_commands:reference:iclcdprint|IclcdPrint()]] | 文字列または数値をLCDに出力します。 |
| RTC | [[:ja-jp_commands:reference:irtcbegin|IrtcBegin()]] | DS3231 RTCの接続を確認して使用を開始します。 |
| ::: | [[:ja-jp_commands:reference:irtcread|IrtcRead()]] | RTCの日付と時刻を読み取ります。 |
| ::: | [[:ja-jp_commands:reference:irtcset|IrtcSet()]] | RTCの日付と時刻を設定します。 |
| ::: | [[:ja-jp_commands:reference:irtcunixtime|IrtcUnixTime()]] | 現在時刻をUnix時間で返します。 |
| ::: | [[:ja-jp_commands:reference:irtcgettemperature|IrtcGetTemperature()]] | RTCの内部温度を返します。 |
| ::: | [[:ja-jp_commands:reference:irtctimevalid|IrtcTimeValid()]] | RTC時刻が信頼できる状態か確認します。 |
| ::: | [[:ja-jp_commands:reference:irtcclearoscillatorstopflag|IrtcClearOscillatorStopFlag()]] | 発振停止状態フラグをクリアします。 |
| ::: | [[:ja-jp_commands:reference:irtcsetalarm1|IrtcSetAlarm1()]] | 秒単位を含むアラーム1を設定します。 |
| ::: | [[:ja-jp_commands:reference:irtcsetalarm2|IrtcSetAlarm2()]] | 分単位のアラーム2を設定します。 |
| ::: | [[:ja-jp_commands:reference:irtcalarmenable|IrtcAlarmEnable()]] | 指定したアラームを有効または無効にします。 |
| ::: | [[:ja-jp_commands:reference:irtcalarmenabled|IrtcAlarmEnabled()]] | 指定したアラームの有効状態を確認します。 |
| ::: | [[:ja-jp_commands:reference:irtcalarmtriggered|IrtcAlarmTriggered()]] | アラームの発生有無を確認し、必要に応じて状態をクリアします。 |
| ::: | [[:ja-jp_commands:reference:irtcsquarewave|IrtcSquareWave()]] | RTCの矩形波出力を設定します。 |
| ::: | [[:ja-jp_commands:reference:irtc32khz|Irtc32kHz()]] | RTCの32kHz出力を有効または無効にします。 |
| デバッグ | [[:ja-jp_commands:reference:debugstart|debugStart()]] | デバッグ出力に使用するポートとボーレートを設定します。 |
| ::: | [[:ja-jp_commands:reference:debugstop|debugStop()]] | デバッグ出力を停止します。 |
| ::: | [[:ja-jp_commands:reference:debugstate|debugState()]] | デバッグ出力の有効状態を返します。 |
| ::: | [[:ja-jp_commands:reference:debug|debug()]] | デバッグが有効な場合だけ値を出力します。 |
| ::: | [[:ja-jp_commands:reference:debugln|debugln()]] | デバッグ値を出力して改行します。 |
| Watchdog | [[:ja-jp_commands:reference:wdt_enable|WDT_ENABLE()]] | Watchdogの制限時間を設定して動作を開始します。 |
| ::: | [[:ja-jp_commands:reference:wdt_disable|WDT_DISABLE()]] | Watchdogの動作を停止します。 |
| ::: | [[:ja-jp_commands:reference:wdt|WDT()]] | 制限時間が切れる前にWatchdogを更新します。 |
| 高速カウンタ | [[:ja-jp_commands:reference:tcntsetup|TCNTSETUP()]] | タイマの外部クロック入力と32ビット拡張モードを設定します。 |
| ::: | [[:ja-jp_commands:reference:tcntout|TCNTOUT()]] | 32ビット拡張モードの累積上位オーバーフロー値を返します。 |
| Modbus RTU Slave | [[:ja-jp_commands:reference:imodbusrtumem|ImodbusRTUMem()]] | Slaveで使用するM・Dメモリのサイズを設定します。 |
| ::: | [[:ja-jp_commands:reference:imodbusrtuadr|ImodbusRTUAdr()]] | M・Dメモリの開始アドレスを設定します。 |
| ::: | [[:ja-jp_commands:reference:imodbusrtuinit|ImodbusRTUInit()]] | 通信ポート、局番、ボーレートを設定します。 |
| ::: | [[:ja-jp_commands:reference:imodbusrtu|ImodbusRTU()]] | 受信要求を確認し、Slave応答を処理します。 |
| Modbus RTU Master | [[:ja-jp_commands:reference:imodbusrtumasterinit|ImodbusRTUmasterInit()]] | Master通信ポートとボーレートを設定します。 |
| ::: | [[:ja-jp_commands:reference:imodbusrtumaster|ImodbusRTUmaster()]] | 1つのMaster要求を直ちに実行します。 |
| ::: | [[:ja-jp_commands:reference:imodbusrtumasteradd|ImodbusRTUmasterAdd()]] | 繰り返し実行するMaster要求を登録します。 |
| ::: | [[:ja-jp_commands:reference:imodbusrtumasterrun|ImodbusRTUmasterRun()]] | 登録要求または指定した単一要求を実行します。 |
| LS産電 Cnet Slave | [[:ja-jp_commands:reference:icnetmem|ICnetMem()]] | Cnet Slaveで使用するM・D・Rメモリのサイズを設定します。 |
| ::: | [[:ja-jp_commands:reference:icnetadr|ICnetAdr()]] | M・D・Rメモリの開始アドレスを設定します。 |
| ::: | [[:ja-jp_commands:reference:icnetinit|ICnetInit()]] | 通信ポート、局番、ボーレートを設定します。 |
| ::: | [[:ja-jp_commands:reference:icnet|ICnet()]] | 受信要求を確認し、Cnet Slave応答を処理します。 |
| Mitsubishi MC Protocol | [[:ja-jp_commands:reference:imcmem|IMcMem()]] | MC Protocolで使用するX・Y・M・Dメモリのサイズを設定します。 |
| ::: | [[:ja-jp_commands:reference:imcadr|IMcAdr()]] | X・Y・M・Dメモリの開始アドレスを設定します。 |
| ::: | [[:ja-jp_commands:reference:imcinit|IMcInit()]] | 通信ポート、局番、ボーレートを設定します。 |
| ::: | [[:ja-jp_commands:reference:imcprotocol|IMcProtocol()]] | 受信要求を確認し、MC Protocol応答を処理します。 |

===== デジタル入力フィルタ =====

^ コマンド形式 ^ 戻り値 ^ 使用基準 ^
| [[:ja-jp_commands:reference:idigitalread|IdigitalRead(pin, samples)]] | フィルタ処理した''HIGH''または''LOW'' | すべてのサンプルが同じ場合だけ状態を更新し、値が混在すると前の安定状態を維持 |
| [[:ja-jp_commands:ibounce|Ibounce(pin, ms)]] | 安定化した入力状態 | ONまたはOFFが設定時間維持されたときに状態変更 |
| [[:ja-jp_commands:reference:ibounceon|IbounceOn(pin, ms)]] | ON方向が遅延された入力状態 | OFF→ON方向だけに時間フィルタを適用 |
| [[:ja-jp_commands:reference:ibounceoff|IbounceOff(pin, ms)]] | OFF方向が遅延された入力状態 | ON→OFF方向だけに時間フィルタを適用 |

''IdigitalRead()''は短時間に繰り返しサンプリングする方式で、''Ibounce()''は''millis()''を基準に入力が安定した時間を確認する方式です。機械式スイッチには通常''Ibounce()''が適しています。

===== エッジ検出 =====

^ コマンド形式 ^ 戻り値 ^ 説明 ^
| [[:ja-jp_commands:reference:iup|Iup(id, input)]] | 立ち上がり時だけ''true'' | OFFからONに変わる瞬間を1回検出 |
| [[:ja-jp_commands:reference:idown|Idown(id, input)]] | 立ち下がり時だけ''true'' | ONからOFFに変わる瞬間を1回検出 |

''id''は各エッジ検出状態を区別します。異なる入力に同じ''id''を使うと状態が混在する場合があります。

===== 状態反転 =====

^ コマンド形式 ^ 戻り値 ^ 説明 ^
| [[:ja-jp_commands:reference:ialt|Ialt(input, state)]] | なし | 入力の立ち上がりごとに''state''値をON/OFF反転 |

次の例では、MPAINO-8A8R(T)の最初の入力''0''と出力''64''を使用します。

<code cpp>
bool lampState = false;

void setup() {}

void loop() {
  bool button = Ibounce(0, 30);
  Ialt(button, lampState);
  digitalWrite(64, lampState); // MPAINOの最初のデジタル出力の例
}
</code>

===== 範囲変換 =====

^ コマンド形式 ^ 戻り値 ^ 説明 ^
| [[:ja-jp_commands:reference:iscale|Iscale(x, inMin, inMax, outMin, outMax)]] | ''int32_t'' | 整数入力範囲を希望する整数範囲に変換 |
| [[:ja-jp_commands:reference:iscalef|Iscalef(x, inMin, inMax, outMin, outMax)]] | ''float'' | 小数点を保持して実数範囲を変換 |

===== タイマ =====

^ コマンド形式 ^ 動作 ^
| [[:ja-jp_commands:reference:iton|Iton(id, state, ms)]] | 入力が設定時間ONであると出力ON |
| [[:ja-jp_commands:reference:itof|Itof(id, state, ms)]] | 入力OFF後に設定時間が経過すると出力OFF |
| [[:ja-jp_commands:reference:itpl|Itpl(id, state, ms)]] | 入力の立ち上がり瞬間から設定時間の間パルス出力 |
| [[:ja-jp_commands:reference:itmon|Itmon(id, state, ms)]] | 実行中に再入力されても延長されない単安定パルス |
| [[:ja-jp_commands:reference:itmr|Itmr(id, state, ms, reset)]] | 入力ON時間を積算し、''reset''で初期化 |

PLCスタイルタイマは''delay()''のようにプログラムを停止しません。代わりに''loop()''が繰り返されるたびに継続的に呼び出してください。異なるタイマに同じ''id''を重複使用しないでください。

次の例では、MPAINO-8A8R(T)の最初の入力''0''と出力''64''を使用します。

<code cpp>
void setup() {}

void loop() {
  bool run = Ibounce(0, 30);
  bool delayedOutput = Iton(0, run, 1000);
  digitalWrite(64, delayedOutput);
}
</code>

===== タイマ状態 =====

^ コマンド形式 ^ 戻り値 ^ 説明 ^
| [[:ja-jp_commands:reference:igettime|IgetTime(id)]] | ''unsigned long'' | 指定したタイマの現在の経過時間を返す |
| [[:ja-jp_commands:reference:igetstate|IgetState(id)]] | ''bool'' | 指定したタイマの現在の出力状態を返す |

===== コールバックタイマ =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:itimerset|ItimerSet(intervalMs, callback)]] | 既定タイマの実行周期とコールバック関数の設定 |
| [[:ja-jp_commands:reference:itimerset|ItimerSet(timerNo, intervalMs, callback)]] | ハードウェアタイマ番号を指定して設定 |
| [[:ja-jp_commands:reference:itimerstart|ItimerStart()]], [[:ja-jp_commands:reference:itimerstart|ItimerStart(timerNo)]] | コールバックタイマの開始 |
| [[:ja-jp_commands:reference:itimerstop|ItimerStop()]], [[:ja-jp_commands:reference:itimerstop|ItimerStop(timerNo)]] | コールバックタイマの停止 |
| [[:ja-jp_commands:reference:itimerstopall|ItimerStopAll()]] | すべてのコールバックタイマを停止 |
| [[:ja-jp_commands:reference:itimerstate|ItimerState()]], [[:ja-jp_commands:reference:itimerstate|ItimerState(timerNo)]] | 実行状態の確認 |

コールバック関数は割り込み内で実行されます。コールバックではフラグや短いカウントだけを変更し、''delay()''、Serial出力、I²C、SPI、長い計算を使用しないでください。

<code cpp>
volatile bool taskFlag = false;

void onTimer() {
  taskFlag = true;
}

void setup() {
  ItimerSet(100, onTimer);
  ItimerStart();
}

void loop() {
  if (taskFlag) {
    taskFlag = false;
    // 時間のかかる実際の処理はloop()で実行します。
  }
}
</code>

===== カウンタ =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:ictu|Ictu(id, CU, RESET, PV)]] | ''CU''の立ち上がりエッジを数え、''PV''に達するとON |
| [[:ja-jp_commands:reference:ictd|Ictd(id, CD, LOAD, PV)]] | ''LOAD''で値を読み込み、''CD''の立ち上がりエッジごとに減少 |
| [[:ja-jp_commands:reference:ictud|Ictud(id, CU, CD, RESET, LOAD, PV)]] | 増加と減少をまとめて処理 |
| [[:ja-jp_commands:reference:igetcount|IgetCount(id)]], [[:ja-jp_commands:reference:isetcount|IsetCount(id, value)]] | 現在のカウント値の参照と変更 |
| [[:ja-jp_commands:reference:ictuddownstate|IctudDownState(id)]] | Up/Downカウンタの下限完了状態の確認 |

カウンタコマンドは''loop()''で継続的に呼び出します。''id''は他のカウンタと重複しないように割り当てます。

===== データバッファ =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:fifo|FIFO(...)]] | 先に保存した16ビットデータから順に取り出すバッファ |
| [[:ja-jp_commands:reference:filo|FILO(...)]] | 後に保存した16ビットデータから順に取り出すバッファ |

===== アナログ入力 =====

^ コマンド形式 ^ 戻り値・用途 ^
| [[:ja-jp_commands:reference:analogreadinit|analogReadInit(sps)]] | MPAINO ADS1118アナログモジュールのサンプリング速度設定 |
| [[:ja-jp_commands:reference:analogread|analogRead(ch)]] | 選択チャネルの生アナログ値の読み取り |
| [[:ja-jp_commands:reference:analogreadavg|analogReadAvg(ch, samples)]], [[:ja-jp_commands:reference:analogreadavgf|analogReadAvgf(ch, samples)]] | 整数または実数の移動平均入力 |

===== アナログ入力フィルタ =====

^ コマンド形式 ^ 戻り値・用途 ^
| [[:ja-jp_commands:reference:ianalogfilter|IanalogFilter(id, raw, samples)]] | ユーザーが渡した任意の値を移動平均処理 |

===== アナログ範囲変換 =====

^ コマンド形式 ^ 戻り値・用途 ^
| [[:ja-jp_commands:reference:ianalogread|IanalogRead(ch, min, max)]], [[:ja-jp_commands:reference:ianalogreadf|IanalogReadf(ch, min, max)]] | 入力をユーザーの整数・実数範囲に変換 |

===== 4~20mA入力 =====

^ コマンド形式 ^ 戻り値・用途 ^
| [[:ja-jp_commands:reference:analogread2|analogRead2(ch)]] | 4~20mA補正入力値の読み取り |
| [[:ja-jp_commands:reference:analogread2avg|analogRead2Avg(ch, samples)]], [[:ja-jp_commands:reference:analogread2avgf|analogRead2Avgf(ch, samples)]] | 4~20mA入力値の整数または実数平均を返す |

===== 4~20mA範囲変換 =====

^ コマンド形式 ^ 戻り値・用途 ^
| [[:ja-jp_commands:reference:ianalogread2|IanalogRead2(ch, min, max)]], [[:ja-jp_commands:reference:ianalogread2f|IanalogRead2f(ch, min, max)]] | 4~20mA入力をユーザー範囲に変換 |

MPAINOでは装着したアナログ入力モジュールとDIPスイッチの電圧・電流範囲を先に確認します。サンプリング速度を上げると応答は速くなりますが、ノイズや測定特性が変わる場合があります。

<code cpp>
void setup() {
  Serial.begin(115200);
  analogReadInit(IANALOG_SPS_64);
}

void loop() {
  int32_t raw = analogReadAvg(0, 8);
  float value = Iscalef(raw, 0.0, 32767.0, 0.0, 100.0);
  Serial.println(value);
}
</code>

===== 温度入力 =====

^ コマンド形式 ^ 戻り値 ^ 対象 ^
| [[:ja-jp_commands:reference:ntcread|ntcRead(ch)]] | 0.1℃単位の整数 | NTC 3950 10kΩ温度センサ入力 |
| [[:ja-jp_commands:reference:ntcreadf|ntcReadf(ch)]] | ℃単位の''float'' | NTC 3950 10kΩ温度センサ入力 |
| [[:ja-jp_commands:reference:pt100read|pt100Read(ch)]] | 0.1℃単位の整数 | MPAINO PT100入力モジュール |

NTCとPT100はセンサ種類と入力回路が異なります。相互に置き換えて使用せず、選択した製品に該当する入力機能があるか確認してください。

===== アナログ出力 =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:analogwriteinit|analogWriteInit(ch, top, prescaler)]] | PWMタイマの分解能と分周比の設定 |
| [[:ja-jp_commands:reference:analogwritefreq|analogWriteFreq(ch, hz)]], [[:ja-jp_commands:reference:analogwritemax|analogWriteMax(ch)]] | PWM周波数の設定と現在の最大値の確認 |
| [[:ja-jp_commands:reference:ianalogwriteinit|IanalogWriteInit(ch, max, min, mode)]] | MPAINOアナログ出力範囲の初期化 |
| [[:ja-jp_commands:reference:ianalogwrite|IanalogWrite(ch, min, max, value)]], [[:ja-jp_commands:reference:ianalogwritef|IanalogWritef(...)]] | 整数・実数のユーザー値をアナログ出力範囲に変換 |

===== 4~20mA出力 =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:analogwrite2|analogWrite2(ch, value)]] | 指定チャネルに4~20mA変換用の生値を出力 |
| [[:ja-jp_commands:reference:ianalogwrite2|IanalogWrite2(ch, min, max, value)]], [[:ja-jp_commands:reference:ianalogwrite2f|IanalogWrite2f(...)]] | 整数・実数のユーザー値を4~20mA出力範囲に変換 |

===== PWM出力 =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:pwm|PWM(pin, value, bit16)]] | 8ビットまたは16ビットPWM出力 |
| [[:ja-jp_commands:reference:fdpwm|FDPWM(pin, hz, duty)]] | 周波数とデューティ比を指定したPWM出力 |
| [[:ja-jp_commands:reference:pwmoff|PWMOFF(pin, off)]], [[:ja-jp_commands:reference:pwm_reset|PWM_RESET()]] | 個別PWMの停止または全体の初期化 |

===== パルス出力 =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:npwm_begin|NPWM_BEGIN(pin, hz, duty, count)]], [[:ja-jp_commands:reference:npwm|NPWM(pin)]] | 指定した数だけパルス出力 |

PWM、高速パルス、''analogWrite()''、コールバックタイマは同じハードウェアタイマを共有する場合があります。複数の機能を組み合わせるときは、該当製品のタイマ対応表を確認してください。

===== PID制御 =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:ipidset|IpidSet(id, kp, ki, kd, sampleMs, outMin, outMax)]] | PID係数、計算周期、出力範囲の設定 |
| [[:ja-jp_commands:reference:ipidrun|IpidRun(id, pv, sv)]] | 現在値''PV''と設定値''SV''から出力を計算 |
| [[:ja-jp_commands:reference:ipidreset|IpidReset(id)]] | 内部状態の初期化 |
| [[:ja-jp_commands:reference:ipidreverse|IpidReverse(id, reverse)]] | 正動作または逆動作の選択 |
| [[:ja-jp_commands:reference:ipiditermlimit|IpidItermLimit(id, min, max)]] | 積分項の範囲制限 |
| [[:ja-jp_commands:reference:ipidoutput|IpidOutput(id)]] | 最後の出力値の確認 |

<code cpp>
void setup() {
  IpidSet(0, 2.0, 0.5, 0.1, 100, 0, 100);
}

void loop() {
  float pv = ntcReadf(0);
  float output = IpidRun(0, pv, 50.0);
  IanalogWritef(0, 0.0, 100.0, output);
}
</code>

PID出力は計算値であり、安全装置ではありません。センサ断線、過温度、出力固着、非常停止は別の安全回路で処理してください。

===== TM1637 FND =====

^ 対象 ^ 主なコマンド ^ 説明 ^
| TM1637 4桁FND | [[:ja-jp_commands:reference:isegbegin|IsegBegin()]], [[:ja-jp_commands:reference:isegbrightness|IsegBrightness()]], [[:ja-jp_commands:reference:isegdecimal|IsegDecimal()]], [[:ja-jp_commands:reference:iseghex|IsegHex()]], [[:ja-jp_commands:reference:isegclear|IsegClear()]] | 最大7台の装置を''device''番号で区別 |

===== キャラクタLCD =====

^ 対象 ^ 主なコマンド ^ 説明 ^
| PCF8574キャラクタLCD | [[:ja-jp_commands:reference:iclcdbegin|IclcdBegin()]], [[:ja-jp_commands:reference:iclcdsetcursor|IclcdSetCursor()]], [[:ja-jp_commands:reference:iclcdprint|IclcdPrint()]], [[:ja-jp_commands:reference:iclcdclear|IclcdClear()]] | 最大4台のLCDを''device''番号で区別 |

===== RTC =====

^ 対象 ^ 主なコマンド ^ 説明 ^
| DS3231 RTC | [[:ja-jp_commands:reference:irtcbegin|IrtcBegin()]], [[:ja-jp_commands:reference:irtcread|IrtcRead()]], [[:ja-jp_commands:reference:irtcset|IrtcSet()]], [[:ja-jp_commands:reference:irtcgettemperature|IrtcGetTemperature()]], [[:ja-jp_commands:reference:irtcsetalarm1|IrtcSetAlarm1()]] | 日付・時刻、温度、アラーム、周波数出力の使用 |

表示装置とRTCは、それぞれの''Begin''コマンドを先に呼び出します。I²Cアドレス、接続ピン、他の機能との共有有無を確認してください。

===== デバッグ =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:debugstart|debugStart()]], [[:ja-jp_commands:reference:debugstart|debugStart(baud)]], [[:ja-jp_commands:reference:debugstart|debugStart(serial, baud)]] | Debug出力の開始とポート選択 |
| [[:ja-jp_commands:reference:debug|debug()]], [[:ja-jp_commands:reference:debugln|debugln()]] | Debugが有効な場合だけ値を出力 |
| [[:ja-jp_commands:reference:debugstop|debugStop()]], [[:ja-jp_commands:reference:debugstate|debugState()]] | Debugの停止と状態確認 |

===== Watchdog =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:wdt_enable|WDT_ENABLE(time)]] | Watchdogの制限時間設定と有効化 |
| [[:ja-jp_commands:reference:wdt|WDT()]], [[:ja-jp_commands:reference:wdt_disable|WDT_DISABLE()]] | Watchdogのリセットと無効化 |

Watchdogを有効にした後、''WDT()''の呼び出しが遅れるとボードが再起動します。通信待ちと長いループの最悪実行時間を先に確認してください。

===== 高速カウンタ =====

^ コマンド形式 ^ 説明 ^
| [[:ja-jp_commands:reference:tcntsetup|TCNTSETUP(timerNo, bit32)]] | タイマ外部クロック入力と32ビット拡張モードの設定 |
| [[:ja-jp_commands:reference:tcntout|TCNTOUT(timerNo)]] | 32ビット拡張モードで累積した上位オーバーフロー回数の確認 |

現在、タイマ外部クロック方式の専用高速カウンタに対応する製品はMPINO-8A8RとMPINO-16A8R8Tです。他の製品では製品別の割り込み入力を確認し、''attachInterrupt()''方式を使用します。

===== Modbus RTU Slave =====

^ 初期設定 ^ ''loop()''で実行するコマンド ^
| [[:ja-jp_commands:reference:imodbusrtumem|ImodbusRTUMem()]], [[:ja-jp_commands:reference:imodbusrtuadr|ImodbusRTUAdr()]], [[:ja-jp_commands:reference:imodbusrtuinit|ImodbusRTUInit()]] | [[:ja-jp_commands:reference:imodbusrtu|ImodbusRTU()]] |

<code cpp>
void setup() {
  ImodbusRTUMem(128, 64);
  ImodbusRTUAdr(0, 0);
  ImodbusRTUInit(Serial2, 1, 9600);
}

void loop() {
  ImodbusRTU();
}
</code>

===== Modbus RTU Master =====

^ 初期設定 ^ 実行コマンド ^
| [[:ja-jp_commands:reference:imodbusrtumasterinit|ImodbusRTUmasterInit()]], [[:ja-jp_commands:reference:imodbusrtumasteradd|ImodbusRTUmasterAdd()]] | [[:ja-jp_commands:reference:imodbusrtumaster|ImodbusRTUmaster()]] または [[:ja-jp_commands:reference:imodbusrtumasterrun|ImodbusRTUmasterRun()]] |

===== LS産電 Cnet Slave =====

^ 初期設定 ^ ''loop()''で実行するコマンド ^
| [[:ja-jp_commands:reference:icnetmem|ICnetMem()]], [[:ja-jp_commands:reference:icnetadr|ICnetAdr()]], [[:ja-jp_commands:reference:icnetinit|ICnetInit()]] | [[:ja-jp_commands:reference:icnet|ICnet()]] |

===== Mitsubishi MC Protocol =====

^ 初期設定 ^ ''loop()''で実行するコマンド ^
| [[:ja-jp_commands:reference:imcmem|IMcMem()]], [[:ja-jp_commands:reference:imcadr|IMcAdr()]], [[:ja-jp_commands:reference:imcinit|IMcInit()]] | [[:ja-jp_commands:reference:imcprotocol|IMcProtocol()]] |

RS-232、RS-485、UARTの''Serial''番号は製品によって異なる場合があります。通信前にポートの役割、電気規格、ボーレート、局番、終端抵抗、DIPスイッチ設定を確認してください。

===== 統合入出力の例 =====

以下の例ではMPAINOの最初のデジタル入力''0''と最初のデジタル出力''64''を使用します。MPINOでは選択したモデルの実際のArduinoピン番号に変更してください。

<code cpp>
const uint8_t inputChannel = 0;
const uint8_t outputChannel = 64;

void setup() {}

void loop() {
  bool stableInput = Ibounce(inputChannel, 30);
  bool delayedOutput = Iton(0, stableInput, 1000);
  digitalWrite(outputChannel, delayedOutput);
}
</code>

===== トラブルシューティング =====

  * **コマンドが見つからない：** ILOGICSボードパッケージのインストールと製品ボードの選択を確認します。
  * **入出力が反応しない：** MPINOのピン番号とMPAINOの論理チャネルを混同していないか確認します。
  * **タイマ・カウンタが停止する：** ''loop()''でコマンドを継続的に呼び出しているか、同じ''id''を重複使用していないか確認します。
  * **PWM周波数がおかしい：** 同じハードウェアタイマを別のPWM・パルス・コールバック機能が使用していないか確認します。
  * **アナログ値が異なる：** 電圧・電流・NTC・PT100のDIPスイッチ、チャネル、サンプリング速度を確認します。
  * **通信できない：** Serialポート、RS-232/RS-485方式、ボーレート、局番、パリティ、配線を確認します。
  * **ボードが繰り返し再起動する：** Watchdogの制限時間より長くかかるコードがないか確認します。

===== 必須注意事項 =====

  * 従来の''#include <ILIB.h>''、''tempRead()''、''Ipt100Read()''の例を現在の内蔵コマンドと混用しないでください。
  * 電源や配線を変更するときは機器の電源を切り、極性、COM、入力電圧、負荷電源を確認します。
  * リレー出力とトランジスタ出力の電気的特性および許容電流を区別してください。
  * プログラム出力だけを非常停止や過電流保護の手段として使用しないでください。
  * 製品別のピンマップ、電気仕様、対応タイマは該当する製品説明書を最終基準として確認します。

===== 関連文書 =====

  * [[:ja-jp_products:overview|製品選択ガイド]]
  * [[:ja-jp_products:mpino_series|MPINOの製品特長と使用の流れ]]
  * [[:ja-jp_products:mpaino|MPAINOのモジュール構成と論理チャネル]]
  * [[:ja-jp_guide:getting_started|Arduino IDEで初めて使う]]
  * [[:ja-jp_guide:wiring|はじめての配線と入出力確認]]
  * [[:ja-jp_safety|安全および設置上の注意事項]]