M5StackToio

M5StackToio はソニー・インタラクティブエンタテインメント社の「toio コアキューブ」を操作するための M5Stack 用 Arduino ライブラリです。

1. 開発環境セットアップ
2. M5StackToio のインストール
3. 使い方
4. Toio オブジェクト
- scan() メソッド (toio コアキューブ発見)
- loop() メソッド (イベント処理)
5. ToioCore オブジェクト
6. サンプルスケッチ
リリースノート
リファレンス
ライセンス

1. 開発環境セットアップ

本ライブラリーを利用するにあたり M5Stack 開発環境が必要です。M5Stack の公式サイト (英語) に記載された手順に従って開発環境をセットアップしてください。

M5Stack Docs - Arduino IDE Development

USB ドライバーのインストール、Arduino-IDE のインストール、Boards Manager の設定、ボードのインストール、ボードの選択、M5Stack Library のインストールが必要となります。

2. M5StackToio のインストール

本ページの右上の Code ボタンをクリックし Download ZIP を選択し、本ライブラリの zip ファイルをダウンロードしてください。

Arduino IDE を起動し、メニューバーの スケッチ -> ライブラリをインクルード -> .ZIP形式のライブラリをインストール... を選択してください。先ほどダウンロードした本ライブラリの zip ファイルを選択すると、本ライブラリのインストールが完了します。

もし git コマンドが利用できるのであれば、次のようにインストールすることも可能です。以下は Windows10 の PowerShell を使った場合の例です。

cd ~
cd Documents\Arduino\libraries
git clone https://github.com/futomi/M5StackToio.git

3. 使い方

以下のサンプルコードは、toio コアキューブをスキャンし、最初に発見した toio コアキューブに接続し、3 秒後に切断します。

#include <M5Stack.h>
#include <Toio.h>

// Toio オブジェクト生成
Toio toio;

void setup() {
  // M5Stack の初期化
  M5.begin();
  M5.Power.begin();
  M5.Lcd.clear();

  Serial.println("- toio コア キューブをスキャンします。");
  std::vector<ToioCore*> toiocore_list = toio.scan(3);
  size_t n = toiocore_list.size();
  if (n == 0) {
    Serial.println("- toio コア キューブが見つかりませんでした。");
    return;
  }
  Serial.printf("- %d 個の toio コア キューブが見つかりました。\n", n);

  Serial.println("- toio コア キューブに BLE 接続します。");
  ToioCore* toiocore = toiocore_list.at(0);
  bool connected = toiocore->connect();
  if (!connected) {
    Serial.println("- BLE 接続に失敗しました。");
    return;
  }
  Serial.println("- BLE 接続に成功しました。");
  Serial.println("- 3 秒後に切断します。");
  delay(3000);
  toiocore->disconnect();
  Serial.println("- BLE コネクションを切断しました。");
}

void loop() {

}

上記サンプルコードを実行する前に、toio コアキューブの電源を入れてください。実行に成功すれば、Arduino IDE のシリアルモニタに次の結果が表示されます。

- toio コア キューブをスキャンします。
- 1 個の toio コア キューブが見つかりました。
- toio コア キューブに BLE 接続します。
- BLE 接続に成功しました。
- 3 秒後に切断します。
- BLE コネクションを切断しました。

上記のサンプルコードを以下に解説します。

ライブラリのインクルード

以下の通り、.ino ファイルの先頭で、M5Stack.h に加え、本ライブラリのヘッダファイル Toio.h をインクルードしてください。

#include <M5Stack.h>
#include <Toio.h>

次に、グローバル変数として、Toio オブジェクトを生成します。以下は変数 toio に Toio オブジェクトを格納しています。

Toio toio;

toio コアキューブの発見

以降は .ino ファイルの setup() 関数の中で実行します。

toio コアキューブを発見するには、Toio オブジェクトの scan() メソッドを実行します。scan() メソッドにはスキャン秒数を指定します。指定しなければ 3 秒間スキャンを行います。

std::vector<ToioCore*> toiocore_list = toio.scan(3);

