Add Chirp section

Getting-started.md

@@ -16,7 +16,7 @@ If you only want to program a frequency, test the radio, and save it:
 1. Save the setup with `ChSave` if you want to keep it as a memory channel.
 1. Switch back to `channel mode` with `F` + `3 VFO/MR` when you want to browse saved channels.
 
-If you prefer programming from a computer, use the `CHIRP` driver provided with each firmware release, or another compatible programming tool for this firmware.
+If you prefer programming from a computer, use the `CHIRP` driver provided with each firmware release. See [Programming with CHIRP](./Programming-with-CHIRP) for the dedicated `Fusion` workflow.
 
 > [!WARNING]
 > Do not use Quansheng CPS. It overwrites custom settings.
@@ -94,6 +94,7 @@ These terms appear throughout the wiki:
 ## Where to go next
 
 * [Radio operation](./Radio-operation) for VFO/channel usage, status bar, `F Lock`, `TXLock`, and sleep behavior
+* [Programming with CHIRP](./Programming-with-CHIRP) for computer programming with the dedicated driver included in each release
 * [Scanning](./Scanning) for frequency scan, memory scan, `ScnRng`, and DCS / CTCSS scanning
 * [Menu](./Menu) for every menu item and the hidden menu
 * [Button functions](./Button-functions) for shortcuts, long presses, and programmable keys

Home.md

