operation manual
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Windows
macOS
Linux
Windows/macOS/Linux では、始動時にTWELITE無線マイコンが接続されているシリアルポートを選択する画面になります。
シリアルポートは Alt(Cmd)+0,1,2,... のキー操作でいつでも切り替えが可能です。
Windows
macOS
Linux
M5Stack
TWELITE STAGEアプリを通じた操作について解説します。
Windows
macOS
Linux
M5Stack
Windows
macOS
Linux
Windows/macOS/Linuxでは、Alt(またはCmd)を押し続けることでヘルプ画面を表示します。ヘルプ画面ではAlt(Cmd)と一緒に操作できるキーの説明や一部動作状況を表示します。
Windows
macOS
Linux
Windows/macOS/LinuxでのAlt(Cmd)を押しながらの操作について解説します。表中ではAlt(Cmd)+の表記は省略しています。Alt(Cmd)を押すとヘルプ画面が出てきて使用可能なキーは確認できますが、下表に補足します。
Windows
macOS
Linux
Windows/macOS/Linuxでは、M5Stack にあるハードウェアボタンをエミュレートするため、画面下部にマウスを移動すると [ A ]
[ B ] [ C ]
といったオーバーレイ表示が行われます。ボタンはクリック(ボタン押上)と、長押しクリックをエミュレートします。
Windows
macOS
Linux
Windows/macOS/Linuxでは、TWELITE STAGE の画面構成は文字列のみで構成されますが、メニューやボタン、タブについてはマウスによる操作が可能です。
Windows
macOS
Linux
M5Stack
階層化されたメニューの最上位です。
Windows
macOS
Linux
M5Stack
TWELITE無線マイコンにはApp_Wingsを書き込んでおき、通信相手のTWELITE PALからのシリアルメッセージが表示されていることを確認してから使用します。事前にApp_WingsのアプリケーションIDやチャネルを設定しておく必要があります。
通信相手はTWELITE PALです。
App_Wings経由で無線パケット由来のシリアルメッセージが得られたときに、PAL子機のID (1..32まで) に対応するリスト項目に、PALの種別とセンサー情報などを簡易表示します。
現在表示されるリスト画面中に新しく受信した情報が表示されたときは、そのエントリ行にカーソルが移動します。
Windows
macOS
Linux
M5Stack
TWELITE無線マイコンにはApp_Twelite(標準アプリ)またはApp_Wingsを書き込んでおき、通信相手からのシリアルメッセージが表示されていることを確認してから使用します。
通信相手はApp_Twelite(標準アプリ)で、標準アプリのボタンやアナログ入力の状態のメッセージ (0x81メッセージ) を受信すると、その内容を mwm5 のパーサーライブラリにより解釈して表示します。
のを解釈します。
のを解釈します。
Glancerはglanceする人という英単語で、を簡易表示するものです。TWELITE無線マイコンにはApp_Wingsを書き込んでおき、通信相手 (App_Twelite, TWELITE PAL, ... アプリケーションIDとチャネルが一致すれば混在も可) からの情報を表示します。
M5Stackでは、320x240画面上の液晶と3つのボタンを用いて操作します。各種操作にはキーボードを必須とするものもあるためを推奨します。
キー
意味
ESC
キャンセル、前画面に戻る
Enter
入力、選択
カーソル↑↓
項目の選択
キー
意味
I
+ + + を入力します。インタラクティブモードに入るキーシーケンスです。 ※ スリープによる間欠動作を行うアプリは + + + ではインタラクティブモードになりません。
R
モジュールをリセットする。TWELITE R や MONOSTICK の機能を用いてリセットピンの制御を行います。
A, S, D
A, B, C ボタンを押します。
Shift + A, S, D
A, B, C ボタンを長押しします。
C
表示されている画面の文字列をクリップボードにコピーします。(画面によって範囲は異なります)
V
クリップボードからキーボード入力としてペーストします。
F
フルスクリーンに遷移します。Shift+Fは、可能であれば、より拡大します。
G
画面の描画方法を変更します。320x240の液晶画面をエミュレートしていますが、拡大時の描画方式として(1. 液晶モニタ風の描画 / 2. ブラウン管風の描画 / 3. ドットを目立たせた拡大 / 4. ドットをぼやかせた拡大)の4種類が選択できます。
※ 設定メニューで起動時設定にできます。
J
画面サイズを選択します。選択可能な画面サイズは(640x480 / 960x720 / 1280x720 / 1280x960 / 320x240)です。
※ 設定メニューで起動時設定にできます。
Q
TWELITE STAGE を終了します。
0
シリアルポートを切断し、再度シリアルポートの一覧を表示します。
1,2,..
シリアルポートを選択します。
L
シリアルポートの入出力のログを開始します。終了時にはログファイルが Windows であればメモ帳、macOS であれば ログビューアで開かれます。Shift+L でログ格納フォルダを開きます。
マウス
意味
マウスポインタの移動
クリック操作が可能な範囲にポインタを移動すると、文字列が反転したり文字の色が変わります。
左クリック
要素を選択します。クリック直後に要素中の文字列が太字表示になり、約0.3秒後に選択が実行されます。
右クリック
ESCキーの入力を行います。
ホイール
リスト項目では項目の上下選択を行います。
操作 |
[ A ] | リストの前ページに移動する。 |
[ A ] 長押し | この画面を抜け、前メニューに戻る |
[ B ] | フォントを変更します。 |
[ B ] 長押し | テスト用のダミーデータによる画面表示を行います。 |
[ C ] | リストの次ページに移動する。 |
[ C ] 長押し | TWELITE 無線モジュールのリセットピンを制御し、リセットします。 |
ESC | ESCキーを入力することで、この画面を抜けます。 |
操作 |
[ A ] | 割当なし |
[ A ] 長押し | この画面を抜け、前メニューに戻る |
[ B ] | フォントを変更します。 |
[ B ] 長押し | テスト用のダミーデータによる画面表示を行います。 |
[ C ] | 割当なし |
[ C ] 長押し | TWELITE 無線モジュールのリセットピンを制御し、リセットします。 |
ESC | ESCキーを入力することで、この画面を抜けます。 |
操作 |
[ A ] | リストの前項目に移動する。 |
[ A ] 長押し | この画面を抜け、前メニューに戻る |
[ B ] | 選択表示に移行します。 |
[ B ] 長押し | 項目をソートします。ソートを実行するたびに、ソートキーは順に変わります。 |
[ C ] | リストの次項目に移動する。 |
[ C ] 長押し | TWELITE 無線モジュールのリセットピンを制御し、リセットします。 |
ESC | ESCキーを入力することで、この画面を抜けます。 |
操作 |
[ A ] | 割当なし |
[ A ] 長押し | この画面を抜け、選択画面に戻る。 |
[ B ] | 割当なし |
[ B ] 長押し | 割当なし |
[ C ] | 割当なし |
[ C ] 長押し | TWELITE 無線モジュールのリセットピンを制御し、リセットします。 |
ESC | この画面を抜け、選択画面に戻る。 |
Windows
macOS
Linux
直前に指定・書換実行した項目を再選択します。
選択した項目によって、以下のいずれかの振る舞いになります。
選択プロジェクトの再書換
直線選択した一覧画面
Windows
macOS
Linux
フォルダまたは.BINファイルをTWELITE STAGE APP 画面中にドラッグ&ドロップできます。ドロップした対象に対して操作を行うときに選択します。
.BINファイルをドロップしたときは、そのファイルが格納されるフォルダをドロップした場合と同様の振る舞いで、そのフォルダにあるファームウェア一覧が表示されます。
Windows
macOS
Linux
M5Stack
ビルド済みのアプリ(.BINファイル)を書き込みます。
メニューを選択すると、ファイル一覧が表示されます。書き込みたいファームウェアを選択してください。
メニュー選択前に、書き込みむBINファイルを以下に格納しておきます。
BINフォルダにはTWELITE STAGEでビルドした .BIN ファイル(各プロジェクトのbuildフォルダ以下に格納)を、ファイル名を変更せず格納しておきます。
ファイル名によりBLUE/REDの識別を行っています。
Windows
macOS
Linux
M5Stack
ANSIエスケープシーケンス(の一部)に対応した簡易ターミナルです。TWELITE 無線マイコンと直接入出力を行います。
Windows
macOS
Linux
TWELITE APPSのビルドと書き換えを行います。 (Windows/Mac/Linux)
TWENET C API によるC言語で記述され、そのまま利用いただく比較的規模の大きいソースコードが中心です。
この画面を開くと、プロジェクト一覧が表示されます。書き込みたいプロジェクトを選択すると、ビルド~書き込みを行います。書き込み終了後にEnter
または[ B ]
ボタンを押すことで、TWELITE無線モジュールをリセットし、インタラクティブモード画面(またはターミナル画面、要設定)に遷移します。
ビルド対象となるプロジェクトは以下になります。
Windows
macOS
Linux
M5Stack
TWELITE無線マイコンのアプリ(ファームウェア)を書き換えます。
Windows
macOS
Linux
では、アクト(Act)などソースコードからのビルド(コンパイル)を行い、書き込みます。
Windows
macOS
Linux
ビルド中の画面です。ビルドコマンドの内容はコンソール画面に出力されます。画面中の ... はビルドしているファイル数、下部の暗い色の表示はビルドしているファイル名です。
ビルドがエラーの場合は、上記のような画面になります。再ビルドの実行やエラーログの表示を行えます。また、一定時間でタイムうとして直線のメニューに戻ります。
画面上のエラーメッセージは、代表的なもののみ表示されます。ビルドが失敗したときエラー内容のメッセージが表示されない場合もあります。
ビルドが成功するとファームウェアを書き込む画面になります。
書換がエラーの場合は、上記のような画面になります。
書換が無事成功すると上記のような表示になります。
Windows
macOS
Linux
M5Stack
各種設定を行います。
この画面のメニューはマウス操作できません。
以下の解説のメニュー中では、プラットフォームによっては存在しない項目がありますが、全てを列挙して解説します。
共通メニュー以外の色設定については、解説を省略します。
この画面ではデータセーブ領域のメンテナンスを行うユーティリティです。EEPROM(64バイトを1セクタとして最大60セクタ、3840バイト)をエミュレートしています。
Windows
macOS
Linux
ではTWELITE_Stage.sav
ファイルに保存されます。
M5Stack
ではフラッシュメモリのEEPROMエミュレート領域に保存されます。
M5Stack
では、しておいた、ビルド済みの.BINファイル(ファームウェア)を書き込むことができます。
プラットフォーム
場所
Windows, Mac, Linux
{MWSTAGEフォルダ}/BIN
M5Stack
SDカード最上位フォルダにBINフォルダを作成しておく
操作
[ A ]
+ + + シーケンスの入力(インタラクティブモード)
[ A ] 長押し
この画面を抜け、前メニューに戻る
[ B ]
大きなフォントで表示する。最初の画面の部分領域を表示します。カーソルが画面中に表示されるように領域を選びますが、画面出力によっては見たい部分が見えない場合もあります。
[ B ] 長押し
折返し制御のON/OFF。標準では折返し表示を行うようになっていますが、折り返ししないように表示することもできます。画面右端以降の文字列は表示されません。
[ C ]
ファーム書換画面に移動します。ファームウェアの開発中には頻繁にソースコードの修正、動作確認、ビルド&書き込みを行うため、ショートカットを用意しています。
[ C ] 長押し
TWELITE 無線モジュールのリセットピンを制御し、リセットします。
ESC ESC
ESCキーを2回素早く入力することで、この画面を抜けます。
※ 殆どの画面ではESCキーを1回押すことで画面から抜ける操作となっていますが、ターミナルではESCキーの単独入力を使用する場合があるため、2回連続入力の割当になっています。
操作
[ A ]
メニュー選択 ↑
[ A ] 長押し
この画面を抜け、前メニューに戻る
[ B ]
選択
[ B ] 長押し
関連ウェブサイト(プロジェクトフォルダの000desc.txt
に登録がある場合)をOS標準のブラウザで開きます。
[ C ]
メニュー選択 ↓
[ C ] 長押し
フォルダ(プロジェクト、関連フォルダ)を開きます。設定メニューでVS Codeで開くように設定できます。
ESC
この画面を終了し、書換メニューに戻ります。
マウスクリック [ウェブ]
関連ウェブサイトを開きます。
マウスクリック [フォルダ] または [VSCode]
関連フォルダを開きます。
マウスクリック [▽] または [△]
次ページ、前ページに移動します。
操作 |
[ A ] 長押し | この画面を抜け、前メニューに戻る |
[ B ] | エラー時に再ビルドする |
[ C ] | エラーログを表示する (Windows/Mac) エラーログは |
[ C ] 長押し | フォルダ(プロジェクト、関連フォルダ)を開きます。設定メニューでVS Codeで開くように設定できます。 |
ESC | この画面を終了し、書換メニューに戻ります。 |
操作 |
[ A ] 長押し | この画面を抜け、前メニューに戻る |
[ B ] | 再度書換を行う(直前の書き換えメニューに戻ります。再書換のメニュー項目が選択されている状態なので、もう一度[ B ]を押すことで再書換操作になります) |
ESC | この画面を終了し、書換メニューに戻ります。 |
操作 |
[ A ] 長押し | この画面を抜け、前メニューに戻る |
[ B ] | TWELITE無線モジュールをリセットして、インタラクティブモード画面(または設定によりターミナル)画面に移動します。 |
ESC | この画面を終了し、書換メニューに戻ります。 |
設定 | 内容 |
起動アプリ | TWELITE STAGE始動時にビューアアプリに移動する設定です。設定値は1..{ビューアアプリメニューで列挙されている数}です。 ※ シリアルデバイスIDを設定しておかないと、始動時に接続するシリアルデバイス選択画面で入力待ちになります。 |
画面サイズ・描画方法 |
|
シリアルデバイスID |
|
PS/2キーボードレイアウト |
|
文字色・背景色 | 文字色、背景色を指定します。共通設定の色設定値は他の画面の設定にも継承されます。他の画面で未設定の場合は共通設定の色設定が採用されます。 色はRGB 24bitを16進数で指定しますが、内部的には16bit 565 形式に値が丸められます。 |
設定 | 内容 |
ビルド時のmakeジョブ数 |
|
codeでフォルダを開く (VSCode) |
|
書換完了後の画面 |
|
設定 | 内容 |
r | セクタを読み出します。0..59を入力すると、入力したセクタ番号のセクタの内容を表示します。 |
R | (YESを入力すると全セクタの読み出しを行いますが、一番最後の部分しか表示されません) |
e | セクタを消去(0xFF)します。0..59を入力すると、入力したセクタ番号のセクタが消去されます。 |
E | YESを入力すると全セクタを消去します。 |
操作 |
[ A ] | メニュー選択 ↑ |
[ A ] 長押し | この画面を抜け、前メニューに戻る |
[ B ] | 選択 |
[ B ] 長押し | 関連ウェブサイト(プロジェクトフォルダの |
[ C ] | メニュー選択 ↓ |
[ C ] 長押し | フォルダ(プロジェクト、関連フォルダ)を開きます。設定メニューでVS Codeで開くように設定できます。 |
ESC | この画面を終了し、書換メニューに戻ります。 |
マウスクリック [ウェブ] | 関連ウェブサイトを開きます。 |
マウスクリック [フォルダ] または [VSCode] | 関連フォルダを開きます。 |
マウスクリック [▽] または [△] | 次ページ、前ページに移動します。 |
Windows
macOS
Linux
シリアルポートを選択しなおします。
Alt(Cmd)+0
, Alt(Cmd)+1,2,..
による操作を行っても構いません。
Windows
macOS
Linux
アクト(Act)のビルドと書き換えを行います。 (Windows/Mac/Linux)
アクト(Act)の記述の参考となる小規模なソースコードが中心です。
この画面を開くと、プロジェクト一覧が表示されます。書き込みたいプロジェクトを選択すると、ビルド~書き込みを行います。書き込み終了後にEnter
または[ B ]
ボタンを押すことで、TWELITE無線モジュールをリセットし、インタラクティブモード画面(またはターミナル画面、要設定)に遷移します。
ビルド対象となるプロジェクトは以下になります。
M5Stack
M5Stack特有の動作や利用方法について記載します。TWELITE STAGEボードが接続されていることを前提とします。
TWELITE STAGE APPでは、以下のGPIOを利用しています。
※ TWELITE STAGEボードでは、回路保護を目的とした抵抗などが配線されています。詳しくは回路図を参照ください。
上記、使用されているGPIOピンとの接続先については十分配慮してください。
以下は特に注意を払う必要があります。
TWELITE 無線マイコンの当該ピンの設定を出力とする。
例えばTWELITE STAGE ボードではGPIO05にDIO12(DI1)が接続されていますが、このピンをGNDに直接落したり、ファームウェアからDIO12を出力設定かつLOWに設定したりした場合、M5StackからGPIO05をHIGHレベル出力すると過大電流が流れます。
これらのピンに(TWELITE STAGEボード以外の)別のデバイスを接続している。
後述するfacesのキーパッドが該当します。TWELITE STAGE APPでは、起動時にキーパッドのI2Cデバイスを検出できた場合は、GPIO5の制御を省略するようにしています。
TWELITE STAGE アプリでは、多くの操作をキーボード前提としております。以下のキーボードに対応しています。
PS/2 コネクタ PS/2 キーボードを接続することが出来ます。USB共用タイプの一部など、場合によっては動作しないことも考えられます。
M5Stack 純正のカード型キーボード CardKB (Grove端子接続)です。
M5Stack faces の QWERTY タイプキーパッドが利用できます。
キーパッドの割り込みピンがTWELITE STAGE ボードで利用するSETピンと衝突するため、TWELITE STAGE起動時のI2Cバスチェックでキーパッドを検出した場合は、TWELITE STAGE APP ではSETピン制御を行わないようにしています。
同様に10キーパッドなども同じピンを割り込み用に使用しています。
TWELITE PALなどスリープによる間欠動作するファームウェアでは、設定(インタラクティブモード)画面に入るためにSET=LOWとして電源投入(リセット)を行いますが、この操作を手動で行う(具体的にはTWELITE STAGEボードのDI1ボタンをリセットを行う瞬間だけ押しておく)必要があります。
キーパッドを利用する場合、以下の割り当てを行っています。
TWELITE 無線マイコン用のファームウェアを M5Stack から書き込むことが出来ます。
Windows/Mac/Linuxにあるアクト(Act)のビルドなどは出来ません。
FAT32フォーマットしたSDカード上の最上位フォルダに BIN フォルダを作成し、BIN フォルダ中にファームウェアをコピーしておきます。
ファームウェアのファイル名により一部識別(RED/BLUE用)しているので、ファイル名はWin/Mac/Linux用のTWELITE STAGE でビルドしたファイル名は変更しないようにしてください。
Windows
macOS
Linux
TWELITE 無線マイコンとのシリアル通信のログを記録することができます。
Alt(Cmd)+Lキーを押します。
ログ記録中にもう一度 Alt(Cmd) + L キーを押します。
ログの記録が終了し、その時のログファイルがOS標準の方法(Windowsならメモ帳、macOS ならコンソール)で開かれます。
TWELITE 無線マイコンから受信した文字列→そのまま記録されます
TWELITE 無線マイコンに送信した文字列→1文字ずつWindowsの場合は 「 」
macOS/Linuxは « »
で囲って記録します。
例えば«t»
とある場合はキーボードからt
を入力したことを意味します。
{TWELITE STAGE APP の実行形式のあるフォルダ}/log にログ開始時の日時を元にしたファイル名で保存されます。
Alt(Cmd)+Shift+L を押すことで、そのフォルダを開きます。
Windows
macOS
Linux
M5Stack
コマンダーは、TWELITE無線マイコンにシリアルメッセージを送付するものです。コマンダーの最初の画面は留意事項について記載しています。
画面上部にはテキストで表現されたタブがあり、これをマウスでクリックすることでタブ中の画面に移動します。
この画面は App_Twelite(標準アプリ)の 0x80 コマンドを生成し、送付します。TWELITE無線マイコンにはApp_TweliteまたはApp_Wingsを書き込んで、アプリケーションID・チャネルを設定し、通信相手からメッセージが受信されていることを確認します。
各項目を変更するたびにコマンドが生成されます。送信ボタンを押すと、現在の設定のコマンドを再度送信します。
この画面は通知PAL(NOTICE PAL)のLED制御用のコマンドを生成します。TWELITE無線マイコンにはApp_Wingsを書き込んで、アプリケーションID・チャネルを設定し、通信相手からメッセージが受信されていることを確認します。
各項目を変更するたびにコマンドが生成されます。点灯ボタンを押すと、現在の設定のコマンドを再度送信します。
画面下部には、コマンドが生成されたタイムスタンプと :
で始まるコマンドが表示されます。クリップボードにはこの画面の内容がコピーされます。
操作
[ A ]
メニュー選択 ↑
[ A ] 長押し
この画面を抜け、前メニューに戻る
[ B ]
選択
[ B ] 長押し
関連ウェブサイト(プロジェクトフォルダの000desc.txt
に登録がある場合)をOS標準のブラウザで開きます。
[ C ]
メニュー選択 ↓
[ C ] 長押し
フォルダ(プロジェクト、関連フォルダ)を開きます。設定メニューでVS Codeで開くように設定できます。
ESC
この画面を終了し、書換メニューに戻ります。
マウスクリック [ウェブ]
関連ウェブサイトを開きます。
マウスクリック [フォルダ] または [VSCode]
関連フォルダを開きます。
マウスクリック [▽] または [△]
次ページ、前ページに移動します。
接続先
GPIO16,17
TWELITE UART 接続
GPIO02
TWELITE PRGピン
GPIO05
TWELITE SETピン(DI1)
GPIO26
TWELITE RSTピン
GPIO35,36
PS/2 キーボードコネクタ
キー
割り当て
Alt+1..9
数字の1..9
Alt+0
ESC
操作
[ A ]
タブの移動(左)
[ A ] 長押し
この画面を抜け、選択画面に戻る。
[ B ]
割当なし
[ B ] 長押し
割当なし
[ C ]
タブの移動(右)
[ C ] 長押し
TWELITE 無線モジュールのリセットピンを制御し、リセットします。
ESC
この画面を抜け、選択画面に戻る。
項目
内容
宛先
送信先です。自身が子機の場合は「親機: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ポートは変更しません。
※ TWESTAGE基板のPWM1のLEDはVCCからの吸い込みとなっているため、0で最も明るく点灯し、100%では消灯となります。
項目
内容
子機ID
送信先です。1..8を指定します。子機にも同じIDを割り振っておきます。
色
点灯色を7色から指定します。白は2種類ありますが、1つはRGBの混色で1つは白色LED単体の点灯です。
明るさ
0..15で指定します。0は消灯です。
点灯点滅
点灯または点滅パターンを選択します。
点灯時間
コマンド発行後、一定時間経過すると自動的に消灯する機能です。
消灯ボタン
消灯メッセージを生成します。
点灯ボタン
現在の設定を送信します。