前の記事でMicropythonとmicrobit_ssd1306ライブラリーを使ってMicro:bitからOLED有機ELディスプレイにテキストメッセージを表示する例を紹介しました。今回は、同じライブラリーを利用して、ビットマップファイルを表示する例を紹介します。
当記事は、シリーズでマイクロビット(Micro:bit)のプログラミングについて紹介しています。初めての方はこちらをご覧ください。
以下の項目については前回の記事を参照してください。
・使用するOLED有機ELディスプレイについて
・Micro:bitとOLED有機ELディスプレイの接続
・OLED有機ELディスプレイ用のライブラリーの入手とmu_codeフォルダーへのコピー
2021/9/15更新：当記事はMicro:bit V1.5 、Mu Editor V1.0.2 の時点でテスト済みですが、Mu Editor V1.1.0b5でカタカナライブラリーで不具合がありましたので Micro:bit V2でテストし直し、問題ない事を確認しました。当記事はMicro:bit V2 と Mu V1.1.0b5で動作確認しています。
１．使用するライブラリーと命令
当手順は、Githubの『Simple micropython library for the micro:bit to control the SSD1306 display』のライブラリーと手順を紹介しています。ビットマップ変換については手順が煩雑でしたので、プログラムを一部改修しましたので、オリジナル手順とは異なりますので、注意してください。
今回のライブラリーを使用すると、以下の命令がMuで使えるようになります。なお、今回のライブラリーは128×64専用ですので、128×32で使用すると画像がつぶれるようです。下の表示例を参照してください。
以下の表のサンプルプログラムのうち、３のビットマップファイルを表示するプログラムの手順を紹介します。使用する機能により、使用するライブラリーが異なりますので、注意してください。
| ライブラリーの命令 | 命令の説明 |
|
１．initialize() |
画面をリセットして初期化します。 以下の命令を実行する前に、必ず実行する必要があります。 |
|
２．clear_oled() |
画面を消去します。初期化の直後や、前に表示した画面を消去するために使用します。 |
|
３．show_bitmap(filename) |
別途準備されたbitmapファイル作成ソフトで作成したfilenameをディスプレイに表示します。 サンプルで提供されているbitmapファイルを表示するプログラム |
|
４．set_px(x, y, color, draw=1) |
x(0～127)とy(0～63)で指定した座標をcolor(0=黒か1=白)で指定した色で表示します。draw=0は表示用バッファーにデータを書き込むだけで、draw_screen()命令を使用して表示します。draw=1はすぐに表示されます。 |
|
５．get_px(x, y) |
x(0～127)とy(0～63)で指定した座標の色(0=黒か1=白)を返します。 |
|
６．add_text(x, y, text, draw=1) |
前回の記事で紹介済み |
|
７．create_stamp(img) |
Micro:bit内で定義されているImageを作成します。 |
|
８．draw_stamp(x, y, stamp, color, draw=1) |
７で作成したImageを表示します。 |
|
９．pulse(time=500) |
画面の明るさを指定した時間で徐々に明るくします。デフォルト値は0.5秒です。 |
|
１０．blink(time=1000) |
画面をtimeで指定した時間で点滅します。デフォルト値は1秒間隔です。 |
２．Muで実際にビットマップファイルを表示するプログラムを作成
２－１．Muを開始して、gazou_sample.pyを作成します。まだ、転送しないでください。（サンプルプログラムgazou_sample.pyをコピーしてください）
２－２．前回の記事でダウンロードしたmicrobit_ssd1306-masterフォルダー内にsample_imagesフォルダーがあります。その中に以下の３つのファイルがありますので、microbit_logoをmu_codeにコピーしてください。
bitmap_converter.py：ビットマップファイルをOLED有機ディスプレイ表示用に変換するプログラム
microbit_logo：OLED有機ディスプレイ表示用のデータ
microbit_logo.bmp：ビットマップファイル
２－３．必要なライブラリーをMicro:bitにコピーするために
をクリックすると、以下の様な画面になりMicro:bit内とコンピューター内のmu_codeフォルダーが表示されます。Micro:bit内には以前に転送したプログラムがmain.pyという名前で保存されています。どんな名前のプログラムを転送しても、main.pyという名前になります。mu_codeフォルダーはMuで作成したプログラムが保管される場所です。
２－４．必要なライブラリーをコンピューターのファイル：からドラッグして、Micro:bitのファイルでドロップしてコピーします。まず、ssd1306.pyをコピーします。以下のようになります。次に、同じようにssd1306_bitmap.pyもコピーします。
２－５．以下のようになりますので、次に表示用ファイルmicrobit_logoもコピーします。
２－６．以下のようになりますので、file操作を止めるために再度をクリックします。これをしないと転送できません。その後、転送をクリックしてプログラムをMicro:bitにコピーします。
２－７．転送が終わるとプログラムが実行され、ビットマップが以下のように表示されます。
３．OLED有機ディスプレイ(128×64)表示用ビットマップファイルの作成手順
この手順は、Windows１０環境で確認したものです。bitmap_converterJP.exeは当方で改修したものです。前回の記事でダウンロードしたmicrobit_ssd1306-masterフォルダー内にsample_imagesフォルダーがありますので、以下の手順はすべてそのフォルダーで作業してください。
３－１．以下のファイル『bitmap_converterJP.exe』をダウンロードして、microbit_ssd1306-masterフォルダー内にあるsample_imagesフォルダー内にコピーしてください。このプログラムは、pythonが導入されていなくても実行できます。
３－２．こちらにアクセスしてビットマップファイルをbitmap_converterJP.exeで使えるデータに変換するためのソフトを入手します。以下のような画面になりますので、『LCD_Assistant.zip』をクリックしてダウンロードしてください。
３－３．ダウンロードした『LCD_Assistant.zip』を適当なフォルダー（マイドキュメントなど）に解凍してください。解凍するとLCD_Assistantフォルダー内に『LCD_Assistant.exe』というプログラムが解凍されますので、このプログラムを実行してください。以下の様なウインドウが開きます。ビットマップファイルを作成後にこのプログラムで変換しますので、後で使用します。左側にある設定は以下の画面同様になっているか確認してください。
変換の流れ：①128×64のビットマップファイルを作成→②このプログラムで変換→③bitmap_converter.pyで再度変換してMicro:bitで表示
３－４．ウィンドウズのペイントソフトなどを使って、128x64pxのビットマップファイルを作成し、microbit_ssd1306-masterフォルダー内のsample_imagesフォルダーに保存してください。（ビットマップ作成手順については、ここでは省きます。）今回の説明用に以下のビットマップファイル『test1.bmp』をサンプルで作成しました。手順を確認するのであれば、このファイルを右クリックしてダウンロードして利用してください。
３－５．３－２でダウンロードしたプログラムで、test1.bmpファイルを読み込みます。File→Load imageをクリックします。
３－６．以下のようなファイルを選択する画面が表示されますので、microbit_ssd1306-masterフォルダー内のsample_imagesフォルダーから『test1.bmp』を選択します。
３－７．読み込んだビットマップが表示されますので、正しければFile→Save outputをクリックします。
３－８．以下のようなファイルを保存する画面が表示されますので、ファイル名『indata』を入力してmicrobit_ssd1306-masterフォルダー内のsample_imagesフォルダーに保存します。後述するプログラムで『indata』を使用しますので、他の名前にしないでください。
３－９．先ほど、１の手順でダウンロードしたmicrobit_ssd1306-masterフォルダー内のsample_imagesフォルダーにある『bitmap_converterJP.exe』をダブルクリックして実行します。以下の確認画面が開きますので、良ければエンターキーを押します。
３－１０．エンターキーを押すと、以下のメッセージを表示されます。良ければエンターキーを押して、プログラムを終わってください。microbit_ssd1306-masterフォルダー内にsample_imagesフォルダー内に『outdata』ができ上がっています。
３－１１．出来上がった『outdata』ファイルに分かりやすい名前を付けて、mu_codeフォルダーに移動するかコピーしてください。後は、『１．Muで実際にビットマップファイルを表示するプログラムを動かしてみる』の手順で『microbit_logo』のかわりに今回作成したファイルを使用すれば、以下のように表示されます。注意：プログラムのshow_bitmap(microbit_logo)のmicrobit_logoを今回作成したファイル名で書き換えてください。
４．ビットマップファイル表示を利用したプログラムの作成
以下は、ブロックエディターで作成した『トゥルース・オア・デア』をMicropythonで作成した例です。ひらがなメッセージをビットマップで作成してOLED有機ディスプレイに表示して分かりやすくなりました。
使用したビットマップファイルは以下です。上の手順で変換してプログラムを動かしてみてください。
次の記事では、『カタカナ』をテキスト表示できるライブラリーを追加しましたので紹介します。
最後まで記事をお読みいただきありがとうございます。
記事の改善に役立てたいと思いますので、よろしければアンケートにご協力ください。
今回の記事に使用した製品は以下になります。