scan() メソッドは、指定秒数だけスキャンを実行してから、発見された toio コアキューブのリストを返します。リストの型は std::vector です。個々の toio コアキューブを表すオブジェクトの型は ToioCore オブジェクトのポインタです。この ToioCore オブジェクトを使って、該当の toio コアキューブを操作します。

次の処理に移る前に、発見された toio コアキューブの数をチェックします。

size_t n = toiocore_list.size();
if(n == 0) {
  Serial.println("toio コア キューブが見つかりませんでした。");
  return;
}
ToioCore* toiocore = toiocore_list.at(0);

上記コードでは、最初に見つかった toio コアキューブを表す ToioCore オブジェクトのポインタを、変数 toiocore に格納しています。

toio コアキューブに BLE 接続

発見した toio コアキューブに BLE 接続するには、該当の toio コアキューブを表す ToioCore オブジェクトのポインタから connect() メソッドを呼び出します。

bool connected = toiocore->connect();
if(!connected) {
  Serial.println("BLE 接続に失敗しました。");
  return;
}

connect() メソッドは BLE 接続が完了すると true を返します。この戻り値をチェックしてください。

toio コアキューブに BLE 接続できたら、以降で解説する toioCore オブジェクトのメソッドをポインタ経由で呼び出して toio コアキューブを操作します。

toio コアキューブを切断

BLE 接続した toio コアキューブを切断するには、ToioCore オブジェクトのポインタから disconnect() メソッドを呼び出します。

toiocore->disconnect();

4. `Toio` オブジェクト

Toio オブジェクトは次のように生成します。以下のコードでは、変数 toio に Toio オブジェクトが格納されます。

Toio toio;

以降、変数 toio に Toio オブジェクトが格納されているとして解説します。

✔ `scan()` メソッド (toio コアキューブ発見)

scan() メソッドは指定秒数だけ toio コアキューブをスキャンします。

プロトタイプ宣言

std::vector<ToioCore*> scan(uint8_t duration);

引数

No.	変数名	型	必須	説明
1	`duration`	`uint8_t`		スキャン秒数 (デフォルト値: 3)

コードサンプル

std::vector<ToioCore*> toiocore_list = toio.scan(3);

✔ `loop()` メソッド (イベント処理)

loop() メソッドはイベント処理を実行します。後述のイベントハンドラ設定関数を使う場合は、.ino ファイルの loop() メソッド内で必ず呼び出してください。

プロトタイプ宣言

void loop();

引数

なし

コードサンプル

void loop() {
  M5.update();
  toio.loop();
  ...
}

5. `ToioCore` オブジェクト

前述の通り、発見した toio コアキューブを操作するには、toioCore オブジェクトのメソッドをポインタ経由で呼び出します。以下、toioCore オブジェクトに実装されたメソッドを説明します。以降、変数 toiocore が toioCore オブジェクトのポインタとします。

✔ `getAddress()` メソッド (アドレス取得)

toio コアキューブの MAC アドレスを返します。

プロトタイプ宣言

std::string getAddress();

引数

なし

コードサンプル

std::string mac = toiocore->getAddress();
Serial.println(mac.c_str()); // 例 "d1:52:fa:d2:c6:a1"

✔ `getName()` メソッド (デバイス名取得)

toio コアキューブのデバイス名を返します。デバイス名は、toio コアキューブがアドバタイジングパケットにセットした localName の値です。通常は "toio Core Cube" 固定です。

プロトタイプ宣言

std::string getName();

引数

なし

コードサンプル

std::string name = toiocore->getName();
Serial.println(name.c_str()); // 例 "toio Core Cube"

✔ `connect()` メソッド (BLE 接続)

toio コアキューブに BLE 接続を行います。

プロトタイプ宣言

bool connect();

引数

なし

コードサンプル

bool connected = toiocore->connect();
if (!connected) {
  Serial.println("- BLE 接続に失敗しました。");
  return;
}

✔ `disconnect()` メソッド (BLE 切断)

toio コアキューブとの BLE コネクションを切断します。

プロトタイプ宣言

void disconnect();

引数

なし

コードサンプル

toiocore->disconnect();

✔ `isConnected()` メソッド (接続状態取得)

