Seeeduino XIAOでRGB LEDを操作する

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

Arduino環境でRGB LED用のAdafruit_NeoPixelライブラリを使用するとRGB LEDを様々なパターンで点灯させることができます。Arduino IDEにAdafruit_NeoPixelライブラリを追加してRGB LEDを操作する方法を説明しています。

Seeeduino XIAO用拡張ボード（Seeed Studio）及びGrove Mech Keycap(Seeed Studio)を使用しています。RGB LEDはMech keycapに実装されているものとRGB LEDはマイコン内蔵RGB LED 5mm PL9823-F5(秋月電子で購入)を使用しています。

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

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

Adafruit NeoPixelライブラリを追加する
動作確認
ソースコード全体
関連リンク

Adafruit NeoPixelライブラリを追加する

Arduino IDEでライブラリの追加を行います。ライブラリマネージャーを開いて検索欄に「pixel」（adafruitなど）などライブラリ名の一部を入力するとライブラリの候補が表示されます。候補の中から「Adafruit NeoPixel by Adafruit」をインストールします。

RGB LEDを操作するためにArduinoの標準関数であるdigitalWrite()とタイマを使ってDOを操作する場合ライブラリの処理の遅延の為RGB LEDの操作に必要なタイミング波形を生成することができません。

Adafruit NeoPixelライブラリはArduinoマイコンの操作をアセンブラ（機械語）に近づけることで処理による遅延を可能な限り減らすことで精度の良いタイミング波形を生成するように工夫されています。

Adafruit NeoPixelライブラリは上記のことを意識しなくてもメンバー関数をコールすることで点灯パターンを指定できるようになっています。マイコンのDOでRGB LEDを操作する場合のタイミング波形の考え方を下記記事にまとめています。

PICマイコン(PIC16F1827)でRGB LEDを操作する

ライブラリの準備と初期化

#include <Adafruit_NeoPixel.h>

#define NUMPIXELS2 2 // Popular NeoPixel ring size
//Adafruit_NeoPixelクラスの型の変数を宣言
Adafruit_NeoPixel pixels2(NUMPIXELS2, PIXEL_PIN2, NEO_RGB  + NEO_KHZ400);

void setup() {
  pixels2.begin(); //DOなどの設定を行う
  pixels2.clear(); //色パターンクリア
  pixels2.show(); //色パターンを表示（点灯）
}

ライブラリを使用するためAdafruit_NeoPixel.hをインクルードします。Adafruit_NeoPixelクラスの型の変数を宣言してインスタンス化します。インスタンス化した変数の第1引数にはRGB LEDを操作する数を指定します。第2引数にはRGB LEDを操作するDOピンを指定します。第3引数にはRGB LEDの色のタイプ及びタイミング波形の周波数を選択します。

PL9823-F5を操作する変数をpixels2としています。PL9823-F5を2つ使って色のパターンを表示するため第1引数に2を指定しています。PL9823-F5の点灯順であるRGBを指定するためNEO_RGBを指定し応答速度を調整するためNEO_KHZ400（400kHz）を指定して加算しています。

PL9823-F5のデータシートには最大800kHzと記載がありますがライブラリのNEO_KHZ800（800KHz）を指定すると動作しないことがあったので速度を落としています。

begin()関数はインスタンス化した変数で指定したDOのピンの設定を行います。clear()関数は点灯のパターンをクリアします。show()関数で指定した点灯のパターンでLEDを点灯します。

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

ライブラリの使用例

for(uint16_t i=0; i<NUMPIXELS2; i++){
  if(i == 0){
    pixels2.setPixelColor(i,red2,green2,blue2);
  }
  else{
    pixels2.setPixelColor(i,red3,green3,blue3);
  }
    pixels2.show();
}

色パターンの指定にはsetPixelColor()関数を使用します。第1引数には点灯させるLEDのインデックス番号を指定します。インデックス番号はRGB LEDを連結して点灯する場合の番号です。第2引数は赤色の点灯パターンを0～255で指定します。第3引数は緑色の点灯パターンを0～255で指定します。第4引数は青色の点灯パターンを0～255で指定します。

setPixelColor()関数で点灯パターンを指定してshow()関数で点灯させます。例では1番目のLEDと2番目のLEDを続けて操作するためfor分による繰り返し処理を行っています。

show()関数の内部で300us程度のウェイトが実装されているためPL9823-F5では各RGB LEDを操作する間隔を意識する必要はありません。（使用するRGB LEDによってはウェイトを追加する必要がある可能性があります）

OLEDにRGBの状態を表示する

OLEDの表示はU8g2ライブラリを使用しています。U8g2ライブラリの追加方法については下記記事を参考にしてください。

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

