This is desktop application controlling Linak office desks. Application functionality is similar to application provided by Linak. One of the goals of this project is to allow the desk control under Linux operating systems, because official application does not support Linux OS.
Application was tested on DPG1C desk panel containing built-in Bluetooth module.
Communication protocol between DPG1C module and official application was reverse engineered mostly by mocking DPG1C Bluetooth service.
- scanning for nearby devices
- moving up/down
- moving to favourite position
- setting reminder, desk offset and favoritie positions
- system tray icon
- auto reconnecting to recent device
- persisting application settings
- drawing position chart over time
- position statistics
- linakdeskapp.main -- entry point for the application
- linakdeskmock -- Bluetooth service mocking Linak desk service
- testlinakdeskapp -- unit tests for the application
Bluepy package requires special privileges when scanning for nearby devices.
It is recomended to solve it by adding capabilities to the package:
cd <PYTHON_PATH>/site-packages/bluepy sudo setcap 'cap_net_raw,cap_net_admin+eip' bluepy-helper
Go to directory where bluepy is installed (local user or system) and execute setcap as stated above.
To run application try one of:
- run src/linakdeskctl
- run src/linakdeskapp/main.py
- execute cd src; python3 -m linakdeskapp
Application can be run in profiler mode passing --profile as command line parameter.
To run mock simply execute linakdeskmock/main.py file.
To run tests execute src/runtests.py. It can be run with code profiling and code coverage options.
In addition there is demo application not requiring Bluetooth connection. It can be run by testlinakdeskapp/gui/main_window_example.py.
- PyQt5
- matplotlib
- pandas
- bluepy
Installation:
sudo apt install python3-matplotlib python3-pandas
pip3 install --user bluepy
- use of EnumMeta class (linak_service.py)
- defining method decorators (synchronied.py)
- use of threading: Thread, Event, Timer
- use of QThreadPool and Worker concepts
- properly killing (Ctrl+C) PyQt (sigint.py)
- loading of UI files and inheriting from it
- embedding matplotlib graph with navigation toolbar into PyQt widget
- code profiling (cProfile)
- code coverage (coverage)
- handle cm/inch unit switch
- add fav buttons inside popup of system tray icon
- handle away from keyboard
- disabling light guidance does not seem to work. It seems to be problem on device side, because even in Linak app it does not work.
If You are willing to work on this project, then after first clone You have to fetch submodule inside lib. To do this simply call configure_submodules.sh script placed in root directory tree.
If You like the project or it is valuable to You then feel free to support my work.
