google-site-verification: google3bd66dd162ef54c7.html

ArduinoでI2Cキャラクタ液晶を使う(その2) ライブラリの選定

 ArduinoからI2Cインターフェイスのキャラクタ液晶を使う話の続きです。前回の記事で基本的な接続は確認出来たので、今回はライブラリを使って動かしてみます。実は、以前ライブラリの使用を試みたことがあるのですが、うまくいかなくて途中で断念しました。ライブラリを使わなくてもプログラムを頑張れば表示は出来ますが、いつもそんな面倒なことはやってられません。

▼回路図
AQM1602XA-RN-GBWとArduinoの接続図
 テストの前提条件は上の回路図で動くことです(I2Cバスは変換基板上でプルアップされています)。つまり、Arduino UNO に秋月のI2C接続キャラクタ液晶(AQM1602XA-RN-GBW)を接続して動かすことが目標です。たぶんこれ、現時点では一番多い使い方だと思います。なお、この回路では液晶の電源電圧とI2Cバスの信号レベルは共に5Vです。後の記事に出てきますが、この電圧条件をクリア出来ないライブラリがいくつかありました。

▼テストの様子
動作確認中
 I2Cのバスの信号を見ながらテストしました。

 ネットを検索してArduino で使えそうな I2C液晶のライブラリを探して、Arduino IDEに登録しました。ライブラリを登録すると、下の図のようにスケッチ例が出るようになるので、これを動かしてみれば正常に動くかどうか簡単に調べることが出来ます。なお、登録したライブラリが使えなかった場合は単にそのファイルを消すだけで済むはずで、後遺症は残らないと思います(たぶん)。

▼ライブラリに登録した様子
サンプルプログラム

 上を拡大したのが下の画面です。

▼今回登録したI2C液晶表示ライブラリ
登録したライブラリ
 今回、I2Cキャラクタ液晶用のライブラリとして、上記赤枠内の5種類のライブラリを登録しました。

 以下、この画面に出ている順にテスト結果をレポートしていきます。

1.I2CLiquidCrystal Noriaki Mitsunaga さん
 このライブラリでいきなりこの記事の結論が出てしまいました、このライブラリは使えます。このライブラリを使うと、lcd.setCursorとか、lcd.Print などパラレル液晶でおなじみのコマンドが使えます。それに何の修正も不要です。これこそ私が求めていたライブラリです。

 少しだけ説明を加えたいと思います。 このライブラリは初期化ルーチンでいろいろなメーカーのLCDが選べるようになっています。今回私が探していたのは上の回路図に書いたように秋月で売られているLCD用のライブラリですが、それはこのライブラリのデフォルトで指定されている Straberry Linux の定義がそのまま使えました。昔はストリナで売ってたけど今では秋月でも取り扱うようになったということなんでしょう。

 もう少し細かく説明すると、下記ルーチンで

// initialize the library
// uncomment next line if you are using a LCD from Straberry Linux
I2CLiquidCrystal lcd(20, (bool)true);
// | +--- set true if the power suply is 5V, false if it is 3.3V
// +-------- contrast (0-63)
 I2CLiquidCrystal lcd(20, (bool)true); となっているものを I2CLiquidCrystal lcd(20, (bool)false); とすれば電源電圧3.3V用の設定(Voltage Boosterが動く)となりますが、今回は5Vで使うのでこのままで大丈夫です。このあたりは作者の方のWebに詳しい説明があるのでそちらを見た方が判り易いです。

 なお、電源電圧指定の引数に論理値のキャスト(bool)が入っていますが、これは省略して下記のように書いてもかまわないと思います。 true という変数名は論理変数の真を表す予約語なのでキャストで明記する必要は無いと思うのですが、何か深い理由があるのかも知れません。
I2CLiquidCrystal lcd(20, true); 

2.LiquidCrystal_I2C fdebrabander さん@gitHub
 これ、gitHubに登録されていたものです。試してみたのですが全く動きませんでした。プログラムを見るとI2Cアドレスが0x27となっているので、全く別のメーカーの液晶用のライブラリのようです。なお、gitHub内の説明資料やプログラムの中も見たのですが液晶の型格が特定出来るような情報はありませんでした。名前だけで判断してはダメということですね。

3.skI2CLCDlib きむ茶工房さん
 きむ茶工房さんのwebには役に立つ情報がいっぱいあって、以前からお世話になっています。このライブラリでは液晶モジュールの電圧設定がデフォルトでは3Vになっているのでこれを下記のように修正して5Vに変更する必要があります。なおこのあたりは作者のWebに詳しく書かれています。
     // ICON OFF,コントラスト(0-63),VDD=3.3Vで使う
