マニュアル

• 1: TWELITE STAGE SDK
• 1.1: 導入方法
• 1.1.1: フォルダ構成
• 1.1.2: プラットフォーム別の注意事項
• 1.1.2.1: Windowsへインストールする際の注意事項
• 1.1.2.2: macOSインストールする際の注意事項
• 1.1.2.3: Linuxへインストールする際の注意事項
• 1.1.2.4: Raspberry Piへインストールする際の注意事項
• 1.2: TWELITE STAGE APP
• 1.2.1: TWELITE STAGE APP マニュアル
• 1.2.1.1: パッケージの取得
• 1.2.1.2: 使用方法
• 1.2.1.2.1: キーとマウスの操作
• 1.2.1.2.2: 画面の操作
• 1.2.1.2.2.1: シリアルポート選択
• 1.2.1.2.2.2: メインメニュー
• 1.2.1.2.2.2.1: ビューア
• 1.2.1.2.2.2.1.1: ターミナル
• 1.2.1.2.2.2.1.2: 標準アプリ ビューア
• 1.2.1.2.2.2.1.3: グラフ
• 1.2.1.2.2.2.1.3.1: 加速度リアルタイムグラフ
• 1.2.1.2.2.2.1.3.2: センサーグラフ
• 1.2.1.2.2.2.1.4: 簡易モニタ
• 1.2.1.2.2.2.1.4.1: CUE ビューア
• 1.2.1.2.2.2.1.4.2: ARIA ビューア
• 1.2.1.2.2.2.1.4.3: グランサー
• 1.2.1.2.2.2.1.5: コマンダー
• 1.2.1.2.2.2.2: アプリ書換
• 1.2.1.2.2.2.2.1: BINから選択
• 1.2.1.2.2.2.2.2: actビルド&書換
• 1.2.1.2.2.2.2.3: TWELITE APPSビルド&書換
• 1.2.1.2.2.2.2.4: Act_extras
• 1.2.1.2.2.2.2.5: 指定
• 1.2.1.2.2.2.2.6: 再書換
• 1.2.1.2.2.2.2.7: ビルド・書換画面
• 1.2.1.2.2.2.3: インタラクティブモード
• 1.2.1.2.2.2.4: TWELITE STAGE の設定
• 1.2.1.2.2.2.5: シリアルポートの選択
• 1.2.1.2.3: ログ機能
• 1.2.1.3: 詳細な仕様
• 1.2.1.3.1: コマンドライン引数とiniファイルによる詳細設定
• 1.2.1.3.2: 環境変数
• 1.2.1.3.3: 000desc.txt によるプロジェクト説明の追加
• 1.2.1.4: ライセンス
• 1.2.1.5: 改訂履歴
• 1.3: TWELITE APPS
• 1.3.1: 超簡単！標準アプリ マニュアル
• 1.3.1.1: 超簡単！標準アプリ マニュアル
• 1.3.1.1.1: 超簡単！標準アプリのピン配置
• 1.3.1.1.2: 超簡単！標準アプリの動作モード
• 1.3.1.1.3: 超簡単！標準アプリの代替ボーレート設定
• 1.3.1.1.4: 超簡単！標準アプリのUART機能
• 1.3.1.1.5: インタラクティブモード（超簡単！標準アプリ）
• 1.3.2: 親機・中継機アプリ マニュアル
• 1.3.2.1: 親機・中継機アプリ マニュアル
• 1.3.2.1.1: 親機・中継機アプリの動作モード
• 1.3.2.1.1.1: 親機・中継機アプリの親機モード
• 1.3.2.1.1.1.1: 親機・中継機アプリの受信メッセージ
• 1.3.2.1.1.1.1.1: 超簡単！標準アプリからの出力（親機・中継機アプリ）
• 1.3.2.1.1.1.1.2: リモコンアプリからの出力（親機・中継機アプリ）
• 1.3.2.1.1.1.1.3: シリアル通信アプリからの出力（親機・中継機アプリ）
• 1.3.2.1.1.1.1.4: パル／キュー／アリアアプリからの出力（親機・中継機アプリ）
• 1.3.2.1.1.1.1.4.1: パルアプリからの出力（親機・中継機アプリ）
• 1.3.2.1.1.1.1.4.2: キューアプリからの出力（親機・中継機アプリ）
• 1.3.2.1.1.1.1.4.3: アリアアプリからの出力（親機・中継機アプリ）
• 1.3.2.1.1.1.1.4.4: パル・キュー・アリアアプリからの出力の詳細（親機・中継機アプリ）
• 1.3.2.1.1.1.1.5: actからの出力（親機・中継機アプリ）
• 1.3.2.1.1.1.1.6: 無線タグアプリからの出力（親機・中継機アプリ）
• 1.3.2.1.1.1.2: 親機・中継機アプリの送信コマンド
• 1.3.2.1.1.1.2.1: 超簡単！標準アプリへの入力（親機・中継機アプリ）
• 1.3.2.1.1.1.2.2: シリアル通信アプリへの入力（親機・中継機アプリ）
• 1.3.2.1.1.1.2.3: パルアプリ（通知パル）への入力（親機・中継機アプリ）
• 1.3.2.1.1.2: 親機・中継機アプリの中継機モード
• 1.3.2.1.2: インタラクティブモード（親機・中継機アプリ）
• 1.3.3: リモコンアプリ マニュアル
• 1.3.3.1: リモコンアプリ マニュアル
• 1.3.3.1.1: リモコンアプリのピン配置
• 1.3.3.1.2: リモコンアプリの動作モード
• 1.3.3.1.3: リモコンアプリの代替ボーレート設定
• 1.3.3.1.4: リモコンアプリのUART機能
• 1.3.3.1.5: リモコンアプリのカスタムデフォルト機能
• 1.3.3.1.6: リモコンアプリのペアリング機能
• 1.3.3.1.7: インタラクティブモード（リモコンアプリ）
• 1.3.4: シリアル通信アプリ マニュアル
• 1.3.4.1: シリアル通信アプリ マニュアル
• 1.3.4.1.1: シリアル通信アプリのピン配置
• 1.3.4.1.2: シリアル通信アプリの通信モード
• 1.3.4.1.2.1: シリアル通信アプリの書式モード（アスキー形式）
• 1.3.4.1.2.1.1: シリアル通信アプリ 書式モード（アスキー）の 0xDB コマンド
• 1.3.4.1.2.2: シリアル通信アプリの書式モード（バイナリ形式）
• 1.3.4.1.2.2.1: シリアル通信アプリ 書式モード（バイナリ）の 0xDB コマンド
• 1.3.4.1.2.3: シリアル通信アプリのチャットモード
• 1.3.4.1.2.4: シリアル通信アプリの透過モード
• 1.3.4.1.2.5: シリアル通信アプリのヘッダ付き透過モード
• 1.3.4.1.3: シリアル通信アプリのカスタムデフォルト機能
• 1.3.4.1.4: シリアル通信アプリの通信における注意点
• 1.3.4.1.5: インタラクティブモード（シリアル通信アプリ）
• 1.3.5: キューアプリ マニュアル
• 1.3.5.1: キューアプリ マニュアル
• 1.3.5.1.1: キューアプリの動作モード
• 1.3.5.1.1.1: キューアプリのTWELITE CUEモード
• 1.3.5.1.1.2: キューアプリの動作センサーパルモード
• 1.3.5.1.1.3: キューアプリの開閉センサーパルモード
• 1.3.5.1.2: キューアプリの設定方法
• 1.3.5.1.2.1: キューアプリのOTAによる設定
• 1.3.5.1.2.2: キューアプリのTWELITE R2/R3による設定
• 1.3.5.1.2.3: インタラクティブモード（キューアプリ）
• 1.3.6: アリアアプリ マニュアル
• 1.3.6.1: アリアアプリ マニュアル
• 1.3.6.1.1: アリアアプリの使用方法
• 1.3.6.1.1.1: アリアアプリの動作確認
• 1.3.6.1.1.2: アリアアプリの動作モード
• 1.3.6.1.1.2.1: アリアアプリのTWELITE ARIAモード
• 1.3.6.1.1.2.2: アリアアプリの開閉センサーパルモード
• 1.3.6.1.2: アリアアプリの設定方法
• 1.3.6.1.2.1: アリアアプリのOTAによる設定
• 1.3.6.1.2.2: アリアアプリのTWELITE R2/R3による設定
• 1.3.6.1.3: インタラクティブモード（アリアアプリ）
• 1.3.7: パルアプリ マニュアル
• 1.3.7.1: パルアプリ マニュアル
• 1.3.7.1.1: インタラクティブモード（パルアプリ）
• 1.4: act サンプル
• 1.4.1: act サンプル
• 1.4.1.1: act0..4
• 1.4.1.2: Scratch
• 1.4.1.3: Slp_Wk_and_Tx
• 1.4.1.4: Parent_MONOSTICK
• 1.4.1.5: PingPong
• 1.4.1.6: BRD_APPTWELITE
• 1.4.1.7: BRD_I2C_TEMPHUMID
• 1.4.1.8: BRD_ARIA
• 1.4.1.9: PAL_AMB
• 1.4.1.10: PAL_AMB-usenap
• 1.4.1.11: PAL_AMB-behavior
• 1.4.1.12: PAL_MAG
• 1.4.1.13: PAL_MOT-single
• 1.4.1.14: PAL_MOT-fifo
• 1.4.1.15: PulseCounter
• 1.4.1.16: WirelessUART
• 1.4.1.17: ユニバーサル レシーバー
• 1.4.1.18: Unit_???
• 1.5: 改版履歴
• 2: Pythonによるファームウェアの書き込み
• 2.1: Pythonによるファームウェアの書き込み
• 3: TWELITE SPOT / ESP32
• 3.1: 導入済みアプリケーションの概要
• 3.2: 無線性能に配慮した設置方法
• 3.3: ファームウェア開発環境の構築方法
• 3.3.1: Arduino IDE 1.x による開発環境の構築方法
• 3.3.1.1: Arduino IDE 1.x の導入
• 3.3.1.2: Arduino core for the ESP32 の導入
• 3.3.1.3: Arduino core for the ESP32 の設定
• 3.3.1.4: MWings ライブラリの導入
• 3.4: ファームウェアの書き込み方法
• 3.4.1: ESP32 へのファームウェアの書き込み方法
• 3.4.1.1: ESP32 へのスケッチの書き込み方法
• 3.4.1.2: ESP32 へのファイルの書き込み方法
• 3.4.1.3: ESP32 のパーティションテーブルを指定した書き込み方法
• 3.4.2: TWELITE へのファームウェアの書き込み方法
• 3.4.3: ファームウェアの初期化方法
• 3.4.3.1: ESP32 のファームウェアの初期化方法
• 3.4.3.2: TWELITE のファームウェアの初期化方法
• 3.5: サンプルスケッチの解説
• 3.5.1: TWELITE と通信するスケッチの解説
• 3.5.1.1: 超簡単！標準アプリのデータを取得・操作
• 3.5.1.1.1: 超簡単！標準アプリのデータを取得・操作
• 3.5.1.1.2: 超簡単！標準アプリのデータを取得・操作
• 3.5.1.1.3: 超簡単！標準アプリのデータを取得・操作
• 3.5.1.2: キューアプリのデータを取得
• 3.5.1.2.1: キューアプリのデータを取得
• 3.5.1.2.2: キューアプリのデータを取得
• 3.5.1.2.3: キューアプリのデータを取得
• 3.5.1.3: アリアアプリのデータを取得
• 3.5.1.3.1: アリアアプリのデータを取得
• 3.5.1.3.2: アリアアプリのデータを取得
• 3.5.1.3.3: アリアアプリのデータを取得
• 3.5.2: TWELITE に加えて無線 LAN を活用するスケッチの解説
• 3.5.2.1: プリインストール済みスケッチ
• 3.5.2.1.1: プリインストール済みスケッチ
• 3.5.2.1.2: プリインストール済みスケッチ
• 3.5.2.2: WebSocketによる中継
• 3.5.2.2.1: WebSocketによる中継
• 3.5.2.3: REST API の使用
• 3.5.2.3.1: REST API の使用
• 3.5.2.3.2: REST API の使用
• 3.5.2.4: Google スプレッドシートの利用
• 3.5.2.4.1: Google スプレッドシートの利用
• 3.5.2.5: ThingSpeak によるグラフ表示
• 3.5.2.5.1: ThingSpeak によるグラフ表示
• 4: TWELITE WINGS API / MWings
• 4.1: TWELITE Wings API / MWings for Python
• 4.1.1: TWELITE Wings API / MWings for Python
• 4.2: TWELITE Wings API / MWings for 32-bit Arduinos
• 4.2.1: TWELITE Wings API / MWings for 32-bit Arduinos
• 4.2.1.1: TWELITE SPOT に使用する
• 4.2.1.2: Arduino UNO R4 に使用する
• 4.2.1.3: パケットパーサの拡張
• 5: Miscellaneous
• 5.1: TWELITE PAL/CUE/ARIA Script
• 5.1.1: 使用方法
• 5.1.2: ソースファイル
• 5.1.2.1: PAL_Script.py
• 5.1.2.2: Main_user.py
• 5.1.2.3: MNLib
• 5.1.2.3.1: apppal.py
• 5.1.2.3.2: appbase.py
• 5.1.2.3.3: mwSerial.py
• 5.1.2.3.4: parseFmt.py parseFmt_*.py
• 5.2: TWE Programmer

