mwp Gtk4 RC3

Third (and probably final) public release candidate for mwp / Gtk4.

• This is built from the mwp4 branch.
• Please see the migration guide for system requirements etc.
• Please raise Github issues for stuff that is broken / regressions
• It is the intention that unless there are major issues, the mwp4 branch will become master and the current master (Gtk+-3.0) branch will be renamed to legacy. This should happen at the end of September 2024.
• As the published user guide has yet to be updated, please ask any usage / UX questions in the current discussion. The draft UG in the mwp4 branch reflects the latest documentation.

![mwp](https://github.com/stronnag/mwptools/raw/mwp4/docs/assets/mwp4.png

mwp Gtk4 RC2

second public release candidate for mwp / Gtk4.

• This is built from the mwp4 branch.
• Please see the migration guide for system requirements etc.
• Please raise Github issues for stuff that is broken / regressions
• It is the intention that unless there are major issues, the mwp4 branch will become master and the current master (Gtk+-3.0) branch will be renamed to legacy.
• As the user guide has yet to be updated, please ask any usage / UX questions in the current discussion.

mwp Gtk4 RC1

First public release of mwp for Gtk4.

• This is built from the mwp4 branch.
• Please see the migration guide for system requirements etc.
• Please raise Github issues for stuff that is broken / regressions
• It is the intention that unless there are major issues, the mwp4 branch will become master and the current master (Gtk+-3.0) branch will be renamed to legacy.
• As the user guide has yet to be updated, please ask any usage / UX questions in the current discussion.

Touch me gently - snapshot 2024-07-02

Accidentally deleted and reinstated 2024-07-04 --- no functional changes.

Overview

The snapshot here represents the state of the mwptools project at a point in time.

• It is not a 'release'
• master and or development branches may be newer / more (or less) "stable" etc.

Changes since last snapshot

• Map interactions are touch-screen aware
• With "touch", it is necessary to double tap an icon for the right mouse menu.
• This is intended to be the last "new feature" version of the Gtk+-3.0 series.

Changed Dependencies

None

Deprecation Notice

A number of Gtk3 components that are significant mwp dependencies (libchamplain and its dependencies, libgdl) are becoming obsolescent and are effectively unmaintained upstream. This is likely to be an ongoing problem (see more detail)

Migrating mwp to Gtk4:

• Is significant effort
• Has now started:
  • The current Gtk4 replacement for libgdl is not sufficiently functional to meet mwp's needs, the replacement is to be decided.
  • libshumate, the replacement for the mapping component, is now useful enough to start migration.
  • It remains the case that some of the currently supported distros don't yet provide sufficient Gtk4 support, however as the migration will take a while, this may be a problem.

Gtk4 migration will take a while ("before Christmas"). It is much more that "migrate the map layer" as it provides an incentive to make some major internal design improvements (that were not previously possible) as well. The extant (Gtk3) version is effectively in maintenance mode.

Functional Dependencies

• For blackbox replay, you need the flightlog2x tools ; flightlog2x tools provides binary downloads for common Operating Systems.
• Please check the wiki Recent Changes document for any new dependencies since your last installation.

Debian package Installation

If you really want a binary snapshot ...

Preparation

• (Debian et al). Please ensure you have the universe repository enabled
• Ensure that the system is up to date: (Debian et al ... sudo apt update && sudo apt upgrade).

Download and Install

• Arch Linux users can install mwptools-git from the AUR.
• For Debian and derivatives, install the Debian package here. The archive is built in Debian Stable, which should also work with newer distributions.
  • It is necessary to download the archive and install it locally, e.g.

    $  curl -LO https://github.com/stronnag/mwptools/releases/download/7.181.368/mwptools_7.181.368_amd64.deb
    $ sudo apt install ./mwptools_7.181.368_amd64.deb

• Otherwise, build from source.

WSL-G users, note that ser2udp.exe is functionally unchanged.

Snapshot 2024-06-13

Overview

The snapshot here represents the state of the mwptools project at a point in time.

• It is not a 'release'
• master and or development branches may be newer / more (or less) "stable" etc.

Changes since last snapshot

• Handle LTM LAND navigation state
• Handle CRSF LAND navigation state
• Display LAND nav state in live telemetry and BBL replay
• Process CLI file before mission / blackbox log
• Use FW Approach / Loiter radius from CLI file
• Ensure mission file provided to fl2ltm is MWXML

Changed Dependencies

None

Deprecation Notice

A number of Gtk3 components that are significant mwp dependencies (libchamplain and its dependencies, libgdl) are becoming obsolescent and are effectively unmaintained upstream. This is likely to be an ongoing problem (see more detail)

Migrating mwp to Gtk4:

• Is significant effort
• Not practical at the moment
  • The current Gtk4 replacements for libchamplain and libgdl are not sufficiently functional to meet mwp's needs
  • Some of the currently supported distros don't yet provide sufficient Gtk4 support.
• Will probably happen at some stage

Functional Dependencies

• For blackbox replay, you need the flightlog2x tools ; flightlog2x tools provides binary downloads for common Operating Systems.
• Please check the wiki Recent Changes document for any new dependencies since your last installation.

Debian package Installation

If you really want a binary snapshot ...

Preparation

• (Debian et al). Please ensure you have the universe repository enabled
• Ensure that the system is up to date: (Debian et al ... sudo apt update && sudo apt upgrade).

Download and Install

• Arch Linux users can install mwptools-git from the AUR.
• For Debian and derivatives, install the Debian package here. The archive is built in Debian Stable, which may also work with newer distributions.
  • It is necessary to download the archive and install it locally, e.g.

    $ curl -LO https://github.com/stronnag/mwptools/releases/download/7.162.723/mwptools_7.162.723_amd64.deb
    $ sudo apt install ./mwptools_7.162.723_amd64.deb

• Otherwise, build from source.

WSL-G users, note that ser2udp.exe is functionally unchanged.

Snapshot 2024-05-25

Overview

The snapshot here represents the state of the mwptools project at a point in time.

• It is not a 'release'
• master and or development branches may be newer / more (or less) "stable" etc.

Changes since last snapshot

• Rate limit MSP polling (for SITL)
• Clean up messaging timer code
• Revise ancient WP download timer
• Add msp_adsb gsetting (on / off / auto) to manage MSP2_ADSB_VEHICLE_LIST usage.
• Improve MSP2_ADSB_VEHICLE_LIST enabling checks (for msp_adsb == auto).
• Fix BLE for characteristics / service checking with multiple devices of same type
• Improve serial instrumentation

Changed Dependencies

None

Deprecation Notice

A number of Gtk3 components that are significant mwp dependencies (libchamplain and its dependencies, libgdl) are becoming obsolescent and are effectively unmaintained upstream. This is likely to be an ongoing problem (see more detail)

Migrating mwp to Gtk4:

• Is significant effort
• Not practical at the moment
  • The current Gtk4 replacements for libchamplain and libgdl are not sufficiently functional to meet mwp's needs
  • Some of the currently supported distros don't yet provide sufficient Gtk4 support.
• Will probably happen at some stage

Functional Dependencies

• For blackbox replay, you need the flightlog2x tools ; flightlog2x tools provides binary downloads for common Operating Systems.
• Please check the wiki Recent Changes document for any new dependencies since your last installation.

Debian package Installation

If you really want a binary snapshot ...

Preparation

• (Debian et al). Please ensure you have the universe repository enabled
• Ensure that the system is up to date: (Debian et al ... sudo apt update && sudo apt upgrade).

Download and Install

• Arch Linux users can install mwptools-git from the AUR.
• For Debian and derivatives, install the Debian package here. The archive is built in Debian Stable, which should also work with newer distributions.
  • It is necessary to download the archive and install it locally, e.g.

   $ curl -LO https://github.com/stronnag/mwptools/releases/download/7.146.457/mwptools_7.146.457_amd64.deb
   $ sudo apt install ./mwptools_7.146.457_amd64.deb

• Otherwise, build from source.

WSL-G users, note that ser2udp.exe is functionally unchanged.

Current Build (2024-05-12)

Changes

• Prefer MSP_BOXIDS over MSP_BOXNAME. This make mwp more usable on low bandwidth devices with minimal hardware buffering (e.g. BLE CC2541 devices).
• Improve serial write for low resource serial devices
• Make map "In View" / "Centre On" more obvious, add shortcut key toggle
• Add ICAO category specific icons for ADS-B tracks
• Support MSP2_ADSB_VEHICLE_LIST (for FC with attached PingRX / TT_SC1 device)
• Add further RTLSDR ADS-B options (dump1090 JSON and readsb protobuf-c formats).
• Overhaul the whole radar / telemetry tracker API, improving performance and stability.
• Improve fcflash (remove erroneous stty).

Dependencies

In order to build in support for the readsb protobuf-c format for ADS-B tracks, it is necessary to have a (lib)protobuf-c (development) package installed. Note that mwp will build without this.

Deprecation Notice

A number of Gtk3 components that are significant mwp dependencies (libchamplain and its dependencies, libgdl) are becoming obsolescent and are effectively unmaintained upstream. This is likely to be an ongoing problem (see more detail)

Migrating mwp to Gtk4:

• Is significant effort
• Not practical at the moment
  • The current Gtk4 replacements for libchamplain and libgdl are not sufficiently functional to meet mwp's needs
  • Some of the currently supported distros don't yet provide sufficient Gtk4 support.
• Will probably happen at some stage

Dependencies

• For blackbox replay, you need the flightlog2x tools ; flightlog2x tools provides binary downloads for common Operating Systems.
• Please check the wiki Recent Changes document for any new dependencies since your last installation.

Debian package Installation

Preparation

• (Debian et al). Please ensure you have the universe repository enabled
• Ensure that the system is up to date: (Debian et al ... sudo apt update && sudo apt upgrade).

Download and Install

• Arch Linux users can install mwptools-git from the AUR.

• For Debian and derivatives, install the Debian package here. The archive is built in Debian Stable, which should also work with newer distributions.

  • It is necessary to download the archive and install it locally, e.g.

    $ curl -LO https://github.com/stronnag/mwptools/releases/download/7.133.323/mwptools_7.133.323_amd64.deb
    $ sudo apt install ./mwptools_7.133.323_amd64.deb

• Otherwise, build from source.

WSL-G users, note that ser2udp.exe is functionally unchanged.

Current Build (2024-04-21)

Changes

• Add General Aviation specific units settings (for radar functions, see manual)
• Document new radar settings
• Improve / document INAV autodecl tool (for checking INAV 8.0 auto-declination values).
• Update inav-parse_bb_compass.rb to optionally use declination / --simulate-imu to additionally generate / plot pure mag heading.
• Add -remote option to ser2udp (see its README)
• Fix multi-mission manager (delete / fwapproach consistency)

Deprecation Notice

A number of Gtk3 components that are significant mwp dependencies (libchamplain and its dependencies, libgdl) are becoming obsolescent and are effectively unmaintained upstream. This is likely to be an ongoing problem (see more detail)

Migrating mwp to Gtk4:

• Is significant effort
• Not practical at the moment
  • The Gtk4 replacements for libchamplain and libgdl are not sufficiently functional to meet mwp's needs
  • Some of the currently supported distros don't yet provide sufficient Gtk4 support.
• Will probably happen at some stage

Dependencies

• For blackbox replay, you need the flightlog2x tools ; flightlog2x tools provides binary downloads for common Operating Systems.
• Please check the wiki Recent Changes document for any new dependencies since your last installation.

Installation

Preparation

• (Debian et al). Please ensure you have the universe repository enabled
• Ensure that the system is up to date: (Debian et al ... sudo apt update && sudo apt upgrade).

Download and Install

• Arch Linux users can install mwptools-git from the AUR.
• Install the Debian package here (Debian and derivatives). The archive is built in Debian Stable, which may or not work with newer distributions.
• Download the archive and install it locally, e.g.

  curl -LO https://github.com/stronnag/mwptools/releases/download/7.111.629/mwptools_7.111.629_amd64.deb
  sudo apt install ./mwptools_7.111.629_amd64.deb
  

• Otherwise, build from source (recommended).

WSL-G users, note that ser2udp.exe is essentially the same but enhanced to work with solely push telemetry. Unless you need this, you don't need a new ser2udp.exe.

Current Build (2024-04-01)

Changes

• The environment variable MWP_POS_OFFSET previously used to "relocate" missions / logs for replay has been removed. It is replaced by a new --rebase LAT,LON option which should be more practical. LAT,LON represents an absolute location in a format understood by mwp.

  For example, to relocate a BBL/mission replay to a "plausibly deniable" Narita Airport from its original location:

    mwp --rebase "35.761000 140.378945" -b nomag/nomag.TXT -m nomag/nomag.mission
  

  The result of which can be seen in this youtube video.

• The rebase implementation has been improved for geodesic correctness, for example a circular mission will remain a circle after relocation.

• A standalone movemission tool has been published as a result of rebase work. Note, this is not built / installed by default; see the cmd/movemission directory for details.

• The displayed geometry of FW Landing Approaches matches that of the INAV Configurator

• Numerous build system workarounds (and improvements) for Meson 1.40 and later.

• Updated user guide

Light-bulb moment (WSL)

mwp's extant atstart and atexit setting can be used to automate the invocation / removal by mwp of the WSL specific "serial bridge" tool ser2udp.exe; thus removing the previously documented requirement for a wrapper "batch file". More detail in the user guide.

Deprecation Notice

A number of Gtk3 components that are significant mwp dependencies (libchamplain and its dependencies, libgdl) are becoming obsolescent and are effectively unmaintained upstream. This is likely to be an ongoing problem (see more detail)

Migrating mwp to Gtk4:

• Is significant effort
• Not practical at the moment
  • The Gtk4 replacements for libchamplain and libgdl are not sufficiently functional to meet mwp's needs
  • Some of the currently supported distros don't yet provide sufficient Gtk4 support.
• Will probably happen at some stage

Dependencies

• For blackbox replay, you need the flightlog2x tools ; flightlog2x tools provides binary downloads for common Operating Systems.
• Please check the wiki Recent Changes document for any new dependencies since your last installation.

Installation

Preparation

• (Debian et al). Please ensure you have the universe repository enabled
• Ensure that the system is up to date: (Debian et al ... sudo apt update && sudo apt upgrade).

Download and Install

• Arch Linux users can install mwptools-git from the AUR.

• Install the Debian package here (Debian and derivatives). The archive is built in Debian Stable, which may or not work with newer distributions.

  • It is necessary to download the archive and install it locally, e.g.

    $ curl -LO https://github.com/stronnag/mwptools/releases/download/7.091.502/mwptools_7.091.502_amd64.deb
    sudo apt install ./mwptools_7.091.502_amd64.deb

• Otherwise, build from source (recommended).

WSL-G users, note that ser2udp.exe is unchanged.

Current Build (2024-02-26)

Changes

• Fix MSP serialisation / de-serialisation of FWApproach directions
• Fix MWXML serialisation of FWApproach directions
• Improve planned home generation for multi-missions
• Update user guide

Deprecation Notice

A number of Gtk3 components that are significant mwp dependencies (libchamplain and its dependencies, libgdl) are becoming obsolescent and are effectively unmaintained upstream. This is likely to be an ongoing problem (see more detail)

Migrating mwp to Gtk4:

• Is significant effort
• Not practical at the moment
  • The Gtk4 replacements for libchamplain and libgdl are not sufficiently functional to meet mwp's needs
  • Some of the currently supported distros don't yet provide sufficient Gtk4 support.
• Will probably happen at some stage

Dependencies

• For blackbox replay, you need the flightlog2x tools ; flightlog2x tools provides binary downloads for common Operating Systems.
• Please check the wiki Recent Changes document for any new dependencies since your last installation.

Installation

Preparation

• (Debian et al). Please ensure you have the universe repository enabled
• Ensure that the system is up to date: (Debian et al ... sudo apt update && sudo apt upgrade).

Download and Install

It is necessary to download the archive and install it locally, e.g.

$ curl -LO https://github.com/stronnag/mwptools/releases/download/7.057.554/mwptools_7.057.554_amd64.deb
$ sudo apt install ./mwptools_7.057.554_amd64.deb

Otherwise, build from source (recommended).

WSL-G users, note that ser2udp.exe is unchanged.