diff --git a/hardware/bioamp/bioamp-exg-pill/index.rst b/hardware/bioamp/bioamp-exg-pill/index.rst index c0a57755..8c77622c 100644 --- a/hardware/bioamp/bioamp-exg-pill/index.rst +++ b/hardware/bioamp/bioamp-exg-pill/index.rst @@ -63,7 +63,7 @@ BioAmp EXG Pill’s elegant design allows it to be used in 3 ways: :align: center BioAmp EXG Pill is fully configurable -=============================== +============================================= 1. Increase the gain of the instrumentation amplifier by using a 0603 resistor at ``R6``. Decrease gain and configure the bandpass filter by using 0603 parts at ``R12`` and ``C5``. Band limiting is very useful for EOG and EEG recording. Also, the signal sometimes clips while recording an ECG with electrodes very close to the heart. Creating a solder jumper for a band-pass filter helps with that. By default, BioAmp EXG Pill is configured to record EEG and EOG but you can bridge the pads (below bandpass) with solder to make it configurable for EMG and ECG. 2. The normal method of operation for best-quality signal amplification is to use 3 electrodes by default but you can bridge the pads (below electrodes) to make it configurable for 2 electrodes. The 2-electrode mode is specifically included for projects like heart (ECG) patches for HRV. It’s only supposed to be used with a battery-operated setup and is quite prone to high interference noise due to a lack of proper reference on the body (This option is not recommended for most operations) @@ -75,7 +75,7 @@ Software requirements .. image:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.* -- Download Backyard Brains' `Spike Recorder https://backyardbrains.com/products/spikerecorder`_ according to the operating system you are using (Windows, OSX, Linux). +- Download Backyard Brains' `Spike Recorder `_ according to the operating system you are using (Windows, OSX, Linux). .. image:: ../../../kits/diy-neuroscience/basic/media/byb.* diff --git a/hardware/bioamp/muscle-bioamp-patchy/index.rst b/hardware/bioamp/muscle-bioamp-patchy/index.rst index e84be2f1..126e6fc9 100644 --- a/hardware/bioamp/muscle-bioamp-patchy/index.rst +++ b/hardware/bioamp/muscle-bioamp-patchy/index.rst @@ -3,6 +3,8 @@ Muscle BioAmp Patchy ##################### +:bdg-danger:`v0.2` + Overview ********** diff --git a/hardware/bioamp/muscle-bioamp-shield/index.rst b/hardware/bioamp/muscle-bioamp-shield/index.rst index bdf1432f..e12776f0 100644 --- a/hardware/bioamp/muscle-bioamp-shield/index.rst +++ b/hardware/bioamp/muscle-bioamp-shield/index.rst @@ -3,6 +3,8 @@ Muscle BioAmp Shield ###################### +:bdg-danger:`v0.3` + Overview ********** @@ -90,7 +92,17 @@ Images below shows a quick overview of the hardware design. Contents of the kit ******************** -.. todo:: contents photo +There are 2 variants available for Muscle BioAmp Shield v0.3 kit - one comes with the shield assembled and the other one contains bare PCB of the sensor and the components separately which you can assemble pretty easily. + +.. figure:: media/kit-contents-assembled.* + :align: center + + Assembled Muscle BioAmp Shield kit content + +.. figure:: media/kit-contents-unassembled.* + :align: center + + Unassembled Muscle BioAmp Shield kit content .. youtube:: w8yw12SUe6Q :width: 100% @@ -274,11 +286,31 @@ Step 1: Stack on Arduino Uno Stack the Muscle BioAmp Shield on top of Arduino Uno properly. +.. only:: html + + .. figure:: media/gifs/shield-arduino-connection.gif + :align: center + +.. only:: latex + + .. figure:: media/images/shield-arduino-connection.* + :align: center + Step 2: Connecting Electrode Cable ======================================= Connect the BioAmp Cable to Muscle BioAmp Shield as shown. +.. only:: html + + .. figure:: media/gifs/electrode-cable-connection.gif + :align: center + +.. only:: latex + + .. figure:: media/images/electrode-cable-connection.* + :align: center + Step 3: Skin Preparation ============================= @@ -298,6 +330,19 @@ Using gel electrodes 2. Peel the plastic backing from electrodes 3. Place the IN+ and IN- cables on the arm near the ulnar nerve & REF (reference) at the back of your hand as shown in the connection diagram. +.. only:: html + + .. figure:: media/gifs/electrode-placement.gif + :align: center + +.. only:: latex + + .. figure:: media/images/electrode-placement-1.* + :align: center + + .. figure:: media/images/electrode-placement-2.* + :align: center + Using Muscle BioAmp Band --------------------------- @@ -316,7 +361,20 @@ Step 5: Connect Arduino UNO to your laptop ============================================= Connect your Arduino UNO R3 to your laptop using the USB cable (Type A to Type B). + +.. only:: html + + .. figure:: media/gifs/arduino-laptop-connection.gif + :align: center +.. only:: latex + + .. figure:: media/images/arduino-laptop-connection-1.* + :align: center + + .. figure:: media/images/arduino-laptop-connection-2.* + :align: center + .. warning:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. Step 6: Visualise EMG signals on laptop @@ -338,20 +396,34 @@ After opening the serial plotter make sure to select the baud rate to 115200. Now flex your arm to visualize the muscle signals in real time on your laptop. +.. only:: html + + .. figure:: media/gifs/visualise-emg.gif + :align: center + +.. only:: latex + + .. figure:: media/images/visualise-emg.* + :align: center + Step 7: Visualise EMG signals on LEDs ========================================== Copy paste the Arduino Sketch given below in Arduino IDE: - LED Bar Graph: https://github.com/upsidedownlabs/BioAmp-EXG-Pill/blob/main/software/LEDBarGraph/LEDBarGraph.ino + LED Bar Graph: https://github.com/upsidedownlabs/BioAmp-EXG-Pill/blob/main/software/LEDBarGraph/LEDBarGraph.ino Make sure you have selected the right board and COM port. Now upload the code, and flex your arm. You'll see the LED bar going up. More strength you apply, more the LED bar goes up. .. only:: html - .. figure:: media/LEDGraph.gif + .. figure:: media/gifs/led-graph.gif + :align: center -.. todo:: Add PNG/JPEG image for latex build +.. only:: latex + + .. figure:: media/images/led-graph.* + :align: center Step 8: Listen to your EMG signals ==================================== @@ -365,7 +437,15 @@ Listening EMG on speakers 2. Switch on the speaker and turn the volume to maximum. 3. Flex and listen to your muscles. +.. only:: html + + .. figure:: media/gifs/listening-emg-speakers.gif + :align: center +.. only:: latex + + .. figure:: media/images/listening-emg-speakers.* + :align: center Listening EMG on a wired earphones/headphones ---------------------------------------------- @@ -376,11 +456,31 @@ Listening EMG on a wired earphones/headphones .. only:: html - .. figure:: media/listening-muscle-signals.gif + .. figure:: media/gifs/listening-emg-earphones.gif + :align: center + +.. only:: latex + + .. figure:: media/images/listening-emg-earphones.* + :align: center -.. todo:: Add PNG/JPEG image for latex build +Step 9: Controlling a servo motor +=================================== -Step 9: Controlling a servo claw +Connect the servo claw to Muscle BioAmp Shield. + +Copy paste the Arduino Sketch given below in Arduino IDE: + + Servo Controller: https://github.com/upsidedownlabs/Muscle-BioAmp-Arduino-Firmware/blob/main/5_ServoControl/5_ServoControl.ino + +Make sure you have selected the right board and COM port. Now upload the code, and flex your arm to control the servo claw in real time. + +.. only:: html + + .. figure:: media/gifs/servo-control.gif + :align: center + +Step 10: Controlling a servo claw ==================================== Connect the servo claw to Muscle BioAmp Shield. @@ -392,12 +492,16 @@ Copy paste the Arduino Sketch given below in Arduino IDE: Make sure you have selected the right board and COM port. Now upload the code, and flex your arm to control the servo claw in real time. .. only:: html + + .. figure:: media/gifs/claw-control.gif + :align: center - .. figure:: media/servo-control.gif +.. only:: latex -.. todo:: Add PNG/JPEG image for latex build + .. figure:: media/images/claw-control.* + :align: center -Step 10: Connecting 9V battery +Step 11: Connecting 9V battery ==================================== Till now, the power for the EMG system was coming from the laptop via USB cable of Arduino Uno but there can be 2 ways in which you can make the system portable: @@ -407,13 +511,12 @@ Till now, the power for the EMG system was coming from the laptop via USB cable .. only:: html - .. figure:: media/9v-battery.gif - -.. todo:: Add PNG/JPEG image for latex build + .. figure:: media/gifs/9v-battery.gif + :align: center .. note:: Do not use 9V battery while controlling a servo claw using Muscle BioAmp Shield. Instead connect the Arduino UNO to a power bank or directly to your laptop. -Step 10: Other functionalities you can explore +Step 12: Other functionalities you can explore ==================================================== Using I2C ports @@ -421,7 +524,7 @@ Using I2C ports There are 2 I2C ports available on Muscle BioAmp Shield and you can connect hundreds of devices having I2C compatibility using the 4-pin JST PH 2.0 mm STEMMA cables provided. -Some of the examples are: ``OLED screens``, ``character displays``, ``temperature sensors``, ``accelerometers``, ``gyroscopes``, ``light sensors``, ``BioAmp Hardware`` +Some of the examples are: ``OLED screens``, ``character displays``, ``temperature sensors``, ``accelerometers``, ``gyroscopes``, ``light sensors``, ``BioAmp Hardware``. Using STEMMA Digital port --------------------------- @@ -436,7 +539,4 @@ Connect Arduino Uno's A2 analog input pins using STEMMA analog connectors. Using user buttons --------------------- -Program the 2 user buttons according to your project requirements. - -Using Isolated output ------------------------ \ No newline at end of file +Program the 2 user buttons according to your project requirements. \ No newline at end of file diff --git a/hardware/bioamp/muscle-bioamp-shield/media/Claw control.gif b/hardware/bioamp/muscle-bioamp-shield/media/Claw control.gif deleted file mode 100644 index a393a8ed..00000000 Binary files a/hardware/bioamp/muscle-bioamp-shield/media/Claw control.gif and /dev/null differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/9v-battery.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/9v-battery.gif similarity index 100% rename from hardware/bioamp/muscle-bioamp-shield/media/9v-battery.gif rename to hardware/bioamp/muscle-bioamp-shield/media/gifs/9v-battery.gif diff --git a/hardware/bioamp/muscle-bioamp-shield/media/gifs/arduino-laptop-connection.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/arduino-laptop-connection.gif new file mode 100644 index 00000000..ddaf641d Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/gifs/arduino-laptop-connection.gif differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/gifs/claw-control.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/claw-control.gif new file mode 100644 index 00000000..1fe7ae81 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/gifs/claw-control.gif differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/gifs/electrode-cable-connection.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/electrode-cable-connection.gif new file mode 100644 index 00000000..03b6e33f Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/gifs/electrode-cable-connection.gif differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/gifs/electrode-placement.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/electrode-placement.gif new file mode 100644 index 00000000..6fdcb176 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/gifs/electrode-placement.gif differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/LEDGraph.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/led-graph.gif similarity index 100% rename from hardware/bioamp/muscle-bioamp-shield/media/LEDGraph.gif rename to hardware/bioamp/muscle-bioamp-shield/media/gifs/led-graph.gif diff --git a/hardware/bioamp/muscle-bioamp-shield/media/gifs/listening-emg-earphones.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/listening-emg-earphones.gif new file mode 100644 index 00000000..951601ab Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/gifs/listening-emg-earphones.gif differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/gifs/listening-emg-speakers.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/listening-emg-speakers.gif new file mode 100644 index 00000000..db0c5736 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/gifs/listening-emg-speakers.gif differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/listening-muscle-signals.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/listening-muscle-signals.gif similarity index 100% rename from hardware/bioamp/muscle-bioamp-shield/media/listening-muscle-signals.gif rename to hardware/bioamp/muscle-bioamp-shield/media/gifs/listening-muscle-signals.gif diff --git a/hardware/bioamp/muscle-bioamp-shield/media/servo-control.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/servo-control.gif similarity index 100% rename from hardware/bioamp/muscle-bioamp-shield/media/servo-control.gif rename to hardware/bioamp/muscle-bioamp-shield/media/gifs/servo-control.gif diff --git a/hardware/bioamp/muscle-bioamp-shield/media/gifs/shield-arduino-connection.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/shield-arduino-connection.gif new file mode 100644 index 00000000..fe233285 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/gifs/shield-arduino-connection.gif differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/gifs/visualise-emg.gif b/hardware/bioamp/muscle-bioamp-shield/media/gifs/visualise-emg.gif new file mode 100644 index 00000000..a5df3f1c Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/gifs/visualise-emg.gif differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/arduino-laptop-connection-1.png b/hardware/bioamp/muscle-bioamp-shield/media/images/arduino-laptop-connection-1.png new file mode 100644 index 00000000..a450518d Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/arduino-laptop-connection-1.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/arduino-laptop-connection-2.png b/hardware/bioamp/muscle-bioamp-shield/media/images/arduino-laptop-connection-2.png new file mode 100644 index 00000000..b9246f7b Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/arduino-laptop-connection-2.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/claw-control.png b/hardware/bioamp/muscle-bioamp-shield/media/images/claw-control.png new file mode 100644 index 00000000..210ba34b Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/claw-control.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/electrode-cable-connection.png b/hardware/bioamp/muscle-bioamp-shield/media/images/electrode-cable-connection.png new file mode 100644 index 00000000..259a299e Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/electrode-cable-connection.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/electrode-placement-1.png b/hardware/bioamp/muscle-bioamp-shield/media/images/electrode-placement-1.png new file mode 100644 index 00000000..dde28d83 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/electrode-placement-1.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/electrode-placement-2.png b/hardware/bioamp/muscle-bioamp-shield/media/images/electrode-placement-2.png new file mode 100644 index 00000000..fa9b2cc9 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/electrode-placement-2.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/led-graph.png b/hardware/bioamp/muscle-bioamp-shield/media/images/led-graph.png new file mode 100644 index 00000000..3c921b09 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/led-graph.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/listening-emg-earphones.png b/hardware/bioamp/muscle-bioamp-shield/media/images/listening-emg-earphones.png new file mode 100644 index 00000000..45dfe73d Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/listening-emg-earphones.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/listening-emg-speakers.png b/hardware/bioamp/muscle-bioamp-shield/media/images/listening-emg-speakers.png new file mode 100644 index 00000000..3cfdbb6f Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/listening-emg-speakers.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/shield-arduino-connection.png b/hardware/bioamp/muscle-bioamp-shield/media/images/shield-arduino-connection.png new file mode 100644 index 00000000..2d653341 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/shield-arduino-connection.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/images/visualise-emg.png b/hardware/bioamp/muscle-bioamp-shield/media/images/visualise-emg.png new file mode 100644 index 00000000..7c7cc12a Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/images/visualise-emg.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/kit-contents-assembled.png b/hardware/bioamp/muscle-bioamp-shield/media/kit-contents-assembled.png new file mode 100644 index 00000000..a271d5e5 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/kit-contents-assembled.png differ diff --git a/hardware/bioamp/muscle-bioamp-shield/media/kit-contents-unassembled.png b/hardware/bioamp/muscle-bioamp-shield/media/kit-contents-unassembled.png new file mode 100644 index 00000000..c5dd2894 Binary files /dev/null and b/hardware/bioamp/muscle-bioamp-shield/media/kit-contents-unassembled.png differ