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

TWELITE STAGE SDK

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

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

TWELITE STAGEバイナリ配布

更新履歴に最新のTWELITE STAGE SDK から TWELITE STAGE アプリの更新がある場合や、M5Stack版の配布は以下より行います。配布バージョンはGitHub上のtagを確認ください。

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

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

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

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

• Windows10

• macOS (High Sierra 以降)

• Linux (Ubuntu18.04)

• Raspberry Pi (Raspberry Pi 3 Model B, Lcd Touch Screen, Raspberry Pi OS August-2020)

• M5stack

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

本資料について

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

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

  • Windows -- Windows10

  • macOS -- Mac OS X, macOS

  • Linux -- Linux (Ubuntuなど)

  • RasPi -- RaspberryPi

  • M5Stack -- M5Stack core, faces

Windows macOS Linux RasPi

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

Windows

cキーを押すと、リストで反転中のシリアルポートのCOMポート名が表示されます。

RasPi

Raspberry Pi ではUSBデバイスに加えて/dev/serial0 /dev/serial1があれば serial0, serial1 が表示されます。通常はserial0を使用します。

Windows macOS Linux RasPi

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

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

VSCodeを利用する設定（アプリ書換＞codeでフォルダを開く）になっている場合は、ビルドは行わずbuild/以下のを開きます。

フォルダ

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

操作

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 フォルダ中にファームウェアをコピーしておきます。

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

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

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

macOS

環境

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

Windows macOS Linux M5Stack RasPi

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

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

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

Windows/Mac/Linux

Windows macOS Linux

Windows macOS Linux

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

Windows macOS Linux RasPi

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

Windows macOS Linux M5Stack RasPi

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

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

Windows macOS Linux M5Stack RasPi

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

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

改訂履歴の最新バージョンと、各プラットフォーム向けの配布バージョンと一致しない場合があります。

1.0.8 MWSTAGE2021_09収録版

• [ A ] [ B ] [ C ]ボタンで、ポインタから外れたボタンが残ってしまう場合があった

• STAGE APPでEnter入力の際にTWELITEに対してCRLFを送信するようにした

• MacのFTDIライブラリを更新しApple Silicon(M1)でもシリアル仲介プログラムを利用しなくても、動作できるようになった

• Windowsでmsysツール群のPATHを内部設定し、期待しないmakeが呼び出されないようにした

• TWELITE未接続でも書き込み画面に移動できるようにした(B,Rキーを入力し、対象のTWELITEモデルを指定する)

• VSCodeを利用する設定を行った場合は、ActやTweAppsを選択したときに、ビルドを実行せず、build/以下の.binファイルを書き込む画面を開くようにした。（ビルドはVSCodeから実施します）

• いくつかの環境変数を内部的に設定し、TWELITE STAGEから起動したVSCodeにこれらを参照させることで、VSCodeから適切なビルドを実行、VSCodeのコード解釈に対して適切なライブラリソースを参照できるようにした

• MWSDKディレクトリ以下にサンプルコードが格納されているが、ビルド対象のディレクトリをドロップすることで、MWSDK以外のディレクトリでもビルドや書き込み作業をできるようにした（ディレクトリ名に空白や日本語文字などが含まれてはいけません）

• 始動時のコンソール画面に、内部のディレクトリ設定や環境変数の設定内容を表示するようにした

• 終了時は１秒待ってからSTAGE APPを終了するようにした

1.0.7pre2

• Raspberry Pi の対応を強化 (1.0.7pre2)

  • serial0 の対応（TWELITE STAGE HAT)

  • Zero 向けビルドを追加(対応ライブラリでビルド＆描画フェード機能を無効化)

1.0.3 MWSTAGE2020_12収録版

• TWELITE CUE対応（パーサー・CUEビューア）

• 書換メニューで、書き込み時にベリファイ（比較）を行うようにした。

• Apple Silicon暫定対応（TWELITE_Stage.command はユニバーサルアプリ、シリアル処理用の外部コマンドsersrv_ftdi.command、Toolsは Rosetta2 で動作可能な intel バイナリを再ビルド、シリアル通信は外部コマンド経由のため遅くなります)

既知の問題

• 起動時にAlt(Cmd)押し下げ時のヘルプメッセージが出現しない場合がある。Alt(Cmd)+0を入力することで表示されます。

• 書換メニューでファイル名が長すぎる場合に、行の行事が乱れる場合がある。

• Apple Siliconでの動作については十分な検証を行っていません。

0.9.11 MWSTAGE2020_10, Raspberry Pi 版 (暫定版)

(※包括的な検証を実施しないバージョンです)

• Raspberry Pi での動作

• その他、機能調整

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

リリース初版

Windows macOS Linux RasPi

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

ログの開始

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

ログ記録の終了

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

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

※ RaspberryPi ではログファイルの保存のみで開く機能はありません。

ログの記録

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

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

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

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

Windows macOS Linux

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

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

Windows macOS Linux RasPi M5Stack

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

