5  イベントの発生源 ①:ボタン割り込み

5.1 ポーリングと割り込み

ボタンの状態を知る方法は 2 つあります。

方法 仕組み 欠点
ポーリング loop() で digitalRead() を繰り返し読む 読んでいない間の押下を見逃す。CPU が休めない
割り込み ピンの変化をハードウェアが検出し、割り込みハンドラ (ISR) を呼ぶ ISR の中でできることに制約がある

nRF52840 では、GPIOTE(GPIO Tasks and Events)という周辺回路がピンの変化を検出して割り込みを発生させます。Arduino の attachInterrupt() がこれを設定します。

5.2 実装

#ifndef DRV_BUTTON_H
#define DRV_BUTTON_H

#include <Arduino.h>

#define BUTTON_PIN 8            // D8 と GND の間にタクトスイッチをつなぐ
#define BUTTON_DEBOUNCE_MS 30   // チャタリングとみなす時間
#define BUTTON_LONG_PRESS_MS 1000

void button_init();

#endif // DRV_BUTTON_H
#include "drv_button.h"
#include "app_event.h"

// 割り込みとメインの両方から触る変数には volatile を付ける
static volatile uint32_t s_pressed_at = 0;   // 押された時刻
static volatile uint32_t s_last_edge_at = 0; // 最後にエッジを受け付けた時刻
static volatile bool s_is_pressed = false;

// 割り込みハンドラ(ISR): 短く終わらせる。重い処理・Serial・delay は禁止
static void button_isr()
{
  uint32_t now = millis();
  if (now - s_last_edge_at < BUTTON_DEBOUNCE_MS)
    return; // チャタリング: 直前のエッジから時間が経っていなければ無視
  s_last_edge_at = now;

  bool level_low = (digitalRead(BUTTON_PIN) == LOW); // プルアップなので押すと LOW
  if (level_low && !s_is_pressed)
  {
    s_is_pressed = true;
    s_pressed_at = now;
  }
  else if (!level_low && s_is_pressed)
  {
    s_is_pressed = false;
    uint32_t held = now - s_pressed_at;
    event_post(held >= BUTTON_LONG_PRESS_MS ? EVT_BUTTON_LONG : EVT_BUTTON_SHORT);
  }
}

void button_init()
{
  pinMode(BUTTON_PIN, INPUT_PULLUP);
  attachInterrupt(digitalPinToInterrupt(BUTTON_PIN), button_isr, CHANGE);
}

5.2.1 CHANGE で押下と解放の両方を捕まえる

attachInterrupt(..., CHANGE) で、押したとき(HIGH → LOW)と離したとき(LOW → HIGH)の両方 で ISR が呼ばれます。

  • 押したとき: 時刻を記録
  • 離したとき: 押していた時間で 短押し / 長押し を判定してイベントを積む

5.2.2 チャタリング

機械式スイッチは、押した瞬間・離した瞬間に接点が数 ms〜十数 ms の間 細かく ON/OFF を繰り返します(チャタリング, バウンス)。何もしないと、1 回の押下で ISR が何回も呼ばれ、短押しイベントが複数発生します。

flowchart LR
  A["押す"] --> B["接点が数 ms<br/>ON/OFF を繰り返す"] --> C["安定して ON"]

このサンプルでは、直前に受け付けたエッジから 30 ms 以内のエッジは無視する という簡単な方法をとっています。ハードウェアで RC フィルタを入れる方法もあります。

5.2.3 ISR で守るべきこと

してはいけないこと 理由
delay()、長いループ ISR の間はほかの割り込みや全タスクが止まる。BLE の通信タイミングも乱れる
Serial.print() 内部で待ちやバッファ操作がある。ISR から呼ぶとハングすることがある
I²C / SPI 通信(センサの読み取り) 通信に時間がかかり、ライブラリが割り込みを使っていることもある
FreeRTOS の通常版 API ISR からは ...FromISR 版だけを使う(event_post() が使い分けている)

ISR では「何が起きたか」をイベントとして積むだけ にし、処理はメインループのハンドラで行うのが原則です。

5.2.4 volatile

static volatile uint32_t s_pressed_at = 0;

ISR とメインの処理の両方から読み書きする変数には volatile を付けます。付けないと、コンパイラが「この変数は途中で変わらない」と仮定して、レジスタに置いた古い値を使い続ける最適化をすることがあります。

ノートvolatile だけでは足りない場合

volatile は「毎回メモリから読み書きする」ことを保証するだけで、複数の変数をまとめて一貫性を保つ(読んでいる途中で ISR に書き換えられない)ことは保証しません。複数の値を受け渡したいときは、このサンプルのように イベントのペイロードにコピーしてキューで渡す のが安全です。

5.3 割り込みの遅延実行(ISR_DEFERRED)

Adafruit nRF52 コアの attachInterrupt() には、ISR_DEFERRED というフラグがあります。

attachInterrupt(digitalPinToInterrupt(BUTTON_PIN), button_isr, CHANGE | ISR_DEFERRED);

これを付けると、コールバックは ISR の中ではなく 後でタスクの中から 呼ばれます。ISR の制約を気にせずに済みますが、呼ばれるまでに遅れが生じます。このサンプルでは、ISR で行う処理が短いので使っていません。

5.4 演習

  1. BUTTON_DEBOUNCE_MS を 0 にして、短押しを何回か試そう。シリアルモニタで、1 回の押下で複数回測定が始まる・止まる様子が見られるか?(スイッチによっては見られないこともある)
  2. 今の実装では、長押しは 離したときに 判定される。押し続けて 1 秒たった時点で 長押しイベントを出すにはどうすればよいか考えよう

押した時点で ワンショットのタイマー(1 秒後に 1 回だけ呼ばれる)を開始し、

  • タイマーが満了したとき、まだ押されていれば EVT_BUTTON_LONG を積む(長押し確定フラグを立てる)
  • 離したとき、長押し確定フラグが立っていなければ EVT_BUTTON_SHORT を積み、タイマーを止める

とします。FreeRTOS のソフトウェアタイマーは SoftwareTimer::begin(ms, cb, nullptr, false)(最後の引数 false = 繰り返さない)でワンショットにできます。ただし、ISR からタイマーを開始するには xTimerStartFromISR() を使う必要があります。

5.5 System OFF からのボタン復帰(参考)

nRF52840 の最も深い省電力モード System OFF では、ほとんどの回路が止まり、ピンの SENSE 機能(指定したレベルを検出すると起動)でのみ復帰できます。

nrf_gpio_cfg_sense_input(digitalPinToPinName(BUTTON_PIN),
                         NRF_GPIO_PIN_PULLUP, NRF_GPIO_PIN_SENSE_LOW);
NRF_POWER->SYSTEMOFF = 1;  // ここで眠る。ボタンを押すとリセットされ、setup() から再開

System OFF から復帰すると リセットと同じ扱い になり、RAM の内容は失われ、setup() から始まります。長時間使わないときの「電源 OFF」として使えます。