diff --git a/.buildinfo b/.buildinfo index 99a4aab8..03cc08ad 100644 --- a/.buildinfo +++ b/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 9dd112192f34636b55813ff02851c3f7 +config: bc9512566069a2f355aa1259ef1066ed tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/_images/shield-pamphlet.jpg b/_images/shield-pamphlet.jpg deleted file mode 100644 index ee60abb8..00000000 Binary files a/_images/shield-pamphlet.jpg and /dev/null differ diff --git a/_sources/bioamp-exg-pill.rst b/_sources/bioamp-exg-pill.rst deleted file mode 100644 index d68be951..00000000 --- a/_sources/bioamp-exg-pill.rst +++ /dev/null @@ -1,13 +0,0 @@ -:orphan: - -.. _bioamp-exg-pill-datasheet: - -BioAmp EXG Pill -############### - -.. toctree:: - :hidden: - :maxdepth: 1 - :caption: BioAmp - - hardware/bioamp/bioamp-exg-pill/index \ No newline at end of file diff --git a/_sources/guides/usage-guides/using-bioamp-bands/index.rst b/_sources/guides/usage-guides/using-bioamp-bands/index.rst index b41dd115..d52e3996 100644 --- a/_sources/guides/usage-guides/using-bioamp-bands/index.rst +++ b/_sources/guides/usage-guides/using-bioamp-bands/index.rst @@ -13,15 +13,15 @@ Why use BioAmp Bands? Usually, people use gel electrodes to record biopotential signals from the skin surface. But, it has its own disadvantages. So we came up with these BioAmp Bands using which users can enjoy a more comfortable, cost-effective, and hassle-free experience while recording biopotential signals. -- :bdg-primary:`Comfort` BioAmp Bands are generally more comfortable to wear than gel electrodes, especially for long-term recordings. They conform to the body's shape and avoid the sticky, sometimes irritating sensation of gel electrodes. +- :bdg-primary:`Comfort:` BioAmp Bands are generally more comfortable to wear than gel electrodes, especially for long-term recordings. They conform to the body's shape and avoid the sticky, sometimes irritating sensation of gel electrodes. -- :bdg-secondary:`Reusability` Unlike gel electrodes, which are often single-use and need to be replaced frequently, BioAmp Bands can be reused multiple times. This makes them more cost-effective and environmentally friendly. +- :bdg-secondary:`Reusability:` Unlike gel electrodes, which are often single-use and need to be replaced frequently, BioAmp Bands can be reused multiple times. This makes them more cost-effective and environmentally friendly. -- :bdg-success:`Ease of Use` These bands are easy to wear and adjust, reducing the hassle of setup and ensuring consistent placement. +- :bdg-success:`Ease of Use:` These bands are easy to wear and adjust, reducing the hassle of setup and ensuring consistent placement. -- :bdg-info:`Hygiene` They can be easily cleaned and sanitized between uses, reducing the risk of skin irritation and infections. Gel electrodes, on the other hand, can leave residue on the skin surface. +- :bdg-info:`Hygiene:` They can be easily cleaned and sanitized between uses, reducing the risk of skin irritation and infections. Gel electrodes, on the other hand, can leave residue on the skin surface. -- :bdg-danger:`Performance` The bands can provide stable and reliable signal recordings depending on your environment conditions. For hot/humid conditions, the bands usually perform better while recording the signals. But if the weather is cold causing dry skin, then it is recommended to prepare the skin properly and apply electrode gel between the metallic part of cable and skin surface. If you feel that the skin impedence is increasing, then reapply electrode gel frequently. The other option is to use gel electrodes after preparing the skin properly. +- :bdg-danger:`Performance:` The bands can provide stable and reliable signal recordings depending on your environment conditions. For hot/humid conditions, the bands usually perform better while recording the signals. But if the weather is cold causing dry skin, then it is recommended to prepare the skin properly and apply electrode gel between the metallic part of cable and skin surface. If you feel that the skin impedence is increasing, then reapply electrode gel frequently. The other option is to use gel electrodes after preparing the skin properly. Types of BioAmp Bands @@ -29,7 +29,7 @@ Types of BioAmp Bands There are 3 types of BioAmp Bands and all these bands offer targeted and efficient solutions for recording biopotential signals from the muscles, heart, and brain, making them versatile tools for a wide range of HCI/BCI applications. -1) Muscle BioAmp Band +1. Muscle BioAmp Band ========================== Muscle BioAmp Band (EMG Band) is a stretchable band that can be connected to any of our Muscle BioAmp Hardware or any EXG sensor using a BioAmp Cable. It allows you to record your muscle signals hassle-free. @@ -55,7 +55,7 @@ Muscle BioAmp Band (EMG Band) is a stretchable band that can be connected to any | Wearable | Yes | +---------------------+--------------------------------------------+ -2) Heart BioAmp Band +2. Heart BioAmp Band ========================== Heart BioAmp Band (ECG Band) is a stretchable band that can be connected to any of our Heart BioAmp Hardware or any EXG sensor using BioAmp Cable. It allows you to record your ECG signals hassle-free. @@ -81,7 +81,7 @@ Heart BioAmp Band (ECG Band) is a stretchable band that can be connected to any | Wearable | Yes | +---------------------+--------------------------------------------+ -3) Brain BioAmp Band +3. Brain BioAmp Band ========================== Brain BioAmp Band (EEG Band) is a stretchable band that can be connected to any of our Brain BioAmp Hardware or any EXG sensor using BioAmp Cable to record signals from the brain hassle-free. @@ -130,45 +130,90 @@ Assembly 1. Take your Muscle BioAmp Band, hold the side of the band that has buckle on it and align the top part of the buckle with the flat surface of the snap. -.. figure:: media/muscle-bioamp-band/emg-band-assembly-1.gif - :align: center +.. only:: html -2. Take the other end of the band and insert it in the buckle. + .. figure:: media/muscle-bioamp-band/emg-band-assembly-1.* + :align: center -.. figure:: media/muscle-bioamp-band/emg-band-assembly-2.gif - :align: center +.. only:: latex + + .. figure:: media/muscle-bioamp-band/images/emg-band-assembly-1.* + :align: center + +1. Take the other end of the band and insert it in the buckle. + +.. only:: html + + .. figure:: media/muscle-bioamp-band/emg-band-assembly-2.* + :align: center + +.. only:: latex + + .. figure:: media/muscle-bioamp-band/images/emg-band-assembly-2.* + :align: center + + .. figure:: media/muscle-bioamp-band/images/emg-band-assembly-3.* + :align: center 3. Your band is now ready to use. You can also adjust the size of the band according to your targeted muscle. -.. figure:: media/muscle-bioamp-band/adjust-band-size.gif - :align: center +.. only:: html + + .. figure:: media/muscle-bioamp-band/adjust-band-size.* + :align: center + +.. only:: latex + + .. figure:: media/muscle-bioamp-band/images/adjust-band-size.* + :align: center Skin Preparation =================== Apply Nuprep Skin Preparation Gel on the skin surface where dry electrodes would be placed to remove dead skin cells and clean the skin from dirt. After rubbing the skin surface thoroughly, clean it with an alcohol wipe or a wet wipe. -For more information, please check out detailed step by step `skin preparation guide `_. +For more information, please check out detailed step by step :ref:`skin-preparation`. Measure EMG ============= 1. Flip the band and snap the dry electrodes of the BioAmp Cable on it as shown below. -.. figure:: media/muscle-bioamp-band/connecting-cable.gif - :align: center +.. only:: html -2. Flip the band again and wear it on your arm in such a way that IN+ and IN- are placed on the arm near the ulnar nerve and REF (reference) on the far side of the band. + .. figure:: media/muscle-bioamp-band/connecting-cable.* + :align: center -.. figure:: media/muscle-bioamp-band/wearing-band.gif - :align: center +.. only:: latex + + .. figure:: media/muscle-bioamp-band/images/connecting-cable.* + :align: center + +1. Flip the band again and wear it on your arm in such a way that IN+ and IN- are placed on the arm near the ulnar nerve and REF (reference) on the far side of the band. + +.. only:: html + + .. figure:: media/muscle-bioamp-band/wearing-band.* + :align: center + +.. only:: latex + + .. figure:: media/muscle-bioamp-band/images/wearing-band.* + :align: center .. note:: Make sure the dry electrodes (shiny parts of the BioAmp Cable) are in direct contact with the skin. 3. Now put a small amount of electrode gel or Ten20 paste between the skin and dry electrodes to get the best signal acquisition. + +.. only:: html -.. figure:: media/muscle-bioamp-band/applying-gel.gif - :align: center + .. figure:: media/muscle-bioamp-band/applying-gel.* + :align: center + +.. only:: latex + + .. figure:: media/muscle-bioamp-band/images/applying-gel.* + :align: center .. note:: - After using the band, don't leave the gel residue on the dry electrodes longer than an hour as it may corrode them over a period of time. - Wash the band with liquid soap and rinse it properly after every use. Use it again only when it is completely dry. @@ -181,20 +226,37 @@ Skin Preparation Apply Nuprep Skin Preparation Gel on your chest where dry electrodes would be placed to remove dead skin cells and clean the skin from dirt. After rubbing the skin surface thoroughly, clean it with an alcohol wipe or a wet wipe. -For more information, please check out detailed step by step `skin preparation guide `_. +For more information, please check out detailed step by step :ref:`skin-preparation`. Assembly ============ 1. Take your Heart BioAmp Band and wrap the band around your chest in such a way that the pointy part of the snap touches your chest and the flat part is on the outer side. -.. figure:: media/heart-bioamp-band/wearing-band.gif - :align: center +.. only:: html + + .. figure:: media/heart-bioamp-band/wearing-band.* + :align: center + +.. only:: latex + + .. figure:: media/heart-bioamp-band/images/wearing-band.* + :align: center 2. Now insert the loose end of the band into the buckle and tighten it by pulling the strap. -.. figure:: media/heart-bioamp-band/band-assembly.gif - :align: center +.. only:: html + + .. figure:: media/heart-bioamp-band/band-assembly.* + :align: center + +.. only:: latex + + .. figure:: media/heart-bioamp-band/images/band-assembly.* + :align: center + + .. figure:: media/heart-bioamp-band/images/band-assembly-2.* + :align: center 3. Your band is now ready to use. You can also adjust the size of the band according to your chest size. @@ -203,15 +265,29 @@ Measure ECG 1. Snap the IN- cable on the left most side of the band, IN+ cable in the middle, and REF cable on the right side as shown below. -.. figure:: media/heart-bioamp-band/connecting-cable.gif - :align: center +.. only:: html + + .. figure:: media/heart-bioamp-band/connecting-cable.* + :align: center + +.. only:: latex + + .. figure:: media/heart-bioamp-band/images/connecting-cable.* + :align: center .. note:: Make sure the dry electrodes (shiny parts of the BioAmp Cable) are in direct contact with the skin. 2. Now put a small amount of electrode gel or Ten20 paste between the skin and dry electrodes to get the best signal acquisition. -.. figure:: media/heart-bioamp-band/electrode-gel.gif - :align: center +.. only:: html + + .. figure:: media/heart-bioamp-band/electrode-gel.* + :align: center + +.. only:: latex + + .. figure:: media/heart-bioamp-band/images/electrode-gel.* + :align: center .. note:: - After using the band, don't leave the gel residue on the dry electrodes longer than an hour as it may corrode them over a period of time. - Wash the band with liquid soap and rinse it properly after every use. Use it again only when it is completely dry. @@ -223,38 +299,38 @@ Assembly =========== You get the band in two parts - the longer part consists of buckles at both ends and the shorter one has loose ends on both sides. -1) Hold one end of the longer band and align the top part of the buckle with the flat surface of the snap. +1. Hold one end of the longer band and align the top part of the buckle with the flat surface of the snap. -2) Now take the shorter band and insert it into the buckle of longer band. +2. Now take the shorter band and insert it into the buckle of longer band. -3) Repeat step 1 and 2 for the other buckle on the longer band. +3. Repeat step 1 and 2 for the other buckle on the longer band. -4) Your band is now ready to use. You can also adjust the size of the band according to your head size. +4. Your band is now ready to use. You can also adjust the size of the band according to your head size. Skin Preparation =================== Apply Nuprep Skin Preparation Gel on your targeted area (visual cortex or prefrontal cortex) where dry electrodes would be placed to remove dead skin cells and clean the skin from dirt. After rubbing the skin surface thoroughly, clean it with an alcohol wipe or a wet wipe. -For more information, please check out detailed step by step `skin preparation guide `_. +For more information, please check out detailed step by step :ref:`skin-preparation`. Measure 1-channel EEG ======================== -1) Flip the band, take your BioAmp Cable, and snap the REF cable on a gel electrode. Now snap the IN- and IN+ cable on: +1. Flip the band, take your BioAmp Cable, and snap the REF cable on a gel electrode. Now snap the IN- and IN+ cable on: - Fp1 and Fp2 positions for recording EEG from prefrontal cortex - O1 and O2 positions for recording EEG from visual cortex .. note:: The electrode positions mentioned above are according to `International 10-20 sytem for recording EEG `_. -2) Flip the band again and wear it in a way so that the dry electrodes (shiny parts of the cable) are in contact with: +2. Flip the band again and wear it in a way so that the dry electrodes (shiny parts of the cable) are in contact with: - skin surface on the forehead (if recording from prefrontal cortex) - scalp surface on the back side of your head (if recording from visual cortex) -3) Peel of the plastic backing of the gel electrode and place it on the bony part behind your earlobe. +3. Peel of the plastic backing of the gel electrode and place it on the bony part behind your earlobe. .. note:: While placing the gel electrodes on the skin, make sure to place the non-sticky tab of the electrode in the direction opposite to your hair growth. This allows you to remove the electrodes easily without pulling off much body hair. -4) Now put a small amount of electrode gel or Ten20 paste between the skin/scalp and dry electrodes to get the best signal acquisition. \ No newline at end of file +4. Now put a small amount of electrode gel or Ten20 paste between the skin/scalp and dry electrodes to get the best signal acquisition. \ No newline at end of file diff --git a/_sources/guides/usage-guides/using-gel-electrodes/index.rst b/_sources/guides/usage-guides/using-gel-electrodes/index.rst index cebee068..6a434f25 100644 --- a/_sources/guides/usage-guides/using-gel-electrodes/index.rst +++ b/_sources/guides/usage-guides/using-gel-electrodes/index.rst @@ -79,14 +79,14 @@ Using the electrodes Determine the target area from where you want to record the biopotential signals. -.. warning:: For people having sensitive skin, it is recommended to use either gel electrodes with hydrogel/standard adhesive or use `BioAmp Bands `_. +.. warning:: For people having sensitive skin, it is recommended to use either gel electrodes with hydrogel/standard adhesive or :ref:`use BioAmp Bands `. 1. Skin Preparation ====================== Remove any excessive hair on the targeted area. Apply Nuprep skin preparation gel on the skin surface where electrodes would be placed to remove dead skin cells and clean the skin from dirt. After rubbing the skin surface thoroughly, clean it with an alcohol wipe or a wet wipe. -For more information, please check out detailed step by step `skin preparation guide `_. +For more information, please check out detailed step by step :ref:`skin-preparation`. .. note:: Always ensure that the prepared skin area is dry prior to applying the gel electrodes. diff --git a/_sources/hardware/bioamp/bioamp-exg-pill/index.rst b/_sources/hardware/bioamp/bioamp-exg-pill/index.rst index 38e20754..45e967cd 100644 --- a/_sources/hardware/bioamp/bioamp-exg-pill/index.rst +++ b/_sources/hardware/bioamp/bioamp-exg-pill/index.rst @@ -15,7 +15,7 @@ just a few. It also works with any dedicated ADC, like the Texas Instruments ADS .. note:: It is recommended to use Arduino UNO R4 while recording biopotential signals since it has 14-bit ADC and can record the signals much accurately. -.. image:: ../../../media/bioamp-exg-pill.* +.. figure:: ../../../media/bioamp-exg-pill.* :align: center What makes it different? @@ -75,11 +75,11 @@ Software requirements - Before you start using the kit, please download `Arduino IDE v1.8.19 (legacy IDE) `_. Using this you'll be able to upload the arduino sketches in your development board and visualise the data on your laptop. -.. image:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.* +.. figure:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.* - Download Backyard Brains' `Spike Recorder `_ according to the operating system you are using (Windows, OSX, Linux). -.. image:: ../../../kits/diy-neuroscience/basic/media/byb.* +.. figure:: ../../../kits/diy-neuroscience/basic/media/byb.* Using the Hardware ********************* @@ -94,9 +94,13 @@ Insert the provided BioAmp cable's JST PH connector and header pins from top as .. figure:: media/assembly-step1.* :align: center + `Soldering the connector & header pins on BioAmp EXG Pill` + .. figure:: media/bioamp-exg-pill-soldered.* :align: center + `After soldering, BioAmp EXG Pill should look like this` + Step 2 (optional): Configure for ECG/EMG ========================================== @@ -129,6 +133,8 @@ For all the examples provided, we are using the A0 pin of Arduino UNO R3. Connec .. figure:: media/connections-with-arduino.* :align: center + `Connections with Arduino UNO R3` + .. warning:: Take precautions while connecting to power, if power pins are to be swapped, your BioAmp EXG Pill will be fried and it’ll become unusable (DIE). Step 4: Connecting electrode cable @@ -136,7 +142,10 @@ Step 4: Connecting electrode cable Connect the BioAmp cable to BioAmp EXG Pill by inserting the cable end in the JST PH connector as shown in the graphic below. -.. image:: media/connection-with-cable.* +.. figure:: media/connection-with-cable.* + :align: center + + `Connections with BioAmp Cable v3` Step 5: Skin Preparation =========================== @@ -171,18 +180,21 @@ We have 2 options to measure the EMG signals, either using the gel electrodes or 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. -.. image:: media/emg.* +.. figure:: media/emg.* - **Using Muscle BioAmp Band:** 1. Connect the BioAmp cable to Muscle BioAmp Band in a way such that IN+ and IN- are placed on the arm near the ulnar nerve & REF (reference) on the far side of the band. + 2. Now put a small drop of electrode gel between the skin and metallic part of BioAmp cable to get the best results. +.. tip:: Visit the complete documentation on how to :ref:`assemble and use the BioAmp Bands ` or follow the youtube video given below. + **Tutorial on how to use the band:** -.. youtube:: xYZdw0aesa0 - :align: center - :width: 100% + .. youtube:: xYZdw0aesa0 + :align: center + :width: 100% .. note:: In this demonstration we are recording EMG signals from the ulnar nerve, but you can record EMG from other areas as well (biceps, triceps, legs, jaw etc) as per your project requirements. Just make sure to place the IN+, IN- electrodes on the targeted muscle and REF on a bony part. @@ -191,11 +203,11 @@ Uploading the code Connect the Arduino Uno to your laptop using the USB cable (Type A to Type B). Copy paste any one of the Arduino Sketches given below in Arduino IDE v1.8.19 that you downloaded earlier: -EMG Filter: https://github.com/upsidedownlabs/Muscle-BioAmp-Arduino-Firmware/blob/main/2_EMGFilter/2_EMGFilter.ino +:fab:`github;pst-color-primary` `EMG Filter `_ -EMG Envelope: https://github.com/upsidedownlabs/Muscle-BioAmp-Arduino-Firmware/blob/main/3_EMGEnvelope/3_EMGEnvelope.ino +:fab:`github;pst-color-primary` `EMG Envelope `_ -Go to tools from the menu bar, select "board" option then select Arduino UNO. In the same menu, +Go to ``tools`` from the menu bar, select ``board`` option then select Arduino UNO. In the same menu, select the COM port on which your Arduino Uno is connected. To find out the right COM port, disconnect your board and reopen the menu. The entry that disappears should be the right COM port. Now upload the code, & open the serial plotter from the tools menu to visualize @@ -203,14 +215,15 @@ the EMG signals. After opening the serial plotter make sure to select the baud rate to 115200. -.. warning:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. +.. important:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. Visualizing the EMG signals ---------------------------- Now flex your arm to visualize the muscle signals in real time on your laptop. -.. image:: media/EMGEnvelop.* +.. figure:: media/EMGEnvelop.* + :align: center Step 6: Measuring ElectroCardioGraphy (ECG) ============================================= @@ -232,7 +245,8 @@ We have 2 options to measure the ECG signals, either using the gel electrodes or 2. Peel the plastic backing from electrodes 3. Place the IN- cable on the left side, IN+ in the middle and REF (reference) on the far right side as shown in the diagram. -.. image:: media/ecg.* +.. figure:: media/ecg.* + :align: center - **Using Heart BioAmp Band:** @@ -240,20 +254,22 @@ We have 2 options to measure the ECG signals, either using the gel electrodes or 2. Place the IN- cable on the left side, IN+ in the middle and REF (reference) on the far right side. 3. Now put a small drop of electrode gel between the skin and metallic part of BioAmp cable to get the best results. -**Tutorial on how to use the band:** +.. tip:: Visit the complete documentation on how to :ref:`assemble and use the BioAmp Bands ` or follow the youtube video given below. -.. youtube:: fr5iORsVyUM - :align: center - :width: 100% + **Tutorial on how to use the band:** + + .. youtube:: fr5iORsVyUM + :align: center + :width: 100% Uploading the code --------------------- Connect Arduino Uno to your laptop using the USB cable (Type A to Type B). Copy paste the Arduino Sketch given below in Arduino IDE v1.8.19 that you downloaded earlier: -ECG Filter: https://github.com/upsidedownlabs/Heart-BioAmp-Arduino-Firmware/blob/main/2_ECGFilter/2_ECGFilter.ino +:fab:`github;pst-color-primary` `ECG Filter `_ -Go to tools from the menu bar, select "board" option then select Arduino UNO. In the same menu, +Go to ``tools`` from the menu bar, select ``board`` option then select Arduino UNO. In the same menu, select the COM port on which your Arduino Uno is connected. To find out the right COM port, disconnect your board and reopen the menu. The entry that disappears should be the right COM port. Now upload the code, & open the serial plotter from the tools menu to visualize @@ -261,12 +277,15 @@ the signals. After opening the serial plotter make sure to select the baud rate to 115200. -.. warning:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. +.. important:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. Visualizing the ECG signals ----------------------------- -.. image:: media/bioamp-Exg-Pill-ECG.* +Sit back, relax and see your ECG signals in real time on your laptop. + +.. figure:: media/bioamp-Exg-Pill-ECG.* + :align: center Step 7: Measuring Electrooculography (EOG) ================================================ @@ -287,7 +306,8 @@ We have 2 ways to measure the EOG signals, either record the horizontal eye move - **Horizontal EOG recording:** -.. image:: media/eog-horizontal.* +.. figure:: media/eog-horizontal.* + :align: center 1. Connect the BioAmp cable to gel electrodes. 2. Peel the plastic backing from electrodes. @@ -295,7 +315,8 @@ We have 2 ways to measure the EOG signals, either record the horizontal eye move - **Vertical EOG recording:** -.. image:: media/eog-vertical.* +.. figure:: media/eog-vertical.* + :align: center 1. Connect the BioAmp cable to gel electrodes. 2. Peel the plastic backing from electrodes. @@ -306,9 +327,9 @@ Uploading the code Connect Arduino Uno to your laptop using the USB cable (Type A to Type B). Copy paste the Arduino Sketch given below in Arduino IDE v1.8.19 that you downloaded earlier: -EOG Filter: https://github.com/upsidedownlabs/Eye-BioAmp-Arduino-Firmware/blob/main/2_EOGFilter/2_EOGFilter.ino +:fab:`github;pst-color-primary` `EOG Filter `_ -Go to tools from the menu bar, select "board" option then select Arduino UNO. In the same menu, +Go to ``tools`` from the menu bar, select ``board`` option then select Arduino UNO. In the same menu, select the COM port on which your Arduino Uno is connected. To find out the right COM port, disconnect your board and reopen the menu. The entry that disappears should be the right COM port. Now upload the code, & open the serial plotter from the tools menu to visualize @@ -316,12 +337,15 @@ the signals. After opening the serial plotter make sure to select the baud rate to 115200. -.. warning:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. +.. important:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. Visualizing the EOG signals ------------------------------ -.. image:: media/bioamp-exg-pill-eog.* +Move your eyes up-down or left-right to see your EOG signals in real time on your laptop. + +.. figure:: media/bioamp-exg-pill-eog.* + :align: center Step 8: Measuring Electroencephalography (EEG) =================================================== @@ -335,7 +359,7 @@ Step 8: Measuring Electroencephalography (EEG) For recording EEG from different parts of the brain, you have to place the electrodes according to the `International 10-20 system for recording EEG `_. -.. image:: ../../../kits/diy-neuroscience/basic/media/10-20-system.* +.. figure:: ../../../kits/diy-neuroscience/basic/media/10-20-system.* :align: center Electrodes placement @@ -345,7 +369,8 @@ We have 2 options to measure the EEG signals, either using the gel electrodes or - **Using gel electrodes to record from prefrontal cortex part of brain:** -.. image:: media/eeg.* +.. figure:: media/eeg.* + :align: center 1. Connect the BioAmp cable to gel electrodes. 2. Peel the plastic backing from electrodes. @@ -357,27 +382,29 @@ We have 2 options to measure the EEG signals, either using the gel electrodes or 2. In this case, the REF (reference) should be connected using gel electrode. So connect the reference of BioAmp cable to the gel electrode, peel the plastic backing and place it at the bony part, on the back side of your earlobe. 3. Now put a small drop of electrode gel on the dry electrodes (IN+ and IN-) between the skin and metallic part of BioAmp cable to get the best results. -.. note:: Similarly you can use the band to record EEG signals from the visual cortex part of brain by placing the dry electrodes on O1 and O2 instead of Fp1 and Fp2. Everything else will remain the same. +.. tip:: Visit the complete documentation on how to :ref:`assemble and use the BioAmp Bands ` or follow the youtube video given below. + + **Tutorial on how to use the band:** -**Tutorial on how to use the band:** + .. youtube:: O6qp7teT-sM + :align: center + :width: 100% -.. youtube:: O6qp7teT-sM - :align: center - :width: 100% +.. note:: Similarly you can use the band to record EEG signals from the visual cortex part of brain by placing the dry electrodes on O1 and O2 instead of Fp1 and Fp2. Everything else will remain the same. Uploading the code ----------------------- Connect Arduino Uno to your laptop using the USB cable (Type A to Type B). Copy paste the Arduino Sketch given below in Arduino IDE v1.8.19 that you downloaded earlier: -`Spike recorder arduino code `_ +:fab:`github;pst-color-primary` `Spike recorder arduino code `_ -Go to tools from the menu bar, select "board" option then select Arduino UNO. In the same menu, +Go to ``tools`` from the menu bar, select ``board`` option then select Arduino UNO. In the same menu, select the COM port on which your development board is connected. To find out the right COM port, screen disconnect your board and reopen the menu. The entry that disappears should be the right COM port. Now upload the code. -.. warning:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. +.. important:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. Visualizing the EEG signals ------------------------------- @@ -386,6 +413,9 @@ Open the Spike Recorder software. When the Spike Recorder starts, it will start the first icon on the top left corner of the screen, select the COM port on which your Arduino UNO is connected and click on connect. .. figure:: ../../../kits/diy-neuroscience/basic/media/spike-recorder-configurations.* + :align: center + + `Spike Recorder settings` Mute the speakers and apply the 50Hz notch filter by clicking on the checkbox as shown in the screenshot above. You should set the low band pass filter to 1Hz and high bandpass filter to 40Hz as we are only recording the EEG signals which range between @@ -393,7 +423,10 @@ these frequencies. Now everything is configured and connected. So close the settings window and start recording EEG signals. -.. image:: ../../../kits/diy-neuroscience/basic/media/bioamp-exg-pill-eeg.* +.. figure:: ../../../kits/diy-neuroscience/basic/media/bioamp-exg-pill-eeg.* + :align: center + + `EEG signals being visualised in Spike Recorder` The signals that you can see on the screen right now are originating from prefrontal cortex part of your brain and propagating through all the layers to the surface of your skin. @@ -458,25 +491,49 @@ Project ideas & tutorials :margin: 4 4 0 0 :gutter: 2 - .. grid-item-card:: Detecting heart beats + .. grid-item-card:: Controlling video game using brainwaves (EEG) :text-align: center - :link: https://youtu.be/uB5R-vGJjJo + :link: https://www.instructables.com/Controlling-Video-Game-Using-Brainwaves-EEG/ - .. grid-item-card:: Measuring heart rate + .. grid-item-card:: Visualising electrical impulses from eyes (EOG) + :text-align: center + :link: https://www.instructables.com/Visualizing-Electrical-Impulses-of-Eyes-EOG-Using-/ + + .. grid-item-card:: Recording EEG from visual cortex :text-align: center - :link: https://youtu.be/PvWtCFNK3_s + :link: https://www.instructables.com/Recording-EEG-From-Visual-Cortex-of-Brain-Using-Bi/ + + .. grid-item-card:: Recording EEG from prefrontal cortex + :text-align: center + :link: https://www.instructables.com/Recording-EEG-From-Pre-Frontal-Cortex-of-Brain-Usi/ + + .. grid-item-card:: Eye blink detection + :text-align: center + :link: https://www.instructables.com/Eye-Blink-Detection-by-Recording-EOG-Using-BioAmp-/ .. grid-item-card:: Creating a drowsiness detector :text-align: center - :link: https://youtu.be/h4F41mp4mWk + :link: https://www.instructables.com/Drowsiness-Detector-by-Detecting-EOG-Signals-Using/ + + .. grid-item-card:: Record publication-grade ECG + :text-align: center + :link: https://www.instructables.com/Record-Publication-Grade-ECG-at-Your-Home-Using-Bi/ + + .. grid-item-card:: Measuring heart rate + :text-align: center + :link: https://www.instructables.com/Measuring-Heart-Rate-Using-BioAmp-EXG-Pill/ + + .. grid-item-card:: Detecting heart beats + :text-align: center + :link: https://www.instructables.com/Detecting-Heart-Beats-Using-BioAmp-EXG-Pill/ - .. grid-item-card:: Detecting eye blinks + .. grid-item-card:: Record publication-grade EMG :text-align: center - :link: https://youtu.be/PfEJVa3gv6E + :link: https://www.instructables.com/Recording-Publication-Grade-Muscle-Signals-Using-B/ - .. grid-item-card:: Record EEG from visual cortex part of brain + .. grid-item-card:: Detecting up and down movement of eyes :text-align: center - :link: https://youtu.be/XENPUkfxLec + :link: https://www.instructables.com/Tracking-UP-and-DOWN-Movements-of-Eyes-Using-EOG/ These are some of the project ideas but the possibilities are endless. So create your own Human Computer Interface (HCI) and Brain Computer Interface (BCI) projects and share them with us at contact@upsidedownlabs.tech. @@ -487,11 +544,17 @@ Project ideas & tutorials Below are some project ideas that you can try making at your home. - 1. `Recording EEG from visual cortex `_ - 2. `Measuring heart rate `_ - 3. `Detecting heart beats `_ - 4. `Creating a drowsiness detector `_ - 5. `Detecting eye blinks `_ + 1. `Controlling video game using brainwaves (EEG) `_ + 2. `Visualising electrical impulses from eyes (EOG) `_ + 3. `Recording EEG from visual cortex part of brain `_ + 4. `Recording EEG from prefrontal cortex part of brain `_ + 5. `Eye blink detection `_ + 6. `Creating a drowsiness detector `_ + 7. `Record publication-grade ECG `_ + 8. `Measuring heart rate `_ + 9. `Detecting heart beats `_ + 10. `Record publication-grade EMG `_ + 11. `Detecting up and down movement of eyes `_ These are some of the project ideas but the possibilities are endless. So create your own Human Computer Interface (HCI) and Brain Computer Interface (BCI) projects and share them with us at contact@upsidedownlabs.tech diff --git a/_sources/hardware/bioamp/bioamp-v1.5/index.rst b/_sources/hardware/bioamp/bioamp-v1.5/index.rst index 9eebafec..cf16bd53 100644 --- a/_sources/hardware/bioamp/bioamp-v1.5/index.rst +++ b/_sources/hardware/bioamp/bioamp-v1.5/index.rst @@ -73,7 +73,7 @@ Images below shows a quick overview of the hardware design. Contents of the kit ******************** -.. image:: media/kit-contents.* +.. figure:: media/kit-contents.* Software requirements ********************** @@ -195,14 +195,14 @@ Using the kit The image below shows the possibilities of using BioAmp v1.5. Seems complicated? Don't worry, we'll explain each and every step in detail. So follow along to create your own setup. -.. image:: media/bioamp-v1-5-connections.* +.. figure:: media/bioamp-v1-5-connections.* Step 1: Connecting the cables ================================== Connect the BioAmp cable, 9V snap cable and BioAmp AUX cable to BioAmp v1.5 by inserting the cable ends in the respective JST PH connectors as shown below. -.. image:: media/board-with-cables.* +.. figure:: media/board-with-cables.* Step 2: Skin Preparation ========================== @@ -223,7 +223,7 @@ Using gel Electrodes 2. Peel the plastic backing from the 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. -.. image:: media/bioamp-v1-5-emg.* +.. figure:: media/bioamp-v1-5-emg.* Using Muscle BioAmp Band ---------------------------- @@ -240,7 +240,7 @@ Step 4: Connecting 9V battery Connect any 9V battery to BioAmp v1.5 using the 9V snap cable. Now activate the board by flipping ON the power switch, and you'll notice an LED light up, showing that the board is ready to use. -.. image:: media/9v-battery.* +.. figure:: media/9v-battery.* Step 5: Listen to your muscle signals ====================================== @@ -254,7 +254,7 @@ Using speakers 2. Switch on the speaker and turn the volume to maximum. 3. Flex and listen to your muscles. -.. image:: media/listening-emg-2.* +.. figure:: media/listening-emg-2.* Using wired earphones/headphones ---------------------------------------------- @@ -263,7 +263,7 @@ Using wired earphones/headphones 2. Plug it in your ears. 3. Flex and listen to your muscles. -.. image:: media/listening-emg-3.* +.. figure:: media/listening-emg-3.* Step 6: Visualize EMG signals on mobile phone =================================================== @@ -277,7 +277,7 @@ Using Phone Recorder app 2. Flex your muscle to be able to record the muscle signals. 3. If you want to extract that data then it will be saved by default as a .wav file but you can convert it in any other format according to your project requirements. -.. image:: media/emg-in-mobile-2.* +.. figure:: media/emg-in-mobile-2.* Using Backyard Brains' Spike Recorder mobile app ------------------------------------------------ @@ -286,7 +286,7 @@ Using Backyard Brains' Spike Recorder mobile app 2. Open the app, click the setting icon on the top right corner and set the recording type to EMG. 3. Apply the 50Hz or 60Hz notch filter depending on the country you are living in. For example if you are in India then the AC current oscillates at a frequency of 50Hz but it oscillates at 60Hz frequency in USA. This AC current acts as a noise in the signals so we have to remove it by applying this notch filter. -.. image:: media/spike-recorder-mobile.* +.. figure:: media/spike-recorder-mobile.* :width: 80% :align: center @@ -294,7 +294,7 @@ Using Backyard Brains' Spike Recorder mobile app 5. Flex your muscles to be able to visualize the muscle signals (EMG). 6. You can record the EMG data as a .wav file by pressing the record button on the top right corner of the app and then convert it in any other format as per your project requirements. -.. image:: media/emg-in-mobile.* +.. figure:: media/emg-in-mobile.* Step 7: Visualize the EMG signals on laptop ============================================ @@ -308,13 +308,13 @@ Using Backyard Brains' Spike Recorder 2. Open the software, click the setting icon on the top right corner and set the low band pass filter to 72Hz and high band pass filter to 720Hz. 3. Apply the 50Hz or 60Hz notch filter depending on the country you are living in. For example if you are in India then the AC current oscillates at a frequency of 50Hz but it oscillates at 60Hz frequency in USA. This AC current acts as a noise in the signals so we have to remove it by applying this notch filter. -.. image:: media/spike-recorder-laptop.* +.. figure:: media/spike-recorder-laptop.* 4. Again click on the setting icon to close it and you are ready. 5. Flex your muscles to be able to visualize the muscle signals (EMG) 6. You can record the EMG data as a .wav file by pressing the record button on the top right corner of the app and then convert it in any other format as per your project requirements. -.. image:: media/emg-in-laptop.* +.. figure:: media/emg-in-laptop.* Using Audacity ---------------- @@ -324,6 +324,6 @@ Using Audacity 3. Flex your muscles to be able to visualize the muscle signals (EMG) 4. By default the EMG data would be recorded as a .wav file but you can convert it in any other format as per your project requirements. -.. image:: media/emg-in-audacity.* +.. figure:: media/emg-in-audacity.* diff --git a/_sources/hardware/bioamp/muscle-bioamp-biscute/index.rst b/_sources/hardware/bioamp/muscle-bioamp-biscute/index.rst index ec737db2..2efc01fc 100644 --- a/_sources/hardware/bioamp/muscle-bioamp-biscute/index.rst +++ b/_sources/hardware/bioamp/muscle-bioamp-biscute/index.rst @@ -1,4 +1,4 @@ -.. _muscle_bioamp-biscute: +.. _muscle-bioamp-biscute: Muscle BioAmp Biscute ###################### @@ -82,14 +82,14 @@ Images below shows a quick overview of the hardware design. Contents of the kit ******************** -.. image:: media/kit-contents.* +.. figure:: media/kit-contents.* Software requirements ********************** - Before you start using the kit, please download `Arduino IDE v1.8.19 (legacy IDE) `_. Using this you'll be able to upload the arduino sketches on your development board and visualise the data on your laptop. -.. image:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.png +.. figure:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.png Assembling the kit ******************** @@ -205,7 +205,7 @@ Using the kit Step 1: Connect Arduino UNO R3 ================================= -.. image:: media/arduino-biscute-connection.* +.. figure:: media/arduino-biscute-connection.* Connect ``VCC`` to either ``5V`` or ``3.3V``, ``GND`` to ``GND``, and ``OUT`` to ``Analog pin A0`` of your Arduino UNO via jumper cables provided by us. If you are connecting ``OUT`` to any other analog pin, then you will have to change the INPUT PIN in the arduino sketch accordingly. @@ -216,7 +216,7 @@ Connect ``VCC`` to either ``5V`` or ``3.3V``, ``GND`` to ``GND``, and ``OUT`` to Step 3: Connecting electrode cable ======================================== -.. image:: media/biscute-cable-connection.* +.. figure:: media/biscute-cable-connection.* Connect the BioAmp cable to Muscle BioAmp Biscute by inserting the cable end in the JST PH connector as shown above. @@ -241,7 +241,7 @@ We have 2 options to measure the EMG signals, either using the gel electrodes or 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. -.. image:: media/biscute-emg.* +.. figure:: media/biscute-emg.* - **Using Muscle BioAmp Band:** @@ -280,7 +280,7 @@ Visualizing the EMG signals Now flex your arm to visualize the muscle signals in real time on your laptop. -.. image:: media/using-biscute.* +.. figure:: media/using-biscute.* **Video tutorial:** diff --git a/_sources/hardware/bioamp/muscle-bioamp-blip/index.rst b/_sources/hardware/bioamp/muscle-bioamp-blip/index.rst index 90ac4c00..bbe87f3a 100644 --- a/_sources/hardware/bioamp/muscle-bioamp-blip/index.rst +++ b/_sources/hardware/bioamp/muscle-bioamp-blip/index.rst @@ -75,14 +75,14 @@ Images below shows a quick overview of the hardware design. Contents of the kit ******************** -.. image:: media/blip-kit-contents.* +.. figure:: media/blip-kit-contents.* Software requirements ********************** - Before you start using the kit, please download `Arduino IDE v1.8.19 (legacy IDE) `_. Using this you'll be able to upload the arduino sketches on your development board and visualise the data on your laptop. -.. image:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.png +.. figure:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.png Using the kit **************** @@ -92,7 +92,7 @@ Step 1: Soldering connector & header pins Solder the header pins and JST Ph 2.0mm connector on the Muscle BioAmp Blip as shown below. If you ordered assembled kit then you can skip this step and directly move to step 2. -.. image:: media/soldering-blip.* +.. figure:: media/soldering-blip.* Step 2: Connections with the sensor ======================================== @@ -104,28 +104,28 @@ Directly connecting jumper cables You can directly connect the male to female jumper cables on the header pins of Muscle BioAmp Blip at ``5V``, ``GND``, ``AN``. -.. image:: media/blip-with-jumper-cables.* +.. figure:: media/blip-with-jumper-cables.* Connecting on breadboard --------------------------- If you are thinking to connect more components/sensors and want to integrate Muscle BioAmp Blip in the complete circuit then it will be better to use a breadboard. Snap the Muscle BioAmp Blip on the breadboard and connect the jumper cables (male to male) at ``5V``, ``GND``, ``AN``. -.. image:: media/blip-with-breadboard.* +.. figure:: media/blip-with-breadboard.* Connecting via mikroBUS port ----------------------------- You can also connect the Muscle BioAmp Blip to any hardware that has mikroBUS™ port like mikroBUS™ shuttle, mikroBUS™ Arduino UNO Click Shield to name a few. -.. image:: media/blip-with-shuttle.* +.. figure:: media/blip-with-shuttle.* Step 3: Connecting with Arduino UNO R3 ======================================= Connect ``5V`` of the sensor to ``5V`` of your Arduino UNO, ``GND`` to ``GND``, and ``AN`` to ``Analog pin A0`` via other end of the jumper cables. If you are connecting ``AN`` to any other analog pin, then you will have to change the `INPUT PIN` in the example arduino sketch accordingly. -.. image:: media/blip-arduino-connections.* +.. figure:: media/blip-arduino-connections.* .. note:: For demonstration purposes we are showing connections of the sensor with Arduino UNO R3 but you can use any other development board or a standalone ADC of your choice. @@ -134,7 +134,7 @@ Step 4: Connecting electrode cable Connect the BioAmp cable to Muscle BioAmp Blip by inserting the cable end in the JST PH connector as shown. -.. image:: media/blip-bioamp-cable.* +.. figure:: media/blip-bioamp-cable.* Step 5: Skin Preparation =============================================== @@ -201,7 +201,7 @@ Step 8: Visualizing the EMG signals Now flex your arm to visualize the muscle signals in real time on your laptop. -.. image:: media/emg-recording.* +.. figure:: media/emg-recording.* .. rubric:: Footnotes diff --git a/_sources/hardware/bioamp/muscle-bioamp-candy/index.rst b/_sources/hardware/bioamp/muscle-bioamp-candy/index.rst index dc04086d..9273168a 100644 --- a/_sources/hardware/bioamp/muscle-bioamp-candy/index.rst +++ b/_sources/hardware/bioamp/muscle-bioamp-candy/index.rst @@ -7,7 +7,7 @@ Overview ********* A candy-size single-channel ElectroMyography (EMG) sensor for recording of muscle signals -at an affordable cost. It is an SMD version of :ref:`muscle_bioamp-biscute` that can be used to make +at an affordable cost. It is an SMD version of :ref:`muscle-bioamp-biscute` that can be used to make amazing Human-Computer Interface (HCI) projects. .. figure:: media/Muscle-BioAmp-Candy-front.* @@ -88,14 +88,14 @@ Images below shows a quick overview of the hardware design. Contents of the kit ******************** -.. image:: media/kit-contents.* +.. figure:: media/kit-contents.* Software requirements ********************** - Before you start using the kit, please download `Arduino IDE v1.8.19 (legacy IDE) `_. Using this you'll be able to upload the arduino sketches on your development board and visualise the data on your laptop. -.. image:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.png +.. figure:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.png Using the kit **************** @@ -103,7 +103,7 @@ Using the kit Step 1: Connect Arduino UNO R3 ================================= -.. image:: media/arduino-candy-connection.* +.. figure:: media/arduino-candy-connection.* Connect ``VCC`` to either ``5V`` or ``3.3V``, ``GND`` to ``GND``, and ``OUT`` to ``Analog pin A0`` of your Arduino UNO via jumper cables provided by us. If you are connecting ``OUT`` to any other analog pin, then you will have to change the `INPUT PIN` in the example arduino sketch accordingly. @@ -114,7 +114,7 @@ Connect ``VCC`` to either ``5V`` or ``3.3V``, ``GND`` to ``GND``, and ``OUT`` to Step 2: Connecting electrode cable ======================================== -.. image:: media/candy-cable-connection.* +.. figure:: media/candy-cable-connection.* Connect the BioAmp cable to Muscle BioAmp Candy by inserting the cable end in the JST PH connector as shown above. @@ -139,7 +139,7 @@ We have 2 options to measure the EMG signals, either using the gel electrodes or 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. -.. image:: media/candy-emg.* +.. figure:: media/candy-emg.* - **Using Muscle BioAmp Band:** @@ -178,7 +178,7 @@ Visualizing the EMG signals Now flex your arm to visualize the muscle signals in real time on your laptop. -.. image:: media/using-candy.* +.. figure:: media/using-candy.* **Video tutorial:** diff --git a/_sources/hardware/bioamp/muscle-bioamp-patchy/index.rst b/_sources/hardware/bioamp/muscle-bioamp-patchy/index.rst index 4d5247a7..38e9b29b 100644 --- a/_sources/hardware/bioamp/muscle-bioamp-patchy/index.rst +++ b/_sources/hardware/bioamp/muscle-bioamp-patchy/index.rst @@ -69,7 +69,7 @@ Images below shows a quick overview of the hardware design. Contents of the kit ******************** -.. image:: media/kit-contents.* +.. figure:: media/kit-contents.* We have made a complete unboxing video of the kit. Please find the link below: @@ -82,7 +82,7 @@ Software requirements Before you start using the kit, please download `Arduino IDE v1.8.19 (legacy IDE) `_. Using this you'll be able to upload the arduino sketches on your development board and visualise the data on your laptop. -.. image:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.png +.. figure:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.png Using the kit **************** @@ -92,14 +92,14 @@ Step 1: Connect reference cable Connect the reference cable to the Muscle BioAmp Patchy as shown in the diagram. -.. image:: media/ref-cable-connection.* +.. figure:: media/ref-cable-connection.* Step 2: Connecting sensor to gel electrodes ================================================ Snap the Muscle BioAmp Patchy on the gel electrodes (Don't peel the plastic backing from the electrodes at this moment). -.. image:: media/patchy-electrode-connection.* +.. figure:: media/patchy-electrode-connection.* :width: 80% :align: center @@ -115,7 +115,7 @@ Step 4: Electrode Placements Now peel off the plastic backing from the gel electrodes and place the Muscle BioAmp Patchy on the targeted muscle and the reference on the bony part of your elbow as shown in the diagram. -.. image:: media/patchy-on-hand.* +.. figure:: media/patchy-on-hand.* .. note:: In this demonstration we are recording EMG signals from the ulnar nerve, but you can record EMG from other areas as well (biceps, triceps, legs, jaw etc) as per your project requirements. Just make sure to place the IN+, IN- electrodes on the targeted muscle and REF on a bony part. @@ -124,7 +124,7 @@ Step 5: Connect Arduino UNO R3 Connect ``VCC`` to ``5V``, ``GND`` to ``GND``, and ``OUT`` to ``Analog pin A0`` of your Arduino UNO via jumper cables provided by us. If you are connecting ``OUT`` to any other analog pin, then you will have to change the INPUT PIN in the arduino sketch accordingly. -.. image:: media/pathcy-arduino-connections.* +.. figure:: media/pathcy-arduino-connections.* .. note:: For demonstration purposes we are showing connections of the sensor with Arduino UNO R3 but you can use any other development board or a standalone ADC of your choice. @@ -137,7 +137,7 @@ EMG Filter: https://github.com/upsidedownlabs/Muscle-BioAmp-Arduino-Firmware/blo EMG Envelope: https://github.com/upsidedownlabs/Muscle-BioAmp-Arduino-Firmware/blob/main/3_EMGEnvelope/3_EMGEnvelope.ino -.. image:: media/setup.* +.. figure:: media/setup.* Go to ``tools`` from the menu bar, select ``board`` option then select Arduino UNO. In the same menu, select the COM port on which your Arduino Uno is connected. To find out the right COM port, @@ -154,7 +154,7 @@ Step 7: Visualizing the EMG signals Now flex your arm to visualize the muscle signals in real-time on your laptop. -.. image:: media/patchy-emg.* +.. figure:: media/patchy-emg.* **Video tutorial:** diff --git a/_sources/hardware/bioamp/muscle-bioamp-shield/index.rst b/_sources/hardware/bioamp/muscle-bioamp-shield/index.rst index f101e335..908ebcb5 100644 --- a/_sources/hardware/bioamp/muscle-bioamp-shield/index.rst +++ b/_sources/hardware/bioamp/muscle-bioamp-shield/index.rst @@ -13,7 +13,8 @@ BackYard Brains (BYB) `Muscle Spiker shield `_. Using this you'll be able to upload the arduino sketches on your development board and visualise the data on your laptop. -.. image:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.png - -Assembling the Kit -******************** +.. figure:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.* + :align: center -You can get your own Muscle BioAmp Shield bag of parts from our `online stores `_ (shipping worldwide) -and for assembling your shield you can take a look at `this interactive BOM `_ or the step by step guide below. + Download Arduino IDE v1.8.19 -.. note:: Follow the highlighted yellow shapes to assemble your shield! +.. only:: html -.. grid:: 1 1 2 2 - :margin: 2 2 0 0 - :gutter: 2 + Assembling the Kit + ******************** - .. grid-item:: - - .. figure:: media/Assembly/01_Bare_Board.* + You can get your own Muscle BioAmp Shield bag of parts from our `online stores `_ (shipping worldwide) + and for assembling your shield you can take a look at `this interactive BOM `_ or the step by step guide below. - **Step 1 - Bare Board** + .. note:: Follow the highlighted yellow shapes to assemble your shield! - .. grid-item:: + .. grid:: 1 1 2 2 + :margin: 2 2 0 0 + :gutter: 2 - .. figure:: media/Assembly/02_1M_Resistors.jpg + .. grid-item:: - **Step 2 - 1M Resistors** + .. figure:: media/Assembly/01_Bare_Board.* + + **Step 1 - Bare Board** + + .. grid-item:: + + .. figure:: media/Assembly/02_1M_Resistors.jpg + + **Step 2 - 1M Resistors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/03_330R_Resistors.jpg + .. figure:: media/Assembly/03_330R_Resistors.jpg - **Step 3 - 330R Resistors** + **Step 3 - 330R Resistors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/04_10K_Resistors.jpg + .. figure:: media/Assembly/04_10K_Resistors.jpg - **Step 4 - 10K Resistors** + **Step 4 - 10K Resistors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/05_22K_Resistors.jpg + .. figure:: media/Assembly/05_22K_Resistors.jpg - **Step 5 - 22K Resistors** + **Step 5 - 22K Resistors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/06_1K_Resistors.jpg + .. figure:: media/Assembly/06_1K_Resistors.jpg - **Step 6 - 1K Resistors** + **Step 6 - 1K Resistors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/07_220K_Resistors.jpg + .. figure:: media/Assembly/07_220K_Resistors.jpg - **Step 7 - 220K Resistors** + **Step 7 - 220K Resistors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/08_1nF_Capacitors.jpg + .. figure:: media/Assembly/08_1nF_Capacitors.jpg - **Step 8 - 1nF Capacitors** + **Step 8 - 1nF Capacitors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/09_100nF_Capacitors.jpg + .. figure:: media/Assembly/09_100nF_Capacitors.jpg - **Step 9 - 100nF Capacitors** + **Step 9 - 100nF Capacitors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/10_100pF_Capacitors.jpg + .. figure:: media/Assembly/10_100pF_Capacitors.jpg - **Step 10 - 100pF Capacitors** + **Step 10 - 100pF Capacitors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/11_Angled_Header_Pins.jpg + .. figure:: media/Assembly/11_Angled_Header_Pins.jpg - **Step 11 - Angled Header Pins** + **Step 11 - Angled Header Pins** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/12_5x5mm_Buttons.jpg + .. figure:: media/Assembly/12_5x5mm_Buttons.jpg - **Step 12 - 5x5mm Buttons** + **Step 12 - 5x5mm Buttons** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/13_OptoIsolator.jpg + .. figure:: media/Assembly/13_OptoIsolator.jpg - **Step 13 - OptoIsolator** + **Step 13 - OptoIsolator** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/14_JST_PH_Angled_Connectors.jpg + .. figure:: media/Assembly/14_JST_PH_Angled_Connectors.jpg - **Step 14 - JST PH Angled Connectors** + **Step 14 - JST PH Angled Connectors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/15_JST_PH_Straight_Connectors.jpg + .. figure:: media/Assembly/15_JST_PH_Straight_Connectors.jpg - **Step 15 - JST PH Straight Connectors** + **Step 15 - JST PH Straight Connectors** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/16_IC_Socket.jpg + .. figure:: media/Assembly/16_IC_Socket.jpg - **Step 16 - IC Socket** + **Step 16 - IC Socket** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/17_IC.jpg + .. figure:: media/Assembly/17_IC.jpg - **Step 17 - IC** + **Step 17 - IC** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/18_LEDs.jpg + .. figure:: media/Assembly/18_LEDs.jpg - **Step 18 - LEDs** + **Step 18 - LEDs** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/19_3.5mm_Headphone_Jack.jpg + .. figure:: media/Assembly/19_3.5mm_Headphone_Jack.jpg - **Step 19 - 3.5mm Headphone Jack** + **Step 19 - 3.5mm Headphone Jack** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/20_2.2uF_Capacitor.jpg + .. figure:: media/Assembly/20_2.2uF_Capacitor.jpg - **Step 20 - 2.2uF Capacitor** + **Step 20 - 2.2uF Capacitor** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/21_1uF_Capacitor.jpg + .. figure:: media/Assembly/21_1uF_Capacitor.jpg - **Step 21 - 1uF Capacitor** + **Step 21 - 1uF Capacitor** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/22_470uF_Capacitor.jpg + .. figure:: media/Assembly/22_470uF_Capacitor.jpg - **Step 22 - 470uF Capacitor** + **Step 22 - 470uF Capacitor** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/23_Header_Pins.jpg + .. figure:: media/Assembly/23_Header_Pins.jpg - **Step 23 - Header Pins** + **Step 23 - Header Pins** - .. grid-item:: + .. grid-item:: - .. figure:: media/Assembly/24_Assembled.jpg + .. figure:: media/Assembly/24_Assembled.jpg - **Step 24 - Assembled Shield** + **Step 24 - Assembled Shield** -Still can't figure out the assembly? You can follow the video provided below to assemble your Shield. + Still can't figure out the assembly? You can follow the video provided below to assemble your Shield. -.. youtube:: dcuCihh3yn4 - :width: 100% + .. youtube:: dcuCihh3yn4 + :width: 100% Using the Sensor ****************** @@ -288,7 +318,7 @@ Stack the Muscle BioAmp Shield on top of Arduino Uno properly. .. only:: html - .. figure:: media/gifs/shield-arduino-connection.gif + .. figure:: media/gifs/shield-arduino-connection.* :align: center .. only:: latex @@ -303,7 +333,7 @@ Connect the BioAmp Cable to Muscle BioAmp Shield as shown. .. only:: html - .. figure:: media/gifs/electrode-cable-connection.gif + .. figure:: media/gifs/electrode-cable-connection.* :align: center .. only:: latex @@ -340,20 +370,26 @@ Using gel electrodes .. figure:: media/images/electrode-placement-1.* :align: center + `Electrode placement for REF cable` + .. figure:: media/images/electrode-placement-2.* :align: center + `Electrode placement for IN+, IN- cables` + Using Muscle BioAmp Band --------------------------- 1. Connect the BioAmp cable to Muscle BioAmp Band in a way such that IN+ and IN- are placed on the arm near the ulnar nerve & REF (reference) on the far side of the band. 2. Now put a small drop of electrode gel between the skin and metallic part of BioAmp cable to get the best results. +.. tip:: Visit the complete documentation on how to :ref:`assemble and use the BioAmp Bands ` or follow the youtube video given below. + **Tutorial on how to use the band:** -.. youtube:: xYZdw0aesa0 - :align: center - :width: 100% + .. youtube:: xYZdw0aesa0 + :align: center + :width: 100% .. note:: In this demonstration we are recording EMG signals from the ulnar nerve, but you can record EMG from other areas as well (biceps, triceps, legs, jaw etc) as per your project requirements. Just make sure to place the IN+, IN- electrodes on the targeted muscle and REF on a bony part. @@ -371,9 +407,11 @@ Connect your Arduino UNO R3 to your laptop using the USB cable (Type A to Type B .. figure:: media/images/arduino-laptop-connection-1.* :align: center + :width: 50% .. figure:: media/images/arduino-laptop-connection-2.* - :align: center + :align: center + :width: 50% .. warning:: Make sure your laptop is not connected to a charger and sit 5m away from any AC appliances for best signal acquisition. @@ -382,9 +420,9 @@ Step 6: Visualise EMG signals on laptop Copy paste any one of the arduino sketches given below in Arduino IDE v1.8.19 that you downloaded earlier: - EMG Filter: https://github.com/upsidedownlabs/Muscle-BioAmp-Arduino-Firmware/blob/main/2_EMGFilter/2_EMGFilter.ino +:fab:`github;pst-color-primary` `EMG Filter `_ - EMG Envelope: https://github.com/upsidedownlabs/Muscle-BioAmp-Arduino-Firmware/blob/main/3_EMGEnvelope/3_EMGEnvelope.ino +:fab:`github;pst-color-primary` `EMG Envelope `_ Go to ``tools`` from the menu bar, select ``board`` option then select Arduino UNO. In the same menu, select the COM port on which your Arduino Uno is connected. To find out the right COM port, @@ -406,12 +444,14 @@ Now flex your arm to visualize the muscle signals in real time on your laptop. .. figure:: media/images/visualise-emg.* :align: center + `Visualise EMG signals on laptop` + 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 +:fab:`github;pst-color-primary` `LED Bar Graph `_ 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. @@ -425,6 +465,8 @@ Make sure you have selected the right board and COM port. Now upload the code, a .. figure:: media/images/led-graph.* :align: center + `Visualise EMG signals on LEDs` + Step 8: Listen to your EMG signals ==================================== @@ -447,6 +489,8 @@ Listening EMG on speakers .. figure:: media/images/listening-emg-speakers.* :align: center + Listening EMG on speakers + Listening EMG on a wired earphones/headphones ---------------------------------------------- @@ -464,6 +508,8 @@ Listening EMG on a wired earphones/headphones .. figure:: media/images/listening-emg-earphones.* :align: center + `Listening EMG on a wired earphones/headphones` + Step 9: Controlling a servo motor =================================== @@ -471,7 +517,7 @@ 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 +:fab:`github;pst-color-primary` `Servo Controller `_ 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. @@ -487,7 +533,7 @@ Connect the servo claw to Muscle BioAmp Shield. Copy paste the Arduino Sketch given below in Arduino IDE: - Claw Controller: https://github.com/upsidedownlabs/Muscle-BioAmp-Arduino-Firmware/tree/main/4_ClawController +:fab:`github;pst-color-primary` `Claw Controller `_ 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. diff --git a/_sources/index.rst b/_sources/index.rst index baa3f44c..db0c6c90 100644 --- a/_sources/index.rst +++ b/_sources/index.rst @@ -39,7 +39,7 @@ that you can use with our hardware. .. grid-item:: .. card:: - :link: muscle_bioamp-biscute + :link: muscle-bioamp-biscute :link-type: ref :img-top: media/muscle-bioamp-biscute.* :img-alt: @@ -143,4 +143,11 @@ that you can use with our hardware. :maxdepth: 1 :caption: Guides - guides/index \ No newline at end of file + guides/index + +.. toctree:: + :hidden: + :maxdepth: 1 + :caption: Courses + + courses/index \ No newline at end of file diff --git a/_sources/kits/diy-neuroscience/basic/index.rst b/_sources/kits/diy-neuroscience/basic/index.rst index 66fc290e..40c8ed69 100644 --- a/_sources/kits/diy-neuroscience/basic/index.rst +++ b/_sources/kits/diy-neuroscience/basic/index.rst @@ -34,11 +34,11 @@ Software requirements - Before you start using the kit, please download `Arduino IDE v1.8.19 (legacy IDE) `_. Using this you'll be able to upload the arduino sketches in Maker UNO and visualise the data on your laptop. -.. image:: media/arduino-ide.* +.. figure:: media/arduino-ide.* - Download Backyard Brains' `Spike Recorder `_ according to the operating system you are using (Windows, OSX, Linux). -.. image:: media/byb.* +.. figure:: media/byb.* Using the kit ************** @@ -48,7 +48,7 @@ This kit is made in a way so that even beginners can use it and get started with Step 1 (optional): Configure for EMG/ECG ========================================= -.. image:: media/configuration-emg-ecg.* +.. figure:: media/configuration-emg-ecg.* BioAmp EXG Pill is by default configured for recording EEG or EOG, so if you are recording any of the two signals you can skip this step. But if you want to record good quality ECG or EMG, then it is recommended to configure it @@ -59,7 +59,7 @@ by making a solder joint as shown in the image above. Step 2: Connect Maker UNO ========================== -.. image:: media/connection-with-maker-uno.* +.. figure:: media/connection-with-maker-uno.* Connect ``VCC`` to ``5V``, ``GND`` to ``GND``, and ``OUT`` to ``Analog pin A0`` of your Maker UNO via jumper cables provided by us. If you are connecting OUT to any other analog pin, then you will have to change the INPUT PIN in the arduino sketch accordingly. @@ -68,7 +68,7 @@ Connect ``VCC`` to ``5V``, ``GND`` to ``GND``, and ``OUT`` to ``Analog pin A0`` Step 3: Connecting electrode cable =============================================== -.. image:: media/bioamp-cable.* +.. figure:: media/bioamp-cable.* Connect the BioAmp cable to BioAmp EXG Pill by inserting the cable end in the JST PH connector as shown above. @@ -93,7 +93,7 @@ We have 2 options to measure the EMG signals, either using the gel electrodes or 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. -.. image:: media/emg.* +.. figure:: media/emg.* - **Using Muscle BioAmp Band:** @@ -132,7 +132,7 @@ Visualizing the EMG signals Now flex your arm to visualize the muscle signals in real time on your laptop. -.. image:: media/EMGEnvelop.* +.. figure:: media/EMGEnvelop.* Step 6: Measuring ECG (ElectroCardioGraphy) =============================================== @@ -148,7 +148,7 @@ We have 2 options to measure the ECG signals, either using the gel electrodes or 2. Peel the plastic backing from electrodes 3. Place the IN- cable on the left side, IN+ in the middle and REF (reference) on the far right side as shown in the diagram. -.. image:: media/ecg.* +.. figure:: media/ecg.* - **Using Heart BioAmp Band:** @@ -182,7 +182,7 @@ After opening the serial plotter make sure to select the baud rate to 115200. Visualizing the ECG signals ----------------------------- -.. image:: media/bioamp-Exg-Pill-ECG.* +.. figure:: media/bioamp-Exg-Pill-ECG.* Step 7: Measuring EOG (ElectroOculoGraphy) ============================================= @@ -194,7 +194,7 @@ We have 2 ways to measure the EOG signals, either record the horizontal eye move - **Horizontal EOG recording:** -.. image:: media/eog-horizontal.* +.. figure:: media/eog-horizontal.* 1. Connect the BioAmp cable to gel electrodes. 2. Peel the plastic backing from electrodes. @@ -202,7 +202,7 @@ We have 2 ways to measure the EOG signals, either record the horizontal eye move - **Vertical EOG recording:** -.. image:: media/eog-vertical.* +.. figure:: media/eog-vertical.* 1. Connect the BioAmp cable to gel electrodes. 2. Peel the plastic backing from electrodes. @@ -228,7 +228,7 @@ After opening the serial plotter make sure to select the baud rate to 115200. Visualizing the EOG signals ------------------------------ -.. image:: media/bioamp-exg-pill-eog.* +.. figure:: media/bioamp-exg-pill-eog.* Step 8: Measuring EEG (ElectroEncephaloGraphy) =============================================== @@ -236,7 +236,7 @@ Step 8: Measuring EEG (ElectroEncephaloGraphy) Let's understand the electrode placements before moving forward in this project. For recording EEG from different parts of the brain, you have to place the electrodes according to the `International 10-20 system for recording EEG `_. -.. image:: media/10-20-system.* +.. figure:: media/10-20-system.* :width: 80% Electrodes placement @@ -246,7 +246,7 @@ We have 2 options to measure the EEG signals, either using the gel electrodes or - **Using gel electrodes to record from prefrontal cortex part of brain:** -.. image:: media/eeg.* +.. figure:: media/eeg.* 1. Connect the BioAmp cable to gel electrodes. 2. Peel the plastic backing from electrodes. diff --git a/_sources/kits/diy-neuroscience/pro/index.rst b/_sources/kits/diy-neuroscience/pro/index.rst index 813f34a7..2c5399bc 100644 --- a/_sources/kits/diy-neuroscience/pro/index.rst +++ b/_sources/kits/diy-neuroscience/pro/index.rst @@ -12,6 +12,8 @@ applications, and gain valuable insights. .. figure:: media/diy-neuroscience-kit-pro.* :align: center + DIY Neuroscience Kit Pro + Contents of the kit ******************** @@ -45,6 +47,8 @@ Contents of the kit .. figure:: media/kit-content.* :align: center +Click on the link below to see the unboxing of the kit: + .. youtube:: Sn389Q7Izy4 :width: 100% :align: center @@ -62,7 +66,7 @@ Download the following according to the operating system you are using (Windows, - `Arduino IDE v1.8.19 (legacy IDE) `_ -.. image:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.* +.. figure:: ../../../kits/diy-neuroscience/basic/media/arduino-ide.* Using the kit ************** @@ -84,7 +88,7 @@ just a few. It also works with any dedicated ADC, like the Texas Instruments ADS .. figure:: ../../../media/bioamp-exg-pill.* -.. note:: Checkout the complete documentation on `BioAmp EXG Pill `_ which includes how to use the sensor, record various biopotential signals from your body (ECG, EMG, EOG, EEG) and make different HCI/BCI projects using it. +.. note:: Checkout the complete documentation on :ref:`bioamp-exg-pill` which includes how to use the sensor, record various biopotential signals from your body (ECG, EMG, EOG, EEG) and make different HCI/BCI projects using it. Step 2: Using Muscle BioAmp Shield ======================================= @@ -96,7 +100,7 @@ signals to make amazing projects in the domain of Human-Computer Interface (HCI) .. figure:: ../../../media/muscle-bioamp-shield.* -.. note:: Checkout the complete documentation on `Muscle BioAmp Shield `_ which includes how to use the sensor, record/visualise/listen muscle signals and make different HCI projects using it. +.. note:: Checkout the complete documentation on :ref:`muscle-bioamp-shield` which includes how to use the sensor, record/visualise/listen muscle signals and make different HCI projects using it. Step 3: Using the sensors together ====================================== @@ -112,14 +116,16 @@ a. Connecting Muscle BioAmp Shield to MCU/ADC Stack the Muscle BioAmp Shield on top of your Arduino Uno properly. -.. only:: html +.. only:: latex - .. figure:: ../../../hardware/bioamp/muscle-bioamp-shield/media/gifs/shield-arduino-connection.gif + .. figure:: ../../../hardware/bioamp/muscle-bioamp-shield/media/images/shield-arduino-connection.* :align: center -.. only:: latex + Stacking Muscle BioAmp Shield on top of Arduino - .. figure:: ../../../hardware/bioamp/muscle-bioamp-shield/media/images/shield-arduino-connection.* +.. only:: html + + .. figure:: ../../../hardware/bioamp/muscle-bioamp-shield/media/gifs/shield-arduino-connection.gif :align: center b. Configure for ECG/EMG (optional) @@ -130,8 +136,9 @@ BioAmp EXG Pill is by default configured for recording EEG or EOG but if you wan .. figure:: ../../../hardware/bioamp/bioamp-exg-pill/media/assembly-step2.* :align: center -.. note:: Even without making the solder joint the BioAmp EXG Pill is capable of recording ECG or EMG but the signals would be more accurate if you configure it. + Configure BioAmp EXG Pill for EMG/ECG +.. note:: Even without making the solder joint the BioAmp EXG Pill is capable of recording ECG or EMG but the signals would be more accurate if you configure it. c. Connecting sensors together -------------------------------------- @@ -148,16 +155,39 @@ Connect the BioAmp EXG Pill to the A2 port of Muscle BioAmp Shield via 3-pin STE | A2 | OUT | +----------------------+-----------------+ -.. figure:: media/gifs/shield-pill-connection.* - :align: center +.. only:: latex + + .. figure:: media/images/shield-pill-connection.* + :align: center + + Inserting JST PH connector in A2 port of Muscle BioAmp Shield + + .. figure:: media/images/shield-pill-connection-2.* + :align: center + + Muscle BioAmp Shield to BioAmp EXG Pill connections + +.. only:: html + + .. figure:: media/gifs/shield-pill-connection.* + :align: center d. Connecting electrode cables -------------------------------- Connect one BioAmp cable to BioAmp EXG Pill and another BioAmp cable to Muscle BioAmp Shield by inserting the cable ends into the respective JST PH connectors as shown below: -.. figure:: media/gifs/bioamp-cables-connection.* - :align: center +.. only:: html + + .. figure:: media/gifs/bioamp-cables-connection.* + :align: center + +.. only:: latex + + .. figure:: media/images/bioamp-cables-connection.* + :align: center + + Connecting BioAmp Cables to the sensors e. Skin Preparation --------------------------- @@ -166,7 +196,7 @@ We'll create a 2-channel EMG acquisition system and to do so, we'll be using bot Apply Nuprep Skin Preparation Gel on the skin surface where electrodes would be placed to remove dead skin cells and clean the skin from dirt. After rubbing the skin surface thoroughly, clean it with an alcohol wipe or a wet wipe. -For more information, please check out detailed step by step `skin preparation guide `_. +For more information, please check out detailed step by step :ref:`skin-preparation`. f. Electrodes placement ------------------------- @@ -180,36 +210,60 @@ Using gel electrodes 2. Peel the plastic backing from electrodes. 3. Place the IN+ and IN- cables on the left arm near the ulnar nerve & REF (reference) at the back of your left hand as shown below. -.. figure:: media/gifs/gel-electrodes-connection.* - :align: center +.. only:: html + + .. figure:: media/gifs/gel-electrodes-connection.* + :align: center 4. Now snap the BioAmp Cable connected to Muscle BioAmp Shield to gel electrodes. 5. Peel the plastic backing from electrodes. 6. Place the IN+ and IN- cables on the right arm near the ulnar nerve & REF (reference) at the back of your right hand as shown below. -.. figure:: media/gifs/gel-electrodes-connection-2.* - :align: center +.. only:: html + + .. figure:: media/gifs/gel-electrodes-connection-2.* + :align: center + +.. only:: latex + + .. figure:: media/images/gel-electrodes-connection.* + :align: center + + Gel electrodes placement Using Muscle BioAmp Band +++++++++++++++++++++++++ 1. Snap the BioAmp Cable connected to BioAmp EXG Pill on Muscle BioAmp Band in a way such that IN+ and IN- are placed on the left arm near the ulnar nerve & REF (reference) on the far side of the band. -.. figure:: media/gifs/bioamp-band-connection-2.* - :align: center +.. only:: html + + .. figure:: media/gifs/bioamp-band-connection-2.* + :align: center 2. Snap the BioAmp Cable connected to Muscle BioAmp Shield on Muscle BioAmp Band in a way such that IN+ and IN- are placed on the right arm near the ulnar nerve & REF (reference) on the far side of the band. -.. figure:: media/gifs/bioamp-band-connection.* - :align: center +.. only:: html + + .. figure:: media/gifs/bioamp-band-connection.* + :align: center + +.. only:: latex + + .. figure:: media/images/bioamp-band-connection.* + :align: center + + Muscle BioAmp Band placement 3. Now put a small drop of electrode gel between the skin and metallic parts of BioAmp Cables to get the best results. +.. tip:: Visit the complete documentation on how to :ref:`assemble and use the BioAmp Bands ` or follow the youtube video given below. + **Tutorial on how to use the band:** -.. youtube:: xYZdw0aesa0 - :align: center - :width: 100% + .. youtube:: xYZdw0aesa0 + :align: center + :width: 100% .. note:: In this demonstration we are recording EMG signals from the ulnar nerve, but you can record EMG from other areas as well (biceps, triceps, legs, jaw etc) as per your project requirements. Just make sure to place the IN+, IN- electrodes on the targeted muscle and REF on a bony part. @@ -217,8 +271,8 @@ g. Uploading the code ---------------------- Connect Arduino Uno to your laptop using the USB cable (Type A to Type B). Download the github repository given below: - -Muscle BioAmp Arduino Firmware: https://github.com/upsidedownlabs/Muscle-BioAmp-Arduino-Firmware/ + +:fab:`github;pst-color-primary` `Muscle BioAmp Arduino Firmware `_ Go to the folder ``8_EMGScrolling``, open the arduino sketch ``8_EMGScrolling.ino`` in Arduino IDE. @@ -236,13 +290,42 @@ Go to ``tools`` from the menu bar, click on ``serial monitor`` to open it or cli Press the ``SW1 button`` on Muscle BioAmp Shield. Now you'll see green LED glowing on the LED bar. When you flex your right arm, you'll get output value 1 on the serial monitor and red LED will glow. Similarly, when you flex your left arm, you'll get output value 2 and yellow LED will glow. -.. figure:: media/gifs/testing.* - :align: center +.. only:: html + + .. figure:: media/gifs/testing.* + :align: center + +.. only:: latex + + .. figure:: media/images/testing-1.* + :align: center + + Press the SW1 button to start getting the output + + .. figure:: media/images/testing-2.* + :align: center + + Flex the right arm, red LED glows + + .. figure:: media/images/testing-3.* + :align: center + + Flex the left arm, yellow LED glows + + .. figure:: media/images/testing-4.* + :align: center + + Flex the right arm, serial monitor shows output value 1 + + .. figure:: media/images/testing-5.* + :align: center + + Flex the left arm, serial monitor shows output value 2 i. Running python script ------------------------- -Open Visual Studio Code, click on File < Open folder to open the folder ``8_EMGScrolling``. +Open Visual Studio Code, click on File > Open folder to open the folder ``8_EMGScrolling``. Open the terminal, and ensure that the path is configured to the location of the ``requirement.txt`` file. @@ -269,15 +352,26 @@ Run the Python script ``EMG_Scroll.py`` by writing the given command in the term j. Scrolling using EMG signals --------------------------------- +Press the ``SW1 button`` on Muscle BioAmp Shield again. + In the terminal, you will see Move Now prompt. When you flex your right arm, you'll see UP in the terminal. Similarly, when you move your left arm, you'll see DOWN in the terminal. -.. figure:: media/gifs/demo-1.* - :align: center +.. only:: html + + .. figure:: media/gifs/demo-1.* + :align: center + +.. only:: latex + + .. figure:: media/images/demo-1.* + :align: center Now, open youtube shorts on your laptop and start scrolling using your muscle signals. -.. figure:: media/gifs/demo-2.* - :align: center +.. only:: html + + .. figure:: media/gifs/demo-2.* + :align: center .. note:: What's happening in the background? Whenever an EMG signal is detected, it acts as a trigger to emulate UP or DOWN key on the keyboard. @@ -286,7 +380,7 @@ k. Calibrating the code **Changes in Arduino Sketch** -Modify the threshold values on lines 73 and 74. Threshold 1 is for the EMG signals recorded from the Muscle BioAmp Shield, and threshold 2 is for the EMG signals recorded from the BioAmp EXG Pill. +Modify the threshold values on **lines 73 and 74**. Threshold 1 is for the EMG signals recorded from the Muscle BioAmp Shield, and threshold 2 is for the EMG signals recorded from the BioAmp EXG Pill. Uncomment line 71 in the Arduino code and navigate to Tools > Serial Plotter. You’ll see two plots showing the EMG signals of both of your arms. Flex your right arm and observe the peak value on the y-axis. If the peak value is around 240, you can set threshold 1 anywhere between 150 to 200. The lower the threshold value, the easier it is to trigger the output as UP or DOWN, and vice versa. Repeat the process to determine the threshold 2 value for your left arm. @@ -294,7 +388,7 @@ After setting the thresholds, comment out line 71. **Changes in Python script** -Adjust the latency value on line 51. A higher latency value will make the output less responsive, requiring you to flex and hold longer to scroll through the screen. A lower latency value will make the output more responsive, allowing you to scroll through the screen more easily. +Adjust the latency value on **line 51**. A higher latency value will make the output less responsive, requiring you to flex and hold longer to scroll through the screen. A lower latency value will make the output more responsive, allowing you to scroll through the screen more easily. l. Conclusion ----------------- @@ -365,7 +459,7 @@ Some project ideas :text-align: center :link: https://www.instructables.com/Tracking-UP-and-DOWN-Movements-of-Eyes-Using-EOG/ - 2. Projects made using Muscle BioAmp Shield + 1. Projects made using Muscle BioAmp Shield ============================================= .. grid:: 2 2 2 2 @@ -392,7 +486,7 @@ Some project ideas :text-align: center :link: https://www.instructables.com/Making-a-Muscle-Strength-Game-Using-Muscle-BioAmp-/ - 3. Projects made using the sensors together + 1. Projects made using the sensors together ============================================== .. grid:: 2 2 2 2 @@ -410,3 +504,39 @@ Some project ideas These are some of the project ideas but the possibilities are endless. So create your own Human Computer Interface (HCI) and Brain Computer Interface (BCI) projects and share them with us at contact@upsidedownlabs.tech. +.. only:: latex + + You can find step-by-step tutorials for various HCI/BCI projects on our `Instructables `_. + + Projects made using BioAmp EXG Pill + ==================================== + + 1. `Controlling video game using brainwaves (EEG) `_ + 2. `Visualising electrical impulses from eyes (EOG) `_ + 3. `Recording EEG from visual cortex part of brain `_ + 4. `Recording EEG from prefrontal cortex part of brain `_ + 5. `Eye blink detection `_ + 6. `Creating a drowsiness detector `_ + 7. `Record publication-grade ECG `_ + 8. `Measuring heart rate `_ + 9. `Detecting heart beats `_ + 10. `Record publication-grade EMG `_ + 11. `Detecting up and down movement of eyes `_ + + Projects made using Muscle BioAmp Shield + =========================================== + + 1. `Record, visualise, and listen to EMG signals `_ + 2. `Controlling 3d-printed servo claw using EMG `_ + 3. `Controlling prosthetic hand using EMG `_ + 4. `Building the ultimate servo claw game `_ + 5. `Building muscle strength game `_ + + Projects made using the sensors together + ============================================ + + 1. `Control dino game using eye blinks `_ + 2. `Control servo claw using EOG `_ + + These are some of the project ideas but the possibilities are endless. So create your own Human Computer Interface (HCI) and + Brain Computer Interface (BCI) projects and share them with us at contact@upsidedownlabs.tech \ No newline at end of file diff --git a/_static/latex/bioamp-exg-pill.rst b/_static/latex/bioamp-exg-pill.rst new file mode 100644 index 00000000..6ed1eb02 --- /dev/null +++ b/_static/latex/bioamp-exg-pill.rst @@ -0,0 +1,19 @@ +:orphan: + +.. _bioamp-exg-pill-datasheet: + +BioAmp EXG Pill +############### + +.. toctree:: + :hidden: + :maxdepth: 3 + + ../../../hardware/bioamp/bioamp-exg-pill/index + + +.. toctree:: + :hidden: + :maxdepth: 3 + + ../../../guides/usage-guides/skin-preparation/index.rst diff --git a/_static/latex/diy-neuroscience-kit-pro.rst b/_static/latex/diy-neuroscience-kit-pro.rst new file mode 100644 index 00000000..aacf8a52 --- /dev/null +++ b/_static/latex/diy-neuroscience-kit-pro.rst @@ -0,0 +1,41 @@ +:orphan: + +.. _diy-neuroscience-kit-pro-datasheet: + +DIY Neuroscience Kit Pro +######################### + +.. toctree:: + :hidden: + :maxdepth: 4 + + ../../../kits/diy-neuroscience/pro/index + + +.. toctree:: + :hidden: + :maxdepth: 3 + + ../../../hardware/bioamp/bioamp-exg-pill/index.rst + + +.. toctree:: + :hidden: + :maxdepth: 3 + + ../../../hardware/bioamp/muscle-bioamp-shield/index.rst + + +.. toctree:: + :hidden: + :maxdepth: 3 + + ../../../guides/usage-guides/skin-preparation/index.rst + +.. toctree:: + :hidden: + :maxdepth: 3 + + ../../../guides/usage-guides/using-bioamp-bands/index.rst + + diff --git a/_static/latex/muscle-bioamp-shield.rst b/_static/latex/muscle-bioamp-shield.rst new file mode 100644 index 00000000..6c15f330 --- /dev/null +++ b/_static/latex/muscle-bioamp-shield.rst @@ -0,0 +1,18 @@ +:orphan: + +.. _muscle-bioamp-shield-datasheet: + +Muscle BioAmp Shield +######################### + +.. toctree:: + :hidden: + :maxdepth: 3 + + ../../../hardware/bioamp/muscle-bioamp-shield/index + +.. toctree:: + :hidden: + :maxdepth: 3 + + ../../../guides/usage-guides/skin-preparation/index.rst \ No newline at end of file diff --git a/bioamp-exg-pill.html b/bioamp-exg-pill.html deleted file mode 100644 index 59b0c45f..00000000 --- a/bioamp-exg-pill.html +++ /dev/null @@ -1,720 +0,0 @@ - - - - - - - - - - - BioAmp EXG Pill — upsidedownlabs.github.io documentation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - - - - - - - - - -
-
-
-
- - - Ctrl+K -
-
- - -
-
Welcome to Upside Down Labs docs site!
-
- - -
-
- - - -
- -
- - - -
- -
- -
- -
- -
-
- -
- - -
- -
- - - -
- - -
- -
- -
    -
  • - - - - - - - - - - - - GitHub -
    • -
  • - - - - - - - - - - - - Docs -
    • -
  • - - - - - - - - - - - - Discord -
    • -
  • - - - - - - - - - - - Instructables -
    • -
  • - - - - - - - - - - - Upside Down Labs -
    • -
