TWELITE STAGE アプリは以下の方法で配布しています。

TWELITE STAGE SDK

https://mono-wireless.com/jp/products/stage/index.html

Windows/Mac/Linuxプラットフォーム用で、開発ツールなどを含め一式を配布します。

TWELITE STAGEバイナリ配布

最新のTWELITE STAGE SDK から TWELITE STAGE アプリのみの更新がある場合は、以下より配布します。

Windows10

https://github.com/monowireless/TWELITE_Stage_BIN_Win

Mac (macOS)

https://github.com/monowireless/TWELITE_Stage_BIN_macOS

M5Stack

https://github.com/monowireless/TWELITE_STAGE_Bin_M5Stack

MWM5ライブラリ

TWELITE STAGE のソースコードを含む MWM5 ライブラリは以下より入手できます。

https://github.com/monowireless/mwm5

Windows

環境

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

• Windows10 バージョン 1903

• VisualStudio 2019 (32bit ビルド)

動作に必要要件

• FTDI 社の FT232 シリーズが動作するようにデバイスドライバのインストールが必要な場合があります。MONOSTICK や TWELITE-R が認識できていない場合は、https://www.ftdichip.com より D2XX ドライバを導入してみてください。

• Visual Studio 2019 の Visual C++ 頒布可能コード（ランタイムライブラリ）が必要になる場合があります。アプリケーションの起動時にエラーが出て起動しない場合は、本パッケージで再配布する TWELITE_Stage¥INSTALL¥VC_redist.x86.exe またはマイクロソフト社のウェブサイトから入手して、インストールしてください。配布バイナリは 32bit です。

ソースコードの変更履歴は https://github.com/monowireless/mwm5 を参照ください。

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エクストラのメニューを追加

  • Act_samplesより高度なもの

  • 外部のオープンソースライブラリ（センサー手続きなど）を利用したもの

• マウスによる操作を拡大 (リスト、ボタン、タブ)

  • マウス移動でフォーカス、左クリックで確定、右クリックは[ESC]キー入力

• 画面表示負荷の低減

  • アプリケーションがバックグラウンドの時はスクリーンセーバーを無効にした

  • アプリケーションがバックグラウンドの時は、描画回数を減らして CPU 負荷を減らした

