Skip to content

Commit

Permalink
Updated hardware docs for new Github hardware repository.
Browse files Browse the repository at this point in the history
  • Loading branch information
ThomasAkam committed Jul 10, 2019
1 parent 444744c commit 22a9c25
Show file tree
Hide file tree
Showing 6 changed files with 14 additions and 12 deletions.
Binary file removed docs/media/hardware/LED-driver-1-1-sch.pdf
Binary file not shown.
Binary file modified docs/media/hardware/audio-board.jpg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/hardware/breakout-1-2-back.jpg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/hardware/breakout-1-2-front.jpg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/media/hardware/poke-2-3-sch.pdf
Binary file not shown.
26 changes: 14 additions & 12 deletions docs/user-guide/hardware.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

A typical pyControl hardware setup consists of one or more breakout boards connected to a computer by USB, each of which runs a single behavioural setup. The breakout board connects to a set of devices such as nosepokes, audio boards and LED drivers which make up the setup. USB hubs can be used between the computer and breakout boards such that many setups can be controlled from a single computer.

All pyControl hardware is open source and design files for the hardware detailed below are available in the [pyControl hardware repository](https://bitbucket.org/takam/pycontrol_hardware). The repository also has a list of [useful parts](https://bitbucket.org/takam/pycontrol_hardware/src/default/useful-parts-list.md) such as cables, solenoids, mounting hardware etc for building setups. Assembled pyControl hardware is available from the [OpenEphys store](http://www.open-ephys.org/store).
All pyControl hardware is open source and design files for the hardware detailed below are available in the [pyControl hardware repository](https://github.com/ThomasAkam/pyControl_hardware). The repository also has a list of [useful parts](https://github.com/ThomasAkam/pyControl_hardware/blob/master/useful-parts-list.md) such as cables, solenoids, mounting hardware etc for building setups. Assembled pyControl hardware is available from the [OpenEphys store](http://www.open-ephys.org/store).

For information about synchronising pyControl with other hardware such as electrophysiology or video cameras see the [synchronisation](synchronisation.md) user guide.

Expand Down Expand Up @@ -249,7 +249,9 @@ sync_input = Digital_input(pin=board.port_5.DIO_B, rising_event='sync_pulse')

The current version 1.2 of the pyControl Breakout board has 6 RJ45 behaviour ports, 4 BNC connectors, indicator LEDs and user pushbutton. Ports 1 & 2 have an additional driver line *POW_C*. Ports 3 and 4 have an additional DIO line *DIO_C* which also supports analog output (DAC). Ports 3 and 4 support I2C and ports 1,3 & 4 support UART serial communication over their DIO lines.

[Schematic (pdf)](../media/hardware/breakout-1-2-sch.pdf)                  [Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Breakout/)
[Schematic (pdf)](../media/hardware/breakout-1-2-sch.pdf)

[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Breakout_board)

**Front:**
![Breakout 1.2 front](../media/hardware/breakout-1-2-front.jpg)
Expand Down Expand Up @@ -299,7 +301,7 @@ The following Python classes define devices which plug into behaviour ports.

Nosepoke port with infra-red beam, stimulus LED and socket to connect solenoid valve.

[Schematic (pdf)](../media/hardware/poke-2-3-sch.pdf)                  [Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Poke/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Nose_poke)

|**Front**|**Side - solenoid attached**|
|---|---|
Expand Down Expand Up @@ -351,7 +353,7 @@ left_poke.SOL.off() # Turn off the solenoid.

Audio amplifier board for driving a speaker to produce auditory stimuli. The board uses the micropython [DAC](https://docs.micropython.org/en/latest/pyboard/library/pyb.DAC.html) for stimulus generation. The audio board must be plugged into a port on the breakout board which supports DAC output and I2C serial communication (used to set the volume) - ports 3 and 4 on breakout board 1.2 are suitable.

[Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Audio_board/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Audio_board)

![Audio board](../media/hardware/audio-board.jpg)

Expand Down Expand Up @@ -413,7 +415,7 @@ speaker.off() # Turn off sound output.

A constant current LED driver for optogenetic stimulation.

[Schematic (pdf)](../media/hardware/LED-driver-1-1-sch.pdf)                  [Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/LED_driver/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/LED_driver)

![LED driver](../media/hardware/LED-driver.jpg)

Expand Down Expand Up @@ -455,7 +457,7 @@ The stepper motor adaptor board connects an Easydriver to a pyControl behaviour
> The stepper motor driver can draw power either from the 12V line on the behaviour port or from a 12V power supply connected to the stepper motor board using the 2.1mm barrel plug. The maximum current that can safely be drawn from the behaviour port is 0.6A (the maximum rated current per conductor on Cat5 network cables). If your stepper motor requires more current, connect a 12V power supply directly to the stepper motor driver. The current requirements for some common stepper motors are detailed in the EasyDriver documentation.


[Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Stepper_driver/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Stepper_driver)

![Stepper driver](../media/hardware/stepper_driver.jpg)

Expand Down Expand Up @@ -496,7 +498,7 @@ The rotary encoder adaptor board connects an Avago HEDM-55xx series rotary encod

For an example task using a rotary encoder to measure running speed and trigger framework events when running starts and stops see [*running_wheel*](https://bitbucket.org/takam/pycontrol/src/default/tasks/running_wheel.py).

[Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Rotary_encoder/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Rotary_encoder)

![Stepper driver](../media/hardware/rotary_encoder.jpg)

Expand Down Expand Up @@ -576,7 +578,7 @@ Each port on the port expander works like a standard behaviour port, with 2 DIO

**Required driver files:** *_port_expander.py*, *_MCP.py*

[Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Port_expander/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Port_expander)

![Stepper driver](../media/hardware/port_expander_photo.jpg)

Expand Down Expand Up @@ -605,7 +607,7 @@ The Five Poke board is a set of five nose pokes on a single PCB, each with an IR

**Required driver files:** *_five_poke.py*

[Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Five_poke/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Five_poke)

**Five poke mounted**
![Five_poke mounted](../media/hardware/five-poke-mounted.jpg)
Expand Down Expand Up @@ -644,7 +646,7 @@ An optional solenoid driver daughter board can be connected to the nine poke boa

**Required driver files:** *_nine_poke.py*, *_MCP.py*

[Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Nine_poke/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Nine_poke)

**Nine poke PCB**
![Nine_poke pcb](../media/hardware/nine-poke-pcb.jpg)
Expand Down Expand Up @@ -692,7 +694,7 @@ An electrical lickometer board which has two lick detection circuits and two sol

**Required driver files:** *_lickometer.py*

[Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Lickometer/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Lickometer)

![Five_poke mounted](../media/hardware/lickometer_photo.jpg)

Expand Down Expand Up @@ -739,7 +741,7 @@ An audio board which uses the [DFPlayer](https://www.dfrobot.com/wiki/index.php/

**Required driver files:** *_audio_player.py*

[Repository](https://bitbucket.org/takam/pycontrol_hardware/src/default/Audio_player/)
[Repository](https://github.com/ThomasAkam/pyControl_hardware/tree/master/Audio_player)

![Audio board](../media/hardware/audio-player.jpg)

Expand Down

0 comments on commit 22a9c25

Please sign in to comment.