aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorcnlohr <lohr85@gmail.com>2016-12-02 23:18:19 -0500
committercnlohr <lohr85@gmail.com>2016-12-02 23:18:19 -0500
commit363b9fe3db6a023479266ee7c62e7109e71323c4 (patch)
treeaf2eded58828b7b0081be78ed0b79d11ace73217 /README.md
parent84d17df274f52776ca8ca602458ecefc746d3811 (diff)
downloadlibsurvive-363b9fe3db6a023479266ee7c62e7109e71323c4.tar.gz
libsurvive-363b9fe3db6a023479266ee7c62e7109e71323c4.tar.bz2
Get ready for public (NOT RELEASE)
Diffstat (limited to 'README.md')
-rw-r--r--README.md47
1 files changed, 46 insertions, 1 deletions
diff --git a/README.md b/README.md
index 3ea8406..6a5be4e 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,47 @@
# libsurvive
-High-performance Vive Library
+
+**WARNING PROJECT NOT YET IN EXPERIMENTAL PHASE**
+
+## Introduction
+High-performance HTC Vive Library
+
+I say "high-performance" really this project is based tightly off of OSVR-Vive-Libre, but, specifically is an attempt to:
+
+1) Minimize external libraries. Actual reason for starting this: Downloading all of the libraries needed for OSVR-Vive-Libre maxed out my data plan.
+2) Put it under an open-source instead of a force-source license. (GPL to MIT/X11)
+3) Write it in C.
+4) Avoid extra layers where convenient.
+5) (long shot) Make the vive vivable for use with Intel Integrated Graphics systems.
+
+
+Will I succeed? Probably not.
+
+Definitely going to try!
+
+
+## External dependencies
+
+* libUSB
+* pthread
+* (planned, may not be needed) lapack
+
+If I ever get to video output... OpenGL.
+
+## Architecture
+
+There is an internal representation and an external representation. These lines may get blurred. Internal representation lives in .h files in the ```src/``` folder. External lives in ```include/``` folder.
+
+It is written in some fairly stout "layers" which are basically just function calls:
+
+| Layer | Description | Status |
+| ------------------------------------------------ |
+| survive_usb.c | Data is taken in at "survive_usb.c" from libusb. | Done |
+| survive_data.c | Raw HID messages are processed into logical "light" "analog" and "imu" messages. | Mostly done, Missing light data from controllers, and lighthouse data. |
+| survive_process.c | Process the high-level data into solutions for | Not yet started. Will be done by ultramn |
+
+I may or may not read data from the Vive regarding configuration. If I do, it would be added to the survive_usb.c
+
+
+
+
+