画面の操作

• 1: シリアルポート選択
• 2: メインメニュー
• 2.1: ビューア
• 2.1.1: ターミナル
• 2.1.2: 標準アプリ ビューア
• 2.1.3: グラフ
• 2.1.3.1: 加速度リアルタイムグラフ
• 2.1.3.2: センサーグラフ
• 2.1.4: 簡易モニタ
• 2.1.4.1: CUE ビューア
• 2.1.4.2: ARIA ビューア
• 2.1.4.3: グランサー
• 2.1.5: コマンダー
• 2.2: アプリ書換
• 2.2.1: BINから選択
• 2.2.2: actビルド&書換
• 2.2.3: TWELITE APPSビルド&書換
• 2.2.4: Act_extras
• 2.2.5: 指定
• 2.2.6: 再書換
• 2.2.7: ビルド・書換画面
• 2.3: インタラクティブモード
• 2.4: TWELITE STAGE の設定
• 2.5: シリアルポートの選択

Windows   macOS   Linux   RasPi

Windows / macOS / Linux / Raspberry Pi

TWELITE STAGE APPはコンソール画面（コマンドライン）から起動するアプリケーションです。コンソール画面とウインドウ画面の両方に情報を出力します。

コンソール画面には、ターミナルと同様にUART出力を表示します。

一部の環境でコンソール画面の入力を受け付ることがありますが、確認済みの正式機能という位置づけではありません。

Raspberry Pi (nox)

X11 を使わず、フレームバッファに表示します。

通常（フレームバッファ上のシェル画面から起動した場合）はコンソール画面を表示しません。

1 - シリアルポート選択

Windows   macOS   Linux   RasPi

概要

Windows / macOS / Linux では、始動時にTWELITEが接続されたシリアルポートを選択する画面を表示します。 ただし、シリアルポートは、あとから接続することもできます。

Windows

cキーを押すと、リストで反転中のシリアルポートのCOMポート名が表示されます。

Raspberry Pi

Raspberry Pi ではUSBデバイスに加えて/dev/serial0 /dev/serial1があれば serial0, serial1 を表示します。なお、通常はserial0を使用します。

2 - メインメニュー

Windows   macOS   Linux   RasPi

階層化されたメニューの最上位に位置します。

この画面では、メニュー選択を行います。メニューを反転すると、下部緑色文字部分に簡易的な解説を表示します。

• ビューア : TWELITE から受信した電文を解釈して表示するビューアです。多くの場合、受信側の TWELITE には App_Wings を書き込んでおきます。
• アプリ書き換え : ファームウェアをビルドし、接続した TWELITE に書き込みます。
• インタラクティブモード : 接続した TWELITE 設定を、インタラクティブモードによって行います。
• TWELITE STAGEの設定 : TWELITE STAGE アプリの各種設定を行います。
• シリアルポートの選択 : シリアルポートを選択します。
• 説明書 : 説明書を表示するメニューです。以下の説明書をブラウザで開きます。
  • TWELITE STAGE アプリ（この文書）
  • MWX ライブラリ
  • TWENET_C ライブラリ

2.1 - ビューア

Windows   macOS   Linux   RasPi

ビューアは、接続した TWELITE から受信した情報を表示したり、コマンドを送ったりするための機能です。

2.1.1 - ターミナル

Windows   macOS   Linux   RasPi

概要

一般的なVT100系のシリアルターミナルです。

TWELITE のインタラクティブモードやリセット制御をサポートしています。

操作

2.1.2 - 標準アプリ ビューア

Windows   macOS   Linux   RasPi

概要

通信相手の TWELITE には App_Twelite（標準アプリ）を書き込んでおきます。標準アプリのボタンやアナログ入力の状態のメッセージ (0x81メッセージ) を受信すると、その内容を mwm5 のパーサーライブラリにより解釈して表示します。

操作

2.1.3 - グラフ

• 加速度リアルタイムグラフ：加速度センサーのパケットをリアルタイムで表示します。周波数領域の表示や CSV ファイルの保存ができます。
• センサーグラフ：TWELITE 各種センサーのデータを sqlite3 データベースに保存し、グラフを表示します。

2.1.3.1 - 加速度リアルタイムグラフ

Windows   macOS   Linux   RasPi

概要

TWELITE CUE や TWELITE 動作センサーPAL から受信したパケットを参照します。加速度データをリアルタイムで表示できるほか、周波数解析や CSV 出力の機能があります。

CUE モード、MOTモード、2525 FIFO モードの３種類に対応しています。

連続したサンプルが一定数(解析窓)以上になると、XYZ軸を周波数解析した表示を行います。ただし 2525 FIFO モードでは常に連続していると仮定します。

