inky

インキー

Inky PhatのPython Library、Inky What、およびInky Impression e-Paper Displays for Raspberry Pi。

Inky Phat

Inky Phatは250x122ピクセルのeペーパーディスプレイで、赤/黒/白、黄色/黒/白、黒/白で利用できます。それは、ナメタグや、毎日のカレンダーや天気の概要などの非常に低い頻度の情報を表示するのに最適です。

インキー何

Inky赤/黒/白、黄色/黒/白、黒/白で利用できる400x300ピクセルの電子ペーパーディスプレイ。詳細な毎日のTo Doリスト、複数日の天気予報、バスの時刻表など、多くの解像度があります。

真っ白な印象

Inky Insirvesは、4インチ（640 x 400ピクセル）5.7 "（600 x 448ピクセル）および7.3"（800 x 480ピクセル）フレーバーで利用可能な、輝かしい7カラーEinkディスプレイのラインです。強い色が詰め込まれており、印象的なグラフィックや大量のデータを表示するのに最適です。

インストール

このライブラリをRaspberry Pi OS BookWorm以降で使用することをお勧めします。 Python≥3.7が必要です。

フルインストール（推奨）：

すべての前提条件をインストールし、最小限の労力で起きて実行する簡単なインストールスクリプトを作成しました。それを実行するには、メニューで見つける端末を起動します - >アクセサリ - > raspberry piデスクトップの端末、以下に説明します。

新しいターミナルウィンドウの入力では、コマンドが以下に表示されているとまったく同じように（タイプミスを確認してください）、画面上の手順に従います。

git clone https://github.com/pimoroni/inky
cd inky
./install.sh

メモライブラリは「Pimoroni」仮想環境にインストールされます。例を実行するには、アクティブ化する必要があります。

 source ~/.virtualenvs/pimoroni/bin/activate

発達：

貢献したい場合、または最新のコードを使用して座席の端に住んでいる場合は、次のような開発バージョンをインストールできます。

git clone https://github.com/pimoroni/inky
cd inky
./install.sh --unstable

Pypiから安定したライブラリをインストールし、手動で構成します

• 仮想環境をセットアップ： python3 -m venv --system-site-packages $HOME/.virtualenvs/pimoroni
• 仮想環境に切り替えます： source ~/.virtualenvs/pimoroni/bin/activate
• ライブラリのインストール： pip install inky

これは構成の変更を行うことはないため、次のことを有効にする必要がある場合があります。

• I2C： sudo raspi-config nonint do_i2c 0
• SPI： sudo raspi-config nonint do_spi 0

オプションで、 sudo raspi-configまたはグラフィカルなラズベリーPI構成UIを実行して、インターフェイスを有効にすることができます。

さらに、エラーを回避するには、SPIのチップ選択を無効にする必要がある場合があります。

 Woah there, some pins we need are in use!
  ️   Chip Select: (line 8, GPIO8) currently claimed by spi0 CS0

これにはdtoverlay=spi0-0csを/boot/firmware/config.txtに追加する必要があります。

使用法

ライブラリはPython 3で実行する必要があります。

自動セットアップ

Inkyは、（EEPROMに保存されている情報から）ボードを自動的に識別し、それに応じてセットアップすることができます。これは、最近のインキーディスプレイで作業する最も簡単な方法です。

 from inky . auto import auto
display = auto ()

その後、ボードから色と解像度を取得できます。

 display . colour
display . resolution 

手動セットアップ

EEPROMなしで古いInkyを持っている場合は、手動でタイプを指定できます。 Inky Libraryには、PHATとWhatの両方のモジュールが含まれています。次のように、Inky Phat Oneをロードします。

 from inky import InkyPHAT

その後、「赤」、「黄色」、または「黒」の色を選択し、クラスをインスタンス化する必要があります。

 display = InkyPHAT ( 'red' )

Inky LibraryからInky What Classをロードするために必要なものを使用している場合：

 from inky import InkyWHAT
display = InkyWHAT ( 'red' )

Inkyを初期化したら、心配する必要がある方法は3つしかありません。

画像を設定します

Inkyの内部バッファーにPIL画像、Numpy配列、またはリストを設定します。画像の寸法は、ファットの寸法または使用しているものと一致する必要があります。

 display . set_image ( image )

PILを使用して画像を作成する必要があります。 PIL 、画像の上にテキスト、線、形状を描くことができるImageDrawモジュールを提供します。参照：https：//pillow.readthedocs.io/en/stable/reference/imagedraw.html

境界線を設定します

あなたのファットなどの境界色の色を設定します。

 display . set_border ( colour )

colour 、 inky.RED 、 inky.YELLOW 、 inky.WHITE 、 inky.BLACKの1つである必要があります。

ディスプレイを更新します

画像を準備して設定し、境界線の色を選択したら、次のe-inkディスプレイを更新できます。

 display . show ()

移動

古いinkyphatライブラリからコードを移行している場合、描画と画像の操作機能の多くがInkyから削除されていることがわかります。これらの機能は常にPILによって提供され、推奨されるアプローチは、PILを使用して画像を作成および準備する前に、 set_image()を使用してInkyに設定することです。