nixo
/
tuhi
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Updated Live Mode (markdown)

Peter Hutterer 2019-09-09 08:37:23 +10:00
parent fff8f222bd
commit f18bae76c2
1 changed files with 13 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
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).