パケットの区切りが明示的である場合（直前のパケットから３秒以上経過したとき、CUEモードは１パケットごと、MOTモードはパケットのシーケンス番号が不連続になった場合）には、４サンプル分のダミーデータを挿入しピンク色の背景色を表示します。

先着順に最大４ノードまでのデータを格納します。

操作

サンプルレートの推定

サンプリングレートは、パケットの受信時間から計算しています。過去複数サンプルの受信時間を平均して１サンプル分としているため、パケットの飛びなどがある場合は誤差が大きくなります。 また、関連するログ記録のタイムスタンプ(T_SMPL)も同様に推測値であり、パケット取得時と比較して遅れたタイムスタンプになります。 なお、サンプルレートの推定が終わると、グラフ表示のスクロールをスムーズにします。

CUEグラフモードの起動時に開く

[STAGE 共通設定→起動アプリ指定]にて31を指定してください。

ログ出力（表示データ保存）

(c)表示データ保存 ボタンを押すことで、画面上の表示位置（右端サンプル）を起点とした最大 512 サンプル分のデータを出力できます。

ログファイル名は {logフォルダ}/acc_snap_{タイムスタンプ}.csv です。

• データは、画面右端の一番新しいサンプルが 512 番目（ファイルの末尾）です。
• 周波数解析実行時は、最後のサンプルから 周波数解析サンプル数分が対象です。
• 周波数解析対象サンプルが記録されている行に周波数解析結果を追加しています（64 サンプルの場合は 449 番目から 32 行が結果で DC 成分から高周波成分までが並びます）。

追加情報

ログ出力（自動保存）

加速度リアルタイムグラフ画面を開き、データが入力された時点から自動的にログファイルを出力します。

ログファイル名は logフォルダ/accel_{シリアル番号}_{タイムスタンプ}.csv です。

追加情報

2.1.3.2 - センサーグラフ

Windows   macOS   Linux   RasPi

概要

各種センサーデータを SQLite データベースに記録し、画面上にグラフ形式で表示します。データベースファイルは外部のアプリケーションから参照することも可能です。

• データベースには SQLite (sqlite3) を使用しており、{MW_STAGE Install}/log/{実行形式名}_WSns.sqlite というファイルに格納されます。
• 画面遷移は [一覧(グラフプレビューあり)]>[24時間データ] >[ライブビュー]です。
  • [24時間データ] から更に [年] [月] [日(グラフプレビューあり)] 選択画面に遷移できます。
• [ライブ]表示画面について
  • 一覧から特定のノードを選択します。
  • １秒おきのリアルタイム表示を行い、過去 450 秒間のデータを表示します。
• [24時間データ] 表示画面について
  • 特定の日のデータを表示します。
  • １秒おきの更新とし、その間に複数のデータがあった場合は間引かれます。
  • 最大拡大時（１ピクセル１秒）以外は、各ピクセルの範囲における取得値の平均を表示します。
  • 値が画面よりはみ出す場合は、上下端に測定点を表示します。
  • 現在時刻が含まれる場合には、新着データで表示を更新します。
  • マウスホイールやカーソルキー↑ ↓の入力：時間軸の拡大・縮小
  • マウスポインタの移動：マウスポインタに対応した時間軸にある取得データを簡易表示します。
    • カーソルキー→ ←：隣の取得データに移動します。
  • マウスクリック&ドラッグ：スクロール（拡大時のみ）
  • 拡大時はスクロールバーによる操作も可能です。
  • [CSV出力] 機能では、データベースに含まれるすべての取得値を表示します。

操作

センサーノードのメモ（補助情報）の編集

「24時間データ画面」で、画面右上のセンサーノードのメモ部分を左クリックすると、メモを編集するためのプロンプトを使用できます。

画面遷移

基本の画面は一覧、24時間、ライブの3種類に分けられます。

[一覧] <--> [24時間] <--> [ライブ]
              ↓↑
          [年月日選択]

センサーグラフモードの起動時に開く

[STAGE 共通設定 → 起動アプリ指定] にて 32 を指定してください。

DBのテーブルについて

sensor_data

受信したデータを格納します。

sensor_node

センサーノードにテキストメモ（付加情報）を格納します。

sensor_last

最後に受信したタイムスタンプを管理します。

2.1.4 - 簡易モニタ

• CUEビューア : TWELITE CUE からのパケットを解釈して簡易表示します
• ARIAビューア : TWELITE ARIA からのパケットを解釈して簡易表示します
• Glancer : TWELITE の多くの形式に対応した簡易モニタです