この画面はターミナルとほぼ同じ振る舞いをしますが、インタラクティブモード遷移のための操作と離脱の検出を行うなど、インタラクティブモードに固有の機能が追加されています。

Windows macOS Linux M5Stack RasPi

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

プロジェクトフォルダに000desc.txtが作成されていると、TWELITE STAGE APPは、プロジェクトフォルダの一覧でその内容を表示します。

ファイルは UTF-8 で記述します。書式は２種類あります。

書式1

Windows macOS Linux M5Stack RasPi

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

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

一覧表示

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

選択表示

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

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

M5Stack

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

ハードウェア接続

TWELITE STAGE ボード

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

最小限の接続

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

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

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

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

Windows macOS Linux M5Stack RasPi

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

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

通信相手はTWELITE PALです。

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

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

Windows macOS Linux RasPi

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

Windows macOS Linux RasPi

ビルド中

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

ビルドエラー

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

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

書換中

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

v1.0.2以降は、ファームウェア書き換え後に、書き換え内容を読み出して確認するベリファイ処理を行います。

書換失敗

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

書換完了

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

v1.0.2以降は、ファームウェア書き換え後に、書き換え内容を読み出して確認するベリファイ処理を行います。

Windows macOS Linux M5Stack RasPi

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

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

Windows macOS Linux M5Stack RasPi

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

Windows macOS

Windows

環境

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

Windows macOS Linux RasPi M5Stack

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

共通のキー

Windows macOS Linux RasPi M5Stack

ヘルプ画面

Windows macOS Linux RasPi

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

Alt(Cmd)+操作

Windows macOS Linux RasPi

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

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

Windows macOS Linux RasPi

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

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

Windows macOS Linux RasPi

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

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 RasPi

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

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

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

Windows macOS Linux RasPi

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

Windows macOS Linux M5Stack RasPi

TWELITE CUEやTWELITE ARIA通知メッセージを解釈します。

TWELITE CUEタブ

TWELITE CUEのデフォルト設定(CUEモード)は、コイン電池でも動作できるスリープを用いた間欠駆動をしながら、いくつかの要因により起床し、起床後様々な情報を送信しいます。

起床要因

• タイマーの起床（設定値による定期起床）

• 加速度の検出による起床

• 磁気センサーによる起床（磁石が近づいたことを検出した場合）

送信データ

• 検出イベント（後述）

• モジュール電源電圧

• 磁気センサーの検出値

パケット

パケットの基本情報を表示します。

イベント

TWELITE CUEのデフォルトの出力では、必ず加速度イベントとして出力します。起床要因に関わらず、起床後には一定サンプル数の加速度計測を行います。この加速度の結果に応じたイベントが送信します。

電圧

モジュールの電源電圧[mV]です。

磁石

検出された磁石の極または未検出を表示します。

加速度

起床後に計測された加速度を表示します。

TWELITE ARIAタブ

TWELITE ARIAのデフォルト設定(ARIAモード)は、コイン電池でも動作できるスリープを用いた間欠駆動をしながら、いくつかの要因により起床し、起床後様々な情報を送信しいます。

起床要因

• タイマーの起床（設定値による定期起床）

• 磁気センサーによる起床（磁石が近づいたことを検出した場合）

送信データ

• モジュール電源電圧

• 磁気センサーの検出値

• 温湿度データ

パケット

パケットの基本情報を表示します。

データ表

TWELITE ARIAから受信した過去9回分のデータの履歴を表示します。上にあるほど新しいデータです。

時間(s)

TWELITE STAGE APPが起動してからデータを受信するまでの時間[秒]です。

ID

モジュールの論理デバイスIDです。

VCC(mV)

モジュールの電源電圧[mV]です。

温度(C)

モジュールが計測した温度(℃)です。

湿度(%)

モジュールが計測した湿度(％)です。

磁石

検出された磁石の極または未検出を表示します。

解説タブ

簡易マニュアルです。

画面例

Windows macOS Linux RasPi

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

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

VSCodeを利用する設定（アプリ書換＞codeでフォルダを開く）になっている場合は、ビルドは行わずbuild/以下のを開きます。

フォルダ

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

操作

TWELITE STAGE APP は、TWELITE STAGE SDKパッケージ内のフロントエンドアプリケーションとして動作します。ここでは、そのフォルダ構成について解説します。

MWSDK フォルダ

MWSDK フォルダには、TWELITE無線マイコンのソフトウェアを構築するためのライブラリや、サンプル、TWELITE APPS のソースコードが含まれます。

RasPi

TWELITE Stage アプリは Raspberry Pi で動作します。

• X11を用いないフレームバッファによる描画を行います。

• マウスとタッチスクリーンに対応します。

TWELITE STAGE APP では、内部的に環境変数を設定して make などのビルドプログラムの動作を行います。事前に環境変数の設定は不要です。

内部的に設定される環境変数

Windows macOS Linux RasPi M5Stack

各種設定を行います。

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

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

ルートメニュー

共通設定

アプリ書換

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

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