2023-08-09 23:00:44 +08:00
# Open reimplementation of the Quan Sheng UV K5 v2.1.27 firmware
2023-09-06 07:26:30 +08:00
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.
2023-08-09 23:00:44 +08:00
2023-09-11 04:15:46 +08:00
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:
2023-09-06 07:26:30 +08:00
* https://github.com/fagci/uv-k5-firmware-fagci-mod
2023-09-09 19:27:37 +08:00
* https://github.com/OneOfEleven/uv-k5-firmware-custom
2023-09-10 03:40:32 +08:00
* https://github.com/Tunas1337/uv-k5-firmware (Check the branches)
2023-09-10 20:23:07 +08:00
* https://github.com/rebezhir/openquack for Russian users
2023-08-11 19:51:53 +08:00
2023-09-02 00:14:26 +08:00
# 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.
2023-09-06 07:26:30 +08:00
You can get an appropriate version from: https://developer.arm.com/downloads/-/gnu-rm
2023-09-02 00:14:26 +08:00
2023-08-11 19:51:53 +08:00
# Building
To build the firmware, you need to fetch the submodules and then run make:
```
2023-08-16 16:51:46 +08:00
git submodule update --init --recursive --depth=1
2023-08-11 19:51:53 +08:00
make
```
2023-09-17 02:47:22 +08:00
# Flashing with the official updater
* Use the firmware.packed.bin file
# Flashing with [k5prog](https://github.com/piotr022/k5prog)
* ./k5prog -F -YYY -b firmware.bin
# Flashing with SWD
2023-09-10 03:40:32 +08:00
* If you own a JLink or compatible device and want to use the Segger software, you can find a flash loader [here ](https://github.com/DualTachyon/dp32g030-flash-loader )
* 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.
2023-09-16 06:24:32 +08:00
# Support
2023-09-20 05:13:44 +08:00
* If you like my work, you can support me through https://ko-fi.com/DualTachyon
2023-09-16 06:24:32 +08:00
2023-09-06 07:26:30 +08:00
# Credits
Many thanks to various people on Telegram for putting up with me during this effort and helping:
* [Mikhail ](https://github.com/fagci/ )
* [Andrej ](https://github.com/Tunas1337 )
2023-09-08 02:12:43 +08:00
* [Manuel ](https://github.com/manujedi )
2023-09-06 07:26:30 +08:00
* @wagner
* @Lohtse Shar
* [@Matoz ](https://github.com/spm81 )
* @Davide
* @Ismo OH2FTG
2023-09-09 19:27:37 +08:00
* [OneOfEleven ](https://github.com/OneOfEleven )
2023-09-06 07:26:30 +08:00
* and others I forget
2023-08-09 23:00:44 +08:00
# 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.