2.1.4.1 - CUE ビューア

Windows   macOS   Linux   RasPi

概要

TWELITE CUE から受信したメッセージを解釈して表示します。

TWELITE CUE の動作

工場出荷時の TWELITE CUE は、TWELITE CUEモードに設定されています。

TWELITE CUEモードでは、コイン電池で駆動できるように間欠駆動をしながら、いくつかの要因によってスリープから起床して、様々なデータを送信します。

起床要因

TWELITE CUE がスリープから起床するには、以下のうちいずれかの要因を必要とします。

• タイマーによる起床（定期的な起床）
• 加速度の検出による起床
• 磁気センサーによる起床（磁石が近づいたことを検出した場合）

送信するデータの種類

TWELITE CUE は、以下のデータをパケットに収めて送信します。

• 検出イベント（後述）
• モジュール電源電圧
• 磁気センサーの検出値
• 加速度データ

パケットの属性

受信したパケットの属性からは、その基本情報を得ることができます。

イベント

TWELITE CUEモードでは、必ず加速度イベントを出力します。 起床要因に関わらず、起床後には一定サンプル数の加速度を計測します。このとき、加速度の計測結果に応じてイベントを判定します。

電圧

モジュールの電源電圧[mV]です。

磁石

検出された磁石の極または未検出を表示します。

加速度

起床後に計測された加速度を表示します。

• サンプル：加速度のサンプル数を表示しています。10サンプル固定です。
• レートID：加速度のサンプルレートです。04固定で100Hzです。
• X,Y,Z：３つの軸の加速度です。８サンプル分の平均値として求めています。単位はミリG (1000mG=1G=9.8m/s2)です。

画面の表示例

2.1.4.2 - ARIA ビューア

Windows   macOS   Linux   RasPi

概要

TWELITE ARIA から受信したメッセージを解釈して表示します。

TWELITE ARIA の動作

工場出荷時の TWELITE ARIA は、TWELITE ARIAモードに設定されています。

TWELITE ARIAモードでは、コイン電池で駆動できるように間欠駆動をしながら、いくつかの要因によってスリープから起床して、様々なデータを送信します。

起床要因

TWELITE ARIA がスリープから起床するには、以下のうちいずれかの要因を必要とします。

• タイマーによる起床（定期的な起床）
• 磁気センサーによる起床（磁石が近づいたことを検出した場合）

送信するデータの種類

TWELITE ARIA は、以下のデータをパケットに収めて送信します。

• モジュール電源電圧
• 磁気センサーの検出値
• 温湿度データ

パケットの属性

受信したパケットの属性からは、その基本情報を得ることができます。

温湿度データ表

TWELITE ARIAから受信した過去9回分のデータの履歴を表示します。最新のデータが最上部に表示されます。

時間[s]

TWELITE STAGE APPが起動してからデータを受信するまでの時間[秒]です。

ID

モジュールの論理デバイスIDです。

VCC(mV)

モジュールの電源電圧[mV]です。

温度(C)

モジュールが計測した温度(°C)です。

湿度(%)

モジュールが計測した湿度(％)です。

磁石

検出された磁石の極または未検出を表示します。

2.1.4.3 - グランサー

Windows   macOS   Linux   RasPi

概要

Glancer は、受信メッセージ中の情報を簡易的に表示します。

接続する TWELITE には App_Wings を書き込んでおくことで、通信相手のTWELITE (App_Twelite, TWELITE PAL, … アプリケーションIDと周波数チャネルを一致させれば混在も可) から受信した情報を表示できます。

操作

一覧表示の画面と選択表示の画面を切り替えて使用します。

一覧表示

通信相手からの情報を列挙します。

表示内容は（メッセージの種別、論理デバイスID、シリアルID、LQI (Lq)、電源電圧（情報に含まれている場合）、タイムスタンプ）です。

選択表示

一覧表示で項目を移動し反転表示になったところで選択操作を行うことで、この画面に遷移します。特定の通信相手に関する情報を到着順に表示します。

選択されてからの受信パケット数と LQI の平均値が表示されます。

2.1.5 - コマンダー

Windows   macOS   Linux   RasPi

概要

コマンダーは、TWELITE にシリアルメッセージを送信する機能です。

操作

コマンダーの最初の画面は留意事項について記載しています。

画面上部にはテキストで表現されたタブがあり、これをマウスでクリックすることでタブ中の画面に移動できます。

タブ：TWELITE

この画面では、 標準アプリ（App_Twelite） の 0x80コマンドを生成し、送信します。

接続する TWELITE には App_Twelite または 親機・中継機アプリ（App_Wings） を書き込んでおき、アプリケーションID・チャネルを設定した上で、通信相手からメッセージが受信されていることを確認してください。

