IchigoJamで有機ＥＬキャラクタディスプレイモジュールを制御

IchigoJamで秋月電子で販売されている有機ＥＬキャラクタディスプレイモジュールを
制御してみました（型番はSO1602AWWB-UC-WB-Uという製品）。
IchigoJamのファームウェアは1.2.1を使っています。

IchigoJamからはI2C接続にて制御しています。

さすが有機EL、表示が綺麗ですね。

この有機ＥＬキャラクタディスプレイモジュール（以後長いのでOLEDと略）の使い方は
製品ページリンクのデータシートよりも、製品についてる説明書（日本語）の方が分かり
易いです。

結線
製品についてる説明書の「マイコンとの接続例」に従って結線するだけです。

プログラムソース

1 'OLED Character Display DEMO
10 CLV
20 GSB @ｼｮｷｶ
30 [0]="IchigoJam World"
40 [1]="ﾈ･ｺ･ﾆ･ｺ･ﾝ･ﾊﾞ･ﾝ･ﾜ"
50 X=0:Y=0:S=[0]:GSB @ﾋｮｳｼﾞ
60 X=0:Y=1:S=[1]:GSB @ﾋｮｳｼﾞ
70 END
500 @ｼｮｷｶ
510 POKE #700,0,1,2,#C,1,#40
520 FOR M=#701 TO #704
530 R=I2CW(#3C,#700,1,M,1)
540 NEXT
550 RTN
600 @ﾋｮｳｼﾞ
610 L=LEN(S)
620 POKE#706,#80+Y*32+X
630 R=I2CW(#3C,#700,1,#706,1)
640 FOR I=0 TO L-1
650 R=I2CW(#3C,#705,1,S+I,1)
660 NEXT
670 RTN

プログラムはわりと短めですね。使いやすいモジュールです。
（GSBはGOSUBの省略形、RTNはRETURNの省略形です）

簡単な解説

OLEDの利用のために２つのサブルーチン(GOSUBで呼び出し)を定義しています。
初期化処理(500行 @ｼｮｷｶ)と、表示処理(600行 @ﾋｮｳｼﾞ)です。

・初期化処理(500行 @ｼｮｷｶ)
  OLED対する命令は２バイト構成（コマンドコード＋データ）です。
  510行でそのコマンドとデータをメモリ上に定義しています。
  520行～540行でそのデータをI2Cアドレス#3CのOLEDに送っています。

  具体的には
    #00, #01 : Clear Display (表示部をクリア）
    #00, #02 : Return Home (カーソル位置を先頭に移動）
    #00, #0C : Send Display on command (表示ON、カーソル表示なし)
    #00, #01 : Clear Display (表示部をクリア、取りあえず説明書通りにもう一度クリア） 
  という４つの命令を送っています。

・表示処理(600行 @ﾋｮｳｼﾞ)
  引数（値を渡す変数）としてS、X、Yを使用しています。

     表示する文字列  S(文字列）
     表示位置横        X(0～15)
     表示位置縦        Y(0～1)
 
  610行が表示する文字列の長さを変数Lに設定、
  620行が表示位置アドレス (OLEDの内部アドレス）をメモリアドレス#706に設定
  しています。630行でその表示位置をOLEDに送信しています。
  具体的には次の２バイトを送信しています。
    #00, #80+表示位置アドレス(=#80+Y*32+X) : Set DDRAM Address

  表示アドレスは１行目が#00～#0F（左→右）、2行目が#20～#2F（左→右）となります。

  640行～660行が変数Sから１文字づつ文字を取り出して、OLEDに送信して
  表示を行っています。

これらのサブルーチンを10行から70行で利用しています。