toio コアキューブとの BLE 接続状態を返します。接続中であれば true を、切断中であれば false を返します。

プロトタイプ宣言

bool isConnected();

引数

なし

コードサンプル

if(toiocore->isConnected()) {
  Serial.println("接続中");
} else {
  Serial.println("切断中");
}

✔ `onConnection()` メソッド (接続状態イベントのコールバックをセット)

toio コアキューブとの BLE 接続状態イベントのコールバックをセットします。BLE 接続状態に変化があれば、引数に指定したコールバック関数を呼び出します。コールバック関数には接続状態を表す bool 値が引き渡されます。

プロトタイプ宣言

typedef std::function<void(bool connected)> OnConnectionCallback;
void onConnection(OnConnectionCallback cb);

引数

No.	変数名	型	必須	説明
1	`cb`	`OnConnectionCallback`	✔	コールバック関数

コードサンプル

以下のサンプルスケッチは、10 秒おきに BLE 接続と切断を繰り返します。コールバック関数により、接続状態のイベントが発生すると、その状態を出力します。

コールバックを使う場合は、.ino ファイルの loop() 関数内で Toio オブジェクトの loop() メソッドを呼び出してください。コールバックは、.ino ファイルの loop() 関数が実行が開始されてから発生したイベントしかハンドリングできませんので注意してください。そのため、以下のサンプルスケッチでは、loop() 関数内で BLE 接続と切断を行っています。

#include <M5Stack.h>
#include <Toio.h>

// Toio オブジェクト生成
Toio toio;

// ToioCore オブジェクトのポインタ
ToioCore* toiocore = nullptr;

// BLE 接続・切断のタイムスタンプ
unsigned long conn_time = millis();

void setup() {
  // M5Stack の初期化
  M5.begin();
  M5.Power.begin();

  // toio コア キューブのスキャン開始
  std::vector<ToioCore*> toiocore_list = toio.scan(3);
  if (toiocore_list.size() > 0) {
    toiocore = toiocore_list.at(0);
  }

  // BLE 接続状態イベントのコールバックをセット
  toiocore->onConnection([](bool state) {
    Serial.println(state ? "接続" : "切断");
  });
}

void loop() {
  // コールバックを使う場合には必ず Toio オブジェクトの loop() を呼び出す
  toio.loop();

  if (toiocore) {
    // 10 秒おきに BLE 接続・切断を繰り返す
    unsigned long now = millis();
    if (now - conn_time >= 10000) {
      if (toiocore->isConnected()) {
        toiocore->disconnect();
      } else {
        toiocore->connect();
      }
      conn_time = now;
    }
  }
}

✔ `getBleProtocolVersion()` メソッド (BLE プロトコルバージョン取得)

toio コアキューブの BLE プロトコルバージョンを取得します。

プロトタイプ宣言

std::string getBleProtocolVersion();

引数

なし

コードサンプル

std::string ble_ver = toiocore->getBleProtocolVersion();
Serial.println(ble_ver.c_str()); // 例 "2.1.0"

✔ `playSoundEffect()` メソッド (効果音再生)

toio コアキューブにプリセットされた効果音を再生します。

プロトタイプ宣言

void playSoundEffect(uint8_t sound_id, uint8_t volume = 0xff);

引数

No.	変数名	型	必須	説明
1	`sound_id`	`uint8_t`	✔	効果音の ID (0 ～ 10)
2	`volume`	`uint8_t`		音量 (0 ～ 255)。指定が無ければ 255。

効果音の ID の意味は以下の通りです。

効果音 ID	効果音名称
`0`	Enter
`1`	Selected
`2`	Cancel
`3`	Cursor
`4`	Mat in
`5`	Mat out
`6`	Get 1
`7`	Get 2
`8`	Get 3
`9`	Effect 1
`10`	Effect 2

コードサンプル

toiocore->playSoundEffect(3);

✔ `playSoundRaw()` メソッド (サウンド再生開始)

toio コアキューブの通信仕様で定義された生データを、サウンドの Characteristic に書き込みます。主に MIDI データを再生するために使います。詳細は toio コアキューブのサウンドの仕様を参照してください。

プロトタイプ宣言

