SPISettings
Last revision:2026/01/24

名称

SPISettings

説明

SPIデバイスのSPIポートを設定するために、SPISettingsオブジェクは利用される。3つのすべてのパラメータは、一つのSPISettingsオブジェクトにまとめられ、SPI.beginTransaction()に渡される。

すべての設定値が定数のとき、SPISettingsはSPI.beginTransaction()内で直接利用することもできる。このときは、より小さく、より速いコードを生成する。どれかの設定が変数(特にクロックスピード)のとき、SPISettingsというオブジェクトを生成すると、より効率的になる。

このオブジェクトはSPIライブラリの一部である。詳細は、SPIを参照すること。

書式

  • SPISettings(speedMaximum, dataOrder, dataMode)
  • SPISettings mySetting(speedMaximum, dataOrder, dataMode)

C言語シグネチャ(avr)

SPISettings::SPISettings(uint32_t clock, uint8_t bitOrder, uint8_t dataMode);

SPISettings::SPISettings();

引数

speedMaximum通信の最大スピード。20MHzまで対応可能なSPIチップのときは、20000000を使う。
dataOrderMSBFIRSTもしくはLSBFIRST。
dataModeSPI_MODE0もしくはSPI_MODE1、SPI_MODE2、SPI_MODE3。

パラメータを省略した形式では、clock=4000000、bitOrder=MSBFIRST、dataMode=SPI_MODE0が設定される。

戻り値

なし。

コード例 

1
2
3
4
5
6

// Using SPISettings directly (best when all settings are constants)
SPI.beginTransaction(SPISettings(14000000, MSBFIRST, SPI_MODE0));

// Using a named SPISettings object (best when any setting is a variable)
SPISettings mySetting(speedMaximum, MSBFIRST, SPI_MODE0);
SPI.beginTransaction(mySetting);

オリジナルのページ

https://docs.arduino.cc/language-reference/en/functions/communication/SPI/SPISettings/

最終更新日

August 16, 2026

inserted by FC2 system