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:

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”.

6 Comments

  1. freebox-v6 said:

    Bonjour, l’API de la télécommande est désormais obsolète et est amené à disparaitre. Elle est désormais remplacée par un nouveau système décrit ici : http://dev.freebox.fr/sdk/

    26 décembre 2011
    Reply
    • Avatar photo Hervé said:

      Bonjour. Merci pour ce lien fort intéressant. Le SDK semble plus puissant que les appels HTTP mais peut-être un peu moins facile à mettre en oeuvre. C’est à étudier!

      27 décembre 2011
      Reply
  2. lleezy said:

    C’est bien expliquer tout ça mais…… COMMENT VOUS VOULER ALLER DANS LES PARAMETRE POUR AVOI LE CODE SI ON A PAS DE TELECOMMANDE ?!?!?!??!?!?!

    1 octobre 2012
    Reply
  3. hayat said:

    comment fait-on pour avoir le code de la telecommande de free v6 avec pour mon seul outil le boitier freebox (son micro ecran tactile )

    24 mars 2013
    Reply
  4. Eliam said:

    Merci beaucoup pour cet article, c’est exactement ce que je cherchai. Trop cool d’allumer la tv, et de mettre une chaine sur un scenario.

    30 mai 2013
    Reply
  5. website said:

    Je ѵaioѕ dire que ce n’est nullement erroոé ..

    13 mars 2014
    Reply

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Prouvez que vous êtes humain: * Time limit is exhausted. Please reload CAPTCHA.