Ces plugins pour mupen64plus et Project 64 exploitent la fonction d'accès direct aux manettes offerte par mes adaptateurs N64 à USB (versions 3 et plus) pour permettre au jeu tournant dans l'émulateur de communiquer directement avec les manettes.

Qu'est-ce que cela apporte? Plusieurs avantages! En voici quelques uns:

• Aucune calibration requise. Puisque le jeu parle directement avec la manette, il recevra exactement les mêmes valeurs d'axe que s'il ne s'agissait pas d'émulation. Bref, la manette fonctionnera et répondra aussi bien (ou aussi mal) et exactement comme dans la vraie vie, et ce sans efforts.
• Latency très bas. Lorsque le jeu doit lire la manette, le message de requête est sur le champ relayé à la manette par l'adaptateur qui à son tour retourne la réponse au jeu.
• Support potentiel de tout accessoire branché dans le port d'expansion de la manette N64 sans aucune intervention ni fonctionnalités y étant spécifiques requises de la part de l'émulateur, du plugin et de l'adaptateur (autre que l'accès direct). Ce qui veut dire:
  • Support du rumble pack (testé)
  • Support du memory pack (testé)
  • Support du transfer pack (confirmé!)
  • Support du Bio Sensor (testé)
  Comme lorsqu'une vraie console N64 est utilisée, il suffit simplement d'insérer l'accessoire voulu et le jeu s'occupe du reste. Aucune configuration de l'émulateur n'est nécessaire.
• Support de périphériques autres que des manettes.
  • Souris N64 (testé)
  • VRU (confirmé!)
  • Clavier N64 (non confirmé^[1])

^[1] Je ne peux pas tester les accessoires que je ne possède pas encore. Mais la beauté de la chose est qu'en théorie ça fonctionne déjà. (Contactez-moi si vous avez la chance de tester)

Voici quelques screenshots réalisés avec une carte mémoire N64 dans la manette. Le gestionnaire de mempak de Mario Kart 64 (maintenir START enfoncé lors du lancement du jeu) est utilisable malgré les glitch graphiques. En jeu, nous pouvons constater la présence d'un ghost (sauvegardé dans le mempak lors d'une partie précédente (le jeu a été redémarré depuis). Plus tard (et sur une machine Linux dans ce screenshot) les données écrites par MK64 peuvent être relues avec l'outil de gestion d'adaptateur.


Note: Pour l'instant il ne vaut mieux pas utiliser le gestionnaire d'adaptateur en même temps qu'un jeu est en marche.

---