- -
- -
- - -
- - -
- - - - - -
- -
- - -
-
- - - - - -
- - - -
- - -
- -
-
- -
- - - -
- -
- -
- -
    -
  • - - - - - - - - - - - - GitHub -
    • -
  • - - - - - - - - - - - - Docs -
    • -
  • - - - - - - - - - - - - Discord -
    • -
  • - - - - - - - - - - - Instructables -
    • -
  • - - - - - - - - - - - Upside Down Labs -
    • -
- -
- -
- - -
-
- - - - -
- -
- - -
-
- -
-
- -
- -
- - - - -
- -
- - -
-
- - - - - -
- -
-

BioAmp EXG Pill#

-
-
-
- - -
- - - - - -
- -
-
-
- -
- - - -
- - -
- - -
- - - - - - Edit on GitHub - - - -
-
- -
- -
- - Show Source - -
-
- -
- - -
-
- -
- -
-
-
- - - - - -
-
- -
- -
- -

- - © Copyright 2024, Upside Down Labs. -
- -

-
- -
- - - -
- -

- Last updated on Jun 28, 2024. -
-

- -
- -
- -
- - \ No newline at end of file diff --git a/bioamp-exg-pill.pdf b/bioamp-exg-pill.pdf deleted file mode 100644 index a1128ae4..00000000 Binary files a/bioamp-exg-pill.pdf and /dev/null differ diff --git a/bioamp-v1.5.pdf b/bioamp-v1.5.pdf deleted file mode 100644 index c8c69281..00000000 Binary files a/bioamp-v1.5.pdf and /dev/null differ diff --git a/diy-neuroscience-kit-pro.pdf b/diy-neuroscience-kit-pro.pdf new file mode 100644 index 00000000..9144aff8 Binary files /dev/null and b/diy-neuroscience-kit-pro.pdf differ diff --git a/experiments/index.html b/experiments/index.html index eb6667a7..071fa574 100644 --- a/experiments/index.html +++ b/experiments/index.html @@ -53,7 +53,7 @@ - + @@ -184,19 +184,19 @@ + +
  • + + DigiKey + +
    • +