v1.0

Author: openfpga-admin

README.md

@@ -0,0 +1,14 @@
+# Example: Basic Assets 
+This example demonstrates loading and displaying a static image and audio from selectable asset files out of RAM. A square is drawn over the top of the image, which can be controlled with user input.
+* SDRAM controller
+* Video generation
+* I2S audio generation
+* User input (DPAD = move square, B = green square, A = pink square, X = replay audio)
+* Reload assets during runtime via the Core Settings menu
+* Core menu signaling (box moves while OS menu is active)
+
+
+## Legal
+Analogue’s Development program was created to further video game hardware preservation with FPGA technology. Analogue does not support or endorse the use of infringing content.
+
+Analogue Developers have access to Analogue Pocket I/O’s so Developers can utilize cartridge adapters or interface with other pieces of original or bespoke hardware to support legacy media.

audio.json

@@ -0,0 +1,5 @@
+{
+  "audio": {
+    "magic": "APF_VER_1" 
+  }
+}

core.json

@@ -0,0 +1,36 @@
+{
+    "core": {
+        "magic": "APF_VER_1",
+        "metadata": {
+            "platform_ids": [
+                "ex_platform"
+            ],
+            "shortname": "Basic Assets",
+            "description": "APF core example. Displays image and plays audio.",
+            "author": "Example Author",
+            "url": "https://github.com/open-fpga",
+            "version": "1.0.0",
+            "date_release": "2022-08-23"
+        },
+        "framework": {
+            "target_product": "Analogue Pocket",
+            "version_required": "1.1",
+            "sleep_supported": false,
+            "dock": {
+                "supported": true,
+                "analog_output": false
+            },
+            "hardware": {
+                "link_port": false,
+                "cartridge_adapter": -1
+            }
+        },
+        "cores": [
+            {
+                "name": "default",
+                "id": 0,
+                "filename": "bitstream.rbf_r"
+            }
+        ]
+    }
+}

data.json

@@ -0,0 +1,30 @@
+{
+    "data": {
+        "magic": "APF_VER_1",
+        "data_slots": [
+            {
+                "name": "Background",
+                "id": 1,
+                "required": true,
+                "parameters": 3,
+                "extensions": [
+					"bin"
+                ],
+                "size_exact": 184320,
+                "address": "0x00000000"
+            },
+			{
+                "name": "Audio",
+                "id": 99,
+                "required": true,
+                "parameters": 3,
+                "extensions": [
+                    "wav"
+                ],
+                "size_exact": 0,
+                "size_maximum": "0x3C00000",
+                "address": "0x00400000"
+            }
+        ]
+    }
+}

dist/.gitkeep

@@ -0,0 +1,8 @@
+{
+  "platform": {
+    "category": "Example Cores",
+    "name": "Example Platform",
+    "year": 2022,
+    "manufacturer": "Example Manufacturer"
+  }
+}

dist/assets/.keep

@@ -0,0 +1,10 @@
+Example Core - Basic Assets
+
+This example demonstrates loading and displaying a static image and audio from selectable asset files out of RAM. A square is drawn over the top of the image, which can be controlled with user input.
+
+* SDRAM controller
+* Video generation
+* I2S audio generation
+* User input displayed in Controls menu
+* Reload assets during runtime via the Core Settings menu
+* Core menu signaling (box moves while OS menu is active)

dist/assets/ex_audio_1.wav

@@ -0,0 +1,27 @@
+{
+    "input": {
+        "magic": "APF_VER_1",
+        "controllers": [
+            {
+                "type": "default",
+                "mappings": [
+                    {
+                        "id": 0,
+                        "name": "Purple Square",
+                        "key": "pad_btn_a"
+                    },
+                    {
+                        "id": 1,
+                        "name": "Green Square",
+                        "key": "pad_btn_b"
+                    },
+                    {
+                        "id": 2,
+                        "name": "Replay Audio",
+                        "key": "pad_btn_x"
+                    }
+                ]
+            }
+        ]
+    }
+}

dist/assets/ex_audio_2.wav

@@ -0,0 +1,18 @@
+{
+    "interact": {
+        "magic": "APF_VER_1",
+        "variables": [
+            {
+                "name": "Screen Border",
+                "id": 1,
+                "type": "check",
+                "enabled": true,
+                "persist": true,
+                "address": "0x50000000",
+                "defaultval": 1,
+                "value": 1,
+                "mask": "0xFFFF0000"
+            }
+        ]
+    }
+}

dist/assets/ex_image_1.bin

@@ -0,0 +1,28 @@
+*/db/
+*/incremental_db/
+*/simulation/
+*/greybox_tmp/
+incremental_db/
+db/
+PLLJ_PLLSPE_INFO.txt
+c5_pin_model_dump.txt
+cr_ie_info.json
+*.pin
+*.pof
+*.ptf.*
+*.qar
+*.qarlog
+*.qws
+*.rpt
+*.smsg
+*.sof
+*.sopc_builder
+*.summary
+*.txt
+*.bak
+*.cmp
+*.done
+*.xml
+*.sld
+*.cdf
+

dist/assets/ex_image_2.bin

@@ -0,0 +1,31 @@
+# -------------------------------------------------------------------------- #
+#
+# Copyright (C) 2019  Intel Corporation. All rights reserved.
+# Your use of Intel Corporation's design tools, logic functions 
+# and other software and tools, and any partner logic 
+# functions, and any output files from any of the foregoing 
+# (including device programming or simulation files), and any 
+# associated documentation or information are expressly subject 
+# to the terms and conditions of the Intel Program License 
+# Subscription Agreement, the Intel Quartus Prime License Agreement,
+# the Intel FPGA IP License Agreement, or other applicable license
+# agreement, including, without limitation, that your use is for
+# the sole purpose of programming logic devices manufactured by
+# Intel and sold by Intel or its authorized distributors.  Please
+# refer to the applicable agreement for further details, at
+# https://fpgasoftware.intel.com/eula.
+#
+# -------------------------------------------------------------------------- #
+#
+# Quartus Prime
+# Version 18.1.1 Build 646 04/11/2019 SJ Lite Edition
+# Date created = 21:31:36  January 22, 2020
+#
+# -------------------------------------------------------------------------- #
+
+QUARTUS_VERSION = "18.1"
+DATE = "21:31:36  January 22, 2020"
+
+# Revisions
+
+PROJECT_REVISION = "ap_core"