4  状態遷移テーブル

4.1 状態の定義

#ifndef APP_STATE_H
#define APP_STATE_H

#include <Arduino.h>

// 状態。状態遷移テーブルの「行」になる
enum State : uint8_t
{
  STATE_WAIT, // 待機
  STATE_MEAS, // 測定中
  STATE_MAX,
};

inline const char *state_name(State s)
{
  switch (s)
  {
  case STATE_WAIT: return "WAIT";
  case STATE_MEAS: return "MEAS";
  default: return "UNKNOWN";
  }
}

#endif // APP_STATE_H

EventId と同じく、末尾の STATE_MAX が状態の数になります。

4.2 ハンドラの型とテーブル

#ifndef APP_HANDLER_H
#define APP_HANDLER_H

#include "app_event.h"
#include "app_state.h"

// ハンドラ: イベントを受け取り、次の状態を返す
typedef State (*EventHandler)(const Event &ev);

// 状態遷移テーブル [状態][イベント]。nullptr は「この状態ではそのイベントを無視する」
extern const EventHandler handler_table[STATE_MAX][EVT_MAX];

// テーブルを引いてハンドラを呼び、次の状態を返す
State dispatch(State current, const Event &ev);

// 各状態のハンドラ
State wait_on_button_short(const Event &ev);
State wait_on_meas_start(const Event &ev);
State wait_on_get_info(const Event &ev);
State wait_on_get_latest(const Event &ev);
State wait_on_timer_100ms(const Event &ev);

State meas_on_button_long(const Event &ev);
State meas_on_meas_stop(const Event &ev);
State meas_on_get_info(const Event &ev);
State meas_on_get_latest(const Event &ev);
State meas_on_timer_100ms(const Event &ev);
State meas_on_timer_1s(const Event &ev);
State meas_on_disconnected(const Event &ev);

#endif // APP_HANDLER_H

4.2.1 関数ポインタ

typedef State (*EventHandler)(const Event &ev);

は、「const Event & を受け取って State を返す関数」への ポインタ型 に EventHandler という名前を付けています。関数ポインタを使うと、呼び出す関数を実行時に(表を引いて)選べます。

4.2.2 テーブル本体と dispatch

#include "app_handler.h"

// 状態遷移テーブル
// 行 = 現在の状態、列 = イベント。書かなかった要素は nullptr(無視)になる。
// [STATE_WAIT] = {...} の書き方(配列の指示付き初期化子)は C の機能で、
// C++ では GCC の拡張として使える(要素の順番を enum の順に並べること)。
const EventHandler handler_table[STATE_MAX][EVT_MAX] = {
    [STATE_WAIT] = {
        [EVT_NOP] = nullptr,
        [EVT_BUTTON_SHORT] = wait_on_button_short,
        [EVT_BUTTON_LONG] = nullptr,
        [EVT_TIMER_100MS] = wait_on_timer_100ms,
        [EVT_TIMER_1S] = nullptr,
        [EVT_BLE_CONNECTED] = nullptr,
        [EVT_BLE_DISCONNECTED] = nullptr,
        [EVT_BLE_CMD_GET_INFO] = wait_on_get_info,
        [EVT_BLE_CMD_MEAS_START] = wait_on_meas_start,
        [EVT_BLE_CMD_MEAS_STOP] = nullptr,
        [EVT_BLE_CMD_GET_LATEST] = wait_on_get_latest,
    },
    [STATE_MEAS] = {
        [EVT_NOP] = nullptr,
        [EVT_BUTTON_SHORT] = nullptr,
        [EVT_BUTTON_LONG] = meas_on_button_long,
        [EVT_TIMER_100MS] = meas_on_timer_100ms,
        [EVT_TIMER_1S] = meas_on_timer_1s,
        [EVT_BLE_CONNECTED] = nullptr,
        [EVT_BLE_DISCONNECTED] = meas_on_disconnected,
        [EVT_BLE_CMD_GET_INFO] = meas_on_get_info,
        [EVT_BLE_CMD_MEAS_START] = nullptr,
        [EVT_BLE_CMD_MEAS_STOP] = meas_on_meas_stop,
        [EVT_BLE_CMD_GET_LATEST] = meas_on_get_latest,
    },
};

State dispatch(State current, const Event &ev)
{
  // ガード: 範囲外の状態・イベントでテーブルの外を読まない
  if (current >= STATE_MAX || ev.id >= EVT_MAX)
    return current;

  EventHandler h = handler_table[current][ev.id];
  if (h == nullptr)
    return current; // この状態では無視するイベント

  return h(ev);
}
  • テーブルは [STATE_MAX][EVT_MAX] の 2 次元配列。行が状態、列がイベント
  • dispatch() は、範囲チェック(ガード)→ 表を引く → nullptr なら無視 → ハンドラを呼んで次の状態を返す
  • ハンドラは 次の状態を戻り値で返す。状態を書き換えるのは loop() の 1 か所だけなので、「どこで状態が変わったのか」を探す必要がない
ノート指示付き初期化子 [STATE_WAIT] = {...}

配列の要素を添字で指定して初期化する書き方は C99 の機能で、C++ の標準にはありません。GCC は拡張として受け付けますが、要素を enum の順番どおりに並べる必要 があります(順番を入れ替えると sorry, unimplemented: non-trivial designated initializers not supported というエラーになる)。

この書き方の利点は、どのセルにどのハンドラが入っているかが読める ことです。添字を書かずに並べる方法もありますが、イベントを 1 つ追加したときに列がずれても気づけません。

4.3 ハンドラの実装

4.3.1 待機状態

#include "app_meas.h"
#include "app_handler.h"
#include "drv_imu.h"