1 - TWELITE STAGE SDK

1.1 - 導入方法

動作環境によっては、本アプリケーションの動作に各種設定が必要です。問題が生じた場合には、本資料の記述を参考にして環境を整備してください。

TWELITE STAGE SDK のインストール手順

① アーカイブを取得

各プラットフォーム (Windows / macOS / Linux) 用の TWELITE STAGE SDK を ダウンロード します。

brew install twelite-stage

② アーカイブを展開

ダウンロードしたZipアーカイブを展開します。

③ ファイルを確認

展開先のフォルダを確認します。

展開先のフォルダ {MWSTAGE インストール} には、以下が含まれます。

• TWELITE STAGE APP
  • Windows の場合：TWELITE_Stage.exe（通常版）、TWELITE_Stage_VSCode.exe（VSCode対応版）
  • macOS の場合：TWELITE_Stage.command（通常版）、TWELITE_Stage_VSCode.command（VSCode対応版）
  • Linux の場合：TWELITE_Stage.run（通常版）、TWELITE_Stage_VSCode.run（VSCode対応版）
• TWELITE_STAGE - TWELITE STAGE APP の関連ファイル
• MWSDK - ライブラリ、ソースコードなど
• Tools - ビルドするためのツールチェインなど
• BIN - TWELITE STAGE APP の [BINから選択]メニューで参照されるTWELITE 向け.BINファイル
• log - TWELITE STAGE APP のログ機能やデータベースファイルの保存先
• flask_wsns_db - Python, Flask, sqlite3 による簡易的なサーバ

詳細は「フォルダ構成」をご覧ください。

1.1.1 - フォルダ構成

TWELITE STAGE APP は、TWELITE STAGE SDK のフロントエンドアプリケーションとして動作します。

ここでは、そのフォルダ構成について解説します。

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

  MWSDK/            : MWSDKのライブラリなど
  BIN/              : [BINファイル選択]時の格納先
  log/              : ログ・データベース格納先

  Tools/            : gcc コンパイラなどのツール一式

  flask_wsns_db/    : Python, Flask, sqlite3 による簡易的なサーバ

MWSDK フォルダ

MWSDK/
  Act_samples/        : mwx ライブラリによるサンプルコード
  Wks_TweApps/        : TWELITE APPS のソースコード
  Act_extras/         : mwx ライブラリによるより専門的なサンプル、他のライブラリを引用したもの
  TWENET/             : TWENET ライブラリ (mwx ライブラリなど)
  ChipLib/            : 半導体ライブラリ
  MkFiles/            : Makefile の本体処理部分
  docs/               : ライブラリマニュアルなど
  LICENSE             : MWSDKのライセンス記述
  000manifest         : MWSDKのバージョン情報
  ReleaseNotes.md     : 更新履歴(トップページ)
  ReleaseNotes_en.md  : 更新履歴(英語)
  ReleaseNotes_jp.md  : 更新履歴(日本語)

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

TWELITE_Stage.sav

TWELITE STAGE APPの設定情報を記録します。

ファイル名は TWELITE STAGE APP 実行形式名 + .sav です。

TWELITE_Stage.ini

.iniファイルの詳細はこちら。

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

設定の異なる TWELITE STAGE APP を実行する

TWELITE_Stage.exe (Windows の場合) を別のファイル名でコピーします。 例えば TWS1.exe と変更した場合は、TRS1.sav, TRS1.ini という設定ファイルを参照します。

BIN フォルダ

TWELITE STAGE APP の [BINから選択] メニューを選択したときには、このフォルダにある ファームウェアファイル (.BIN) を利用します。

log フォルダ

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

グラフ機能を用いた場合のデータベースファイルの格納先や、csvファイルの出力先もこのフォルダです。

Tools フォルダ

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

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

flask_wsns_db フォルダ

TWELITE STAGE APP のセンサーグラフビューアで作成したデータベースにアクセスするためのPythonのサンプルスクリプトです。 本サンプルでは表やグラフでデータをWebブラウザで閲覧することができます。

詳しくは flask_wsns_db/README.html を参照してください。

ビルドプロジェクトフォルダ

フォルダの検索順

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

1. TWELITE STAGE APP が起動したときのフォルダ
2. TWELITE STAGE APP の実行形式があるフォルダ
3. {MWSDKフォルダ}/..
4. {MWSDKフォルダ}

Wks_Acts

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

1.1.2 - プラットフォーム別の注意事項

