ソース参照します。https：//www.cnblogs.com/MyAutomation/p/9348480.html
SPIバスのArduinoライブラリ関数
SPIの基本
SPI：高速同期シリアルポート。これは、標準的な4線式同期シリアル双方向バスです。
名前が示唆するようSPIは、英語のシリアル・ペリフェラル・インターフェースの略でシリアル・ペリフェラル・インターフェース。モトローラは最初のプロセッサのそのMC68HCXXファミリに定義されています。SPIインターフェースは、主EEPROM、FLASH、に使用されているリアルタイムクロック、AD変換器、及びデジタル信号プロセッサとデコーダとの間のデジタル信号。SPIは、高速、全二重、同期通信バスであり、PCBレイアウト上のスペースを節約しながら、ICへの保存、チップのピンにのみ4本のワイヤを占有し、利便性、n個この簡単に使用できる機能のうち、今より多くのチップは、この統合通信プロトコルなどAT91RM9200などを、。
SPIバスシステムが同期してシリアル・ペリフェラル・インターフェース MCUと周辺機器の様々な行うことができ、情報を交換するためにシリアルに通信します。周辺FLASHRAM、ネットワークコントローラ、LCDディスプレイドライバ、A / D変換器等MCUを提供しました。SPIバスシステムに直接それは一般的に4つのラインに使用されるインターフェイス規格の周辺機器のそれぞれの製造業者の多様を指示することができる：MISOからシリアルクロックライン（SCLK）、ホスト入力/出力データ線を、内/スレーブをマスタデータ線MOSIとアクティブロースレーブ選択線SS（いくつかの割り込みラインINTとのSPIインタフェースチップは、何のSPIインターフェースチップの出力マスタ/スレーブ入力データ線MOSIは存在しません）。
SPI通信原理は、一方向伝送のために（事実3において、このデバイスの主作業モードからその方法は、一般的にマスタと1つまたは複数のスレーブデバイスを有する、単純であり、少なくとも4本のワイヤ月それは）半二重モードです。すべては総SPIデバイスに基づいていますSDI（データ入力）、SDO（あるデータ出力）、SCLK（クロック）、CS（チップセレクト）。
（SPIバスマスター出力/スレーブ入力）でMOSI-SPIバスのマスタアウト/スレーブ。
MISO-SPIバスマスター入力/スレーブ出力（SPIバスマスター入力/スレーブ出力）。
マスタデバイスによって生成SCLK-クロック信号;
SSと呼ばれるこのピンをマスター制御（チップ選択）によって、デバイスからの信号を有効にし、いくつかのICピンCS-。
チップが選択されているか否かを前記CS制御、それだけ言うことであるチップセレクト信号をイネーブル信号（高電位または低電位）に予め定められている、操作は、このチップのために有効です。これが可能同じバスSPI上の複数のデバイスを接続することができます。
通信のための責任3つのラインMOSI、MISO、SCLK。通信は、データ交換を介して行われ、SPIデータはビット単位で送信されることを意味するシリアル通信プロトコルです。SCKクロックによって提供されるパルス、パルスデータ転送に基づくSDI、SDOは、ここで、クロックラインSCLKである、完全です。データ出力は SDOラインを介してクロック立ち上がりエッジまたは立ち下がりエッジを、即座に立ち上がりまたは立ち下がりエッジで読み出されるとき、データが変化します。データ転送が完了すると、入力は同じ原理を使用します。このように、変化（及び1の下縁に沿って）、少なくとも8倍へのクロック信号は、8ビットデータの送信を完了します。
通信ポイントツーポイントでは、SPIインターフェースは、簡単かつ効率的に対処する操作と全二重通信を必要としません。システム内の複数のスレーブデバイスが、各デバイスは、イネーブル信号とは別に必要とし、ハードウェアは、I2Cよりも幾分複雑です。
SPI通信有4种不同的模式，不同的从设备可能在出厂时就配置为某种模式，这是不能改变的；但通信双方必须是工作在同一模式下，所以需要对主设备的SPI模式进行配置。通过CPOL（时钟极性）和CPHA（时钟相位）来设置主设备的通信模式，具体如下： Mode0：CPOL=0，CPHA=0 Mode1：CPOL=0，CPHA=1 Mode2：CPOL=1，CPHA=0 Mode3：CPOL=1，CPHA=1
时钟极性CPOL用来配置SCLK的电平处于哪种状态时是空闲态或者有效态，时钟相位CPHA用来配置数据采样是在第几个SCLK脉冲边沿： CPOL=0，表示当SCLK=0时处于空闲态，所以有效状态就是SCLK处于高电平时 CPOL=1，表示当SCLK=1时处于空闲态，所以有效状态就是SCLK处于低电平时 CPHA=0，表示数据采样是在第1个边沿，数据发送在第2个边沿 CPHA=1，表示数据采样是在第2个边沿，数据发送在第1个边沿
例如： CPOL=0，CPHA=0：此时空闲态时，SCLK处于低电平，数据采样是在第1个边沿，也就是SCLK由低电平到高电平的跳变，所以数据采样是在上升沿，数据发送是在下降沿。
CPOL=0，CPHA=1：此时空闲态时，SCLK处于低电平，数据发送是在第1个边沿，也就是SCLK由低电平到高电平的跳变，所以数据采样是在下降沿，数据发送是在上升沿。
CPOL=1，CPHA=0：此时空闲态时，SCLK处于高电平，数据采集是在第1个边沿，也就是SCLK由高电平到低电平的跳变，所以数据采集是在下降沿，数据发送是在上升沿。
CPOL=1，CPHA=1：此时空闲态时，SCLK处于高电平，数据发送是在第1个边沿，也就是SCLK由高电平到低电平的跳变，所以数据采集是在上升沿，数据发送是在下降沿。
SPI库函数
SPISettings 配置SPI总线端口
Description 描述
The SPISettings object is used to configure the SPI port for your SPI device. All 3 parameters are combined to a single SPISettings object, which is given to SPI.beginTransaction().
When all of your settings are constants, SPISettings should be used directly in SPI.beginTransaction(). See the syntax section below. For constants, this syntax results in smaller and faster code.
If any of your settings are variables, you may create a SPISettings object to hold the 3 settings. Then you can give the object name to SPI.beginTransaction(). Creating a named SPISettings object may be more efficient when your settings are not constants, especially if the maximum speed is a variable computed or configured, rather than a number you type directly into your sketch.
Syntax 语法
SPI.beginTransaction(SPISettings(14000000, MSBFIRST, SPI_MODE0)) Note:Best if all 3 settings are constants
SPISettings mySettting(speedMaximum, dataOrder, dataMode) Note:Best when any setting is a variable''
Parameters 参数
speedMaximum: The maximum speed of communication. For a SPI chip rated up to 20 MHz, use 20000000.
dataOrder: MSBFIRST or LSBFIRST
dataMode : SPI_MODE0, SPI_MODE1, SPI_MODE2, or SPI_MODE3 四种数据传送模式
Returns None 返回
begin() 初始化SPI总线的参数
Description
Initializes the SPI bus by setting SCK, MOSI, and SS to outputs, pulling SCK and MOSI low, and SS high.
Syntax SPI.begin()
Parameters None
Returns None
end() 关闭SPI总线
Description
Disables the SPI bus (leaving pin modes unchanged).
Syntax SPI.end()
Parameters None
Returns None
beginTransaction() 开始使用SPI总线
Description
Initializes the SPI bus using the defined SPISettings.
Syntax
SPI.beginTransaction(mySettings);
Parameters
mySettings: the chosen settings according to SPISettings.
Returns None.
endTransaction() 停用SPI总线
Description
Stop using the SPI bus. Normally this is called after de-asserting the chip select, to allow other libraries to use the SPI bus.
Syntax
SPI.endTransaction()
Parameters None.
Returns None.
setBitOrder() 设置传输数据时的先后顺序
Description
This function should not be used in new projects. Use SPISettings with SPI.beginTransaction() to configure SPI parameters.
Sets the order of the bits shifted out of and into the SPI bus, either LSBFIRST (least-significant bit first) or MSBFIRST (most-significant bit first).
Syntax
SPI.setBitOrder(order)
Parameters
order: either LSBFIRST or MSBFIRST
Returns None
setClockDivider() 设置时钟分频器
Description
This function should not be used in new projects. Use SPISettings with SPI.beginTransaction() to configure SPI parameters.
Sets the SPI clock divider relative to the system clock. On AVR based boards, the dividers available are 2, 4, 8, 16, 32, 64 or 128. The default setting is SPI_CLOCK_DIV4, which sets the SPI clock to one-quarter the frequency of the system clock (4 Mhz for the boards at 16 MHz).
Arduino DueOn the Due, the system clock can be divided by values from 1 to 255. The default value is 21, which sets the clock to 4 MHz like other Arduino boards.
Syntax
SPI.setClockDivider(divider)
Parameters
Returns None
setDataMode() 设置数据模式，即时钟的极性和相位
Description
This function should not be used in new projects. Use SPISettings with SPI.beginTransaction() to configure SPI parameters.
Sets the SPI data mode: that is, clock polarity and phase. See the Wikipedia article on SPI for details.
Syntax
SPI.setDataMode(mode)
Parameters
Returns None
transfer(), transfer16() 数据传送
Description
SPI transfer is based on a simultaneous send and receive: the received data is returned in receivedVal (or receivedVal16). In case of buffer transfers the received data is stored in the buffer in-place (the old data is replaced with the data received).
Syntax
receivedVal = SPI.transfer(val) receivedVal16 = SPI.transfer16(val16) SPI.transfer(buffer, size)
Parameters
val: the byte to send out over the bus val16: the two bytes variable to send out over the bus buffer: the array of data to be transferred
Returns the received data
usingInterrupt() 在中断中做SPI处理
Description
If your program will perform SPI transactions within an interrupt, call this function to register the interrupt number or name with the SPI library. This allows SPI.beginTransaction() to prevent usage conflicts. Note that the interrupt specified in the call to usingInterrupt() will be disabled on a call to beginTransaction() and re-enabled in endTransaction().
Syntax
SPI.usingInterrupt(interruptNumber)
Parameters
interruptNumber: the associated interrupt number.
Returns None.
SPI基本知识
SPI:高速同步串行口。是一种标准的四线同步双向串行总线。
SPI，是英语Serial Peripheral interface的缩写，顾名思义就是串行外围设备接口。是Motorola首先在其MC68HCXX系列处理器上定义的。SPI接口主要应用在 EEPROM，FLASH，实时时钟，AD转换器，还有数字信号处理器和数字信号解码器之间。SPI，是一种高速的，全双工，同步的通信总线，并且在芯片的管脚上只占用四根线，节约了芯片的管脚，同时为PCB的布局上节省空间，提供方便，正是出于这种简单易用的特性，如今越来越多的芯片集成了这种通信协议，比如AT91RM9200。
SPI总线系统是一种同步串行外设接口，它可以使MCU与各种外围设备以串行方式进行通信以交换信息。外围设置FLASHRAM、网络控制器、LCD显示驱动器、A/D转换器和MCU等。SPI总线系统可直接与各个厂家生产的多种标准外围器件直接接口，该接口一般使用4条线:串行时钟线(SCLK)、主机输入/从机输出数据线MISO、主机输出/从机输入数据线MOSI和低电平有效的从机选择线SS(有的SPI接口芯片带有中断信号线INT、有的SPI接口芯片没有主机输出/从机输入数据线MOSI)。
SPI的通信原理很简单，它以主从方式工作，这种模式通常有一个主设备和一个或多个从设备，需要至少4根线，事实上3根也可以(用于单向传输时，也就是半双工方式)。也是所有基于SPI的设备共有的，它们是SDI(数据输入)、SDO(数据输出)、SCLK(时钟)、CS(片选)。
MOSI–SPI总线主机输出/ 从机输入(SPI Bus Master Output/Slave Input);
MISO–SPI总线主机输入/ 从机输出(SPI Bus Master Input/Slave Output);
SCLK–时钟信号，由主设备产生;
CS–从设备使能信号，由主设备控制(Chip select)，有的IC此pin脚叫SS。
其中CS是控制芯片是否被选中的，也就是说只有片选信号为预先规定的使能信号时(高电位或低电位)，对此芯片的操作才有效。这就允许在同一总线上连接多个SPI设备成为可能。
3根线MOSI，MISO，SCLK负责通讯。通讯是通过数据交换完成的，SPI是串行通讯协议，也就是说数据是一位一位的传输的。由SCK提供时钟脉冲，SDI，SDO则基于此脉冲完成数据传输，这就是SCLK时钟线存在的原因。数据输出通过 SDO线，数据在时钟上升沿或下降沿时改变，在紧接着的下降沿或上升沿被读取。完成一位数据传输，输入也使用同样原理。这样，在至少8次时钟信号的改变(上沿和下沿为1次)，就可以完成8位数据的传输。
在点对点的通信中，SPI接口不需要进行寻址操作，且为全双工通信，简单高效。在多个从设备的系统中，每个从设备需要独立的使能信号，硬件上比I2C要稍微复杂。
SPI通信有4种不同的模式，不同的从设备可能在出厂时就配置为某种模式，这是不能改变的；但通信双方必须是工作在同一模式下，所以需要对主设备的SPI模式进行配置。通过CPOL（时钟极性）和CPHA（时钟相位）来设置主设备的通信模式，具体如下： Mode0：CPOL=0，CPHA=0 Mode1：CPOL=0，CPHA=1 Mode2：CPOL=1，CPHA=0 Mode3：CPOL=1，CPHA=1
时钟极性CPOL用来配置SCLK的电平处于哪种状态时是空闲态或者有效态，时钟相位CPHA用来配置数据采样是在第几个SCLK脉冲边沿： CPOL=0，表示当SCLK=0时处于空闲态，所以有效状态就是SCLK处于高电平时 CPOL=1，表示当SCLK=1时处于空闲态，所以有效状态就是SCLK处于低电平时 CPHA=0，表示数据采样是在第1个边沿，数据发送在第2个边沿 CPHA=1，表示数据采样是在第2个边沿，数据发送在第1个边沿
例如： CPOL=0，CPHA=0：此时空闲态时，SCLK处于低电平，数据采样是在第1个边沿，也就是SCLK由低电平到高电平的跳变，所以数据采样是在上升沿，数据发送是在下降沿。
CPOL=0，CPHA=1：此时空闲态时，SCLK处于低电平，数据发送是在第1个边沿，也就是SCLK由低电平到高电平的跳变，所以数据采样是在下降沿，数据发送是在上升沿。
CPOL=1，CPHA=0：此时空闲态时，SCLK处于高电平，数据采集是在第1个边沿，也就是SCLK由高电平到低电平的跳变，所以数据采集是在下降沿，数据发送是在上升沿。
CPOL=1，CPHA=1：此时空闲态时，SCLK处于高电平，数据发送是在第1个边沿，也就是SCLK由高电平到低电平的跳变，所以数据采集是在上升沿，数据发送是在下降沿。
SPI库函数
SPISettings 配置SPI总线端口
Description 描述
The SPISettings object is used to configure the SPI port for your SPI device. All 3 parameters are combined to a single SPISettings object, which is given to SPI.beginTransaction().
When all of your settings are constants, SPISettings should be used directly in SPI.beginTransaction(). See the syntax section below. For constants, this syntax results in smaller and faster code.
If any of your settings are variables, you may create a SPISettings object to hold the 3 settings. Then you can give the object name to SPI.beginTransaction(). Creating a named SPISettings object may be more efficient when your settings are not constants, especially if the maximum speed is a variable computed or configured, rather than a number you type directly into your sketch.
Syntax 语法
SPI.beginTransaction(SPISettings(14000000, MSBFIRST, SPI_MODE0)) Note:Best if all 3 settings are constants
SPISettings mySettting(speedMaximum, dataOrder, dataMode) Note:Best when any setting is a variable''
Parameters 参数
speedMaximum: The maximum speed of communication. For a SPI chip rated up to 20 MHz, use 20000000.
dataOrder: MSBFIRST or LSBFIRST
dataMode : SPI_MODE0, SPI_MODE1, SPI_MODE2, or SPI_MODE3 四种数据传送模式
Returns None 返回
begin() 初始化SPI总线的参数
Description
Initializes the SPI bus by setting SCK, MOSI, and SS to outputs, pulling SCK and MOSI low, and SS high.
Syntax SPI.begin()
Parameters None
Returns None
end() 关闭SPI总线
Description
Disables the SPI bus (leaving pin modes unchanged).
Syntax SPI.end()
Parameters None
Returns None
beginTransaction() 开始使用SPI总线
Description
Initializes the SPI bus using the defined SPISettings.
Syntax
SPI.beginTransaction(mySettings);
Parameters
mySettings: the chosen settings according to SPISettings.
Returns None.
endTransaction() 停用SPI总线
Description
Stop using the SPI bus. Normally this is called after de-asserting the chip select, to allow other libraries to use the SPI bus.
Syntax
SPI.endTransaction()
Parameters None.
Returns None.
setBitOrder() 设置传输数据时的先后顺序
Description
This function should not be used in new projects. Use SPISettings with SPI.beginTransaction() to configure SPI parameters.
Sets the order of the bits shifted out of and into the SPI bus, either LSBFIRST (least-significant bit first) or MSBFIRST (most-significant bit first).
Syntax
SPI.setBitOrder(order)
Parameters
order: either LSBFIRST or MSBFIRST
Returns None
setClockDivider() 设置时钟分频器
Description
This function should not be used in new projects. Use SPISettings with SPI.beginTransaction() to configure SPI parameters.
Sets the SPI clock divider relative to the system clock. On AVR based boards, the dividers available are 2, 4, 8, 16, 32, 64 or 128. The default setting is SPI_CLOCK_DIV4, which sets the SPI clock to one-quarter the frequency of the system clock (4 Mhz for the boards at 16 MHz).
Arduino DueOn the Due, the system clock can be divided by values from 1 to 255. The default value is 21, which sets the clock to 4 MHz like other Arduino boards.
Syntax
SPI.setClockDivider(divider)
Parameters
Returns None
setDataMode() 设置数据模式，即时钟的极性和相位
Description
This function should not be used in new projects. Use SPISettings with SPI.beginTransaction() to configure SPI parameters.
Sets the SPI data mode: that is, clock polarity and phase. See the Wikipedia article on SPI for details.
Syntax
SPI.setDataMode(mode)
Parameters
Returns None
transfer(), transfer16() 数据传送
Description
SPI transfer is based on a simultaneous send and receive: the received data is returned in receivedVal (or receivedVal16). In case of buffer transfers the received data is stored in the buffer in-place (the old data is replaced with the data received).
Syntax
receivedVal = SPI.transfer(val) receivedVal16 = SPI.transfer16(val16) SPI.transfer(buffer, size)
Parameters
val: the byte to send out over the bus val16: the two bytes variable to send out over the bus buffer: the array of data to be transferred
Returns the received data
usingInterrupt() 在中断中做SPI处理
Description
If your program will perform SPI transactions within an interrupt, call this function to register the interrupt number or name with the SPI library. This allows SPI.beginTransaction() to prevent usage conflicts. Note that the interrupt specified in the call to usingInterrupt() will be disabled on a call to beginTransaction() and re-enabled in endTransaction().
Syntax
SPI.usingInterrupt(interruptNumber)
Parameters
interruptNumber: the associated interrupt number.
Returns None.