Merge pull request #91 from zapta/main

Assorted tweaks

Author: zapta

CHANGELOG.md

@@ -6,15 +6,23 @@
   distinguish if a testbench is run by `apio sim` or `apio test` use the macro
   `APIO_SIM` which has the values `1` and `0` respectivly.
 
-- The values in the project file apio.ini can now contain pre-defined 
+- The values in the project file apio.ini can now contain pre-defined
   macros https://fpgawars.github.io/apio/docs/project-file/#value-macros .
 
 - Restructured the FPGAs definition file fpgas.jsonc. This requires users
   that custom FPGAs definition in their projects to adapt the format.
+  see `~/.apio/packages/definitions.fpgas.jsonc` for examples.
 
-- Fine tuned the parameters of Gowin build (e.g. add an optional `family` arg 
+- Fine-tuned the parameters of Gowin build (e.g. add an optional `family` arg 
   for the Gowin 20k FPGA).
 
+- Minor tweaks and refactoring of the commands tree for clarity.
+
+- Added to the `openFPGAloader` programmer definition the options `--force-terminal-mode`
+  and `--verify`. If you have in your project a custom `boards.jsonc` or `programmers.jsonc`
+  file, you may need to adjust them accordingly.
+
+
 ## [0.1.7]
 
 ### Changed

src/commands.js

@@ -203,7 +203,7 @@ const TOOLS_TREE = [
   },
 
   {
-    title: "boards",
+    title: "definitions",
     children: [
       {
         title: "list boards",
@@ -220,26 +220,39 @@ const TOOLS_TREE = [
     ],
   },
 
+  {
+    title: "devices",
+    children: [
+      {
+        title: "scan usb",
+        tooltip: "List USB devices",
+        id: "apio.devicesListUsb",
+        action: { cmds: ["{apio-bin} devices scan-usb"] },
+      },
+
+      {
+        title: "scan serial",
+        tooltip: "List serial devices",
+        id: "apio.devicesListSerial",
+        action: { cmds: ["{apio-bin} devices scan-serial"] },
+      },
+    ],
+  },
+
   {
     title: "drivers",
     children: [
       {
-        title: "FTDI",
+        title: "ftdi",
         children: [
           {
-            title: "list devices",
-            tooltip: "List USB devices",
-            id: "apio.devicesListUsb",
-            action: { cmds: ["{apio-bin} devices usb"] },
-          },
-          {
-            title: "install driver",
+            title: "install",
             tooltip: "Install FTDI driver for your board",
             id: "apio.driversInstallFtdi",
             action: { cmds: ["{apio-bin} drivers install ftdi"] },
           },
           {
-            title: "uninstall driver",
+            title: "uninstall",
             tooltip: "Uninstall the FTDI driver",
             id: "apio.driversUninstallFtdi",
             action: { cmds: ["{apio-bin} drivers uninstall ftdi"] },
@@ -250,19 +263,13 @@ const TOOLS_TREE = [
         title: "serial",
         children: [
           {
-            title: "list devices",
-            tooltip: "List serial devices",
-            id: "apio.devicesListSerial",
-            action: { cmds: ["{apio-bin} devices serial"] },
-          },
-          {
-            title: "install driver",
+            title: "install",
             tooltip: "Install serial driver for your board",
             id: "apio.driversInstallSerial",
             action: { cmds: ["{apio-bin} drivers install serial"] },
           },
           {
-            title: "uninstall driver",
+            title: "uninstall",
             tooltip: "Uninstall the serial driver",
             id: "apio.driversUninstallSerial",
             action: { cmds: ["{apio-bin} drivers uninstall serial"] },

src/constants.js

@@ -12,7 +12,7 @@ const APIO_CLI_RELEASE_REPO = "fpgawars/apio";
 // Release tag (YYYY-MM-DD) – matches git tag and PyPI version
 // Change ONLY this line when you publish a new daily build.
 //
-const APIO_CLI_RELEASE_TAG = "2026-03-24";
+const APIO_CLI_RELEASE_TAG = "2026-04-03";
 
 // Export for require()
 module.exports = {