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 です。

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

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

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

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

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

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 向けビルドを追加(対応ライブラリでビルド＆描画フェード機能を無効化)

  • X11 デスクトップ向けビルドを追加

• 一般のFTDIデバイス(FT232,FT230)でも利用できるようにした。ファームウェア書き込みモードは手動で行う必要があります

• Windowsで、シリアルポート選択画面でcキーを押すことでWindowsで割り当てられているCOMポートを表示する機能を追加した

• ボーレートを115200bpsから変更できるようにした

• 描画フェード機能を無効にするコマンドラインオプション(-E 0)を追加。

1.0.3 MWSTAGE2020_12収録版

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

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

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

• ディレクトリ構成で MWSTAGE/MWSDK/Tools を MWSTAGE/Toolsに移動した。(MWSDKをMWSDK_COMMONレポジトリをそのまま利用できるようにするため)

• TWELITE_Stage.ini (起動ファイル名から拡張子を取り除き .ini を付加) を、起動時に読み込みMWSDKディレクトリを選択できるようにした。(古い版のライブラリ一式を簡単に切り替えられるようにした)

• 画面描画用のSDL2ライブラリを 2.0.12 に変更した (Windows, MacOS, RaspberryPi)。

• Windows では static ビルドとして DLL ファイル不要とした。

• make -j による並列ビルド数を(物理CPU数 - 1)とした。

• 書換メニューのいくつかの場所で、シリアルポートの再オープンを明示的に行うようにした。デバイスの抜き差しを行ったときなどにUSB接続が切断した場合などに、復帰しやすいようにした。

• Alt(Cmd)+Shift+m, t で mwx, twesettings を開くとき TWENET/usever.mk 記載のディレクトリを

  　開くようにした。

• [Raspberry Pi] 初回起動時に /dev/serial0 での書込メニュー遷移が失敗する問題を修正。

既知の問題

• 起動時に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にコマンドを送付)

• ビューア＞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

リリース初版

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

$ cd ./MWSTAGE/TWELITE_Stage/INSTALL/ubuntu/
$ sudo ./set_udev_sudo.sh

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

ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001",
   MODE="0666",
   RUN+="/bin/sh -c 'rmmod ftdi_sio && rmmod usbserial'"
ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6015",
   MODE="0666",
   RUN+="/bin/sh -c 'rmmod ftdi_sio && rmmod usbserial'"

Centos 7

$ cd ./MWSTAGE/TWELITE_Stage/INSTALL/centos/
$ sudo ./set_udev_sudo.sh

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

ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001",
   MODE="0666", 
   RUN+="/bin/sh -c '/usr/sbin/rmmod ftdi_sio'"
ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6015",
   MODE="0666", 
   RUN+="/bin/sh -c '/usr/sbin/rmmod ftdi_sio'"

アプリケーション登録

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

Ubuntu 16.04, 18.04, 20.04

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

$ cd ./MWSTAGE/TWELITE_Stage/INSTALL/ubuntu/
$ ./make_launch_icon.sh

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

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

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

RasPi

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

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

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

• ビルドツールチェインが付属しコンパイルも可能です。

環境

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

