Windows

環境

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

• Windows10 バージョン 1903

• VisualStudio 2019 (32bit ビルド)

動作に必要要件

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

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

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

Windows macOS Linux M5Stack

のを解釈します。

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

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

Windows macOS Linux M5Stack

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

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

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

Windows macOS Linux

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

Windows/Mac/Linux

Windows macOS Linux

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

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

M5Stack

M5Stack

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

M5Stack

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

ハードウェア接続

Windows macOS Linux M5Stack

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

Windows macOS Linux

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

Windows macOS Linux

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

Windows macOS Linux

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

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

フォルダ

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

操作

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

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

• Windows10

• macOS (High Sierra 以降)

• Linux (Ubuntu18.04)

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

本資料について

• を参照ください。

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

  • Windows -- Windows10

Windows macOS Linux M5Stack

のを解釈します。

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

通信相手はTWELITE PALです。

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

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

TWELITE STAGE SDK

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

Windows macOS Linux M5Stack

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

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

ビルド中

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

Windows macOS Linux

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

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 の画面構成は文字列のみで構成されますが、メニューやボタン、タブについてはマウスによる操作が可能です。

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

0.9.9 - MWSTAGE2020_10収録版

• 最上位メニューにも [ｳｪﾌﾞ] ボタンを追加し、関連リンクをブラウザで開けるようにした。

• Linux版のフォルダ、ウェブ、VS Code で開く機能を実装した。

• TWELITE 無線モジュールが頻繁に UART 出力している場合に、書き込みメニューへ遷移しづらいことがあった

0.9.8a

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

0.9.8

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

改定内容

• ビューア＞コマンダーの追加

  • 標準アプリ 0x80 コマンド

  • NOTICE PALのLED制御 (App_Wingsにコマンドを送付)

既知の問題

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

0.8.9

2020_05 リリース版

• ウインドウアイコンの追加

• BINファイル一覧画面での最大リスト数の制約を緩和 (win/linux/mac)

• Glancerビューアの追加

0.8.6

Linux 版リリース初版

0.8.5

リリース初版

macOS

環境

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

• macOS Mojave (10.14.6)

• macOS Catalina (10.15.4)

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

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

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

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

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

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

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

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

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

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

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

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

Windows macOS Linux M5Stack

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

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

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

Windows macOS Linux

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

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

フォルダ

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

操作

M5Stack

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

利用するGPIOについて

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

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

キーボード

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

PS/2コネクタ

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

CardKB

M5Stack 純正のカード型キーボード (Grove端子接続)です。

M5Stack faces QWERTYタイプキーパッド

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

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

アプリ書換

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

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

Windows macOS Linux M5Stack

各種設定を行います。

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

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

ルートメニュー

共通設定

アプリ書換

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

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

Windows macOS Linux M5Stack

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

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

Windows macOS Linux M5Stack

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

Windows macOS Linux

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

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

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 を押すことで、そのフォルダを開きます。