arduino: 猫にコ・ン・バ・ン・ワ

2024年9月
日	月	火	水	木	金	土
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

「Arduino用美咲フォントライブラリ教育漢字・内部フラッシュメモリ乗せ版」を更新しました。
ここ最近の調査をライブラリに反映しました。

・Arduino-misakiUTF16 Arduino用美咲フォントライブラリ教育漢字・内部フラッシュメモリ乗せ版
　https://github.com/Tamakichi/Arduino-misakiUTF16

おもな変更点
・ライブラリ形式(library format)をrev. 2.2に変更(以前はrev 1.x)
・美咲フォントの最新版 2021-05-05(美咲ゴシック第2)利用に変更
　(以前は2012-06-03 正式公開初版を利用)
・isZenkaku()の追加
　⇒ 半角(4ドット)・全角(8ドット)幅判定により半角文字を詰めて表示可能となりました
・いくつかの不具合対応(半角・全角変換ミスなど)

せっかくの機会なので、新Arduino Uno（Arduino Uno R4 WiFi)に搭載されているLEDマトリックスで、デモってみました。

Arduino Uno R4 WiFi搭載 LEDマトリックスで美咲フォント表示
Arduino_uno_r4_led_matrix

動いている様子(Youtube ※BGMあり)

表示器がボート搭載だと、お手軽に利用できて良いですね～

プログラムソース

このサンプルプログラムは、ライブラリのサンプルプログラムとして添付しました。

参考にした文献
・Using the Arduino UNO R4 WiFi LED Matrix
　https://docs.arduino.cc/tutorials/uno-r4-wifi/led-matrix/

　公式サイトのLEDドットマトリックスを利用するための解説です。
　利用するライブラリ及び、LEDドットマトリックスのフレームバッファの構造について説明されています。

今回作成したサンプルプログラムでは、フレームバッファにデータをセットして表示しています(setAt()関数)。
フレームバッファの構造は、横12ドットx縦8ドットの計96ドット分の96ビットをlong整数 32ビットx3個に単純に詰めている感じです。
フレームバッファを直接いじれば、なんでも表示できそうですね

フレームバッファの左スクロールを実装しているscroll()関数、
汎用性のない、12x8ドット限定の力業実装で少々分かりにくいコードですが、
32ビットx3の配列をビットシフトでビットを左にずらしているのですが、その際に
　①ビットシフト時の最上位ビットの欠落対策
　②0～7行の右端ビットクリア、
　③ワードをまたぐ行の左端ビットの処理
を行って補正してます。
ちょっとエレガントでないのでもう少し良い方法があるかもしれません

新Arduino Uno R4ボード、搭載マイコンがRenesas RA4M1（Arm Cortex-M4）に変更となりました。
このボードも発売直後に購入したものの、放置していました。やっと使い始めた感じです。
まだまだ、使いこなせてないので、ドキュメントをあさりつつ遊んで行きたいと思います。

こんな感じで、ライブラリ更新と少々の動作確認の上、公開いたしました。

Arduino用の美咲フォントライブラリの更新に伴い、Arduino用ライブラリ作成の再確認メモです。
(久しぶりのライブラリ作成・修正ですっかり忘れてました)

参考文献
・Arduino DOCS - Home/Learn/ Writing a Library for Arduino
　https://docs.arduino.cc/learn/contributions/arduino-creating-library-guide/
　ライブラリ作成の入門編的な資料です。

・Library specification
　https://arduino.github.io/arduino-cli/0.36/library-specification/
　ライブラリ作成に関する仕様です。

・KEI SAKAKI's PAGE. - Arduino開発環境用の「ライブラリ」を作成してみる
　https://kei-sakaki.jp/2015/01/07/making-library-for-arduino-development-environment/
　Arduino IDEのバージョン的に少々古い情報となりますが、大変参考になりました（情報公開に感謝♪

まずは、ディレクトリ構成に規約があります。
■ ライブラリのディレクトリ構成
・librarys\
　 ライブラリ格納ディレクトリ\
　　　 keywords.txt
　　　 library.properties
　　　 src\
　　　　ライブラリ用ヘッダーファイル
　　　　ライブラリ用ソースファイル
　　　examples\
　　　　サンプルプログラム\
　　　　　　サンプルプログラムソースファイル
　　　　　　　・・・
　　　extras\ （オプション）
　　　資料など

例：美咲フォントライブラリの例

librarys\

└─ misakiUTF16\

　 │ keywords.txt

　 │ library.properties

　 ├─ examples\

　 │ ├─ aitendo_ht16k33

　 │ │ aitendo_ht16k33.ino

　 │ ├─ banner\

　 │ │ banner.ino

　 │ └─ misaki_tvout\

　 │ misaki_tvout.ino

　 └─ src\

　　　　　 misakiUTF16.cpp

　　　　　 misakiUTF16.h

　　　　　 misakiUTF16FontData.h

■keywords.txt の定義

name=misakiUTF16

version=1.2.0

author=Tamakichi

maintainer=Tamakichi

email=tamacat2014@gmail.com

sentence=Japanese font data and driver

paragraph=8x8dots Misaki font driver for Arduino Uno

category=Other

url=https://github.com/Tamakichi/Arduino-misakiUTF16

architectures=*

■library.propertiesの定義

#######################################
# Syntax Coloring Map For misakiUTF16
#######################################

#######################################
# Datatypes (KEYWORD1)
#######################################

#######################################
# Methods and Functions (KEYWORD2)
#######################################
misakiUTF16 KEYWORD2
findcode KEYWORD2
getFontDataByUTF16 KEYWORD2
getFontData KEYWORD2
utf16_HantoZen KEYWORD2
hkana2kana KEYWORD2
HantoZen KEYWORD2
charUFT8toUTF16 KEYWORD2
Utf8ToUtf16 KEYWORD2
getFontTableAddress KEYWORD2
isZenkaku KEYWORD2
LatenS2Zen KEYWORD2
isBasicLatin KEYWORD2
isLatinSupple KEYWORD2

#######################################
# Constants (LITERAL1)
#######################################

■開発者用フラグファイル
ライブラリの開発中、Arduino IDEにてlibrarys\に配置いているサンプルプログラムの上書きは禁止されているのですが、
ライブラリのルートフォルダに.developmentを配置すると上書き可能となる。

これについて検証してみましたが、Arduino IDEでサンプルプログラムを直接開いた分には、この設定無しに上書きできます。
Arduino IDEの「スケッチの例」にてサンプルプログラムを開いた場合は、.developmentの有無に関係なく、上書き出来ません。
う～ん、今一意味不明..

・・・

しかし、ココログ.. htmlのタグ記述とかできるのに、いうこと聞いてくれなくて糞過ぎ..(>_<)
過去の記事は修正するとレイアウトが崩れるので編集不能だし.. 何とかならんですかね..