This repository contains a portable OpenSource HyperRAM controller for FPGAs written in VHDL. I'm writing my own implementation because I've looked at several other implementations, and they all seemed lacking in various regards (features, stability, portability, etc.)
The HyperRAM controller in this repository is a complete rewrite from scratch, and is provided with a MIT license.
Learn more by reading the documentation in this repository or by browsing the companion website: https://mjoergen.github.io/HyperRAM/
This implementation has support for:
All the source files for the HyperRAM controller are in the src/hyperram directory, and all files needed for simulation are in the simulation directory.
Porting to another platform may require hand-tuning of some clock parameters, see the section on porting.
I'm testing this HyperRAM controller on the MEGA65
hardware platform (revision 3). It contains the 8 MB HyperRAM chip (link to
datasheet) from ISSI (Integrated Silicon
Solution Inc.). Specifically, the part number of the HyperRAM device on the
MEGA65 is IS66WVH8M8BLL-100B1LI
, which indicates a 64 Mbit, 100 MHz version
with 3.0 V supply and a single-ended clock.
I've written a complete Example Design to test the HyperRAM controller on this MEGA65 platform. The additional source files needed for this are placed in the src/Example_Design directory.
The HyperRAM controller has just two interfaces, one for the external HyperRAM device and one for the client (user) of the HyperRAM. For the client interface I've chosen the Avalon Memory Map protocol. This is an industry standard and is easy to use. The interface width is 16 bits corresponding to one word of the HyperRAM. The addressing is in units of words, not bytes.
The Avalon interface supports burst mode, where you can read or write multiple words in a single HyperRAM transaction. Section 3.5.5 in the Avalon Memory Map specification describes burst mode in detail.
To see an example of how to use the HyperRAM controller and how to connect it to the internal FPGA logic and to the external HyperRAM device, have a look at the Example_Design, specifically at the top level file and the trafic generator.
Make sure that you are aware of the necessity of Tri-State-Buffering. It is good design practice to infer the tri-state buffers from the top-level file.
The HyperRAM configuration and identification registers can be accessed through the same Avalon Memory Map interface via the following addresses:
0x80000000
: Identification Register 0 (Read-only)0x80000001
: Identification Register 1 (Read-only)0x80000800
: Configuration Register 0 (Read-write)0x80000801
: Configuration Register 1 (Read-write)Here is a brief summary of the signals involved in the Avalon Memory Map interface. For full details, refer to Section 3 of the specification. The HyperRAM controller uses "Pipelined Read Transfer with Variable Latency", see section 3.5.4 and Figure 12, and supports burst mode, see section 3.5.5. It does not use the "waitrequestAllowance" property.
Signal | Description |
---|---|
write |
Asserted by client for one clock cycle when writing data to the HyperRAM |
read |
Asserted by client for one clock cycle when reading data from the HyperRAM |
address |
Address (in units of 16-bit words) |
writedata |
Data to write |
byteenable |
1-bit for each byte of writedata to the HyperRAM |
burstcount |
Number of words to transfer |
readdata |
Data received from the HyperRAM |
readdatavalid |
Asserted when data from the HyperRAM is valid |
waitrequest |
Asserted by the device when it is busy |
The following links provide additional information: