TWELITE STAGE APP

• 1: TWELITE STAGE APP マニュアル
• 1.1: パッケージの取得
• 1.2: 使用方法
• 1.2.1: キーとマウスの操作
• 1.2.2: 画面の操作
• 1.2.2.1: シリアルポート選択
• 1.2.2.2: メインメニュー
• 1.2.2.2.1: ビューア
• 1.2.2.2.1.1: ターミナル
• 1.2.2.2.1.2: 標準アプリ ビューア
• 1.2.2.2.1.3: グラフ
• 1.2.2.2.1.3.1: 加速度リアルタイムグラフ
• 1.2.2.2.1.3.2: センサーグラフ
• 1.2.2.2.1.4: 簡易モニタ
• 1.2.2.2.1.4.1: CUE ビューア
• 1.2.2.2.1.4.2: ARIA ビューア
• 1.2.2.2.1.4.3: グランサー
• 1.2.2.2.1.5: コマンダー
• 1.2.2.2.2: アプリ書換
• 1.2.2.2.2.1: BINから選択
• 1.2.2.2.2.2: actビルド&書換
• 1.2.2.2.2.3: TWELITE APPSビルド&書換
• 1.2.2.2.2.4: Act_extras
• 1.2.2.2.2.5: 指定
• 1.2.2.2.2.6: 再書換
• 1.2.2.2.2.7: ビルド・書換画面
• 1.2.2.2.3: インタラクティブモード
• 1.2.2.2.4: TWELITE STAGE の設定
• 1.2.2.2.5: シリアルポートの選択
• 1.2.3: ログ機能
• 1.3: 詳細な仕様
• 1.3.1: コマンドライン引数とiniファイルによる詳細設定
• 1.3.2: 環境変数
• 1.3.3: 000desc.txt によるプロジェクト説明の追加
• 1.4: ライセンス
• 1.5: 改訂履歴

1 - TWELITE STAGE APP マニュアル

様々なプラットフォームで動作します。

• Windows10
• macOS (High Sierra 以降、Intel および Apple Silicon Mac に対応)
• Linux (Ubuntu18.04)
• Raspberry Pi (Raspberry Pi 3 Model B, Lcd Touch Screen, Raspberry Pi OS August-2020)
• (M5stack : バージョン1.0 まで対応。v1.3以降はソースレベルで非対応です。)

※ プラットフォームによって、動作条件や配布形式、また機能が異なります。

本資料について

• 対象のプラットフォームを示すため、一部のページでは以下を記載しています。
  • Windows   – Windows 10
  • macOS   – Mac OS X, OS X, macOS
  • Linux   – Ubuntuなど（64bit）
  • RasPi   – Raspberry Pi

1.1 - パッケージの取得

最新版のTWELITE STAGE アプリは、以下のいずれかの方法で取得できます。

TWELITE STAGE SDK 全体（公式サイト）

モノワイヤレス公式サイトでは、TWELITE STAGE アプリを含む開発ツール一式（Windows/macOS/Linux用）を配布しています。

TWELITE STAGE-トワイライトステージ - MONO-WIRELESS.COM

TWELITE STAGE アプリのみ（GitHub）

モノワイヤレス公式リポジトリでは、TWELITE STAGE アプリ単体のバイナリを配布しています。 TWELITE STAGE アプリだけを更新する場合や、M5Stack版を取得する際にはこちらをご利用ください。 各バイナリのバージョンはGitHub上のtagから識別できます。

Windows

monowireless/TWELITE_Stage_BIN_Win: Binary Distribution of TWELITE Stage.

macOS

monowireless/TWELITE_Stage_BIN_macOS: Binary distribution of TWELITE Stage for macOS

Linux

Linux 版のバイナリは個別に配布しておりません。 バイナリは TWELITE STAGE SDK パッケージから取得してください。 もしくは、ソースコードからビルドしてください。

Raspberry Pi

Raspberry Pi 版のバイナリは個別に配布しておりません。 バイナリは TWELITE STAGE SDK パッケージから取得してください。 もしくは、ソースコードからビルドしてください。

M5Stack

バージョン 1.0.3a までを以下のページで配布しております。

monowireless/TWELITE_STAGE_Bin_M5Stack

ソースコード (MWM5ライブラリ)

TWELITE STAGE のソースコードを含む MWM5 ライブラリは以下のページで公開しています。

monowireless/mwm5

TWELITE STAGE アプリのソースコードは、examples/TWELITE_Stageに配置しています。

1.2 - 使用方法

アプリの起動方法

TWELITE STAGE アプリを起動するには、{MWSTAGE インストール} にある実行形式を実行します。

実行はプラットフォーム(Windows, macOS, Linux)によって方法が異なります。

アプリの実行形式

TWELITE STAGE APP には、2種類の実行形式があります。

• TWELITE_Stage.{拡張子} - 標準設定で起動します。
• TWELITE_Stage_VSCode.{拡張子} - 「VSCode を使う」設定済みです(設定はTWELITE_Stage_VSCode.iniに保存)。VSCodeを使う設定を有効にすると、VSCodeを用いた開発作業に適した動作を行うようになります。

アプリの実行画面

アプリを起動すると、以下の２種類のウィンドウが表示されます。

• メイン画面
  • TWELITE STAGE APPのユーザインタフェースを表示します。
  • TWELITE STAGE APPの操作はこの中で行います。
• コマンド画面
  • 通常は使用しませんが、補助情報を表示します。
    • シリアル通信の内容が表示されるため、ログを確認する用途に最適です。
    • コマンドラインから実行した場合には、実行元のターミナルがコマンド画面となります。

アプリの終了

いずれかの方法で終了してください。

• 実行画面上の右上にマウスポインタを移動し、画面内に表示された終了ボタンを押します。
• 実行画面のウインドウを閉じます（macOSの場合は⌘Qも使用できます）。

1.2.1 - キーとマウスの操作

Windows   macOS   Linux   RasPi

キー操作

Windows   macOS   Linux   RasPi

Alt(⌘)を押しながら行うキー入力は、TWELITE STAGE APP の設定を変える操作等に割り当てられています。その他のキー操作は、通常は文字入力として機能します。

共通のキー

Windows   macOS   Linux   RasPi

ヘルプ画面

Windows   macOS   Linux   RasPi

Alt(⌘)を押し続けることでヘルプ画面を表示します。ヘルプ画面ではAlt(⌘)と一緒に操作できるキーの説明や一部動作状況を表示します。

ヘルプ画面は画面の左上部分にマウスポインタを移動することでも表示できます。

Alt(⌘)+操作

Windows   macOS   Linux   RasPi

Alt(⌘)を押しながら行う操作について解説します。

表中ではAlt(⌘)+の表記は省略しています。上記のヘルプ画面から使用可能なキーを確認できますが、下表に補足説明を示します。

その他の操作

マウス操作

Windows   macOS   Linux   RasPi

マウス操作は左クリックが中心ですが、右クリック、右ダブルクリック、ホイールを使う場合があります。

マウスによるA,B,Cボタン

Windows   macOS   Linux   RasPi

画面下部のメニュー表示にマウスポインタを移動すると、[ A ], [ B ], [ C ] という表記のボタンが表示されます。 TWELITE STAGE APPは、この3つ並びのハードウェアボタンを模したメニューに画面ごとの機能を割り当てています。 このボタンを左クリックまたは左長押しクリックすることで、機能を呼び出しできます。（Alt(⌘)+a,s,d`` または Alt(⌘)+Shift+a,s,d`でも選択可能）

マウスによる画面操作

Windows   macOS   Linux   RasPi

Windows/macOS/Linuxでは、TWELITE STAGE APP の画面を原則文字列のみで構成しますが、メニューやボタン、タブについてはマウスによる操作が可能です。

画面はテキストのみの構成ですが、画面上部のタブや、反転表示の文字はマウスの左クリックで選択可能です。

1.2.2 - 画面の操作

Windows   macOS   Linux   RasPi

Windows / macOS / Linux / Raspberry Pi

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

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

Raspberry Pi (nox)

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

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

1.2.2.1 - シリアルポート選択

Windows   macOS   Linux   RasPi

概要

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

Windows

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

Raspberry Pi

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

1.2.2.2 - メインメニュー

Windows   macOS   Linux   RasPi

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

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

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

1.2.2.2.1 - ビューア

Windows   macOS   Linux   RasPi

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

1.2.2.2.1.1 - ターミナル

Windows   macOS   Linux   RasPi

概要

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

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

操作

1.2.2.2.1.2 - 標準アプリ ビューア

Windows   macOS   Linux   RasPi

概要

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

操作

1.2.2.2.1.3 - グラフ

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

1.2.2.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 です。

追加情報

1.2.2.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

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

1.2.2.2.1.4 - 簡易モニタ

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

1.2.2.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)です。

画面の表示例

1.2.2.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)です。

湿度(%)

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

磁石

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

1.2.2.2.1.4.3 - グランサー

Windows   macOS   Linux   RasPi

概要

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

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

操作

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

一覧表示

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

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

選択表示

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

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

1.2.2.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・チャネルを設定した上で、通信相手からメッセージが受信されていることを確認します。

画面下部の表示

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

1.2.2.2.2 - アプリ書換

Windows   macOS   Linux   RasPi

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

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

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

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

1.2.2.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
       ...

1.2.2.2.2.2 - actビルド&書換

Windows   macOS   Linux   RasPi

概要

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

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

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

操作

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

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

ビルド～書き込み画面

1.2.2.2.2.3 - TWELITE APPSビルド&書換

Windows   macOS   Linux   RasPi

概要

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

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

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

操作

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

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

ビルド～書き込み画面

1.2.2.2.2.4 - Act_extras

Windows   macOS   Linux   RasPi

概要

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

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

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

操作

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

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

ビルド～書き込み画面

1.2.2.2.2.5 - 指定

Windows   macOS   Linux  

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

1.2.2.2.2.6 - 再書換

Windows   macOS   Linux   RasPi  

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

1.2.2.2.2.7 - ビルド・書換画面

Windows   macOS   Linux   RasPi  

ビルド中

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

ビルドエラー

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

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

書換中

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

書換失敗

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

書換完了

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

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

Windows   macOS   Linux   RasPi

概要

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

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

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

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

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

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

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

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

1.2.2.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バイト）をエミュレートします。

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

Windows   macOS   Linux   RasPi

概要

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

1.2.3 - ログ機能

Windows   macOS   Linux   RasPi

操作

記録開始

Alt(⌘)+L を押します。

記録終了

記録中に再度 Alt(⌘)+L キーを押します。

ログの記録が終了し、その時点のログファイルをOS標準の方法（Windowsはメモ帳、macOSはコンソール.app）で開きます。

仕様

ログの記録

TWELITE から受信した文字列は、そのまま記録されます。

TWELITE に送信した文字列は、１文字ずつ記録されます。 Windowsの場合は ｢ ｣、 macOS / Linux / RaspBerryPi は « » で囲われます。 例えば«t»とある場合は、キーボードからtを入力したことを意味します。

ログ記録のフォルダとファイル名

{TWELITE STAGE APP の実行形式のあるフォルダ}/log にログ開始時の日時を元にしたファイル名で保存されます。

Alt(⌘)+Shift+L を押すことで、そのフォルダを開きます。

1.3 - 詳細な仕様

1.3.1 - コマンドライン引数とiniファイルによる詳細設定

コマンドライン引数

コマンドライン引数は、TWELITE STAGE APPのいくつかの細かい設定を行います。

iniファイル

iniファイルはTWELITE STAGE APPの基本的な設定(MWSDKのフォルダを参照するなど)を行うために使用されます。

iniファイル名は{TWELITE STAGE APPの実行ファイルのベース名} + .ini です。 通常は TWELITE_Stage.ini となります。

;;; MWSDKの参照を変更します。
; MWSDK=MWSDK
mwsdk=mwsdk2020_10

;;; インターフェース言語
; LANG=en

;;; ウィンドウのジオメトリ
GEOM_X=200
GEOM_Y=100

シンタックス

• ini ファイルはプレーンテキストファイルとして記述される。
• キーと値は = で区切られた1行に格納される (例: KEY=value)。
• キーと値の文字列は行頭から始まる(キーの前に空白や他の文字は許されない)。
• キーと値の間にスペースを入れてはならない。
• コメント行は ; または # を行頭に追加する。

設定

異なる設定の TWELITE STAGE APP を実行する

異なる設定の TWELITE STAGE APP が必要な場合は、TWELITE STAGE APPと同じフォルダに実行ファイルをコピーして、同じ名前の .ini ファイルを作成します。

例えば、英語のインターフェースを使用する場合、TWELITE_Stage.exe(注: .exe はWindowsの実行ファイルの拡張子)を TWELITE_Stage_en.exe にコピーして、 LANG=en の設定を TWELITE_Stage_en.ini に書き込むことで、英語のインターフェースを有効化した実行ファイルを作成できます。

  TWELITE_Stage.exe
  TWELITE_Stage.ini | 特別な設定なし

  TWELITE_Stage_ja.exe | TWELITE_Stage.exe のコピー
  TWELITE_Stage_en.ini | LANG=en が設定されている。

1.3.2 - 環境変数

内部的に設定される環境変数

参考

.vscode/settings.json の設定例（抜粋）

    "C_Cpp.default.includePath": [
        "${env:MWSDK_TWENET_LIBSRC}/include/**",
        "${env:MWSDK_TWENET_LIBSRC}/src/**"
    ],
    "C_Cpp.default.browse.path": [
        "${env:MWSDK_TWENET_LIBSRC}/include/**",
        "${env:MWSDK_TWENET_LIBSRC}/src/**"
    ],

"../../"で始まる定義は、TWELITE STAGEアプリからプロジェクトを開く場合は不要です。環境変数MWSDK_TWENET_LIBSRCを設定しない場合に、既定のフォルダ構成の時にソース参照先を指定しています。

1.3.3 - 000desc.txt によるプロジェクト説明の追加

プロジェクトフォルダに000desc.txtを作成した場合には、TWELITE STAGE APP が、プロジェクトフォルダの一覧にその内容を表示します。

ファイルは UTF-8 形式のプレーンテキストで記述します。書式は以下の２種類があります。

書式1

スイッチを押した時にLEDを点灯
act4はTWELITE DIPに接続されたスイッチを押した時にLEDを点灯させるactを動作させます。
https://mono-wireless.com/jp/products/act/index.html

• 1行目はタイトル行です。
• 2行目以降は詳細の記述です。
• 最終行が http で始まる場合は、ウェブサイトへのリンクになります。

書式2

[JAPANESE]
TITLE=actのテンプレート
DESC=中身が何もない setup(), loop() のみのファイルです。
新しく act を記述するのに利用してください。
URL=jp/MWX/content/Act_samples/README.html
[ENGLISH]
TITLE=act empty template
DESC=This act file only contains empty setup() and loop(),
which is intended to write a new act.
URL=en/MWX/content/Act_samples/README.html

iniファイルのような書式です。行頭から始まる項目名と=文字までを項目の定義として=以降が項目の内容です。

URL 指定について

1.4 - ライセンス

モノワイヤレス 株式会社が配布するTWELITE_Stageの実行形式は MW-SLA-1J,1E が適用されます。

利用したオープンソース成果物

高品質なソースコードを提供いただいたオープンソースプロジェクトに感謝いたします。

1.5 - 改訂履歴

ソースコードの変更履歴は https://mwm5.twelite.info/changes および https://github.com/monowireless/mwm5 を参照してください。

プラットフォームによっては、配布中の最新バージョンと改訂履歴の最新バージョンが一致しない場合があります。

1.3.8 MWSTAGE2022_08収録版

メジャーバージョンアップ。

• 内部描画解像度を320x240から640x480ピクセルに変更
• 加速度センサーのリアルタイムグラフの追加
• センサーデータの保存とグラフ表示を行うセンサーグラフを追加
• 英語表示に対応
• 主要マニュアルをローカルhtmlファイルに変更

1.0.8 MWSTAGE2021_09収録版

• [ A ] [ B ] [ C ]ボタンで、ポインタから外れたボタンが残ってしまう場合があった
• STAGE APPでEnter入力の際にTWELITEに対してCRLFを送信するようにした
• MacのFTDIライブラリを更新しApple Silicon(M1)でもシリアル仲介プログラムを利用しなくても、動作できるようになった
• Windowsでmsysツール群のPATHを内部設定し、期待しないmakeが呼び出されないようにした
• TWELITE未接続でも書き込み画面に移動できるようにした(B,Rキーを入力し、対象のTWELITEモデルを指定する)
• VSCodeを利用する設定を行った場合は、actやTweAppsを選択したときに、ビルドを実行せず、build/以下の.binファイルを書き込む画面を開くようにした。（ビルドはVSCodeから実施します）
• いくつかの環境変数を内部的に設定し、TWELITE STAGEから起動したVSCodeにこれらを参照させることで、VSCodeから適切なビルドを実行、VSCodeのコード解釈に対して適切なライブラリソースを参照できるようにした
• MWSDKフォルダ以下にサンプルコードが格納されているが、ビルド対象のフォルダをドロップすることで、MWSDK以外のフォルダでもビルドや書き込み作業をできるようにした（フォルダ名に空白や日本語文字などが含まれてはいけません）
• 始動時のコンソール画面に、内部のフォルダ設定や環境変数の設定内容を表示するようにした
• 終了時は１秒待ってからSTAGE APPを終了するようにした

1.0.7pre2

• Raspberry Pi の対応を強化 (1.0.7pre2)
  • serial0 の対応（TWELITE STAGE HAT)
  • Zero 向けビルドを追加(対応ライブラリでビルド＆描画フェード機能を無効化)
  • X11 デスクトップ向けビルドを追加
• 一般のFTDIデバイス(FT232,FT230)でも利用できるようにした。ファームウェア書き込みモードは手動で行う必要があります
• Windowsで、シリアルポート選択画面でcキーを押すことでWindowsで割り当てられているCOMポートを表示する機能を追加した
• ボーレートを115200bpsから変更できるようにした
• 描画フェード機能を無効にするコマンドラインオプション(-E 0)を追加。

1.0.3 MWSTAGE2020_12収録版

• TWELITE CUE対応（パーサー・CUEビューア）
• 書換メニューで、書き込み時にベリファイ（比較）を行うようにした。
• Apple Silicon暫定対応（TWELITE_Stage.command はユニバーサルアプリ、シリアル処理用の外部コマンドsersrv_ftdi.command、Toolsは Rosetta2 で動作可能な intel バイナリを再ビルド、シリアル通信は外部コマンド経由のため遅くなります)
• フォルダ構成で MWSTAGE/MWSDK/Tools を MWSTAGE/Toolsに移動した。(MWSDKをMWSDK_COMMONレポジトリをそのまま利用できるようにするため)
• TWELITE_Stage.ini (起動ファイル名から拡張子を取り除き .ini を付加) を、起動時に読み込みMWSDKフォルダを選択できるようにした。(古い版のライブラリ一式を簡単に切り替えられるようにした)
• 画面描画用のSDL2ライブラリを 2.0.12 に変更した (Windows, MacOS, RaspberryPi)。
• Windows では static ビルドとして DLL ファイル不要とした。
• make -j による並列ビルド数を(物理CPU数 - 1)とした。
• 書換メニューのいくつかの場所で、シリアルポートの再オープンを明示的に行うようにした。デバイスの抜き差しを行ったときなどにUSB接続が切断した場合などに、復帰しやすいようにした。
• Alt(Cmd)+Shift+m, t で mwx, twesettings を開くとき TWENET/usever.mk 記載のフォルダを
• 　開くようにした。
• [Raspberry Pi] 初回起動時に /dev/serial0 での書込メニュー遷移が失敗する問題を修正。

既知の問題

• 起動時にAlt(Cmd)押し下げ時のヘルプメッセージが出現しない場合がある。Alt(Cmd)+0を入力することで表示されます。
• 書換メニューでファイル名が長すぎる場合に、行の行事が乱れる場合がある。
• Apple Siliconでの動作については十分な検証を行っていません。

0.9.11 MWSTAGE2020_10, Raspberry Pi 版 (暫定版)

(※包括的な検証を実施しないバージョンです)

• Raspberry Pi での動作
• その他、機能調整

0.9.9 - MWSTAGE2020_10収録版

• 最上位メニューにも [ｳｪﾌﾞ] ボタンを追加し、関連リンクをブラウザで開けるようにした。
• Linux版のフォルダ、ウェブ、VS Code で開く機能を実装した。
• TWELITE が頻繁に UART 出力している場合に、書き込みメニューへ遷移しづらいことがあった

0.9.8a

https://github.com/monowireless/TWELITE_STAGE_Bin_M5Stack/releases/tag/0.9.8a

M5Stack版で MW-SLA-1J,E / MW-OSSLA-1J,E のデュアルライセンスとし、readme-j.txt を更新した。

0.9.8

ビューア一覧表示に[ｳｪﾌﾞ]ボタンを追加し、関連サイトを開く機能を追加など。

改定内容

• ビューア＞コマンダーの追加
  • 標準アプリ 0x80 コマンド
  • NOTICE PALのLED制御 (App_Wingsにコマンドを送付)
• ビューア＞PALビューアのNOTICE PAL対応。
• Act_extrasのメニューを追加
  • Act_samplesより高度なもの
  • 外部のオープンソースライブラリ（センサー手続きなど）を利用したもの
• マウスによる操作を拡大 (リスト、ボタン、タブ)
  • マウス移動でフォーカス、左クリックで確定、右クリックは[ESC]キー入力
• 画面表示負荷の低減
  • アプリケーションがバックグラウンドの時はスクリーンセーバーを無効にした
  • アプリケーションがバックグラウンドの時は、描画回数を減らして CPU 負荷を減らした
• ビルドプロジェクト(act, TWE_Apps, Act_extras)の一覧の機能強化
  • 項目選択時に下部に概要を表示 (000desc.txtを読み込む。TWE_Descクラスにより処理)
  • プロジェクトフォルダを開く（またはVSCodeで開く)機能
  • 関連ウェブサイトを開く機能
  • ALt+Shift+m mwxライブラリ、Alt+Shift+t twesettingsライブラリを開く機能
  • ビルドメニュー中で選択中のフォルダやビルドエラーファイルを開けるようにした。
• ログ（シリアルポート入出力）機能の追加
  • (Alt/Cmd+L)でログの開始・終了
  • ログファイルを {TWELITE_Stage 実行形式のあるフォルダ}/log に格納
  • ファイル名は twestage_{日付-時刻}.log
  • Shift+Alt/Cmd+L でログファイルフォルダを開く
• その他、変更・修正など
  • シリアル(FTDI)デバイス名、IDの表示方法を変更
  • App_UARTでインタラクティブモードに遷移しなかった問題を修正
  • フォルダドロップ時の挙動を変更した (これまではバイナリ書き込みになる場合があったが、メニュー遷移とした)
  • ターミナル長押し時[C]でリセットに加え、画面クリアするようにした。

既知の問題

• M5Stack で設定を保存するときにハングアップし、設定内容が初期化される場合があります。

0.8.9

2020_05 リリース版

• ウインドウアイコンの追加
• BINファイル一覧画面での最大リスト数の制約を緩和 (win/linux/mac)
• Glancerビューアの追加
• 解説文面等の調整
• コンソール画面の描画の調整
• ファーム書き込み後の移動先画面(インタラクティブモードかターミナルか）の設定が動作していなかった
• Alt(or Cmd)+W の割り当てを変更
• その他不具合の修正

0.8.6

Linux 版リリース初版

0.8.5

リリース初版