2023-09-09 07:03:56 +00:00
|
|
|
# Open reimplementation of the Quan Sheng UV K5 v2.1.27 firmware
|
|
|
|
|
|
2023-09-09 07:18:49 +00:00
|
|
|
This repository is a cloned and customized version of DualTachyon's open firmware found here ..
|
2023-09-09 07:03:56 +00:00
|
|
|
|
|
|
|
|
https://github.com/DualTachyon/uv-k5-firmware
|
|
|
|
|
|
2023-09-09 07:18:49 +00:00
|
|
|
Am amazing achievement if you ask me !
|
|
|
|
|
|
2023-09-09 07:03:56 +00:00
|
|
|
# User customization
|
|
|
|
|
|
|
|
|
|
This version you can customize at compile time by making various changes to the makefile.
|
|
|
|
|
You can edit those changes by (currently) editing the MakeFile, look for these lines ..
|
|
|
|
|
|
2023-09-11 08:55:59 +00:00
|
|
|
* CFLAGS += -DDISABLE_BIG_FREQ .. show frequencies using smaller font
|
|
|
|
|
* CFLAGS += -DDISABLE_NOAA .. remove NOAA channels option from the firmware
|
|
|
|
|
* CFLAGS += -DDISABLE_VOICE .. remove spoken VOICES option from the firmware
|
|
|
|
|
* CFLAGS += -DDISABLE_AIRCOPY .. remove AIRCOPY option
|
|
|
|
|
* CFLAGS += -DDISABLE_ALARM .. remove the ALARM transmit option from the firmware
|
|
|
|
|
* CFLAGS += -DKEEP_MEM_NAME .. keep the memory channels name when re-saving a channel
|
|
|
|
|
* CFLAGS += -DCHAN_NAME_FREQ .. show the channel frequency (as well as channel number/name)
|
2023-09-12 18:53:54 +00:00
|
|
|
* CFLAGS += -DRX_ANY_FREQ .. allow RX on any frequency from 18MHz to 1300MHz
|
2023-09-11 08:55:59 +00:00
|
|
|
* #CFLAGS += -DENABLE_TX_WHEN_AM .. enable TX when radio set to AM (radio does NOT do AM, the adverts are false)
|
|
|
|
|
* #CFLAGS += -DSINGLE_VFO_CHAN .. (not yet implemented) show a single VFO/CHANNEL if dual-watch/cross-band are disabled
|
|
|
|
|
* #CFLAGS += -DBAND_SCOPE .. (not yet implemented) add a band scope/spectrum/panadapter option
|
2023-09-09 07:03:56 +00:00
|
|
|
|
|
|
|
|
To enable the custom option just uncomment the line by removing the starting '#'.
|
|
|
|
|
|
|
|
|
|
# Other changes made
|
|
|
|
|
|
2023-09-10 17:11:25 +00:00
|
|
|
* Various bugs fixed that the QS firmware had (TX tail, Menu confimation etc)
|
2023-09-11 08:10:11 +00:00
|
|
|
* Added new bugs
|
2023-09-11 08:55:59 +00:00
|
|
|
* Battery voltage boot screen now includes percentage
|
2023-09-10 17:11:25 +00:00
|
|
|
* Slightly less intense menu style
|
|
|
|
|
* AM RX now allowed everywhere, although the radio really doesn't do AM, the adverts are a con !
|
2023-09-10 04:49:39 +00:00
|
|
|
* Finer RSSI bar steps
|
2023-09-11 09:17:02 +00:00
|
|
|
* Nicer/cleaner big numeric font than original QS big numeric font
|
2023-09-13 01:01:35 +00:00
|
|
|
* Various menu re-wordings - to try and reduce 'WTH does that mean ?'
|
2023-09-09 10:36:09 +00:00
|
|
|
|
2023-09-09 07:03:56 +00: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.
|
|
|
|
|
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
|
|
|
|
|
```
|
|
|
|
|
|
2023-09-11 07:57:48 +00:00
|
|
|
To compile directly in windows without the need of a linux virtual machine:
|
2023-09-11 07:54:27 +00:00
|
|
|
|
|
|
|
|
```
|
2023-09-11 10:56:59 +00:00
|
|
|
1. Download and install "gcc-arm-none-eabi-10.3-2021.10-win32.exe" from https://developer.arm.com/downloads/-/gnu-rm
|
|
|
|
|
2. Download and install "gnu_make-3.81.exe" from https://gnuwin32.sourceforge.net/packages/make.htm
|
|
|
|
|
3. You may (or may not) need to reboot your PC after installing the above
|
2023-09-11 07:54:27 +00:00
|
|
|
```
|
2023-09-09 07:03:56 +00:00
|
|
|
|
2023-09-11 10:56:59 +00:00
|
|
|
Then you can run 'win_make.bat' from the directory you saved this source code too.
|
|
|
|
|
You may need to edit the bat file (path to make.exe) depending on where you installed 'gnu_make' too.
|
2023-09-11 08:10:11 +00:00
|
|
|
|
2023-09-09 07:03:56 +00:00
|
|
|
# Credits
|
|
|
|
|
|
|
|
|
|
Many thanks to various people on Telegram for putting up with me during this effort and helping:
|
|
|
|
|
|
2023-09-11 08:10:11 +00:00
|
|
|
* [DualTachyon](https://github.com/DualTachyon)
|
|
|
|
|
* [Mikhail](https://github.com/fagci)
|
2023-09-09 07:03:56 +00:00
|
|
|
* [Andrej](https://github.com/Tunas1337)
|
2023-09-11 08:10:11 +00:00
|
|
|
* [Manuel](https://github.com/manujedi)
|
2023-09-09 07:03:56 +00:00
|
|
|
* @wagner
|
|
|
|
|
* @Lohtse Shar
|
|
|
|
|
* [@Matoz](https://github.com/spm81)
|
|
|
|
|
* @Davide
|
|
|
|
|
* @Ismo OH2FTG
|
2023-09-11 08:10:11 +00:00
|
|
|
* [OneOfEleven](https://github.com/OneOfEleven)
|
2023-09-09 07:03:56 +00:00
|
|
|
* and others I forget
|
|
|
|
|
|
|
|
|
|
# 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.
|
|
|
|
|
|
