piKey v0.3: maintenant compatible avec le 3.40OE

Concept de base

piKey consiste en un module central framework, qui agit comme un coordinateur entre une collection de modules de plug-in.

Chaque plug-in procure une interface entre le framework, mais également la source d'entrée (Par exemple un clavier) - Ils sont appelés plug-ins d'entrée - ou un environnement d'entrée sur la PSP (Comme un clavier visuel sur l'écran) - Ils sont appelés plug-ins de sortie.

piKey chargera et activera n'importe quel plug-in que vous aurez installé, vous pourrez donc facilement choisir quelle fonctionnalité vous voulez utiliser à n'importe quel moment.

Installation

piKey se lance mieux en tant que plug-in pour les custom firmwares de Dark_AleX, même si il peut être lancé par un homebrew qui a besoin d'une entrée clavier.

Le moyen le plus simple de l'installer est d'utiliser l'installateur présent dans l'archive.

Premièrement, téléchargez l'archive de piKey. Copiez l contenu du répertoire MS_ROOT directement sur votre Memory Stick. Allez ensuite dans le menu Jeux de votre PSP et lancez l'homebrew nommé piKey installer. L'installateur vous demandera si vous voulez copier le prx pikey dans le flash0 et si vous voulez le lancer automatiquement en kernel 1.50. Tout ceci, n'étant recommandé que si vous savez ce que vous faites lorsque vous écrivez les fichiers dans le flash0. Une fois que l'installateur à copié les fichiers au bon endroit sur la PSP, redémarrez-la et allez dans le Recovery Mode, en pressant R au démarrage, puis allez dans la partie Plugins. Vérifiez que pikey.prx est bien activé dans le mode VSH et GAME !

Les Plugins
piKey vient avec les plugins suivants par défaut : Plugins d'Entrée

IR - Ce plugin utilise la librairie de clavier infrarouge de Monsti pour supporter l'entrée de différents types de clavier infra-rouges.

SIO - Ce plugin supporte l'entrée via un cable Serial I/O. Les câbles SIO se branchent au port écouteurs de la PSP, pour procurer une interface serial. Vous pouvez utiliser le plugin SIO pour afficher les informations debug d'autres plugins de piKey.

Plugins de sortie

CTRL - Ce plugin simule des pressions de touches sur la PSP, en mappant les touches pressées sur le clavier à d'autres boutons sur la PSP. Pour le moment, le curseur de touches simule des pressions des flèches directionnelles (D-Pad)

OSK - Ce plugin détecte quand le clavier virtuel de la PSP est actif, et traduit les fichiers touches de piKey en un bouton nécessaire pour entrer le texte dans l'OSK.

DANZEFF non disponible - Ce plugin fonctionne comme le plugin OSK, mais contrôle les homebrews utilisant la méthode de texte DANZEFF. Le plugin est seulement actif en mode JEUX. Il n'y a aucun moyen facile de détecter quand un clavier Danzeff est lancé, vous aurez donc à activer le mode "nKey's Danzeff" manuellement, en appuyant sur Ctrl-D de votre clavier. Une fois votre texte écris, désactivez le plugin avec Ctrl-D. nKey vous affichera son statut avec un message à l'écran.

Configuration

La configuration est généralement plutôt simple effectuer. piKey devrait être convenablement configurable par la plupart des utilisateurs. Voici quelques choses que vous devez savoir :

Sélectionner le plugin que vous voulez utiliser

Si vous n'utilisez par un plugin particulier, vous pouvez choisir de l'empecher d'être lancé. C'est simple : Supprimez simplement le PRX concerné qui se trouve dans "ms0:/seplugins/pikey/inputdrivers/" ou "ms0:/seplugins/pikey/outputdrivers/

Autre fichier de configiration:

pikeyconfig.txt contient les paramètres suivants:

SIO DEBUG - Contrôle si des messages de debug s'affiche sur l'interface série câble.

STATUS MESSAGES - Contrôle si les messages d'état s'affiche sur l'écran.

DISABLED IN 150 - contrôle si πKey fonctionne pour les homebrews en mode FW150 -

DISABLE HOTKEY - controle quelle touche est utilisé pour empecher πKey de se lancer lors du demearrage de l PSP. Par defaut, cette touche est SELECT. Vous pouvez parametrer n'importe quelle combinaison de touches en suivant des contyactes de touches définies dans pspctrl.h du Kit de développement PSP non officiel.

Désactiver piKey

Vous pouvez utiliser le Menu Recovery de votre custom firmware pour choisir quand piKey doit être chargé. Démarrez simplement le Mode Recovery, sélectionnez les options de "Plug-ins". Vous pouvez choisir ici quels plug-ins vous voulez charger et dans quel mode de kernel. piKey est contrôlé par les entrées de pikey.prx bien évidemment.

Par défaut piKey est chargé dans les modes VSH et GAME

Configuration individuelle des plug-ins Plugin IR

Pour l'instant c'est le seul plug-in avec une configuration qui est disponible. Le plug-in IR a besoin de savoir quel clavier vous avez installé - Vous pouvez le dire en éditant le fichier "ms0:/seplugins/pikey/pspirkeyb.ini" sur votre carte mémoire. Il utilise le clavier Targus par défaut.

