Merge pull request #23 from cfausn/master

Added MyoWare Integration Tutorial
openbci-archive · Oct 5, 2016 · e51e510 · e51e510
2 parents 8a47182 + ad62b7c
commit e51e510
Show file tree

Hide file tree

Showing 5 changed files with 53 additions and 0 deletions.
diff --git a/assets/images/firing.png b/assets/images/firing.png
diff --git a/assets/images/myoware.jpg b/assets/images/myoware.jpg
diff --git a/assets/images/normalizing.png b/assets/images/normalizing.png
diff --git a/assets/images/rest.png b/assets/images/rest.png
diff --git a/tutorials/13-MyoWare_Integration.md b/tutorials/13-MyoWare_Integration.md
@@ -0,0 +1,53 @@
+# MyoWare OpenBCI Integration
+
+## I. Materials needed
+
+![MyoWare Board](../assets/images/myoware.jpg)
+
+1. MyoWare Board
+2. OpenBCI Board and power source
+3. OpenBCI Dongle
+4. Headers for soldering (similar to the headers we include in our boards [here](http://docs.openbci.com/tutorials/04-External_Trigger_8bit_Example)). I used male headers but you can use whichever you prefer.
+5. Jumper Wires (depending on which headers you use). At least 3 of these cables will need to have female ends and at least 2 will need male ends, the other vary depending on which headers you use.
+6. Soldering Iron and some rosin
+
+
+### 1. Soldering the MyoWare Headers
+
+In order to properly integrate the MyoWare with your OpenBCI board, we will need to get the output of each electrode attached to the myoware  board itself. To do this we will need to solder headers onto the R, E, and M parts of the board. 
+R is the reference electrode, the one with the wire. E is the end electrode, and M is the middle electrode. These two electrodes will measure activity across a muscle. 
+
+In addition to these electrode headers we will need to solder headers onto the areas that supply power to the MyoWare. In order to do this, simply solder two headers to the + and - parts of the board. This will be your ground and power supplied from the OpenBCI board.
+
+
+### 2. OpenBCI Headers
+![Board with Headers](../assets/images/8bit_w_Headers.jpg)
+If you have not already soldered your headers onto OpenBCI board, you should do so now. However if you'd prefer to minimize soldering, at least solder headers into the leftmost area of the board. We will be utilizing DVDD and GND right above the OpenBCI logo.
+
+
+### 3. Wiring 
+
+The wiring is very simple actually! All we need to do is connect the two electrode pins to an NXP input (I used N1P for this tutorial), and the reference to the bottom BIAS pin. For example:
+R (Myo)  -> BIAS(OBCI)
+M (Myo) -> N1P Bottom (OBCI)
+E (Myo) -> N1P Top (OBCI)
++ (Myo) -> DVDD (OBCI)
+- (Myo) -> GND (OBCI)
+
+While the M and E electrodes can be interchanged onto any of the NXP pins, the reference electrode will always need to stay on the bottom BIAS pin.
+
+When you have everything wired up, plug in your OpenBCI board and dongle, and turn everything on. Then open up the GUI and you can start coding!
+
+### 4. Using the GUI
+
+As the myoware is basically now a 3-electrode system, we can use it as such in the GUI! If you use the newest GUI version you can use the EMG widget to visualize this data:
+![Resting](../assets/images/rest.png)
+This should be the data at rest (before a muscle flex)
+
+![Firing](../assets/images/firing.png)
+Here is the data after a muscle is flexed
+
+![Normalizing](../assets/images/normalizing.png)
+And here it is as the muscle goes back to rest
+
+You can use these events to trigger analog or digital events from within the GUI as you like! Make sure to check out the `EMG_Widget.pde` file for a full description of how to do this.