Add v2.0 firmware to downloads (#103)

* Add v2.0 firmware to downloads

- Reorganize downloads page a bit
- Update oni-repl usage
- Update oni-repl release

* Fix broken ref

* Fix link to direct users to riffa installation instructions

The link was previously pointing users to a less relevant section.

---------

Co-authored-by: cjsha <[email protected]>

Author: jonnew

source/Hardware Guide/PCIe Host/setup-windows.rst

@@ -99,6 +99,8 @@ Windows does not ship with a C++ runtime. Before using ONIX on windows, you
 will need to install `Microsoft Visual C++ Redistributable for Visual Studio
 2015, 2017 and 2019 <https://download.visualstudio.microsoft.com/download/pr/453680ea-b88a-411f-80fd-5db37fdc9dbb/5D9999036F2B3A930F83B7FE3E2186B12E79AE7C007D538F52E3582E986A37C3/VC_redist.x64.exe>`__.
 
+.. _install_riffa:
+
 Install Device Driver
 ---------------------------------------
 

source/Resources/downloads.rst

@@ -23,84 +23,69 @@ Downloads
    * - :download:`1.0.0 <../_static/downloads/onix-software-releases/oni-repl-x64_v1.0.0.zip>`
      - 2022.11.27
      - Initial release.
+   * - :download:`1.1.0 <../_static/downloads/onix-software-releases/oni-repl-x64_v1.1.0.zip>`
+     - 2025.06.25
+     - Fixes to hardware reset behavior. Addition of several command line
+       switches and options in the REPL.
 
-.. _pcie_host_updater_download:
+.. _riffa_driver_download:
 
-PCIe Host Updater
+RIFFA Device Driver
 ----------------------------------------------
 
-.. note:: Please see :ref:`Updating PCIe Host Firmware
-    <pcie_host_firmware_update>` for instructions on how to use these files. When
+.. note:: Please see :ref:`Install Device Driver <install_riffa>` 
+    for instructions on how to use this file. When
     using mac or linux, you will need to compile from `source
-    <https://github.com/open-ephys/onix-gateware-field-updaters>`__.
+    <https://github.com/open-ephys/liboni>`__.
 
-.. list-table:: PCIe Host update tools
+.. list-table:: RIFFA PCIe driver
    :widths: 15 25 60
    :header-rows: 1
 
    * - Version
      - Release Date
      - Release Notes
-   * - :download:`1.0.0 <../_static/downloads/onix-software-releases/onix-pcie-host-flash-tools-x64_v1.0.0.zip>`
-     - 2022.11.27
-     - Initial release.
-
------------------
+   * - :download:`6.1.0.2 <../_static/downloads/onix-driver-releases/riffa/riffa-x64_v6.1.0.2.zip>`
+     - 2024.03.14
+     - Fix race condition in the RIFFA kernel driver for windows.
 
-.. _breakout_updater_download:
+.. _pcie_host_updater_download:
 
-Breakout Board Updater
+PCIe Host Firmware
 ----------------------------------------------
 
-.. note:: Please see :ref:`Updating Breakout Board Firmware
-    <breakout_firmware_update>` for instructions on how to use these files.
-
-.. list-table:: Breakout Board update tools
-   :widths: 15 25 60
-   :header-rows: 1
-
-   * - Version
-     - Release Date
-     - Release Notes
-   * - :download:`1.0.0 <../_static/downloads/onix-software-releases/tinyprog.zip>`
-     - 2024.07.05
-     - Initial release.
+.. note:: Please see :ref:`Updating PCIe Host Firmware
+   <pcie_host_firmware_update>` for instructions on how to use these files.
+   When using mac or linux, you will need to compile the Updater software from
+   `source <https://github.com/open-ephys/onix-gateware-field-updaters>`__.
 
------------------
+.. _pcie_host_image_download:
 
-.. _riffa_driver_download:
+PCIe Host Upload Tool
+______________________________________________
+Software for uploading bitfiles to hardware.
 
-RIFFA Device Driver
-----------------------------------------------
-
-.. note:: Please see :ref:`Updating PCIe Host Firmware
-    <pcie_host_firmware_update>` for instructions on how to use these files. When
-    using mac or linux, you will need to compile from `source
-    <https://github.com/open-ephys/liboni>`__.
-
-.. list-table:: RIFFA PCIe driver
+.. list-table:: PCIe Host upload tool
    :widths: 15 25 60
    :header-rows: 1
 
    * - Version
      - Release Date
      - Release Notes
-   * - :download:`6.1.0.2 <../_static/downloads/onix-driver-releases/riffa/riffa-x64_v6.1.0.2.zip>`
-     - 2024.03.14
-     - Fix race condition in the RIFFA kernel driver for windows.
+   * - :download:`1.0.0 <../_static/downloads/onix-software-releases/onix-pcie-host-flash-tools-x64_v1.0.0.zip>`
+     - 2022.11.27
+     - Initial release.
 
 -----------------
 
-.. _pcie_host_image_download:
-
-PCIe Host Firmware
-----------------------------------------------
-.. note:: Please see :ref:`Updating PCIe Host Firmware
-    <pcie_host_firmware_update>` for instructions on how to use these files.
+PCIe Controller Bitfiles
+______________________________________________
 
 .. warning::
-      Make sure that the host firmware image you download matches the PCIe Host Hardware version you have
-      as shown in the table below. An incorrect firmware version will not report any error while updating but will cause failures during operation.
+   Make sure that the host firmware image you download matches the PCIe Host
+   Hardware version you have as shown in the table below. An incorrect firmware
+   version will not report any error while updating but will cause failures
+   during operation.
 
 .. table::
     :widths: 50 50
@@ -111,34 +96,61 @@ PCIe Host Firmware
     +=======================================================+=============================================================================================================+
     | Hardware Revision 1.4                                 | Deprecated. Please :ref:`get in touch <support>` so we can assist you.                                      |
     +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+
-    | Hardware Revision 1.5                                 | :download:`Firmware version 1.1D <../_static/downloads/onix-gateware-images/onix-host-v1.1-update-revD.bin>`|
+    | Hardware Revision 1.5                                 | :download:`Firmware version 2.0D <../_static/downloads/onix-gateware-images/onix-host-v2.0-update-revD.bin>`|
     +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+
-    | Hardware Revision 1.6                                 | :download:`Firmware version 1.1F <../_static/downloads/onix-gateware-images/onix-host-v1.1-update-revF.bin>`|
+    | Hardware Revision 1.6                                 | :download:`Firmware version 2.0F <../_static/downloads/onix-gateware-images/onix-host-v2.0-update-revF.bin>`|
     +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------+
 
 
 .. .. list-table:: PCIe Host Revision 1.4 firmware images
 ..    :widths: 15 25 60
 ..    :header-rows: 1
-.. 
+..
 ..    * - Version
 ..      - Release Date
 ..      - Release Notes
 ..    * - :download:`0.6 <./_static/downloads/onix-gateware-images/pcie-host-1r4/onix-pcie-host-1r4_v0.6.bin>`
 ..      - 2022.11.27
 ..      - Remove unnecessary breakout board PLL reset during context initialization which could cause LEDs to turn off.
- 
 
-.. _breakout_image_download:
 
 Breakout Board Firmware
 ----------------------------------------------
-.. note:: Please see :ref:`Updating Breakout Board Firmware
-    <breakout_firmware_update>` for instructions on how to use these files.
+
+.. note:: Please see :ref:`Updating Breakout Board Firmware <breakout_firmware_update>`
+    for instructions on how to use these files. When
+    using mac or linux, you will need to compile from `source
+    <https://github.com/open-ephys/onix-gateware-field-updaters>`__.
+
+.. _breakout_updater_download:
+
+Breakout Board Upload Software
+______________________________________________
+Software for uploading bitfiles to hardware.
+
+.. list-table:: Breakout Board firmware upload tool
+   :widths: 15 25 60
+   :header-rows: 1
+
+   * - Version
+     - Release Date
+     - Release Notes
+   * - :download:`1.0.0 <../_static/downloads/onix-software-releases/tinyprog.zip>`
+     - 2024.07.05
+     - Initial release.
+
+-----------------
+
+.. _breakout_image_download:
+
+Breakout Board Bitfiles
+______________________________________________
 
 .. warning::
-      Make sure that the breakout board firmware image you download matches the breakout board hardware version you have
-      as shown in the table below. An incorrect firmware version will not report any error while updating but will cause failures during operation.
+   Make sure that the breakout board firmware image you download matches the
+   breakout board hardware version you have as shown in the table below. An
+   incorrect firmware version will not report any error while updating but will
+   cause failures during operation.
 
 .. table::
     :widths: 50 50

source/Software Guide/oni-repl/usage.rst

@@ -5,8 +5,9 @@
 
 .. code-block:: console
 
-    oni-repl <driver> [slot] [-d] [-D <value>] [-n <value>] [-i <device index>]
-    [--rbytes=<bytes>] [--wbytes=<bytes>] [--dumppath=<path>] [-h,--help] [-v,--version]
+    oni-repl <driver> [slot] [-q] [-d] [-D <value>] [-n <value>] [-i <device
+    index>] [--rbytes=<bytes>] [--wbytes=<bytes>] [--dformat=<hex,dec>]
+    [--dumppath=<path>] [--regpath=<path>] [-h,--help] [-v,--version]
 
 Required Arguments
 -----------------------------------
@@ -19,12 +20,14 @@ Required Arguments
 
 Command Line Options
 -----------------------------------
+-q          Quit after intialization. If specified, quit before entering repl but after after establishing a connection with hardware, obtaining the device table, and writing to registers specified in --regpath.
 -d 			Display frames. If specified, frames produced by the oni hardware will be printed to the console.
 -D <percent> 		The percent of frames printed to the console if frames are displayed. Percent should be a value in (0, 100.0].
 -n <count> 		Display at most count frames. Reset only on program restart. Useful for examining the start of the data stream.
 -i <index> 		Only display frames from device with specified index value.
 --rbytes=<bytes>   Set block read size in bytes. This number determines the latency/bandwidth tradeoff. Large block read sizes will reuslt in less frequent data transfers from hardware that can increase overall streaming bandwith of the system. This number imposes a lower bound on real-time latency since the system will need to accumulate the entire read block before data is transmitted.
 --wbytes=<bytes>   Set write preallocation size in bytes. This number indicates the amount of memory is reserved for use by the write stream. Tuning my improve real-time performance depending on write frequency.
+--dformat=<hex,dec>     Set the format of frame data printed to the console to hexidecimal (default) or decimal.
 --dumppath=<path> 	Path to folder to dump raw device data. If not defined, no data will be written. A flat binary file with name <index>_idx-<id>_id-<datetime>.raw will be created for each device in the device table that produces streaming data. The bit-wise frame definition in the ONI device datasheet (as required by the ONI spec) will describe frame data is organized in each file.
 --regpath=<path>   Path to a text file containing a table of the form: