Utiliser une CAMÉRA IP FOSCAM (HD) avec une box domotique 

Voici la marche à suivre pour intégrer une caméra Foscam HD - comme par exemple les modèles que nous commercialisons (FI9818W, FI9828W, FI9821P, FI9821EP, FI9831PFI9826P, etc.) - à une box (ou un logiciel) domotique.

 

API des caméras FOSCAM HD

Fonction Adresse URL
Stream 1 en H264 rtsp://adresse_ip_camera:port/videoMain
Stream 2 en H264 rtsp://adresse_ip_camera:port/videoSub
Changer Stream 2 en MJPEG** http://adresse_ip_camera:port/cgi-bin/CGIProxy.fcgi?usr=?????&pwd=?????&cmd=setSubStreamFormat&format=1
Flux vidéo MJPEG** http://adresse_ip_camera:port/cgi-bin/CGIStream.cgi?cmd=GetMJStream&usr=?????&pwd=?????
Photo JPG http://adresse_ip_camera:port/cgi-bin/CGIProxy.fcgi?cmd=snapPicture2&usr=?????&pwd=?????
Tourner à gauche* http://adresse_ip_camera:port/cgi-bin/CGIProxy.fcgi?cmd=ptzMoveLeft&usr=?????&pwd=?????
Tourner à droite* http://adresse_ip_camera:port/cgi-bin/CGIProxy.fcgi?cmd=ptzMoveRight&usr=?????&pwd=?????
Monter* http://adresse_ip_camera:port/cgi-bin/CGIProxy.fcgi?cmd=ptzMoveUp&usr=?????&pwd=?????
Descendre* http://adresse_ip_camera:port/cgi-bin/CGIProxy.fcgi?cmd=ptzMoveDown&usr=?????&pwd=?????

* Pour les modèles motorisés uniquement.
** Sur certains modèles uniquement (FI9821 V2 par exemple). 

Exemple pour le flux vidéo au format MJPEG d'une caméra ayant pour adresse IP 192.168.10.181, le port 80 (par défaut), l'utilisateur "admin" et le mot de passe "12345" :

http://192.168.10.181:80/cgi-bin/CGIStream.cgi?cmd=GetMJStream&usr=admin&pwd=12345 

 

Le port 80 étant standard, il est possible de l'omettre (dans ce cas, supprimer le :80) mais attention, certaines caméras Foscam utilisent le port 88, vérifiez donc avant.

 

Voici en téléchargement, le pdf complet des API des caméras FOSCAM HD : 

 

Récupération / Configuration de l'adresse IP

Une fois la caméra branchée et démarrée, si vous ne connaissez pas l'adresse IP de votre caméra, vous pouvez utiliser le logiciel PC / MAC "IP Camera Tool" fourni sur le CD-ROM de la caméra ou téléchargeable via ce lien.

 

Trouver sa caméra IP Foscam FI8910W

 