本記事では表示に使用した関数について説明します。

char chr1[17];
 
u8x8.drawString(0,0,"Mech keycap     "); //0行0列を指定して書き込み
//u8x8.setCursor(0, 0);
//u8x8.print("Mech keycap     ");

sprintf(&chr1[0]," R%3d G%3d B%3d ",rd,grn,bl);//表示文字列を生成
u8x8.drawString(0,1, &chr1[0]); //0行1列を指定を指定して書き込み

drawString()関数は行と列および文字列を指定して書き込みを行う関数です。第1引数に行番号を指定します。行はセル群（5×8等のフォント）において左端の位置から右に向かって0～昇順になります。第2引数に列番号を指定します。列はセル群（5×8等のフォント）において上端から下に向かって0～昇順になります。

例では一番上の行（ライン）に”Mech keycap”の文字列を書き込んでいます。setCursor()関数でカーソル位置を指定してprint()関数で文字を書き込む方法と同等の処理になります。

sprintf()関数は文字列を生成する標準関数です。第1引数に生成後の文字列を格納するアドレスを指定します。第2引数に生成する文字列のフォーマットを指定します。%dなどの変換指定子を含めることでカウント値など任意の数値を文字列に変換することができます。

第3引数以降は第2引数内の変換指定子の数に応じて変換する変数を指定します。例では変数rd, grn,blを3桁の10進数で表示するように指定しています。

sprintf()を使用する場合、生成後の文字列を格納する配列に対して文字列の長さがオーバーしないように管理する必要があります。また文字列の最後にNULL文字（0）が付加されるので余裕を持った格納サイズを指定する必要があります。

例では16文字の生成に対してNULL文字を考慮して17バイトの領域を確保しています。生成した文字列が確保した領域を超えてしまうと領域オーバーした部分の値が書き換わってしまうため予期しない動作不良の原因となるため注意が必要です。

動作確認

PL9823-F5のデータシートの実装例には抵抗値が記載されていませんが、電流制限の目的で220Ωの抵抗を実装しています。抵抗を実装した影響で各色の輝度に影響するため各色に対してカウント値に制限を設けています。赤が100、緑が200、青は制限せず255段階の変更としています。Grove Mech KeycapのLEDは制限せず255段階の変更としています。

Grove Mech Keycapのボタンを押すと赤→緑→青→赤→・・・繰り返しの順でパターン変更する色の種別を変更します。Grove Mech Keycapのボタンを長押しするとすべてのLEDを消灯します。

SW1を押すと選択している色に対してカウントを+1し、長押しすると連続して更新します。SW2を押すと選択している色に対してカウントを-1し、長押しすると連続して更新します。

OLEDにGrove Mech KeycapのLED、LED1、LED2のカウント値を表示します。OLEDの表示処理には遅延が発生するためにタイマを設けることで頻繁な更新を行わないようにしています。そのためOLEDの表示はボタン操作より僅かに遅れて表示します。

更新頻度が高い場合SW1とSW2を連打しているとタイミングによってはOLEDの表示がバグるケースがありバグって画面が消えるとリセットしない限り復帰できなくなる問題が発生しました。更新の頻度と操作性を考慮した遅延時間の調整が必要だと感じました。

LED1のカウント値を基準にしてOLEDに４つのパターンでRGB LEDの点灯させました。LED1のカウント値はRGB LED1の下のラインがLED1のカウント値です。

パターン1は赤：100、緑：0、青：0とします。パターン2は赤：100、緑：0、青：255とします。パターン3は赤：0、緑：200、青：255とします。パターン4は赤：0、緑：200、青：1(0にすべきでしたが間違って1になっています)とします。

パターン1のLED1は赤色になっています。LED2はすべての色の合成で白色になっています。パターン2のLED1は赤と青の合成で紫色になっています。LED2はすべての色の合成で白色になっています。

パターン3のLED1は緑と青の合成で水色になっています。LED2はすべての色の合成で白色になっています。パターン4のLED1は緑でLED2は赤と緑の合成で黄色になっています。

Grove Mech KeycapのRGB LED及びLED1、LED2がSW1とSW2の組み合わせによって点灯のパターンが変更できていることが確認できました。

ソースコード全体

ソースコードは記事作成時点において動作確認できていますが、使用しているライブラリの更新により動作が保証できなくなる可能性があります。また、ソースコードを使用したことによって生じた不利益などの一切の責任を負いかねます。参考資料としてお使いください。

リンクからZIPファイル形式のファイルをダウンロードし、任意の場所に展開していただくとテキストファイルが生成されます。

ソースコードをダウンロード