void playSoundRaw(uint8_t* data, size_t length);

引数

No.	変数名	型	必須	説明
1	`data`	`uint8_t*`	✔	書き込むデータのバイト列
2	`length`	`size_t`	✔	書き込むバイト数

コードサンプル

以下のサンプルコードは、チャルメラを最大音量で再生します。

uint8_t charumera_data[39] = {
  3,             // 制御の種類 (MIDI なら `3`)
  1,             // 繰り返し回数
  12,            // Operation の数
  14,  69, 255,  // 140ms, A5
  14,  71, 255,  // 140ms, B5
  56,  73, 255,  // 560ms, C#6
  14,  71, 255,  // 140ms, B5
  14,  69, 255,  // 140ms, A5
  114, 128, 255, // 無音
  14,  69, 255,  // 140ms, A5
  14,  71, 255,  // 140ms, B5
  14,  73, 255,  // 560ms, C#6
  14,  71, 255,  // 140ms, B5
  14,  69, 255,  // 140ms, A5
  56,  71, 255   // 560ms, B5
};
toiocore->playSoundRaw(charumera_data, 39);

✔ `stopSound()` メソッド (サウンド再生停止)

サウンド再生を停止します。

プロトタイプ宣言

void stopSound();

引数

なし

コードサンプル

toiocore->stopSound();

✔ `turnOnLed()` メソッド (LED 点灯)

toio コアキューブの LED を点灯します。

プロトタイプ宣言

void turnOnLed(uint8_t r, uint8_t g, uint8_t b);

引数

No.	変数名	型	必須	説明
1	`r`	`uint8_t`	✔	赤コンポーネント (`0` ～ `255`)
2	`g`	`uint8_t`	✔	緑コンポーネント (`0` ～ `255`)
2	`b`	`uint8_t`	✔	青コンポーネント (`0` ～ `255`)

コードサンプル

toiocore->turnOnLed(0xff, 0xff, 0x00); // 黄色で点灯

※ 黒 (0x00, 0x00, 0x00) を指定すると消灯になります。

✔ `turnOffLed()` メソッド (LED 消灯)

toio コアキューブの LED を消灯します。

プロトタイプ宣言

void turnOffLed();

引数

なし

コードサンプル

toiocore->turnOffLed();

✔ `getBatteryLevel()` メソッド (バッテリーレベルを取得)

toio コアキューブのバッテリーレベル (%) を取得します。

プロトタイプ宣言

uint8_t getBatteryLevel();

引数

なし

コードサンプル

uint8_t batt_level = toiocore->getBatteryLevel();
Serial.printf("%d パーセント\n", batt_level);

✔ `onBattery()` メソッド (バッテリーイベントのコールバックをセット)

toio コアキューブのバッテリーイベントのコールバックをセットします。5 秒間隔で引数に指定したコールバック関数を呼び出します。コールバック関数にはバッテリーレベル (パーセント) が引き渡されます。

プロトタイプ宣言

typedef std::function<void(uint8_t level)> OnBatteryCallback;
void onBattery(OnBatteryCallback cb);

引数

No.	変数名	型	必須	説明
1	`cb`	`OnBatteryCallback`	✔	コールバック関数

コードサンプル

以下のサンプルスケッチは、バッテリーイベントを受信する都度、バッテリーレベルを出力します。

コールバックを使う場合は、.ino ファイルの loop() 関数内で Toio オブジェクトの loop() メソッドを呼び出してください。コールバックは、.ino ファイルの loop() 関数が実行が開始されてから発生したイベントしかハンドリングできませんので注意してください。

#include <M5Stack.h>
#include <Toio.h>

// Toio オブジェクト生成
Toio toio;

void setup() {
  // M5Stack の初期化
  M5.begin();
  M5.Power.begin();

  // toio コア キューブのスキャン開始
  std::vector<ToioCore*> toiocore_list = toio.scan(3);
  if (toiocore_list.size() == 0) {
    return;
  }
  ToioCore* toiocore = toiocore_list.at(0);

  // BLE 接続
  toiocore->connect();

  // バッテリーイベントのコールバックをセット
  toiocore->onBattery([](uint8_t level) {
    Serial.printf("%d パーセント\n", level);
  });
}