TWELITE STAGE APP を各プラットフォームにインストールする際の注意事項を記載しています。

1.1.2.1 - Windowsへインストールする際の注意事項

環境

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

• Windows10 バージョン 1903
• VisualStudio 2019 (32bit ビルド)

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

MONOSTICK や TWELITE R シリーズには、 FTDI社の USBシリアル変換IC（FT230/FT232 シリーズ）を搭載しています。これらを利用するために、デバイスドライバのインストールが必要となる場合があります。

PC がMONOSTICK や TWELITE R を認識しない場合には、 https://www.ftdichip.com より D2XX ドライバをインストールしてください。

Visual C++ ランタイムライブラリの追加インストール

場合によっては、Visual Studio 2019 の Visual C++ 頒布可能コード（ランタイムライブラリ）が必要です。

アプリケーションの起動時にエラーが出て起動しない場合は、本パッケージで再配布している TWELITE_Stage¥INSTALL¥VC_redist.x86.exe を実行するか、マイクロソフト社のウェブサイトから入手してください。なお、再配布バイナリは 32bit です。

1.1.2.2 - macOSインストールする際の注意事項

環境

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

• macOS 10.14 (Mojave, Intel)
• macOS 12 (Monterey, Apple Silicon)

依存するソフトウェアや警告ダイアログについて

下記の事象が発生した場合には、 TWELITE_Stage.command の動作のために、実行の許可やインストールが必要です。

• ツールチェインにはコード署名がなされていますが、コード署名が正しく認証されない場合は、ビルドツールチェイン (ba-elf-gcc など) の実行形式一つずつについて、動作許可を求められる場合があります。
• ダウンロードアーカイブには署名しておりません。実行時には、インターネットからダウンロードされたアプリケーションとしてセキュリティ警告が出る場合があります。
• TWELITE_Stage.command をインストールしたパスからの実行許可を要求される場合があります。
• ビルド実行時に make ユーティリティのインストールダイアログが出る場合があります。

make ユーティリティの追加インストール

場合によっては、make ユーティリティをインストールしなくてはなりません。

コマンドライン (zsh) から make を実行したときに、エラーが出る場合には Command Line Tools をインストールします。

xcode-select --install

インストールが完了したら、make を入力して以下のメッセージの出力を確認します。

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

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

