クラス SPI -- シリアルペリフェラルインタフェース バスプロトコル(マスタ側)¶
SPI はマスタによって駆動される同期シリアルプロトコルです。物理レベルにおいて、バスは SCK、MOSI、MISO 3本の線で構成されています。複数のデバイスが同じバスを共有できます。各デバイスには、通信を行うバス上の特定のデバイスを選択するための個別の4番目の信号 SS (Slave Select)が必要です。SSシグナルの管理はユーザーコードで(machine.Pin クラス経由で)行う必要があります。
ハードウェア SPI の実装は machine.SPI クラス、ソフトウェア SPI の 実装は machine.SoftSPI クラスにより利用できます。ハードウェア SPI は、システムの基盤ハードウェアサポートを使って読み書きします。たいていは効率的で高速ですが、利用できるピンに制限のある場合があります。ソフトウェア SPI はビットバンギングによって実装されており、どのピンでも利用できますが、効率的ではありません。両クラスとも利用可能なメソッドは同じで、構築方法が異なるのが大きな違いです。
コンストラクタ¶
-
class
machine.SPI(id, ...)¶ id で指定したバスで SPI オブジェクトを構築します。 id に指定できる値はポートとそのハードウェアに依存します。値 0, 1 などは一般的に、ハードウェア SPI ブロック #0, #1 などを選択するために使われます。
追加のパラメータを指定しないと、SPI オブジェクトは作成されますが初期化されません(そのような場合、バスが過去に初期化されたことがあれば、その定が引き継がれます)。追加のパラメータが与えられると、バスは初期化されます。追加のパラメータについては
initを参照してください。
-
class
machine.SoftSPI(baudrate=500000, *, polarity=0, phase=0, bits=8, firstbit=MSB, sck=None, mosi=None, miso=None)¶ ソフトウェア SPI オブジェクトを新規に構築します。追加のパラメータを指定する必要があり、たいていは少なくとも sck, mosi, miso を指定します。パラメータの説明は SPI.init を参照してください。
メソッド¶
-
SPI.init(baudrate=1000000, *, polarity=0, phase=0, bits=8, firstbit=SPI.MSB, sck=None, mosi=None, miso=None, pins=(SCK, MOSI, MISO))¶ 与えたパラメータで SPI バスを初期化します。
baudrateは SCK のクロックレートです。polarityは 0 か 1 であり、アイドリング状態のときのクロックのレベルを指定します。phaseは 0 か 1 であり、それぞれ、１番目または２番目のクロックエッジでのデータ読取りを指定します。bitsは各転送のビット幅です。すべてのハードウェアでサポートされることが保証されているのは 8 だけです。firstbitは SPI.MSB か SPI.LSB です。sck,mosi,misoはバス信号に使用するピン(machine.Pin)オブジェクトです。ほとんどのハードウェア SPI ブロック(コンストラクタのパラメータ id で指定)では、ピンが固定されていて変更できません。場合によっては、ハードウェアブロックが、１つのハードウェアSPIブロックに対して２～３の代替ピンセットを許しています。任意のピン割り当ては、ビットバンギング SPI ドライバー(id= -1)に対してのみ可能です。pins- WiPy ポートにはsck,mosi,miso引数がありません。その代わりpinsパラメータでタプルとしてそれらを指定できます。
ハードウェア SPI の場合、実際のクロック周波数は要求されたボーレートより低いかもしれません。これはプラットフォームのハードウェアに依存します。実際のレートは SPI オブジェクトを
print関数で表示することにより判ります。
-
SPI.deinit()¶ SPI バスをオフにします。
-
SPI.read(nbytes, write=0x00)¶ writeで指定した１バイトを連続で書き込みながら、nbytesで指定したバイト数を読み込みます。読み込んだデータを持つbytes型オブジェクトを返します。
-
SPI.readinto(buf, write=0x00)¶ writeで指定した１バイトを連続で書き込みながら、bufに指定したバッファに読み込みます。Noneを返します注記: WiPy では読み込んだバイト数を返します。
-
SPI.write(buf)¶ bufに含まれる bytes 型オブジェクトを書き込みます。Noneを返します。注記: WiPy では書き込んだバイト数を返します。
-
SPI.write_readinto(write_buf, read_buf)¶ read_bufに読込みながらwrite_bufの bytes 型オブジェクトを書き込みます。両バッファは同じでも異なっていてもかまいませんが、同じ長さでなければなりません。Noneを返します。注記: WiPy では書き込んだバイト数を返します。