タブ：NOTICE

この画面では、通知PAL（NOTICE PAL） の LED制御コマンド を生成します。

接続する TWELITE には App_Wings を書き込んでおき、アプリケーションID・チャネルを設定した上で、通信相手からメッセージが受信されていることを確認します。

画面下部の表示

画面下部には、コマンドが生成されたタイムスタンプと :で始まるコマンドが表示されます。クリップボードにはこの画面の内容がコピーされます。

2.2 - アプリ書換

Windows   macOS   Linux   RasPi

アプリ書換機能では、TWELITE のアプリ（ファームウェア）を書き込むことができます。

• ビルド済みの.BINファイルを書き込む
• アクト（act）などのソースファイルからビルドして書き込む

ソースファイルのビルド、ターミナル切断、書き込みユーティリティ起動、ターミナル接続といった煩雑さを解消できます。

• TWELITE を自動で認識する
• 書き込み終了後にリセットしてからインタラクティブモードまたはターミナルに遷移する
• 各プロジェクトのリストから、プロジェクトフォルダまたはVSCode等の環境を起動する （Raspberry Pi版を除く）
• 各プロジェクトのリストから、関連情報のウェブページを開く （Linux版、Raspberry Pi版を除く）

2.2.1 - BINから選択

Windows   macOS   Linux   RasPi

概要

ビルド済みのアプリ（.BINファイル）を書き込むことができます。

メニューを選択すると、.BINファイルの一覧が表示されます。書き込むファームウェアを選択してください。

あらかじめ用意されている.BINファイルとは別のファイルを使用する際は、メニューを選択する前に書き込むファイルを以下に格納してください。

BINフォルダには、ファイル名を変更せずに TWELITE STAGE でビルドした .BINファイル（各プロジェクトのbuildフォルダ以下に格納されています）を格納してください。

../BIN/App_Wings_MONOSTICK_BLUE_L1304_V1-1-3.bin
       App_Wings_MONOSTICK_RED_L1304_V1-1-3.bin
       App_Twelite_BLUE_L1304_V1-9-1.bin
       App_Twelite_RED_L1304_V1-9-1.bin
       ...

2.2.2 - actビルド&書換

Windows   macOS   Linux   RasPi

概要

MWX ライブラリによって記述されたアクト（act）のビルドと書き換えを行うことができます。

この画面では、以下のパスに配置されたアクトによるプロジェクトの一覧を表示します。

{MWSTAGEインストールフォルダ}/MWSTAGE/Act_samples

操作

一覧から書き込むプロジェクトを選択することで、ビルド～書き込みを行えます。

なお、書き込み終了後に ENTER または[ B ]ボタンを押すことで、TWELITE をリセットしてインタラクティブモード画面（もしくはターミナル画面、要設定）に遷移できます。

ビルド～書き込み画面

2.2.3 - TWELITE APPSビルド&書換

Windows   macOS   Linux   RasPi

概要

TWENET C ライブラリによって記述された TWELITE APPS のビルドと書き換えを行うことができます。

この画面では、以下のパスに配置されたプロジェクトの一覧を表示します。

{MWSTAGEインストールフォルダ}/MWSTAGE/Wks_TweApps

操作

一覧から書き込むプロジェクトを選択することで、ビルド～書き込みを行えます。

なお、書き込み終了後に ENTER または[ B ]ボタンを押すことで、TWELITE をリセットしてインタラクティブモード画面（もしくはターミナル画面、要設定）に遷移できます。

ビルド～書き込み画面

2.2.4 - Act_extras

Windows   macOS   Linux   RasPi

概要

MWX ライブラリによって記述されたアクト（act）のビルドと書き換えを行うことができます。

この画面では、以下のパスに配置されたアクトによるプロジェクトの一覧を表示します。

{MWSTAGEインストールフォルダ}/MWSTAGE/Act_extras

操作

一覧から書き込むプロジェクトを選択することで、ビルド～書き込みを行えます。

なお、書き込み終了後に ENTER または[ B ]ボタンを押すことで、TWELITE をリセットしてインタラクティブモード画面（もしくはターミナル画面、要設定）に遷移できます。

ビルド～書き込み画面

2.2.5 - 指定

Windows   macOS   Linux  

フォルダまたは.BINファイルを TWELITE STAGE APP の画面にドラッグ＆ドロップすることで、特定のプロジェクトを書き込むことができます。 ドロップした対象のビルドや書き込みを行うときに選択します。

2.2.6 - 再書換

Windows   macOS   Linux   RasPi  

