1 / 33

0.9 TWELITE STAGE APP

TWELITE 統合環境

をご参照ください。お気付きの点がありましたら、当サポート窓口にご連絡いただければ幸いです。

本資料は TWELITE STAGE APP バージョン 0.9 に対応します。

LICENSE

ライセンス

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

ソースコードについてはが適用されます。概要はリンク先を参照ください。

お客様がソースコードからビルドした場合は、非商用目的でより制限の緩和されたMW-OSSLA-1J,1E

改訂履歴

reviese

ソースコードの変更履歴はを参照ください。

0.9.9 - MWSTAGE2020_10収録版

インストール

install

環境に依存して、本アプリケーションが動作しない、また、各種設定が必要な場合があります。問題が発生した場合は、本資料の記述を参考に環境を整備いただくようお願いいたします。

開発環境を構築するためには、ソフトウェア群のインストール、またこれらの利用許諾に同意する必要があります。また、PC、ワークステーション上でセキュリティ設定等が必要になる場合があります。

配布時には十分注意しておりますが、ウィルスなどの確認はお客様のほうでも留意いただくようお願いいたします。
お客様のセキュリティの考え方や運用（例：外部アプリケーションのインストールの可否）については、お客様の環境の管理者にご確認ください。

また、開発環境をインストールまた動作するにあたり、OSが介在し設定等必要になる場合があります（例：開発元が不明なアプリケーションの実行。開発環境または紹介するツール群の多くは、アプリケーションは開発元を証明する仕組みが組み込まれせん）。設定方法については、一般の情報を参考いただくようお願いいたします。

Windows

TWELITE_Stage インストール (Windows10)

Windows

環境

以下の環境で開発しています。

macOS

TWELITE_Stage インストール (macOS)

macOS

環境

以下の環境で開発しています。

macOS Mojave (10.14.6)
macOS Catalina (10.15.4)

追加的なインストールや警告ダイアログについて

ダウンロードアーカイブには署名しておりません。実行時には、インターネットからダウンロードされたアプリケーションとしてセキュリティ警告が出る場合があります。
TWELITE_Stage をインストールしたパスからの実行許可を要求される場合があります。
ビルド実行時に make ユーティリティのインストールダイアログが出る場合があります。

上記は TWELITE_Stage の動作のためには許可を与えたり、インストール作業が必要になります。

参考: make ユーティリティの手動インストール

※ OSバージョンの違いなどにより、別の手順で行う必要がある場合があります。

コマンドドライン (bash) にて、make を実行した時エラーが出る場合は XCode のインストールを行います。

インストール完了後、make を入力して以下のメッセージが出れば OK です。

シリアルポートの取り扱いについて

