aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKing Kévin <kingkevin@cuvoodoo.info>2019-09-30 13:39:58 +0200
committerKing Kévin <kingkevin@cuvoodoo.info>2019-09-30 13:39:58 +0200
commitdfc006eb4575926aff5fca40f4661ec2ef191107 (patch)
treeb407de2e6fa173b8453c3b17a17a8d13ad6f336e
parent8946ed7f5c81566a8a02c7718f211656ebcad125 (diff)
re-add README
-rw-r--r--README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..011b914
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+these Linux programs read out the measurements from the WEB/WITRN/GZUt/QWay U2/U2p USB power meter.
+
+go to [wiki](https://wiki.cuvoodoo.info/doku.php?id=web-u2) for more information about the device and protocols.
+
+USB
+===
+
+`u2_usb` reads the measurements using the USB HID interface.
+
+to compile the source code you require: gcc, make, hidapi library (libhidapi-dev).
+then just run `make` and it will output the `u2_usb` binary.
+
+run `u2_usb` to get the output in CSV format.
+run `u2_usb -d` to get the raw and decoded output (useful for reversing and debugging).
+
+Bluetooth
+=========
+
+to compile the source code you require: gcc, make, dbus library (libdbus-1-dev).
+then just run `make` and it will output the `u2_bt` binary.
+
+ensure the BlueZ Bluetooth stack is running:
+```
+sudo systemctl start bluetooth
+```
+don't forget to grant the permissions to access bluetooth devices:
+```
+sudo adduser $USER bluetooth
+```
+
+run `u2_bt` to get the output in CSV format.
+run `u2_bt -d` to get the raw and decoded output (useful for reversing and debugging).
+
+I did not implement the possibility to specify the Bluetooth adapter and device.
+the program uses the first Bluetooth adapter it finds, and first device with the name starting with Qway_U2.