Updated the README
[openmind.git] / README.md
blob5c504e25a98583eb17db89bb98258e4a9cca15bc
1 What is it?
2 -----------
3 OpenMind is a take on an open source electroencephalograph, i.e. a device to capture "brain waves" - the tiny electrical
4 signals your brain emits when working. By itself, the hardware can also be used as "just" a pretty high-resolution
5 albeit slow ADC to upgrade your arduino (imagine gaining 12 bits of resolution...). I suspect that the hardware should
6 also easily be sensible enough to directly measure muscle action potentials.
8 Introduction
9 ------------
10 This repository contains the third version of the hardware. This is a modular system: Each PCB can (depending on what
11 chip you put on it and what you want to do) measure signals on one or two channels with one (absolute) or two
12 (differential) electrodes each. The chips used are ADS129X, 24-bit ADCs with integrated AC hum filter and preamplifier
13 with differential inputs. The ADS1291 contains one, the ADS1292 two channels.
14 In a single-channel configuration one board is the digital equivalent of a conventional EEG's active electrode.
16 All these "digital active electrodes" can be connected on one SPI bus with one !CS-line per module - so a bunch of eight
17 of them can be controlled via three SPI pins and 8 !CS pins (which themselves can be multiplexed from three pins using a
18 small logic IC)
20 Files
21 -----
22  * `2ch-dual-shield` *recommended* A 2-channel Arduino shield which may be populated as an analog frontend for the Arduino's ADCs or (*recommended*) with an integrated analog frontend containing a 16- or 24-bit ADC.
23  * `4ch-1chip-minimal-breakout` A minimalist breakout board for a large (TQFP-64) 4-channel chip. The coax electrode cables are supposed to be soldered directly to the board.
24  * `4ch-dual-shield` A variant containing 4 differential channels which can be populated analog for use with the Arduino's ADC or with integrated TI frontends. This board became way too crowded, I recommend its successor, the 2-channel version.
25  * `active-electrode` An active electrode design small enough so the board *can be* the electrode. In this design, the analog frontend sits on the electrode so there are no analog connections leaving the board whatsoever (except for the analog power supply, that is).
26  * `analog-shield` A fully analog Arduino shield containing nil but 4 primitive differential amplifiers to connect 8 inputs to 4 adc channels of the Arduino.
27  * `libraries-and-stuff` Libraries used in the boards. As of now, not all required libs are included but just the ones I made myself. For the others I still have to sort out the licensing foo.
29 Electrode Connections
30 ---------------------
31 ### Electrode modes
32 In absolute mode you connect one electrode to each channel's positive (non-inverting) input, and connect the negative
33 (inverting) input to the reference signal (as denoted on the schematic/PCB).
34 In differential mode you connect one electrode to each of the two inputs of each channel and the device will measure the
35 potential between each pair.
37 ### Right-leg drive (RLD)
38 The RLD is an op-amp which is used to cancel out LF interference with the EEG signal. It works by continuously comparing
39 a reference potential (normally VDD/2) with an average of all electrode signals and driving a dedicated reference
40 electrode with the difference. This signal is very weak and thus not noticable except in the measurements.
41 Multiple devices can be cascaded by connecting their ``RLD_INV`` pins together and powering down all but one RLD. This
42 RLD's output signal is used to provide the reference voltage.
43 The active RLD can be selected at runtime, and you could even select the reference electrode at runtime from any
44 electrode connected to one of the inputs - sacrificing that one electrode.
46 ### Lead-off detection
47 The ADS12XX does contain a pretty neat lead-off-detection, which can be used to measure the connection of the electrode
48 to the skin and the connection of the RLD electrode to the skin. This could e.g. be used to signify the electrodes
49 connection status with the on-board LEDs.
51 Miscellaneous
52 -------------
53 The ``RLDIN/RLDREF`` signal can be routed to any of the device's electrodes (whatever that might be needed for) *and/or*
54 any of the ADC inputs - so you can connect some auxiliary signal to this pin and measure it with any ADC.
56 The pad on the bottom side of the board is intended to be used to surface-mount type 261k or 269k 9v battery connectors
57 (available at digikey). I did not yet physically check it, but I will as soon as I order at digikey.
59 To guarantee galvanic separation from mains potential and to improve the power supply noise floor for the ADCs I would
60 recommend using a battery (rechargeable or not), radioisotope thermoelectric (or other peltier), fuel cell or other
61 non-switching, off-grid power supply. Extra style points are given for the radioactive option.
63 Software/driver
64 ---------------
65 The interfacing of these ADCs is pretty straightforward. A driver for AVRs currently only supporting the ADS1194
66 (16-bit, 4ch version) can be found at https://github.com/jaseg/OpenMind-firmware
68 What to do with this?
69 ---------------------
70 Just a bunch of ideas:
72 * http://www.instructables.com/id/Animatronic-Cat-Ears/ This only needs more pony.
73 * A sleep cycle-detector that wakes you up by using some LEDs to simulate dawn at *exactly* the right time
74 * A muscle-computer-interface, i.e. a device that senses when you physically move your muscles by measuring the pretty
75   strong signals your brain sends to them. For reference see William Gibson: Burning Chrome (though, in comparision to
76   the one used there, openmind is still one-way).
78 Warning
79 -------
80 These schematics and code are distributed in the hope that they will be useful, but WITHOUT ANY WARRANTY; without even
81 the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
82 Now, the following should be obvious: Do not connect this stuff to anything alive unless you absolutely know what you are doing and do not blame me when you fry your brains with it.