void loop() {
  // コールバックを使う場合には必ず Toio オブジェクトの loop() を呼び出す
  toio.loop();
}

✔ `getButtonState()` メソッド (ボタンの状態を取得)

toio コアキューブ裏面のボタン (LED と同じ) の押下状態を取得します。押した状態なら true を、そうでなければ false を返します。

プロトタイプ宣言

bool getButtonState();

引数

なし

コードサンプル

if(toiocore->getButtonState()) {
  Serial.println("ボタンが押されています。");
} else {
  Serial.println("ボタンは押されていません。");
}

✔ `onButton()` メソッド (ボタンイベントのコールバックをセット)

toio コアキューブのボタン押下イベントのコールバックをセットします。ボタン押下状態に変化があれば、引数に指定したコールバック関数を呼び出します。コールバック関数にはボタン押下状態を表す bool 値が引き渡されます。

プロトタイプ宣言

typedef std::function<void(bool state)> OnButtonCallback;
void onButton(OnButtonCallback cb);

引数

No.	変数名	型	必須	説明
1	`cb`	`OnButtonCallback`	✔	コールバック関数

コードサンプル

以下のサンプルスケッチは、ボタン押下状態に変化があると、その都度、その状態を出力します。

コールバックを使う場合は、.ino ファイルの loop() 関数内で Toio オブジェクトの loop() メソッドを呼び出してください。コールバックは、.ino ファイルの loop() 関数が実行が開始されてから発生したイベントしかハンドリングできませんので注意してください。

#include <M5Stack.h>
#include <Toio.h>

// Toio オブジェクト生成
Toio toio;

void setup() {
  // M5Stack の初期化
  M5.begin();
  M5.Power.begin();

  // toio コア キューブのスキャン開始
  std::vector<ToioCore*> toiocore_list = toio.scan(3);
  if (toiocore_list.size() == 0) {
    return;
  }
  ToioCore* toiocore = toiocore_list.at(0);

  // BLE 接続
  toiocore->connect();

  // ボタン押下状態イベントのコールバックをセット
  toiocore->onButton([](bool state) {
    Serial.println(state ? "ボタン押下" : "ボタン解除");
  });
}

void loop() {
  // コールバックを使う場合には必ず Toio オブジェクトの loop() を呼び出す
  toio.loop();
}

✔ `getMotion()` メソッド (モーションセンサーの状態を取得)

toio コアキューブのモーションセンサーの状態を取得します。

プロトタイプ宣言

struct ToioCoreMotionData {
  bool flat;
  bool clash;
  bool dtap;
  uint8_t attitude;
};

ToioCoreMotionData getMotion();

引数

なし

戻値

ToioCoreMotionData 型の構造体が返されます。各メンバーの意味は以下の通りです。

名前	型	説明
`flat`	`bool`	水平検出 (`true`: 水平, `false`: 水平でない)
`clash`	`bool`	衝突検出 (`true`: あり, `false`: なし)
`dtap`	`bool`	ダブルタップ検出 (`true`: あり, `false`: なし)
`attitude`	`uint8_t`	姿勢検出 (後述)

姿勢検出 attitude が取る値とその意味は以下の通りです。

値	toio コアキューブの姿勢
`1`	天面が上
`2`	底面が上
`3`	背面が上
`4`	正面が上
`5`	右側面が上
`6`	左側面が上

姿勢検出の詳細は toio コアキューブ技術仕様をご覧ください。

コードサンプル

ToioCoreMotionData motion = toiocore->getMotion();
Serial.println("- 水平検出: " + String(motion.flat ? "水平" : "水平でない"));
Serial.println("- 衝突検出: " + String(motion.clash ? "あり" : "なし"));
Serial.println("- ダブルタップ検出: " + String(motion.dtap ? "あり" : "なし"));
Serial.println("- 姿勢検出: " + String(motion.attitude));

✔ `onMotion()` メソッド (モーションセンサーのコールバックをセット)

toio コアキューブのモーションイベントのコールバックをセットします。モーションに変化があれば、引数に指定したコールバック関数を呼び出します。コールバック関数にはモーションを表す構造体が引き渡されます。