// ===== 待機状態 (STATE_WAIT) のハンドラ =====

State wait_on_button_short(const Event &ev)
{
  Serial.println("[WAIT] button short -> start measurement");
  meas_begin();
  return STATE_MEAS;
}

State wait_on_meas_start(const Event &ev)
{
  Serial.println("[WAIT] BLE cmd -> start measurement");
  meas_begin();
  return STATE_MEAS;
}

State wait_on_get_info(const Event &ev)
{
  reply_info();
  return STATE_WAIT;
}

State wait_on_get_latest(const Event &ev)
{
  reply_latest();
  return STATE_WAIT;
}

State wait_on_timer_100ms(const Event &ev)
{
  // 待機中も最新値だけは更新しておく(GET_LATEST に答えるため)
  g_latest_acc_mg = imu_read_magnitude_mg();
  return STATE_WAIT;
}

4.3.2 測定状態

#include "app_meas.h"
#include "app_event.h"
#include "app_handler.h"
#include "drv_imu.h"

// ===== 測定状態 (STATE_MEAS) のハンドラ =====

State meas_on_button_long(const Event &ev)
{
  Serial.println("[MEAS] button long -> stop");
  return STATE_WAIT;
}

State meas_on_meas_stop(const Event &ev)
{
  Serial.println("[MEAS] BLE cmd -> stop");
  return STATE_WAIT;
}

State meas_on_get_info(const Event &ev)
{
  reply_info(); // 待機状態と同じ処理は共通関数にまとめる
  return STATE_MEAS;
}

State meas_on_get_latest(const Event &ev)
{
  reply_latest();
  return STATE_MEAS;
}

State meas_on_timer_100ms(const Event &ev)
{
  uint16_t v = imu_read_magnitude_mg();
  g_latest_acc_mg = v;
  meas_add_sample(v);
  return STATE_MEAS;
}

State meas_on_timer_1s(const Event &ev)
{
  MeasSummary s = meas_close_second();
  notify_summary(s);
  Serial.printf("[MEAS] seq=%u n=%u mean=%umg max=%umg dropped=%lu\n",
                s.seq, s.n, s.mean_mg, s.max_mg, (unsigned long)event_dropped_count());
  return STATE_MEAS;
}

State meas_on_disconnected(const Event &ev)
{
  // 切断されても測定は続ける(BLE はデータの出口にすぎない)
  Serial.println("[MEAS] disconnected, keep measuring");
  return STATE_MEAS;
}

ハンドラの書き方のルール:

  1. 短く終わらせる(delay() や長いループを書かない)
  2. 次の状態を返す。状態を変えないなら現在の状態を返す
  3. 同じ処理は共通関数に まとめる(reply_info() など)。テーブルのセルごとに関数があるので、放っておくとコピペが増えやすい

4.4 新しい状態を追加する(演習)

「キャリブレーション状態」を追加してみましょう。

仕様:

  • 待機中に 長押し すると CALIB 状態に入る
  • CALIB 状態では 100 ms ごとに加速度を読み、3 秒間(30 サンプル)の平均 を求める
  • 30 サンプルたまったら、平均値をシリアルに表示して WAIT に戻る
  • CALIB 中のボタン・BLE コマンドは無視する(GET_INFO だけは応答する)

手順:

  1. app_state.h の enum State に STATE_CALIB を追加(STATE_MAX の前)
  2. 状態遷移表を 先に紙に書く(どのイベントで何をするか)
  3. ハンドラ calib_on_timer_100ms などを書く
  4. handler_table に [STATE_CALIB] = {...} の行を追加
  5. handler_table の [STATE_WAIT] 行の [EVT_BUTTON_LONG] を、CALIB に入るハンドラにする
  6. state_name() と、main.cpp の ui_update() に CALIB の表示を追加(例: 赤と緑を同時に点けると黄色)
// app_handler_calib.cpp
#include "app_handler.h"
#include "app_meas.h"
#include "drv_imu.h"

static uint8_t s_count = 0;
static uint32_t s_sum = 0;

State wait_on_button_long(const Event &ev)
{
  s_count = 0;
  s_sum = 0;
  Serial.println("[WAIT] button long -> calibration");
  return STATE_CALIB;
}

State calib_on_timer_100ms(const Event &ev)
{
  s_sum += imu_read_magnitude_mg();
  if (++s_count < 30)
    return STATE_CALIB;
  Serial.printf("[CALIB] mean = %lu mg\n", (unsigned long)(s_sum / s_count));
  return STATE_WAIT;
}

State calib_on_get_info(const Event &ev)
{
  reply_info();
  return STATE_CALIB;
}

テーブルの CALIB の行は、EVT_TIMER_100MS と EVT_BLE_CMD_GET_INFO 以外をすべて nullptr にします。「ほかのイベントは無視する」という仕様が、表の上で一目でわかる ことを確認しましょう。

4.5 状態に入るとき・出るときの処理

「状態に入るときに必ず行う処理」(エントリ動作)がある場合、遷移元の数だけハンドラに同じコードを書く ことになりがちです(サンプルでは meas_begin() を 2 か所で呼んでいる)。

規模が大きくなったら、loop() で状態の変化を検出して、エントリ関数のテーブル を呼ぶ方法があります。

typedef void (*StateAction)();
const StateAction on_enter[STATE_MAX] = {
    [STATE_WAIT] = nullptr,
    [STATE_MEAS] = meas_begin,
};

void loop()
{
  Event ev = event_wait();
  State next = dispatch(s_state, ev);
  if (next != s_state && on_enter[next] != nullptr)
    on_enter[next]();
  s_state = next;
  ui_update(s_state);
}