TPI SE3 2024/2025 - Historique des versions

Tvantroy : /* Matériel */

2025-04-22T16:12:21Z

Matériel

← Version précédente		Version du 22 avril 2025 à 16:12
Ligne 10 :		Ligne 10 :
	=== Matériel ===		=== Matériel ===

	Pour 2024/2025, vous pouvez utiliser la carte "programmateur ISP" que vous avez ~~réalisé~~ en "programmation des systèmes embarqués", en particulier si vous avez prévu assez de boutons et de LED. Si votre carte ne vous parait pas adaptée, vous pouvez utiliser une des [https://wiki-ima.plil.fr/mediawiki//index.php/IMA4_2018/2019_SEC4 manettes] déjà réalisées.		Pour 2024/2025, vous pouvez utiliser la carte "programmateur ISP" que vous avez réalisée en "programmation des systèmes embarqués", en particulier si vous avez prévu assez de boutons et de LED. Si votre carte ne vous parait pas adaptée, vous pouvez utiliser une des [https://wiki-ima.plil.fr/mediawiki//index.php/IMA4_2018/2019_SEC4 manettes] déjà réalisées.

	Les boutons seront utilisés pour diriger votre vaisseau et les LED pour afficher votre nombre de vies restantes.		Les boutons seront utilisés pour diriger votre vaisseau et les LED pour afficher votre nombre de vies restantes.

Rex : /* Fermeture du périphérique USB */

2025-04-22T15:57:30Z

Fermeture du périphérique USB

← Version précédente		Version du 22 avril 2025 à 15:57
Ligne 110 :		Ligne 110 :
	==== Fermeture du périphérique USB ====		==== Fermeture du périphérique USB ====

	Ecrivez une fonction qui libère les périphériques détectés. Pour cela, relachez toutes les interfaces réclamées puis fermez la "poignée". Vous allez devoir, à nouveau, explorer la structure arborescente de description de configuration du périphérique ou sauver les numéros des interfaces dans le tableau global. Affichez l’indice et le numéro de chaque interface libérée.		Ecrivez une fonction qui libère les périphériques détectés. Pour cela, relachez toutes les interfaces réclamées puis fermez la "poignée". Vous allez devoir, à nouveau, explorer la structure arborescente de description de configuration du périphérique ou sauver les numéros des interfaces dans un tableau global. Affichez l’indice et le numéro de chaque interface libérée.

	==== Association bouton / code ====		==== Association bouton / code ====

	Vous pouvez maintenant écrire le coeur du programme PC. Le programme doit prendre en argument un numéro de bouton et un code de touche. Une interruption USB doit être lancée pour demander à la carte d'effectuer une association entre ce numéro et ce code.		Vous pouvez maintenant écrire le coeur du programme PC. Le programme doit prendre en argument un numéro de bouton et un code de touche. Une interruption USB doit être lancée pour demander à la carte d'effectuer une association entre ce numéro et ce code.

Rex : /* Appropriation des interfaces spécifiques */

2025-04-22T15:56:50Z

Appropriation des interfaces spécifiques

← Version précédente		Version du 22 avril 2025 à 15:56
Ligne 104 :		Ligne 104 :
	* pour chaque interface, prendre la première alternative d’interface ;		* pour chaque interface, prendre la première alternative d’interface ;
	* trouver le numéro d’interface pour utilisation avec <code>libusb_claim_interface</code> ;		* trouver le numéro d’interface pour utilisation avec <code>libusb_claim_interface</code> ;
	* récupérer le point d’accès présent, sauver ~~le numéro~~ du point d’accès dans ~~une variable globale (pas la peine de déclarer~~ un tableau~~, tous les périphériques de même identifiant sont réputés avoir les mêmes numéros de point d’accès)~~.		* récupérer le point d’accès présent, sauver l'adresse du point d’accès dans un tableau global.

	Affichez l’indice et le numéro de chaque interface détectée et réclamée. Affichez aussi ~~le numéro~~ du point d’accès trouvé.		Affichez l’indice et le numéro de chaque interface détectée et réclamée. Affichez aussi l'adresse du point d’accès trouvé.

	==== Fermeture du périphérique USB ====		==== Fermeture du périphérique USB ====

Rex : /* Gestion des codes de touches */

2025-04-22T15:54:51Z

Gestion des codes de touches

← Version précédente		Version du 22 avril 2025 à 15:54
Ligne 87 :		Ligne 87 :
	Nous souhaitons pouvoir associer les boutons de la carte aux codes des touches utilisés dans le jeu pour cela nous avons créé une interface spécifique au niveau du périphérique USB.		Nous souhaitons pouvoir associer les boutons de la carte aux codes des touches utilisés dans le jeu pour cela nous avons créé une interface spécifique au niveau du périphérique USB.

	Nous allons donc utiliser la bibliothèque USB <code>libusb-1.0</code> pour ~~écrire des fonctions C permettant de contrôler les LED~~. Vous avez le manuel complet de la bibliothèque à l’URL [http://libusb.sourceforge.net/api-1.0/modules.html]. Vous trouverez un résumé de la bibliothèque à l’URL [https://rex.plil.fr/Enseignement/Systeme/Systeme.PSE]/. Pour cette utilisation assez basique nous utiliserons les fonctions de communication bloquantes.		Nous allons donc utiliser la bibliothèque USB <code>libusb-1.0</code> pour interagir avec cette interface. Vous avez le manuel complet de la bibliothèque à l’URL [http://libusb.sourceforge.net/api-1.0/modules.html]. Vous trouverez un résumé de la bibliothèque à l’URL [https://rex.plil.fr/Enseignement/Systeme/Systeme.PSE]/. Pour cette utilisation assez basique nous utiliserons les fonctions de communication bloquantes.

	==== Enumération des périphériques USB ====		==== Enumération des périphériques USB ====
Ligne 93 :		Ligne 93 :
	Ecrivez une fonction pour examiner tous les périphériques USB disponibles sur les bus USB de votre machine de TP. Dès qu’un périphérique s’avère être un périphérique USB du type cherché, sauvez la "poignée" (obtenue avec <code>libusb_open</code>) vers ce périphérique dans un tableau statique global de type <code>libusb_device_handle* periphs[MAX_PERIPH]</code>.		Ecrivez une fonction pour examiner tous les périphériques USB disponibles sur les bus USB de votre machine de TP. Dès qu’un périphérique s’avère être un périphérique USB du type cherché, sauvez la "poignée" (obtenue avec <code>libusb_open</code>) vers ce périphérique dans un tableau statique global de type <code>libusb_device_handle* periphs[MAX_PERIPH]</code>.

	Vous pouvez utiliser la commande <code>lsusb</code> pour trouver les identifiants USB de votre type de périphérique. Pour chaque périphérique sélectionné, faites afficher le numéro du bus sur lequel se trouve le périphérique ainsi que son adresse sur ce bus.		Vous pouvez utiliser la commande <code>lsusb</code> pour trouver les identifiants USB de votre type de périphérique, même si ce n'est pas vraiment nécessaire puisque vous avez vous-même donné ces identifiants lors de la programmation du microcontrôleur. Pour chaque périphérique sélectionné, faites afficher le numéro du bus sur lequel se trouve le périphérique ainsi que son adresse sur ce bus.

	==== Appropriation des interfaces spécifiques ====		==== Appropriation des interfaces spécifiques ====

Rex : /* Programmation sur le PC */

2025-04-22T15:36:14Z

Programmation sur le PC

← Version précédente		Version du 22 avril 2025 à 15:36
Ligne 76 :		Ligne 76 :

	== Programmation sur le PC ==		== Programmation sur le PC ==

			En plus du programme "envahisseurs" que vous réalisez par ailleurs, vous allez devoir écrire un programme annexe pour gérer les codes de touches à utiliser.

	=== Utilisation de la carte dans le jeu "envahisseurs" ===		=== Utilisation de la carte dans le jeu "envahisseurs" ===

	Il n'y a de modification à apporter au jeu pour utiliser la carte en tant que dispositif de contrôle du vaisseau. Pour le nombre de vies utilisez le système de fichiers virtuel <code>sysfs</code>.		Il n'y a de modification à apporter au jeu pour utiliser la carte en tant que dispositif de contrôle du vaisseau. Pour le nombre de vies utilisez le système de fichiers virtuel <code>sysfs</code>. Regardez du coté du répertoire <code>/sys/class/leds</code>.
	Regardez du coté du répertoire <code>/sys/class/leds</code>.

	=== Gestion des codes de touches ===		=== Gestion des codes de touches ===

Rex le 22 avril 2025 à 15:34

2025-04-22T15:34:30Z

← Version précédente		Version du 22 avril 2025 à 15:34
Ligne 72 :		Ligne 72 :

	Référez-vous au cours "programmation des systèmes embarqués" pour la gestion du point d'accès de type interruption.		Référez-vous au cours "programmation des systèmes embarqués" pour la gestion du point d'accès de type interruption.

			Les associations doivent être sauvées en EEPROM. Pour cela vous pouvez utiliser les fonctions d'<code>avr-gcc</code> dont les prototypes se trouvent dans <code><avr/eeprom.h</code>, à savoir <code>eeprom_write_byte</code> et <code>eeprom_read_byte</code>.

	== Programmation sur le PC ==		== Programmation sur le PC ==
Ligne 112 :		Ligne 114 :

	Vous pouvez maintenant écrire le coeur du programme PC. Le programme doit prendre en argument un numéro de bouton et un code de touche. Une interruption USB doit être lancée pour demander à la carte d'effectuer une association entre ce numéro et ce code.		Vous pouvez maintenant écrire le coeur du programme PC. Le programme doit prendre en argument un numéro de bouton et un code de touche. Une interruption USB doit être lancée pour demander à la carte d'effectuer une association entre ce numéro et ce code.

	Les associations doivent être sauvées en EEPROM. Pour cela vous pouvez utiliser les fonctions d'<code>avr-gcc</code> dont les prototypes se trouvent dans <code><avr/eeprom.h</code>, à savoir <code>eeprom_write_byte</code> et <code>eeprom_read_byte</code>.

Rex : /* Code LUFA d’exemple */

2025-04-22T15:27:22Z

Code LUFA d’exemple

← Version précédente		Version du 22 avril 2025 à 15:27
Ligne 57 :		Ligne 57 :
	=== Code LUFA d’exemple ===		=== Code LUFA d’exemple ===

	Dans le répertoire de la bibliothèque LUFA, créez un répertoire PolytechLille au même niveau que les répertoires Demos et Projects. Dans ce répertoire, copiez la démonstration du sous-chemin <code>Device/LowLevel/Keyboard</code> sous le nom, par exemple, <code>Clavier</code>. Renommez aussi les fichiers dans le répertoire et modifiez le makefile. Au niveau du makefile indiquez le microcontrôleur correct, NONE comme platine de test, ajustez le chemin d’accès LUFA_PATH et passez à la bonne fréquence.		Dans le répertoire de la bibliothèque LUFA dont une version utilisable est disponible [https://rex.plil.fr/Enseignement/Systeme/Systeme.PSE/lufa-LUFA-210130-NSI.zip ici], créez un répertoire <code>PolytechLille</code> au même niveau que les répertoires <code>Demos</code> et <code>Projects</code>. Dans ce répertoire, copiez la démonstration du sous-chemin <code>Device/LowLevel/Keyboard</code> sous le nom, par exemple, <code>Clavier</code>. Renommez aussi les fichiers dans le répertoire et modifiez le makefile. Au niveau du makefile indiquez le microcontrôleur correct, <code>NONE</code> comme platine de test, ajustez le chemin d’accès <code>LUFA_PATH</code> et passez à la bonne fréquence.

	Vous pouvez compiler cet exemple et le charger sur votre carte (rappel un simple <code>make dfu</code> suffit). ~~Testez~~ ensuite que le périphérique USB est bien présent avec un <code>lsusb</code>. A ce point le clavier ne doit pas encore fonctionner.		Vous pouvez compiler cet exemple et le charger sur votre carte (rappel un simple <code>make dfu</code> suffit). Vérifiez ensuite que le périphérique USB est bien présent avec un <code>lsusb</code>. A ce point le clavier ne doit pas encore fonctionner.

	=== Adaptation de l'exemple à la carte ===		=== Adaptation de l'exemple à la carte ===

Rex : /* Principe */

2025-04-22T15:24:14Z

Principe

← Version précédente		Version du 22 avril 2025 à 15:24
Ligne 34 :		Ligne 34 :
	=== Principe ===		=== Principe ===

	Vous devez programmer l'ATmega8u2 de votre carte ou l’ATMega32u4 de la manette pour gérer le bus USB et réaliser un périphérique USB. Vous utiliserez <code>avr-gcc</code> comme compilateur C. Le téléchargement du programme sur le microcontrôleur se fera en utilisant l’utilitaire <code>dfu-programmer</code> capable de programmer les AVR ATMega8u2 et ATMega32u4 via le bus USB. Vous n’aurez pas à programmer directement les registres du microntrôleur pour gérer l’USB, vous utiliserez une bibliothèque nommée LUFA ~~dont une version utilisable est disponible [https://rex.plil.fr/Enseignement/Systeme/Systeme.PSE/lufa-LUFA-210130-NSI.zip ici]~~.		Vous devez programmer l'ATmega8u2 de votre carte ou l’ATMega32u4 de la manette pour gérer le bus USB et réaliser un périphérique USB. Vous utiliserez <code>avr-gcc</code> comme compilateur C. Le téléchargement du programme sur le microcontrôleur se fera en utilisant l’utilitaire <code>dfu-programmer</code> capable de programmer les AVR ATMega8u2 et ATMega32u4 via le bus USB. Vous n’aurez pas à programmer directement les registres du microntrôleur pour gérer l’USB, vous utiliserez une bibliothèque nommée LUFA.

	En première approche, vous devez implanter un périphérique USB HID (périphérique d’interface homme-machine, Human Interface Device en patoi). Plus précisement vous devez implanter un périphérique USB HID clavier. Un tel périphérique comporte une interface de classe HID avec au minimum un point d’accès entrant (IN). Vous devez faire en sorte que votre clavier gère les boutons de la carte comme des touches. Votre clavier USB doit aussi contrôler les LED présentes sur la carte.		En première approche, vous devez implanter un périphérique USB HID (périphérique d’interface homme-machine, Human Interface Device en patoi). Plus précisement vous devez implanter un périphérique USB HID clavier. Un tel périphérique comporte une interface de classe HID avec au minimum un point d’accès entrant (IN). Vous devez faire en sorte que votre clavier gère les boutons de la carte comme des touches. Votre clavier USB doit aussi contrôler les LED présentes sur la carte.

Rex le 22 avril 2025 à 15:18

2025-04-22T15:18:47Z

← Version précédente		Version du 22 avril 2025 à 15:18
Ligne 24 :		Ligne 24 :
	avrdude -c stk500v1 -p atmega32u4 -P /dev/ttyACM0 -b 19200 -U lfuse:w:0xFF:m -U efuse:w:0xF7:m		avrdude -c stk500v1 -p atmega32u4 -P /dev/ttyACM0 -b 19200 -U lfuse:w:0xFF:m -U efuse:w:0xF7:m

	Ensuite utilisez l'un des binaires de ~~cette~~ [[File:AVR_DFU_bootloaders.zip ~~archive~~]] et flashez le sur le microcontrôleur. Ci-dessous, un exemple pour l'ATmega32u4 :		Ensuite utilisez l'un des binaires de l'archive [[File:AVR_DFU_bootloaders.zip]] et flashez-le sur le microcontrôleur. Ci-dessous, un exemple pour l'ATmega32u4 :

	avrdude -c stk500v1 -p atmega32u4 -P /dev/ttyACM0 -b 19200 -U flash:w:ATMega32U4-usbdevice_dfu-1_0_0.hex		avrdude -c stk500v1 -p atmega32u4 -P /dev/ttyACM0 -b 19200 -U flash:w:ATMega32U4-usbdevice_dfu-1_0_0.hex

Rex : /* Installation d'un chargeur DFU */

2025-04-22T15:18:01Z

Installation d'un chargeur DFU

← Version précédente		Version du 22 avril 2025 à 15:18
Ligne 24 :		Ligne 24 :
	avrdude -c stk500v1 -p atmega32u4 -P /dev/ttyACM0 -b 19200 -U lfuse:w:0xFF:m -U efuse:w:0xF7:m		avrdude -c stk500v1 -p atmega32u4 -P /dev/ttyACM0 -b 19200 -U lfuse:w:0xFF:m -U efuse:w:0xF7:m

	Ensuite utilisez l'un des binaires de cette [[File:AVR_DFU_bootloaders.zip\|archive]] et flashez le sur le microcontrôleur. Ci-dessous, un exemple pour l'ATmega32u4 :		Ensuite utilisez l'un des binaires de cette [[File:AVR_DFU_bootloaders.zip archive]] et flashez le sur le microcontrôleur. Ci-dessous, un exemple pour l'ATmega32u4 :

	avrdude -c stk500v1 -p atmega32u4 -P /dev/ttyACM0 -b 19200 -U flash:w:ATMega32U4-usbdevice_dfu-1_0_0.hex		avrdude -c stk500v1 -p atmega32u4 -P /dev/ttyACM0 -b 19200 -U flash:w:ATMega32U4-usbdevice_dfu-1_0_0.hex

TPI SE3 2024/2025 - Historique des versions

Tvantroy : /* Matériel */

Rex : /* Fermeture du périphérique USB */

Rex : /* Appropriation des interfaces spécifiques */

Rex : /* Gestion des codes de touches */

Rex : /* Programmation sur le PC */