Seeeduino XIAOでジョイスティックの情報を取得する

こんにちは、ENGかぴです。

GroveモジュールのGrove-Thumb JoystickでスティックをX方向とY方向に円を描くようにスティックを回すと位置に応じたアナログ電圧を取得することができます。Seeeduino XIAO用の拡張ボードを使って動作確認を行いました。

Seeeduino XIAO用拡張ボード（Seeed Studio）を使用しています。ジョイスティックを操作して拡張基板のブザーの音程と長さを変更して動作確認を行います。

Seeeduino XIAOを使って動作確認を行ったことを下記リンクにまとめています。

Seeeduino XIAOで学べるソフト開発と標準ライブラリの使い方

Grove-Thumb Joystickを使用する
1. モジュールの特性の確認
2. アナログ値をフィルタリングする
Seeeduino XIAOの拡張ボードを使用する
1. 標準ライブラリでブザーを鳴らす
2. OLEDライブラリの使用例
動作確認
ソースコード全体
関連リンク

Grove-Thumb Joystickを使用する

Grove-Thumb JoystickはSeeed Studioが製作しているGroveモジュールです。X方向とY方向に円を描くようにスティックを回すと操作位置に応じた電圧を出力します。詳細は下記のリンクを参考にしてください。

Grove – Thumb Joystick | Seeed Studio Wiki

Seeeduino XIAOにGrove-Thumb Joystickの電圧を入力すると操作量に応じた電圧を取得することができます。本記事では取得したアナログ値を使ってブザーの音程と長さを操作します。

Grove-Thumb Joystickを以下ではジョイスティックとします。

PR：わからないを放置せず、あなたにあったスキルを身に着けるコツを教えるテックジム　「書けるが先で、理解が後」を体験しよう！

モジュールの特性の確認

ジョイスティックのWikiページに標準値が記載されていますが、使用するモジュールによって中央値と最大/最小値は若干変化することから使用するモジュールの特性を確認します。

シリアルモニターにジョイスティックを±X方向と±Y方向に倒したときの値を表示して確認します。

X軸のシリアルモニターの結果と同様にしてY軸もシリアルモニターで値を確認しました。X軸とY軸の結果をまとめると以下の通りになりました。

軸	最小値（－側）	中央値（操作なし）	最大値（+側）
X軸	252	525	791
Y軸	264	519	772

モジュールの特性の確認

シリアルモニタでの確認の結果から本記事で使用するジョイスティックの基準値はX軸：525、Y軸：519とします。X軸よりもY軸の方が最小値と最大値のレンジが狭い結果になりました。

アナログ値をフィルタリングする

void TimerCnt(void){
  uint8_t i;
  uint16_t sumx=0;
  uint16_t sumy=0;

  meas.bufx[meas.wp] = analogRead(JOY_AO_X); //X軸の値を取得
  meas.bufy[meas.wp] = analogRead(JOY_AO_Y); //Y軸の値を取得

  if( ++meas.wp >= AIFILT_MAX ){ //保管先を更新
    meas.wp = 0;
  }

  for( i=0; i < AIFILT_MAX; i++ ){ //平均をとるため合計値を算出
    sumx += meas.bufx[i];
    sumy += meas.bufy[i];    
  }

  meas.x = sumx / AIFILT_MAX; //平均値を計算
  meas.y = sumy / AIFILT_MAX; //平均値を計算
}

アナログ値は外来ノイズの影響を受けるため取得したデータを平均化（ローパスフィルタの効果）して使用します。

TimerInt()関数は10ms毎にタイマー割り込みでコールされる自作の関数です。アナログ値のサンプリングタイミングを一定に保つため割り込みでアナログ値の取得と平均値を計算します。

analogRead()関数は引数で指定したピンのアナログ変換値を取得します。X軸、Y軸のアナログ値をそれぞれmeas.bufx[]、meas.bufy[]に格納します。

meas.wpはmeas.bufx[]及びmeas.bufy[]の配列にアナログ値を格納する場所を示したポインタ値です。meas.wpを更新することで配列に順番にアナログ値を格納します。

アナログ値の平均値を計算するため配列の合計値を計算し、配列の数（AIFILT_MAX）で割っています。meas.xとmeas.yに平均値を格納しアナログ値として使用します。

Seeeduino XIAOの拡張ボードを使用する

