neopixel
--- WS2812 / NeoPixel LED の制御¶
このモジュールは WS2812 / NeoPixel LED のドライバです。
注釈
このモジュールは ESP8266、ESP32、RP2 のポートにのみデフォルトで含まれています。STM32 / Pyboard などでは mip を使って neopixel
パッケージをインストールするか、 直接 micropython-lib からモジュールをダウンロードして、ファイルシステムにコピーしてください。
クラス NeoPixel¶
このクラスは、ピンに接続された WS2812 LED ストリップのピクセルデータを格納します。アプリケーションは、ピクセルデータを設定し、ストリップを更新する準備ができたら、 NeoPixel.write()
を呼び出す必要があります。
たとえば次のように使います:
import neopixel
# 32 LED ストリップ X8 に接続
p = machine.Pin.board.X8
n = neopixel.NeoPixel(p, 32)
# 赤のグラデーションを描画
for i in range(32):
n[i] = (i * 8, 0, 0)
# ストリップを更新
n.write()
コンストラクタ¶
- class neopixel.NeoPixel(pin, n, *, bpp=3, timing=1)¶
NeoPixel オブジェクトを構築します。パラメータは次のとおりです:
pin は machine.Pin のインスタンスです。
n はストリップにある LED の数です。
bpp は RGB LED の場合で 3、RGBW LED の場合で 4 です。
timing は 40kKHz LED で 0、800kHz LED で 1 です(たいていは 800kHz)。
machine.bitstream()
が受け入れるタイミングのタプルでも指定できます。
ピクセルにアクセスするメソッド¶
- NeoPixel.fill(pixel)¶
指定した pixel 値(すなわち RGB/RGBW のタプル)を、すべてのピクセルの値に設定します。
- NeoPixel.__len__()¶
ストリップにある LED の数を返します。
- NeoPixel.__setitem__(index, val)¶
index で指定したピクセルに値(RGB/RGBW のタプル)を設定します。
- NeoPixel.__getitem__(index)¶
index で指定したピクセルの値(RGB/RGBW のタプル)を返します。
出力メソッド¶
- NeoPixel.write()¶
現在のピクセルデータをストリップに書き出します。