samedi 2 juin 2012

Karotz Kmd - Kommand Line Interface


Objectif : Envoyer en direct des ordres simples au Karotz sans passer par la procédure normale de développement et d'installation d'applications (appz) sur le store Violet. Aussi simple que d'imprimer !

Un simple .exe qui s'exécute en mode console (ms-dos) et permet ainsi d'exécuter des tâches automatisées et/ou de lancer des batches (.bat)

Télécharger le Zip - version compilée pour .NET v3.5
Pour la version .NET v4.0 c'est celui-ci

Plateforme : Windows avec .NET v 3.5 installé. Pour vérifier la version du .NET installé sur votre PC, allez dans le répertoire C:\Windows\Microsoft.NET\Framework et vous devriez y découvrir (un ou) plusieurs dossiers nommés v1.0.x v1.1.x v2.0.x v3.0 v3.5 v4.0.x. Le mieux est quand même d'avoir la version v3.5 au minimum. Dans le cas contraire, se rendre sur le site de MS pour télécharger le .NET

  • Installation : Télécharger le zip puis extraire les 4 fichiers (kzkmd.exe + kzkmd.ini + kzkmd.txt + google.protocolbuffers.dll) dans un dossier (nommé ici KzKmd pour le tuto).
  • Configuration
KzKmd.ini à éditer (avec un notepad)
# Karotz Kommander Conf file
# http://Wizz.cc
#
# Find your ip on your Kz account manager.
# Go to http://www.karotz.com

Host=192.168.1.4
# Default Port : always set to 9123
Port=9123
#
Modifier la ligne host avec l'adresse ip lcoale de votre Karotz. Vous pouvez la trouver sur votre compte Karotz. Ensuite cliquer sur le picto réprésentant votre Kz pour y décourvir son IP, Adresse MAC et Pseudo. Le port de communication est toujours le (tcp) 9123.

KzKmd.txt contient les commandes à envoyer au Karotz.
# Commentaire
led 0000ff
play http://mp3.live.tv-radio.com/fip/all/fip-32k.mp3
#
pause 10
#
  • Utilisation 
En ligne de commandes ou en batch.

kzkmd.exe [-conf=file.ini] [-file=kmd.txt] [-host=192....] [-port=9123] [-debug]

Par défaut le fichier de configuration est kzkmd.ini et le fichier de commandes kzkmd.txt

Les paramètres -host et -port passés en ligne de commandes sont alors prioritaires sur ceux définis dans le fichier .ini

Ex: kzkmd.exe -debug -host=192.168.1.110

L'InteractiveId obtenu lors de la connexion au Karotz est sauvegardé dans le fichier KzKmd.pid

Vous pouvez ainsi le récupérer avec un autre programme externe du même genre pour communiquer avec la session active.

On pouvait penser aussi à fermer cette session par l'url fournie par l'Api Violet dans sa section Dév http://api.karotz.com/api/karotz/interactivemode?action=stop&interactiveid=3e910454-xxx mais non trop beau !..

4 commentaires:

  1. Wow! This will really simplify Karot control.
    Can you give an example how to capture an image from a webcam and save to file using kzkmd?

    RépondreSupprimer
  2. Bonjour,

    Je viens d'acquérir un Karotz, et je me demandais en quoi tu avais coder ton binaire ? Des sources ou des liens d’exemple ?

    Cordialement,

    RépondreSupprimer
  3. Bonjour,

    Super initiative, génial!

    Serait-il possible d'obtenir le code source pour pouvoir l'adapter à d'autres usages (code lua, bash, etc) ?

    Merci.

    Merci.

    RépondreSupprimer