• Hardware

  • Raspberry Pi 3 Model B

  • LCD Screen: Raspberry Pi Touch Display (7")

• OS & distribution

  • Raspberry PI OS (32bit) Lite (Version:August 2020)

既知の問題・制限事項

• 1回目の起動で /dev/serial0 の動作が失敗することがある。

• Raspberry Pi 4B ではタッチスクリーンの動作は未検証です。

• TWELITE STAGE への入力文字列が/dev/tty1上で動作してるシェルやgettyへ入力文字列がそのまま渡されます。/dev/tty1から起動することを推奨します。

• 他のインストールや動作のプログラム(X11など)に影響を受けることがあります。

アーカイブの展開

ダウンロードしたアーカイブファイルは、パス名に空白や日本語などが含まれないディレクトリに展開します。

以下ではRaspberry Piのホームディレクトリに展開してます。

$ cd /home/pi
$ unzip MWSTAGE2020_XX_YYYY.zip

ディレクトリ構成

../MWSTAGE
     TWELITE_Stage.run    TWELITE_Stage アプリ
     BIN/                 ファームウェアBINファイル
     MWSDK/               MWSDK ライブラリなど
     TWELITE_Stage/       TWELITE_Stage アプリ関連ファイル

デバイスドライバ

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

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

$ cd ./MWSTAGE/TWELITE_Stage/INSTALL/ubuntu/
$ sudo ./set_udev_sudo.sh

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

ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001",
   MODE="0666",
   RUN+="/bin/sh -c 'rmmod ftdi_sio && rmmod usbserial'"
ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6015",
   MODE="0666",
   RUN+="/bin/sh -c 'rmmod ftdi_sio && rmmod usbserial'"

UARTについて

上述の環境では、raspi-config よりシリアルポートの設定をすることで /dev/serial0 が利用可能になります。

  $ sudo raspi-config

  メニューより
  "3 Interface Options    Configure connections to peripherals"
  →"P6 Serial Port Enable/disable shell messages on the serial connection"

  以下のようにログインシェルとしては利用しない、ハードウェアを有効化するを選択します。
  "Would you like a login shell to be accessible over serial?" -> <No>
  "Would you like the serial port hardware to be enabled?" → <Yes>

配線例

 [TWELITE]               [RaspberryPi]
  GND  ------------------ Gound (#6,#9,#14,#20,#25,#30,#34,#39のいずれか)
  TXD(DIO6,DIP#10) ------ GPIO15/UART0 RXD (#10)
  PRG(SPIMISO,DIP#7) ---- GPIO23 (#16)
  RXD(DIO7,DIP#3) ------- GPIO14/UART0 TXD (#8)
  RST(RESETN,DIP#21) ---- GPIO22 (#15)
  VCC  ------------------ 3V3 (#1,#17のいずれか)
  SET(DIO12,DIP#15) ----- GPIO12 (#32)

• TWELITE, RaspberryPi ともに製造元のマニュアルを参照ください。

• DIP# は TWELITE DIP のピン番号です。

• 上記配線は TWELITE 無線マイコンモジュールが安定稼働することを保証するものではありません。

TWELITE Stage アプリの起動

• X11のデスクトップ上では動作しません。X11を終了しておきます。

• TWELITE_Stage.runを実行します。スクリーン画面上のTWELITE Stageアプリが表示されます。

留意事項

• マウスとタッチパネルに対応します。

• TWELITE Stage アプリ中で、入力した文字はコンソール画面にも表示される場合があります。

その他

/dev/dri

TWELITE_Stage.run 起動時に以下のエラーが出る場合があります。

  "The path /dev/dri/ cannot be opened or is not available"

無視しても構いません。

メモリ不足

ビルド時はCPU数が4以上の場合は、CPU数を一つ引いた値の並列コンパイルを実行します(4コアなら3並列)。場合によってはメモリ不足が発生するかもしれません。その場合は並列数を変更してください。

RaspberryPi 4

以下の設定が必要です。OpenGL関連のドライバが有効にする必要があります。

• raspi-config の Advanced Settings → A2 GL Driver → G2 GL (Fake KMS) を選択する

• libgles-dev パッケージを導入しておく

• タッチスクリーンの動作は未検証です

macOS

環境

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

• macOS Mojave (10.14.6)

• macOS Catalina (10.15.4)

• macOS BigSur (11.1, Device Transfer Kit)

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

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

• 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

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

Windows macOS Linux M5Stack RasPi

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

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

Windows macOS Linux RasPi

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

Windows

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

RasPi

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

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接続は記載していません。

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/Mac/Linux

Windows macOS Linux

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

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

RaspberryPi

RasPi

X11を用いないフレームバッファに表示されます。

通常（フレームバッファ上のシェル画面から起動した場合）はコンソール画面は表示されません。

M5Stack

M5Stack

Windows macOS Linux M5Stack RasPi

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

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

Windows macOS Linux M5Stack RasPi

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

Windows macOS Linux M5Stack RasPi

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

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

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

Windows macOS Linux M5Stack RasPi

のを解釈します。

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

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

Windows macOS Linux M5Stack RasPi

のを解釈します。

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

通信相手はTWELITE PALです。

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

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

Windows macOS Linux M5Stack RasPi

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

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

一覧表示

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

選択表示

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

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

Windows macOS Linux M5Stack RasPi

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

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 M5Stack RasPi

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

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

タブ：TWELITE

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

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

タブ:NOTICE

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

画面下部の表示

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

Windows macOS Linux RasPi

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

Windows macOS Linux RasPi M5Stack

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

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

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

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

[画面黒背景にする]
  ↓
[TWELITE無線マイコンリセット (制御可能ならSET=LO)]
  ↓
<間欠動作アプリのインタラクティブモードメッセージを検出？> --YES--> [操作画面]へ
  ↓タイムアウト
['+' を３回入力]
  ↓
<通常アプリのインタラクティブモードメッセージを検出？> --YES--> [操作画面]へ
  ↓タイムアウト
[操作画面へ] ※ この状態はインタラクティブモードではない

[操作画面]
  ↓
<インタラクティブモード脱出メッセージ?> --> [終了]
  ↓
<画面離脱操作 [ A ] 長押しなど> --> [終了]
  ↓
<ESC ?> -> <入力中判定> --NO-> [終了]
  ↓            ↓
[入力文字列をTWELITE無線モジュールへ送信]
  ↓
[操作画面]へ戻る

[終了]
  ↓
[TWELITE無線マイコンリセット]
  ↓
[画面離脱] インタラクティブモード画面を終了し前の画面へ戻る  

Windows macOS Linux RasPi

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

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

../MWSTAGE/            TWELITE STAGE SDK インストール
    /TWELITE_Stage.??? 実行形式 (Windwows .exe, macOS .command, Linux .run)
    /TWELITE_Stage.sav 設定ファイル
    /TWELITE_Stage.ini その他設定(MWSDKディレクトリ名指定)
    /TWELITE_Stage/    TWELITE STAGE APP の関連ファイル

    /MWSDK/            MWSDKのライブラリなど
    /BIN/              [BINファイル選択]時の格納先
    /log/              ログ格納先
    
    /Tools/            gcc コンパイラなどのツール一式
    
※ 本構成は MWSDK2020_11 以降です。
※ MWSDK2020_10以前との大きな相違は Tools の配置です。
../MWSTAGE/
    /MWSDK/
      /Tools/          <= Tools は MWSDK内に格納
    (/MWSDK.ini) .     <= MWSDK.ini は非対応

MWSDK フォルダ

MWSDK/
  Act_samples/   : mwx ライブラリによるサンプルコード 
  Wks_TweApps/   : TWELITE APPS のソースコード 
  Act_extras/    : mwx ライブラリによるより専門的なサンプル、他のライブラリを引用したもの
  TWENET/        : TWENET ライブラリ (mwx ライブラリなど) 
  ChipLib/       : 半導体ライブラリ  
  MkFiles/       : Makefile の本体処理部分     
  000manifest    : MWSDKのバージョン情報

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

MWSDK.ini

# MWSDK.ini の例
# MWSDK=MWSDK
MWSDK=MWSDK2020_10

MWSDK/ フォルダの替わりに別のフォルダを指定したいときに編集します。複数のライブラリバージョンを混在させる場合に便利です。上記の例では MWSDK2020_10フォルダを利用します。

BINフォルダ

TWELITE STAGE APP の [BINから選択] メニューを選択したとき、このフォルダにある TWELITE 無線マイコン用のファームウェアファイル (.BIN) が列挙されます。

logフォルダ

TWELITE STAGE APP でシリアルポートのログ機能を実行したときに、このフォルダにログファイルが格納されます。

Tools フォルダ

gcc, g++ などのクロスコンパイラの toolchain などが含まれます。

プラットフォーム特有のユーティリティもこのフォルダに格納されます。詳しくは Tools/reame-j.txt を参照してください。

ビルドプロジェクトフォルダについて

フォルダの検索順

以下の順でビルドプロジェクトフォルダ (Act_samples など) を検索します。

1. TWELITE STAGE APPが起動したときのフォルダ

2. TWELITE STAGE APPの実行形式があるフォルダ

3. {MWSDKフォルダ}/..

4. {MWSDKフォルダ}

Wks_Acts

Wks_Acts フォルダが存在する場合は、Act_samples フォルダの替わりに、このフォルダをメニューの[Actビルド＆書換]メニューから参照します。

Windows macOS Linux

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

Windows macOS Linux RasPi 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) 書換完了後の画面
l: (         0) LTOを行わない

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

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

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

Windows macOS Linux RasPi

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

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

ビルド～書き込み画面

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

フォルダ

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

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

操作

Windows macOS Linux RasPi

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

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

ビルド～書き込み画面

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

フォルダ

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

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

操作

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

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

参考１

.vscode/settings.json の設定例（抜粋）

    "C_Cpp.default.includePath": [
        "${env:MWSDK_TWENET_LIBSRC}/include/**",
        "${env:MWSDK_TWENET_LIBSRC}/src/**"
    ],
    "C_Cpp.default.browse.path": [
        "${env:MWSDK_TWENET_LIBSRC}/include/**",
        "${env:MWSDK_TWENET_LIBSRC}/src/**"
    ],

"../../"で始まる定義は、TWELITE STAGEアプリからプロジェクトを開く場合は不要です。環境変数MWSDK_TWENET_LIBSRCを設定しない場合に、既定のディレクトリ構成の時にソース参照先を指定しています。

Windows macOS Linux M5Stack RasPi

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

ビルド中

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

ビルドエラー

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

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

書換中

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

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

書換失敗

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

書換完了

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

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

Windows macOS Linux RasPi

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

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

ビルド～書き込み画面

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

フォルダ

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

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

操作

M5Stack

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

利用するGPIOについて

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

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

キーボード

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

PS/2コネクタ

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

CardKB

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

M5Stack faces QWERTYタイプキーパッド

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

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

アプリ書換

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

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

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

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

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

書式1

• 1行目はタイトル行です。

• 2行目以降は詳細の記述です。

• 最終行が http で始まる場合は、ウェブサイトへのリンクになります。

書式２

iniファイルのような書式です。行頭から始まる項目名と=文字までを項目の定義として=以降が項目の内容です。