Skip to content
sybip edited this page Feb 8, 2023 · 29 revisions

goTenna Mesh (GTM) is a miniature UHF radio transceiver with ad-hoc mesh networking capabilities, providing a peer-to-peer text messaging service similar to two-way paging, but without any central infrastructure. The GTM device itself has a headless design and is intended to be operated from a mobile phone, tablet or computer connected via Bluetooth LE. No Internet or cellular connection are required.

The manufacturer publishes a simple app for iOS and Android. Until recently, a binary-only SDK was also available for app development, however it has been officially discontinued in November 2022. Some third-party applications based on the SDK are available.

The hardware, firmware, protocols, endpoint app and SDK are all proprietary closed-source and most technical documentation is NDA-walled.

The pyGT project attempts to collect, organize and develop open-source information, code and resources with the goal of enabling fully transparent open-source development on the goTenna platform without relying on any restricted, or restrictable components.

Contents

Topic Information Code More info
INTERNAL
Bluetooth interface BLE protocol gtdevice.py
gtm-lab gtmBLE
API commands GTM API Commands gtdefs.py
Radio protocol Radio Protocol gtairobj.py
gtm-lab project
Mesh protocol Mesh Protocol gtm-lab project
Addressing, GID etc Addresses
Data formats Messages
Message ACKs
GTH16 Hash Algorithm
gtapiobj.py
pygth16.py
Hardware GTM Hardware -
Serial console GTM Serial Console -
EXTERNAL
goTenna App (GTA) goTenna App -
GTA data formats GTA Message Format
GTK256 algorithm
compatGTA.py
ATAK plugin ATAK integration compatTAK.py

NEW open-source firmware project

The gtm-lab playground was launched in 2021 to develop an alternative, open-source implementation of the goTenna Mesh radio protocols on generic ESP32 + RFM9x hardware.

IMPORTANT NOTICE

2019-02-02 The goTenna Mesh serial console feature has been quietly removed from Mesh firmware version 1.1.12. Users requiring this feature are advised to use version 1.1.8. Read more.


Any suggestions, corrections or contributions, please use the issues section, or bitmessage to sybip at BM-2cW2P5qmucxH4jWP2JEyqKA12VhTJibUXL.

Clone this wiki locally