SerialLedController用Arduinoライブラリ

現在、Serial LED Shieldの頒布に向けてドキュメントの整理や梱包を行っております。
少しづつWindowsのアプリもVersionアップしていたりします。

今更ですが、GitHubも使い始めまして、Serial LED Shieldのライブラリを公開しました。
本ライブラリを利用することで、スッキリ？としたコードが書けるようになります。
そこで、インストールの方法とライブラリの使い方を簡単にご紹介させていただきます。

■インストールの方法

GitHubから、SerialLedController.zipをダウンロードします。

次に、ZipファイルのままArduino IDEにライブラリを登録します。

Arduino IDEを起動し
「スケッチ」->「ライブラリを使用」->「Add Library」を選択し、先ほどダウンロードしたzipファイルを指定します。

これでインストールは完了です。
画面はMAC用ですが、Windowsでも同様手順で利用できます。

■ライブラリの利用方法

インストールすることで、サンプルスケッチが複数インストールされますので、それを試してもらうのが一番早いと思います。
「スケッチの例」->「SerialLedController」->「SerialLedShield」->exampleがいろいろ

いろんなサンプルが入っています。

名称	概要
Baudrate19200	19200bpsでSerialLEDコントローラと通信します。
Baudrate57600	57600bpsでSerialLEDコントローラと通信します。
Default	デフォルトの（演出）設定で動作確認します。
Ext32Demo	最大数の32個LEDを使った演出デモ
HelloDemo	16(32)個のLEDを利用した文字表現
SerialCtrlDirect	Windows用のシリアルLEDプログラマーから演出確認が行える
Sw1Bar	Sw1押下でBar演出を確認します。
Sw1HardwareSerial	HartwareSerialを利用して通信するサンプル
Sw1Rainbow	Rainbow演出を確認します。
Sw1Seesaw	Seesaw演出を確認します。
Sw1Sift	Shift演出を確認します。
Sw1SoftwareSerial	SoftwareSerialを利用して通信するサンプル

※今後増える可能性があります。

Sw1Rainbow.inoを例にプログラムを説明することにします。

■プログラム例（Sw1Rainbow.ino）

１．ライブラリ利用時にインクルードします。

#include <SerialLedController.h>

その下にテーブルが見えますが、このテーブルがフルカラーLED演出用の定義テーブルです。
ここには４種類のテーブルが定義され、SW1を押下する毎にテーブルを切り替えて演出を変更するようになっています。
テーブルは、８バイト境界になるようにコマンドを記述するようにします。
コマンドの詳細は、シリアルコマンドの資料を確認してください。

２．シリアル通信のオブジェクトを生成します。

SoftwareSerial softSerial(2, 3);

３．今回のライブラリのオブジェクトを生成します。

SerialLedController controller(4, 5);

４．ライブラリの利用を開始します。

controller.begin(&softSerial, true);

ここは、SW1を押下されたときの処理です。
５．再生を停止します。（前回再生中の場合があるため）

controller.stop();

６．テーブルを指定しコマンドを転送します。（LEDの演出を指定する）

controller.write(led_play_list_array[index], led_play_list_size[index]);

７．再生を開始します。（LED演出開始）

controller.start();

Sw1を押下する毎にテーブルが切り替わり演出が変更されます。
詳しくは、ソースコード中のコメントや、GitHub上にあるReadMeに関数の説明がありますのでそちらを参照してください。