- Intel Quartus Lite with device support for Cyclone V
- Text editor for creating JSON files
- Dock and DAC are optional
- Intel Approved USB or Ethernet Blaster JTAG cable
- Intel/Altera or Terasic versions of this tool are supported. Clone tools are not suggested and may have unexpected behavior and/or cause hardware damage.
- Torx T-6 screwdriver for removing the rear cover to access the JTAG header
- Not required on Pocket Developer Edition, which have a removable door on the rear cover.
- Micro SD card
- Up to 1TB
- FAT32 or exFAT supported
- Analogue Developer Key (optional)
- For additional debugging features via the cartridge bus
Get the Core Template
To get started quickly Analogue provides a core template with the appropriate JSON files and a sample core. You can download the core template here.
Design and Compile the Core
To begin, open the core template in your text editor of choice.
Configure your core by editing your JSON files as needed. For details view the Documentation for JSON files.
Develop and compile your core with Quartus.
Debug the Core on Pocket
To debug your core on Pocket it is necessary to package the core for development and involves a few simple steps:
- Transfer your JSON files to the SD Card.
- Copy any core assets to the SD Card.
- Transfer the core binary files to the SD Card.
Place the files on an SD Card using USB-Link mode or a computer. For additional details please view Packaging A Core.
After populating your SD Card you will need to connect your computer to Pocket via JTAG located along the bottom edge. Depending on your model, this may require removing the rear cover with a T6 screwdriver.
Left: The four screw locations for removing the rear cover
Right: JTAG pin 01 location
Do not remove the battery or disassemble Pocket.
Only use Intel approved JTAG devices or cables to avoid damage. Observe ESD precautions handling static-sensitive devices when accessing the JTAG.
Reloading the FPGA bitstream
After a core is running the developer can at any time reload the FPGA bitstream over JTAG. Pocket will automatically re-initialize the core with the exact same starting conditions. Any previously selected assets will be remembered and reloaded. All other stateful data is not transferred between reloads. JSON files will be reinitialized reflecting any changes made between reloads.
USB Link Mode
Developers can optionally mount the SD card via the USB-C connection on Pocket. This is a convenient feature for iteration workflows such as quickly adjusting JSON files or replacing binary files. Transfer speeds are limited to < 1MBps and large file transfers are not recommended. This feature can be accessed in the Tools > Developer section of Analogue OS.
Packaging Your Core
For additional details please view Packaging A Core.
Steps for Packaging
- Copy the template project JSON to your
- Append the version number and release timestamp to
- Update any other metadata such as author, shortname, URL, etc.
- Reverse the bitstream
- Convert the compiled FPGA bitstream format for Pocket and copy it into your core folder
- For details view the Creating a reversed RBF.
- Add the relevant folders to a
Specify Version Number and Date Released
Each core should be packaged with a version number. We encourage versioning to follow SemVer. When a core is packaged check that
core.json value is updated along with the
Best Practices for Packaging
- Name your packaged
.zipthe same as
- View the core_squares release example.