最適な出力のために、Google Chrome(15以降)または Microsoft Edge(79以降)を推奨いたします。
2024-11-14 現在使用方法
TWELITE STAGE APP の使用方法
TWELITE STAGE APP の画面・操作方法を解説します。
アプリの起動方法
TWELITE STAGE アプリを起動するには、{MWSTAGE インストール}
にある実行形式を実行します。
アップデートなどでTWELITE STAGE アプリの実行形式を差し替える場合には、必ず、指定フォルダ {MWSTAGE インストール} にコピーしてください。 それ以外のパスに実行形式を配置した場合の動作は未定義です。
実行はプラットフォーム(Windows, macOS, Linux)によって方法が異なります。
システム | 拡張子 | 備考 |
---|
Windows | .exe | エクスプローラで実行形式をダブルクリック |
macOS | .command | Finder で実行形式をダブルクリック |
Linux
RasPi | .run | ディストリビューションやインストール環境に依存します。Xウインドウシステム上のターミナル画面(xtermなど)から、コマンドとして実行します |
アプリの実行形式
TWELITE STAGE APP には、2種類の実行形式があります。
- TWELITE_Stage.{拡張子} - 標準設定で起動します。
- TWELITE_Stage_VSCode.{拡張子} - 「VSCode を使う」設定済みです(設定は
TWELITE_Stage_VSCode.ini
に保存)。VSCodeを使う設定を有効にすると、VSCodeを用いた開発作業に適した動作を行うようになります。
TWELITE STAGE APP は複数起動してもエラーになりませんが、複数起動すると不都合のある機能(センサーグラフ機能など)が存在します。
したがって、複数のアプリを同時に起動する際には、実行形式を複製して、別々のファイルを立ち上げる必要があります。 各種設定ファイルや入出力ファイルが分離されるため、互いの干渉を避けることができます。
アプリの実行画面
アプリを起動すると、以下の2種類のウィンドウが表示されます。
- メイン画面
- TWELITE STAGE APPのユーザインタフェースを表示します。
- TWELITE STAGE APPの操作はこの中で行います。
- コマンド画面
- 通常は使用しませんが、補助情報を表示します。
- シリアル通信の内容が表示されるため、ログを確認する用途に最適です。
- コマンドラインから実行した場合には、実行元のターミナルがコマンド画面となります。
アプリの終了
いずれかの方法で終了してください。
- 実行画面上の右上にマウスポインタを移動し、画面内に表示された終了ボタンを押します。
- 実行画面のウインドウを閉じます(macOSの場合は
⌘Q
も使用できます)。
ごくまれに、終了操作をしても実行画面が残る場合があります。その場合には、以下をお試しください。
- TWELTIE STAGE APPのコマンドライン画面を閉じる。
- 強制終了を行う(強制終了の操作方法はお使いのシステムの解説を参照してください)。
1 - キーとマウスの操作
TWELITE STAGE APP に使用するキーとマウスの操作説明
Windows
macOS
Linux
RasPi
TWELITE STAGE APP に使用するキーとマウスの操作を解説します。
キー操作
Windows
macOS
Linux
RasPi
Alt(⌘)
を押しながら行うキー入力は、TWELITE STAGE APP の設定を変える操作等に割り当てられています。その他のキー操作は、通常は文字入力として機能します。
共通のキー
Windows
macOS
Linux
RasPi
キー | 意味 |
---|
ESC ESC | 素早く2回ESC を押す。キャンセル、または前画面に戻る。画面によっては1回の押下で前画面に戻ります。 |
ENTER | 入力、選択 |
BS | 一文字削除 |
カーソルキー↑ ↓ | 項目の選択 |
ヘルプ画面
Windows
macOS
Linux
RasPi
Alt(⌘)
を押し続けることでヘルプ画面を表示します。ヘルプ画面ではAlt(⌘)
と一緒に操作できるキーの説明や一部動作状況を表示します。
ヘルプ画面は画面の左上部分にマウスポインタを移動することでも表示できます。
Alt(⌘)+操作
Windows
macOS
Linux
RasPi
Alt(⌘)
を押しながら行う操作について解説します。
表中ではAlt(⌘)
+の表記は省略しています。上記のヘルプ画面から使用可能なキーを確認できますが、下表に補足説明を示します。
Alt(⌘) +キー | 意味 |
---|
I | + + + を入力します。インタラクティブモードに入るキーシーケンスです。※ スリープによる間欠動作を行うアプリは非対応。 |
R | モジュールをリセットします。TWELITE R や MONOSTICK の機能を用いてリセットピンの制御を行います。 |
A , S , D | A, B, C ボタンを押します。 |
Shift +A , S , D | A, B, C ボタンを長押しします。 |
C | 表示されている画面の文字列をクリップボードにコピーします。(画面によって範囲は異なります) |
V | クリップボードからキーボード入力としてペーストします。 |
F | フルスクリーン表示に遷移します。Shift+Fの場合、可能であればより拡大します。 |
G | 画面の描画方法を変更します。640x480の液晶画面をエミュレートしていますが、拡大時の描画方式として(1. 液晶モニタ風の描画 / 2. ブラウン管風の描画 / 3. ドットを目立たせた拡大 / 4. ドットをぼやかせた拡大)の4種類が選択できます。※ 設定メニューで起動時の設定を変更できます。 |
J | 画面サイズを選択します。選択可能な画面サイズは {640,480}, {1280, 720}, {1280,960}, {1920,1440}, {2560,1440}, {320,240} です。※ 設定メニューで起動時設定にできます。 |
Q | TWELITE STAGE APPを終了します。 |
0 | シリアルポートを切断し、再度シリアルポートの一覧を表示します。 |
1 , 2 , … | シリアルポートを選択します。 |
L , Shift +L | シリアルポートの入出力のログを開始します。終了時にはログファイルが Windows であればメモ帳、macOS であれば ログビューア で開かれます。Shift +L でログ格納フォルダを開きます。 |
その他の操作
キー | 意味 |
---|
Alt(⌘) +Shift +Ctrl +m | MWX ライブラリコードのフォルダを開きます。 |
Alt(⌘) +Shift +l | log フォルダを開きます。 |
マウス操作
Windows
macOS
Linux
RasPi
マウス操作は左クリックが中心ですが、右クリック、右ダブルクリック、ホイールを使う場合があります。
マウス操作 | 意味 |
---|
左クリック | 選択 |
左クリックしながらドラッグ | 画面によっては利用(グラフ画面でのドラッグ) |
左ダブルクリック | 使用しない |
右クリック | 画面によっては使用する |
右ダブルクリック | 画面から脱出する(ESC ESC と同様) |
ホイール | 画面によって利用する(グラフ画面で拡大縮小) |
マウスによる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 の画面を原則文字列のみで構成しますが、メニューやボタン、タブについてはマウスによる操作が可能です。
画面はテキストのみの構成ですが、画面上部のタブや、反転表示の文字はマウスの左クリックで選択可能です。
2 - 画面の操作
TWELITE STAGE APP の各画面における操作説明
Windows
macOS
Linux
RasPi
Windows / macOS / Linux / Raspberry Pi
TWELITE STAGE APPはコンソール画面(コマンドライン)から起動するアプリケーションです。コンソール画面とウインドウ画面の両方に情報を出力します。
コンソール画面には、ターミナルと同様にUART出力を表示します。
一部の環境でコンソール画面の入力を受け付ることがありますが、確認済みの正式機能という位置づけではありません。
Raspberry Pi (nox)
X11 を使わず、フレームバッファに表示します。
通常(フレームバッファ上のシェル画面から起動した場合)はコンソール画面を表示しません。
2.1 - シリアルポート選択
シリアルポート選択画面の操作説明
Windows
macOS
Linux
RasPi
概要
Windows / macOS / Linux では、始動時にTWELITEが接続されたシリアルポートを選択する画面を表示します。 ただし、シリアルポートは、あとから接続することもできます。
TWELITE STAGEアプリでは、シリアルポートの選択と各画面の処理は連携しません。 例えば、シリアルポートの選択をしていない状態で、ビューアを起動しても表示は更新されません。この状態でシリアルポートを選択すると、ビューワの表示が更新されます。
なお、シリアルポートは Alt(⌘)
+0
, 1
, 2
, … のキー操作でいつでも切り替えできます。
Windows
c
キーを押すと、リストで反転中のシリアルポートのCOMポート名が表示されます。
Raspberry Pi
Raspberry Pi ではUSBデバイスに加えて/dev/serial0
/dev/serial1
があれば serial0
, serial1
を表示します。なお、通常はserial0
を使用します。
2.2 - メインメニュー
メインメニュー画面の操作説明
Windows
macOS
Linux
RasPi
階層化されたメニューの最上位に位置します。
この画面では、メニュー選択を行います。メニューを反転すると、下部緑色文字部分に簡易的な解説を表示します。
- ビューア : TWELITE から受信した電文を解釈して表示するビューアです。多くの場合、受信側の TWELITE には App_Wings を書き込んでおきます。
- アプリ書き換え : ファームウェアをビルドし、接続した TWELITE に書き込みます。
- インタラクティブモード : 接続した TWELITE 設定を、インタラクティブモードによって行います。
- TWELITE STAGEの設定 : TWELITE STAGE アプリの各種設定を行います。
- シリアルポートの選択 : シリアルポートを選択します。
- 説明書 : 説明書を表示するメニューです。以下の説明書をブラウザで開きます。
- TWELITE STAGE アプリ(この文書)
- MWX ライブラリ
- TWENET_C ライブラリ
2.2.1 - ビューア
ビューアについて
Windows
macOS
Linux
RasPi
ビューアは、接続した TWELITE から受信した情報を表示したり、コマンドを送ったりするための機能です。
各々のビューアは、比較的小規模なプログラムで mwm5 ライブラリの使用方法のサンプルを兼ねています。
2.2.1.1 - ターミナル
ターミナル画面の操作説明
Windows
macOS
Linux
RasPi
概要
一般的なVT100系のシリアルターミナルです。
TWELITE のインタラクティブモードやリセット制御をサポートしています。
操作
操作 | 説明 |
---|
[ A ] | + + + シーケンスの入力(インタラクティブモード) |
[ A ]長押し | この画面を抜けて、前のメニューに戻ります。 |
[ B ] | 大きなフォントで最初の画面の部分領域を表示します。カーソルが画面中に表示されるように領域を選びますが、画面出力によっては見たい部分が見えない場合もあります。 |
[ B ]長押し | 折返し制御のON/OFFを変更します。標準では折返し表示を行うようになっていますが、折り返ししないように表示することもできます。画面右端以降の文字列は表示されません。 |
[ C ] | ファーム書換画面に移動します。ファームウェアの開発中には頻繁にソースコードの修正、動作確認、ビルド&書き込みを行うため、ショートカットを用意しています。 |
[ C ]長押し | TWELITE のリセットピンを制御し、リセットします。 |
ESC ESC | ESC キーを2回素早く入力することで、この画面を抜けます。※ 殆どの画面ではESC キーを1回押すことで画面から抜ける操作となっていますが、ターミナルではESC キーの単独入力を使用する場合があるため、2回連続入力の割当になっています。 |
2.2.1.2 - 標準アプリ ビューア
標準アプリビューア画面の操作説明
Windows
macOS
Linux
RasPi
概要
通信相手の TWELITE には App_Twelite
(標準アプリ)を書き込んでおきます。標準アプリのボタンやアナログ入力の状態のメッセージ (0x81
メッセージ) を受信すると、その内容を mwm5
のパーサーライブラリにより解釈して表示します。
PC に接続する TWELITE に App_Twelite(標準アプリ) または App_Wings(親機・中継機アプリ)を書き込んでおき、通信相手のTWELITEから受信したデータがターミナルに表示されることを確認してから使用してください。
操作
操作 | 説明 |
---|
[ A ] | 割当なし |
[ A ]長押し | この画面を抜けて、前のメニューに戻ります。 |
[ B ] | フォントを変更します。 |
[ B ]長押し | テスト用のダミーデータによる画面表示を行います。 |
[ C ] | 割当なし |
[ C ]長押し | TWELITE のリセットピンを制御し、リセットします。 |
ESC ESC | ESC キーを入力することで、この画面を抜けます。 |
2.2.1.3 - グラフ
グラフ画面の一覧
- 加速度リアルタイムグラフ:加速度センサーのパケットをリアルタイムで表示します。周波数領域の表示や CSV ファイルの保存ができます。
- センサーグラフ:TWELITE 各種センサーのデータを sqlite3 データベースに保存し、グラフを表示します。
2.2.1.3.1 - 加速度リアルタイムグラフ
加速度リアルタイムグラフ画面の操作説明
Windows
macOS
Linux
RasPi
概要
TWELITE CUE や TWELITE 動作センサーPAL から受信したパケットを参照します。加速度データをリアルタイムで表示できるほか、周波数解析や CSV 出力の機能があります。
加速度リアルタイムグラフでは、各サンプルデータを別々に処理します。
一方、
センサーグラフでは、1パケットに複数サンプルが含まれるような連続計測を行う場合であっても、1パケットを1サンプルとして記録します。
CUE モード、MOTモード、2525 FIFO モードの3種類に対応しています。
連続したサンプルが一定数(解析窓)以上になると、XYZ軸を周波数解析した表示を行います。ただし 2525 FIFO モードでは常に連続していると仮定します。
パケットの区切りが明示的である場合(直前のパケットから3秒以上経過したとき、CUEモードは1パケットごと、MOTモードはパケットのシーケンス番号が不連続になった場合)には、4サンプル分のダミーデータを挿入しピンク色の背景色を表示します。
先着順に最大4ノードまでのデータを格納します。
複数ノード運用時には、互いのパケット衝突により通信の失敗が多くなります。特に FIFO モードでは、送信周期がほぼ一定で互いにほぼ同時期にパケット送信を試み、干渉により送信が失敗するといったことが長時間続く場合があります。原則として無線チャネル1つにつき、1ノードという運用を行ってください。
工場出荷時の TWELITE CUE は TWELITE CUE モードに設定されています。
連続したデータを計測する場合は動作センサーパルモードに変更してください。
加速度リアルタイムグラフを使用する場合における動作センサーパルモードの代表的な設定を以下に記します。
- 連続的に約 25Hz で計測したいとき
t: set Transmission Interval (0)
p: set Sensor Parameter (03000000)
- 連続的に約 50Hz で計測したいとき
t: set Transmission Interval (0)
p: set Sensor Parameter (03000100)
- 連続的に約 100Hz で計測したいとき
t: set Transmission Interval (0)
p: set Sensor Parameter (03000200)
- 約10秒おきに 約 100Hz で128サンプル分計測したいとき
t: set Transmission Interval (10)
p: set Sensor Parameter (03000208)
- 約10秒おきに 約 100Hz で256サンプル分計測したいとき
t: set Transmission Interval (10)
p: set Sensor Parameter (03000210)
- 約10秒おきに 約 50Hz で64サンプル分計測したいとき
t: set Transmission Interval (10)
p: set Sensor Parameter (03000104)
- 約10秒おきに 約 200Hz で128サンプル分計測したいとき
t: set Transmission Interval (10)
p: set Sensor Parameter (03000308)
操作
操作 | 説明 |
---|
右上部(i)ID# ボタン | クリックするごとにIDの切り替えを行います。(注:FIFOモードによる連続サンプルデータは、複数IDによる運用に向きません) |
右上部(f)SMP# ボタン | クリックするごとに解析窓サイズを 64,128,256 と変更します。 |
右下部(c)表示データ保存 ボタン | log フォルダにCSV形式のデータ出力を行います。バッファにある最も古いサンプルから、画面右端の最新のサンプルまでを出力します。(注:出力数は常に 5120 サンプルであり、末尾のデータが最新です) |
右下部PAUSE( ) ボタン | 表示更新を中断します。(注:サンプルの取得は内部の一時サンプルバッファが一杯になるまで行います) |
マウスドラッグ(グラフ部分) | 表示サンプルの位置を移動します。 |
マウスドラッグ(下部スクロールバー) | より大きなステップで表示サンプルの位置を移動します。 |
カーソルキー→ ← | サンプルの表示領域を移動させます。 |
カーソルキー↑ ↓ | サンプルの横軸を拡大・縮小(等倍 / 2倍 / 3倍 / 4倍)します。(注:解析サンプル数 256 の場合は2倍まで) |
サンプルレートの推定
サンプリングレートは、パケットの受信時間から計算しています。過去複数サンプルの受信時間を平均して1サンプル分としているため、パケットの飛びなどがある場合は誤差が大きくなります。
また、関連するログ記録のタイムスタンプ(T_SMPL
)も同様に推測値であり、パケット取得時と比較して遅れたタイムスタンプになります。
なお、サンプルレートの推定が終わると、グラフ表示のスクロールをスムーズにします。
CUEグラフモードの起動時に開く
[STAGE 共通設定→起動アプリ指定]にて31
を指定してください。
ログ出力(表示データ保存)
(c)表示データ保存
ボタンを押すことで、画面上の表示位置(右端サンプル)を起点とした最大 512 サンプル分のデータを出力できます。
最新のサンプルが末尾に記録されるため、冒頭には何もデータが無い場合がある点に注意してください。
ログファイル名は {logフォルダ}/acc_snap_{タイムスタンプ}.csv
です。
- データは、画面右端の一番新しいサンプルが 512 番目(ファイルの末尾)です。
- 周波数解析実行時は、最後のサンプルから 周波数解析サンプル数分が対象です。
- 周波数解析対象サンプルが記録されている行に周波数解析結果を追加しています(64 サンプルの場合は 449 番目から 32 行が結果で DC 成分から高周波成分までが並びます)。
ラベル | 項目名 | 説明 |
---|
# | サンプル番号 | |
T_PKT[ms] | パケット受信時刻 | 1パケットに複数のサンプルが含まれるため、同じタイムスタンプのサンプルが並びます。 |
SEQ | パケット続き番号 | 各パケットに付与されており、連続していればパケットの欠落がないと考えられます。 |
T_SMPL[ms] | サンプル時刻(仮想・推定) | パケットの受信時刻から生成した各サンプルのタイムスタンプです。実際にサンプルが行われた時刻とは一致しません。(注:サンプルレートをパケット受信間隔から推定しているため誤差が大きくなるほか、サンプル周期を都度加算しているため実際のサンプル時刻よりも1パケット周期分遅れたタイムスタンプを記録します) |
X[G] | X軸のサンプル値 | 単位はG です。センサーの値に基づいています。 |
Y[G] | Y軸のサンプル値 | 単位はG です。センサーの値に基づいています。 |
Z[G] | Z軸のサンプル値 | 単位はG です。センサーの値に基づいています。 |
FD# | 周波数解析計算値の番号 | 周波数解析サンプル数が 64 の場合は DC,1,2,...,31 の順で並びます。 |
Hz | 周波数解析計算結果の周波数軸の値 | 推定の周波数です。(FD# / FD_Len) * FD_Freq のように計算しています。 |
X | X軸の周波数解析計算値 | |
Y | Y軸の周波数解析計算値 | |
Z | Z軸の周波数解析計算値 | |
Label | 追加情報名 | 下表参照 |
Info | 追加情報 | 下表参照 |
追加情報
情報名 | 解説 |
---|
ModuleSID | 送信側のシリアル番号 |
Tick[ms] | ログファイルを開いたときのシステム時間(注:TWELITE STAGEアプリ側) |
Date | ログファイルを開いたときの日付 |
Time | ログファイルを開いたときの時刻 |
Time_Msec_part | ログファイルを開いたときの秒未満部分 [ms] |
Samples | 有効サンプルデータ |
FD_Len | 周波数解析サンプル数 |
FD_Start# | 周波数解析開始サンプル番号 |
FD_Freq | 周波数解析範囲の周波数推定値[Hz](注:サンプル受信間隔からの推定) |
ログ出力(自動保存)
加速度リアルタイムグラフ画面を開き、データが入力された時点から自動的にログファイルを出力します。
ログファイル名は logフォルダ/accel_{シリアル番号}_{タイムスタンプ}.csv
です。
画面を開いている間はファイルの書き出しを行うため、その間には読み出し用に開けない、またはすべてのデータが読み出せない場合があります。
ラベル | 項目名 | 説明 |
---|
# | サンプル番号 | |
T_PKT[ms] | パケット受信時刻 | 1パケットに複数のサンプルが含まれるため、同じタイムスタンプのサンプルが並びます。 |
SEQ | パケット続き番号 | 各パケットに付与されており、連続していればパケットの欠落がないと考えられます。 |
T_SMPL[ms] | サンプル時刻(仮想・推定) | パケットの受信時刻から生成した各サンプルのタイムスタンプです。実際にサンプルが行われた時刻とは一致しません。(注:サンプルレートをパケット受信間隔から推定しているため誤差が大きくなるほか、サンプル周期を都度加算しているため実際のサンプル時刻よりも1パケット周期分遅れたタイムスタンプを記録します) |
X[G] | X軸のサンプル値 | 単位はG です。センサーの値に基づいています。 |
Y[G] | Y軸のサンプル値 | 単位はG です。センサーの値に基づいています。 |
Z[G] | Z軸のサンプル値 | 単位はG です。センサーの値に基づいています。 |
Label | 追加情報名 | 下表参照 |
Info | 追加情報 | 下表参照 |
追加情報
情報名 | 解説 |
---|
ModuleSID | 送信側のシリアル番号 |
Tick[ms] | ログファイルを開いたときのシステム時間(注:TWELITE STAGEアプリ側) |
Date | ログファイルを開いたときの日付 |
Time | ログファイルを開いたときの時刻 |
Time_Msec_part | ログファイルを開いたときの秒未満部分 [ms] |
2.2.1.3.2 - センサーグラフ
センサーグラフ画面の操作説明
Windows
macOS
Linux
RasPi
概要
各種センサーデータを SQLite データベースに記録し、画面上にグラフ形式で表示します。データベースファイルは外部のアプリケーションから参照することも可能です。
同一実行形式名の TWELITE STAGE APP を複数起動して、センサーグラフを同時に使用することはできません。
データベースファイルは {MWSTAGEインストール}/log
フォルダに格納され、TWELITE STAGE APP の実行形式名をもとにファイル名が決まります。同一の実行形式名である場合は、同じデータベースファイルを参照してしまいます。TWELITE STAGE APP の実装では、複数のアプリが同時に同一のデータベースにデータを追加することを想定していません。また、場合によってはデータベースファイルのアクセスエラーとなり、TWELITE STAGE APP がクラッシュすることもあります。
例えば、MONOSTICK を PC に2台接続して、同時に複数の「センサーグラフ」を動作させたい場合には、別の実行形式名 (TWELITE_Stage_a.exe
, TWELITE_Stage_b.exe
) とした TWELITE STAGE アプリを複数実行します。このときのデータベースファイル名はそれぞれ log/TWELITE_Stage_a_WSns.sqlite
, log/TWELITE_Stage_b_WSns.sqlite
です。
- データベースには SQLite (sqlite3) を使用しており、
{MW_STAGE Install}/log/{実行形式名}_WSns.sqlite
というファイルに格納されます。 - 画面遷移は
[一覧(グラフプレビューあり)]
>[24時間データ]
>[ライブビュー]
です。[24時間データ]
から更に [年]
[月]
[日(グラフプレビューあり)]
選択画面に遷移できます。
[ライブ]
表示画面について- 一覧から特定のノードを選択します。
- 1秒おきのリアルタイム表示を行い、過去 450 秒間のデータを表示します。
[24時間データ]
表示画面について- 特定の日のデータを表示します。
- 1秒おきの更新とし、その間に複数のデータがあった場合は間引かれます。
- 最大拡大時(1ピクセル1秒)以外は、各ピクセルの範囲における取得値の平均を表示します。
- 値が画面よりはみ出す場合は、上下端に測定点を表示します。
- 現在時刻が含まれる場合には、新着データで表示を更新します。
- マウスホイールやカーソルキー
↑
↓
の入力:時間軸の拡大・縮小 - マウスポインタの移動:マウスポインタに対応した時間軸にある取得データを簡易表示します。
- マウスクリック&ドラッグ:スクロール(拡大時のみ)
- 拡大時はスクロールバーによる操作も可能です。
[CSV出力]
機能では、データベースに含まれるすべての取得値を表示します。
操作
操作 | 説明 |
---|
マウスドラッグ(グラフ部分) | 拡大時に表示サンプルの位置を移動します。 |
マウスドラッグ(下部スクロールバー) | 表示サンプルの位置を移動します。 |
カーソルキー→ ← | サンプルの表示領域を移動させます。 |
カーソルキー↑ ↓ | サンプルの横軸を拡大・縮小します。 |
[ライブ] | 1秒刻みで最新のデータを表示するビューに移動します。 |
[24時間データ] | 1日単位のグラフに移動します。 |
[<<一覧] | 一覧選択画面に移動します。 |
[年] [月] [日] | 年月日で、特定の日を選択します。 |
[最新] | 今日のデータに移動します。 |
[CSV出力] | 1日分のデータをCSVファイルに出力します。 |
一覧で[表示] | リストの表示方式を変更します。 |
一覧で[ソート] | リストの並び順を変更します。 |
一覧で[↑] | リストの並び順を反転します。 |
センサーノードのメモ(補助情報)の編集
v1.3.9+「24時間データ画面」で、画面右上のセンサーノードのメモ部分を左クリックすると、メモを編集するためのプロンプトを使用できます。
キー | 説明 |
---|
通常の半角文字 | 通常の半角英数文字列を直接入力した場合は画面上にも表示されます。 |
IME による入力 | IMEからの入力は画面左上部分に入力途上の文字列が表示されます。ENTER キーで入力中の文字列を確定します。 |
BS | 表示されている末尾の文字を削除します。 |
ENTER | 入力した文字列をデータベースに反映します。 |
IME入力時の操作方法は、システム環境に依存する場合があります。
また、IME入力時の操作によっては期待しない文字列が入力される場合があります。不要な文字列が入力エリアに表示された場合は BS
キーで不要部分を削除してください。
画面遷移
基本の画面は一覧、24時間、ライブの3種類に分けられます。
[一覧] <--> [24時間] <--> [ライブ]
↓↑
[年月日選択]
センサーグラフモードの起動時に開く
[STAGE 共通設定 → 起動アプリ指定] にて 32
を指定してください。
DBのテーブルについて
sensor_data
受信したデータを格納します。
カラム名 | 型 | 解説 |
---|
_uqid | INTEGER | データベースで使用する続き番号 |
sid | INTEGERint32_t | int32_t 型で格納しているシリアル番号です。例えば “8123abcd” というシリアル番号の場合は整数値で -2,128,368,691 の値が格納されます。 |
ts | INTEGERint64_t | システムがパケットを受信した時刻で、int64_t 型で格納されるタイムスタンプ値です。UNIX epoch (エポック、1970年からの経過秒) です。 |
ts_msec | INTEGER | タイムスタンプのミリ秒部分です。 |
year | INTEGER | タイムスタンプよりローカル時間の年部分です。 |
month | INTEGER | タイムスタンプよりローカル時間の月部分です。 |
day | INTEGER | タイムスタンプよりローカル時間の日部分です。 |
hour | INTEGER | タイムスタンプよりローカル時間の時部分です。 |
lid | INTEGER | ユーザにより割り当てられた LID などの識別値です。 |
lqi | INTEGER | 受信強度の目安値です (Link Quality Indicator) 。 |
pkt_seq | INTEGER | パケットの続き番号です。どのような値を取りうるのかはファームウェアによって異なります。 |
pkt_type | INTEGER | 無線パケットの種別です。2 PAL AMB 6 ARIA 1 PAL MAG *3 PAL MOT 5 CUE 0x101 App_Twelite *0x103 App_IO *現時点で非対応 |
value | REAL | 計測値です(パケット種別によって定義が異なります)。pkt_type-> 2,6: 温度[°C] 1: 磁石の判定有無 (00->磁石なし, 01->N極, 02->S極) 3,5: X軸加速度(パケット中に複数サンプル含まれる場合は平均値)[G] 0x101,103: 入力IOのビットマップ(val_dioの下位8ビットと同値) |
value1 | REAL | 計測値です(パケット種別によって定義が異なります)。pkt_type-> 2,6: 湿度[%] 1: 未使用 3,5: Y軸加速度(パケット中に複数サンプル含まれる場合は平均値)[G] 0x101: ADC1[V] 103: 未使用 |
value2 | REAL | 計測値です(パケット種別によって定義が異なります)。pkt_type-> 2: 照度[lx] 6: 未使用 1: 未使用 3,5: Z軸加速度(パケット中に複数サンプル含まれる場合は平均値)[G] 0x101: ADC2[V] 103: 未使用 |
value3 | REAL | 計測値です(パケット種別によって定義が異なります)。pkt_type-> 2: 未使用 6: 未使用 1: 未使用 3,5: 未使用 0x101: ADC3[V] 103: 未使用 |
val_vcc_mv | INTEGER | 電源電圧[mV] |
val_dio | INTEGERint32_t | b0..b7 : DI1..DI8 の値 (1 はLOW, 0 はHIGHレベル)b24..b25 : マグネット値 (b28 が1 の場合) 00 ->磁石なし, 01 ->N極, 10 ->S極b28 : 1 の場合マグネットデータがb24..b25 に格納されるb31 : 定期送信ビット(マグネットのみ) |
val_adc1_mv | INTEGER | pkt_type-> 1,2,3,0x101 : ADC1の計測値 |
val_adc2_mv | INTEGER | pkt_type-> 0x101 : ADC4の計測値 |
val_aux | INTEGER | その他データ格納目的 |
ev_src | INTEGER | イベント発生元 |
ev_id | INTEGER | イベントIDpal_type-> 5: サイコロ(1...6) 16→MOVE他 資料参照 |
ev_param | INTEGER | イベントパラメータ |
sensor_node
センサーノードにテキストメモ(付加情報)を格納します。
カラム名 | 型 | 解説 |
---|
sid | INTEGER | 上述のSID |
sid_text | TEXT | 可読性のためにSIDを16進数に変換した文字列 |
desc | TEXTUTF-8 | SIDに対応するメモ(補助情報)。一覧などで表示する |
sensor_last
最後に受信したタイムスタンプを管理します。
カラム名 | 型 | 解説 |
---|
sid | INTEGER | 上述のSID |
ts | INTEGER | 最後の受信したときのタイムスタンプ |
lid | | 以下、最後に受信時のデータの抜粋 |
lqi | | |
pkt_type | | |
value | | |
value1 | | |
value2 | | |
value3 | | |
val_vcc_mv | | |
val_dio | | |
ev_id | | |
2.2.1.4 - 簡易モニタ
簡易モニタの一覧
- CUEビューア : TWELITE CUE からのパケットを解釈して簡易表示します
- ARIAビューア : TWELITE ARIA からのパケットを解釈して簡易表示します
- Glancer : TWELITE の多くの形式に対応した簡易モニタです
2.2.1.4.1 - CUE ビューア
CUE ビューア画面の操作説明
Windows
macOS
Linux
RasPi
このページには旧バージョンのキャプチャ画像が含まれます。
概要
TWELITE CUE から受信したメッセージを解釈して表示します。
TWELITE CUE の動作
工場出荷時の TWELITE CUE は、TWELITE CUEモードに設定されています。
TWELITE CUEモードでは、コイン電池で駆動できるように間欠駆動をしながら、いくつかの要因によってスリープから起床して、様々なデータを送信します。
CUEモードは TWELITE CUE の動作確認を想定しているため、搭載するセンサーやLEDのすべてを動作させます。
起床要因
TWELITE CUE がスリープから起床するには、以下のうちいずれかの要因を必要とします。
- タイマーによる起床(定期的な起床)
- 加速度の検出による起床
- 磁気センサーによる起床(磁石が近づいたことを検出した場合)
送信するデータの種類
TWELITE CUE は、以下のデータをパケットに収めて送信します。
- 検出イベント(後述)
- モジュール電源電圧
- 磁気センサーの検出値
- 加速度データ
パケットの属性
受信したパケットの属性からは、その基本情報を得ることができます。
属性 | 解説 |
---|
#???? | これまでの受信パケット数です。 |
種別 | mwm5 ライブラリにおけるE_PKT の値で、パケット種別です。TWELITE CUEからのパケットは通常PKT_PAL=02 です。 |
ID | 送信元の論理IDです。通常は0..100 の値になります。 |
AD | 送信元のシリアル番号です。 |
LQ | 受信強度の目安値です (Link Quality Indicator) 。 |
SQ | パケットの続き番号です。 |
イベント
TWELITE CUEモードでは、必ず加速度イベントを出力します。
起床要因に関わらず、起床後には一定サンプル数の加速度を計測します。このとき、加速度の計測結果に応じてイベントを判定します。
イベント | 番号 | 解説 |
---|
ダイス | 1(0x00) .. 6(0x06) | 定期起床と磁気センサー検出起床を起点に判定します。起床後に大きな加速度が検出される場合は、判定不可としたイベント(0xFF )を検出する場合があります。 |
ムーブ | 16(0x10) | 加速度センサーが一定以上の加速度を検出したときに、ムーブまたはシェイクのイベントが発生します。ムーブは、計測した加速度の変化が比較的小さい場合(加速度の変化は検出したが、連続的な加速度の変化がなかった場合)に発生します。 |
シェイク | 0x08 | 加速度センサーが一定以上の加速度を検出したときに、ムーブまたはシェイクのイベントが発生します。シェイクは、計測した加速度の変化が比較的大きい場合(連続的な加速度の変化を検出した場合)に発生します。 |
加速度のしきい値やイベントの検出条件について、定量的な定義は案内しておりません。
電圧
モジュールの電源電圧[mV]です。
磁石
検出された磁石の極または未検出を表示します。
磁気センサーの検出による起床であるかどうかを表示する機能はありません。
加速度
起床後に計測された加速度を表示します。
- サンプル:加速度のサンプル数を表示しています。10サンプル固定です。
- レートID:加速度のサンプルレートです。04固定で100Hzです。
- X,Y,Z:3つの軸の加速度です。8サンプル分の平均値として求めています。単位はミリG (1000mG=1G=9.8m/s2)です。
画面の表示例
2.2.1.4.2 - ARIA ビューア
ARIA ビューア画面の操作説明
Windows
macOS
Linux
RasPi
このページには旧バージョンのキャプチャ画像が含まれます。
概要
TWELITE ARIA から受信したメッセージを解釈して表示します。
TWELITE ARIA の動作
工場出荷時の TWELITE ARIA は、TWELITE ARIAモードに設定されています。
TWELITE ARIAモードでは、コイン電池で駆動できるように間欠駆動をしながら、いくつかの要因によってスリープから起床して、様々なデータを送信します。
起床要因
TWELITE ARIA がスリープから起床するには、以下のうちいずれかの要因を必要とします。
- タイマーによる起床(定期的な起床)
- 磁気センサーによる起床(磁石が近づいたことを検出した場合)
送信するデータの種類
TWELITE ARIA は、以下のデータをパケットに収めて送信します。
- モジュール電源電圧
- 磁気センサーの検出値
- 温湿度データ
パケットの属性
受信したパケットの属性からは、その基本情報を得ることができます。
属性 | 解説 |
---|
#???? | これまでの受信パケット数です。 |
種別 | mwm5 ライブラリにおけるE_PKT の値で、パケット種別です。TWELITE ARIAからのパケットは通常PKT_PAL=02 です。 |
ID | 送信元の論理IDです。通常は0..100 の値になります。 |
AD | 送信元のシリアル番号です。 |
LQ | 受信強度の目安値です (Link Quality Indicator) 。 |
SQ | パケットの続き番号です。 |
温湿度データ表
TWELITE ARIAから受信した過去9回分のデータの履歴を表示します。最新のデータが最上部に表示されます。
時間[s]
TWELITE STAGE APPが起動してからデータを受信するまでの時間[秒]です。
ID
モジュールの論理デバイスIDです。
VCC(mV)
モジュールの電源電圧[mV]です。
温度(C)
モジュールが計測した温度(°C)です。
湿度(%)
モジュールが計測した湿度(%)です。
磁石
検出された磁石の極または未検出を表示します。
磁気センサーの検出による起床であるかどうかを表示する機能はありません。
2.2.1.4.3 - グランサー
グランサー画面の操作説明
Windows
macOS
Linux
RasPi
概要
Glancer は、受信メッセージ中の情報を簡易的に表示します。
接続する TWELITE には App_Wings
を書き込んでおくことで、通信相手のTWELITE (App_Twelite
, TWELITE PAL, … アプリケーションIDと周波数チャネルを一致させれば混在も可) から受信した情報を表示できます。
Glancer は、glance(=ちらりと見る、一瞥)する人という意味の英単語です。
操作
一覧表示の画面と選択表示の画面を切り替えて使用します。
一覧表示
通信相手からの情報を列挙します。
表示内容は(メッセージの種別、論理デバイスID、シリアルID、LQI (Lq)、電源電圧(情報に含まれている場合)、タイムスタンプ)です。
操作 | 説明 |
---|
[ A ] | リストの前項目に移動します。 |
[ A ]長押し | この画面を抜けて、前メニューに戻ります。 |
[ B ] | 選択表示に移行します。 |
[ B ]長押し | 項目をソートします。ソートを実行するたびに、ソートキーは順に変わります。 |
[ C ] | リストの次項目に移動します。 |
[ C ]長押し | TWELITE のリセットピンを制御し、リセットします。 |
ESC | この画面を抜けます。 |
選択表示
一覧表示で項目を移動し反転表示になったところで選択操作を行うことで、この画面に遷移します。特定の通信相手に関する情報を到着順に表示します。
選択されてからの受信パケット数と LQI の平均値が表示されます。
操作 | 説明 |
---|
[ A ] | 割当なし |
[ A ]長押し | この画面を抜けて、前メニューに戻ります。 |
[ B ] | 割当なし |
[ B ]長押し | 割当なし |
[ C ] | 割当なし |
[ C ]長押し | TWELITE のリセットピンを制御し、リセットします。 |
ESC | 選択画面に戻ります。 |
2.2.1.5 - コマンダー
コマンダー画面の操作説明
Windows
macOS
Linux
RasPi
概要
コマンダーは、TWELITE にシリアルメッセージを送信する機能です。
操作
コマンダーの最初の画面は留意事項について記載しています。
画面上部にはテキストで表現されたタブがあり、これをマウスでクリックすることでタブ中の画面に移動できます。
操作 | 説明 |
---|
[ A ] | タブの移動(左) |
[ A ]長押し | この画面を抜けて、選択画面に戻ります。 |
[ B ] | 割当なし |
[ B ]長押し | 割当なし |
[ C ] | タブの移動(右) |
[ C ]長押し | TWELITE のリセットピンを制御し、リセットします。 |
ESC | この画面を抜けて、選択画面に戻ります。 |
タブ:TWELITE
この画面では、 標準アプリ(App_Twelite) の 0x80コマンドを生成し、送信します。
接続する TWELITE には App_Twelite または 親機・中継機アプリ(App_Wings) を書き込んでおき、アプリケーションID・チャネルを設定した上で、通信相手からメッセージが受信されていることを確認してください。
項目 | 内容 |
---|
宛先 | 送信先の TWELITE を指定します。自身が子機の場合は「親機:0」宛を指定してください。自身が親機の場合は「全子機=0x78」または特定の子機ID(1..8まで指定可能)を指定します。 |
DI1..DI4 | DI1からDI4までの設定状態です。■は選択(LOW=GNDレベル)、□は(HIGH=VCCレベル)を意味します。下項目のSELを指定してください。 |
SEL | 各DIの選択ビットです。(0ならDIの指定を無視し、1なら指定を有効化します。) |
PWM1..4 | PWMのデューティ比を設定します。0はGNDレベル相当、1024(100%)はVCCレベル相当です。N.A.にしたPWMポートは変更しません。(注:MW-STA-KIT-0/MW-STA-SOLO-0基板のPWM1はVCCからの吸い込みとなっているため、 LEDは0のときに最も明るく点灯し、100%で消灯します。) |
各項目を変更するたびにコマンドが生成されます。送信ボタンを押すと、現在の設定のコマンドを再度送信します。
タブ:NOTICE
この画面では、通知PAL(NOTICE PAL) の LED制御コマンド を生成します。
接続する TWELITE には App_Wings を書き込んでおき、アプリケーションID・チャネルを設定した上で、通信相手からメッセージが受信されていることを確認します。
項目 | 内容 |
---|
宛先 | 送信先の TWELITE PAL の ID を指定します。値の範囲は 1..8 です。 |
色 | 点灯色を7色から指定します。白は2種類ありますが、一方はRGBの混色でもう一方は白色LED単体が点灯します。 |
明るさ | 0..15で指定します。0は消灯です。 |
点灯点滅 | 点灯または点滅パターンを選択します。 |
点灯時間 | コマンド発行後、一定時間経過すると自動的に消灯する機能です。 |
消灯(x) | 消灯メッセージを生成し、LEDを消灯させます。 |
点灯(SPACE) | 現在の設定を送信し、LEDを点灯させます。 |
各項目を変更するたびにコマンドが生成されます。送信ボタンを押すと、現在の設定のコマンドを再度送信します。
画面下部の表示
画面下部には、コマンドが生成されたタイムスタンプと :で始まるコマンドが表示されます。クリップボードにはこの画面の内容がコピーされます。
2.2.2 - アプリ書換
アプリ書換の機能について
Windows
macOS
Linux
RasPi
アプリ書換機能では、TWELITE のアプリ(ファームウェア)を書き込むことができます。
- ビルド済みの
.BIN
ファイルを書き込む - アクト(act)などのソースファイルからビルドして書き込む
ソースファイルのビルド、ターミナル切断、書き込みユーティリティ起動、ターミナル接続といった煩雑さを解消できます。
- TWELITE を自動で認識する
- 書き込み終了後にリセットしてからインタラクティブモードまたはターミナルに遷移する
- 各プロジェクトのリストから、プロジェクトフォルダまたはVSCode等の環境を起動する (Raspberry Pi版を除く)
- 各プロジェクトのリストから、関連情報のウェブページを開く (Linux版、Raspberry Pi版を除く)
2.2.2.1 - BINから選択
BINから選択の画面の操作説明
Windows
macOS
Linux
RasPi
概要
ビルド済みのアプリ(.BIN
ファイル)を書き込むことができます。
メニューを選択すると、.BIN
ファイルの一覧が表示されます。書き込むファームウェアを選択してください。
あらかじめ用意されている.BIN
ファイルとは別のファイルを使用する際は、メニューを選択する前に書き込むファイルを以下に格納してください。
プラットフォーム | 場所 |
---|
Windows, macOS, Linux, Raspberry Pi | {MWSTAGEフォルダ}/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
...
この機能では、ファイル名から TWELITE(BLUE/REDなど) の識別を行っています。
2.2.2.2 - actビルド&書換
actビルド&書換の画面の操作説明
Windows
macOS
Linux
RasPi
概要
MWX ライブラリによって記述されたアクト(act)のビルドと書き換えを行うことができます。
この画面では、以下のパスに配置されたアクトによるプロジェクトの一覧を表示します。
{MWSTAGEインストールフォルダ}/MWSTAGE/Act_samples
デフォルトでは、サンプルとしてご利用いただくことを想定した比較的小規模なプロジェクトを収録しています。
操作
一覧から書き込むプロジェクトを選択することで、ビルド~書き込みを行えます。
なお、書き込み終了後に ENTER
または[ B ]ボタンを押すことで、TWELITE をリセットしてインタラクティブモード画面(もしくはターミナル画面、要設定)に遷移できます。
ビルド~書き込み画面
VSCodeを利用する設定(アプリ書換>codeでフォルダを開く)を有効化している場合は、ビルドは行わずに
build/
以下の
.BIN
ファイルを書き込む
画面を開きます。
操作 | 説明 |
---|
[ A ] | メニュー選択↑ |
[ A ]長押し | この画面を抜けて、選択画面に戻ります。 |
[ B ] | 選択 |
[ B ]長押し | 関連ウェブサイトをOS標準のブラウザで開きます。(プロジェクトフォルダの000desc.txt に登録されている場合) |
[ C ] | メニュー選択↓ |
[ C ]長押し | フォルダ(プロジェクト、関連フォルダ)を開きます。設定メニューでVS Codeで開くように設定できます。 |
ESC | この画面を抜けて、アプリ書換メニューに戻ります。 |
マウスクリック[ヘルプ] | 関連ウェブサイトを開きます。 |
マウスクリック[フォルダ] または [VSCode] | 関連フォルダを開きます。 |
マウスクリック [▽] または [△] | 次ページ、前ページに移動します。 |
2.2.2.3 - TWELITE APPSビルド&書換
TWELITE APPSビルド&書換の画面の操作説明
Windows
macOS
Linux
RasPi
概要
TWENET C ライブラリによって記述された TWELITE APPS のビルドと書き換えを行うことができます。
この画面では、以下のパスに配置されたプロジェクトの一覧を表示します。
{MWSTAGEインストールフォルダ}/MWSTAGE/Wks_TweApps
デフォルトでは、そのままご利用いただくことを想定した比較的大規模なプロジェクトを収録しています。
操作
一覧から書き込むプロジェクトを選択することで、ビルド~書き込みを行えます。
なお、書き込み終了後に ENTER
または[ B ]ボタンを押すことで、TWELITE をリセットしてインタラクティブモード画面(もしくはターミナル画面、要設定)に遷移できます。
ビルド~書き込み画面
VSCodeを利用する設定(アプリ書換>codeでフォルダを開く)を有効化している場合は、ビルドは行わずに
build/
以下の
.BIN
ファイルを書き込む
画面を開きます。
操作 | 説明 |
---|
[ A ] | メニュー選択↑ |
[ A ]長押し | この画面を抜けて、選択画面に戻ります。 |
[ B ] | 選択 |
[ B ]長押し | 関連ウェブサイトをOS標準のブラウザで開きます。(プロジェクトフォルダの000desc.txt に登録されている場合) |
[ C ] | メニュー選択↓ |
[ C ]長押し | フォルダ(プロジェクト、関連フォルダ)を開きます。設定メニューでVS Codeで開くように設定できます。 |
ESC | この画面を抜けて、アプリ書換メニューに戻ります。 |
マウスクリック[ヘルプ] | 関連ウェブサイトを開きます。 |
マウスクリック[フォルダ] または [VSCode] | 関連フォルダを開きます。 |
マウスクリック [▽] または [△] | 次ページ、前ページに移動します。 |
2.2.2.4 - Act_extras
Act_extras画面の操作説明
Windows
macOS
Linux
RasPi
概要
MWX ライブラリによって記述されたアクト(act)のビルドと書き換えを行うことができます。
この画面では、以下のパスに配置されたアクトによるプロジェクトの一覧を表示します。
{MWSTAGEインストールフォルダ}/MWSTAGE/Act_extras
actビルド&書換とは異なり、サンプルとしてご利用いただくことを想定した比較的複雑な処理を行うプロジェクトや、外部のオープンソースライブラリを利用したプロジェクトを収録しています。
操作
一覧から書き込むプロジェクトを選択することで、ビルド~書き込みを行えます。
なお、書き込み終了後に ENTER
または[ B ]ボタンを押すことで、TWELITE をリセットしてインタラクティブモード画面(もしくはターミナル画面、要設定)に遷移できます。
ビルド~書き込み画面
VSCodeを利用する設定(アプリ書換>codeでフォルダを開く)を有効化している場合は、ビルドは行わずに
build/
以下の
.BIN
ファイルを書き込む
画面を開きます。
操作 | 説明 |
---|
[ A ] | メニュー選択↑ |
[ A ]長押し | この画面を抜けて、選択画面に戻ります。 |
[ B ] | 選択 |
[ B ]長押し | 関連ウェブサイトをOS標準のブラウザで開きます。(プロジェクトフォルダの000desc.txt に登録されている場合) |
[ C ] | メニュー選択↓ |
[ C ]長押し | フォルダ(プロジェクト、関連フォルダ)を開きます。設定メニューでVS Codeで開くように設定できます。 |
ESC | この画面を抜けて、アプリ書換メニューに戻ります。 |
マウスクリック[ヘルプ] | 関連ウェブサイトを開きます。 |
マウスクリック[フォルダ] または [VSCode] | 関連フォルダを開きます。 |
マウスクリック [▽] または [△] | 次ページ、前ページに移動します。 |
2.2.2.5 - 指定
プロジェクトを指定した書き込み
Windows
macOS
Linux
フォルダまたは.BIN
ファイルを TWELITE STAGE APP の画面にドラッグ&ドロップすることで、特定のプロジェクトを書き込むことができます。 ドロップした対象のビルドや書き込みを行うときに選択します。
.BIN
ファイルをドロップしたときは、そのファイルが格納されるフォルダをドロップした場合と同様に、そのフォルダにあるファームウェアの一覧を表示します。
2.2.2.6 - 再書換
直前に書き込んだプロジェクトの再書き込み
Windows
macOS
Linux
RasPi
直前に書き換え・指定したプロジェクトを再選択します。
項目によって、以下のいずれかを行います。
- 選択したプロジェクトの再書換
- 直前に選択したプロジェクト一覧の再表示
2.2.2.7 - ビルド・書換画面
ビルド・書換画面の操作説明
Windows
macOS
Linux
RasPi
ここでは、プロジェクトのビルドや書換を行うときに表示される画面の操作説明を行います。
ビルド中
ビルド(コンパイル)中の画面です。ビルドコマンドの内容は、コンソール画面に出力されます。画面中の ...
はビルドしたファイル数、下部の暗い色の表示はビルドしているファイル名です。
ビルドエラー
ビルドエラーが発生した場合は、上記のような画面を表示します。再ビルドの実行やエラーログの表示を行うことができます。また、一定時間でタイムアウトして直前のメニューに戻ります。
画面上のエラーメッセージは、代表的なものだけが表示されます。ビルドが失敗したとき、エラー内容のメッセージが表示されないこともあります。
操作 | 説明 |
---|
[ A ] | 割当なし |
[ A ]長押し | この画面を抜けて、前のメニューに戻ります。 |
[ B ] | エラー時に再ビルドします。 |
[ B ]長押し | 割当なし |
[ C ] | |
[ C ]長押し | エラーログを表示します(Windows/macOS)。保存場所は{プロジェクトフォルダ}/build/builderr.log です。 |
ESC | この画面を抜けて、書換メニューに戻ります。 |
ENTER | エラー時に再ビルドします。 |
書換中
ビルドが成功すると、ファームウェアを書き込む画面を表示します。
書換失敗
書換がエラーの場合は、下記のような画面を表示します。
操作 | 説明 |
---|
[ A ]長押し | この画面を抜けて、選択画面に戻ります。 |
[ B ] | 再度書換を行う(直前の書き換えメニューに戻ります。 自動的にメニュー項目が選択されるため、 もう一度[ B ]を押すことで再書換できます) |
ESC | この画面を抜けて、書換メニューに戻ります。 |
書換完了
書換が無事に成功すると、下記のような画面を表示します。
v1.0.2以降では、ファームウェア書き換え後に、書き換え内容を読み出して確認するベリファイ処理を行います。
操作 | 説明 |
---|
[ A ]長押し | この画面を抜けて、選択画面に戻ります。 |
[ B ] | TWELITE をリセットして、インタラクティブモード画面(または設定によりターミナル)画面に移動します。 |
ESC | この画面を抜けて、書換メニューに戻ります。 |
2.2.3 - インタラクティブモード
インタラクティブモードの利用
Windows
macOS
Linux
RasPi
概要
この画面から、接続した TWELITE のインタラクティブモードを利用できます。
この画面はターミナルとほぼ同じ振る舞いをしますが、インタラクティブモードに遷移するための操作と離脱の検出を行うなど、インタラクティブモードに固有の機能を追加しています。
- 接続する TWELITE には、インタラクティブモードに対応したファームウェアをあらかじめ書き込んでおく必要があります。
- TWELITE の入出力を使用するため、シリアル通信に文字化けなどが発生した場合など、期待通りにインタラクティブモードへの遷移や離脱ができない場合もあります。
- マウス操作には対応しておりません。キーボード(カーソル
↑
↓
での操作は可能)操作を行ってください。
ターミナルによるインタラクティブモードへの遷移と操作もできます。
- ターミナルでは、自動的にSETピンの操作を行いません。手動でSETピンをLOに設定する必要があります。
- ターミナルにおいても、
+ + +
入力Alt(⌘)+I
やモジュールリセットAlt(⌘)+R
を行う操作を定義しています。
インタラクティブモード画面の動作フロー
以下に大まかな処理の流れを記載します。
[画面黒背景にする]
↓
[TWELITEのリセット (制御可能ならSET=LO)]
↓
<間欠動作アプリのインタラクティブモードメッセージを検出?> --YES--> [操作画面]へ
↓タイムアウト
['+' を3回入力]
↓
<通常アプリのインタラクティブモードメッセージを検出?> --YES--> [操作画面]へ
↓タイムアウト
[操作画面へ] ※ この状態はインタラクティブモードではない
[操作画面]
↓
<インタラクティブモード脱出メッセージ?> --> [終了]
↓
<画面離脱操作 [ A ] 長押しなど> --> [終了]
↓
-> <入力中判定> --NO-> [終了]
↓ ↓
[入力文字列をTWELITEへ送信]
↓
[操作画面]へ戻る
[終了]
↓
[TWELITEのリセット]
↓
[画面離脱] インタラクティブモード画面を終了し前の画面へ戻る
2.2.4 - TWELITE STAGE の設定
TWELITE STAGE APP の設定
Windows
macOS
Linux
RasPi
概要
この画面から、TWELITE STAGE APP の各種設定を行います。
この画面のメニューはマウス操作できません。
また、画面の色を変更した場合に見づらくなる場合があります。
以下の解説のメニュー中には、プラットフォームによっては存在しない項目がありますが、全てを列挙して解説します。
共通メニュー以外の色設定については、解説を省略します。
ルートメニュー
共通設定
ターミナル
標準アプリ ビューア
グラフ表示 (加速度リアルタイム/センサー)
簡易モニター (CUA/ARIA/Glancer)
グランサー(簡易モニタ)
コマンダー
アプリ書換
インタラクティブモード
セーブデータ ユーティリティ(ダンプ/消去)
情報
共通設定
a: ( 0x00) 起動アプリ指定
G: ( 0x00) 画面サイズ・描画方法
F: ( ) シリアルデバイスID
f: (0x00FFFFFF) 文字色
b: (0x005A0032) 背景色
B: ( 115200) ボーレート
設定 | 内容 |
---|
起動アプリ指定 | TWELITE STAGE始動時にビューアアプリに移動する設定です。設定値は1..{ビューアアプリメニューで列挙されている数} です。注:シリアルデバイスIDを設定しておかないと、始動時に接続するシリアルデバイス選択画面で入力待ちになります。 |
画面サイズ・描画方法 | (M5Stack版を除く)XY の2桁の文字で指定します(X :画面サイズ Y :描画方法)。X 0 :640x480 1 :1280x720 2 :1280x960 3 :1920x1440 4 :2560x1440 5 :320x240Y 0 :LCD風 1 :CRT風 2 :ぼやけ 3 :ブロック |
シリアルデバイスID | (M5Stack版を除く)設定はシリアルデバイス名または数値の1..9 を指定します。注:数値の場合はデバイス列挙順になります。 |
文字色・背景色 | 文字色、背景色を指定します。共通設定の色設定値は他の画面の設定にも継承されます。他の画面で未設定の場合は共通設定の色設定が採用されます。色はRGB 24bitを16進数で指定しますが、内部的には16bit 565形式に値が丸められます。 |
ボーレート | TWELITE 側のボーレートが 115200 ではない場合に、ターミナルなどの表示が化けないように設定します。 |
アプリ書換
f: (0x00FFFFFF) 文字色
b: (0x005A0032) 背景色
j: ( 0) ビルド時のmakeジョブ数
v: ( 0) codeでフォルダを開く(VSCode)
l: ( 0) LTOを行わない
n: ( 0) 書換完了後の画面
設定 | 内容 |
---|
ビルド時のmakeジョブ数 | (M5Stack版を除く)ビルドを行う際の並列ジョブ数です。適切な数を設定することでビルド時間の短縮を期待できます。規定値0 は(物理プロセッサ数-1)でジョブ数を計算しています。目安としては論理プロセッサ数を上限とすると良いでしょう。 |
codeでフォルダを開く (VSCode) | (VSCodeのインストールが必要)1 を設定することでOS標準のフォルダウインドウの代わりにcodeコマンド(VSCode)でフォルダを開きます。実行ファイルTWELITE_Stage_VSCode ではデフォルトで1 に設定されています。 |
書換完了後の画面 | (M5Stack版を除く)1 を設定することでインタラクティブモード画面の代わりにターミナルを開きます。2 を設定することで、書換メニューに戻ります。TWELITE_Stage_VSCode では2 に設定されています。 |
LTOを行わない | (Windowsのみ)1 を設定すると、WindowsのコンパイラでLTOを行いません。LTOは比較的小さなバイナリを生成できる一方でリンクに時間を要します。LTOを省略することでより高速なリンクが実現できます。 |
セーブデータユーティリティ
r: Read sector.
R: Read ALL sectors.
e: Erase sector.
E: Erase ALL sectors.
この画面は、データセーブ領域のメンテナンスを行うユーティリティです。EEPROM(64バイトを1セクタとして最大60セクタ、3840バイト)をエミュレートします。
設定 | 内容 |
---|
r | セクタを読み出します。0..59 を入力すると、入力したセクタ番号のセクタの内容を表示します。 |
R | YES を入力すると全セクタの読み出しを行いますが、末尾の部分のみを表示します。 |
e | セクタを消去(0xFF )します。0..59 を入力すると、入力したセクタ番号のセクタが消去されます。 |
E | YES を入力すると全セクタを消去します。 |
Windows, macOS, Linux, Raspberry Pi では、 {実行形式名}.sav
(デフォルトでは TWELITE_Stage.sav
ファイル)に保存されます。
2.2.5 - シリアルポートの選択
シリアルポートの選択
Windows
macOS
Linux
RasPi
概要
この画面では、シリアルポートを再選択できます。
この画面を使用せず、Alt(⌘)+0
, Alt(⌘)+1,2,..
でシリアルポートを切り替えることもできます。
3 - ログ機能
TWELITE と PC 間のログ機能
Windows
macOS
Linux
RasPi
TWELITE と PC 間のシリアル通信のログを記録できます。
操作
記録開始
Alt(⌘)+L
を押します。
記録終了
記録中に再度 Alt(⌘)+L
キーを押します。
ログの記録が終了し、その時点のログファイルをOS標準の方法(Windowsはメモ帳、macOSはコンソール.app)で開きます。
Raspberry Pi では、ログファイルの保存のみ行います。自動的にログファイルを開く機能はありません。
仕様
ログの記録
TWELITE から受信した文字列は、そのまま記録されます。
TWELITE に送信した文字列は、1文字ずつ記録されます。
Windowsの場合は 「 」
、 macOS / Linux / RaspBerryPi は « »
で囲われます。
例えば«t»
とある場合は、キーボードからt
を入力したことを意味します。
ログ記録のフォルダとファイル名
{TWELITE STAGE APP の実行形式のあるフォルダ}/log
にログ開始時の日時を元にしたファイル名で保存されます。
Alt(⌘)+Shift+L
を押すことで、そのフォルダを開きます。