1 files changed, 112 insertions, 0 deletions
diff --git a/src/argaze/TobiiGlassesPro2/README.md b/src/argaze/TobiiGlassesPro2/README.md
new file mode 100644
index 0000000..3352274
--- /dev/null
+++ b/src/argaze/TobiiGlassesPro2/README.md
@@ -0,0 +1,112 @@
+# TobiiGlassesPro2
+
+_This module provides a class interface to handle TobbiGlassesPro2 data and video stream.
+It is based on TobiiGlassesPyController package (https://github.com/ddetommaso/TobiiGlassesPyController)._
+
+## To connect Tobii glasses on Mac OS
+
+* Install DHCP server: brew install isc-dhcp
+
+* Setup DHCP server:
+    * /usr/local/etc/dhcpd.conf
+    * /usr/local/etc/master.conf
+
+* Setup USB LAN Interface:
+    * ip: 192.168.1.1
+    * subnet: 255.255.255.0
+    * router: 192.168.1.254
+
+* Launch Tobii glasses interface to enable USB LAN Interface before to Launch DHCP server.
+
+* Launch DHCP server: sudo /usr/local/sbin/dhcpd
+
+* Kill DHCP server: sudo kill `cat /usr/local/var/dhcpd/dhcpd.pid`
+
+* Watch DHCP server: sudo log stream --info --debug --predicate "process == 'dhcpd'"
+
+## Tobii data structure
+
+Each data frame have the following structure:
+```
+    {
+        'mems': {
+            'ac': {
+                'ts': 1042711827, 
+                's': 0, 
+                'ac': [0.549, -9.868, 2.203]
+            }, 
+            'gy': {
+                'ts': 1042723807, 
+                's': 0, 
+                'gy': [2.94, -2.384, 1.428]
+            }
+        },
+        'right_eye': {
+            'pc': {
+                'ts': 1042743553, 
+                's': 0, 'gidx': 39971, 
+                'pc': [-35.24, -25.51, -31.66], 
+                'eye': 'right'
+            }, 
+            'pd': {
+                'ts': 1042743553, 
+                's': 0, 
+                'gidx': 39971, 
+                'pd': 3.72, 
+                'eye': 'right'
+            }, 
+            'gd': {
+                'ts': 1042743553, 
+                's': 0, 
+                'gidx': 39971, 
+                'gd': [0.1833, 0.307, 0.9339], 
+                'eye': 'right'
+            }
+        }, 
+        'left_eye': {
+            'pc': {
+                'ts': 1042743553, 
+                's': 0, 
+                'gidx': 39971, 
+                'pc': [29.96, -27.92, -40.9], 
+                'eye': 'left'
+            }, 
+            'pd': {
+                'ts': 1042743553, 
+                's': 0, 
+                'gidx': 39971, 
+                'pd': 4.42, 
+                'eye': 'left'
+            }, 
+            'gd': {
+                'ts': 1042743553, 
+                's': 0, 
+                'gidx': 39971, 
+                'gd': [0.1528, 0.2977, 0.9423], 
+                'eye': 'left'
+            }
+        },
+        'gp': {
+            'ts': 1042743553, 
+            's': 0, 
+            'gidx': 39971, 
+            'l': 82832, 
+            'gp': [0.3975, 0.2228]
+        }, 
+        'gp3': {
+            'ts': 1042743553, 
+            's': 0, 
+            'gidx': 39971, 
+            'gp3': [313.64, 542.2, 1728.85]
+        }, 
+        'pts': {
+            'ts': 1042123917,                           
+            's': 0, 
+            'pts': 93695,                               # Presentation Time Stamp (PTS) value to synchronise with live video stream frame PTS
+            'pv': 7
+        }, 
+        'vts': {
+            'ts': -1
+        }
+    }
+```
+\ No newline at end of file