Vous pourrez également avoir besoin de vérifier si vous utiliser le bon keymap - regarder la partie "map = " dans le fichier ini si vous avez besoin de le changer. QWERTY est utilisé par défaut. (AZERTY est le keymap européen !)

Utiliser piKey

Il n'y a pas grand chose a expliquer. Une fois installé et configuré, connectez votre clavier, vérifiez qu'il est bien branché et redémarrez la PSP. Dans le menu, dans un jeu, vous devrez trouvez que le plug-in CTRL est le seul plug-in de sortie actif.

Si vous tapez vos touches sur le clavier, vous verrez que la plupart ne fonctionnent pas encore. Mais si vous utilisez les touches directionnelles, le curseur du XMB bougera ! Super ! Vous pouvez désormais utiliser un clavier sur votre PSP. ENTRER simulera un bouton de confirmation (X ou O selon le paramétrage de votre PSP) et ESC simulera un bouton d'annulation. Vous pouvez presser F1 pour afficher un écran d'aide montrant toutes les touches.

Essayons maintenant d'utiliser le clavier virtuel. Allez dans paramètres Système, et Pseudo. Cela affichera le clavier virtuel, et le plug-in OSK s'activera, donc tout ce que vous taperez sur votre clavier sera automatiquement entré sur le clavier virtuel. Les touches Gauche et Droite bougeront le curseur de texte, la touche Retour effacera le caractère. Vous pouvez utiliser ESC pour annuler ou ENTER pour valider

Utiliser le SIO à la place de l'IR

Si vous avez un câble Serial I/O connecté à votre port écouteurs de votre PSP, vous pouvez taper depuis un terminal serial dans piKey. Vous aurez besoin d'avoir les paramètres suivants configurés pour votre terminal :

Vitesse de connexion 4800 baud.

8 data bits, pas de parité, et 1 stop bit (8n1)

Pas de contrôle "flow"

Émulation du terminal VT100

Le terminal SIO recevra également des messages de statut et de debug de la part du framework de piKey.

Problèmes

Si πKey interfère avec des jeux ou des homebrew, vous pouvez facilement le désactiver en maintenant appuyé la touche que vous avez choisi comme touche de désactivation (SELECT par défaut) lors du redémarrage de la PSP (au moment du logo Sony).

Si vous avez un problème pour faire fonctionner piKey, vous pouvez utiliser la liste suivante pour tenter de trouver ce qui ne marche pas ou ce qui n'est pas bon.

Vérifiez que piKey est activé dans le Recovery Mode.

Essayez de lancer hblib_sample c'est un programme très basique qui affiche votre entrée sur l'écran de la PSP. Si cela fonctionne, vous avez probablement un problème avec un plugin de sortie.

Vérifiez que votre clavier ou autre périphérique fonctionne, en utilisant un autre programme qui n'utilise pas piKey. Par exemple les programmes de teste de la librairie de claviers IR.

Vérifiez que vous avez les fichiers suivants sur votre memory stick:

ms0:/seplugins/pikey.prx

ms0:/seplugins/pikey/outputdrivers/piKeyCtrlout.prx

ms0:/seplugins/pikey/outputdrivers/piKeyOSKout.prx

ms0:/seplugins/pikey/inputdrivers/piKeysio.prx

ms0:/seplugins/pikey/inputdrivers/piKeyIR.prx

ms0:/seplugins/pikey/pspirkeyb.ini

ms0:/seplugins/pikey/keymap/novaets-kis2.ini

ms0:/seplugins/pikey/keymap/default.ini

ms0:/seplugins/pikey/keymap/qwertz-include.ini

ms0:/seplugins/pikey/keymap/README.txt

ms0:/seplugins/pikey/keymap/azerty-include.ini

ms0:/seplugins/pikey/keymap/qwerty-include.ini

Si vous avez un cable SIO, branchez le et selectionnez 4800 baud, 8n1 sans contrôle "flow" sur votre terminal. Ceci devrait vous aider a trouver votre problème. Notez que vous aurez besoin d'un plug-in SIO lancé pour pouvoir utiliser ceci.

Projets futurs

De nombreuses choses sympathiques sont prévues pour piKey dans le futur. Ceci inclue :

Nouveaux plug-ins pour

Entrée via le clavier virtuelInput de Danzeff, pour ceux qui n'ont pas de problèmes hardware. Le clavier de Danzeff est le software de clavier le plus efficace que Fanjita ait vu.

Sortie via Psprint et le clavier de Danzeff, pour les homebrews qui les utilise déjà.

Bon support de l'UFT-8 pour les caractères non-US-ASCII.

Possibilité de lancer piKey via le HEN

Configuration améliorée, pour l'instant de différents Sony sets de caractères du SDK de Sony

Ajout du support pour les touches spéciales du Clavier Targus

Remerciement de Fanjita :

Merci à PSP-Generation, qui a donné le matériel qui  permis le développement original de πKey possible.

D'énormes merci à ceux dont le code a été utilisé directement, ou de façon inspirée, et plus particulièrement TyRaNiD, Monsti et Danzel.

Ce programme n'a pas pu être testé par PSPgen car nous n'avons pas de clavier compatible.

Nous comptons sur vous pour nous ramener vos impressions que nous transmettrons à Fanjita.