Piloter la Freebox Révolution V6 / HD V53 minute(s) de lecture

Problématique : Peut-on piloter la Freebox depuis un système domotique (ou autre)?

Solution : Oui. Mais…

On peut piloter la Freebox via le protocole HTTP.  Cela permet de remplacer la télécommande depuis n’importe quel support informatique communiquant en HTTP.  Plusieurs applications existent pour PC, MAC, iPhone, Android…

Le protocole de pilotage a été mis en place par FREE (API) pour la Freebox V5 et est également disponible pour la Freebox Révolution (V6) .

Il faut pour cela:

• récupérer son code de télécommande Freebox : il est disponible dans Free > Paramètres > Informations générales > Code télécommande.
• appeler une requête HTTP pour piloter le boitier TV de la freebox :http://hd1.freebox.fr/…

Principe de fonctionnement

Le principe de fonctionnement est simple, une requête HTTP GET suffit.  Si l’on considère que le code récupéré de la Freebox est “1236547” on aura:

• Pour un appui :
  http://hd1.freebox.fr/pub/remote_control?code=12345678&key=<touche>
• Pour un appui prolongé :
  http://hd1.freebox.fr/pub/remote_control?code=12345678&key=<touche>&long=true
• Pour un appui répété :
  http://hd1.freebox.fr/pub/remote_control?code=12345678&key=<touche>&repeat=<n>

Si l’on souhaite piloter un second boitier TV dans sa maison,  hd1.freebox.fr peut être remplacé par hd2.freebox.fr pour commander le deuxième boitier.

Liste des actions

Voici de haut en bas, et de gauche à droite (par rapport à la télécommande physique) les valeurs disponibles pour :

red : le bouton rouge (B)
green : le bouton vert (A)
yellow : le bouton jaune (Y)
blue : le bouton bleu (X)

power : la touche rouge on/off
list : la touche d’affichage de la liste des chaînes entre power et tv
tv : la touche verte TV de commutation péritel.

0 à 9 : les touches 0 à 9

back : la touche jaune en dessous du 7
swap : la touche en dessous du 9

info, mail, help, pip : les touches bleues à droite des numéros de chaîne
epg, media, options : les fonctionnalités “secondaires” de ces mêmes touches

vol_inc, vol_dec : volume+ et volume-
prgm_inc, prgm_dec : program+ et program-
ok : touche OK
up, right, down, left : les touches directionnelles entourant le OK

mute : la touche de mise en sourdine
home : la touche free
rec : la touche d’enregistrement
bwd : la touche de retour en arrière (<<)
prev : la touche “précédent” (|<<)
play : la touche lecture/pause
fwd : la touche d’avance rapide (>>)
next : la touche “suivant” (>>|)

Limitations

Le “mais” lancé en début d’article concerne le manque de retour d’état de la Freebox.  On ne sait pas dans quel état est la Freebox à un instant t. 

Un exemple?

• Si l’on alume la Freebox on ne sait pas à l’avance si on trouvera une image de la “page d’acceuil”, si l’on trouvera une image d’une chaîne de la TV ou autre…
• Si l’on envoie : http://hd1.freebox.fr/pub/remote_control?key=power on ne sait pas si l’on communique un ordre d’extinction ou d’alumage de la Freebox.  Tout dépends de son état avant l’envoi de cette commande!

Conclusion

Ca marche! 

La Freebox peut être pilotée dans des scénari de systèmes domotiques (avec les limitations décrites ci sessus) ou bien simplement pilotée sans la télécommande d’origine en utilisant l’une des multiples applications existantes (gratuites ou payantes) disponibles pour les différents systèmes d’exploitation.

Pour effectuer cela avec la Zibase il suffit d’inclure la commande HTTP dans un scénario via une action de type “Fonctions Spéciales” => “Commander par HTTP”.