|
|
|
|
@@ -1,19 +1,19 @@
|
|
|
|
|
SiFive Generators
|
|
|
|
|
Rocket-Chip Generators
|
|
|
|
|
==================
|
|
|
|
|
|
|
|
|
|
Chipyard includes several open-source generators developed and maintained by `SiFive <https://www.sifive.com/>`__.
|
|
|
|
|
These are currently organized within two submodules named ``sifive-blocks`` and ``sifive-cache``.
|
|
|
|
|
Chipyard includes several open-source generators developed by `SiFive <https://www.sifive.com/>`__, and now openly maintained as part of Chips Alliance.
|
|
|
|
|
These are currently organized within two submodules named ``rocket-chip-blocks`` and ``rocket-chip-inclusive-cache``.
|
|
|
|
|
|
|
|
|
|
Last-Level Cache Generator
|
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
|
|
``sifive-cache`` includes last-level cache geneator. The Chipyard framework uses this last-level cache as an L2 cache. To use this L2 cache, you should add the ``freechips.rocketchip.subsystem.WithInclusiveCache`` config fragment to your SoC configuration.
|
|
|
|
|
``rocket-chip-inclusive-cache`` includes last-level cache geneator. The Chipyard framework uses this last-level cache as an L2 cache. To use this L2 cache, you should add the ``freechips.rocketchip.subsystem.WithInclusiveCache`` config fragment to your SoC configuration.
|
|
|
|
|
To learn more about configuring this L2 cache, please refer to the :ref:`memory-hierarchy` section.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Peripheral Devices Overview
|
|
|
|
|
----------------------------
|
|
|
|
|
``sifive-blocks`` includes multiple peripheral device generators, such as UART, SPI, PWM, JTAG, GPIO and more.
|
|
|
|
|
``rocket-chip-blocks`` includes multiple peripheral device generators, such as UART, SPI, PWM, JTAG, GPIO and more.
|
|
|
|
|
|
|
|
|
|
These peripheral devices usually affect the memory map of the SoC, and its top-level IO as well.
|
|
|
|
|
All the peripheral blocks comes with a default memory address that would not collide with each other, but if integrating multiple duplicated blocks in the SoC is needed, you will need to explicitly specify an approriate memory address for that device.
|
|
|
|
|
@@ -34,7 +34,7 @@ Finally, you add the relevant config fragment to the SoC config. For example:
|
|
|
|
|
General Purpose I/Os (GPIO) Device
|
|
|
|
|
----------------------------------
|
|
|
|
|
|
|
|
|
|
GPIO device is a periphery device provided by ``sifive-blocks``. Each general-purpose I/O port has five 32-bit configuration registers, two 32-bit data registers controlling pin input and output values, and eight 32-bit interrupt control/status register for signal level and edge triggering. In addition, all GPIOs can have two 32-bit alternate function selection registers.
|
|
|
|
|
GPIO device is a periphery device provided by ``rocket-chip-blocks``. Each general-purpose I/O port has five 32-bit configuration registers, two 32-bit data registers controlling pin input and output values, and eight 32-bit interrupt control/status register for signal level and edge triggering. In addition, all GPIOs can have two 32-bit alternate function selection registers.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
GPIO main features
|
|
|
|
|
@@ -78,7 +78,7 @@ Including GPIO in the SoC
|
|
|
|
|
Universal Asynchronous Receiver/Transmitter (UART) Device
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
UART device is a periphery device provided by ``sifive-blocks``. The UART offers a flexible means to perform Full-duplex data exchange with external devices. A very wide range of baud rates can be achieved through a fractional baud rate generator. The UART peripheral does not support other modem control signals, or synchronous serial data transfers.
|
|
|
|
|
UART device is a periphery device provided by ``rocket-chip-blocks``. The UART offers a flexible means to perform Full-duplex data exchange with external devices. A very wide range of baud rates can be achieved through a fractional baud rate generator. The UART peripheral does not support other modem control signals, or synchronous serial data transfers.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
UART main features
|
|
|
|
|
@@ -125,7 +125,7 @@ Including UART in the SoC
|
|
|
|
|
Inter-Integrated Circuit (I2C) Interface Device
|
|
|
|
|
-------------------------------------------------
|
|
|
|
|
|
|
|
|
|
I2C device is a periphery device provided by ``sifive-blocks``. The I2C (inter-integrated circuit) bus interface handles communications to the serial I2C bus. It provides multi-master capability, and controls all I2C bus-specific sequencing, protocol, arbitration and timing. It supports Standard-mode (Sm), Fast-mode (Fm) and Fast-mode Plus (Fm+).
|
|
|
|
|
I2C device is a periphery device provided by ``rocket-chip-blocks``. The I2C (inter-integrated circuit) bus interface handles communications to the serial I2C bus. It provides multi-master capability, and controls all I2C bus-specific sequencing, protocol, arbitration and timing. It supports Standard-mode (Sm), Fast-mode (Fm) and Fast-mode Plus (Fm+).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
I2C main features
|
|
|
|
|
@@ -169,7 +169,7 @@ Including I2C in the SoC
|
|
|
|
|
Serial Peripheral Interface (SPI) Device
|
|
|
|
|
-------------------------------------------------
|
|
|
|
|
|
|
|
|
|
SPI device is a periphery device provided by ``sifive-blocks``. The SPI interface can be used to communicate with external devices using the SPI protocol.
|
|
|
|
|
SPI device is a periphery device provided by ``rocket-chip-blocks``. The SPI interface can be used to communicate with external devices using the SPI protocol.
|
|
|
|
|
|
|
|
|
|
The serial peripheral interface (SPI) protocol supports half-duplex, full-duplex and simplex synchronous, serial communication with external devices. The interface can be configured as master and in this case it provides the communication clock (SCLK) to the external slave device.
|
|
|
|
|
|