Vous pouvez aussi regarder dans la configuration du serveur DHCP de votre box / routeur Internet quelle adresse IP a été attribuée à la caméra. En cas de doute, vous pourrez la retrouver avec son adresse MAC (elle est marquée sur l'étiquette se trouvant sous la caméra).

Nous vous recommandons vivement d'attribuer une IP fixe à votre caméra :

  • Soit en réservant une adresse IP (bail statique) dans le menu DHCP de votre box / routeur Internet,

 

Exemple sur une Freebox (l'adresse MAC de votre caméra est indiquée sur son étiquette) :

 

Bail statique sur Freebox

 

  • Soit en configurant l'adresse IP de votre caméra à la main dans son interface ou via le logiciel "IP Camera Tool". Mais dans ce cas, il faudra veiller à ce que cette adresse ne soit jamais utilisée par le serveur DHCP de votre box / routeur (réserver l'adresse ou utiliser une adresse en dehors du "pool" d'adresses possibles.)
Nous recommandons plutôt la deuxième solution car si après une coupure de courant la caméra est prête avant la box Internet, le DHCP peut ne pas fonctionner.

 

Configurer l'adresse IP de sa caméra Foscam FI8910W

 

Informations sur le flux H264

Les caméras HD FOSCAM utilisent par défaut sur leurs deux flux le format de compression vidéo H264, et ce format est transmis via le protocole RTSP (protocole de streaming temps réel).

Contrairement au protocole HTTP, le RTSP ne peut pas être directement visualisé en tapant l'adresse dans un navigateur internet. Le flux H264 ne peut être visualisé que via l'interface web de la caméra ou un logiciel compatible RTSP comme VLC, l'interface web ou l'application de la Zipabox ou le logiciel impérihome par exemple.

Actuellement, les autres box domotiques ne sont pas compatibles avec ce format / protocole.

 

Afin de visualiser ces flux en H264, vous devez utiliser les APIs suivantes:

  • Pour le flux principal : rtsp://adresse_ip_caméra:port_rtsp/videoMain
  • Pour le flux secondaire : rtsp://adresse_ip_caméra:port_rtsp/videoSub 
Le port du flux RTSP peut être 80, 88 ou 554 suivant le modèle de la caméra et surtout sa version de firmware.
Sur les firmwares les plus récents, il est nécessaire d'activer le flux RTSP qui ne l'est plus par défaut. Pour cela, il faut aller sur la page web de configuration de la caméra, dans "réglages", "réseau" puis "onvif" et cocher la case "activé". Ce menu vous informera aussi sur le port utilisé pour RTSP, probablement le 554.

Informations sur le flux MJPEG

Les caméras HD de la marque FOSCAM ne possèdent pas, par défaut, de flux MJPEG.
Néanmoins, Foscam a laissé sur certains modèles (FI9821 V2 par exemple) la possibilité de "convertir" le flux secondaire, initialement H264, en MJPEG.
Cela est indispensable pour intégrer les caméras aux box domotiques non compatibles avec le H264.

 

Pour ce faire, il faut utiliser ces deux APIs:

  • Pour convertir le flux secondaire : http://adresse_ip_camera:port/cgi-bin/CGIProxy.fcgi?usr=?????&pwd=?????&cmd=setSubStreamFormat&format=1
  • Pour visualiser le flux une fois converti : http://adresse_ip_camera:port/cgi-bin/CGIStream.cgi?cmd=GetMJStream&usr=?????&pwd=?????

 

Pour plus d'informations sur la procédure à appliquer, veuillez suivre notre tutoriel sur l'activation du mode MJPEG sur les caméras Foscam HD .

Accès à distance

Avant toute chose, il est extrêmement important de changer votre mot de passe avant de donner accès à votre caméra depuis l'extérieur !

Choisissez un mot de passe complexe mélangeant minuscules, majuscules et chiffres, mesurant au moins 10 à 12 caractères et n'utilisant pas de mot ou nom courants.

Si votre box domotique est une eedomus, le mot de passe vous sera imposé par elle : il vous faudra donc soit changer le mot de passe admin soit créer un autre utilisateur ("eedomus" par exemple). Pour plus de détails concernant la configuration des caméras sur la eedomus, consultez le tutoriel officiel : http://doc.eedomus.com/view/Ajouter_une_cam%C3%A9ra_IP).

 

Pour accéder à distance à votre caméra, avec la plupart des box (sauf la Zipabox pour laquelle tout est automatique), il sera nécessaire d'effectuer une "redirection de port" sur le port 80 en TCP et en UDP.

Ce réglage s'effectue via votre box / routeur Internet, la méthode et les termes utilisés variant fortement d'un FAI / fabriquant de routeur à l'autre.

 

Exemple sur une Freebox (il y a deux redirections à créer, une en tcp et une en udp) :

 

Redirection de ports sur Freebox

 

La connexion depuis l'extérieur se fera via l'adresse IP de votre box internet complétée par le port choisi.

Par exemple : http://88.80.112.76:80

 

Si vous avez plusieurs caméras ou que votre port 80 est déjà utilisé, vous pouvez aussi faire de la translation de port en utilisant par exemple le port 181 (port externe) vers 80 (port interne) pour la caméra 1, 182 vers 80 pour la caméra 2 et ainsi de suite.

Là encore, la connexion depuis l'extérieur se fera via l'adresse IP de votre box internet complétée par le port choisi.

Par exemple : http://88.80.112.76:181 pour la caméra 1, http://88.80.112.76:182 pour la caméra 2 etc.

 

Exemple avec un routeur ASUS :

 

Redirection ou translation de port sur routeur ou box Internet 

 

Et si mon adresse IP Internet change tous les jours ?

Si vous avez une eedomus ou une Zibase, pas de problème, votre box domotique connaît votre adresse IP en permanence, il n'y a donc pas besoin de lui donner cette information.

Dans les autres cas, il peut être judicieux d'utiliser la fonction DDNS intégrée gratuitement aux caméras Foscam, allez pour cela dans le menu DDNS de votre caméra, activez-le ("enable") et récupérez l'adresse "Fabricant de domaine" (mauvaise traduction de la part de Foscam) : http://XXXXXX.myfoscam.org

La connexion depuis l'extérieur se fera maintenant via cette adresse complétée par le port choisi :  http://XXXXXX.myfoscam.org:port.

Plus besoin de connaitre l'adresse IP externe de votre box surtout si celle-ci change régulièrement :-) 

Fichiers attachés : Foscam IPCamera HD H264 CGI User Guide v1.0.5.pdf


Mis à jour le : 20/09/2016 à 11:24 Auteur : Boris Delplanque, technicien domotique-store.fr



Les nouvelles questions sont affichées en même temps que la réponse du technicien. Nous répondons généralement en moins d'une journée ouvrée, néanmoins, certaines questions peuvent nécessiter des tests ou recherches complémentaires et augmenter ce délai. Nous nous réservons le droit de ne pas publier ni répondre aux questions de service après-vente concernant un produit n'ayant pas été acheté sur notre boutique.