Seeeduino XIAO専用の拡張ボードを使用するとOLEDに文字を表示したりSDカードを使用したりGrove端子を利用してセンサーと接続することができます。下記記事に拡張ボードについてとOLEDライブラリ追加の方法をまとめています。

Seeeduino XIAOの拡張ボードのOLEDを使用する

標準ライブラリでブザーを鳴らす

拡張ボードにはブザーが実装されておりArduinoの標準ライブラリであるtone()関数を使ってブザーを鳴らすことができます。以下に一例を示します。

#define PIN_PULSE  3　//拡張基板では3を指定する

void setup() {
  uint8_t i;

  //初期化時に3回ピピピとブザーを鳴らす例
  for( i=0; i < 3; i++ ){
    tone(PIN_PULSE,3000, 100);
    delay(200);
  } 
｝

void loop() {

　//音程を変化させながらブザーを鳴らす例　
  if( timbuz == TIME_UP){
    timbuz = BUZ_WAIT;
    x_val = BASE_VALUE_X - meas.x; //アナログ値の変化を算出
    y_val = BASE_VALUE_Y - meas.y; //アナログ値の変化を算出
    tone(PIN_PULSE,BASE_FREQ + x_val, BASE_DUR + y_val);
  }
}

tone()関数の引数1にパルス波形を出力するピン番号を指定します。拡張基板では3が割り振られているので３ピンを指定します。

引数2に振動波形の周波数を指定します。周波数を高くするほどブザーの音程が高くなります。ブザーの対象帯域の周波数を指定しますが低すぎるとブザーが鳴らない場合や高すぎるとブザーが聞こえなくなります。

引数3にパルス波形の出力期間を指定します。引数3に値を指定しない場合は出力を続ける指定となります。

例ではジョイスティックから取得したアナログ値を第2引数と第3引数の値に使用することでブザーの周波数と出力期間が可変するようにしています。

注意事項としてパルス波形が出力される前にtone()関数を上書きすると状態変化によるウェイトなどによって出力されない状態になることがあります。頻繁なtone()の上書きが発生しないようにすることが必要です。

PR：わからないを放置せず、あなたにあった最低限のスキルを身に着けるコツを教えるテックジム　「書けるが先で、理解が後」を体験しよう！

OLEDライブラリの使用例

#include <U8x8lib.h>

U8X8_SSD1306_128X64_NONAME_HW_I2C u8x8( SCL, SDA, U8X8_PIN_NONE);

void setup() {
  u8x8.begin();　//初期化
  u8x8.setFlipMode(1);  // set number from 1 to 3
  u8x8.setFont(u8x8_font_5x8_r); //フォントを選択
}

OLEDライブラリの追加や初期化の方法は下記の記事を参考にしてください。

Seeeduino XIAOの拡張ボードのOLEDを使用する

U8x8libライブラリをインクルードしU8X8_SSD1306_128X64_NONAME_HW_I2Cクラスの変数としてu8x8（任意でよい）をインスタンス化します。setup()内でメンバー関数であるbegin()関数、setFlipMode()関数、setFont()関数などを使用してOLEDの初期化を行います。

u8x8.setCursor(0, 4); //カーソル移動
u8x8.print("X-->");
u8x8.print(meas.x); //アナログ値を文字列で出力
u8x8.setCursor(0, 6); //カーソル移動
u8x8.print("Y-->");
u8x8.print(meas.y);　//アナログ値を文字列で出力

setCursor()関数で文字表示する座標を指定します。第1引数に行番号、第2引数に列番号を指定します。座標を指定した後はprint()関数で文字を書き込んで表示します。例ではX–>の後ろにアナログ値を文字列で出力しています。Y–>についても同様です。

種別	内容
SetCursor()	データを書き込む初期位置（表示スタート位置）にカーソルを合わせます。
print() println()	文字列を指定して書き込み（表示）ます。 println()は文字列の最後に改行コードが入ります。
clearLine()	指定した列の文字をクリアします。

今回使用したメンバー関数

clearLine()関数で上書き前の文字列を消してから表示した場合、ラインの文字列を消してから文字列を書き込むため表示がチラついて見えます。

clearLine()関数を使用しない場合上書きする文字列が短い場合、文字が残ったまま上書きするため表示がおかしくなることがあります。文字列の長さを統一している場合はそのまま上書きしても問題になりません。