Package: dronecan-gui-tool
DroneCAN GUI ToolDroneCAN GUI Tool is a cross-platform (Windows/Linux/OSX) application for UAVCAN v0.9 and/or DroneCAN V1 management and diagnostics.Read the docs athttps://dronecan.org.Ask questions athttps://ardupilot.org/copter/docs/common-contact-us.html.Read installation instructions:GNU/LINUXWINDOWSMACOSInstalling on GNU/LinuxThe general approach is simple:Install PyQt5 for Python 3 using your OS' package manager (e.g. APT).Install the application itself from Git via PIP:pip3 install git+https://github.com/DroneCAN/gui_tool@master(it is not necessary to clone this repository manually).
Alternatively, if you're a developer and you want to install your local copy, usepip3 install ..It also may be necessary to install additional dependencies, depending on your distribution (see details below).Once the application is installed, you should see new desktop entries available in your desktop menu;
also a new executabledronecan_gui_toolwill be available in yourPATH.
If your desktop environment doesn't update the menu automatically, you may want to do it manually, e.g.
by invokingsudo update-desktop-database(command depends on the distribution).It is also recommended to install Matplotlib - it is not used by the application itself,
but it may come in handy when using the embedded IPython console.Debian-based distributionssudoapt-getinstall-ypython3-pippython3-setuptoolspython3-wheel
sudoapt-getinstall-ypython3-numpypython3-pyqt5python3-pyqt5.qtsvggit-core
sudopip3installgit+https://github.com/DroneCAN/gui_tool@masterTroubleshootingIf installation fails with an error like below, try to install IPython directly withsudo pip3 install ipython:error: Setup script exited with error in ipython setup command:
Invalid environment marker: sys_platform == "darwin" and platform_python_implementation == "CPython"If you're still unable to install the package, please open a ticket.RPM-based distributionsMaintainers wantedFedora 29+sudodnfinstallpython3-PyQt5
sudopip3installgit+https://github.com/DroneCAN/gui_tool@masterInstalling on WindowsIn order to install this application,download and install the latest.msipackage from here:https://firmware.ardupilot.org/Tools/CAN_GUI/.Building the MSI packagePlease see the file winbuild.bat in this directory, or use the MSI file build by github actions on any commitInstalling on macOSOSX support is a bit lacking in the way that installation doesn't create an entry in the applications menu,
but this issue should be fixed someday in the future.
Other than that, everything appears to function more or less correctly.
If you have a choice, it is recommended to use Linux or Windows instead,
as these ports are supported much better at the moment.Homebrew optionInstall the Homebrew package manager for OSX.Run the following commands:brewinstallpython3
brewpostinstallpython3
pip3installPyQt5
pip3installgit+https://github.com/DroneCAN/gui_tool@master
dronecan_gui_toolMacPorts optionInstall XCode from App Store, install MacPorts fromhttps://www.macports.org/install.php,
then run the commands below.
If you're prompted to install Command Line Developer Tools, agree.sudoportselfupdate
sudoportinstallcurl-ca-bundlepy35-pippy35-pyqt5py35-numpy
sudopython3.5-mpipinstallgit+https://github.com/DroneCAN/gui_tool@masterWe would like to provide prebuilt application packages instead of the mess above.
Contributions adding this capability would be welcome.DevelopmentReleasing new versionFirst, deploy the new version to PyPI. In order to do that, perform the following steps:Update the version tuple inversion.py, e.g.1, 0, and commit this change.Create a new tag with the same version number as in the version file, e.g.git tag -a 1.0 -m v1.0.Push to master:git push && git push --tagsThen, build a Windows MSI package using the instructions above, and upload the resulting MSI to
the distribution server.Code stylePlease follow the existing code styles .HistoryMuch of the development of this tool is based upon original work by
Pavel Kirienko and others from the UAVCAN Development Team. Seehttps://github.com/UAVCAN/gui_toolfor contributors.