@@ -7,7 +7,7 @@ This firmware is a fork of the [F4HWN custom firmware](https://github.com/armel/
 
 The Fusion edition brings together, in a single firmware, all the different editions that were previously released separately for the UV-K5 V1. In other words, instead of choosing between multiple specialized firmwares, Fusion integrates all features into one unified build, and more. 
 
-If you are new to the firmware, a good reading order is: [Getting started](./Getting-started), [Radio operation](./Radio-operation), [Scanning](./Scanning), [Menu](./Menu), then [Button functions](./Button-functions).
+If you are new to the firmware, a good reading order is: [Getting started](./Getting-started), [Programming with CHIRP](./Programming-with-CHIRP) if you manage the radio from a computer, [Radio operation](./Radio-operation), [Scanning](./Scanning), [Menu](./Menu), then [Button functions](./Button-functions).
 
 > [!WARNING]
 > THIS FIRMWARE HAS NO REAL BRAIN. PLEASE USE YOUR OWN.
@@ -19,6 +19,7 @@ If you are new to the firmware, a good reading order is: [Getting started](./Get
 ## Start here
 
 * New to the firmware: [Getting started](./Getting-started)
+* Want to program the radio from a computer: [Programming with CHIRP](./Programming-with-CHIRP)
 * Want to understand scanning: [Scanning](./Scanning#memory-channels-scanning)
 * Want to understand the status bar: [Radio operation](./Radio-operation#status-bar)
 * Want to explore specialized features: [Advanced features](./Advanced-features)
@@ -28,6 +29,7 @@ If you are new to the firmware, a good reading order is: [Getting started](./Get
 ## Chapters
 
 * [Getting started](./Getting-started)
+* [Programming with CHIRP](./Programming-with-CHIRP)
 * [Troubleshooting](./Troubleshooting)
 * [Radio operation](./Radio-operation)
 * [Scanning](./Scanning)

Programming-with-CHIRP.md

@@ -0,0 +1,111 @@
+> 🌐 **Translate**  
+> Automatic translation is available via Google Translate: [Open translated version](https://translate.google.com/translate?sl=auto&u=https://github.com/armel/uv-k1-k5v3-firmware-custom/wiki/Programming-with-CHIRP/).
+
+# Programming with CHIRP
+
+This page explains how to use `CHIRP` with the dedicated `Fusion` driver included with each firmware release.
+
+> [!WARNING]
+> Use the `CHIRP` driver from the same firmware release as the one installed on your radio.
+> Do not use Quansheng CPS.
+> Do not use a generic `UV-K5` or non-`Fusion` driver.
+
+## Compatibility
+
+The dedicated driver is only for:
+
+* `UV-K1`
+* `UV-K5 V3`
+* `Fusion` edition
+
+It is not for:
+
+* `UV-K5 V1 / V2`
+* other Quansheng models
+* other firmware editions
+
+Because `Fusion` uses a different memory layout, another driver can read or write the wrong data.
+
+## Before you start
+
+* make sure the radio really runs the matching `Fusion` release
+* locate the included driver file in that release package
+* the file name starts with `f4hwn.fusion.chirp` and ends with `.py`
+* be ready to save a backup of the radio image before editing anything
+
+> [!NOTE]
+> `CHIRP` may show this driver as experimental. That is expected. Read the radio first and save the downloaded image before changing anything.
+
+## Load the dedicated driver in CHIRP
+
+1. Open `CHIRP`.
+1. If `File > Load Module...` is not available, enable CHIRP developer features first, then restart `CHIRP`.
+1. Use `File > Load Module...` and select the `f4hwn.fusion.chirp...py` file included with the firmware release.
+1. Once the module is loaded, `CHIRP` should offer the `Fusion` model entry.
+
+## Download from the radio
+
+1. Turn the radio on.
+1. Connect a compatible programming cable to the `mic/spkr` connector.
+1. Make sure the connector is firmly inserted.
+1. In `CHIRP`, choose `Radio > Download From Radio...`
+1. Select the correct serial port.
+1. Select `Vendor`: `Quansheng`.
+1. Select `Model`: `UV-K1 & UV-K5 V3 (F4HWN Fusion)`.
+1. Start the download and wait until the radio image has been fully read.
+1. Save that image as your backup before making changes.
+
+> [!TIP]
+> If communication fails, disconnect the cable, turn the radio on first, then reconnect the cable. The dedicated driver warns that some setups may fail if the radio was powered on with the cable already attached.
+
+## Show the extra fields
+
+After the download, enable `View > Show Extra Fields` in `CHIRP`.
+
+This is important because the dedicated `Fusion` driver exposes several channel-specific fields through the `Extra` group. Without `Show Extra Fields`, some firmware-specific parameters remain hidden in the channel editor.
+
+Typical examples include:
+
+* `TXLock`
+* `BusyCL`
+* `FreqRev`
+* `PTT ID`
+* `Compander`
+* `Scanlists`
+
+## Edit and upload
+
+You can then edit memories, names, and the supported settings.
+
+When you are ready:
+
+1. Review your changes.
+1. In `CHIRP`, choose `Radio > Upload To Radio...`
+1. Use the same port, vendor, and model.
+1. Wait until the upload is fully complete before touching the cable or turning the radio off.
+
+> [!WARNING]
+> Leave calibration-related or advanced items alone unless you know exactly what they do.
+
+## Good practice
+
+* always use the driver included with the same firmware release
+* always download first, then save a backup
+* after a firmware update, reload the newer driver module from that release
+* use `CHIRP` for bulk programming, not Quansheng CPS
+
+## If something looks wrong
+
+Check these points:
+
+1. the radio is really a `UV-K1` or `UV-K5 V3`
+1. the radio really runs the `Fusion` edition
+1. `CHIRP` loaded the dedicated `Fusion` driver, not another `UV-K5` module
+1. the cable is fully inserted
+1. the selected serial port is the correct one
+
+## Related pages
+
+* [Getting started](./Getting-started)
+* [Radio operation](./Radio-operation)
+* [Troubleshooting](./Troubleshooting)

Radio-operation.md

@@ -38,7 +38,7 @@ Each VFO can operate independently in either frequency mode or channel mode. To
 
 In `frequency mode`, you manually enter the frequency with the keypad. You can also change different options for that VFO in the menu (the first 13 menu entries). Once the VFO is set up, the settings can be saved to a memory channel by going into the `ChSave` menu and choosing the target memory channel.
 
-In `channel mode`, you can switch between saved memory channels. Memory channels can be added manually as mentioned above or programmed from a computer with the `CHIRP` driver provided with each firmware release, or another compatible tool.
+In `channel mode`, you can switch between saved memory channels. Memory channels can be added manually as mentioned above or programmed from a computer with the `CHIRP` driver provided with each firmware release. See [Programming with CHIRP](./Programming-with-CHIRP) for the dedicated `Fusion` workflow.
 
 For frequency scan, memory scan, `ScnRng`, and DCS / CTCSS scanning, see [Scanning](./Scanning).
 
@@ -121,6 +121,7 @@ When `PTT` is pressed, the 1750 Hz tone can be activated by pressing [`Side butt
 ## Related pages
 
 * [Getting started](./Getting-started)
+* [Programming with CHIRP](./Programming-with-CHIRP)
 * [Scanning](./Scanning)
 * [Menu](./Menu)
 * [Button functions](./Button-functions)

Troubleshooting.md

@@ -27,7 +27,7 @@ Do not use Quansheng CPS. It overwrites custom settings.
 
 Use the `CHIRP` driver provided with each firmware release, or another compatible programming tool instead.
 
-See also: [Getting started](./Getting-started) and [Radio operation](./Radio-operation#basic-operation--configuration).
+See also: [Programming with CHIRP](./Programming-with-CHIRP), [Getting started](./Getting-started), and [Radio operation](./Radio-operation#basic-operation--configuration).
 
 ## I changed a memory channel setting, but it did not stay saved
 
@@ -129,6 +129,7 @@ See also: [Button functions](./Button-functions) and [Advanced features](./Advan
 ## Where to go next
 
 * [Getting started](./Getting-started)
+* [Programming with CHIRP](./Programming-with-CHIRP)
 * [Radio operation](./Radio-operation)
 * [Scanning](./Scanning)
 * [Advanced features](./Advanced-features)

_Sidebar.md

@@ -4,6 +4,7 @@
 
 * [Home](./Home)
 * [Getting started](./Getting-started)
+* [Programming with CHIRP](./Programming-with-CHIRP)
 * [Troubleshooting](./Troubleshooting)
 
 ## Daily use