プロトタイプ宣言

struct ToioCoreMotionData {
  bool flat;
  bool clash;
  bool dtap;
  uint8_t attitude;
};

typedef std::function<void(ToioCoreMotionData motion)> OnMotionCallback;
void onMotion(OnMotionCallback cb);

引数

No.	変数名	型	必須	説明
1	`cb`	`OnMotionCallback`	✔	コールバック関数

コードサンプル

以下のサンプルスケッチは、モーションに変化があると、その都度、その状態を出力します。

コールバックを使う場合は、.ino ファイルの loop() 関数内で Toio オブジェクトの loop() メソッドを呼び出してください。コールバックは、.ino ファイルの loop() 関数が実行が開始されてから発生したイベントしかハンドリングできませんので注意してください。

#include <M5Stack.h>
#include <Toio.h>

// Toio オブジェクト生成
Toio toio;

void setup() {
  // M5Stack の初期化
  M5.begin();
  M5.Power.begin();

  // toio コア キューブのスキャン開始
  std::vector<ToioCore*> toiocore_list = toio.scan(3);
  if (toiocore_list.size() == 0) {
    return;
  }
  ToioCore* toiocore = toiocore_list.at(0);

  // BLE 接続
  toiocore->connect();

  // モーションイベントのコールバックをセット
  toiocore->onMotion([](ToioCoreMotionData motion) {
    Serial.println("------------------------------------------");
    Serial.println("- 水平検出: " + String(motion.flat ? "水平" : "水平でない"));
    Serial.println("- 衝突検出: " + String(motion.clash ? "あり" : "なし"));
    Serial.println("- ダブルタップ検出: " + String(motion.dtap ? "あり" : "なし"));
    Serial.println("- 姿勢検出: " + String(motion.attitude));
  });
}

void loop() {
  // コールバックを使う場合には必ず Toio オブジェクトの loop() を呼び出す
  toio.loop();
}

✔ `controlMotor()` メソッド (モーター制御)

toio コアキューブのモーターを制御します。

プロトタイプ宣言

void controlMotor(bool ldir, uint8_t lspeed, bool rdir, uint8_t rspeed, uint16_t duration = 0);

引数

No.	変数名	型	必須	説明
1	`ldir`	`bool`	✔	左モーターの回転方向 (`true`: 前進, `false`: 後進)
2	`lspeed`	`uint8_t`	✔	左モーターの速度 (`0` ～ `115`)
3	`rdir`	`bool`	✔	右モーターの回転方向 (`true`: 前進, `false`: 後進)
4	`rspeed`	`uint8_t`	✔	右モーターの速度 (`0` ～ `115`)
5	`duration`	`uint16_t`		モーターの制御時間 (ミリ秒)

lspeed および rspeed の値と実際の速度の対応は、toio コアキューブ通信仕様をご覧ください。

duration に 0 (デフォルト値) を指定すると、停止 (lspeed, rspeed に 0 をセット) 命令を受けるまで動き続けます。

コードサンプル

// 右に曲がりながら進む
toiocore->controlMotor(true, 50, true, 40);
delay(5000);

// 停止
displayProgressMessage("Stopping...");
toiocore->controlMotor(true, 0, true, 0);
delay(5000);

// 2 秒間だけ左に曲がりながら進む
toiocore->controlMotor(true, 40, true, 50, 2000);
delay(5000);

✔ `drive()` メソッド (運転)

ゲームパッドやジョイスティックを使うことを想定したモーター制御メソッドです。モーター制御をスロットルとステアリング操作に置き換えます。

プロトタイプ宣言

void drive(int8_t throttle, int8_t steering);

引数

No.	変数名	型	必須	説明
1	`throttle`	`int8_t`	✔	スロットル (`-100` ～ `100`)
2	`steering`	`int8_t`	✔	ステアリング (`-100` ～ `100`)

throttle に正の値を指定すると前進、負の値を指定すると後進、0 を指定すると停止します。steering に正の値を指定すると右に曲がり、負の値を指定すると左に曲がります。