// LCD.Init(LCD_NOT_ICON,32,LCD_VDD3V) ;
LCD.Init(LCD_NOT_ICON,32,LCD_VDD5V) ;
 これでライブラリとしては正常に動くようになります。ただ残念なことに、文字表示の関数としてLCD.putc( )と LCD.puts( )くらいしか用意されていないようで、肝心のlcd.print( ) がありません。これではArduinoの文化で育った私は困ってしまいます(すみません)。たぶんPIC使いの方なら大丈夫なんでしょう。

 あと、きむ茶工房さんのサイトにこのキャラクタ液晶の昇圧回路について繰り返し注意が書かれています。これは自分も気にしていた点ですが、私と同じ見解が書かれていたので安心しました。

 それと、ライブラリの名前が skI2CLCDlib となっていて、先頭にsk という文字が入っているのは私の好きな作法です。このあたりの話は記事の後ろの方でまとめて触れたいと思います。

4.ST7032 オレ工房さん
 このライブラリはとても良く出来ていて必要な関数は全て揃っています。もちろん lcd.print もあります。スケッチ例もたくさん揃っていて親切な作りになっています。

 ただ残念なことに 昇圧回路が常にONになっていてライブラリからOFFにすることが出来ません。つまり液晶の電源電圧が3.3Vの場合しか使えません。Arduino UNOには3.3V電源を供給するピンがあるので、ここから液晶に電源を供給すればとりあえず動くとは思います。でも信号のレベルが合わないので I2Cバスのノイズマージンが確保出来ません。ということで、この使い方はお勧め出来ません。

 ということで私の結論は、このライブラリは使えない、ということになります。 あと、ライブラリの名称がドライバチップの名前のまま(ST7032)になっているのは、私としてはちょっと気になる点です。

5.wI2cLcdACN1602 エレキジャック、nakaoさん
 これ動きませんでした。よく見ると液晶のPNがACM1602となっていますが今回の液晶はAQM1602です。おまけにドライバのチップはST7066ということで全然別の製品用でした。これくらいは事前にちゃんと理解してから探せよ→自分。ということなんですが、すみません私が悪いです。

◆まとめ
 Arduinoで動かすI2Cキャラクタ液晶のライブラリは検索すれば簡単に見つかるだろう、と思っていたのですが。実際には簡単ではありませんでした。事実、今回は5種類試してそのまま使えたのは一つだけ(1.項の I2CLiquidCrystal)でした。昔、知識も無い状態で適当にネットで拾ったライブラリを入れてうまく動かなかったのはある意味当然の結果でした。

 あと、いまさら気付いたのですが、パラレルインターフェイスの液晶を使う場合のライブラリは LiquidCrystal.h を使いますが、このライブラリの完成度が素晴らしく高いので、他のライブラリを探す必要が全く無かったということなんですね。

◆ライブラリの名について
 この記事の中でちょっと触れていますが、ライブラリの名前について以前から気になっていることがあります。それは、ライブラリの名前は後で改良版を作る人のことを考えて付けて欲しい、ということです。デバイスの名前と同じライブラリがよく作られています(ex:デバイス名がABC123ならライブラリ名もABC123.h) 。でもそういうど真ん中の立派な名前を使われると、後で改良版を作る人はライブラリ名をどうするか困ってしまいます。(改変版を作る場合、オリジナルの作者の方の権利を侵さない注意は当然必要です。)

 もちろん最初の作者の方が、ずっとそのライブラリをメンテナンスしていただけるなら、ど真ん中の立派な名前を使っていただいてかまいません。でも現実を見ていると、そうはなっていないケースがたくさんあります。

 ライブラリの名前はもちろん判り易くないといけません。でもそれをそのまま使うのでは無く、ちょっと自分のイニシャルを追加して傷を付ける、というスタイルが良いのではないかと個人的には思います。今回の記事では、3.項と5.項のライブラリがそうなっていると思います。

 このくだりはちょっと余計だったかも知れません、また異論もあるでしょう。そもそもライブラリを一つも公開していない人間が偉そうなこと言うんじゃないよ、というお叱りを受けそうです。ただ、ずっと気になっていたので、この機会に文章にしてみました。
カレンダー
05 | 2017/06 | 07
- - - - 1 2 3
4 5 6 7 8 9 10
11 12 13 14 15 16 17
18 19 20 21 22 23 24
25 26 27 28 29 30 -
プロフィール

ラジオペンチ

Author:ラジオペンチ
電子工作を中心としたブログです。たまに近所(東京都稲城市)の話題など。60過ぎて視力や器用さの衰えを感じつつ日々挑戦!
コメントを入れる時にメールアドレスの記入は不要です。なお、非公開コメントは受け付けていません。

記事が気に入ったらクリックを!
最新記事
カテゴリ
最新コメント
リンク
FC2カウンター
検索フォーム
月別アーカイブ
RSSリンクの表示
QRコード
QRコード