This repository is a preservation project of the UV K5 v2.1.27 firmware. It is dedicated to understanding how the radio works and help developers making their own customisations/fixes/etc. It is by no means fully understood or has all variables/functions properly named, as this is best effort only. As a result, this repository will not include any customisations or improvements over the original firmware.
You can find an alternate branch called "fixes" that contains fixes for real bugs present in the original firmware. This branch will also accumulate fixes/improvements from newer releases by QS (for example v2.01.31).
For improved/better firmware and new features, you can find the following repositories by other collaborators:
- https://github.com/fagci/uv-k5-firmware-fagci-mod
- https://github.com/OneOfEleven/uv-k5-firmware-custom
- https://github.com/Tunas1337/uv-k5-firmware (Check the branches)
- https://github.com/rebezhir/openquack for Russian users
- press UP / DOWN key to change frequency
- press 1 / 7 to control measurement time (increasing "sensitivity")
- press 2 / 8 to to set frequency change step
- press 9 / 3 for zoom in / zoom out
- press and hold * / F to set squelch level
- press 6 to BW 6.25KHz->12.5KHz->25KHz
- press 0 to mode FM->AM->SSB->BYP->RAW
- press EXIT to disable spectrum view
arm-none-eabi GCC version 10.3.1 is recommended, which is the current version on Ubuntu 22.04.03 LTS. Other versions may generate a flash file that is too big. You can get an appropriate version from: https://developer.arm.com/downloads/-/gnu-rm
To build the firmware, you need to fetch the submodules and then run make:
git submodule update --init --recursive --depth=1
make
- ALL COMMANDS ARE RUN IN THE CODESPACE, nothing modifies you pc, don't run any command on your local pc
- you need a github account
- open your codespaces: https://github.com/codespaces
- click on "New codespace"
- Repository: nakhonthai/uv-k5-firmware-aprs-mod
- Branch: main
- Region/Machine type: Doesn't matter
- click on "New codespace"
- execute
sh -c "$(curl -fsSL https://raw.githubusercontent.com/manujedi/UV_K5-Tools/main/TutOnlineEnv/SetupGCC.sh)"in the Terminal (or run the commands by hand to see what they do)- this takes some time (about 1min)
- your codespace should stop (if not select the codespace and press enter), click restart
- Build the FW (do not use
ninja, replaceninjawithmake. Commands are similar to the ones in the README):mkdir buildcd buildcmake ..makemake rssi_sbar_encoded
- Use the firmware.packed.bin file
Flashing with k5prog
- ./k5prog -F -YYY -b firmware.bin
- If you own a JLink or compatible device and want to use the Segger software, you can find a flash loader here
- If you want to use OpenOCD instead, you can use run "make flash" off this repo.
- The DP32G030 has flash masking to move the bootloader out of the way. Do not try to flash your own way outside of the above methods or risk losing your bootloader.
- If you like my work, you can support me through https://ko-fi.com/DualTachyon
Many thanks to various people on Telegram for putting up with me during this effort and helping:
- Mikhail
- Andrej
- Manuel
- @wagner
- @Lohtse Shar
- @Matoz
- @Davide
- @Ismo OH2FTG
- OneOfEleven
- and others I forget
Copyright 2023 Dual Tachyon https://github.com/DualTachyon
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.