{{tag>Xenial matériel clavier souris}}

====== Clavier et Souris Roccat ======

Roccat a développé des pilotes libres pour ses claviers et souris, disponible depuis la page de téléchargement du site en fonction du matériel supporté.
Le CD-ROM d'installation fournit ne les contient pas mais contient les manuels en PDF des claviers et souris. \\
Vous avez la possibilité de mettre à jour le [[https://sourceforge.net/projects/roccat/files/firmwares/|firmware]] depuis le pilote **sauf pour les Roccat Ryos MK FX et Skeltr où il faudra au préalable passer par Windows**.

<note>
En branchant le clavier ou la souris, on peut s'en servir avec sa configuration Hardware par défaut, mais pour accéder aux réglages, il faut compiler plusieurs paquets ou effectuer l'installation depuis les dépôts.
</note>

===== Compatibilité claviers et souris =====
<note important>
Ne semble pas compatible pour le moment avec la version 5.7.0 (à tester sur la 5.9.0) :
  * Kone Pure 2017 (souris, capteur OWL-EYE)
  * Kone EMP (souris, capteur OWL-EYE)
  * Leadr (souris, capteur OWL-EYE)
</note>

==== Compatibilité claviers ====
^ Modèle ^ Profils ^ Raccourcis ^ Macros ^
^ Arvo | 5 | Hardware | Software |
^ Isku | 5 | Hardware | Hardware |
^ Isku FX | 5 | Hardware | Hardware |
^ Ryos MK / Glow / Pro | 5 | Hardware | Hardware |
^ Ryos MK FX | 5 | Hardware | Hardware |
^ Ryos MK TLK Pro| 5 | Hardware | Hardware |
^ Skeltr | 5 | Hardware | Hardware |
^ Sova Membrane / MK | 5 | Hardware | Hardware |
^ Suora | 1 | Hardware | Hardware |

<note>**NB** : certains claviers — tel le **Roccat Ryos MK __FX__** ne proposent pas sous Linux la possibilité de mettre l'effet de clignotement sélectif par touche.
</note>
==== Compatibilité souris ====
^ Modèle ^ Profils ^ Raccourcis ^ Macros ^
^ Kiro | 1 | Hardware | Hardware |
^ Kone | 5 | Hardware | Hardware |
^ Kone[+] | 5 | Hardware | Hardware |
^ Kone Pure | 5 | Hardware | Hardware |
^ Kone Pure Optical | 5 | Hardware | Hardware |
^ Kone Pure Military \\ Kone Pure Optical Black | 5 | Hardware | Hardware |
^ Kone XTD | 5 | Hardware | Hardware |
^ Kone XTD Optical | 5 | Hardware | Hardware |
^ Kova[+] | 5 | Hardware | Hardware |
^ Kova Color | 5 | Hardware | Hardware |
^ Lua | 1 | Hardware | Hardware |
^ Nyth | 5 | Hardware | Hardware |
^ Pyra (avec ou sans fil) | 5 | Hardware | Hardware |
^ Savu | 5 | Hardware | Hardware |
^ Tyon | 5 | Hardware | Hardware |

===== Pré-requis =====
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.
  * **Avoir mis à jour le Firmware depuis Windows (Roccat Ryos MK FX)**
  * Avoir lu [[:tutoriel:comment_installer_un_paquet|comment installer un paquet]].
  * Avoir lu [[:terminal|comment se servir du terminal]].

===== Installation =====
Pour installer les paquets nécessaire au bon fonctionnement des souris Roccat :
  * [[:ppa#ajout_d_un_ppa_a_vos_sources_logicielles|Ajoutez le PPA]] **ppa:berfenger**((https://launchpad.net/~berfenger/+archive/ubuntu/roccat)) dans vos sources de logiciels.
  * Puis [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|rechargez la liste des paquets]],
  * [[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt>roccat-tools]]**.
  * Rajoutez ensuite chaque utilisateurs au groupe "roccat" afin de faire fonctionner le pilote sans avoir besoin de faire "sudo" sans arrêt
  * [[:clavier_souris_roccat#Event Handler|Dans une prochaine partie]], nous verrons comment utiliser **roccateventhandler** afin davoir les notifications et les effets pour le clavier.
<code>
sudo add-apt-repository ppa:berfenger/roccat
sudo apt-get update
sudo apt-get install roccat-tools
sudo usermod -aG roccat $USER
</code>

<note tip>**Il est important d'ajouter chaque utilisateurs au groupe roccat, sinon, il faudra faire un "sudo" à chaque opérations** \\ **$USER** représente le nom d'utilisateur à ajouter</note>

Enfin, il ne vous reste plus qu'à débrancher et rebrancher votre clavier ou souris (ou redémarrer si vous ne voulez pas plonger derrière le bureau) pour que tout fonctionne. \\ Bravo !

===== Configurations =====
<note tip>Notez toutefois que certains paramètres nécessitent **roccatheventhandler** pour bien fonctionner et que certains scripts ne sont pas les mêmes entre Windows et Linux.</note>
Les claviers et souris Roccat se configurent selon un principe simple : on paramètre son clavier ou sa souris et on stocke la configuration directement dans le matériel ! \\
Votre clavier ou souris s'en conservera  désormais ses paramètres, même si vous changez de système d'exploitation, que vous le rebranchez ailleurs, etc. \\
Pour changer les paramètres par la suite, il suffit de revenir dans une interface de configuration et de les ré-enregistrer. \\

Pour configurer la souris, faites une recherche via le [[:unity#tableau_de_bord_dash|tableau de bord Unity]], le lanceur KDE ou autre lanceur avec le mot clé **roccat**. \\
Pour le Roccat Kone Optical Black, il faut sélectionner le pilote Roccat Pure Military. \\

Si vous préférez tout faire en ligne de commande, vous pouvez choisir la configuration avec :
<code>
roccat_keyboard_launcher #Pour les claviers
roccat_mouse_launcher  #Pour les souris
</code>

Si vous avez lancé **roccat_mouse_launcher,** vous devriez voir apparaître une fenêtre de ce type : \\
{{:interface_souris_roccat.png}} \\

Si vous avez lancé **roccat_keyboard_launcher,** vous devriez voir apparaître une fenêtre de ce type : \\
{{:interface_clavier_roccat_1.png}} \\

La section **Misc** / ** Gamefiles ** permet d'appliquer le paramètre automatiquement si une application spécifique est lancée ! \\
{{:interface_clavier_roccat_2.png}} \\

Voici un exemple de Gamefiles (l'idéal est de mettre le chemin complet mais parfois, le nom fonctionne mieux) :
  * Counter-Strike
  * Half-Life
  * ioquake3
  * Deathmatch
  * Dota
  * /usr/bin/amarok
  * Mozilla Thunderbird
  * Mozilla Firefox
  * LibreOffice
  * GIMP
  * Facebook
  * YouTube
  * etc.

Pour les claviers, cochez //Emulate light effects//, pour émuler l'affichage du clavier sachant que roccatheventhandler doit tourner pour les effets Ripple FX, Fire et Plasma (voir dans **Misc** => **Scrip FX** pour sélectionner les effets). \\
Notez qu'il est préférable de désactiver le profil par défaut (si vous l'avez activé) pour éviter toute confusion lors des basculements de profils. \\
Vous pouvez renommer les profils, exporter les paramètres pour effectuer une sauvegarde (conseillé), importer pour restaurer etc.. \\
Lorsque vous cliquez sur **OK**, les paramètres se stockerons automatiquement sur le matériel.

<note tip>
Le [[http://www.roccat.org/Support/|manuel Roccat]], présent sur le CD "d'installation" de votre souris, décrit très bien comment utiliser cette interface.
</note>

===== Event Handler =====
Roccat Event Handler est la partie la plus importante mais étrangement, peu mentionnée. \\
En effet, le Event Handler va vous permettre pas mal de choses :
  * Avoir des effets bluffants sur le clavier
  * Avoir les notifications de changement de profil pour le clavier et la souris

Pour que cela fonctionne parfaitement, l'idéal est que cela se lance au démarrage du système mais bien entendu, les effets ne seront disponibles qu'après connexions à la session ! \\

<note>
Au préalable, je conseil d'appliquer la commande suivante suite à un message d'erreur détecté dans la console :
<code>sudo ln -s /usr/share/roccat/ryos_effect_modules/ripple.lua /usr/share/roccat/ryos_effect_modules/ripple.lc</code>
</note>

==== Création du script ====
N'oubliez pas au préalable que l'utilisateur doit être ajouté dans le groupe **roccat**. \\
Afin que roccateventhandler fonctionne au démarrage, mettez ce code dans un fichier que vous allez renommer **roccateventhandler** ou **roccateventhandler.sh** :
<code>
#!/bin/sh
roccateventhandler
</code>

Ensuite, déplacez ce fichier dans **/etc/init.d** et donnez-lui les droits d'execution :
<code>
sudo mv ./roccateventhandler* /etc/init.d
sudo chmod +x /etc/init.d/roccateventhandler*
</code>

==== Mise en place dans les runlevels ====
Afin que le script s’exécute au démarrage, il suffit de le mettre ensuite dans les runlevels en faisant un lien symbolique (pour les puristes) :
<code>
cd /etc/init.d/rc4.d
sudo ln -s ../roccateventhandler roccateventhandler
cd /etc/init.d/rc5.d
sudo ln -s ../roccateventhandler roccateventhandler
cd /etc/init.d/rc6.d
sudo ln -s ../roccateventhandler roccateventhandler
cd /etc/init.d/rcS.d
sudo ln -s ../roccateventhandler roccateventhandler
</code>

Ou pour faire plus simplement :
<code>
sudo ln -s /etc/inid.d/roccateventhandler /etc/rc4.d/roccateventhandler
sudo ln -s /etc/inid.d/roccateventhandler /etc/rc5.d/roccateventhandler
sudo ln -s /etc/inid.d/roccateventhandler /etc/rc6.d/roccateventhandler
sudo ln -s /etc/inid.d/roccateventhandler /etc/rcS.d/roccateventhandler
</code>
Redémarrez le PC, connectez-vous et admirez le résultat :-) !

===== Personnalisation de scripts =====
Il est possible de personnaliser ses effets ! \\
Pour cela, il suffit de copier l'un des fichiers présents dans **/usr/share/roccat/ryos_effect_modules** \\
Pour faire un effet Matrix par exemple, proche de l'effet Ripple FX faire ceci : \\
<code>
sudo cp /usr/share/roccat/ryos_effect_modules/ripple.lua /usr/share/roccat/ryos_effect_modules/Matrix.lua
</code>

Modifiez ensuite ce fichier avec votre éditeur de texte préféré, je vais prendre nano dans notre cas pour mettre les Xubuntuistes, les Ubuntuistes et Kubuntuistes d'accord : \\
<code>sudo nano /usr/share/roccat/ryos_effect_modules/Matrix.lua</code>
Dans la première ligne non commentée, vous allez voir ceci :
<code java>
-- Color capable devices use this color for the wave.
local COLOR = { red = 0xff, green = 0x00, blue = 0x00 }
</code>
Le **ff** après le **0x** indique que l'effet est rouge, sans vert ni bleu (car ils sont à 00 après le 0x).\\
Vous avez compris le principe : il s'agit de RGB (Rouge Vert Bleu) : ff étant la valeur maximale et 00 la valeur minimale.\\
Modifiez la ligne de code ainsi, enregistrez et testez : \\
<code java>
-- Color capable devices use this color for the wave.
local COLOR = { red = 0x00, green = 0xff, blue = 0x00 }
</code>
Néo est dans votre clavier :-) ! \\

Vous trouverez facilement sur Google des palettes RGB et si vous voulez faire vos propres effets, il vous suffit d'éditer le code à votre sauce :-) ! \\

===== Désinstallation =====
Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]] :
<code>
sudo apt-get remove roccat-tools
</code>
 
Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. \\
Les journaux du système ainsi que les fichiers de préférences des utilisateurs dans leurs dossiers personnels seront toujours conservés.
 
===== Utilisation =====
Vous savez vous servir d'un clavier et d'une souris, non ? ;-) \\
[[https://youtu.be/zd6qTpZUkWA|Petite présentation en vidéo]] \\

===== Voir aussi =====
  * **(fr)** [[http://www.roccat.org/Support/|Site officiel de Roccat]]
  * **(en)** [[https://sourceforge.net/projects/roccat/|Page Sourceforge du pilote Linux de Roccat]]

----
//Contributeurs principaux : [[utilisateurs:yagraph|Yagraph]] et [[utilisateurs:Judibet|Judibet]]//