path: root/snd-alpx/ReleasesNotes.txt

Notes de versions du pilote Linux
=================================

Notes de la version V3.4.3 (Support (AlpDANTE/Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 3.4.3

Nouveautés
 * Support des applications compilées avant le firmware 240 des Alp882e : adaptation de la liste des sources de synchronisation. Ce mode est activé via le paramètre alp882_pre_FW240_apps_support

 * Suppression de l'asterix postfixé dans les noms des cartes Alp222e lorsque le mode de compatibilité de firmware est activé.


Notes de la version V3.4.2 (Support (AlpDANTE/Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 3.4.2

Nouveautés

 * Activation du loopback interne des cartes AlpDANTE via le paramètre du module : dante_loopback_enabled

 * Support des applications compilées avec les contrôles des cartes Alp222e des firmware pré-V283. Les valeurs des contrôles des sources de synchronisation des Alp222e ont changés en V283 ce qui implique une recompilation des applications utilisatrices. Cette fonctionnalité permet le support des applications SANS une re-compilation via une adaptation. Activation via le paramètre alp222_pre_FW283_apps_support.

 * Désactivation des logs d'accès aux contrôles dans la génération.

 * Mise à jour des éléments de copyright : année 2024.


Notes de la version V3.4.1 (Support (AlpDANTE/Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 3.4.1

Nouveautés
 * Support de Ubuntu 22.04 (noyaux 5.15 et 6.5)
 * Support des distributions Debian 11 (noyau 5.10) , 12 (noyau 6.1).
 * Support des distributions de la famille RedHat 8 (4.18) et RedHat 9 (5.14).
 * Contournement du blocage de la lecture lors de cycles enchainés de lecture : "while($true) ; do aplay XXXX ; done".  Ce contournement consiste à ajouter un delai de 200ms avant l'ouverture effective du flux dans le pilote.
 * Suppression des cas de blocage lors de cycles Start/Stop très courts (<100ms) et répétitifs, des flux audios.
 * Correction de l'erreur "DMAR NO_PASID, PTE" si "Virt I/O" / IOMMU est activé (BIOS et options du noyau).


Notes de la version V3.4.0 (Support (AlpDANTE/Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 3.4.0 (PROTOTYPE)

Nouveautés
 * Intégrable dans les ServLink/Alp.
 * XDMA : utilisation complète du DMAEngine fourni par Xilinx
 * Support des noyaux 6.5
 * Support des noyaux pré 5.15.
 * Support complet de CentOS9 (noyau 5.14.0-381) avec flux audio via le DMAEngine.
 * Incorporation de regmap_mmio pour résoudre la dépendence au besoin
 * Alp222e-MIC : gamme d'amplification des entrées MIC de -24dB à +56dB.
 * Nouvelles versions de firmware supportées : Alp222e: V286 et Alp882e/Alp442e: V251.
 * Correction erreur EPROBE_DEFER (-517) observée sur Ubuntu Server 22.04.
 * Correction de l'arrêt des flux PLAYBACK lors de cycles Start/Stop courts sur les Alp222e.

 Notes de la version V3.3.2 (Support (AlpDANTE/Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 3.3.2

Nouveautés
 * Support CentOS9 (noyau 5.14.0-381) : définitions des structures des gpio.
 * Ajout du script tools/build_virtual_boards_alsa_conf.sh pour la génération d'un fichier asoundrc déclarant des cartes ALP virtuelles à partir de cartes ALP physique présentes.

Notes de la version V3.3.1 (Support (AlpDANTE/Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 3.3.1

Nouveautés
 * Support Debian 10. La version précédente ne compilait pas suite à un conflit de nommage entre le code du pilote et une macro du noyau.


Notes de la version V3.3.0 (Support (AlpDANTE/Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 3.3.0

Nouveautés:
 * AlpDANTE : Stockage de la configuration courante de la carte dans la mémoire Flash lors du démarrage du pilote (persistence de la FS donnée en paramètre)
 * AlpDANTE: Indication du nom de la carte sur le réseau DANTE dans les informations d'identité de la carte dans les logs du noyau ET dans le pseudo fichier sysfs : /"sys/class/sound/cardX/device/dante_card_name" avec X le numéro de la carte AlpDANTE indiqué par la commande "aplay -l". Ce nom est celui de la carte visible dans le DANTE contrôleur.


 Notes de la version V3.2.0 (Support (AlpDANTE/Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 3.2.0

Nouveautés:
 * Suppression de la foncitonnalité de mise à jour du firmware des carte AlpDANTE. La mise à jour se fait via un utilitaire fourni avec la mise à jour sous Windows.

=======================================================
Contenu de la version :

 * Le pilote en version 3.1.0
 * Firmware V283/2.7 pour Alp222e (Mise à jour obligatoire des cartes avant utilisation de cette version du pilote)
 * Firmware V247/1.10 pour les cartes multi-channels(Alp882e/Alp442e) (mise à jour obligatoire des cartes Alp882e avant utilisation de cette version du pilote).
 * Firmware V316/1.8 pour les cartes AlpDANTE.
 
 Nouveautés:
  * Support des cartes AlpDANTE : 
		* Support des différentes fréquences de fonctionnement via le paramètre de module : "dante_configured_fs"qui prend une valeur en Hz, ex : pour 48kHz, "dante_configured_fs=48000". La valeur par défaut est 48000. Toutes les cartes AlpDANTE fonctionnent alors à cette vitesse.
		
		* Script de mise à jour du firmware dans "tools/dante_card_update_firmware.sh", le firmware est livré dans une archive .zip inclue dans la livraison.
		
		* indication du numéro de série comme suffixe des partitions pour mise à jour présente lors de l'indication de mise à jour obligatoire.
		
		* Note : les cartes AlpDANTE n'expose pas de contrôle ALSA.
	
* Script de mise à jour des cartes audio classiques est renommé en "tools/audio_card_update_firmware.sh"

* Mise à disposition de la règle udev pour éviter la prise en compte des cartes Alp par PulseAudio. La règle est dans le fichier "udev/88-pulseaudio-no-alp.rules". Pour sa prise en compte, il faut re-démarrer le système.

Notes de la version V2.3.1 (Support (Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 2.3.1
 * Firmware V283/2.7 pour Alp222e (Mise à jour obligatoire des cartes avant utilisation de cette version du pilote)
 * Firmware V247/1.10 pour les cartes multi-channels(Alp882e/Alp442e) (mise à jour obligatoire des cartes Alp882e avant utilisation de cette version du pilote).
 
Nouveautés :
 * Support officiel de RockyLinux 9.2 (noyau 5.14)


Notes de la version V2.3.0 (Support (Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 2.3.0
 * Firmware V283/2.7 pour Alp222e (Mise à jour obligatoire des cartes avant utilisation de cette version du pilote)
 * Firmware V247/1.10 pour les cartes multi-channels(Alp882e/Alp442e) (mise à jour obligatoire des cartes Alp882e avant utilisation de cette version du pilote).
 
Nouveautés :
  * Alp222 : Support de l'entrée de synchro inter-carte (nouvelle entrée dans les contrôles de synchro).
  

Notes de la version V2.2.0 (Support (Alp882e / Alp442e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 2.2.0
 * Firmware V281/1.9 pour Alp222e 
 * Firmware V241/2.6 pour les cartes multi-channels(Alp882e/Alp442e) (mise à jour obligatoire des cartes Alp882e avant utilisation de cette version du pilote).
 
Nouveautés :

 * Support des cartes Alp442e et Alp442e-MIC
 * Alp882e-MIC : Support des entrées MIC dans le mixer
 * En cas d'anomalie dans la dans la mémoire Flash, la carte passe en mode "DEAD" (LED de façade clignotent en alternance), cela nécessite un retour usine.
 * Le pilote place toute carte multi-channel(442/882) ayant une version antérieure du firmware en mode dégradé ne  permettant que la mise à jour du firmware.
 


Notes de la version V2.1.0 (Support (Alp882e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 2.1.0

 Nouveautés
  * Version du FPGA dans le fichier "ver_fpga" du sysfs de la carte
  * Version du Micro-contrôleur dans le fichier "ver_mcu" du sysfs de la carte. Note, le contenu est une chaine "x.y" avec x : version majeur et y : version mineure.
  
  Ex. : "/sys/class/sound/card2/device/ver_mcu" et Ex. : "/sys/class/sound/card2/device/ver_fpga"
    
  Evolutions
	* Renommage du pseudo fichier "reg_serial_number" en "serial_number" en cohérence avec ceux concernant les versions.
   Ex. : "/sys/class/sound/card2/device/serial_number"
	* Depuis V 2.0.0, le passage en mode PROD de la carte (visibilité de la mémoire flash) est assuré par le paramètre de module "with_board_in_prod_mode" qui remplace "with_board_in_user_mode".


Notes de la version V2.0.1 (Support (Alp882e / Alp222e) tous modèles)
=======================================================
Contenu de la version :

 * Le pilote en version 2.0.1

 Nouveautés
  * Indication du numéro de série dans le nommage de la partition de mise  à jour du firmware (uniquement en mode USER). Voir ci-dessous
  ----
# cat /proc/mtd
dev:    size   erasesize  name
mtd0: 00218000 00000000 "fw-user-updatable-270400000003"
mtd1: 00218000 00000000 "fw-user-updatable-270200000003"
mtd2: 00218000 00000000 "fw-user-updatable-270200000002"
----

 * Fichier de configuration ALSA pour Alp882e avec paires stéréo virtuelles dans ./alsa_conf/asound-stereo_alp882.conf

 Corrections
	* Elimination de la fausse détection de l'option MIC des Alp222e lors du premier chargement du pilote.


Notes de la version V2.0.0 (Support (Alp882e / Alp222e) tous modèles)
=======================================================

Contenu de la version :

 * Le pilote en version 2.0.0
 * Le firmware Alp882e en version V208/1.6, lire la note ci-dessous !!
 * Le firmware Alp222e en version V273/2.4
 
 *ATTENTION* le firmware V208 des Alp882e impose d'avoir une zone de production avec une indication valide du modèle de carte sous peine de "bloquer" la carte avec potentiellement un retour usine obligatoire. Le pilote ne sait pas encore ré-activer une carte dans cet état. Si blocage, la procédure actuelle est de reprogrammer la carte avec la sonde JTAG avec un FW en version précédente, puis programmer une zone de production valide : Numéro de série et indication de modèle. DONC ne pas mettre ce Firmware dans les cartes prototype sans une modification de leurs zones de Production.
 
* Les fichiers contenant les listes des contrôles des cartes Alp222e, Alp222e-MIC, Alp882e et Alp882e-MIC avec les sufixes "controls" et "contents".
* Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
	* Supporte tous les modèles de cartes Alp222e et Alp882e via la valeur du champ "SubSystemId" PCIe.
	* !!! Nouveau nommage des cartes : ajout du 'e' suffixe à la racine du modèle : "Alp222" devient "Alp222e".
	* Accès au numéro de série via le fichier spécial "reg_serial_number" dans le sysfs de la carte : Ex. : "/sys/class/sound/card2/device/reg_serial_number" pour la carte 2 et plus depuis un accès direct à la mémoire Flash de la carte : "/dev/mtd".
	* Ajout du fichier de configuration ALSA "asound-alp882.conf" permettant d'avoir des paires stéréos virtuelles à partir des canaux d'une Alp882e.
	* Accès Flash limité à la seule zone du firmware utilisateur pour mise à jour en fonctionnement normal. Passage en mode PROD via un paramètre du module.
	* Amélioration des indications d'identité des cartes dans les logs du noyau (numéro de série , indication de l'identifiant du modèle).
	
 Corrections
	* Alp882e (firmware V208 et ultérieurs) : délai de 500ms avant ouverture de flux lors de changement de FS entre 2 ouvertures de flux internes.
 
 Notes de la version V1.999.11 (PROTOTYPE Support Alp882)
=======================================================

VERSION transitoire pour validation de la correction du support des FS > 48kHz.

 
Notes de la version V1.999.10 (PROTOTYPE Support Alp882)
=======================================================

Contenu de la version :

 * Le pilote en version 1.999.10
 * Les fichiers contenant les listes des contrôles des cartes Alp222e, Alp222e-MIC, Alp882e et Alp882e-MIC avec les sufixes "controls" et "contents".
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
 * Activation du mode MIC des cartes Alp882e via le paramètre "with_882mic_option", Le mode LINE est activé par défaut. La carte se comporte comme une Alp882e et pas une Alp882e-MIC.
 * Mémoire Flash : seule la zone "fw-user-updatable" est accessible en écriture.
 * Récupération de la FS effective via un seul contrôle et pas deux (Base et Coefficient).
 * Création du script "tools/ update_firmware.sh" de mise à jour du firmware comprenant le contournement d'une limitation du FGPA. Impose la présence de l'outil "dd".
 * Support des cartes Alp222e-MIC ayant 0x0820 comme valeur du "SubsystemVendorId".
 * Nouveau nommage des cartes : ajout du 'e' suffixe au à la racine du modèle : "Alp222" devient "Alp222e".
	
Corrections
  * Support correct des FS>48kHz (Tests faits avec outil Play.EXE).
  
Limitations connues
 * Délai de 1s avant ouverture de flux lors de changement de FS entre 2 ouvertures de flux internes.
 
Limitations inconnues
 * ...

 

Notes de la version V1.999.9 (PROTOTYPE Support Alp882)
=======================================================

Contenu de la version :

 * Firmware en version 191/1.3
 * Le pilote en version 1.999.9
 * Le fichier contenant la liste des contrôles de la carte : Liste_controles.txt et leurs contenus : Controls_Contents.txt
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
	
Corrections
  * RE-Corrections des adresses des registres d'amplification des entrées analogiques. Tests faits avec 882 ET 222 (cette fois).
  
Limitations connues
 * Le basculement automatique des sources d'horloges n'est pas pleinement opérationnel (basculement sur source interne à 32kHz si activation par défaut). 
 
Limitations inconnues
 * ...


Notes de la version V1.999.8 (PROTOTYPE Support Alp882)
======================================================

Contenu de la version :

 * Firmware en version 191/1.3
 * Le pilote en version 1.999.8
 * Le fichier contenant la liste des contrôles de la carte : Liste_controles.txt et leurs contenus : Controls_Contents.txt
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
	
	
	
Corrections
  * Corrections des adresses des registres de contrôles des ASRC.
  * Corrections des adresses des registres d'amplification des entrées analogiques.
  
Limitations connues
 * Le basculement automatique des sources d'horloges n'est pas pleinement opérationnel (basculement sur source interne à 32kHz si activation par défaut). 
 
Limitations inconnues
 * ...


Notes de la version V1.999.7 (PROTOTYPE Support Alp882)
=======================================================

Contenu de la version :

 * Firmware en version 191/1.3
 * Le pilote en version 1.999.7
 * Le fichier contenant la liste des contrôles de la carte : Liste_controles.txt et leurs contenus : Controls_Contents.txt
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
	* Renommage des contrôles concernant la gestion des sources de synchronisation (voir après)
	
	
Corrections
  * Mixer des cartes Alp882 opérationel. Configuration différente entre Alp222 et Alp882.
  
Limitations connues
 * Le basculement automatique des sources d'horloges n'est pas pleinement opérationnel (basculement sur source interne à 32kHz si activation par défaut). 
 
Limitations inconnues
 * ...
  
Renommage des sources de synchronisation

 * "Clk Src" => "Clk Eff Src"
 * "Clk Base"=> "Clk Eff Base"
 * "Clk Coef" => "Clk Eff Coef"
 * "CkSc Up" => "Clk Src Up"
 * "CkSc Down" => "Clk Src Down"
Cela assure une meilleure lecture et les contrôles sont consécutifs dans alsamixer. Les numIds n'ont pas changés.


Notes de la version V1.999.6 (PROTOTYPE Support Alp882)
=======================================================

Contenu de la version :

 * Firmware en version 191/1.3
 * Le pilote en version 1.999.6
 * Le fichier contenant la liste des contrôles de la carte : Liste_controles.txt et leurs contenus : controls_contents.txt
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
	* Ajout des contrôles de gestion des sources d'horloges pour une Alp882.( voir les Limitations plus bas)
	* contrôles AES SRC sont en logique négative (1=> AES SRC désactivé). Libellé suffixé par "Disable".
	
Corrections
  
Limitations connues
 * Le basculement automatique des sources d'horloges n'est pas pleinement opérationnel (basculement sur source interne à 32kHz si activation par défaut). 
 
Limitations inconnues
 * ...
  

Notes de la version V1.999.5 (PROTOTYPE Support Alp882)
======================================================

Contenu de la version :

 * Firmware en version 191/1.3
 * Le pilote en version 1.999.5
 * Le fichier contenant la liste des contrôles de la carte : Liste_controles.txt et leurs contenus : controls_contents.txt
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
  * Définitions de l'ensemble des contrôles (ajout des alimentation fantômes des entrées lignes)
  * Le Mixer est opérationnel, attention par défaut ALSA va configurer les noeuds à 0. La carte est donc muette à cause de la configuration par d'faut d'ALSA.
  * Modification de l'ordre des contrôles pour dégager un troc commun entre les modèles LINE et LINE/MIC des 882.
  * Renommage des zones MTD de la carte pour être en rapport avec les spécifications  
		----
		"golden"
		"fw-user-updatable"
		"init-config"
		"user-config"
		"production"
		"test"
		----
	Attention, la zone "test" est appelée à disparaitre dans les versions suivantes.
	
	
Corrections
 * Firmware V191/1.3 : configuration par défaut du Mixer corrigée.
 * Contrôles des AES SRC modifient bien les bits de contrôle dans la carte.
  
 
Limitations connues
 * MIXER non paramétrable : il fonctionne en mode transparent.
 * FS max de 192kHz (FMW) , pas testée avec le pilote.
 
Limitations inconnues
 * ...
  

Notes de la version V1.999.4 (PROTOTYPE Support Alp882)
=======================================================

Contenu de la version :

 * Firmware en version 191
 * Le pilote en version 1.999.4
 * Le fichier contenant la liste des contrôles de la carte : Liste_controles.txt et leurs contenus : controls_contents.txt
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
  * Support version 191 du firmware (adresse du MIXER)
 
Corrections
  
 
Limitations connues
 * MIXER non paramétrable : il fonctionne en mode transparent.
 * FS max de 192kHz (FMW) , pas testée avec le pilote.
 
Limitations inconnues
 * ...
  
Notes de la version V1.999.3 (PROTOTYPE Support Alp882)
======================================================

Contenu de la version :

 * Firmware en version 102
 * Le pilote en version 1.999.3
 * Le fichier contenant la liste des contrôles de la carte : Liste_controles.txt et leurs contenus : controls_contents.txt
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
  * Ajout de log pour pb de détection des GPIOs Input/Output
 
Corrections
  * GPIOs : corrections de la régression pour les Alp222
 
Limitations connues
 * MIXER non paramétrable : il fonctionne en mode transparent.
 * FS max de 8kHz.
 
Limitations inconnues
 * ...
  


Notes de la version V1.999.2 (PROTOTYPE Support Alp882)
======================================================

Contenu de la version :

 * Firmware en version 102
 * Le pilote en version 1.999.2
 * Le fichier contenant la liste des contrôles de la carte : Liste_controles.txt et leurs contenus : controls_contents.txt
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 * Les fichiers du firmware V102 : alp882_multiboot_build_102_ublaze_1.0.mcs : pour programmation complète via la sonde JTAG et l'outil VIVADO, alp882_multiboot_user_build_102_ublaze_1.0.bin : pour mise à jour in situ UNE fois le Fiwrmware en version 102).
 
 
Nouveautés:
 * GPIOs : Ok au niveau logique
 * Support de la mise à jour du Firmware (comme pour Alp222, via /dev/mtd1)

Corrections
 
Limitations connues
 * MIXER non paramétrable : il fonctionne en mode transparent.
 * FS max de 8kHz.
 
Limitations inconnues
 * ...
  



Notes de la version V1.999.1 (PROTOTYPE Support Alp882)
======================================================

Contenu de la version :

 * Firmware en version 0 (alp-882_dyn_mixer_conf.mcs pour reprogrammation complète) dans l'archive alp-882_dyn_mixer_conf.zip
 * Le pilote en version 1.999.1
 * Le fichier contenant la liste des contrôles de la carte : Liste_controles.txt et leurs contenus : controls_contents.txt
 * Le fichier recensant les informations de versions attendues selon les versions de firmware et pilote : Versions_attendues.txt
 
Nouveautés:
 * C'est le premier pilote/Firmware : hautement instable.

Corrections
 
 
Limitations connues
 * MIXER non fonctionnel : il fonctionne en mode transparent.
 
Limitations inconnues
 *