SE3Groupe2025-4 - Historique des versions

Aboualle : Syntaxe fixée

2026-06-19T17:14:12Z

Syntaxe fixée

← Version précédente		Version du 19 juin 2026 à 17:14
Ligne 84 :		Ligne 84 :
	==== Descripteurs USB ====		==== Descripteurs USB ====

	Le fichier `Descriptors.h` déclare les adresses et la taille des endpoints :		Le fichier <code>Descriptors.h</code> déclare les adresses et la taille des endpoints :

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">
Ligne 92 :		Ligne 92 :
	</syntaxhighlight>		</syntaxhighlight>

	Dans `Descriptors.c`, la configuration est décrite avec une interface unique (bInterfaceClass = 0xFF) et deux endpoints :		Dans <code>Descriptors.c</code>, la configuration est décrite avec une interface unique (bInterfaceClass = 0xFF) et deux endpoints :

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">
Ligne 112 :		Ligne 112 :
	</syntaxhighlight>		</syntaxhighlight>

	Les chaînes de caractères (fabricant, produit, numéro de série) sont également définies. Le callback `CALLBACK_USB_GetDescriptor` fournit ces descripteurs à l’hôte lors de l’énumération.		Les chaînes de caractères (fabricant, produit, numéro de série) sont également définies. Le callback <code>CALLBACK_USB_GetDescriptor</code> fournit ces descripteurs à l’hôte lors de l’énumération.

	==== Code de la carte (CustomHID.c) ====		==== Code de la carte (CustomHID.c) ====
Ligne 118 :		Ligne 118 :
	Le programme principal est simplifié : il initialise le matériel, démarre la pile USB, puis boucle sur les tâches USB et le traitement des endpoints.		Le programme principal est simplifié : il initialise le matériel, démarre la pile USB, puis boucle sur les tâches USB et le traitement des endpoints.

	Initialisation matérielle :		'''Initialisation matérielle''' :
	- Les LEDs (PD0 et PD1) sont configurées en sortie.		- Les LEDs (PD0 et PD1) sont configurées en sortie.
	- Les boutons (PC4 et PC5) sont en entrée avec pull‑up internes.		- Les boutons (PC4 et PC5) sont en entrée avec pull‑up internes.
	- Le watchdog est désactivé et l’horloge est mise à 16 MHz (si les fusibles ne sont pas encore programmés).		- Le watchdog est désactivé et l’horloge est mise à 16 MHz (si les fusibles ne sont pas encore programmés).

	Traitement de l’endpoint OUT (`process_out`) :		'''Traitement de l’endpoint OUT''' (<code>process_out</code>) :
	- Sélectionne l’endpoint OUT.		- Sélectionne l’endpoint OUT.
	- Si un paquet est reçu, lit un octet et applique ses bits 0 et 1 aux LEDs.		- Si un paquet est reçu, lit un octet et applique ses bits 0 et 1 aux LEDs.
Ligne 140 :		Ligne 140 :
	</syntaxhighlight>		</syntaxhighlight>

	Traitement de l’endpoint IN (`process_in`) :		'''Traitement de l’endpoint IN''' (<code>process_in</code>) :
	- Sélectionne l’endpoint IN.		- Sélectionne l’endpoint IN.
	- Si l’endpoint est prêt à écrire, lit l’état des deux boutons (bits PC4 et PC5) et les envoie dans un octet.		- Si l’endpoint est prêt à écrire, lit l’état des deux boutons (bits PC4 et PC5) et les envoie dans un octet.
Ligne 157 :		Ligne 157 :
	</syntaxhighlight>		</syntaxhighlight>

	Événements USB :		'''Événements USB''' :
	- `EVENT_USB_Device_ConfigurationChanged` configure les deux endpoints (taille 8, type INTERRUPT).		- <code>EVENT_USB_Device_ConfigurationChanged</code> configure les deux endpoints (taille 8, type INTERRUPT).
	- `EVENT_USB_Device_ControlRequest` gère les requêtes standard (délégation à LUFA).		- <code>EVENT_USB_Device_ControlRequest</code> gère les requêtes standard (délégation à LUFA).

	La boucle principale appelle `USB_USBTask()` et les deux fonctions de traitement uniquement lorsque l’adresse USB est attribuée.		La boucle principale appelle <code>USB_USBTask()</code> et les deux fonctions de traitement uniquement lorsque l’adresse USB est attribuée.

	==== Programme PC (main_pc.c) ====		==== Programme PC (main_pc.c) ====

	Le programme côté PC utilise la bibliothèque `libusb-1.0` pour dialoguer avec la carte.		Le programme côté PC utilise la bibliothèque <code>libusb-1.0</code> pour dialoguer avec la carte.

	Initialisation :		'''Initialisation''' :
	- Ouvre le périphérique par VID/PID (0x03EB / 0x2044).		- Ouvre le périphérique par VID/PID (0x03EB / 0x2044).
	- Détache le pilote noyau si nécessaire.		- Détache le pilote noyau si nécessaire.
	- Réclame l’interface (claim).		- Réclame l’interface (claim).

	Contrôle des LEDs (OUT) :		'''Contrôle des LEDs (OUT)''' :
	- Les touches `1`, `2`, `3` basculent respectivement les bits 5, 6, 7 (mais ici seuls les bits 0 et 1 sont utilisés).		- Les touches <code>1</code>, <code>2</code>, <code>3</code> basculent respectivement les bits 5, 6, 7 (mais ici seuls les bits 0 et 1 sont utilisés).
	- La touche `0` éteint tout.		- La touche <code>0</code> éteint tout.
	- L’envoi se fait via `libusb_interrupt_transfer` sur l’endpoint OUT (adresse 0x01).		- L’envoi se fait via <code>libusb_interrupt_transfer</code> sur l’endpoint OUT (adresse 0x01).

	Lecture des boutons (IN) :		'''Lecture des boutons (IN)''' :
	- Une requête `libusb_interrupt_transfer` est effectuée périodiquement sur l’endpoint IN (0x82).		- Une requête <code>libusb_interrupt_transfer</code> est effectuée périodiquement sur l’endpoint IN (0x82).
	- L’octet reçu est affiché, et un message indique quel bouton est pressé (SW3 sur PC4, SW4 sur PC5).		- L’octet reçu est affiché, et un message indique quel bouton est pressé (SW3 sur PC4, SW4 sur PC5).

	Le programme utilise `select` sur `stdin` pour ne pas bloquer, ce qui permet une interaction fluide.		Le programme utilise <code>select</code> sur <code>stdin</code> pour ne pas bloquer, ce qui permet une interaction fluide.

	Résultat attendu :		'''Résultat attendu''' :
	- Le programme affiche l’état des boutons en temps réel.		- Le programme affiche l’état des boutons en temps réel.
	- En appuyant sur `1`, `2`, `3` ou `0`, les LEDs (PD0 et PD1) s’allument/s’éteignent selon les commandes envoyées.		- En appuyant sur <code>1</code>, <code>2</code>, <code>3</code> ou <code>0</code>, les LEDs (PD0 et PD1) s’allument/s’éteignent selon les commandes envoyées.

	Cette validation est indispensable avant d’implémenter le protocole ISP, car nous allons réutiliser exactement ce même canal pour échanger des commandes SPI avec la cible.		Cette validation est indispensable avant d’implémenter le protocole ISP, car nous allons réutiliser exactement ce même canal pour échanger des commandes SPI avec la cible.

Aboualle : /* Compilation et téléversement */

2026-06-19T15:58:10Z

Compilation et téléversement

← Version précédente		Version du 19 juin 2026 à 15:58
Ligne 72 :		Ligne 72 :
	</syntaxhighlight>		</syntaxhighlight>

	Après le reset, les deux LEDs ~~doivent clignoter~~ en alternance. Ce test confirme que :		Après le reset, les deux LEDs clignotent en alternance. Ce test confirme que :
	* Le microcontrôleur est correctement alimenté ;		* Le microcontrôleur est correctement alimenté ;
	* L’horloge externe 16 MHz fonctionne ;		* L’horloge externe 16 MHz fonctionne ;

Rex : Révocation des modifications de Rex (discussion) vers la dernière version créée par Aboualle

2026-06-19T14:35:36Z

Révocation des modifications de Rex (discussion) vers la dernière version créée par Aboualle

← Version précédente		Version du 19 juin 2026 à 14:35
Ligne 118 :		Ligne 118 :
	Le programme principal est simplifié : il initialise le matériel, démarre la pile USB, puis boucle sur les tâches USB et le traitement des endpoints.		Le programme principal est simplifié : il initialise le matériel, démarre la pile USB, puis boucle sur les tâches USB et le traitement des endpoints.

	~~'''~~Initialisation matérielle~~'''~~ :		Initialisation matérielle :
	* Les LEDs (PD0 et PD1) sont configurées en sortie.		- Les LEDs (PD0 et PD1) sont configurées en sortie.
	* Les boutons (PC4 et PC5) sont en entrée avec pull‑up internes.		- Les boutons (PC4 et PC5) sont en entrée avec pull‑up internes.
	* Le watchdog est désactivé et l’horloge est mise à 16 MHz (si les fusibles ne sont pas encore programmés).		- Le watchdog est désactivé et l’horloge est mise à 16 MHz (si les fusibles ne sont pas encore programmés).

	~~'''~~Traitement de l’endpoint OUT~~'''~~ (`process_out`) :		Traitement de l’endpoint OUT (`process_out`) :
	* Sélectionne l’endpoint OUT.		- Sélectionne l’endpoint OUT.
	* Si un paquet est reçu, lit un octet et applique ses bits 0 et 1 aux LEDs.		- Si un paquet est reçu, lit un octet et applique ses bits 0 et 1 aux LEDs.

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">

Rex : /* Code de la carte (CustomHID.c) */

2026-06-19T14:33:56Z

Code de la carte (CustomHID.c)

← Version précédente		Version du 19 juin 2026 à 14:33
Ligne 118 :		Ligne 118 :
	Le programme principal est simplifié : il initialise le matériel, démarre la pile USB, puis boucle sur les tâches USB et le traitement des endpoints.		Le programme principal est simplifié : il initialise le matériel, démarre la pile USB, puis boucle sur les tâches USB et le traitement des endpoints.

	Initialisation matérielle :		'''Initialisation matérielle''' :
	- Les LEDs (PD0 et PD1) sont configurées en sortie.		* Les LEDs (PD0 et PD1) sont configurées en sortie.
	- Les boutons (PC4 et PC5) sont en entrée avec pull‑up internes.		* Les boutons (PC4 et PC5) sont en entrée avec pull‑up internes.
	- Le watchdog est désactivé et l’horloge est mise à 16 MHz (si les fusibles ne sont pas encore programmés).		* Le watchdog est désactivé et l’horloge est mise à 16 MHz (si les fusibles ne sont pas encore programmés).

	Traitement de l’endpoint OUT (`process_out`) :		'''Traitement de l’endpoint OUT''' (`process_out`) :
	- Sélectionne l’endpoint OUT.		* Sélectionne l’endpoint OUT.
	- Si un paquet est reçu, lit un octet et applique ses bits 0 et 1 aux LEDs.		* Si un paquet est reçu, lit un octet et applique ses bits 0 et 1 aux LEDs.

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">

Aboualle : /* Programme PC (main_pc.c) */

2026-06-18T22:45:13Z

Programme PC (main_pc.c)

← Version précédente		Version du 18 juin 2026 à 22:45
Ligne 195 :		Ligne 195 :
	[[File:Wiki-capture-lsusb.png\|thumb\|center\|400px\|lsusb]]		[[File:Wiki-capture-lsusb.png\|thumb\|center\|400px\|lsusb]]

	[[File:Wiki-photo-prog.~~png~~\|thumb\|center\|400px\|photo du programmeur 2 minutes après que je l'ai cramé]]		[[File:Wiki-photo-prog.jpeg\|thumb\|center\|400px\|photo du programmeur 2 minutes après que je l'ai cramé]]

	== Bilan ==		== Bilan ==

Aboualle : /* Programme PC (main_pc.c) */

2026-06-18T22:43:38Z

Programme PC (main_pc.c)

← Version précédente		Version du 18 juin 2026 à 22:43
Ligne 194 :		Ligne 194 :

	[[File:Wiki-capture-lsusb.png\|thumb\|center\|400px\|lsusb]]		[[File:Wiki-capture-lsusb.png\|thumb\|center\|400px\|lsusb]]

			[[File:Wiki-photo-prog.png\|thumb\|center\|400px\|photo du programmeur 2 minutes après que je l'ai cramé]]

	== Bilan ==		== Bilan ==

Aboualle : /* Carte électronique */

2026-06-18T22:42:38Z

Carte électronique

← Version précédente		Version du 18 juin 2026 à 22:42
Ligne 19 :		Ligne 19 :

	Vidéo très courte et en basse résolution de la carte en fonctionnement :		Vidéo très courte et en basse résolution de la carte en fonctionnement :

	~~[[Média:2025-PSE-04-PROG-video.mp4]]~~

	== Programmation ==		== Programmation ==

Aboualle : /* Compilation et téléversement */

2026-06-18T22:37:29Z

Compilation et téléversement

← Version précédente		Version du 18 juin 2026 à 22:37
Ligne 79 :		Ligne 79 :
	* Les broches PD0 et PD1 sont accessibles et commandables ;		* Les broches PD0 et PD1 sont accessibles et commandables ;
	* Le chargeur DFU est opérationnel.		* Le chargeur DFU est opérationnel.

	~~[[File:2025-PSE-04-PROG-blink.mp4\|Clignotement des LEDs]]~~


	=== Gestion personnalisée des endpoints (IN/OUT) ===		=== Gestion personnalisée des endpoints (IN/OUT) ===

Aboualle le 18 juin 2026 à 22:35

2026-06-18T22:35:41Z

← Version précédente		Version du 18 juin 2026 à 22:35
Ligne 81 :		Ligne 81 :

	[[File:2025-PSE-04-PROG-blink.mp4\|Clignotement des LEDs]]		[[File:2025-PSE-04-PROG-blink.mp4\|Clignotement des LEDs]]


			=== Gestion personnalisée des endpoints (IN/OUT) ===

			L’objectif est de piloter directement les LEDs depuis le PC et de lire l’état des boutons, sans passer par la classe CDC. Pour cela, nous avons défini une interface USB générique (classe 0xFF) avec deux points d’accès de type INTERRUPT.

			==== Descripteurs USB ====

			Le fichier `Descriptors.h` déclare les adresses et la taille des endpoints :

			<syntaxhighlight lang="c">
			#define LED_OUT_EPADDR (ENDPOINT_DIR_OUT \| 1) // Endpoint 1 OUT
			#define BTN_IN_EPADDR (ENDPOINT_DIR_IN \| 2) // Endpoint 2 IN
			#define EP_SIZE 8
			</syntaxhighlight>

			Dans `Descriptors.c`, la configuration est décrite avec une interface unique (bInterfaceClass = 0xFF) et deux endpoints :

			<syntaxhighlight lang="c">
			const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor =
			{
			.Config = { ... },
			.Interface =
			{
			.Header = { .Size = sizeof(USB_Descriptor_Interface_t), .Type = DTYPE_Interface },
			.InterfaceNumber = 0,
			.TotalEndpoints = 2,
			.Class = 0xFF, // Vendor-specific
			.SubClass = 0x00,
			.Protocol = 0x00,
			},
			.Endpoint_OUT = { ... },
			.Endpoint_IN = { ... },
			};
			</syntaxhighlight>

			Les chaînes de caractères (fabricant, produit, numéro de série) sont également définies. Le callback `CALLBACK_USB_GetDescriptor` fournit ces descripteurs à l’hôte lors de l’énumération.

			==== Code de la carte (CustomHID.c) ====

			Le programme principal est simplifié : il initialise le matériel, démarre la pile USB, puis boucle sur les tâches USB et le traitement des endpoints.

			Initialisation matérielle :
			- Les LEDs (PD0 et PD1) sont configurées en sortie.
			- Les boutons (PC4 et PC5) sont en entrée avec pull‑up internes.
			- Le watchdog est désactivé et l’horloge est mise à 16 MHz (si les fusibles ne sont pas encore programmés).

			Traitement de l’endpoint OUT (`process_out`) :
			- Sélectionne l’endpoint OUT.
			- Si un paquet est reçu, lit un octet et applique ses bits 0 et 1 aux LEDs.

			<syntaxhighlight lang="c">
			static void process_out(void)
			{
			Endpoint_SelectEndpoint(EP_OUT);
			if (Endpoint_IsOUTReceived() && Endpoint_IsReadWriteAllowed())
			{
			uint8_t cmd = Endpoint_Read_8();
			LED_PORT = (LED_PORT & ~((1<<LED1_PIN)\|(1<<LED2_PIN))) \| (cmd & 0x03);
			Endpoint_ClearOUT();
			}
			}
			</syntaxhighlight>

			Traitement de l’endpoint IN (`process_in`) :
			- Sélectionne l’endpoint IN.
			- Si l’endpoint est prêt à écrire, lit l’état des deux boutons (bits PC4 et PC5) et les envoie dans un octet.

			<syntaxhighlight lang="c">
			static void process_in(void)
			{
			Endpoint_SelectEndpoint(EP_IN);
			if (Endpoint_IsReadWriteAllowed())
			{
			uint8_t buttons = PINC & ((1<<BTN1_PIN)\|(1<<BTN2_PIN));
			Endpoint_Write_8(buttons);
			Endpoint_ClearIN();
			}
			}
			</syntaxhighlight>

			Événements USB :
			- `EVENT_USB_Device_ConfigurationChanged` configure les deux endpoints (taille 8, type INTERRUPT).
			- `EVENT_USB_Device_ControlRequest` gère les requêtes standard (délégation à LUFA).

			La boucle principale appelle `USB_USBTask()` et les deux fonctions de traitement uniquement lorsque l’adresse USB est attribuée.

			==== Programme PC (main_pc.c) ====

			Le programme côté PC utilise la bibliothèque `libusb-1.0` pour dialoguer avec la carte.

			Initialisation :
			- Ouvre le périphérique par VID/PID (0x03EB / 0x2044).
			- Détache le pilote noyau si nécessaire.
			- Réclame l’interface (claim).

			Contrôle des LEDs (OUT) :
			- Les touches `1`, `2`, `3` basculent respectivement les bits 5, 6, 7 (mais ici seuls les bits 0 et 1 sont utilisés).
			- La touche `0` éteint tout.
			- L’envoi se fait via `libusb_interrupt_transfer` sur l’endpoint OUT (adresse 0x01).

			Lecture des boutons (IN) :
			- Une requête `libusb_interrupt_transfer` est effectuée périodiquement sur l’endpoint IN (0x82).
			- L’octet reçu est affiché, et un message indique quel bouton est pressé (SW3 sur PC4, SW4 sur PC5).

			Le programme utilise `select` sur `stdin` pour ne pas bloquer, ce qui permet une interaction fluide.

			Résultat attendu :
			- Le programme affiche l’état des boutons en temps réel.
			- En appuyant sur `1`, `2`, `3` ou `0`, les LEDs (PD0 et PD1) s’allument/s’éteignent selon les commandes envoyées.

			Cette validation est indispensable avant d’implémenter le protocole ISP, car nous allons réutiliser exactement ce même canal pour échanger des commandes SPI avec la cible.

			Malheureusement après avoir flashé ce code, la carte arretait d'accepter la commande dfu-programmer atmega16u2 erase. Donc on ne peut pas avancer.

			Voici une capture de la reconnaissance de la carte en LUFA.

			[[File:Wiki-capture-lsusb.png\|thumb\|center\|400px\|lsusb]]

	== Bilan ==		== Bilan ==

Aboualle le 18 juin 2026 à 22:19

2026-06-18T22:19:21Z

← Version précédente		Version du 18 juin 2026 à 22:19
Ligne 23 :		Ligne 23 :

	== Programmation ==		== Programmation ==

			=== Test de la carte ===

			Avant d’aborder la programmation USB avec LUFA, nous avons validé le bon fonctionnement de notre carte électronique avec un programme simple de clignotement des deux LEDs (connectées à PD0 et PD1).

			==== Clignotement des LEDs (blink) ====

			Ce code alterne l’état des deux LEDs toutes les 500 ms. Il configure également l’horloge externe à 16 MHz (si les fusibles ne sont pas encore programmés).

			<syntaxhighlight lang="c" line="1">
			#include <avr/io.h>
			#include <util/delay.h>

			// Passage à l'horloge externe 16 MHz sans diviseur
			static inline void clock_init(void) {
			CLKSEL0 = 0b00010101; // sélection horloge externe
			CLKSEL1 = 0b00001111; // fréquence mini 8 MHz
			CLKPR = (1 << CLKPCE); // autorise la modification du diviseur
			CLKPR = 0; // diviseur = 1
			}

			int main(void) {
			clock_init();

			// PD0 et PD1 en sortie (LED1 sur PD0, LED2 sur PD1)
			DDRD \|= (1 << PD0) \| (1 << PD1);

			while (1) {
			PORTD \|= (1 << PD0); // LED1 allumée
			PORTD &= ~(1 << PD1); // LED2 éteinte
			_delay_ms(500);

			PORTD &= ~(1 << PD0); // LED1 éteinte
			PORTD \|= (1 << PD1); // LED2 allumée
			_delay_ms(500);
			}
			}
			</syntaxhighlight>

			==== Compilation et téléversement ====

			Pour compiler, utilisez un Makefile adapté à l’ATmega8U2 (F_CPU=16000000). Le fichier hex généré est flashé via dfu-programmer :

			<syntaxhighlight lang="bash">
			make clean
			make
			sudo dfu-programmer atmega8u2 erase --force
			sudo dfu-programmer atmega8u2 flash blink.hex
			sudo dfu-programmer atmega8u2 reset
			</syntaxhighlight>

			Après le reset, les deux LEDs doivent clignoter en alternance. Ce test confirme que :
			* Le microcontrôleur est correctement alimenté ;
			* L’horloge externe 16 MHz fonctionne ;
			* Les broches PD0 et PD1 sont accessibles et commandables ;
			* Le chargeur DFU est opérationnel.

			[[File:2025-PSE-04-PROG-blink.mp4\|Clignotement des LEDs]]

	== Bilan ==		== Bilan ==

SE3Groupe2025-4 - Historique des versions

Aboualle : Syntaxe fixée

Aboualle : /* Compilation et téléversement */

Rex : Révocation des modifications de Rex (discussion) vers la dernière version créée par Aboualle

Rex : /* Code de la carte (CustomHID.c) */

Aboualle : /* Programme PC (main_pc.c) */

Aboualle : /* Programme PC (main_pc.c) */

Aboualle : /* Carte électronique */

Aboualle : /* Compilation et téléversement */

Aboualle le 18 juin 2026 à 22:35

Aboualle le 18 juin 2026 à 22:19

Aboualle : Syntaxe fixée

Aboualle : /* Compilation et téléversement */

Rex : Révocation des modifications de Rex (discussion) vers la dernière version créée par Aboualle

Rex : /* Code de la carte (CustomHID.c) */

Aboualle : /* Programme PC (main_pc.c) */

Aboualle : /* Programme PC (main_pc.c) */

Aboualle : /* Carte électronique */

Aboualle : /* Compilation et téléversement */