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_HEventId と同じく、末尾の 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_H4.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;
}ハンドラの書き方のルール:
- 短く終わらせる(
delay()や長いループを書かない) - 次の状態を返す。状態を変えないなら現在の状態を返す
- 同じ処理は共通関数に まとめる(
reply_info()など)。テーブルのセルごとに関数があるので、放っておくとコピペが増えやすい
4.4 新しい状態を追加する(演習)
「キャリブレーション状態」を追加してみましょう。
仕様:
- 待機中に 長押し すると CALIB 状態に入る
- CALIB 状態では 100 ms ごとに加速度を読み、3 秒間(30 サンプル)の平均 を求める
- 30 サンプルたまったら、平均値をシリアルに表示して WAIT に戻る
- CALIB 中のボタン・BLE コマンドは無視する(GET_INFO だけは応答する)
手順:
app_state.hのenum StateにSTATE_CALIBを追加(STATE_MAXの前)- 状態遷移表を 先に紙に書く(どのイベントで何をするか)
- ハンドラ
calib_on_timer_100msなどを書く handler_tableに[STATE_CALIB] = {...}の行を追加handler_tableの[STATE_WAIT]行の[EVT_BUTTON_LONG]を、CALIB に入るハンドラにする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);
}