diff --git a/source/Hardware Guide/Lighthouses/setup.rst b/source/Hardware Guide/Lighthouses/setup.rst index 176154dc..ba943608 100644 --- a/source/Hardware Guide/Lighthouses/setup.rst +++ b/source/Hardware Guide/Lighthouses/setup.rst @@ -3,14 +3,48 @@ 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 lighthouses should have the same orientation. + - The distance between the receiver and the transmitters should not exceed the maximum range. This depends + on the sensitivity of the receiver's photodiode on the headstage and is best determined experimentally. Each + base station has a 120° field of view. However, the photodiode has a larger chance of being obstructed from + the transmitter by parts on the headstage at larger angles. + - 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 `_ and + `inspecting the TS4231V1PositionData position data visualizer `_. + 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 `_. + + 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. @@ -19,7 +53,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 `_) diff --git a/source/_static/images/lighthouses/lighthouse-mount-example.png b/source/_static/images/lighthouses/lighthouse-mount-example.png new file mode 100644 index 00000000..a19425a9 Binary files /dev/null and b/source/_static/images/lighthouses/lighthouse-mount-example.png differ diff --git a/source/_static/images/lighthouses/lighthouse_active-range.svg b/source/_static/images/lighthouses/lighthouse_active-range.svg new file mode 100644 index 00000000..30cb4d12 --- /dev/null +++ b/source/_static/images/lighthouses/lighthouse_active-range.svg @@ -0,0 +1,2078 @@ + + + +Enable/Disable