MONOSTICKやTWELITE-R には FTDI社 (https://www.ftdichip.com) の FT232 シリーズの半導体が使用されています。利用するためにはデバイスドライバについて対処が必要になる場合があります。

TWELITE_Stageを起動しても、シリアルポートが表示されない場合は、FTDI社のドライバをアンロードする必要があります。

参考：FTDI社のユーティリティ

このユーティリティは当社のMONOSTICKやTWELITE-Rが挿入された時に、OS標準のデバイスドライバのロードを抑制するものですが、当社以外のデバイスに(同じUSBのIDを持つもの)対しても抑制します。

より D2xxHelper をダウンロードして使用してください。当アーカイブ TWELITE_Stage/INSTALL フォルダにも同じものを収録しています。

参考：FTDI社デバイスドライバの手動アンロード

FTDI 関連のドライバをアンロードします。

M5Stack

M5Stack

M5Stack用の書き換えは以下をご覧ください。

ハードウェア接続

M5Stack Core または faces をお使いの方は TWELITE STAGE ボードを利用することを推奨します。

TWELITE STAGE ボード

TWELITE STAGE ボードのデータシートをご覧ください。

最小限の接続

TWELITE DIPとの接続例です。シリアルポート(UART)のTX,RXのみのシンプルな接続です。この接続では TWELITE 上のファームウェアの書き込みなどが行えません。

シリアルポート以外の接続

以下の配線をすることで PGM/RESET/SET ピンが接続されます。TWELITE STAGEアプリケーションの全機能を利用する場合は以下の接続が必要になります。

ハードウェアの接続構成によっては、結線してはいけない場合もあります。ハードウェアの接続については M5Stack の資料も参考の上、十分注意して行ってください。

例： M5Stack faces の GPIO05 ピンは、キーパッドの割り込みピン（出力）が接続されているため、M5Stack側で出力制御を行うことはできません（故障の原因になりえます）。TWELITE STAGEアプリケーションでは、キーパッドに対応するI2Cデバイスを検出した場合は、出力制御しないようにしています。

※ 上記配線にはPS/2接続は記載していません。

使用方法

operation manual

キー操作・マウス操作

Windows macOS Linux M5Stack

TWELITE STAGEアプリを通じた操作について解説します。

画面

Windows/Mac/Linux

Windows macOS Linux

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

コンソール画面には、ターミナルと同様の出力が行われます。

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

M5Stack

M5Stack

M5Stackでは、320x240画面上の液晶と３つのボタンを用いて操作します。各種操作にはキーボードを必須とするものもあるためを推奨します。

シリアルポート選択

Windows macOS Linux

Windows/macOS/Linux では、始動時にTWELITE無線マイコンが接続されているシリアルポートを選択する画面になります。

シリアルポートは Alt(Cmd)+0,1,2,... のキー操作でいつでも切り替えが可能です。

メインメニュー

Windows macOS Linux M5Stack

階層化されたメニューの最上位です。

ターミナル

Windows macOS Linux M5Stack

ANSIエスケープシーケンス（の一部）に対応した簡易ターミナルです。TWELITE 無線マイコンと直接入出力を行います。

標準アプリビューア

Windows macOS Linux M5Stack

App_Twelite(標準アプリ)の0x81コマンドを解釈します。

TWELITE無線マイコンにはApp_Twelite(標準アプリ)またはApp_Wingsを書き込んでおき、通信相手からのシリアルメッセージが表示されていることを確認してから使用します。

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

PAL ビューア

Windows macOS Linux M5Stack

TWELITE PALの通知メッセージを解釈します。

TWELITE無線マイコンにはApp_Wingsを書き込んでおき、通信相手のTWELITE PALからのシリアルメッセージが表示されていることを確認してから使用します。事前にApp_WingsのアプリケーションIDやチャネルを設定しておく必要があります。

通信相手はTWELITE PALです。

App_Wings経由で無線パケット由来のシリアルメッセージが得られたときに、PAL子機のID (1..32まで) に対応するリスト項目に、PALの種別とセンサー情報などを簡易表示します。

現在表示されるリスト画面中に新しく受信した情報が表示されたときは、そのエントリ行にカーソルが移動します。

グランサー

Windows macOS Linux M5Stack

Glancerはglanceする人という英単語で、受信メッセージ中の情報を簡易表示するものです。TWELITE無線マイコンにはApp_Wingsを書き込んでおき、通信相手 (App_Twelite, TWELITE PAL, ... アプリケーションIDとチャネルが一致すれば混在も可) からの情報を表示します。

画面は２種類の構成になっています。

一覧表示

通信相手からの情報を列挙します。表示内容は（メッセージの種別、論理ID、シリアルID、LQI(Lq)、電源電圧(情報に含まれていれば)、受信時間）です。

選択表示

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

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

アプリ書換

Windows macOS Linux M5Stack

TWELITE無線マイコンのアプリ（ファームウェア）を書き換えます。

Windows macOS Linux では、アクト(Act)などソースコードからのビルド（コンパイル）を行い、書き込みます。

M5Stackでは、しておいた、ビルド済みの.BINファイル(ファームウェア）を書き込むことができます。

BINから選択

Windows macOS Linux M5Stack

ビルド済みのアプリ(.BINファイル)を書き込みます。

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

メニュー選択前に、書き込みむBINファイルを以下に格納しておきます。

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

ファイル名によりBLUE/REDの識別を行っています。

指定

Windows macOS Linux

フォルダまたは.BINファイルをTWELITE STAGE APP 画面中にドラッグ＆ドロップできます。ドロップした対象に対して操作を行うときに選択します。

.BINファイルをドロップしたときは、そのファイルが格納されるフォルダをドロップした場合と同様の振る舞いで、そのフォルダにあるファームウェア一覧が表示されます。

再書換

Windows macOS Linux

直前に指定・書換実行した項目を再選択します。

選択した項目によって、以下のいずれかの振る舞いになります。

インタラクティブモード

Windows macOS Linux M5Stack

インタラクティブモードへの遷移と操作を行います。

インタラクティブモード画面を使用しない場合、ターミナルによるインタラクティブモードの操作は可能です。ターミナルでは + + + の入力やSETピン、リセット操作を手動で行います。

シリアルポートの選択

Windows macOS Linux

シリアルポートを選択しなおします。

Alt(Cmd)+0, Alt(Cmd)+1,2,.. による操作を行っても構いません。

M5Stackでの利用

M5Stack

M5Stack特有の動作や利用方法について記載します。TWELITE STAGEボードが接続されていることを前提とします。

利用するGPIOについて

ログ機能

Windows macOS Linux

TWELITE 無線マイコンとのシリアル通信のログを記録することができます。

ログの開始

Linux

TWELITE_Stage インストール (Linux)

Linux

TWELITE R2 のUSBデバイスIDが従来の0403:6001から0403:6015に変わっています。udevの設定追加が必要です。

32bit版は用意しておりません。

Linux環境はディストリビューションやバージョンによって、用意されているパッケージの種類が違っています。個別にパッケージ等のインストールや設定が必要になる場合があります。

エラーメッセージ等を手がかりに一般の情報を参照いただくようお願いいたします。

環境

TWELITE STAGE は以下の環境で開発・動作確認しています。

Ubuntu 16.04, 18.04, 20.04
NNLinux Beta8 64bit
Centos7

デバイスドライバ

TWELITE STAGE から MONOSTICK や TWELITE-R を認識するためには、ftdi_sioモジュールをアンロードし、また、USBデバイスに対して読み書き権限が必要になります。

USBデバイスのIDは以下のようになります。

ベンダーID 0x0403
プロダクトID 0x6001(MONOSTICK,TWELITE R) または 0x6015 (TWELITE R2)

この設定を自動化するための udev の設定スクリプト(Ubuntu, CentOS) を用意しています。/etc/udev/rules.d に定義をコピーして、設定をリロードしています。設定後は USB デバイスを抜き差ししてから TWELITE_Stage.run を実行してください。起動直後の画面で USB デバイスが表示されれば、設定が反映されています。

Ubuntu 16.04, 18.04. 20.04

定義ファイル（読みやすいように改行しています）

Centos 7

定義ファイル（読みやすいように改行しています）

アプリケーション登録

必要に応じてお使いのデスクトップ環境に合わせて、プログラムを登録してください。

Ubuntu 16.04, 18.04, 20.04

Ubuntu用の定義ファイル生成スクリプトを用意しています。

このスクリプトは .desktop ファイル（アプリ定義）を$HOME/.local/share/applications に作成します。

スクリプト実行後に、アプリケーション一覧に TWELITE STAGE のアイコンが追加されます。

0.9

TWELITE STAGE APP

LICENSE

改訂履歴

hashtag0.9.9 - MWSTAGE2020_10収録版

インストール

Windows

hashtag環境

macOS

hashtag環境

hashtag追加的なインストールや警告ダイアログについて

hashtag参考: make ユーティリティの手動インストール

hashtagシリアルポートの取り扱いについて

hashtag参考：FTDI社のユーティリティ

hashtag参考：FTDI社デバイスドライバの手動アンロード

M5Stack

hashtagハードウェア接続

hashtagTWELITE STAGE ボード

hashtag最小限の接続

hashtagシリアルポート以外の接続

使用方法

キー操作・マウス操作

画面

hashtagWindows/Mac/Linux

hashtagM5Stack

シリアルポート選択

メインメニュー

ターミナル

標準アプリ ビューア

PAL ビューア

グランサー

hashtag

hashtag一覧表示

hashtag選択表示

アプリ書換

BINから選択

指定

再書換

インタラクティブモード

シリアルポートの選択

M5Stackでの利用

hashtag利用するGPIOについて

ログ機能

hashtagログの開始

使用方法

インストール

シリアルポート選択

メインメニュー

アプリ書換

Windows

hashtag環境

TWELITE STAGE APP

hashtag動作に必要要件

hashtag本資料について

画面

hashtagWindows/Mac/Linux

hashtagM5Stack

LICENSE

シリアルポートの選択

指定

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

標準アプリ ビューア

macOS

hashtag環境

hashtag追加的なインストールや警告ダイアログについて

hashtag参考: make ユーティリティの手動インストール

hashtagシリアルポートの取り扱いについて

hashtag参考：FTDI社のユーティリティ

hashtag参考：FTDI社デバイスドライバの手動アンロード

BINから選択

キー操作・マウス操作

ターミナル

改訂履歴

hashtag0.9.9 - MWSTAGE2020_10収録版

再書換

インタラクティブモード

ログ機能

hashtagログの開始

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

hashtagヘルプ画面

0.9.9 - MWSTAGE2020_10収録版

環境

環境

追加的なインストールや警告ダイアログについて

参考: make ユーティリティの手動インストール

シリアルポートの取り扱いについて

参考：FTDI社のユーティリティ

参考：FTDI社デバイスドライバの手動アンロード

ハードウェア接続

TWELITE STAGE ボード

最小限の接続

シリアルポート以外の接続

Windows/Mac/Linux

M5Stack

標準アプリビューア

一覧表示

選択表示

利用するGPIOについて

ログの開始

環境

動作に必要要件

本資料について

Windows/Mac/Linux

M5Stack

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

標準アプリビューア

環境

追加的なインストールや警告ダイアログについて

参考: make ユーティリティの手動インストール

シリアルポートの取り扱いについて

参考：FTDI社のユーティリティ

参考：FTDI社デバイスドライバの手動アンロード

0.9.9 - MWSTAGE2020_10収録版

ログの開始

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

ヘルプ画面

Alt(Cmd)+操作

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

マウスによる画面中の操作 (v0.9.7以降)

0.9.8a

0.9.8

改定内容

既知の問題

0.8.9

0.8.6

0.8.5

ログ記録の終了

ログの記録

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

一覧表示

選択表示

ハードウェア接続

TWELITE STAGE ボード

最小限の接続

シリアルポート以外の接続

利用するGPIOについて

キーボード

PS/2コネクタ

CardKB

M5Stack faces QWERTYタイプキーパッド

アプリ書換

ルートメニュー

共通設定

アプリ書換

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

フォルダ

操作

ビルド中

ビルドエラー

書換中

書換失敗

書換完了

フォルダ

操作

フォルダ

操作

TWELITE STAGE SDK

TWELITE STAGEバイナリ配布

MWM5ライブラリ

タブ：TWELITE