• ビルドプロジェクト(Act, TWE_Apps, Actエクストラ)の一覧の機能強化

  • 項目選択時に下部に概要を表示 (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

リリース初版

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

TWELITE STAGE APP (トワイライト ステージ アプリ) は、TWELITE 無線マイコンシリーズのアプリを書き換えたり、実行結果を閲覧するツールです。

様々なプラットフォームで動作するように設計されています。

• Windows10

• macOS (High Sierra 以降)

• Linux (Ubuntu18.04)

• M5stack

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

本資料について

• https://twelite.gitbook.io/general/about_documentsを参照ください。

• 対応プラットフォームを示すため以下の記載しているページがあります。

  • Windows -- Windows10

  • macOS -- Mac OS X, macOS

  • Linux -- Linux (Ubuntuなど)

  • M5Stack -- M5Stack core, faces

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

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

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

M5Stack

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

ハードウェア接続

TWELITE STAGE ボード

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

最小限の接続

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

[M5Stack 15P]

    GPIO03
    GPIO01
    GPIO16 --- TWELITE DIO6/UART0 TX (TWELITE DIP #10)
    GPIO17 --- TWELITE DIO7/UART0 RX (TWELITE DIP #3)
    GPIO02
    GPIO05
    GPIO25
    GPIO26
    GPIO35
    GPIO36
       RST
       BAT
       3V3 --- TWELITE VCC (TWELITE DIP #28)
        5V
       GND --- TWELITE GND (TWELITE DIP #1,14)

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

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

[M5Stack 15P]

    GPIO03
    GPIO01
    GPIO16 --- TWELITE DIO6/UART0 TX (TWELITE DIP #10)
    GPIO17 --- TWELITE DIO7/UART0 RX (TWELITE DIP #3)
    GPIO02 --- TWELITE PGM   (TWELITE DIP #7)
    GPIO05 --- TWELITE DIO12 (TWELITE DIP #15)
    GPIO25
    GPIO26 --- TWELITE RESET (TWELITE DIP #21)
    GPIO35
    GPIO36
       RST
       BAT
       3V3 --- TWELITE VCC (TWELITE DIP #28)
        5V
       GND --- TWELITE GND (TWELITE DIP #1,14)

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

macOS

環境

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

• macOS Mojave (10.14.6)

• macOS Catalina (10.15.4)

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

• ダウンロードアーカイブには署名しておりません。実行時には、インターネットからダウンロードされたアプリケーションとしてセキュリティ警告が出る場合があります。

• TWELITE_Stage をインストールしたパスからの実行許可を要求される場合があります。

• ビルド実行時に make ユーティリティのインストールダイアログが出る場合があります。

• ツールチェインにはコード署名がなされていますが、コード署名が正しく認証されない場合は、ビルドツールチェイン (ba-elf-gcc など) の実行形式一つずつについて、動作許可を求められる場合があります。

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

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

$ xcode-select --install

$ make
make: *** No targets specified and no makefile found.  Stop.

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

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

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

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

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

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

$ sudo kextunload -b com.apple.driver.AppleUSBFTDI

Linux

環境

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

• Ubuntu 16.04, 18.04, 20.04

• NNLinux Beta8 64bit

• Centos7

デバイスドライバ

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

この設定を自動化するための 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 のアイコンが追加されます。

Windows macOS Linux M5Stack

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

共通のキー

Windows macOS Linux M5Stack

ヘルプ画面

Windows macOS Linux

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

Alt(Cmd)+操作

Windows macOS Linux

Windows/macOS/LinuxでのAlt(Cmd)を押しながらの操作について解説します。表中ではAlt(Cmd)+の表記は省略しています。Alt(Cmd)を押すとヘルプ画面が出てきて使用可能なキーは確認できますが、下表に補足します。

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

Windows macOS Linux

Windows/macOS/Linuxでは、M5Stack にあるハードウェアボタンをエミュレートするため、画面下部にマウスを移動すると [ A ] [ B ] [ C ] といったオーバーレイ表示が行われます。ボタンはクリック（ボタン押上）と、長押しクリックをエミュレートします。

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

Windows macOS Linux

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

Windows macOS Linux M5Stack

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

Windows macOS Linux

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

Windows/Mac/Linux

Windows macOS Linux

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

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

M5Stack

M5Stack

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

Windows macOS Linux M5Stack

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

Windows macOS Linux M5Stack

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

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

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

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

ビルド済みのアプリ(.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
       ...

Windows macOS Linux

アクト(Act)のビルドと書き換えを行います。 (Windows/Mac/Linux)

この画面を開くと、プロジェクト一覧が表示されます。書き込みたいプロジェクトを選択すると、ビルド～書き込みを行います。書き込み終了後にEnterまたは[ B ]ボタンを押すことで、TWELITE無線モジュールをリセットし、インタラクティブモード画面（またはターミナル画面、要設定）に遷移します。

ビルド～書き込み画面

フォルダ

ビルド対象となるプロジェクトは以下になります。

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

操作

Windows macOS Linux M5Stack

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

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

M5Stackでは、SDカードにあらかじめコピーしておいた、ビルド済みの.BINファイル(ファームウェア）を書き込むことができます。

Windows macOS Linux

アクト(Act)のビルドと書き換えを行います。 (Windows/Mac/Linux)

この画面を開くと、プロジェクト一覧が表示されます。書き込みたいプロジェクトを選択すると、ビルド～書き込みを行います。書き込み終了後にEnterまたは[ B ]ボタンを押すことで、TWELITE無線モジュールをリセットし、インタラクティブモード画面（またはターミナル画面、要設定）に遷移します。

ビルド～書き込み画面

フォルダ

ビルド対象となるプロジェクトは以下になります。

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

操作

Windows macOS Linux

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

Windows macOS Linux

TWELITE APPSのビルドと書き換えを行います。 (Windows/Mac/Linux)

この画面を開くと、プロジェクト一覧が表示されます。書き込みたいプロジェクトを選択すると、ビルド～書き込みを行います。書き込み終了後にEnterまたは[ B ]ボタンを押すことで、TWELITE無線モジュールをリセットし、インタラクティブモード画面（またはターミナル画面、要設定）に遷移します。

ビルド～書き込み画面

フォルダ

ビルド対象となるプロジェクトは以下になります。

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

操作

Windows macOS Linux M5Stack

コマンダーは、TWELITE無線マイコンにシリアルメッセージを送付するものです。コマンダーの最初の画面は留意事項について記載しています。

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

タブ：TWELITE

この画面は の を生成し、送付します。TWELITE無線マイコンにはApp_TweliteまたはApp_Wingsを書き込んで、アプリケーションID・チャネルを設定し、通信相手からメッセージが受信されていることを確認します。

各項目を変更するたびにコマンドが生成されます。送信ボタンを押すと、現在の設定のコマンドを再度送信します。

タブ:NOTICE

各項目を変更するたびにコマンドが生成されます。点灯ボタンを押すと、現在の設定のコマンドを再度送信します。

画面下部の表示

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

Windows macOS Linux

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

Windows macOS Linux

ビルド中

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

ビルドエラー

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

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

書換中

ビルドが成功するとファームウェアを書き込む画面になります。

書換失敗

書換がエラーの場合は、上記のような画面になります。

書換完了

書換が無事成功すると上記のような表示になります。

Windows macOS Linux M5Stack

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

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

一覧表示

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

選択表示

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

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

Windows macOS Linux M5Stack

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

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

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

Windows macOS Linux

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

M5Stack

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

利用するGPIOについて

TWELITE STAGE APPでは、以下のGPIOを利用しています。

※ TWELITE STAGEボードでは、回路保護を目的とした抵抗などが配線されています。詳しくはを参照ください。

キーボード

TWELITE STAGE アプリでは、多くの操作をキーボード前提としております。以下のキーボードに対応しています。

PS/2コネクタ

PS/2 コネクタ PS/2 キーボードを接続することが出来ます。USB共用タイプの一部など、場合によっては動作しないことも考えられます。

CardKB

M5Stack faces QWERTYタイプキーパッド

M5Stack faces の QWERTY タイプキーパッドが利用できます。

キーパッドを利用する場合、以下の割り当てを行っています。

アプリ書換

TWELITE 無線マイコン用のファームウェアを M5Stack から書き込むことが出来ます。

FAT32フォーマットしたSDカード上の最上位フォルダに BIN フォルダを作成し、BIN フォルダ中にファームウェアをコピーしておきます。

Windows macOS Linux

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

ログの開始

Alt(Cmd)+Lキーを押します。

ログ記録の終了

ログ記録中にもう一度 Alt(Cmd) + L キーを押します。

ログの記録が終了し、その時のログファイルがOS標準の方法(Windowsならメモ帳、macOS ならコンソール)で開かれます。

ログの記録

TWELITE 無線マイコンから受信した文字列→そのまま記録されます

TWELITE 無線マイコンに送信した文字列→１文字ずつWindowsの場合は ｢ ｣macOS/Linuxは « » で囲って記録します。

例えば«t»とある場合はキーボードからtを入力したことを意味します。

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

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

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

Windows macOS Linux M5Stack

各種設定を行います。

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

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

ルートメニュー

共通設定
 ターミナル
 標準アプリ ビューア
 ＰＡＬ ビューア
 グランサー(簡易モニタ)
 コマンダー
 アプリ書換
 インタラクティブモード
ｾｰﾌﾞﾃﾞｰﾀ ﾕｰﾃｨﾘﾃｨ(ﾀﾞﾝﾌﾟ/消去)
情報

共通設定

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

アプリ書換

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

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

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

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

Windows macOS Linux M5Stack

ビューアは、シリアルポート経由で接続したTWELITE 無線マイコンからの情報を表示したり、反対に司令（コマンド）を送ったりします。

各々のビューアは、比較的小規模なプログラムで mwm5 ライブラリの使用方法のサンプルを兼ねています。