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

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

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 パッケージを導入しておく

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

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

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 ユーティリティの手動インストール

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

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

TWELITE_Stageを起動しても、シリアルポートが表示されない場合は、FTDI社のドライバをアンロード（無効に）する必要があります。以下の「参考」を参照ください。

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

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

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