Skip to content

Add guidelines about lighthouse base station mounting configuration #109

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 35 additions & 2 deletions source/Hardware Guide/Lighthouses/setup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,45 @@
Setup
#########################

1. Mount 2 Vive Base Station Lighthouses over the setup.
1. Mount 2 Vive Base Station Lighthouse over the setup.

.. image:: ../../_static/images/lighthouses/vive_front.jpg
:width: 48 %
.. image:: ../../_static/images/lighthouses/vive_front.jpg
:width: 48 %

Follow these guidelines to decide where to mount your two Lighthouse base stations:

- They should be centered above and facing the area that will be occupied by the lighthouse receivers.
- The distance between the receiver and the transmitters should not exceed 3 meters. Each base station
has a 120° field of view. However, position measurements are noisier when receivers are at the boundary
of the transmitters' range, so leave a safe margin. A receiver must be in range of both transmitters
in order to measure position.
- Secure the base stations such that they can't be easily jostled or moved.

.. tip::
To confirm if the base station configuration covers the entire desired range, slowly move
the TS4231 device through the entire desired range while running
`an example workflow <https://open-ephys.github.io/bonsai-onix1-docs/articles/hardware/hs64/workflow.html>`_ and
`inspecting the TS4231V1PositionData position data visualizer <https://open-ephys.github.io/bonsai-onix1-docs/articles/getting-started/visualize-data.html>`_.
If the TS4231V1PositionData operator ceases to produce data (i.e. if the visualizer stops updating)
at a certain spot, the current base station configuration does not cover that spot. If you are unfamiliar with
using Bonsai to acquire Onix data to do this, visit the OpenEphys.Onix1 Bonsai package
`Getting Started page <https://open-ephys.github.io/bonsai-onix1-docs/articles/getting-started/index.html>`_.


The image below shows a cartoon of what a lighthouse setup might look with a commutator as well mounted
on extruded aluminum rail. The overlapping green area represents the region where a TS4231 device is in
range of both base stations and can measure position.

.. image:: ../../_static/images/lighthouses/lighthouse_active-range.svg

The image below shows an photo of how the actual mounting hardware looks for mounting on extruded aluminum rail.

.. image:: ../../_static/images/lighthouses/lighthouse-mount-example.png

2. Connect one power adaptor to each base station.

3. Using an audio to audio cable, connect the basestations to each other to
synchronise them.

Expand All @@ -19,7 +50,9 @@ Setup
.. image:: ../../_static/images/lighthouses/vive_back.jpg
:width: 48%

4. Set one base station to 'A' and one to 'b' using the channel button
4. Manage the cables such that they don't occlude the TS4231 receivers from the Lighthouse base station transmitters.

5. Set one base station to 'A' and one to 'b' using the channel button
(illustration below is from the `Vive manual
<https://www.vive.com/eu/support/vive/category_howto/about-the-base-stations.html>`_)

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading