diff --git a/docs/media/hardware/LED-driver-1-1-sch.pdf b/docs/media/hardware/LED-driver-1-1-sch.pdf deleted file mode 100644 index 2556515..0000000 Binary files a/docs/media/hardware/LED-driver-1-1-sch.pdf and /dev/null differ diff --git a/docs/media/hardware/audio-board.jpg b/docs/media/hardware/audio-board.jpg index 2e30515..6c5c67b 100644 Binary files a/docs/media/hardware/audio-board.jpg and b/docs/media/hardware/audio-board.jpg differ diff --git a/docs/media/hardware/breakout-1-2-back.jpg b/docs/media/hardware/breakout-1-2-back.jpg index 1a0fec5..15b18f8 100644 Binary files a/docs/media/hardware/breakout-1-2-back.jpg and b/docs/media/hardware/breakout-1-2-back.jpg differ diff --git a/docs/media/hardware/breakout-1-2-front.jpg b/docs/media/hardware/breakout-1-2-front.jpg index ae94d1b..209ff15 100644 Binary files a/docs/media/hardware/breakout-1-2-front.jpg and b/docs/media/hardware/breakout-1-2-front.jpg differ diff --git a/docs/media/hardware/poke-2-3-sch.pdf b/docs/media/hardware/poke-2-3-sch.pdf deleted file mode 100644 index 712386c..0000000 Binary files a/docs/media/hardware/poke-2-3-sch.pdf and /dev/null differ diff --git a/docs/user-guide/hardware.md b/docs/user-guide/hardware.md index a1f20ff..c7c1349 100644 --- a/docs/user-guide/hardware.md +++ b/docs/user-guide/hardware.md @@ -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. @@ -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) @@ -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**| |---|---| @@ -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) @@ -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) @@ -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) @@ -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) @@ -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) @@ -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) @@ -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) @@ -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) @@ -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)