Linux driver for Novation Launchpad Files

1) Français
2) English


1) ***************** FRANCAIS *******************
---- Installation ----
- Exécuter la commande 'make'
=> un fichier 'NovaLPDrv.ko' doit être créé
- Exécuter la commande 'make install' en root ou avec sudo
- Redémarrer le poste

Lors du branchement du launchpad, /dev/nlp0 devrai apparaitre avec les droits écriture/lecture pour tout le monde

ATTENTION : Lors d'une montée de version de votre kernel, il faudra recommencer cette procédure

---- Problème ----
Lors du branchement du launchpad si aucun /dev/nlp n'apprait, suivre la procédure suivante :
- Démarrage du poste
- Chargement du driver : (ne pas brancher le launchpad tant que le driver n'est pas chargé !)
'sudo insmod /lib/modules/$(uname -r)/kernel/drivers/usb/misc/NovaLPDrv.ko'
- Branchement du launchpad (normalement nlp0 doit apparaitre dans /dev)
- Changement des droits pour la lecture/écriture pour tous sur le launchpad :
'sudo chmod 666 /dev/nlp0'

---- Désinstallation ----
- Exécuter la commande 'make remove'

---- Pour les développeurs ----
- Pour récupérer le dernier état (1444 ou 176) du launchpad, coté materiel
  L'application doit envoyer 2 octets {LP_OPTION, LP_GET_STAT}
  Le driver répondra 3 octets {LP_OPTION, LP_GET_STAT, LP_MENU ou LP_GRID}

- Pour récupérer la version du driver 
  L'application doit envoyer 2 octets {LP_OPTION, LP_GET_VERSION}
  Le driver répondra 4 octets {LP_OPTION, LP_GET_VERSION, octet 1, octet 2}
  exemple pour la version 0.28 : octet 1 = 0, octet 2 = 28

- Lorsque le launchpad est débranché : 
  Le driver enverra 2 octets {LP_OPTION, LP_IS_UNPLUG}

2) ***************** ENGLISH ******************

---- Installation ----
- Execute the command 'make'
=> a file 'NovaLPDrv.ko' must be created
- Execute the commande 'make install' when root or with sudo
- Reboot computer

When you plug your launchpad, '/dev/nlp0' should appear with read and write rights for all

WARNING : When you upgrade your kernel, you'll have to restart this procédure

---- Troubleshot ----
When plugging the launchpad, if no /dev/nlpl appears try this procedure :
- Start your computer
- Load the driver : (Don't plug the launchpad before driver is loaded)
'sudo insmod /lib/modules/$(uname -r)/kernel/drivers/usb/misc/NovaLPDrv.ko'
- Plug the launchpad (nlp0 should appears into /dev)
- Change read/write rights for everyone on the launchpad :
'sudo chmod 666 /dev/nlp0'

---- Uninstall ----
- Execute the command 'make remove'

---- For developpers ----
- To retrieve the last stat (144 or 176) of the launchpad, hardware side
  The software must send 2 bytes {LP_OPTION, LP_GET_STAT}
  The driver will answer 3 bytes {LP_OPTION, LP_GET_STAT, LP_MENU or LP_GRID}

- To retrieve the driver version
  The software must send 2 bytes {LP_OPTION, LP_GET_VERSION}
  The driver wille answer 4 bytes {LP_OPTION, LP_GET_VERSION, byte 1, byte 2}
  example for 0.28 version : byte 1 = 0, byte 2 = 28

- When launchpad is unplug :
  The driver will send 2 bytes {LP_OPTION, LP_IS_UNPLUG}