直前に書き換え・指定したプロジェクトを再選択します。

2.2.7 - ビルド・書換画面

Windows   macOS   Linux   RasPi  

ビルド中

ビルド（コンパイル）中の画面です。ビルドコマンドの内容は、コンソール画面に出力されます。画面中の ... はビルドしたファイル数、下部の暗い色の表示はビルドしているファイル名です。

ビルドエラー

ビルドエラーが発生した場合は、上記のような画面を表示します。再ビルドの実行やエラーログの表示を行うことができます。また、一定時間でタイムアウトして直前のメニューに戻ります。

画面上のエラーメッセージは、代表的なものだけが表示されます。ビルドが失敗したとき、エラー内容のメッセージが表示されないこともあります。

書換中

ビルドが成功すると、ファームウェアを書き込む画面を表示します。

書換失敗

書換がエラーの場合は、下記のような画面を表示します。

書換完了

書換が無事に成功すると、下記のような画面を表示します。

2.3 - インタラクティブモード

Windows   macOS   Linux   RasPi

概要

この画面から、接続した TWELITE のインタラクティブモードを利用できます。

この画面はターミナルとほぼ同じ振る舞いをしますが、インタラクティブモードに遷移するための操作と離脱の検出を行うなど、インタラクティブモードに固有の機能を追加しています。

• 接続する TWELITE には、インタラクティブモードに対応したファームウェアをあらかじめ書き込んでおく必要があります。
• TWELITE の入出力を使用するため、シリアル通信に文字化けなどが発生した場合など、期待通りにインタラクティブモードへの遷移や離脱ができない場合もあります。
• マウス操作には対応しておりません。キーボード（カーソル ↑ ↓ での操作は可能）操作を行ってください。

インタラクティブモード画面の動作フロー

以下に大まかな処理の流れを記載します。

[画面黒背景にする]
  ↓
[TWELITEのリセット (制御可能ならSET=LO)]
  ↓
<間欠動作アプリのインタラクティブモードメッセージを検出？> --YES--> [操作画面]へ
  ↓タイムアウト
['+' を３回入力]
  ↓
<通常アプリのインタラクティブモードメッセージを検出？> --YES--> [操作画面]へ
  ↓タイムアウト
[操作画面へ] ※ この状態はインタラクティブモードではない

[操作画面]
  ↓
<インタラクティブモード脱出メッセージ?> --> [終了]
  ↓
<画面離脱操作 [ A ] 長押しなど> --> [終了]
  ↓
 -> <入力中判定> --NO-> [終了]
  ↓            ↓
[入力文字列をTWELITEへ送信]
  ↓
[操作画面]へ戻る

[終了]
  ↓
[TWELITEのリセット]
  ↓
[画面離脱] インタラクティブモード画面を終了し前の画面へ戻る

2.4 - TWELITE STAGE の設定

Windows   macOS   Linux   RasPi

概要

この画面から、TWELITE STAGE APP の各種設定を行います。

以下の解説のメニュー中には、プラットフォームによっては存在しない項目がありますが、全てを列挙して解説します。

共通メニュー以外の色設定については、解説を省略します。

ルートメニュー

共通設定
 ターミナル
 標準アプリ ビューア
 グラフ表示 (加速度ﾘｱﾙﾀｲﾑ/ｾﾝｻｰ)
 簡易モニター (CUA/ARIA/Glancer)
 グランサー(簡易モニタ)
 コマンダー
 アプリ書換
 インタラクティブモード
ｾｰﾌﾞﾃﾞｰﾀ ﾕｰﾃｨﾘﾃｨ(ﾀﾞﾝﾌﾟ/消去)
情報

共通設定

a: (      0x00) 起動アプリ指定
G: (      0x00) 画面サイズ・描画方法
F: (          ) シリアルデバイスID
f: (0x00FFFFFF) 文字色
b: (0x005A0032) 背景色
B: (    115200) ボーレート

アプリ書換

f: (0x00FFFFFF) 文字色
b: (0x005A0032) 背景色
j: (         0) ビルド時のmakeジョブ数
v: (         0) codeでフォルダを開く(VSCode)
l: (         0) LTOを行わない
n: (         0) 書換完了後の画面

セーブデータユーティリティ

r: Read sector.
R: Read ALL sectors.
e: Erase sector.
E: Erase ALL sectors.

この画面は、データセーブ領域のメンテナンスを行うユーティリティです。EEPROM（64バイトを1セクタとして最大60セクタ、3840バイト）をエミュレートします。

2.5 - シリアルポートの選択

Windows   macOS   Linux   RasPi

概要

この画面では、シリアルポートを再選択できます。