Contributions:
MaMaLuigi9001 a testé le Transfer Pak et un Tremor Pak Plus (Équivalent au Rumble Pak de Nintendo) et tout fonctionne. Le jeux testés avec le Transfer Pak sont Pokemon Statium et Pokemon Statium 2 avec Project 64 version 2.3.0.216 sous Windows 10. Il précise toutefois que le jeu plante (l'écran devient noir) lorsqu'il se rends au Gameboy Tower.

Voici quelques screenshots avec les jeux Pokemon:


MaMaLuigi9001 confirme également que le VRU est fonctionnel, mais la version ports1_4 du plugin qui fait en sorte que le deuxième port de l'adaptateur fonctionne comme le port 4 du N64 est requise. Ce plugin fera partie de la version 1.0.0.

Ce plugin fonctionne uniquement avec les adaptateurs GC/N64 à USB raphnet de troisième génération. Vous n'êtes pas certain de quelle est la version de votre adaptateur? Il y a un moyen très rapide pour le savoir: Si le câble USB est amovible, c'est un adaptateur de troisième génération.

Photo	Modèle(s)	Supporté?
	ADAP-GCN64-USB_V3: Adaptateur manette N64 ou Gamecube à USB (v3, Boîtier Noir) ADAP-GCN64-USB-V_V3: Adaptateur manette N64 ou Gamecube à USB (v3, Boîtier Violet) Les prototypes (ADAP-USB-GCN64-V3-PROTO) et unités de pré-lancement (ADAP-USB-GCN64-V3-PR) fonctionnent aussi!	Oui
	ADAP-N64-USB_V3: Adaptateur manette N64 à USB (v3, Boîtier Noir)	Oui
	ADAP-2XN64-USB: Adaptateur pour deux manettes N64 à USB	Oui
	ADAP-GCN64-USB: Adaptateur manette N64 ou Gamecube à USB (n'est plus fabriqué)	Non
	ADAP-N64-USB: Adaptateur manette N64 à USB (n'est plus fabriqué)	Non

Note: Ce n'est pas par manque de volonté que les anciennes versions ne sont pas supportées. C'est simplement qu'elles ne permettent pas la communication directe avec les manettes.

Voici une illustration permettant de comparer les grandes lignes de l'architecture habituelle (input-sdl) et celle obtenue via le plugin d'accès direct raphnet.

---

La chaîne d'événements « normale » est plus ou moins la suivante: (écrit en pensant à mupen64plus, mais s'applique à project64 également)

1. L'adaptateur interroge la manette et store la réponse contenant les valeurs d'axes et de boutons en mémoire.
2. Le PC hôte interroge périodiquement l'adaptateur et reçoit en réponse l'état le plus récent.
3. Ce nouvel état fait son chemin à travers quelques niveaux logiciels driver HID, librairie DirectX ou pilote de joystick et librairie SDL. (L'information est en fait stockée dans un buffer quelque part)
4. Lorsque le jeu tournant dans l'émulateur fait requête de lecture d'état de la manette, une réponse est construite à partir des donnés les plus récentes obtenues par la librairie SDL.

Avantages

Désavantages

L'émulateur n'a pas a attendre. Les donnés les plus récentes sont déjà disponibles, il n'a donc qu'à les mettre dans le bon format et les retourner au jeu.

La valeurs exactes d'axes sont souvent perdues (calibration, attentes de l'émulateur vis-à-vis des limites de valeurs d'axe, etc), et obtenir exactement la sensation du jeu original peut nécessiter beaucoup d'ajustement. L'émulateur doit savoir s'il doit émuler un mempack ou un rumble pack. Il est nécessaire de configurer tout cela, cela dépends des jeux. Et bien que la vibration soit possible (avec le standard HID PID) le support des mempack est moins évident et généralement virtuel (stockage dans des fichiers).

---

La chaîne d'événements de l'approche directe est plus ou moins la suivante:

1. Le jeu tournant dans l'émulateur fait une requête de lecture d'état de la manette.
2. Le plugin se charge de transmettre la demande à l'adaptateur par USB
3. L'adaptateur retransmet la requête telle-quelle à la manette N64 (ou au périphérique en question)
4. La manette (ou périphérique) réponds
5. La réponse est reçue par l'adaptateur et retransmise par USB
6. Le plugin recoit la réponse et la sert sans modifications au jeu.

Avantages	Désavantages
Le jeu échange réellement avec la manette. Le support des accessoires tels le mem pack, rumble pack et autres fonctionne donc naturellement. La réponse de la manette ne subit aucune transformation. Les valeurs d'axes reçues par le jeu sont exactement les mêmes que dans la réalité. Pas d'inconnues et pas d'ajustements!	Puisque la requête doit faire un allez-retour jusqu'à la manette, l'acte de lire le statut des axes et boutons prends un peu plus de temps. Lorsqu'il y a beaucoup d'échanges (notamment pour la lecture et l'écriture de mempacks, cela peut causer un ralentissement temporaire de l'émulation.

Le fichier .zip pour Project 64 (voir la section téléchargement) contient plusieurs fichiers DLL, chacun correspondant à une version du plugin. Voici une table en expliquant les différences et utilitées:

Nom	Fichier	Raison d'être et description
Standard	pj64raphnetraw.dll	La version standard. supporte jusuqu'à 4 joueurs avec n'importe quelle combinaison d'adaptateurs à 1 et 2 ports.
1 joueur	pj64raphnetraw_1player.dll	Version spéciale ne prenant en charge qu'une seule manette, peu importe combien de ports votre adaptateur comporte. Permet parfois, selon le jeu, un léger gain de performance en évitant d'avoir à interroger une manette absente ou non utilisée. Utilisez cette version lorsque vous jouez seul, et la version standard (ci-dessus) lorsque vous jouez entre amis.
Ports 1 et 3	pj64raphnetraw_ports1and3.dll	Version spéciale faisant fonctionner les ports 1 et 2 de votre adaptateur comme les ports 1 et 3 de l'émulateur. Prévue pour le jeu Densha de GO! qui s'attend au raccord d'une manette spéciale dans le port 3.
Ports 1 et 4	pj64raphnetraw_ports1and4.dll	Version spéciale faisant fonctionner les ports 1 et 2 de votre adaptateur comme les ports 1 et 4 de l'émulateur. Prévue pour être utilisée avec le VRU qui doit être branché au port 4.
Net	pj64raphnetraw_net.dll	Il y a quelques problèmes (en ce moment inexpliqués) avec le jeu réseau sous Project64k. Cela ne fonctionne pas, à moins d'installer un très vieux firmware (version 3.3.2). Une nouvelle fonctionnalité visant à augmenter la performance a été ajoutée à la version 3.4.0, et c'est depuis que raphnetraw v0.9.4 s'en sert que ça va mal... Solution temporaire: Cette version n'utilise pas la fonctionnalité en question et permet le jeu en réseau, du moins je l'espère...

Question: Quel fichier me faut-il? Quelle est la différence entre le fichier .zip et le fichier .tar.gz?
Réponse: Les fichiers .zip contiennent des plugins pour Windows (.DLL) prêts à l'emploi. Les fichiers .tar.gz contiennent le code source. Si vous êtes sous Linux, c'est ce qu'il vous faut.

Flux RSS pour cette table

Version 2019-07-16 16 juillet 2019 (Mardi)
Maintenance pour mupen64plus seulement: (Pour project64, voir les versions précédences) Migration vers la version 2.1.0 de l'API de plugin
Fichier(s): mupen64plus-input-raphnetraw-1.1.0.tar.gz (30.6 KB) mupen64plus-input-raphnetraw-windows-1.1.0.zip (262.6 KB)

Pour installer et utiliser le plugin pour PJ64 deux fichiers doivent être copiés vers des endroits spécifiques.

1: Copiez le fichier suivant dans "répertoire d'installation PJ64"/Plugin/Input:

• pj64raphnetraw.dll

(Pour les version plus anciennes de PJ64 (par exemple, version 1.4) il faut mettre le DLL directement dans le répertoire Plugin car il n'y a pas de classification par type.)

2: Vous devez également copier le fichier suivant dans le répertoire racine de votre installation PJ64 (c'est à dire, le répertoire contenant le .EXE):

• libhidapi-0.dll

Ensuite dans la fenêtre de configuration de PJ64, choisissez "raphnetraw for Project64 version xx.xx" de la liste des input plugins.


Note: La version actuelle du plugin créera un fichier de logs nommé raphnetraw.log dans le répertoire de votre utilisateur.

Seule la version Net du plugin (voir Versions spéciales) est compatible avec 1964 en raison d'un hack de performance ne fonctionnant qu'avec Project64. (Ce hack empêche également le jeu en ligne de fonctionner sous Project64).

L'installation du plugin sous 1964 doit être faite ainsi:

1. Copiez le ficheir raphnetraw_net.dll vers le sous-répertoire plugin/ du dossier 1964.
2. Copiez le fichier libhidapi-0.dll dans le répertoire racine de 1964 (pas dans le sous-répertoire plugin)
3. Sélectionnez le plugin raphnetraw de la liste de la boîte de dialogue Change Plugins.

La version .zip du plugin disponible depuis la section téléchargements ci-dessus contient les versions 32 et 64 bits du plugin. Le contenu du .zip ressemble à ceci:

mupen64plus-input-raphnetraw-windows-0.9/
mupen64plus-input-raphnetraw-windows-0.9/README.md
mupen64plus-input-raphnetraw-windows-0.9/dist_win64/
mupen64plus-input-raphnetraw-windows-0.9/dist_win64/libhidapi-0.dll
mupen64plus-input-raphnetraw-windows-0.9/dist_win64/mupen64plus-input-raphnetraw.dll
mupen64plus-input-raphnetraw-windows-0.9/dist_win32/
mupen64plus-input-raphnetraw-windows-0.9/dist_win32/libhidapi-0.dll
mupen64plus-input-raphnetraw-windows-0.9/dist_win32/mupen64plus-input-raphnetraw.dll

Si vous avez la version 64 bit de mupen64-plus, utilisez fichiers du répertoire dist_win64. Pour la version 32 bits, utilisez plutôt les fichiers du répertoire dist_win32.

Installez le plugin (fichiers .dll) dans un répertoire que mupen64plus examinera lors de la recherche des plugins (ex: Dans le même répertoire que l'exécutable et des autres fichiers .DLL) puis lancez l'émulateur ainsi:

$ mupen64plus --input mupen64plus-input-raphnetraw

(en ajoutant naturellement les autres éléments applicables tels que le fichier du jeu)

Suivez les instructions du fichier README.md inclut avec le code source. Ensuite, Installez le plugin (fichier .so) dans le répertoire de plugins de votre installation mupen64plus puis lancez l'émulateur ainsi:

$ mupen64plus --input mupen64plus-input-raphnetraw

(en ajoutant naturellement les autres éléments applicables tels que le fichier du jeu)

Si vous n'êtes pas certain d'avoir réussi à lancer l'émulateur de manière à ce que le plugin raphnet-raw soit utilisé, jetez un coup d'oeil aux messages dans le terminal:

Je ne saurais être tenu responsable pour les dommages que l'utilisation des informations ou la mise en œuvre des instructions présentées sur cette page pourrait causer à votre équipement, à vous-même ou à autrui. Aussi, je ne donne aucune garantie quant à l'exactitude des informations et à leur fonctionnement.