Meshtastic Python 2.3.13

Important

The protobuf modules have moved in this release. While many imports of _pb2 modules directly from meshtastic will still work, they should in general be updated to use meshtastic.protobuf instead. If needing to support multiple versions of this library, consider wrapping the initial import from meshtastic.protobuf in a try block and then importing from plain meshtastic in an except ImportError block.

Additionally, this version of the library clarifies the licensing of the library and CLI to GPL3. There has been a bit of a confusing potentially-dual-license situation for a little while, but GPL3 is the plan going forward.

In better news, BLE connections should work better in this release due to a lot of work improving that code!

What's Changed

• Move protobuf python glue from meshtastic to meshtastic.protobuf by @geeksville in #613
• make specifying an argument to --seriallog optional by @geeksville in #618
• Adds support for ble logging characteristic by @thebentern in #616
• Add bin/git-resolve-poetry-lock.sh to resolve merge conficts by @geeksville in #619
• Clarify licensing by @FedericoCeratto in #582
• Properly handle missing nodes in traceroute response by @ianmcorvidae in #621
• bleak reads can hang if a device walks out of range, cope with that. by @geeksville in #624
• Allow connection args without an argument, add argument aliases by @ianmcorvidae in #625
• Support --ble on older firmwares that don't have the log-radio characteristic yet by @ianmcorvidae in #626
• New LogRecord protobuf BLE logging by @thebentern in #627

Full Changelog: 2.3.12...2.3.13

As before, please use pip to install if standalone binaries are unavailable or non-functional.

Meshtastic Python 2.3.12

What's Changed

• Improve ACK handling: pass to onAckNak and on request in sendData by @ianmcorvidae in #602
• fix bitrot in an old sanity test - use correct namespace by @geeksville in #611
• Add a whitelist of known meshtastic USB VIDs to use a default serial … by @geeksville in #605
• Replace timeago by @FedericoCeratto in #587
• Change build to use poetry by @geeksville in #606

New Contributors

• @FedericoCeratto made their first contribution in #587

Full Changelog: 2.3.11...2.3.12

As with older releases, please use pip install (or your python package installer of choice) if there is no standalone binary for your system, or the one provided doesn't work.

This release changes the developer setup to use the poetry tool. This should make things easier, generally speaking!

Meshtastic Python 2.3.11

What's Changed

• quick-coverage: simple test case just to cover uncovered code. by @nerdenator in #588
• Allow a faster nodedb-less startup on 2.3.11+ with --no-nodes by @ianmcorvidae in #589
• Wait for response with --device-metadata. Fixes #527 by @ianmcorvidae in #591

New Contributors

• @nerdenator made their first contribution in #588

Full Changelog: 2.3.10...2.3.11

The usual note: if there is no standalone binary for your OS or the provided one doesn't work, please use pip to install.

Meshtastic Python 2.3.10

What's Changed

• Add "wait to disconnect" argument by @todd-herbert in #580
• Fix the ignore_incoming management BUG 568 by @868meshbot in #581
• Initialize unknown nodes more in line with meshtastic/design#16; show hardware in --nodes by @ianmcorvidae in #583
• Fix rounding of position values when converting from integer to float in _fixupPosition by @ianmcorvidae in #585
• Use new fixed position admin messages and add --remove-position argument by @ianmcorvidae in #584

New Contributors

• @todd-herbert made their first contribution in #580
• @868meshbot made their first contribution in #581

Full Changelog: 2.3.9...2.3.10

As usual, if the standalone binary is unavailable or doesn't work on your system, please use pip to install.

Meshtastic Python 2.3.9

What's Changed

• Print 0 for channel rather than N/A, since we should probably always have a channel by @ianmcorvidae in #563
• Fix typo in main.py by @jhollowe in #564
• add a warning on --ch-enable and --ch-disable, which should usually be avoided by @ianmcorvidae in #574

New Contributors

• @jhollowe made their first contribution in #564

Full Changelog: 2.3.8...2.3.9

As with other releases, please install with pip if a standalone binary is unavailable or nonfunctional.

Meshtastic Python 2.3.8

This release should see some dramatic performance improvements due to the first change in the list below; updates are highly advised!

What's Changed

• (high-pri fix) Update python client to use the 'modern' meshtastic protocol init flow by @geeksville in #560
• Pretty indent --info JSON output (see below for details) by @geeksville in #558
• Use the new Heartbeat payload variant for the heartbeat instead of an empty ToRadio packet by @ianmcorvidae in #561

Full Changelog: 2.3.7...2.3.8

As with prior releases: if the prebuilt binaries don't exist for your platform or don't work, please use pip to install instead.

Meshtastic Python 2.3.7

What's Changed

• Disallow --dest in remaining spots that don't actually use/allow it by @ianmcorvidae in #553
• Don't allow --dest with --setlat/lon/alt. by @ianmcorvidae in #551
• Allow generating QR codes for remote nodes and for all channels, not just local/primary by @ianmcorvidae in #552
• Add missing StoreForward config from radio by @GUVWAF in #554
• Better support --ch-index for other commands (traceroute, telemetry, position) by @ianmcorvidae in #555
• Add --enter-dfu for entering DFU mode on NRF52 devices via admin message by @ianmcorvidae in #556

Full Changelog: 2.3.6...2.3.7

As with prior releases, if the prebuilt binaries are not available or not working on your system, please use pip instead.

Meshtastic Python 2.3.6

What's Changed

• Refactor to avoid the use of a special global object. by @holdenweb in #544
• Allow 'configure' to import yaml settings nested deeper than 2 levels by @danwelch3 in #470
• Bugfix 466 yaml import by @AeroXuk in #543
• Add a --request-position argument to request positions from nodes by @ianmcorvidae in #546
• Don't export null altitude, but support importing null lat/lon/alt as 0s by @ianmcorvidae in #549
• Send the node's already-known location if --no-time is not passed, rather than sending an empty location (948846e)

New Contributors

• @holdenweb made their first contribution in #544
• @danwelch3 made their first contribution in #470
• @AeroXuk made their first contribution in #543

Full Changelog: 2.3.5...2.3.6

As with previous releases, if the standalone binary for your system is missing or doesn't work, try installing with pip instead.

Meshtastic Python 2.3.5

This is primarily an update for protocol buffers, plus a couple small improvements.

What's Changed

• Show hops away when present in nodeDB (fixes #539) by @ianmcorvidae in #540
• Add --remove-node (fixes #514) by @ianmcorvidae in #541

Full Changelog: 2.3.4.post1...2.3.5

As with prior releases, if a standalone binary for your system is not available or doesn't work, try installing using pip instead; there are a few as-yet-unresolved issues with the standalone binaries.

Meshtastic Python 2.3.4.post1

This version corrects an issue with 2.3.4's version requirements for the protobuf library. It should only be needed relative to 2.3.4 for those with older installations that may have too old a version of that library.

What's Changed

• in --help indicate --setalt takes meters by @Jorropo in #530
• When --listen is set, turn on debug-level logging by @ianmcorvidae in #532
• Protobuf type interfaces for type-checking & undoing protobufs hack by @ianmcorvidae in #528
• feat:506 show all module settings by @flavoromission in #511
• refactoring: Start adding some more structure to the arguments for the CLI by @ianmcorvidae in #538

New Contributors

• @Jorropo made their first contribution in #530
• @flavoromission made their first contribution in #511

Full Changelog: 2.3.3...2.3.4.post1

Note: As in past releases, the windows binary has been removed due to an issue with being detected as malware. Additionally, the ubuntu binary is known to not work as desired on older versions that may not have the expected version of glibc. In both cases, try installing using pip instead until fixes can be made.