little_cat.exe
Documentation

(réception de data en UDP par le réseau et émission de dmx)

suite logicielle schwartzpeter
http://karistouf.free.fr/schwartzpeter.html


Little_cat  permet de recevoir les niveaux de 0 à 255 envoyés en UDP par un programme tiers ( vvvv, puredata, max,...).
Little_cat communique avec le hardware DMX choisi et retransmet ces niveaux.

Little_cat écoute un client UDP, que ce dernier soit sur  -  la machine qui l'héberge
                                                                                 -  une autre machine du réseau

Little_cat est donc ce que l'on nomme un serveur.
Little_cat est l'export du dialogue avec le hardware de schwartzpeter.
Il est mis gracieusement à disposition de la communauté des arts de la scène, dans une idée d'inter-opérabilité et de coopération.




*Configuration :

Paramétrer little_cat.exe

Ouvrir le fichier config_little_cat.txt

interface=4
udpport=11059
remote=0

3 paramètres:

*Le numéro d'interface à paramétrer fonction du hardware choisi:
1    Soundlight USBDMX 1 et 2, et toutes les interfaces utilisant la dll Dashard.dll
2    ENTTEC OPENDMX
3    LPTDMX ( ELEKTOR)
4    ENTTEC PRO
5    DMX512-ONLINE.NET
6    SUNLITE et toutes les interfaces utilisant la dll Dashard2006.dll
7    USBDMX.COM
8    DMX4ALL

*Le port UDP à écouter, vous devez bien sûr émettre depuis le client vers le même nuémro de port.

*Remote: si little_cat est remotable/controllable ou non depuis le client. 0 pour ne pas être en remote. 1 pour l'être.

Ne pas mettre d'espace, ou de return à la fin du dernier paramètre.




*Utilisation :




Lancer little_cat:

-Remote=0

Little_cat va chercher la dll, puis le hardware spécifié et l'ouvrir.
Si cette procédure ne peut fonctionner, un bip sonore se fait. Bien vérifier au démarrage que vous avez une informationindiquant que l'interface est branchée et trouvée.
Pour quitter frapper n'importequ'elle touche du clavier.

-Remote=1
C'est un mode de sécurisation.
Little-cat s'ouvre et attend de recevoir des ordres en UDP afin de pouvoir dialoguer avec le hardware:
Init        Initialisation du hardware ( recherche dll, ouverture interface, lancement du mode émission de dmx)
Close     Arrêt d'envoi de data, Fermeture du hardware, déchargement de la dll
Quit       Fermer le programme little_cat
Le mode remote est expérimental ( version septembre 2008). Des améliorations ne sauraient tarder.
A réception d'une trame de 512 circuits, un petit . est affiché.
L'envoi de dmx se fait à chaque réception de data.

INTERFACES DMX Petite Subtilité:

De nombreux constructeurs  ont suivi ENTTEC dans son choix de chipset pour faire du dmx.
On se retrouve donc avec plétore d'interfaces utilisant les procédures de FTDI, via le port VCOM.
Donc si vous utilisez une Enttec Pro et tapez le numéro d'une USBDMX.COM, la ENTTEC PRO apparaitra comme reconnue. Mais rien se produira dans l'envoi de data.
Les interfaces suivantes utilisent le VCOM: Enttec Open / Enttec PRO / DMX512-ONLINE.NET / USBDMX.COM / DMX4ALL


*Programmes  tiers:

Créer un client pour little_cat est extrêment simple et peut se faire depuis un vvvv, un Pd ou un Max... ou du flash, ou du  java, ou du C, ou du python, etc  ...

VVVV :

trois  patchs sont fournis en exemple:

pour envoyer du data simplement, en remote=0:
from_vvvv_To_little_cat_udpsender ( DMX ).v4
To_little_cat_udpsender_globalwave.v4

pour envoyer des ordres, en remorte=1:
To_little_cat_udpsender_Order_sample.v4


Autres programmes, spécifications :

Envoi de data:
little_cat attend en UDP un tableau  unsigned char Data[512]
0 est donc le circuit 1, et 512 le circuit 512
Ex. le circuit 12 à 100%: Data[12]=255

Envoi d'ordres:
little_cat attend en UDP un tableau unsigned char Order[10]
où les ordres sont du simple string:
Init
Close
Quit
ou bien C/ C++:
Order={'Init'}

Le tableau order[10] est créé pour pouvoir abriter le cas échéant d'autres infos ( univers et autres ).