+ +
+

Usage Warnings#

+
+

Warning

+

Improper setup and usage can cause damage to system components.

+
+
    +

  • Read the following warnings before starting to work with your system. These are crucial aspects to consider during setup and usage that are included in the documentation but are listed here for your convenience.

    • +

  • Read the complete documentation carefully to understand how the system works and refer back to these warnings before using it.

    • +
+
+

Hardware#

+
    +

  • Connecting or disconnecting the breakout board while the PC is on causes damage to the FMChost. More: Breakout Board Guide.

    +
    +
      +

    • Power off the PC before connecting/disconnecting the breakout board.

      • +
    +
    +
    • +

  • Headstage voltage must be configured correctly for operation. The voltage that works for one headstage can damage another, and depends on your hardware configuration such as tether length. More: Tethered Headstage Voltages.

    +
    +
      +

    • Ensure each headstage is configured with the correct voltage according to its specification before connecting and switching on the headstage port switch.

      • +
    +
    +
    • +
+
+
+

Software#

+

For the current Bonsai.ONIX library which is being revised to improve usability

+
    +

  • Headstage port voltage configuration is managed via the ONIContext node or the HeadstagePortControlDevice node. The changes you make using these nodes apply immediately and persist in hardware even if the Bonsai workflow is not running. Headstage port voltage is reset to the default 4.9V only on a power cycle (power off and on — not reboot).

    +
    +
      +

    • Keep the headstage port switches off until you have configured each port correctly.

      • +

    • Remember to set the headstage voltage to the desired value after a power cycle.

      • +
    +
    +
    • +

  • The ONIContext provides a dynamic window to read and write to hardware, but parameters such as device voltage are not saved in the node when the workflow is saved. The HeadstagePortControlDevice node also reads and writes to hardware, but parameters are saved with the workflow. On loading a workflow, Bonsai writes the parameter values set when the workflow was last saved.

    +
    +
      +

    • When you configure the voltage, the ONIContext node shows that value and when you save the workflow this value is not saved. Therefore, that value will not be set to hardware when you load the workflow again. On loading the workflow, the ONIContext node will be reading the voltage that is already set on the hardware and showing this in the LinkVoltage field.

      • +

    • When you configure the voltage, the HeadstagePortControlDevice node shows that value and when you save the workflow this value is saved. Therefore, that value will be set to hardware when you load the workflow again. If you make changes to the voltage value (with any node) and save the workflow, they will be saved in the LinkVoltage property of the HeadstagePortControlDevice node.

      • +
    +
    +
    • +

  • Any workflows containing the NeuropixelsV1eDevice node require the Neuropixels-1.0e Headstage to be connected before the workflows can be opened or loaded into Bonsai.

    +
    +
    +
    +
    • +

  • An ONIContext node or any device node in a workflow can override device settings in another workflow if device addresses are not distinct, because these nodes read/write directly to hardware.

    +
    +
      +

    • Only have one workflow open at a time.

      • +
    +
    +
    • +
+
+
+ + + +