v1.0.0

Author: openfpga-admin

README.md

@@ -0,0 +1,16 @@
+# Example: Basic Chip32
+This example demonstrates basic use of Chip32 to load a small descriptor file, parsing its header, and use it to make decisions about what images to load onto the screen.
+The display is split into 4 horizontal regions. One of three possible images can be loaded into each of the 4 regions. Additional error handling is present to prevent loading invalid data.
+The Chip32 program is smart enough to handle warm reloads, where it puts the core back into reset before loading new data, and takes it out of reset when complete. The bitstream is only loaded once on the first boot.
+
+* Chip32-assisted asset load
+* SDRAM controller
+* Video generation
+* Reload assets during runtime via the Core Settings menu
+
+
+
+## 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,37 @@
+{
+  "core": {
+    "magic": "APF_VER_1",
+    "metadata": {
+      "platform_ids": [
+        "ex_platform"
+      ],
+      "shortname": "Basic Chip32",
+      "description": "APF core example. Displays image strips loaded via Chip32.",
+      "author": "Example Author",
+      "url": "https://github.com/open-fpga",
+      "version": "1.0.0",
+      "date_release": "2022-09-29"
+    },
+    "framework": {
+      "target_product": "Analogue Pocket",
+      "version_required": "1.1",
+      "sleep_supported": false,
+      "chip32_vm": "example_chip32.bin",
+      "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,51 @@
+{
+  "data": {
+    "magic": "APF_VER_1",
+    "data_slots": [
+      {
+        "name": "Configuration",
+        "id": 1,
+        "required": true,
+        "parameters": 3,
+        "extensions": [
+          "dat"
+        ]
+      },
+      {
+        "name": "Audio",
+        "id": 99,
+        "required": true,
+        "parameters": 2,
+        "filename": "ex_audio_1.wav",
+        "extensions": [
+          "wav"
+        ],
+        "size_maximum": "0x3C00000",
+        "address": "0x00400000"
+      },
+      {
+        "name": "Image: Dots",
+        "id": "0x20",
+        "required": true,
+        "parameters": 2,
+        "filename": "ex_image_1.bin",
+        "address": "0x00000000"
+      },
+      {
+        "name": "Image: Grid",
+        "id": "0x21",
+        "required": true,
+        "parameters": 2,
+        "filename": "ex_image_2.bin",
+        "address": "0x12345678"
+      },
+      {
+        "name": "Image: 12 Colors",
+        "id": "0x22",
+        "required": true,
+        "parameters": 2,
+        "filename": "ex_image_3.bin"
+      }
+    ]
+  }
+}