{"id":21135405,"url":"https://github.com/nohal/dashboardsk_pi","last_synced_at":"2025-07-09T03:32:58.795Z","repository":{"id":40296994,"uuid":"481341152","full_name":"nohal/dashboardsk_pi","owner":"nohal","description":"SignalK based dashboard plugin for OpenCPN","archived":false,"fork":false,"pushed_at":"2024-11-04T23:29:06.000Z","size":2358,"stargazers_count":3,"open_issues_count":16,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-04T23:30:11.028Z","etag":null,"topics":["cpp","dashboard","dashboards","marine","navigation","opencpn","plugin","signalk","wxwidgets"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nohal.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":"COPYING.gplv3","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-13T19:02:42.000Z","updated_at":"2024-11-04T23:22:26.000Z","dependencies_parsed_at":"2023-12-06T02:53:34.255Z","dependency_job_id":"139bed2c-fd31-4598-b382-ed2634ff0137","html_url":"https://github.com/nohal/dashboardsk_pi","commit_stats":{"total_commits":204,"total_committers":4,"mean_commits":51.0,"dds":"0.039215686274509776","last_synced_commit":"e28331e836da6ec8eabfeddfdf1f131b8cc6cb5b"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nohal%2Fdashboardsk_pi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nohal%2Fdashboardsk_pi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nohal%2Fdashboardsk_pi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nohal%2Fdashboardsk_pi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nohal","download_url":"https://codeload.github.com/nohal/dashboardsk_pi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225482021,"owners_count":17481179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpp","dashboard","dashboards","marine","navigation","opencpn","plugin","signalk","wxwidgets"],"created_at":"2024-11-20T06:50:45.084Z","updated_at":"2024-11-20T06:50:45.543Z","avatar_url":"https://github.com/nohal.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"DashboardSK plugin for OpenCPN\n==============================\n\nThis project provides an universal instrument dashboard display for [OpenCPN](https://opencpn.org) based on the [SignalK](https://signalk.org) data model.\n\n[![Hosted By: Cloudsmith](https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith\u0026style=flat-square)](https://cloudsmith.com)\n[![Coverity Scan Build Status](https://scan.coverity.com/projects/27049/badge.svg)](https://scan.coverity.com/projects/nohal-dashboardsk_pi)\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/nohal/dashboardsk_pi/main.svg)](https://results.pre-commit.ci/latest/github/nohal/dashboardsk_pi/main)\n\n## Dependencies\n\nThe plugin uses wxWidgets 3.2 or newer (although building against wxWidgets 3.0 may still be possible until we start to hard-enforce use of wxBitmapBundle) and targets OpenCPN 5.7 or newer with plugin API 1.18.\n\n## Compiling\n\nTo compile this plugin you have to be able to compile OpenCPN itself, refer to the [OpenCPN Developer Manual](https://opencpn-manuals.github.io/main/ocpn-dev-manual/0.1/index.html) for instructions on preparing the environment\n\n### Linux/macOS\n\n```bash\ngit clone --recurse-submodules https://github.com/nohal/dashboardsk_pi.git\ncd dashboardsk_pi\nmkdir build\ncd build\ncmake ..\nmake\n```\n\n### Windows\n\nRun `x86 Native Tools Command Prompt for VS 2022` from the Start menu as Administrator\n\n```\ngit clone https://github.com/nohal/dashboardsk_pi.git\ngit submodule update --init\ncd dashboardsk_pi.git\nci\\appveyor.bat\ncd build\ncmake -A Win32 ..\ncmake --build .\n```\n\nSubsequent runs should not need running the command prompt as Administrator\n\n### Obtaining the Git submodules\n\nIn case you already cloned the repository without the `--recurse-submodules` parameter, execute `git submodule update --init` in the root directory of the source tree.\n\n## Contributing\n\n### General\n\nThe project is developed in C++, specifically C++17.\nPlease format your code using `clang-format` before submitting pull requests, they are checked for compliance with the `.clang-format` file used by the project during the CI workflow and can't be accepted if the test is not passing.\nTo make this as simple as possible, a [pre-commit](https://pre-commit.com) configuration is provided in the project, which activates a Git pre-commit hook taking care of the formatting automatically. To use it run the following commands:\n\n```bash\npip3 install pre-commit\ncd \u003cdashboard_sk source directory\u003e\npre-commit install\n```\n\n#### pre-commit on Windows\n\nUse [WSL](https://learn.microsoft.com/en-us/windows/wsl/) for pre-commit and save yourself the headache.\n\n### Documentation\n\nThe code is documented using [Doxygen](https://www.doxygen.nl) style comments. Running `make doxygen-docs` in the build directory generates up to date HTML documentation under `docs`. Please completely document newly added code before submitting pull requests (We started with no warnings about undocumented code being emitted by doxygen and would like to keep it so for the future). Please use English both for naming the entities and documentation and try to name variables in a way describing their purpose. At the other hand, we are not writing a novel here, it is the technical aspect and accuracy of the information that is important.\n\nYou may also run `make asciidoxy-docs` to produce documentation formated using [asciidoxy](https://asciidoxy.org). The intermediate AsciiDoc product is also suitable to be included in the user manual (TODO).\n\nTo be able to do the above follow install the respective tools first...\n\nThe end user documentation integrates to the [OpenCPN plugin documentation framework](https://opencpn-manuals.github.io/plugins/opencpn-plugins/0.1/index.html), is written in [AsciiDoc](https://docs.asciidoctor.org/asciidoc/latest/) and processed using [Antora](https://antora.org) and [AsciiDoctor](https://asciidoctor.org). Please document newly added or changed functionality as soon as it is implemented and try to include the documentation in the same pull request as the code whenever feasible, unfortunately it really won't magically write itelf at some later moment.\n\n### Images\n\nEverything used from the code should be SVG, think at least twice before using a bitmap as the master source of the image. The only place where bitmaps make sense is the documentation.\n\n- Process all the SVG images with [svgo](https://github.com/svg/svgo) - run `svgo --multipass --pretty \u003cyour\u003e.svg` on it\n- Process all PNG images with `oxipng`, `optipng` or similar tool (In case you use `pre-commit` hooks as configured in this repository, the PNG images are optimized automatically before being commited to the repository)\n- Do not use JPEG or any other format using lossy compression for images (Why would you?)\n\n### GUI\n\nThe prototypes for the forms `dashboardsk.fbp` and `dashboardsk_android.fbp` are designed using [wxFormBuilder](https://github.com/wxFormBuilder/wxFormBuilder) and the generated code resides in `include/dashboardskgui.h` and `src/dashboardskgui.cpp` for the desktop version and `include/dashboardskguiandroid.h` and `src/dashboardskguiandroid.cpp` for the Android. Never edit the generated files manually.\nThe actual implementation of the GUI functionality is in `include/dashboardskguiimpl.h` and `src/dashboardskguiimpl.cpp`.\nTo minimize te amount of conditionally compiled code always keep the two user interfaces as similar as possible and name all the widgets equally in both the versions.\nIf you consider it necessary to break the above and feel it is necessary to start writing the whole GUI code by hand, please think it twice and include a bulletproof justification in the description of the respective pull request, as the change will be hardly reversible and we all probably agree that writing GUI completely by hand tends to be little rewarding activity.\n\n### Adding new instruments\n\nAll instruments inherit from the `Instrument` class and be named `\u003cDescriptiveName\u003eInstrument`. The class should be declared in `include/\u003clowercaseclassname\u003e.h` header and if necessary implemented in `src/\u003clowercaseclassname.cpp\u003e`. The tests for each respective class are implemented in `tests/XXX-ClassName.cpp`.\nThe easiest way to start implementing a new instrument is to copy a similar instrument header file (eg. `simplenumberinstrument.h`), rename the class and modify the code to implement the desired functionality.\n\nRefer to `include/instrument.h` for documentation of the basic instrument interface.\n\nEvery new instrument must be added to the `INSTRUMENTS` table at [the beginning of](https://github.com/nohal/dashboardsk_pi/blob/main/include/dashboardsk.h#L54-L62) `include\\dashboardsk.h` with a new ID and the exact name of the class implementing it. The respective code is then generated automagically by the preprocessor.\nNew source files have to be added to `HDR_DASHBOARD` and `SRC_DASHBOARD` lists in `Plugin.cmake`.\n\nWhen adding a new instrument please also update the documentation under `manual/modules/ROOT` with the information relevant to the new functionality.\n\n### Tests\n\nIt is not a completely bad idea to cover your code with tests where feasible (It is not very feasible for the GUI part, but the logic should usually be pretty well testable). The project uses the current branch of [Catch2](https://github.com/catchorg/Catch2) testing framework (Because we use C++17) and the testcases reside under `tests`.\nBuilding the tests is enabled by default and may be disabled by running cmake `cmake` with `-DWITH_TESTS=OFF` parameter.\nTo execute the tests, simply run `ctest` in the build directory.\n\n### Sanitizers support\n\nTo configure the build to enable sanitizer support, run cmake with `-DSANITIZE=\u003ccomma separated list of sanitizers\u003e`, eg. `cmake -DSANITIZE=address ..` to enable the adderess sanitizer reporting memory leaks.\n\n## Credits\n\n- Thanks to Alec Leamas, Mike Rossiter, Kees Verruijt, Jon Gough and others from whose plugin related work this plugin reuses bits and pieces.\n- Thanks to Dave for OpenCPN\n\n## License\n\nThe Catch2 framework is licensed under terms of the Boost Software License 1.0, for details see [LICENSE.txt](https://github.com/catchorg/Catch2/blob/devel/LICENSE.txt)\n\nwxWidgets is licensed under the terms of the wxWindows Library Licence, Version 3.1. For details see [licence.txt](https://github.com/wxWidgets/wxWidgets/blob/master/docs/licence.txt)\n\nOpenCPN is licensed under the terms of the GPLv2+ license, for details see [LICENSING](https://github.com/OpenCPN/OpenCPN/blob/master/LICENSING)\n\nThe `dashboardsk_pi` code is licensed under the terms of the GPL v3, or, at your convenience, newer version of the GPL license. See [LICENSING](https://github.com/nohal/dashboardsk_pi/blob/main/LICENSING) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnohal%2Fdashboardsk_pi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnohal%2Fdashboardsk_pi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnohal%2Fdashboardsk_pi/lists"}