Updated documentation.

Author: William Schumacher

README.md

@@ -10,7 +10,7 @@ Contributions by
 
 * Severin Lemaignan - Base C Library and mcrypt functionality
 * Sharif Olorin  (http://github.com/fractalcat) - hidapi support
-* Bill Schumacher (http://github.com/bschumacher) - Fixed the python library, well almost.
+* Bill Schumacher (http://github.com/bschumacher) - Fixed the Python library
 
 Description
 ===========
@@ -23,8 +23,6 @@ software), just the raw sensor data.
 The C library is backed by hidapi, and should work on any platform
 that hidapi also works on.
 
-The Python library is currently broken. Fix it!
-
 Information
 ===========
 
@@ -70,12 +68,19 @@ Python library
 --------------
 
   import emotiv
+
   headset = emotiv.Emotiv()
+
   try:
+
     while True:
+
       for packet in headset.dequeue():
+
         print packet.gyroX, packet.gyroY
+
   finally:
+
     headset.close()
 
 Platform Specifics Issues
@@ -90,6 +95,9 @@ for each. We've tried to cover both (as based on hidapi's example udev
 file), but your mileage may vary. If you have problems, please post
 them to the github issues page (http://github.com/openyou/emokit/issues).
 
+Your kernel may not support /dev/hidraw devices by default, such as an RPi. 
+To fix that re-comiple your kernel with /dev/hidraw support
+
 Credits - Cody
 ==============
 

doc/Announcement.md

@@ -15,7 +15,7 @@ The code is available on github on the [daeken/Emokit](http://github.com/daeken/
 Where things are right now
 ==========================
 
-You can access raw EEG data from the Emotiv EPOC on Windows, Linux, and OS X from Python.  While it's not known exactly which sensors are which in the data (read below for more info), it's close to being useful already.  Word of warning: this project is less than 48 hours old (I just got hardware in my hands Saturday night) and has only been run by me on Windows due to a dead Linux box.  It's very much alpha quality right now -- don't trust it.
+You can access raw EEG data from the Emotiv EPOC on Windows, Linux, and OS X from Python. Sensor locations can be found at https://github.com/bschumacher/emokit-1/wiki/Sensor-Locations.  Word of warning: this project is less than 48 hours old (I just got hardware in my hands Saturday night) and has only been run by me on Windows due to a dead Linux box.  It's very much alpha quality right now -- don't trust it.
 
 How it happened
 ===============

doc/emotiv_protocol.asciidoc

@@ -127,23 +127,23 @@ An Overview of the 256-bit Packet Layout:
 | 0:7   | Counter/Battery
 | 8:21  | F3 Data
 | 22:35 | FC5 Data
-| 36:49 | AF7 Data
+| 36:49 | AF3 Data
 | 50:63 | F7 Data
 | 64:77 | T7 Data
 | 78:91 | P7 Data
 | 92:105 | O1 Data
 | 107:120 | Connection Quality (Rotating)
-| 121:133 | TP7 Data
+| 121:133 | ?
 | 134:147 | O2 Data
 | 148:161 | P8 Data
 | 162:175 | T8 Data
 | 176:189 | F8 Data
-| 190:203 | AF8 Data
+| 190:203 | AF4 Data
 | 204:217 | FC6 Data
 | 218:231 | F4 Data
 | 233:239 | Gyro X
 | 240:247 | Gyro Y
-| 248:255 | TP8 Data
+| 248:255 | ?
 |=============================
 
 === Counter and Battery