MONOSTICK や TWELITE R シリーズには、 FTDI社 (https://www.ftdichip.com) の USBシリアル変換IC（FT230/FT232 シリーズ）を搭載しています。これらを利用するために、デバイスドライバのインストールが必要となる場合があります。

TWELITE_Stage.command を起動してもシリアルポートが表示されない場合は、FTDI社のドライバをアンロード（無効化）してください。

https://www.ftdichip.com/Drivers/D2XX.htm より D2xxHelper をダウンロードできます。 なお、TWELITE STAGE SDKの TWELITE_Stage/INSTALL フォルダにも同じものを収録しています。

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

FTDI 関連のドライバをアンロードするには、以下のコマンドを実行します。

sudo kextunload -b com.apple.driver.AppleUSBFTDI

1.1.2.3 - Linuxへインストールする際の注意事項

環境

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

• Ubuntu 16.04, 18.04, 20.04
• NNLinux Beta8 64bit
• CentOS 7

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

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 のアイコンが追加されます。

1.1.2.4 - Raspberry Piへインストールする際の注意事項

TWELITE STAGE APPは、一部を除く Raspberry Pi で動作します。

• マウスとタッチスクリーンに対応します。
• ビルドツールチェインが付属しており、コンパイルもできます。
• 実行形式には、X11版のほかにフレームバッファ版（nox）があるほか、半透明エフェクトなどを省略した軽量版があります。

環境

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

ハードウェア

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

ソフトウェア

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

既知の問題・制限事項

• 1回目の起動で /dev/serial0 の動作に失敗することがあります。
• Raspberry Pi 4B では /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'"

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

上述の環境では、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?" -> 
  "Would you like the serial port hardware to be enabled?" → 

配線例

 [TWELITE]               [Raspberry Pi]
  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, Raspberry Pi それぞれのマニュアルを参照してください。
• DIP# は TWELITE DIP のピン番号です。
• 上記の配線は TWELITEが安定稼働することを保証するものではありません。

TWELITE STAGE APPの起動

• フレームバッファ版(nox)はX11のデスクトップ上では動作しません。X11を終了しておきます。
• TWELITE_Stage.runを実行します。スクリーン画面上のTWELITE STAGE APPが表示されます。

留意事項

• マウスとタッチパネルに対応します。
• TWELITE STAGE APP中で、入力した文字はコンソール画面にも表示される場合があります。

その他

/dev/dri エラー

TWELITE_Stage.run の起動時に以下のエラーが出る場合がありますが、無視して構いません。

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

メモリ不足

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

Raspberry Pi 4

Raspberry Pi OS (bookworm)

sudo apt update
sudo apt install --reinstall libraspberrypi0 libraspberrypi-dev libraspberrypi-doc libraspberrypi-bin

sudo apt update
sudo apt install raspberrypi-ui-mods

cd MWSTAGE
wget https://twelite.net/files/TWELITE_Stage_Wayland.run.zip
unzip TWELITE_Stage_Wayland.run.zip
./TWELITE_Stage_Wayland.run

cd MWSTAGE
wget https://twelite.net/files/TWELITE_Stage_Wayland_64.run.zip
unzip TWELITE_Stage_Wayland_64.run.zip
mv Tools/ba-elf-ba2-r36379 Tools/ba-elf-ba2-r36379-bkup32
wget https://twelite.net/files/ba-elf-ba2-r36379_aarch64.tgz
tar -xzf ba-elf-ba2-r36379_aarch64.tgz
mv ba-elf-ba2-r36379 Tools/
./TWELITE_Stage_Wayland_64.run

1.2 - TWELITE STAGE APP

1.2.1 - TWELITE STAGE APP マニュアル

様々なプラットフォームで動作します。

• Windows10
• macOS (High Sierra 以降、Intel および Apple Silicon Mac に対応)
• Linux (Ubuntu18.04)
• Raspberry Pi (Raspberry Pi 3 Model B, Lcd Touch Screen, Raspberry Pi OS August-2020)
• (M5stack : バージョン1.0 まで対応。v1.3以降はソースレベルで非対応です。)

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

本資料について

• 対象のプラットフォームを示すため、一部のページでは以下を記載しています。
  • Windows   – Windows 10
  • macOS   – Mac OS X, OS X, macOS
  • Linux   – Ubuntuなど（64bit）
  • RasPi   – Raspberry Pi

1.2.1.1 - パッケージの取得

最新版のTWELITE STAGE アプリは、以下のいずれかの方法で取得できます。

TWELITE STAGE SDK 全体（公式サイト）

モノワイヤレス公式サイトでは、TWELITE STAGE アプリを含む開発ツール一式（Windows/macOS/Linux用）を配布しています。

TWELITE STAGE-トワイライトステージ - MONO-WIRELESS.COM

TWELITE STAGE アプリのみ（GitHub）

モノワイヤレス公式リポジトリでは、TWELITE STAGE アプリ単体のバイナリを配布しています。 TWELITE STAGE アプリだけを更新する場合や、M5Stack版を取得する際にはこちらをご利用ください。 各バイナリのバージョンはGitHub上のtagから識別できます。

Windows

monowireless/TWELITE_Stage_BIN_Win: Binary Distribution of TWELITE Stage.

macOS

monowireless/TWELITE_Stage_BIN_macOS: Binary distribution of TWELITE Stage for macOS

Linux

Linux 版のバイナリは個別に配布しておりません。 バイナリは TWELITE STAGE SDK パッケージから取得してください。 もしくは、ソースコードからビルドしてください。

Raspberry Pi

Raspberry Pi 版のバイナリは個別に配布しておりません。 バイナリは TWELITE STAGE SDK パッケージから取得してください。 もしくは、ソースコードからビルドしてください。

M5Stack

バージョン 1.0.3a までを以下のページで配布しております。

monowireless/TWELITE_STAGE_Bin_M5Stack

ソースコード (MWM5ライブラリ)

TWELITE STAGE のソースコードを含む MWM5 ライブラリは以下のページで公開しています。

monowireless/mwm5

TWELITE STAGE アプリのソースコードは、examples/TWELITE_Stageに配置しています。

1.2.1.2 - 使用方法

アプリの起動方法

TWELITE STAGE アプリを起動するには、{MWSTAGE インストール} にある実行形式を実行します。

実行はプラットフォーム(Windows, macOS, Linux)によって方法が異なります。

アプリの実行形式

TWELITE STAGE APP には、2種類の実行形式があります。

• TWELITE_Stage.{拡張子} - 標準設定で起動します。
• TWELITE_Stage_VSCode.{拡張子} - 「VSCode を使う」設定済みです(設定はTWELITE_Stage_VSCode.iniに保存)。VSCodeを使う設定を有効にすると、VSCodeを用いた開発作業に適した動作を行うようになります。

アプリの実行画面

アプリを起動すると、以下の２種類のウィンドウが表示されます。

• メイン画面
  • TWELITE STAGE APPのユーザインタフェースを表示します。
  • TWELITE STAGE APPの操作はこの中で行います。
• コマンド画面
  • 通常は使用しませんが、補助情報を表示します。
    • シリアル通信の内容が表示されるため、ログを確認する用途に最適です。
    • コマンドラインから実行した場合には、実行元のターミナルがコマンド画面となります。

アプリの終了

いずれかの方法で終了してください。

• 実行画面上の右上にマウスポインタを移動し、画面内に表示された終了ボタンを押します。
• 実行画面のウインドウを閉じます（macOSの場合は⌘Qも使用できます）。

1.2.1.2.1 - キーとマウスの操作

Windows   macOS   Linux   RasPi

キー操作

Windows   macOS   Linux   RasPi

Alt(⌘)を押しながら行うキー入力は、TWELITE STAGE APP の設定を変える操作等に割り当てられています。その他のキー操作は、通常は文字入力として機能します。

共通のキー

Windows   macOS   Linux   RasPi

ヘルプ画面

Windows   macOS   Linux   RasPi

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

ヘルプ画面は画面の左上部分にマウスポインタを移動することでも表示できます。

Alt(⌘)+操作

Windows   macOS   Linux   RasPi

Alt(⌘)を押しながら行う操作について解説します。

表中ではAlt(⌘)+の表記は省略しています。上記のヘルプ画面から使用可能なキーを確認できますが、下表に補足説明を示します。

その他の操作

マウス操作

Windows   macOS   Linux   RasPi

マウス操作は左クリックが中心ですが、右クリック、右ダブルクリック、ホイールを使う場合があります。

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

Windows   macOS   Linux   RasPi

画面下部のメニュー表示にマウスポインタを移動すると、[ A ], [ B ], [ C ] という表記のボタンが表示されます。 TWELITE STAGE APPは、この3つ並びのハードウェアボタンを模したメニューに画面ごとの機能を割り当てています。 このボタンを左クリックまたは左長押しクリックすることで、機能を呼び出しできます。（Alt(⌘)+a,s,d`` または Alt(⌘)+Shift+a,s,d`でも選択可能）

マウスによる画面操作

Windows   macOS   Linux   RasPi

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

画面はテキストのみの構成ですが、画面上部のタブや、反転表示の文字はマウスの左クリックで選択可能です。

1.2.1.2.2 - 画面の操作

Windows   macOS   Linux   RasPi

Windows / macOS / Linux / Raspberry Pi

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

コンソール画面には、ターミナルと同様にUART出力を表示します。

Raspberry Pi (nox)

X11 を使わず、フレームバッファに表示します。

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

1.2.1.2.2.1 - シリアルポート選択

Windows   macOS   Linux   RasPi

概要

Windows / macOS / Linux では、始動時にTWELITEが接続されたシリアルポートを選択する画面を表示します。 ただし、シリアルポートは、あとから接続することもできます。

Windows

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

Raspberry Pi

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

1.2.1.2.2.2 - メインメニュー

Windows   macOS   Linux   RasPi

階層化されたメニューの最上位に位置します。

この画面では、メニュー選択を行います。メニューを反転すると、下部緑色文字部分に簡易的な解説を表示します。

• ビューア : TWELITE から受信した電文を解釈して表示するビューアです。多くの場合、受信側の TWELITE には App_Wings を書き込んでおきます。
• アプリ書き換え : ファームウェアをビルドし、接続した TWELITE に書き込みます。
• インタラクティブモード : 接続した TWELITE 設定を、インタラクティブモードによって行います。
• TWELITE STAGEの設定 : TWELITE STAGE アプリの各種設定を行います。
• シリアルポートの選択 : シリアルポートを選択します。
• 説明書 : 説明書を表示するメニューです。以下の説明書をブラウザで開きます。
  • TWELITE STAGE アプリ（この文書）
  • MWX ライブラリ
  • TWENET_C ライブラリ

1.2.1.2.2.2.1 - ビューア

Windows   macOS   Linux   RasPi

ビューアは、接続した TWELITE から受信した情報を表示したり、コマンドを送ったりするための機能です。

1.2.1.2.2.2.1.1 - ターミナル

Windows   macOS   Linux   RasPi

概要

一般的なVT100系のシリアルターミナルです。

TWELITE のインタラクティブモードやリセット制御をサポートしています。

操作

1.2.1.2.2.2.1.2 - 標準アプリ ビューア

Windows   macOS   Linux   RasPi

概要

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

操作

1.2.1.2.2.2.1.3 - グラフ

• 加速度リアルタイムグラフ：加速度センサーのパケットをリアルタイムで表示します。周波数領域の表示や CSV ファイルの保存ができます。
• センサーグラフ：TWELITE 各種センサーのデータを sqlite3 データベースに保存し、グラフを表示します。

1.2.1.2.2.2.1.3.1 - 加速度リアルタイムグラフ

Windows   macOS   Linux   RasPi

概要

TWELITE CUE や TWELITE 動作センサーPAL から受信したパケットを参照します。加速度データをリアルタイムで表示できるほか、周波数解析や CSV 出力の機能があります。

CUE モード、MOTモード、2525 FIFO モードの３種類に対応しています。

連続したサンプルが一定数(解析窓)以上になると、XYZ軸を周波数解析した表示を行います。ただし 2525 FIFO モードでは常に連続していると仮定します。

パケットの区切りが明示的である場合（直前のパケットから３秒以上経過したとき、CUEモードは１パケットごと、MOTモードはパケットのシーケンス番号が不連続になった場合）には、４サンプル分のダミーデータを挿入しピンク色の背景色を表示します。

先着順に最大４ノードまでのデータを格納します。

操作

サンプルレートの推定

サンプリングレートは、パケットの受信時間から計算しています。過去複数サンプルの受信時間を平均して１サンプル分としているため、パケットの飛びなどがある場合は誤差が大きくなります。 また、関連するログ記録のタイムスタンプ(T_SMPL)も同様に推測値であり、パケット取得時と比較して遅れたタイムスタンプになります。 なお、サンプルレートの推定が終わると、グラフ表示のスクロールをスムーズにします。

CUEグラフモードの起動時に開く

[STAGE 共通設定→起動アプリ指定]にて31を指定してください。

ログ出力（表示データ保存）

(c)表示データ保存 ボタンを押すことで、画面上の表示位置（右端サンプル）を起点とした最大 512 サンプル分のデータを出力できます。

ログファイル名は {logフォルダ}/acc_snap_{タイムスタンプ}.csv です。

• データは、画面右端の一番新しいサンプルが 512 番目（ファイルの末尾）です。
• 周波数解析実行時は、最後のサンプルから 周波数解析サンプル数分が対象です。
• 周波数解析対象サンプルが記録されている行に周波数解析結果を追加しています（64 サンプルの場合は 449 番目から 32 行が結果で DC 成分から高周波成分までが並びます）。

追加情報

ログ出力（自動保存）

加速度リアルタイムグラフ画面を開き、データが入力された時点から自動的にログファイルを出力します。

ログファイル名は logフォルダ/accel_{シリアル番号}_{タイムスタンプ}.csv です。

追加情報

1.2.1.2.2.2.1.3.2 - センサーグラフ

Windows   macOS   Linux   RasPi

概要

各種センサーデータを SQLite データベースに記録し、画面上にグラフ形式で表示します。データベースファイルは外部のアプリケーションから参照することも可能です。

• データベースには SQLite (sqlite3) を使用しており、{MW_STAGE Install}/log/{実行形式名}_WSns.sqlite というファイルに格納されます。
• 画面遷移は [一覧(グラフプレビューあり)]>[24時間データ] >[ライブビュー]です。
  • [24時間データ] から更に [年] [月] [日(グラフプレビューあり)] 選択画面に遷移できます。
• [ライブ]表示画面について
  • 一覧から特定のノードを選択します。
  • １秒おきのリアルタイム表示を行い、過去 450 秒間のデータを表示します。
• [24時間データ] 表示画面について
  • 特定の日のデータを表示します。
  • １秒おきの更新とし、その間に複数のデータがあった場合は間引かれます。
  • 最大拡大時（１ピクセル１秒）以外は、各ピクセルの範囲における取得値の平均を表示します。
  • 値が画面よりはみ出す場合は、上下端に測定点を表示します。
  • 現在時刻が含まれる場合には、新着データで表示を更新します。
  • マウスホイールやカーソルキー↑ ↓の入力：時間軸の拡大・縮小
  • マウスポインタの移動：マウスポインタに対応した時間軸にある取得データを簡易表示します。
    • カーソルキー→ ←：隣の取得データに移動します。
  • マウスクリック&ドラッグ：スクロール（拡大時のみ）
  • 拡大時はスクロールバーによる操作も可能です。
  • [CSV出力] 機能では、データベースに含まれるすべての取得値を表示します。

操作

センサーノードのメモ（補助情報）の編集

「24時間データ画面」で、画面右上のセンサーノードのメモ部分を左クリックすると、メモを編集するためのプロンプトを使用できます。

画面遷移

基本の画面は一覧、24時間、ライブの3種類に分けられます。

[一覧] <--> [24時間] <--> [ライブ]
              ↓↑
          [年月日選択]

センサーグラフモードの起動時に開く

[STAGE 共通設定 → 起動アプリ指定] にて 32 を指定してください。

DBのテーブルについて

sensor_data

受信したデータを格納します。

sensor_node

センサーノードにテキストメモ（付加情報）を格納します。

sensor_last

最後に受信したタイムスタンプを管理します。

1.2.1.2.2.2.1.4 - 簡易モニタ

• CUEビューア : TWELITE CUE からのパケットを解釈して簡易表示します
• ARIAビューア : TWELITE ARIA からのパケットを解釈して簡易表示します
• Glancer : TWELITE の多くの形式に対応した簡易モニタです

1.2.1.2.2.2.1.4.1 - CUE ビューア

Windows   macOS   Linux   RasPi

概要

TWELITE CUE から受信したメッセージを解釈して表示します。

TWELITE CUE の動作

工場出荷時の TWELITE CUE は、TWELITE CUEモードに設定されています。

TWELITE CUEモードでは、コイン電池で駆動できるように間欠駆動をしながら、いくつかの要因によってスリープから起床して、様々なデータを送信します。

起床要因

TWELITE CUE がスリープから起床するには、以下のうちいずれかの要因を必要とします。

• タイマーによる起床（定期的な起床）
• 加速度の検出による起床
• 磁気センサーによる起床（磁石が近づいたことを検出した場合）

送信するデータの種類

TWELITE CUE は、以下のデータをパケットに収めて送信します。

• 検出イベント（後述）
• モジュール電源電圧
• 磁気センサーの検出値
• 加速度データ

パケットの属性

受信したパケットの属性からは、その基本情報を得ることができます。

イベント

TWELITE CUEモードでは、必ず加速度イベントを出力します。 起床要因に関わらず、起床後には一定サンプル数の加速度を計測します。このとき、加速度の計測結果に応じてイベントを判定します。

電圧

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

磁石

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

加速度

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

• サンプル：加速度のサンプル数を表示しています。10サンプル固定です。
• レートID：加速度のサンプルレートです。04固定で100Hzです。
• X,Y,Z：３つの軸の加速度です。８サンプル分の平均値として求めています。単位はミリG (1000mG=1G=9.8m/s2)です。

画面の表示例

1.2.1.2.2.2.1.4.2 - ARIA ビューア

Windows   macOS   Linux   RasPi

概要

TWELITE ARIA から受信したメッセージを解釈して表示します。

TWELITE ARIA の動作

工場出荷時の TWELITE ARIA は、TWELITE ARIAモードに設定されています。

TWELITE ARIAモードでは、コイン電池で駆動できるように間欠駆動をしながら、いくつかの要因によってスリープから起床して、様々なデータを送信します。

起床要因

TWELITE ARIA がスリープから起床するには、以下のうちいずれかの要因を必要とします。

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

送信するデータの種類

TWELITE ARIA は、以下のデータをパケットに収めて送信します。

• モジュール電源電圧
• 磁気センサーの検出値
• 温湿度データ

パケットの属性

受信したパケットの属性からは、その基本情報を得ることができます。

温湿度データ表

TWELITE ARIAから受信した過去9回分のデータの履歴を表示します。最新のデータが最上部に表示されます。

時間[s]

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

ID

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

VCC(mV)

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

温度(C)

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

湿度(%)

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

磁石

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

1.2.1.2.2.2.1.4.3 - グランサー

Windows   macOS   Linux   RasPi

概要

Glancer は、受信メッセージ中の情報を簡易的に表示します。

接続する TWELITE には App_Wings を書き込んでおくことで、通信相手のTWELITE (App_Twelite, TWELITE PAL, … アプリケーションIDと周波数チャネルを一致させれば混在も可) から受信した情報を表示できます。

操作

一覧表示の画面と選択表示の画面を切り替えて使用します。

一覧表示

通信相手からの情報を列挙します。

表示内容は（メッセージの種別、論理デバイスID、シリアルID、LQI (Lq)、電源電圧（情報に含まれている場合）、タイムスタンプ）です。

選択表示

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

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

1.2.1.2.2.2.1.5 - コマンダー

Windows   macOS   Linux   RasPi

概要

コマンダーは、TWELITE にシリアルメッセージを送信する機能です。

操作

コマンダーの最初の画面は留意事項について記載しています。

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

タブ：TWELITE

この画面では、 標準アプリ（App_Twelite） の 0x80コマンドを生成し、送信します。

接続する TWELITE には App_Twelite または 親機・中継機アプリ（App_Wings） を書き込んでおき、アプリケーションID・チャネルを設定した上で、通信相手からメッセージが受信されていることを確認してください。

タブ：NOTICE

この画面では、通知PAL（NOTICE PAL） の LED制御コマンド を生成します。

接続する TWELITE には App_Wings を書き込んでおき、アプリケーションID・チャネルを設定した上で、通信相手からメッセージが受信されていることを確認します。

画面下部の表示

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

1.2.1.2.2.2.2 - アプリ書換

Windows   macOS   Linux   RasPi

アプリ書換機能では、TWELITE のアプリ（ファームウェア）を書き込むことができます。

• ビルド済みの.BINファイルを書き込む
• アクト（act）などのソースファイルからビルドして書き込む

ソースファイルのビルド、ターミナル切断、書き込みユーティリティ起動、ターミナル接続といった煩雑さを解消できます。

• TWELITE を自動で認識する
• 書き込み終了後にリセットしてからインタラクティブモードまたはターミナルに遷移する
• 各プロジェクトのリストから、プロジェクトフォルダまたはVSCode等の環境を起動する （Raspberry Pi版を除く）
• 各プロジェクトのリストから、関連情報のウェブページを開く （Linux版、Raspberry Pi版を除く）

1.2.1.2.2.2.2.1 - BINから選択

Windows   macOS   Linux   RasPi

概要

ビルド済みのアプリ（.BINファイル）を書き込むことができます。

メニューを選択すると、.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
       ...

1.2.1.2.2.2.2.2 - actビルド&書換

Windows   macOS   Linux   RasPi

概要

MWX ライブラリによって記述されたアクト（act）のビルドと書き換えを行うことができます。

この画面では、以下のパスに配置されたアクトによるプロジェクトの一覧を表示します。

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

操作

一覧から書き込むプロジェクトを選択することで、ビルド～書き込みを行えます。

なお、書き込み終了後に ENTER または[ B ]ボタンを押すことで、TWELITE をリセットしてインタラクティブモード画面（もしくはターミナル画面、要設定）に遷移できます。

ビルド～書き込み画面

1.2.1.2.2.2.2.3 - TWELITE APPSビルド&書換

Windows   macOS   Linux   RasPi

概要

TWENET C ライブラリによって記述された TWELITE APPS のビルドと書き換えを行うことができます。

この画面では、以下のパスに配置されたプロジェクトの一覧を表示します。

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

操作

一覧から書き込むプロジェクトを選択することで、ビルド～書き込みを行えます。

なお、書き込み終了後に ENTER または[ B ]ボタンを押すことで、TWELITE をリセットしてインタラクティブモード画面（もしくはターミナル画面、要設定）に遷移できます。

ビルド～書き込み画面

1.2.1.2.2.2.2.4 - Act_extras

Windows   macOS   Linux   RasPi

概要

MWX ライブラリによって記述されたアクト（act）のビルドと書き換えを行うことができます。

この画面では、以下のパスに配置されたアクトによるプロジェクトの一覧を表示します。

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

操作

一覧から書き込むプロジェクトを選択することで、ビルド～書き込みを行えます。

なお、書き込み終了後に ENTER または[ B ]ボタンを押すことで、TWELITE をリセットしてインタラクティブモード画面（もしくはターミナル画面、要設定）に遷移できます。

ビルド～書き込み画面

1.2.1.2.2.2.2.5 - 指定

Windows   macOS   Linux  

フォルダまたは.BINファイルを TWELITE STAGE APP の画面にドラッグ＆ドロップすることで、特定のプロジェクトを書き込むことができます。 ドロップした対象のビルドや書き込みを行うときに選択します。

1.2.1.2.2.2.2.6 - 再書換

Windows   macOS   Linux   RasPi  

直前に書き換え・指定したプロジェクトを再選択します。

1.2.1.2.2.2.2.7 - ビルド・書換画面

Windows   macOS   Linux   RasPi  

ビルド中

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

ビルドエラー

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

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

書換中

ビルドが成功すると、ファームウェアを書き込む画面を表示します。

書換失敗

書換がエラーの場合は、下記のような画面を表示します。

書換完了

書換が無事に成功すると、下記のような画面を表示します。

1.2.1.2.2.2.3 - インタラクティブモード

Windows   macOS   Linux   RasPi

概要

この画面から、接続した TWELITE のインタラクティブモードを利用できます。

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

• 接続する TWELITE には、インタラクティブモードに対応したファームウェアをあらかじめ書き込んでおく必要があります。
• TWELITE の入出力を使用するため、シリアル通信に文字化けなどが発生した場合など、期待通りにインタラクティブモードへの遷移や離脱ができない場合もあります。
• マウス操作には対応しておりません。キーボード（カーソル ↑ ↓ での操作は可能）操作を行ってください。

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

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

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

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

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

1.2.1.2.2.2.4 - TWELITE STAGE の設定

Windows   macOS   Linux   RasPi

概要

この画面から、TWELITE STAGE APP の各種設定を行います。

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

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

ルートメニュー

共通設定
 ターミナル
 標準アプリ ビューア
 グラフ表示 (加速度ﾘｱﾙﾀｲﾑ/ｾﾝｻｰ)
 簡易モニター (CUA/ARIA/Glancer)
 グランサー(簡易モニタ)
 コマンダー
 アプリ書換
 インタラクティブモード
ｾｰﾌﾞﾃﾞｰﾀ ﾕｰﾃｨﾘﾃｨ(ﾀﾞﾝﾌﾟ/消去)
情報

共通設定

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

アプリ書換

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

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

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

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

1.2.1.2.2.2.5 - シリアルポートの選択

Windows   macOS   Linux   RasPi

概要

この画面では、シリアルポートを再選択できます。

1.2.1.2.3 - ログ機能

Windows   macOS   Linux   RasPi

操作

記録開始

Alt(⌘)+L を押します。

記録終了

記録中に再度 Alt(⌘)+L キーを押します。

ログの記録が終了し、その時点のログファイルをOS標準の方法（Windowsはメモ帳、macOSはコンソール.app）で開きます。

仕様

ログの記録

TWELITE から受信した文字列は、そのまま記録されます。

TWELITE に送信した文字列は、１文字ずつ記録されます。 Windowsの場合は ｢ ｣、 macOS / Linux / RaspBerryPi は « » で囲われます。 例えば«t»とある場合は、キーボードからtを入力したことを意味します。

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

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

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

1.2.1.3 - 詳細な仕様

1.2.1.3.1 - コマンドライン引数とiniファイルによる詳細設定

コマンドライン引数

コマンドライン引数は、TWELITE STAGE APPのいくつかの細かい設定を行います。

iniファイル

iniファイルはTWELITE STAGE APPの基本的な設定(MWSDKのフォルダを参照するなど)を行うために使用されます。

iniファイル名は{TWELITE STAGE APPの実行ファイルのベース名} + .ini です。 通常は TWELITE_Stage.ini となります。

;;; MWSDKの参照を変更します。
; MWSDK=MWSDK
mwsdk=mwsdk2020_10

;;; インターフェース言語
; LANG=en

;;; ウィンドウのジオメトリ
GEOM_X=200
GEOM_Y=100

シンタックス

• ini ファイルはプレーンテキストファイルとして記述される。
• キーと値は = で区切られた1行に格納される (例: KEY=value)。
• キーと値の文字列は行頭から始まる(キーの前に空白や他の文字は許されない)。
• キーと値の間にスペースを入れてはならない。
• コメント行は ; または # を行頭に追加する。

設定

異なる設定の TWELITE STAGE APP を実行する

異なる設定の TWELITE STAGE APP が必要な場合は、TWELITE STAGE APPと同じフォルダに実行ファイルをコピーして、同じ名前の .ini ファイルを作成します。

例えば、英語のインターフェースを使用する場合、TWELITE_Stage.exe(注: .exe はWindowsの実行ファイルの拡張子)を TWELITE_Stage_en.exe にコピーして、 LANG=en の設定を TWELITE_Stage_en.ini に書き込むことで、英語のインターフェースを有効化した実行ファイルを作成できます。

  TWELITE_Stage.exe
  TWELITE_Stage.ini | 特別な設定なし

  TWELITE_Stage_ja.exe | TWELITE_Stage.exe のコピー
  TWELITE_Stage_en.ini | LANG=en が設定されている。

1.2.1.3.2 - 環境変数

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

参考

.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を設定しない場合に、既定のフォルダ構成の時にソース参照先を指定しています。

1.2.1.3.3 - 000desc.txt によるプロジェクト説明の追加

プロジェクトフォルダに000desc.txtを作成した場合には、TWELITE STAGE APP が、プロジェクトフォルダの一覧にその内容を表示します。

ファイルは UTF-8 形式のプレーンテキストで記述します。書式は以下の２種類があります。

書式1

スイッチを押した時にLEDを点灯
act4はTWELITE DIPに接続されたスイッチを押した時にLEDを点灯させるactを動作させます。
https://mono-wireless.com/jp/products/act/index.html

• 1行目はタイトル行です。
• 2行目以降は詳細の記述です。
• 最終行が http で始まる場合は、ウェブサイトへのリンクになります。

書式2

[JAPANESE]
TITLE=actのテンプレート
DESC=中身が何もない setup(), loop() のみのファイルです。
新しく act を記述するのに利用してください。
URL=jp/MWX/content/Act_samples/README.html
[ENGLISH]
TITLE=act empty template
DESC=This act file only contains empty setup() and loop(),
which is intended to write a new act.
URL=en/MWX/content/Act_samples/README.html

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

URL 指定について

1.2.1.4 - ライセンス

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

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

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

1.2.1.5 - 改訂履歴

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

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

1.3.8 MWSTAGE2022_08収録版

メジャーバージョンアップ。

• 内部描画解像度を320x240から640x480ピクセルに変更
• 加速度センサーのリアルタイムグラフの追加
• センサーデータの保存とグラフ表示を行うセンサーグラフを追加
• 英語表示に対応
• 主要マニュアルをローカルhtmlファイルに変更

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

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_extrasのメニューを追加
  • Act_samplesより高度なもの
  • 外部のオープンソースライブラリ（センサー手続きなど）を利用したもの
• マウスによる操作を拡大 (リスト、ボタン、タブ)
  • マウス移動でフォーカス、左クリックで確定、右クリックは[ESC]キー入力
• 画面表示負荷の低減
  • アプリケーションがバックグラウンドの時はスクリーンセーバーを無効にした
  • アプリケーションがバックグラウンドの時は、描画回数を減らして CPU 負荷を減らした
• ビルドプロジェクト(act, TWE_Apps, Act_extras)の一覧の機能強化
  • 項目選択時に下部に概要を表示 (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

リリース初版

1.3 - TWELITE APPS

インタラクティブモードとは

インタラクティブモードは、 TWELITE APPS の詳細設定を行うモードです。

複数のグループで通信したい場合や、通信エラーを減らしたい場合等に必要な設定を行うことができます。

PC との接続

TWELITE の場合	MONOSTICK の場合
親基板へ用意した7Pインターフェイスに TWELITE R シリーズを装着し、USBケーブルを使ってパソコンと接続してください。	MONOSTICK をパソコンの USB ポートに接続してください。 TWELITE R シリーズ は必要ありません。

TWELITE DIP (BLUE/RED) の場合	その他の場合
TWELITE R シリーズ へ装着し、USBケーブルを使ってパソコンと接続してください。	7Pインターフェイスを備える TWELITE シリーズには TWELITE R シリーズ を装着し、USBケーブルを使ってパソコンと接続してください。

インタラクティブモードの切り替え

TWELITE STAGE を使用する場合

TWELITE STAGE APP は TWELITE のファームウェアの書き込みと設定、および受信したデータの表示機能を統合した開発ツールです。

1. TWELITE STAGE APP を起動する

2. TWELITE STAGE APP のメニューから「インタラクティブモード」を選択する

ターミナルソフトを使用する場合

一般のターミナルソフトを使用することもできます。

1. パソコン側でターミナルソフトを起動する（通信条件：115200bps/8-N-1）
2. TWELITEをリセットする。
3. パソコンのキーボードの+をゆっくり（0.2～1秒間隔）で3回押下する。上手くいかない場合は、繰り返し + を入力する。

インタラクティブモードを終了するには、もう一度+を3回押下してください。

インタラクティブモードの操作

インタラクティブモードでは、以下のような画面を表示します。

--- CONFIG/TWELITE APP V1-00-2/SID=0x81000038/LID=0x78 ---
 a: set Application ID (0x67720102)
 i: set Device ID (--)
 c: set Channels (18)
 t: set mode4 sleep dur (1000ms)
 y: set mode7 sleep dur (10s)
 f: set mode3 fps (32)
---
 S: save Configuration
 R: reset to Defaults

表示内容は、ファームウェアの種類やバージョンによって異なります。

手順

1. 値を選択：先頭のアルファベットを押下
2. 値を指定：値を入力
3. 値を確定：Enterキーを押下
4. 値を保存：S（大文字）を押下
5. 値を適用：TWELITE を再起動

()内の値は設定値です。

R（大文字）を押下することで、初期値へリセットできます（Sで適用）。

操作例

アプリケーションIDを 0xBEEFCAFE へ設定する場合の入力は次のようになります。

Input Application ID (HEX:32bit): BEEFCAFE

TWELITE APPS に共通する設定

周波数チャネル、アプリケーションID、デバイスID、再送回数と送信出力の設定は、TWELITE APPS に共通しています。

アプリケーションIDと周波数チャネル

同一のアプリケーションIDと周波数チャネルをもつ端末でないと通信できません。

a：アプリケーションID

通信を行うすべての端末へ同一の値を設定すると、論理的にネットワークを分離できます。

TWELITE は、自身と異なるアプリケーションIDをもつ端末から受信したパケットを破棄します。したがって、同一の周波数チャネル内へ複数のグループを設けることができます。

c：周波数チャネル

通信を行うすべての端末へ同一の値を設定すると、物理的にネットワークを分離できます。

TWELITE は IEEE802.15.4 規格へ準拠しており、2.4GHz帯を16チャネルに分割して使用します。

周波数チャネルを変更する場合は、c（小文字）を押下してください。

チャネルアジリティーの使用（通常は非推奨）

カンマ区切りで複数のチャネルを指定することで、チャネルアジリティを有効化できます。

チャネルアジリティは、複数の周波数チャネルを一定の間隔で切り替えながら通信することにより、劣悪な通信環境における通信の成功率を改善する仕組みです。

同時に3チャネルまで指定できます。指定されたチャネルを一定の間隔で順番に切り替えて送信します。受信側においても、チャネルを一定の間隔で順番に切り替えて受信します。

なお、チャネルの切り替え中は受信できません。通常の通信環境では、1チャネルを指定するよりも通信の信頼性は低下します。子機の送信回数を増やす必要があることから、電池消耗などの面では無駄の多い方式です。しかし、特定チャネルが全く通信不可能になるといった状況に対応できる利点を重視する場合に利用してください。通常は、電波障害の少ないチャネルを事前に特定し、単一チャネルで利用することを推奨します。

各 TWELITE APPS の初期値

i：論理デバイスID

論理デバイス ID は各端末を識別するために使用します。各端末に論理的なIDを割り振ることができます。

1つの親機に対して複数の子機を使用する場合は、各子機へ異なる ID（1~100）を付与してください。

x：送信出力と再送回数

送信出力を弱めることで電波の有効伝達範囲を狭くすることができます。ただし消費電力は変わりませんから、通常は最大出力でお使いください。

再送回数は、1回の送信リクエストにつき追加で送信する回数を指します。通信環境が悪い場合は、再送回数を設定するとデータの到達率が向上する場合があります。ただし、通信時間と消費電力は再送に応じて増加します。

インタラクティブモードでは2桁の数値を入力します。

• 十の位：再送回数
  • 1～9回
  • 0は各アプリのデフォルト値
  • Fで無効化
• 一の位：送信出力
  • 3が最強
  • 2/1/0と１段階小さくなるたびに -11.5dB の出力低下

例

• 32 → 再送3回、出力１段階弱める
• 93 → 再送9回、出力最大

設定の初期化

設定内容によっては、操作へ支障をきたす場合があります（ボーレート変更など）。

次の手順で初期化できます。

1. 他のアプリへ書き換え
2. インタラクティブモードへ切り替え
   • Rでリセット
   • Sで保存
3. 元のアプリへ書き戻す

各 TWELITE APPS に固有の設定

各アプリによって異なる設定については、以下のページをご覧ください。

1.3.1 - 超簡単！標準アプリ マニュアル

1.3.1.1 - 超簡単！標準アプリ マニュアル

ダウンロード

超簡単！標準アプリ（App_Twelite）を導入するには TWELITE STAGE SDK をインストールして、TWELITE STAGE アプリを使って書き換えてください。

1.3.1.1.1 - 超簡単！標準アプリのピン配置

ピン配置

電源入力

VCC/GND には、3.3V（2.3-3.6V）の電源を接続します。

デジタル・アナログ入出力

DIx/DOx, AIx/PWMx ピンは、対応する番号のピンが同期して信号伝送を行います。

シリアル通信

UART

TX/RX は、UART 通信の送信と受信に使用します。具体的には、次のような場面で使用します。

• 無線による信号伝送
  • UART の信号伝送
  • I2C の信号伝送（親機側）
• 外部デバイスとの有線通信
  • 無線で受信したデータの出力
  • 無線で送信するデータの入力
• ファームウェアの管理
  • ファームウェアの設定変更（インタラクティブモード）
  • ファームウェアの書き換え

I2C

SCL/SDAピンは、I2C のターゲットデバイスを接続する際に使用します。

設定入力

Mxピンを未接続またはGNDへ接続することで、親機、子機、中継機といった動作モードを切り替えることができます。

BPSピンを未接続またはGNDへ接続することで、UART のボーレート（通信速度）を 115200bps 以外の値へ変更できます。

リセット入力

リセット入力ピン RST と GNDとの間にプッシュボタンを接続することで、リセットボタンを実装できます。RST は内部プルアップされています。

1.3.1.1.2 - 超簡単！標準アプリの動作モード

動作モードの一覧

各モードは、Mx ピンを未接続または GND へ接続することで設定します。

O：未接続（OPEN）、G：GNDへ接続

初期状態は子機：連続モードです。

モードによって端末を識別するための論理デバイスID（LID）の初期値は異なります。

親機

連続モード

親機：連続モード

信号入力の変化を検知したとき、また1秒おきに、すべての子機へデータを送信します。

また子機から送信されるデータを常時待機しており、反応がよいものの、常に電力を消費します。

• 受信：常に待機
• 送信：入力変化時／1秒おき

子機

連続モード

子機：連続モード

信号入力の変化を検知したとき、また1秒おきに、すべての親機へデータを送信します。

また親機から送信されるデータを常時待機しており、反応がよいものの、常に電力を消費します。

• 受信：常に待機
• 送信：入力変化時／1秒おき

子機：連続0.03秒モード

子機：連続モードの定期送信の間隔は1秒ですが、これを0.03秒に短縮するモードです。

親機から送信されるデータを常時待機しているものの、子機から親機への通信で帯域を占有してしまうため、親機の入力に対する反応は鈍くなってしまいます。常に電力を消費します。

• 受信：常に待機
• 送信：入力変化時／0.03秒おき

間欠モード

子機：間欠1秒モード

信号入力の変化を検知したとき、また1秒おきに節電モードを解除し、すべての親機へデータを送信します。

受信機能を無効とするため、親機の制御を受けることはできません。省電力性能に優れたモードです。

• 受信：無効
• 送信：入力変化時／1秒おき

子機：間欠10秒モード

信号入力の変化を検知したとき、また10秒おきに節電モードを解除し、すべての親機へデータを送信します。

受信機能を無効とするため、親機の制御を受けることはできません。省電力性能に優れたモードです。

• 受信：無効
• 送信：入力変化時／10秒おき

子機：間欠受信1秒モード

信号入力の変化を検知したとき、また1秒おきに節電モードを解除し、すべての親機へデータを送信します。

1秒おきに受信処理も合わせて行います。省電力性能に優れていますが、子機：間欠1秒モードには劣ります。

• 受信：1秒おき
• 送信：入力変化時／1秒おき

中継機

連続モード

中継機：連続モード

中継機は、受信したパケットを送信します。

親機と子機の間に3つまで設置できますが、中継機を増やすとパケットの数が増大するため、干渉しやすくなることに注意してください。

• 受信：常に待機
• 送信：受信時

1.3.1.1.3 - 超簡単！標準アプリの代替ボーレート設定

代替ボーレート設定の有効化

BPS ピンを GND へ接続することで、代替ボーレート設定を有効化できます。

O：未接続（OPEN）、G：GNDへ接続

1.3.1.1.4 - 超簡単！標準アプリのUART機能

デジタル・アナログ入出力

0x81：相手端末からの状態通知

受信した入力信号の状態を出力します。

データ形式

アナログ信号の計算

AIxの入力電圧 \(V\)は、受信した変換値\(e_{r}\)および補正値\(e_{fr}\)を使って次のように表すことができます。

単位は mV

出力データの例

:78811501C98201015A000391000C2E00810301FFFFFFFFFB

0x80：相手端末の出力変更

相手端末の出力信号を制御します。

データ形式

UART 入出力

0x01：任意のデータの送信

データ形式

0x01：任意のデータの受信

データ形式

I2C 入出力

0x88：I2C 入力

データ形式

0x89：I2C 出力

データ形式

1.3.1.1.5 - インタラクティブモード（超簡単！標準アプリ）

ここでは超簡単！標準アプリ（App_Twelite）に固有の機能を説明します。共通機能については、TWELITE APPS マニュアル のトップページを参照してください。

表示例

次のような画面を表示します。

--- CONFIG/TWELITE APP V1-01-1/SID=0x8201001f/LID=0x78 ---
 a: set Application ID (0x67720102)
 i: set Device ID (--)
 c: set Channels (18)
 x: set Tx Power (03)
 t: set mode4 sleep dur (1000ms)
 y: set mode7 sleep dur (10s)
 f: set mode3 fps (32)
 z: set PWM HZ (1000,1000,1000,1000)
 o: set Option Bits (0x00000000)
 b: set UART baud (38400)
 p: set UART parity (N)
---
 S: save Configuration
 R: reset to Defaults

コマンド

各コマンドの詳細を次に示します。

a：アプリケーションID

通信を行う端末はすべて同一の値とします。論理的にネットワークを分離します。

i：論理デバイスID

複数の子機を識別する必要がある場合に設定します。

子機の場合は1-100の任意の値へ、親機の場合は121へ、中継機の場合は122へ設定してください。

c：周波数チャネル

通信を行う端末はすべて同一の値とします。物理的にネットワークを分離します。

x：送信出力と再送回数

電波の送信出力と、パケットを追加で送信する回数を指定します。

t：子機間欠1秒モードの間隔

子機間欠1秒モードの間欠時間を1秒から他の値へ上書きします。単位はミリ秒です。

0を設定した場合は、タイマによる定期的な起床を無効化します。このときDIxの立ち下がりエッジにより起床しますが、立ち上がりエッジでは起床しません。

y：子機間欠10秒モードの間隔

子機間欠10秒モードの間欠時間を10秒から他の値へ上書きします。単位は秒です。

0を設定した場合は、タイマによる定期的な起床を無効化します。このときDIxの立ち下がりエッジにより起床しますが、立ち上がりエッジでは起床しません。

f：子機連続0.03秒モードのサイクル

毎秒の送信リクエストの数を32回から4/8/16回へ上書きします。再送回数は含みません。

z：PWMxの周波数

値を一つ指定した場合は、すべてのPWMポートの周波数を上書きします。カンマ区切りで指定した場合は、PWM1-PWM4に個別の値を上書きできます。

o：オプションビット

32bit の数値を指定します。各ビットに紐付いた設定を有効化できます。

b：UART代替ボーレート

BPSピンをGNDへ接続して起動した場合に選択される代替ボーレートを38400bpsから上書きします。

値は9600/19200/38400/57600/115200/230400から選択できます。他の値を指定すると、誤差が生じる可能性があります。

p：UARTパリティ

Nはパリティ無し、Oは奇数、E:は偶数を示します。

データビットは8、ストップビットは１で固定されます。ハードウェアフローは設定できません。

オプションビットの詳細

オプションビットの値の各ビットに紐付いた設定を解説します。

00000001：低レイテンシモード

低レイテンシモードは、DIxの変化を検知してから速やかに送信を行うことで、受信側の遅延を短縮します。

00000002：定期送信の無効化

連続モードにおける1秒おきの定期送信を無効化します。

00000004：定期送信とUART出力の無効化

子機：連続モードにおける1秒おきの定期送信を無効化するほか、受信データのUART出力を停止します。

00000010：AIxの変化による送信の無効化

子機：連続モードにおいて、AIxの入力が変化した際の送信を無効化します。

開放されたAIxポートは不定の値を報告するため、正気状態でアナログ入力を利用しない場合はVCCへ接続する必要があります。このオプションを設定すると、VCCへの接続を省略できます。

00000020：AIxの値の無効化

ADCの計測値を使用せず、未使用ポート（0xFFFF）扱いとしてパケットを送信します

00000040：PWMxの計算式を変更

初期状態ではボリューム用に調節した出力を PWMx へ適用します。

このオプションはこれを無効化し、1.8V 以下の入力に対してフルスケールの出力を行います。

00000100：ボタン押下時のみ送信

DIxの入力が Low であるときにパケットを連続送信します。

例えば、モータを遠隔制御する際に利用します。リモコンのボタンを押している間にモータを回転させ、電波が途切れた場合に停止させることができます。

00000800：DIxの内部プルアップを停止

DIxの内部プルアップ（約50kΩ）をすべて停止します。

00008000：子機へ中継機能を付与

子機：連続モードにおいて中継機能を付与します。最大中継段数は1です。

00001000：子機中継時の最大中継段数を2とする

00008000：子機へ中継機能を付与の設定時に、最大中継段数を2へ変更します。

00002000：子機中継時の最大中継段数を3とする

00008000：子機へ中継機能を付与の設定時に、最大中継段数を3へ変更します。

00010000：PWMxの波形を反転

PWMxの出力波形を反転します。

AIxへ最大値を入力すると PWMxは Low となります。

00020000：起動後PWMxを落とす

起動後またはリセット後にPWMxの出力を Low 状態とします。

00080000：代替ポート割り当て

代替ポート割り当てを有効化します。

PWM2/PWM3へトランジスタ等を接続すると、動作が不安定となる場合があります（詳細）そうした場合に利用してください。

00100000：起動後2秒間DOxを落とす

起動後またはリセット後にDOxを2秒間 Low 状態とします。

DOx へ接続した LED を起動時に点灯させることができます。

00400000：DOxの出力を反転

DOxの出力を反転します。

初期状態とは異なり、片方の DI が Low レベルになると、もう片方の DO も Low レベルとなります。

00800000：DOxの内部プルアップを停止

DOxの内部プルアップ（約50kΩ）をすべて停止します。

1.3.2 - 親機・中継機アプリ マニュアル

1.3.2.1 - 親機・中継機アプリ マニュアル

機能

TWELITE APPSとactの全てのデータパケットを処理することができ、共通の親機または中継機として使用できます。

• 超簡単！標準アプリやパル専用アプリなどの TWELITE APPS や act のデータを1つの MONOSTICK で収集可能
• 16チャンネルで複数システムを個別に運用可能
• アプリケーションIDの設定することで、同一チャネルに複数システムを混在可能
• 中継機能で通信範囲拡大

1.3.2.1.1 - 親機・中継機アプリの動作モード

親機モードと中継機モードの2つのモードがあります。

1.3.2.1.1.1 - 親機・中継機アプリの親機モード

子機から送信されたデータを受信し、シリアルポートから出力します。また、シリアルポートへ入力されたコマンドを子機へ送信します。

1.3.2.1.1.1.1 - 親機・中継機アプリの受信メッセージ

子機から送信されたデータを受信し、既定の書式でシリアルポートから出力します。

1.3.2.1.1.1.1.1 - 超簡単！標準アプリからの出力（親機・中継機アプリ）

0x81：相手端末からの状態通知

受信した入力信号の状態を出力します。

データ形式

アナログ信号の計算

AIxの入力電圧 \(V\)は、受信した変換値\(e_{r}\)および補正値\(e_{fr}\)を使って次のように表すことができます。

単位は mV

出力データの例

:78811501C98201015A000391000C2E00810301FFFFFFFFFB

データの判別条件

親機・中継機アプリは、さまざまな種類の子機からデータを受信することができます。

出力されたデータが超簡単！標準アプリのものであるかを確認するには、次の箇所を参照してください。

パーサの実装例

• Python
  • mwings_python/src/mwings/parsers/app_twelite.py
• Arduino (C++)
  • mwings_arduino/src/parser/AppTwelitePacketParser.h
  • mwings_arduino/src/parser/AppTwelitePacketParser.cpp

0x01：任意のデータの受信

データ形式

1.3.2.1.1.1.1.2 - リモコンアプリからの出力（親機・中継機アプリ）

0x81：相手端末からの状態通知

受信した入力信号の状態を出力します。

データ形式

出力データの例

:01810F01DB8630000200645F000040004F00400049

データの判別条件

親機・中継機アプリは、さまざまな種類の子機からデータを受信することができます。

出力されたデータがリモコンアプリのものであるかを確認するには、次の箇所を参照してください。

パーサの実装例

• Python
  • mwings_python/src/mwings/parsers/app_io.py
• Arduino (C++)
  • mwings_arduino/src/parser/AppIoPacketParser.h
  • mwings_arduino/src/parser/AppIoPacketParser.cpp

1.3.2.1.1.1.1.3 - シリアル通信アプリからの出力（親機・中継機アプリ）

書式モード：簡易形式

データ形式

出力データの例

:780100112233AABBCCDD13

データの判別条件

親機・中継機アプリは、さまざまな種類の子機からデータを受信することができます。

出力されたデータがシリアル通信アプリ（書式モード：簡易形式）のものであるかを確認するには、次の箇所を参照してください。

パーサの実装例

• Python
  • mwings_python/src/mwings/parsers/app_uart_ascii.py
• Arduino (C++)
  • mwings_arduino/src/parser/AppUartAsciiPacketParser.h
  • mwings_arduino/src/parser/AppUartAsciiPacketParser.cpp

書式モード：拡張書式

データ形式

出力データの例

:78A0028201015AFFFFFFFFA8000700112233AABBCCC6

データの判別条件