1e257e5c90
On native (non-cross) builds, try codec2 resolution in this order: 1. pkg-config (homebrew, Nix, and other pkg-config-based installs) 2. Compiler's built-in find_library (libcodec2-dev on Debian/Ubuntu) 3. Subproject build from source (embedded fallback) This fixes macOS homebrew builds without breaking Linux system package installations that lack a .pc file but have the library on the search path. The previous single find_library approach missed homebrew installs. Also guard the audioDevice struct alignment change to only apply on Darwin ARM64 where Apple's int64_t misbehaves with packed structs. Other platforms retain the original __attribute__((packed)) to avoid increasing memory usage on resource-constrained embedded targets. Co-authored-by: opencode (https://opencode.ai) Co-authored-by: OpenRTX Contributors |
||
|---|---|---|
| .devcontainer | ||
| .github | ||
| .vscode | ||
| lib | ||
| LICENSES | ||
| meta | ||
| openrtx | ||
| platform | ||
| scripts | ||
| subprojects | ||
| tests | ||
| .clang-format | ||
| .gitignore | ||
| 99-openrtx.rules | ||
| AGENTS.md | ||
| CHANGELOG.rst | ||
| CMakeLists.txt | ||
| CONTRIBUTING.md | ||
| cross_cm4.txt | ||
| cross_cm7.txt | ||
| meson.build | ||
| meson_options.txt | ||
| osx.txt | ||
| README.md | ||
| requirements.txt | ||
| REUSE.toml | ||
| voiceprompts.vpc | ||
| west.yml | ||
OpenRTX
Modular Open Source Radio Firmware
OpenRTX is a free and open source firmware for digital amateur radio devices, top-down designed with modularity, flexibility and performance in mind.
This firmware is highly experimental and currently under development, this means that it may not have all the expected functionalities. Anyway, contributions and testing will be warmly welcomed and accepted!
For hardware and software documentation visit openrtx.org. For currently supported devices and their features, see the Development Status page.
Obtaining the firmware
Warning: Read the disclaimer section first!
Pre-built binary images of the OpenRTX firmware for each one of the supported devices are available on the releases page: to flash them to your radio, you can use the OEM firmware upgrade tool or — alternatively and for TYT MD-3x0 and MD-UV3x0 radios only — you can also use the radio_tool program or tarxvf's web based flashing tool dmr.tools.
Between releases, pre-built binary images containing the latest firmware updates are available through nightly builds from the master branch. The nightly builds are available here:
Finally, the instructions on how to compile the OpenRTX firmware for hardware as well as emulation on Linux, are available on the compilation instructions page on our website.
Have a look at the the dedicated page for detailed instructions on flashing the firmware to your radio, look at the OpenRTX website or reach out to us on our channels!
M17 support
From the release version 0.3.3 onwards the OpenRTX firmware provides experimental support for the M17 digital voice mode.
For information on the radios that currently support M17, see the Development Status page on our website.
To make the digital mode work, some modding is required: Refer to the dedicated page on our website for the details on that.
Disclaimer
This project was created for research and amateur radio use only, we are not responsible for improper use of this code which might lead to unauthorized transmission, reception or any patent infringments.
The OpenRTX firmware is released WITHOUT ANY WARRANTY: Anyone flashing a binary image obtained from the sources made available through this repository does so at their own risk. We always test all the code on our devices before publishing it on the repository, however we cannot guarantee the absolute absence of bugs nor of potential side effects.
Contact
To reach out, visit our M17 Reflector or join our Matrix room for general discussion #openrtx_general:matrix.org or the Matrix space #openrtx:matrix.org which contains many additional rooms or our Discord Server.
Donate
To support the development of OpenRTX you can donate using Liberapay.
If you want to donate hardware to facilitate porting and development of OpenRTX, please contact us.
License
This software is released under the GNU GPL v3.
minmea is released under the DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE v2.
QRCode is released under the MIT License.
Code for STM32F405 USB driver is released under the MCD-ST Liberty SW License Agreement V2.
uf2conf.py and related files are released by Microsoft Corporation under MIT license.
Credits
OpenRTX is being made by:
- Niccolò Izzo IU2KIN n@izzo.sh
- Silvano Seva IU2KWO silseva@fastwebnet.it
- Federico Amedeo Izzo IU2NUO federico@izzo.pro
- Frederik Saraci IU2NRO frederik.saraci@gmail.com
Our wholehearted thanks go to the following contributors from the community:
- Joseph Stephen VK7JS, who implemented voice prompts
All this is possible by the huge reverse engineering effort of Travis Goodspeed and all the contributors of the md380tools.
A huge thanks goes to Roger Clark, and his OpenGD77 (repo no longer available) which not only inspired this project, but as a precursor, provided a working code example for the GD77 radio family.
A warm thank you goes to Wojciech Kaczmarski SP5WWP and the M17 community for bringing their libre protocol into our obscure undocumented hardware.
Also, a thank you for donating hardware to this project goes to:
- M17 Project
- laurivosandi
- smeegle5000
And thanks to everyone who donated via LiberaPay.
Translation
Contribute to the crowdsourced effort to make OpenRTX more accessible by helping translate it. Weblate proudly supports libre projects like OpenRTX with their tools to help this.
