Actualiser README.md

This commit is contained in:
Xavier 2026-06-26 15:19:11 +02:00
parent 0ba62c225f
commit c60ebebd0b

213
README.md
View File

@ -1,106 +1,119 @@
<b>Ver: 2.12.2m10</b> # 📻 UHSDR
<br/>
<br/> ## 📌 Description
More News since 2.12.2m9t by Yuri, thank's friend, <br/> **UHSDR** (*Universal Ham Software Defined Radio*) est un firmware open-source pour les **transceivers radioamateurs autonomes**.
I give a arm_non_eabi.sh for install automatique for linux kernel 5.X mini<br> Il supporte les microcontrôleurs **STM32F4 et STM32F7**, et propose :
download the project: git clone http://fra1od.freeboxos.fr:3000/magnum88/UHSDR<br/> - Modes analogiques : **SSB, AM, FM, AM synchrone**.
or download ZIP file and extract the folder UHSDR<br/> - Modes numériques : **FreeDV, RTTY, CW** (avec manipulateur Iambic/Ultimatic).
for make compilation in directory mchf-eclipse<br/> - Interface **CAT et audio via USB**.
execute: <br/> - **Bootloader** pour les mises à jour via USB ou clé USB.
make clean //for clean old compil<br/>
make all //for compilation project for have .dfu or .bin<br/> > 💡 **Origine** : Basé sur le projet [mcHF](http://www.m0nka.co.uk/) de Chris (M0NKA) et Clint (KA7OEI), sous licence **GPLv3** depuis février 2017.
make bootloader //for compilation boot ex 5.04 for have .dfu<br/> M0NKA Chris, KA7OEI Clint, DF8OE Andreas, DB4PLE Danilo, DD4WH Frank, DL2FW Michael et SP9BSL Slawek
after good make you have firmware for .dfu and .elf and .bin<br> ---
if you want change compilation for different radio, ex RS928+<br>
active tag on uhsdr_board_config.h change //#define R928_PLUS by #define R928_PLUS<br> ---
for MCHF first 512k active //#define IS_SMALL_BUILD by #define IS_SMALL_BUILD<br>
for optional you have color too: //#define GREY_STYLE or //#define SEPIA_STYLE<br> ## 📦 Version 2.12.2m10
<br> *Dernières améliorations par **Yuri** et **Xavier (Xav)**.*
For first more i say on this:<br/>
GCC upgarde with version 10.X not good for compilation, <br/> ### ✨ Nouveautés
the old version is 9.X no check header tag on script C or C++,<br/> Version | Auteur | Modifications |
correction on this project UHSDR by Xav for this,<br> |---------------|---------|----------------------------------------------------------------------------------------------------|
on uhsdr_board.h line 246 at 248 change var for static for not error more multiple definition! on bw_data, mem_data and xvtr_data<br/> | **2.12.2m10** | Yuri | Script `arm_non_eabi.sh` pour **installation automatique** sur les noyaux Linux **5.X** (mini). |
and i find a old error on freedv on c2wideband.c for function abs corerction for fabs on 2 line this page<br/> | **2.12.2m9** | - | Corrections de compilation (GCC 10.X → 9.X). |
<br/> | **2.12.2m8** | Xav | **Ajout du mode CQ Contest** (voir [section dédiée](#-cq-contest-mod)). |
<br/> Add Cq Contest Mod on 2.12.2m8 by Xav<br/> | **2.12.2m7** | Xav | **Nouvel écran de boot** au démarrage. |
New screen boot on start since 2.12.2m7 on my project by Xav
<br> ---
## 🛠 Prérequis
| Outil/Dépendance | Version | Description |
|------------------------|---------------|-----------------------------------------------------------------------------|
| **Git** | - | Pour cloner le dépôt. |
| **GCC** | **9.X** | ⚠️ **Version 10.X non compatible** (problèmes de compilation). |
| **Make** | - | Pour compiler le projet. |
| **ARM Toolchain** | `arm-none-eabi-gcc` | Outil de compilation pour STM32. |
---
## 🚀 Installation
### 1⃣ Récupérer le projet
```bash
git clone http://fra1od.freeboxos.fr:3000/magnum88/UHSDR
cd UHSDR
2⃣ Compiler le firmware
Dans le répertoire mchf-eclipse :
bash
Copier
make clean # Nettoie les anciennes compilations
make all # Génère les fichiers .dfu, .bin et .elf
make bootloader # Compile le bootloader (ex: v5.04)
✅ Résultat : Les firmwares seront générés dans les formats :
.dfu (pour mise à jour via USB)
.bin (fichier binaire)
.elf (pour débogage)
⚙️ Configuration
Personnaliser la compilation
Modifiez le fichier uhsdr_board_config.h pour adapter le firmware à votre matériel :
Option
Action
Radio spécifique
Décommentez #define R928_PLUS pour activer le support du RS928+.
Mémoire limitée
Décommentez #define IS_SMALL_BUILD pour les premiers 512 Ko (ex: mcHF v1).
Style d'affichage
Choisissez un thème : #define GREY_STYLE ou #define SEPIA_STYLE.
🔧 Corrections appliquées
Problème GCC 10.X :
La version 9.X est recommandée (moins stricte sur les en-têtes C/C++).
Solution : Utilisez le script arm_non_eabi.sh pour une installation automatique.
Erreurs de compilation :
Dans uhsdr_board.h (lignes 246-248) :
Remplacez var par static pour bw_data, mem_data et xvtr_data (évite les conflits de définition multiple).
Dans freedv/c2wideband.c :
Remplacez abs par fabs (2 occurrences) pour une meilleure précision.
🎯 CQ Contest Mod (depuis 2.12.2m8)
<img src="http://xavier.debert.free.fr/MCHF/1629722823447.jpg" width="20%" border="0"> <img src="http://xavier.debert.free.fr/MCHF/1629722823447.jpg" width="20%" border="0">
In MENU select DEBUG Nouvelle fonctionnalité pour gérer les concours radioamateurs directement depuis l'interface.
<br> 📱 Menu et utilisation
In end list have 2 new line CONTEST Yes or No for activation
<br> Activer le mode Contest :
And color for selection ex:Red
<br> Allez dans MENU → DEBUG.
<img src="http://xavier.debert.free.fr/MCHF/1631858346843.jpg" width="20%" border="0"> Sélectionnez CONTEST: Yes (ou No pour désactiver).
<br> Couleur de sélection : Rouge par défaut.
For Have the new menu if Mod is actived, Switch push F3 for have CQ Contest <img src="http://xavier.debert.free.fr/MCHF/1631858346843.jpg" width="20%" border="0">
<br> Lancer un CQ Contest :
Appuyez sur F3 pour afficher le menu CQ Contest.
<img src="http://xavier.debert.free.fr/MCHF/1631858047458.jpg" width="20%" border="0"> <img src="http://xavier.debert.free.fr/MCHF/1631858047458.jpg" width="20%" border="0">
<br> Gestion des QSO :
The Mem saving a finish QSO
<br> Mem : Sauvegarde un QSO terminé.
The Try saving a QSO no make for try later Try : Sauvegarde un QSO en cours (à finaliser plus tard).
<br> Basculer entre Mem/Try : Appuyez sur F3 pour passer de l'un à l'autre.
The Cq switch list Mem or Try for switch one by one push same F3
<br> Exemple quand le QSO est fini.
Ex finish QSO
<br>
<img src="http://xavier.debert.free.fr/MCHF/1631858047460.jpg" width="20%" border="0"> <img src="http://xavier.debert.free.fr/MCHF/1631858047460.jpg" width="20%" border="0">
<br>
<br>
Video in English
<br>
[![Watch the video](http://xavier.debert.free.fr/MCHF/uhsdr-logo.png)](https://youtu.be/2OXR09mxWS4) [![Watch the video](http://xavier.debert.free.fr/MCHF/uhsdr-logo.png)](https://youtu.be/2OXR09mxWS4)
<br> ---
<br>
<div align="center"><h1><b>The UHSDR Project</b></h1></div>
UHSDR stands for **U**niversal**H**am**S**oftware**D**efined**R**adio.
The project provides the firmware to run standalone HAM transceivers.
It currently supports STM32F4 and STM32F7 MCU based QSD designs. The
current firmware provides receive and transmit for various analog modes
(SSB,AM, FM) including modes like Synchronous AM, plus digital modes
like FreeDV, RTTY and of course CW (including Iambic/Ultimatic keyer).
An USB CAT and audio interface is part of the firmware as well. The
bootloader, which is another part of the project, permits to update the
firmware and bootloader using various means like USB disk or USB cable.
The base of the firmware was started by Chris, M0NKA, and Clint, KA7OEI
as part of the [mcHF](http://www.m0nka.co.uk/) project. In February 2017
both agreed to change firmware license to GPLv3. Because of this the mcHF
firmware has been extended in this project with new functionality
and also with support for use on different transceiver hardware. For
clarifying different license models on mcHF hardware and mcHF firmware the
name of the firmware changed to UHSDR.
The intent of this project is to give full support for mcHF [(and all
other known and listed hardware platforms)](https://github.com/df8oe/UHSDR/wiki/Supported-Hardware) as long as there are
contributors willing to support the given hardware.
So this is the best place to start with up-2-date developed firmware and
bootloader for mcHF.
Binaries of actual development are available as "bleeding edge builds".
Since 08-19-2017 all binaries which are populated are archived and can
accessed at GitHub startup page (see link a few lines down).
If you want to see the recent progress of the project, have a look [at
the commits here](https://github.com/df8oe/mchf-github/commits/active-devel).
You can find descriptions of menus and operating hints at [our WIKI](https://github.com/df8oe/UHSDR/wiki/)
All this is bundled in [startup page](https://df8oe.github.io/UHSDR/).
Have fun - Open-Source opens possibilities!
M0NKA, Chris<br/>
KA7OEI, Clint<br/>
DF8OE, Andreas<br/>
DB4PLE, Danilo<br/>
DD4WH, Frank<br/>
DL2FW, Michael<br/>
SP9BSL, Slawek<br/>
and the complete UHSDR community