ESP32-WROOM-32EのタイマでDIフィルタを実装する

こんにちは、ENGかぴです。

Arduino環境でDIの信号レベルを判定しているとスイッチの切り替えなどで発生するチャタリングのため誤動作の原因になることがあります。タイマライブラリを使用してDIのチャタリングの防止を行う方法をまとめました。

ESP32-WROOM-32E開発ボード（秋月電子）を使用しArduino IDEで開発を行います。Arduino IDEで開発環境の作り方については下記記事を参考にしてください。

ESP32-WROOM-32Eの開発環境（Arduino IDE）を作り方

ESP32-WROOM-32Eを使って動作確認したことをまとめています。

ESP32-WROOM-32Eで学べるソフト開発と標準ライブラリの使い方

タイマを実装する
チャタリング防止のDIフィルタを実装
1. DI信号のチャタリング
2. DIフィルタを実装する
動作確認
ソースコード全体
関連リンク

タイマを実装する

ESP32-WROOM-32Eの開発環境ではタイマに関するライブラリが標準で搭載されています。スケッチ例である「RepeatTimer」を引用しながらタイマの設定を行いDIフィルタを実装していきます。

タイマの設定

ESP32にはハードウェアタイマが４つあります。タイマ設定で任意の値をセットするとタイマカウントが更新されていき時間経過によって割り込みが発生します。

hw_timer_t *timer = NULL;

void setup() {

    //timerSemaphore = xSemaphoreCreateBinary(); //セマフォを作ってタイマ起動時に通知
    timer = timerBegin(0,80,true); //クロック80MHzを80で分周するので1usが最小分解能
    timerAttachInterrupt(timer, &onTimer,true);
    timerAlarmWrite(timer,10000,true);  // 10msごとにonTimer()がコール
    timerAlarmEnable(timer); //timer通知を開始
}

timerBegin()でタイマの初期化を行います。第1引数に使用するタイマ（0～3）を選択し、第2引数に動作クロックである80MHzに対する分周比を指定します。80を指定すると1usの分解能を持つタイマになります。第3引数はタイマカウントを増加（true）させるか減少(false)させるかを選択します。戻り値は他の設定で使用するためhw_timerの型ポインタの変数に戻り値をセットしています。

timerAttachInterrupt ()で割り込み関数を設定します。第1引数にtimerBegin()の戻り値をセットします。第2引数に割り込み処理を行う関数をセットします。第3引数に割り込みエッジをトリガ(true)にするかレベル(false)にするかを指定します。

timerAlarmWrite ()はタイマに値をセットします。第1引数にtimerBegin()の戻り値をセットします。第2引数にtimerBegin()の第2引数で設定した分周に対するカウント数を指定します。1usが分解能であった時10000を引数に指定すると10ms毎にタイマ割り込みが発生します。第3引数にtrueを指定すると割り込み発生時に第2引数の値が再設定されます。

timerAlarmEnable ()でタイマをスタートします。引数にtimerBegin()の戻り値を指定します。

PR：企業で求められる即戦力技術を身に付けるテックキャンプエンジニア転職

割り込み関数を実装

void IRAM_ATTR onTimer(void){ //IRAMセクションに割り当てるとRAM領域となり高速となる

#ifdef SEMAPHORE_USE
    portENTER_CRITICAL_ISR(&timerMux);
    //メインと共用の変数がある場合はこの中で修正ーメイン側も同様にしてクリティカル内で更新する。
    portEXIT_CRITICAL_ISR(&timerMux);
    xSemaphoreGiveFromISR(timerSemaphore,NULL); //ISRにセマフォ（排他処理）を与えてタスクの割込みを防ぐ
#endif
    mainTimer(); //タイマ管理
}

タイマ割り込みでコールする関数としてonTimer()を実装します。voidの後ろに記述しているIRAM_ATTRはRAM領域に配置したい場合に指定します。指定しない場合はROM領域（フラッシュメモリ）に配置されます。

RAM領域に配置することでフラッシュメモリよりも高速に処理することができるため割り込み関数を少しでも高速にしたい場合に指定するとよいでしょう。

セマフォ使用時の例も記述していますがタイマ割り込みを一つしか使用しないのであれば指定する必要はありません。セマフォを利用するとタスク処理中に他のタスクがコールされることを防ぐ（排他処理）ことができます。

タイマ管理

mainTimer()の処理を行い各種タイマを管理します。

void mainTimer(void){

    if( timLedOnOff > TIME_UP ){
        --timLedOnOff;
    }
    if( timDifilter > TIME_UP ){
        --timDifilter;
    }
}

mainTimer()は10ms毎にコールされるためtimLedOnOff及びtimDifilterは10ms毎に更新されるタイマとなります。timLedOnOffに20をセットした場合は200msのタイマとなります。このようにタイマ変数に値をセットすることで任意のタイマを作ることができます。

PR：技術系の通信教育講座ならJTEX

チャタリング防止のDIフィルタを実装

マイコンのDIはデジタル入力で入力された電圧値からHighレベル（1）かLowレベル（0）かの判定を行います。スイッチのチャタリングなどが原因でマイコンが誤動作する可能性があるため注意が必要です。

DI信号のチャタリング

スイッチがONからOFFになったときスイッチの接触抵抗などによって電圧レベルが安定しない瞬間があります。数ms経過するとDI信号が安定するため、安定後にDI情報を取り込む対策が必要です。

僅か数ms間ではありますが１と0が繰り返されること０からフィルタを入れていなかった場合誤動作の可能性があります。リレーの接点などは容量が大きくチャタリングが大きく出ることがあります。

周辺回路でコンデンサを入れたりすることでチャタリングの高周波成分を減衰させることができますが、完全に除去できるわけではありません。

ソフトでDI信号が安定したことを確認して入力として採用することでチャタリングの影響を抑えることができます。

PR：わからないを放置せず、あなたにあったスキルを身に着けるコツを教えるテックジム　「書けるが先で、理解が後」を体験しよう！

DIフィルタを実装する

タイマを利用することで10ms毎にDIの情報を確認し複数回一致したとき値を採用する方法でDIフィルタを実装します。

void DiFilter(void){
    bool boo = true;
    uint8_t i;

    if( timDifilter == TIME_UP ){
        timDifilter = TIM_DIFILT;

        diData.buf[diData.wp] = digitalRead(PIN_DI_SW); //DI情報を取得

        for( i=1; i < sizeof(diData.buf);i++){
            if( diData.buf[i - 1] != diData.buf[i]){
                boo = false; //一度でも不一致があればfalseとなる
            }
        }

        if(boo){ //データがすべて一致なので採用する
            diData.di1 = diData.buf[0];
        }
        if( ++diData.wp >= sizeof(diData.buf)){
            diData.wp = 0;
        }
    }
}

timDifilterがタイムアップするとDI情報を取得しDI情報を格納するバッファを更新します。全てのバッファの値が一致したときDI情報として採用するためチャタリングによる不安定な部分を取り除く事ができます。

timDifilter にセットする値を大きくするとDI情報の安定を判定する時間は長くなりますが、チャタリング防止による誤動作は防ぎやすくなります。

タイマの値を短くしたりバッファの値を増やす方法を選択したりすることで任意のフィルタを実装することができます。

PR：（即戦力のスキルを身に着ける：DMM WEBCAMP 学習コース（はじめてのプログラミングコース））