Home

Awesome

Open reimplementation of the Quan Sheng UV K5 v2.1.27 firmware

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:

Compiler

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

Building

To build the firmware, you need to fetch the submodules and then run make:

git submodule update --init --recursive --depth=1
make

Flashing with the official updater

Flashing with k5prog

Flashing with SWD

Support

Credits

Many thanks to various people on Telegram for putting up with me during this effort and helping:

License

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.