steering の絶対値が大きくなるにつれて、一方のモーターの回転数を緩めることで、ステアリング操作を実現しています。もし throttle に 100 を指定し、steering に 100 を指定すると、左モーターの速度は 100 のままに、右モーターの速度が 0 になります。つまり、右タイヤを軸に左にくるくる回ることになります。ラジコンカーのような動きを求めるなら、steering のリミットを 50 程度に抑えておくのが良いでしょう。

コードサンプル

// ゆっくりと左に曲がる
toiocore->drive(20, -10);
delay(5000);

// 停止
toiocore->drive(0, 0);

もし戦車のように左右のタイヤをそれぞれ反対方向に回転させて本体の中心を軸にくるくる回る動きを実現したい場合は、前述の controlMotor() メソッドを使ってください。

6. サンプルスケッチ

本ライブラリのインストールが完了すると、Arduino IDE のメニューバーの ファイル -> スケッチ例 の中から M5StackToio が選択できるようになります。この中には以下の 3 つのサンプルが用意されています。いずれも M5Stack Basic および M5Stack Gray で動作します。

`basic`

本ライブラリが提供するメソッドを一通り実行するスケッチです。

事前に toio コアキューブの電源を入れてください。

M5Stack が起動すると自動的に toio コアキューブをスキャンします。toio コアキューブが見つかると M5Stack の画面にデバイス名と MAC アドレスが表示されます。見つからなければ、再度、M5Stack ボタンのリセットボタンを押して再起動してください。

toio コアキューブが発見されると、自動的に BLE 接続し、一連のメソッドを順次実行しながら M5Stack の画面に結果を表示します。

一連のメソッドの実行が完了すると、自動的に BLE 接続を切断して終了します。

`event`

本ライブラリが提供するイベントをハンドリングするサンプルスケッチです。

事前に toio コアキューブの電源を入れてください。

M5Stack が起動すると自動的に toio コアキューブをスキャンします。toio コアキューブが見つかると M5Stack の画面にデバイス名と MAC アドレスが表示されます。見つからなければ、再度、M5Stack ボタンのリセットボタンを押して再起動してください。

toio コアキューブが発見された後、M5Stack の A ボタンを押すと toio コアキューブと BLE 接続します。接続が完了すると、各種イベントを待ち受け、受信したイベント情報を M5Stack の画面に表示します。

`joystick_drive`

M5Stack用ジョイスティックユニットを使って toio コアキューブを運転するサンプルスケッチです。

事前に toio コアキューブの電源を入れてください。

M5Stack が起動すると自動的に toio コアキューブをスキャンします。toio コアキューブが見つかると M5Stack の画面にデバイス名と MAC アドレスが表示されます。見つからなければ、再度、M5Stack ボタンのリセットボタンを押して再起動してください。

toio コアキューブと BLE 接続する前にジョイスティックをキャリブレーションする必要があります。M5Stack の画面上にジョイスティックの座標が表示されます。もし x と y の値が 0 でなければ、ジョイスティックの中心座標がずれています。M5Stack の C ボタンを押してキャリブレーションしてください。

toio コアキューブが発見された後、M5Stack の A ボタンを押すと toio コアキューブと BLE 接続します。接続が完了すると、ジョイスティックで toio コアキューブを運転することができます。

BLE 接続中、ジョイスティックの z 軸を押すと、チャルメロが再生されます。また、M5Stack の B ボタンを押すと、toio コアキューブの LED が白で点灯します。

リリースノート

v1.0.0 (2020-07-19)
- 初版リリース

リファレンス

License

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
examples		examples
src		src
.gitattributes		.gitattributes
LICENSE		LICENSE
README.md		README.md
keywords.txt		keywords.txt
library.properties		library.properties

License

mhama/M5StackToio

Folders and files

Latest commit

History

Repository files navigation

M5StackToio

目次

ライブラリのインクルード

toio コア キューブの発見

toio コア キューブに BLE 接続

toio コア キューブを切断

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

戻値

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

プロトタイプ宣言

引数

コードサンプル

basic

toio コアキューブの発見

toio コアキューブに BLE 接続

toio コアキューブを切断

`basic`

`event`

`joystick_drive`