Projection des presets radio par type d'aéronef¶

Public : développeurs. Comment le build projette les listes de canaux (channel_lists, le « mode plan » de presets.yaml) sur les radios physiques de chaque type d'aéronef, en tenant compte de ses particularités matérielles (canal 0, slots réservés, canaux spéciaux en dur, mapping par clé…), plus la priorité/couleur des canaux et les planchettes par type (ADR 0012).

Décision d'architecture : ADR 0010 (étend ADR 0003). Analyse amont : exploration. Côté mission-maker : format presets.yaml.

Le modèle en bref¶

Le mission-maker déclare, une fois par coalition, des listes de canaux par rôle radio fonctionnel (channel_lists) — pas par radio physique. Au build, un packer lit les radios réelles de chaque type depuis les specs DCS et projette chaque liste sur la bonne radio, en appliquant la règle de layout propre au type.

channel_lists (mission-maker, par rôle)
        │
        ▼
   packer  ──lit──►  dcs-radio-specs.yaml   (bandes/modulation par radio, auto-généré)
        │      ──lit──►  dcs-radio-layouts.yaml (particularités par type, maintenu à la main)
        ▼
   PresetDefinition  ──►  injecteur existant  ──►  unit["Radio"] + kneeboard

Le packer produit des objets PresetDefinition et réutilise tel quel l'injecteur, la validation de bande et la génération de kneeboard existants. Une affectation explicite dans presets_assignments (format historique) reste la voie de surcharge manuelle : elle l'emporte toujours sur le packer.

Fichiers source¶

Fichier	Rôle
`dcs-radio-layouts.yaml`	Source de vérité des particularités par type. Maintenu à la main. Chaque primitive y est documentée en tête de fichier.
`dcs-radio-specs.yaml`	Plages de fréquences / modulation par radio physique. Auto-généré (`poetry run update-radio-specs`), ne jamais éditer à la main.
`presets_manager.py`	Le packer et ses règles : `_assign_roles_by_position` (défaut par bande), `_check_layout_radio_count` (garde de comptage), `_channel_list_for_role` (résolution de rôle).

Rôles radio (vocabulaire fixe)¶

Le rôle porte la bande de fréquence ; un canal sans cette bande est retiré de la liste (signalé sous validate, silencieux sous build).

Rôle	Sens
`primary_1`	1re radio V/UHF (bande UHF)
`primary_2`	2e radio V/UHF (bande VHF) ; aussi la radio unique des warbirds
`fm_substitute`	FM comme 2e radio (hélicoptères à une seule V/UHF)
`fm_supplement`	FM en plus de deux V/UHF (avions d'attaque)
`fm_secondary`	2e FM supplémentaire (ex. OH-58D) ; par défaut = copie de `fm_supplement`

Défaut par bande (types sans entrée de layout)¶

Un type absent de dcs-radio-layouts.yaml passe par le défaut _assign_roles_by_position : chaque radio physique est classée par ses plages de fréquences, les radios sans ambiguïté (mono-bande) sont affectées directement — donc un ordre volontairement inversé (la VHF en radio 1 de l'A-10) se résout sans entrée explicite —, et l'ordre physique ne sert de repli que pour les radios combo réellement ambiguës (les deux ARC-210 identiques du F/A-18).

C'est pourquoi A-10C et A-10C_2 sont volontairement absents du fichier de layout : leur ordre VHF-first et la largeur de bande de l'ARC-210 sont déjà résolus correctement par le défaut.

Primitives de particularité¶

Déclarées par radio physique (index 1-based, ordre des specs / du .miz) dans dcs-radio-layouts.yaml :

Primitive	Effet
`rotate_last_to_head: true`	Rotation « canal 0 » : la dernière entrée de la liste passe en tête (slot 1), le reste suit en 2..N. Le kneeboard numérote les slots à partir de 00, comme le sélecteur (slot 13 = canal 12).
`keyed_groups: {block_size, bases}`	Mapping par clé (ADR 0012) : plusieurs rôles partagent une radio, chaque canal placé par sa clé (Group = `base + clé`, slot = `((Group − min_base) mod block_size) + 1`). Trous préservés, débordement rebouclé sur le slot 1 (le Group 100 du Viggen recycle le 20ᵉ canal de `primary_2`). Une clé au-delà de la part du rôle (`block_size / nb_rôles`) est droppée + `WARNING`.
`trailing_specials: [{…}, …]`	Canaux spéciaux en fin de radio. Chaque entrée est soit une constante d'airframe `{freq, mod}` (ex. E/F/G du Viggen), soit issue du plan `{priority: N}` — la fréquence vient du canal marqué `priority: N` (toujours AM ; slot vide si absent). `label` optionnel = nom pilote (Sp1, H…). Surchargeable via `presets_assignments`.
`reserved_head_slots: [idx, …]`	Slot(s) de tête réservé(s) alimentés par un index de la liste (slot « M » / « C »). `[20]` = dernière entrée déplacée en tête ; `[1, 20]` = 1re dupliquée en tête puis dernière déplacée. Un index au-delà d'une liste plus courte prend la dernière entrée de la liste : le slot existe dans le cockpit quelle que soit la longueur de la liste. `head_labels: [C, M]` nomme les slots de tête sur le kneeboard ; les presets qui suivent sont numérotés à partir de 01. Exclusif avec `rotate_last_to_head`.
`capacity: <int>`	Capacité physique de la radio : l'excédent est tronqué en fin de liste (silencieux, log debug).

Ordre de composition quand plusieurs primitives coexistent sur une radio : contenu de base (keyed_groups ou liste de rôle) → (chemin liste seulement) rotation ou slots de tête réservés (mutuellement exclusifs) → ajout des trailing_specials (au bord du bloc pour keyed_groups, sinon juste après le contenu) → troncature à la capacity.

Le packer vérifie aussi le nombre de radios déclarées contre les specs réelles et logue un WARNING en cas de dérive (_check_layout_radio_count) — utile après un patch DCS qui change le nombre de radios d'un appareil.

Types à particularité (état courant)¶

Ces types ont une entrée explicite dans dcs-radio-layouts.yaml ; tous les autres passent par le défaut par bande.

Type	Radios	Particularité
Mi-24P	2 (R-863 V/UHF + R-828 FM)	Radio 1 `primary_1` avec rotation canal 0 ; radio 2 `fm_substitute` standard.
CH-47Fbl1	3 (ARC-186 + ARC-164 + ARC-201D)	Radio 1 `fm_substitute` avec rotation (bande AM secondaire trompe le classement par bande → entrée explicite requise) ; radio 2 `primary_1` avec rotation ; radio 3 `fm_secondary`.
OH58D	4 (UHF, VHF, FM1, FM2)	Radios 1-2 : slot « M » réservé (`reserved_head_slots: [20]`). Radios 3-4 : slots « C » + « M » (`[1, 20]`).
AJS37 (Viggen)	1 (V/UHF, 47 slots)	`keyed_groups` (bloc Groups 100-139 : `primary_1` clés 1-20 → 101-120, `primary_2` clés 1-20 → 121-139 + recyclage du Group 100) + 7 `trailing_specials` slots 41-47 : Sp1/Sp2/Sp3 + H issus du plan (`priority` 1-4), E/F/G en dur. Casse volontairement l'iso-fonctionnalité ADR 0003 (slot 1 = 20ᵉ de `primary_2`, plus un mannequin).

Le détail slot-par-slot de chaque type (avec les commentaires expliquant le pourquoi de chaque choix) vit directement dans dcs-radio-layouts.yaml.

Priorité et couleur des canaux (ADR 0012)¶

Deux attributs facultatifs, posés par le mission-maker sur une entrée du plan (channel_lists) :

priority: N — rang d'importance. Universel : le canal est stabiloté sur toute planchette (marqueur Pn + cellules Name/Freq en orange). Routage Viggen : les priorités 1-4 remplissent FR22 Special 1/2/3 + FR24 H (bande selon le rôle : primary_1→UHF, primary_2→VHF ; toujours AM). Une seule entrée par valeur ; priority n'est pas lu depuis channels_collection.
color: <nom|#RRGGBBAA> — regroupe visuellement des canaux en colorisant la cellule CH (texte auto-contrasté). Accepté dans channel_lists et channels_collection (l'entrée du plan surcharge la définition). Un nom inconnu → WARNING + canal non colorisé. Décoratif, sans effet sur le packing.

Planchettes par type (ADR 0012)¶

Dix appareils Flaming Cliffs n'ont aucune radio réglable et reçoivent seulement une planchette : voir kneeboard_only.

Le build génère une planchette par (coalition, type) réellement injecté, déposée dans le dossier DCS du type : KNEEBOARD/<type>/IMAGES/presets.png (suffixée -<coalition> seulement si le même type vole dans les deux camps). Remplace l'ancien dossier générique KNEEBOARD/IMAGES/.

La page fait toujours 1536 × 2304, du 2:3 : DCS étire l'image pour remplir la fenêtre de la planchette (KNEEBOARD/indicator/init.lua, coordonnées de texture 0..1), et la planchette du cockpit mesure 0,142 × 0,214. Le titre est le nom lisible du type (name des specs). Chaque radio est un bloc titré par sa position et le poste des specs (COMM 1: ARC-210 devient 1. COMM 1 · ARC-210) ; kneeboard_title dans dcs-radio-layouts.yaml le remplace (l'AJS-37 : FR22 / FR24). Un bloc s'arrête à son dernier slot, libellés compris, et les blocs s'écoulent en deux colonnes (_paginate_blocks) : un bloc passe entier à la colonne suivante quand il y tient, seul un bloc plus haut qu'une colonne est coupé, et le surplus va sur presets_2.png. Pour l'AJS-37, la colonne CH affiche les libellés pilote (100-139 puis Sp1/Sp2/Sp3/E/F/G/H). Toute mission qui a des planchettes reçoit aussi KNEEBOARD/IMAGES/00-veaf-calibration.png, la mire qui sert à remettre une fenêtre redimensionnée au 2:3.

Ajouter ou corriger un type¶

Identifier les radios physiques de l'appareil dans dcs-radio-specs.yaml (index, bandes) — voir aussi la table lisible dcs-radio-specs.md.
Vérifier si le défaut par bande suffit (souvent oui). Si non, ajouter une entrée dans dcs-radio-layouts.yaml avec le mapping index → rôle et les primitives nécessaires ; commenter chaque radio (nom + bande).
Couvrir le comportement par un test dans test/python/presets_injector/ (fidélité de layout, capacité, cas AJS-37…).