687 TinyQV 'Berzerk' - Crowdsourced Risc-V SoC
687 : TinyQV 'Berzerk' - Crowdsourced Risc-V SoC
- Author: Michael Bell, et al
- Description: A Risc-V SoC with peripherals from the Tiny Tapeout Risc-V challenge, codename 'Berzerk'
- GitHub repository
- Open in 3D viewer
- Clock: 64000000 Hz
How it works
This is the Tiny Tapeout collaborative competition Risc-V SoC.
The CPU is a small Risc-V CPU called TinyQV, designed with the constraints of Tiny Tapeout in mind. It implements the RV32EC instruction set plus the Zcb and Zicond extensions, with a couple of caveats:
- Addresses are 28-bits
- Program addresses are 24-bits
- gp is hardcoded to 0x1000400, tp is hardcoded to 0x8000000.
Instructions are read using QSPI from Flash, and a QSPI PSRAM is used for memory. The QSPI clock and data lines are shared between the flash and the RAM, so only one can be accessed simultaneously.
Code can only be executed from flash. Data can be read from flash and RAM, and written to RAM.
The peripherals making up the SoC are contributed by the Tiny Tapeout community, with prizes going to the best designs!
Address map
| Address range | Device |
|---|---|
| 0x0000000 - 0x0FFFFFF | Flash |
| 0x1000000 - 0x17FFFFF | RAM A |
| 0x1800000 - 0x1FFFFFF | RAM B |
| 0x8000000 - 0x8000033 | DEBUG |
| 0x8000040 - 0x800007F | GPIO |
| 0x8000080 - 0x80000BF | UART |
| 0x8000100 - 0x80003FF | User peripherals 4-15 |
| 0x8000400 - 0x80004FF | Simple user peripherals 0-15 |
| 0xFFFFF00 - 0xFFFFF07 | TIME |
DEBUG
| Register | Address | Description |
|---|---|---|
| ID | 0x8000008 (R) | Instance of TinyQV: 0x42 (ASCII B) |
| SEL | 0x800000C (R/W) | Bits 6-7 enable peripheral output on the corresponding bit on out6-7, otherwise out6-7 is used for debug. |
| DEBUG_UART_DATA | 0x8000018 (W) | Transmits the byte on the debug UART |
| STATUS | 0x800001C (R) | Bit 0 indicates whether the debug UART TX is busy, bytes should not be written to the data register while this bit is set. |
See also debug docs
TIME
| Register | Address | Description |
|---|---|---|
| MTIME_DIVIDER | 0x800002C | MTIME counts at clock / (MTIME_DIVIDER + 1). Bits 0 and 1 are fixed at 1, so multiples of 4MHz are supported. |
| MTIME | 0xFFFFF00 (RW) | Get/set the 1MHz time count |
| MTIMECMP | 0xFFFFF04 (RW) | Get/set the time to trigger the timer interrupt |
This is a simple timer which follows the spirit of the Risc-V timer but using a 32-bit counter instead of 64 to save area. In this version the MTIME register is updated at 1/64th of the clock frequency (nominally 1MHz), and MTIMECMP is used to trigger an interrupt. If MTIME is after MTIMECMP (by less than 2^30 microseconds to deal with wrap), the timer interrupt is asserted.
GPIO
| Register | Address | Description |
|---|---|---|
| OUT | 0x8000040 (RW) | Control for out0-7 if the GPIO peripheral is selected |
| IN | 0x8000044 (R) | Reads the current state of in0-7 |
| AUDIO_FUNC_SEL | 0x8000050 (RW) | Audio function select for uio7 |
| FUNC_SEL | 0x8000060 - 0x800007F (RW) | Function select for out0-7 |
| Function Select | Peripheral |
|---|---|
| 0 | Disabled |
| 1 | GPIO |
| 2 | UART |
| 3 - 15 | User peripheral 3-15 |
| 16 - 31 | User byte peripheral 0-15 |
| 32 - 39 | User peripheral 16-23 |
| Audio function select | Peripheral |
|---|---|
| 0-3 | PSRAM B enabled |
| 4 | 08 PWL Synth out 7 |
| 5 | 08 PWL Synth out 6 |
| 6 | 20 AY8913 out 7 |
| 7 | 21 Matt PWM out 7 |
UART
| Register | Address | Description |
|---|---|---|
| TX_DATA | 0x8000080 (W) | Transmits the byte on the UART |
| RX_DATA | 0x8000080 (R) | Reads any received byte |
| TX_BUSY | 0x8000084 (R) | Bit 0 indicates whether the UART TX is busy, bytes should not be written to the data register while this bit is set. Bit 1 indicates whether a received byte is available to be read. |
| DIVIDER | 0x8000088 (R/W) | 13 bit clock divider to set the UART baud rate |
| RX_SELECT | 0x800008C (R/W) | 1 bit select UART RX pin: ui_in[7] when low (default), ui_in[3] when high |
How to test
Load an image into flash and then select the design.
Reset the design as follows:
- Set rst_n high and then low to ensure the design sees a falling edge of rst_n. The bidirectional IOs are all set to inputs while rst_n is low.
- Program the flash and leave flash in continuous read mode, and the PSRAMs in QPI mode
- Drive all the QSPI CS high and set SD1:SD0 to the read latency of the QSPI flash and PSRAM in cycles.
- Clock at least 8 times and stop with clock high
- Release all the QSPI lines
- Set rst_n high
- Set clock low
- Start clocking normally
Based on the observed latencies from tt06 testing, at the target 64MHz clock a read latency of 2 is required. The maximum supported latency is currently 3.
The above should all be handled by some MicroPython scripts for the RP2040 on the TT demo PCB.
Build programs using the customised toolchain and the tinyQV-sdk, some examples are here.
External hardware
The design is intended to be used with this QSPI PMOD on the bidirectional PMOD. This has a 16MB flash and 2 8MB RAMs.
The UART is on the correct pins to be used with the hardware UART on the RP2040 on the demo board.
It may be useful to have buttons to use on the GPIO inputs.
IO
| # | Input | Output | Bidirectional |
|---|---|---|---|
| 0 | Interrupt 0 | UART TX | Flash CS |
| 1 | Interrupt 1 | UART RTS | SD0 |
| 2 | SD1 | ||
| 3 | SCK | ||
| 4 | SD2 | ||
| 5 | SD3 | ||
| 6 | Debug UART TX | RAM A CS | |
| 7 | UART RX | Debug signal / PWM | RAM B CS / PWM |