From f18bae76c24186b25fca3fe537f114199c9719b5 Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Mon, 9 Sep 2019 08:37:23 +1000 Subject: [PATCH] Updated Live Mode (markdown) --- Live-Mode.md | 28 +++++++++++++--------------- 1 file changed, 13 insertions(+), 15 deletions(-) diff --git a/Live-Mode.md b/Live-Mode.md index c95a50c..a51f876 100644 --- a/Live-Mode.md +++ b/Live-Mode.md @@ -2,7 +2,7 @@ The so-called Live mode makes a smartpad behave like a bluetooth-connected normal graphics tablet. Stylus input is immediately transmitted to the host computer and the tablet can thus used for digital drawings or as a mouse replacement. -It is possible to use the live mode with tuhi. However, this is not shipped in the flatpak, and so people need to start this from git: +It is possible to use live mode with tuhi. However, this is an experimental feature and not shipped in the flatpak. Users need the git repository for live mode: ```bash git clone https://github.com/tuhiproject/tuhi.git @@ -10,26 +10,24 @@ cd tuhi sudo ./tools/tuhi-live.py ``` -There are a few pitfalls that may arise: -#### the device has not been paired with tuhi, yet: +`tuhi-live` must run as root to create the required `/dev/hidraw` device. This device will appear as virtual input device, libinput or other userspace input stacks will then handle that device as if it was any other input device. +Note that live mode is an experimental feature and the user interface is raw. To use tuhi-live, you must [register](Terminology) the device first. Start Tuhi normally and follow the instructions to register the device. + +## Troubleshooting + +Tuhi 0.2 had known issues with live mode, please use 0.3 or later. + +### Authorization errors + +An authorization error means the device is not registered with Tuhi: ``` 11:44:38 ERROR: tuhi.wacom: **** Exception: DeviceError.AUTHORIZATION_ERROR **** ``` +Please start Tuhi and follow the registration instructions. Note that you must register Tuhi "normally", i.e. **do not use the flatpak** to register Tuhi. Flatpaks store the configuration files in different directories. -In that case you need to need to start tuhi (the gui) and follow the above instructions to register your device. -Then you can start the live mode again. -#### the device has not been paired with tuhi through flatpak: - -``` -11:44:38 ERROR: tuhi.wacom: **** Exception: DeviceError.AUTHORIZATION_ERROR **** -``` - -You need to run the flatpak in the background for the authorization token to be valid. -Note that tuhi 0.2 has issues with the live mode, so you need to upgrade to v0.3 first. - -#### something else happened: +### Something else doesn't work Keep trying. Sometimes, it doesn't work on the first attempt (yes, that's a bug, but hard to reproduce and fix).