目录
一. 基本介绍
1.1.整体结构
1.2. 结构细节与功能描述
二. 输入输出接口
2.1. IO Ports for SPI Leader
2.2. IO Ports for SPI Follower
2.3. SPI Mode Configuration
2.4. Leader IP和Follower IP功能图
三. SPI Programming
3.1. Leader Register Descriptions
3.2. Write to Follower Register
3.3. Read from Follower Register
3.4. Follower Message Formats
3.5. Follower Configuration Register Description
四. 实例分析
4.1. Auto Write Sequence
4.2. Auto Read Sequence
4.3. Write to Target Sequence
4.4. Read from Target Sequence
一. 基本介绍
1.1.整体结构
SPI广泛的应用于单片机与外围设备的连接，对于这种传统连接的SPI采用了MISO,MOSI,SCLK,SELECTS的信号线，并且支持一主多从的结构模式。那么本文中的Chiplet之间采用SPI通信接口仍然保留了此等特点，只不过文中将master对应为SPI leader，slave对应为SPI follower。同样是采用全双工方式通信，leader和follower同时在miso，mosi两条数据线上传输数据。
1.2. 结构细节与功能描述
如图2所示，Chiplet A中包含了SPI leader和一个initiator，initiator是整个Chiplet SPI的幕后主使者，它驱动着leader和follower以及target之间的一切行为，后文为有详细案例说明。在结构中只需要明白SPI leader IP 与initiator会在一个chiplet中，这个chiplet一般为FPGA，SOC或者ASIC。initiator与SPI leader之间采用AVMM接口片内通信。 当我们配置好initiator与SPI leader之间的关系之后，chiplet之间进行inter-chip interconnection就需要用到SPI 通信的原理了，这里首先要选定哪一个chiplet的spi follower进行通信，其次对于选定的chiplet也具有对应的结构。这里我们拿Chiplet B来进行说明，ChipletB中首先用于片间通信的IP就是SPI follower IP，其次Chiplet B使用AVMM接口进行片内通信，用于连接SPI follower与target。（这里的target可以是AIB接口，对其进行配置，也可以是application register，图2中chipletB中AVMM0,AVMM1的target都是AIB IP，AVMM2是application register）。initiator may be a NIOS soft IP microconctroller
二. 输入输出接口
2.1. IO Ports for SPI Leader
对于SPI leader的接口主要包含两个方面，一个方面是SPI leader与SPI follower之间通信的片间接口，其中就是SPI的基本元素，sclk时钟信号，ss_n[3:0]是follower的片选信号，最多支持4个follower，mosi和miso就是master out slave in和slave out master in， mosi是一位位宽，miso[3:0]是因为每个slave对应一条miso线。AVMM不做过多赘述，自行理解，在chiplet spi系统的讲解中我们只需要直到AVMM起到片内通信作用即可。但是需要值得注意的是SPI leader IP中的AVMM是follower，initiator才是AVMM leader。
2.2. IO Ports for SPI Follower
Table 2是follower的IO细节，首先具有SPI follower的interface与SPI leader进行片间通信，信号线与SPI leader基本一致， Select信号和miso信号都变为1位位宽。AVMM接口有三个，因为需要对应三个target。具体细节自行阅读table 2。
2.3. SPI Mode Configuration
在chiplet SPI系统中，只采用一种SPI mode，即mode 0. CPOL=0, CPHA=0。代表sclk在低电平时无效，在上升沿时采样。如下图所示。
Chiplet SPI IP支持DWORD (32 bit)传输，所以读写的数据传输必须是32bits的倍数。MSB首先被传输：bit 31，最后是bit 0。
2.4. Leader IP和Follower IP功能图
SPI leader和SPI follower都有command and status Register，以及write buffer和read buffer。CSR决定了SPI leader的片选信号以及改系统的启动信号，后文会有详细介绍。SPI leader的CSR 由initiator通过AVMM直接写入，而SPI follower的CSR需要由initiator先写入到SPI leader的write buffer，然后通过mosi发送到follower的write buffer，再register write至SPI follower的CSR。SPI follower的command就可以指导follower与target之间的操作。
三. SPI Programming
在user guide的第三部分，主要就是具体的系统通信操作以及相关代码分析。首先在进行具体的案例分析前，我们需要再次强调整体部件的功能。在整个系统中，initiator才是真正的核心，它是CHIPLET spi系统读写指令的产生和发出者。SPI Leader则相当于一个傀儡，无条件的执行来自initiator的指令，进行读写操作，这里我认为SPI Leader有点像Bridge的功能作用。
3.1. Leader Register Descriptions
我们之前在结构细节中提到了Leader主要包含了CSR,Write buffer，Read Buffer。下表则给出了Leader中涉及的register的详细说明，我们进行解读。
对于Leader而言，只有Command Register，Write buffer，Read buffer最为有用，其中Command Register是来自initiator的指令将直接存在这里，首先它的31：30bits用于选择SPI Follower。15：2是burst length，用于决定读写DWORDS的大小，DWORDS的大小= burst length - 1.假如burst length =3 ，则代表DWORDS的数量为4。bit 1则是区分读写操作，1代表read transaction，0代表write transaction。（但是这个对于SPI leader的操作来说是没有意义 ，因为SPI为全双工，当信号线拉低时，mosi和miso同时有数据在传输）。bit 0非常重要，用于启动通信，当把trans_valid =1时，则开始传输。并且在一条新的指令执行开始前，我们都需要等待trans_valid = 0，代表idle。
Write buffer是initiator写在write buffer中的数据，通过mosi发出到follower中，一般来说第一个数据将会被follower当作指令进行decoding，后文会通过详细案例介绍。read buffer则是miso从follower的read buffer发到leader read buffer的数据。
3.2. Write to Follower Register
1. 等待trans_valid = 0，即command register bit 0 = 0，从而确保SPI system在此时是idle的。
2. initiator通过AVMM接口将要发送的数据写入到leader的write buffer中。代码如下：
3.3. Read from Follower Register
1. 等待trans_valid = 0
2. initiator通过AVMM写入read command至leader 的write buffer，随后发送到follower进行告知，后续follower的command具体指令将会在后文介绍。
3.4. Follower Message Formats
我们之前说明了Leader的相关操作，比如Leader向Follower写，以及Leader从Follower读。相对于Leader而言，Follower的操作会更难一点，因为Leader相当于一个傀儡，全部由initiator说什么就做什么，不需要自行做过多的判断操作。但是follower则不一样，因为mosi这根线不仅要传数据，还要传让follower执行的指令，所以要对此进行区分的话，就要就一些额外的设定。所以就有了message formats。
对于Leader通过mosi发送到follower的message：
第一个DWORD,DW0代表指令：该指令的组成为：Command CMD[31:28], Burstlen[27:19], Address ADDR[18:0].which has the same format as Command Register0 [20:2]。19个bits，前两位为AVMM接口选择，后17bits为AVMM start address。
DW1-DWn：write data或者donot care。
对于Follower通过miso发送到Leader的message：
DW0: Dummy DW
DW1 - DWn: Read data or don't care, depending on the CMD and Command Register1 auto_rd_lat setting in table.
Table 4和Table 6显示了DW0的前四位 CMD[31:28]对应的功能。其中代表了六种不同的操作模式，后续会在实例中解释。
3.5. Follower Configuration Register Description
四. 实例分析
4.1. Auto Write Sequence
4.2. Auto Read Sequence
auto read就是从Target取到数据一直到leader的write buffer的过程再一个SPI transaction完成。由于AVMM clk和SPI clk是同步的，所以需要通过Follower Command Register1的auto_rd_lat 这个参数设置donot care 的 DWORDS直到read data 有效。
1. 根据AVMM target的类型配置Command Register 1，如果这个target是application register block，the fields auto_chan_num and auto_offset_addr are typically 0.target is an AIB PHY, set auto_chan_num to the number of channels to be written, minus one. If the target is an AIB PHY, set auto_offset_addr to 0x800. The following example shows a 24-channel four burst Auto Read. The Initiator programs the Follower Command Register1 field auto_chan_num to 23 to indicate that 24 channels are to be written.
2. 将DW0给follower的command写入到write buffer。其中包含了burstlen = 3，CMD = 6, addr。
3. 配置Leader 的command register，开始读取同时也发送。
3. master_polling( );
4. 开始接收数据
4.3. Write to Target Sequence
与auto操作不同的是，正常的write和read需要使用到follower的command register0.我们要通过follower的command register0指导follower与target的操作。所以一共要分为两个环节
第一环节：
1. 等待trans_valid=0
2. initiator写入leader write buffer 32'h 30000000, 代表buffer write
3. 将要发给target的data先写入到leader write buffer。
4. 配置leader command register并将write buffer里面的东西发送到follower的write buffer
5. content 包含（command DWORD和write buffer data）
第二环节：
1. 等待trans_valid = 0
2. 发送到leader write buffer 32‘h 10000000，代表register write，并且写到register 0
3. DW1为要存到follower command register0中的指令，该指令要包含：avmm_burst_len，AVMM接口选择，start addr，rdnwr=0（write），trans_valid。
4. 配置leader command register将这两个words发送过去
5. 等待trans_valid = 0
4.4. Read from Target Sequence
1. 等待 trans_valid = 0
2. 与write to target sequence环节相反，先配置follower的command register 0，写入到leader write buffer中（32'h 10000000）-》register write
3. 写入DW1，DW1为真正的command register0指令，包含avmm_burst_len,avmm选择，start_address = target's AVMM start address, rdnwr = 1(read), trans_valid = 1
4. 设置leader command register发送这两个words到follower
5. 等待trans_valid = 0
6. 将buffer read的指令通过initiator发送到Leader 的 write buffer DW0 32’h 20000000 -》buffer read
7. 设置leader的command register，开始从follower读取data，第一个为dummy word，后面为正常data。所以需要在正常words数量上加1.
