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.
|
2023-09-14 10:16:45 +00:00
|
|
|
You can edit those changes by (currently) editing the MakeFile, look for these lines at the top of the file ..
|
|
|
|
|
|
|
|
* ENABLE_AIRCOPY := 0
|
|
|
|
* ENABLE_FMRADIO := 0 FM band 2 radio
|
|
|
|
* ENABLE_OVERLAY := 1
|
|
|
|
* ENABLE_UART := 1 without this you can't configure the radio with your PC
|
|
|
|
* ENABLE_NOAA := 0 NOAA channels
|
|
|
|
* ENABLE_VOICE := 0 strange voices
|
|
|
|
* ENABLE_ALARM := 0 TX alarms
|
|
|
|
* ENABLE_BIG_FREQ := 0 big font for the frequencies
|
|
|
|
* ENABLE_KEEP_MEM_NAME := 1 maintain the channel name when (re)saving a memory channel
|
|
|
|
* ENABLE_CHAN_NAME_FREQ := 1 show the channel frequency below the channel name/number
|
|
|
|
* ENABLE_WIDE_RX := 1 enable the RX in the full 18MHz to 1300MHz (though frontend is not tuned for full range)
|
|
|
|
* ENABLE_TX_WHEN_AM := 0 allow TX when RX set to AM
|
|
|
|
* ENABLE_TAIL_CTCSS_PHASE_SHIFT := 1 use CTCSS tail phase shift rather than QS's 55Hz tone method
|
|
|
|
* #ENABLE_SINGLE_VFO_CHAN := 1 not yet implemented
|
|
|
|
* #ENABLE_BAND_SCOPE := 1 not yet implemented
|
2023-09-14 08:56:30 +00:00
|
|
|
|
|
|
|
To enable the custom option, set the above option to '1'
|
2023-09-09 07:03:56 +00:00
|
|
|
|
|
|
|
# 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.
|
|
|
|
|