# QF105

The QF105 System-on-Chip is an OpenMPW5 tapeout of the QF100 System-on-Chip family.

The QF100 System-on-Chip family is a simple, microcontroller-style system comprised of the following:

 1. A 3-stage, in-order 32-bit Lanai core
 2. 2KB of SRAM
 3. An SPI flash memory controller with 1024kb of instruction/data cache
 3. A Wishbone interconnect/fabric containing:
     1. An SPI controller
     2. A GPIO controller
     3. A simple timer

Notably absent are: an interrupt system and a debug interface.

<img src="https://object.ceph-eu.hswaw.net/q3k-personal/e1a5e381b78e7aaed10e88473902ae9adb624aaf87846746058479aaa5e6ced1.jpg" width="300">

## Lanai

Lanai is a family of RISC CPUs first introduced by Myricom in their NICs. Since then, its use seems to have mostly shifted to Google, whose engineers have contributed a Lanai target to LLVM. Not much is known about the use of the core inside Google.

The Lanai implementation in the QF100 series SoC targets the instruction set as generated by LLVM, called 'Lanai 11'. It diverges in some aspects from the previous versions of the instruction set as documented by Myricom and as implemented by their network cards, by removing RRR (register-register-register, a.k.a. dual-ALU) instructions, removing the PUNT instruction, and tightening some pipeline timing.

We have a work-in-progress LLD implementation for Lanai and Rust target for Lanai, that will be opensourced (and hopefully upstreamed) soon.

I wrote a [summary about Lanai](https://q3k.org/lanai.html) on my homepage.

## QF100 sources: qfc

The QF100 is built from a 'bundle' of verilog exported from the 'qfc' repository. This bundle contains pre-processed files containing both compiled Bluespec as well as Bluespec standard library code. Each hard macro in the resulting design has a separate Verilog file named the same way.

To update the bundle from qfc:

    $ cd qfc
    $ bazel build //boards/qf100
    $ cp bazel-bin/boards/qf100/qf100/*v ../verilog/rtl/