Résolution des problèmes techniques

Les mangeoires du réseau sont en perpétuel développement et amélioration. Si vous rencontrez des problèmes avec votre mangeoire, essayez d'abord ce guide pour le corriger. Si vous avez un souci, le bureau peut également vous aider, dans la mesure de ses disponibilités ! (bureau@poids-plume.fr)

Problèmes techniques

Ma mangeoire ne prend plus de vidéos

Si votre mangeoire ne prend plus de vidéos, mais le faisait auparavant sans que vous soyez intervenu dessus, il est possible que la caméra soit simplement "plantée". Ce problème se manifeste souvent par les lignes suivantes dans le log:

system 2021-11-19 07:20:13 carduelis start_loggers[854]: mmal: mmal_vc_component_enable: failed to enable component: ENOSPC
system 2021-11-19 07:20:13 carduelis start_loggers[854]: mmal: camera component couldn't be enabled 
system 2021-11-19 07:20:13 carduelis start_loggers[854]: mmal: main: Failed to create camera component
system 2021-11-19 07:20:13 carduelis start_loggers[854]: mmal: Failed to run camera app. Please check for firmware updates

Un redémarrage de la mangeoire peut alors solutionner le problème. Un système automatique est présent sur les mangeoires, pour s'assurer que la caméra est en état de fonctionnement (logiciel v3.0 et plus). Si ce n'est pas le cas, alors la mangeoire va redémarrer toute seule. Lorsqu'un tel mécanisme s'active, les lignes suivantes sont présentes dans le log:

watchdog 2021-12-16 13:30:02 !!!!!!!!!!!!!! WATCHDOG camera ELAPSED !!!!!!!!!!!!!!
watchdog 2021-12-16 13:30:02 Last kick was at 1639645203, which is more than 10800s
watchdog 2021-12-16 13:30:02 Restarting feeder in 60 seconds.

A noter que le message ci-dessus peut apparaître également de temps en temps, lorsque les visites à la mangeoire se succèdent trop vite -- pas d'inquiétude à avoir dans ce cas, il s'agit d'une limite technique de la caméra.

Si le problème persiste malgré un ou plusieurs redémarrages, alors il peut s'agir d'un problème de connexion entre le Raspberry Pi et la caméra: il faut alors ouvrir la mangeoire et vérifier que les connexions soient bien faites. Le ruban connecteur orange doit être bien enfoncé et parallèle à la fiche. Si le problème persiste, alors il est possible d'envisager de changer le ruban orange connecteur de la caméra (d'abord) et la caméra elle-même (ensuite).

Ma mangeoire ne se connecte plus à internet

Si votre mangeoire était connectée à internet, mais ne l'est plus, il est possible simplement qu'il y ai un souci ponctuel de wifi: tentez de redémarrer la mangeoire. Si cela persiste malgré le redémarrage, essayez de faire la même manipulation proche de votre routeur ("box" internet). Si la connexion se réétablit, il est possible que votre mangeoire soit simplement trop loin du routeur pour pouvoir s'y connecter de manière fiable. Essayez de placer votre mangeoire plus proche de votre routeur. Une autre possibilité est que votre routeur soit sur un canal déjà encombré par les réseaux wifi voisins: il y a alors trop de "bruit" pour que la transmission se fasse bien entre votre mangeoire dehors et le routeur (la "box"). Essayez de changer le canal wifi utilisé par votre box (il s'agit d'un réglage à faire le plus souvent dans l'interface d'administration de la box).

Si malgré tout, le problème persiste, il est possible que le raspberry pi de la mangeoire soit dégradé. Prendre contact avec le bureau pour regarder plus en détails et peut être changer des composants.

Des oiseaux se posent sur le perchoir, mais la mangeoire ne prend pas de vidéos

Les accidents arrivent... il est possible que le perchoir de votre mangeoire soit cassé ! Les capteurs de masse sont très (très) sensibles. Envoyez un message au bureau (bureau@poids-plume.fr) pour demander un avis sur votre mangeoire, il est souvent possible de diagnostiquer le problème avec les données disponibles sur le portail d'accès aux données (https://data.poids-plume.fr).

Des oiseaux se posent sur le perchoir, mais la mangeoire ne prend pas de vidéos et/ou le poids est aberrant

Symptomes : la mangeoire est bien connectée sur le site, des oiseaux se posent mais pas de vidéos. Lorsque l'on regarde le poids de base (sans oiseaux, dispo dans données brutes sur votre page de mangeoire), le poids est aberrant (~ 135g pour moi sans oiseau).

Dans ce cas, il se peut que le problème soit lié à des graines coincées entre le perchoir et la mangeoire, empêchant ainsi qu capteur de masse d'être influencé par le poids des oiseaux sur le nichoir. Il faut simplement retirer les graines et cela repart. Il est également possible que le capteur de masse soit en bon état, mais qu'il faille le recalibrer (voir plus loin sur cette page).

Étapes techniques

Se connecter en ssh à la mangeoire

Il est parfois nécessaire de se connecter à la mangeoire pour mieux comprendre quel peut être le problème. On utilise pour cela ssh. ssh est un logiciel qui va nous permettre d'ouvrir une invite de commande sur la mangeoire -- il s'agit d'une interface textuelle dans laquelle nous allons pouvoir lancer des commandes afin d'effectuer des actions sur la mangeoire.

Afin de se connecter à la mangeoire, vous pouvez utiliser la commande suivante, à taper dans un terminal (présent sous windows 10 et +, mac ou linux):

ssh pi@<mangeoire> 

où "<mangeoire>" est le nom de votre mangeoire (pyrrhula, poecile, etc.). Cela marche souvent car les routeurs familiaux savent associer un nom d'hôte (le nom de votre mangeoire) à une adresse ip. Si la commande ci-dessus échoue (typiquement avec une erreur 'ssh: Could not resolve hostname <mangeoire>: Name or service not known'), c'est que votre routeur ne sait pas faire cette association. Il faut alors lancer la même commande en utilisant explicitement l'adresse IP de votre mangeoire, la plupart du temps quelque chose de la forme suivante:

ssh pi@192.168.1.xx 

où xx est un nombre entre 1 et 255. L'adresse IP d'une mangeoire est affichée dans les logs de celle-ci (aller sur la page correspondante sur data.poids-plume.fr), avec une ligne de ce genre (notez l'adresse ci-dessous, 192.168.1.23):

system 2021-12-22 00:59:01 Dec 22 00:04:24 merula dhclient[397]: DHCPREQUEST for 192.168.1.23 on wlan0 to 192.168.1.1 port 67

Si la commande ssh réussit, vous devriez être présenté(e) à une invite de mot de passe (qui vous aura été transmis par quelqu'un du bureau): entrez-le puis tapez sur 'Entrée'. C'est normal qu'aucun caractère ne s'affichent lorsque l'on tape le mot de passe. Une fois le mot de passe entré, la mangeoire vous affiche un message d'accueil, et une invite de commande vous est présentée. Vous pouvez alors taper les commandes nécessaires pour la résolution du problème ci-dessus. En particulier, la commande 'feederctl' permet d'effectuer les actions habituelles de gestion des mangeoires.

Calibrer le capteur de masse

Le capteur de masse des mangeoire se base sur la lecture d'une micro variation de tension électrique. Dans la résine blanche située sur la barre en aluminium si situent des petites pastilles: lorsqu'un poids est placé sur la barre en aluminium, celle-ci se déforme très légèrement, ce qui fait varier le courant électrique. Afin de pouvoir relier les variation de la tension électrique à une valeur de masse vraie, il est nécessaire de calibrer le capteur en utilisant des masses connues.

Pour réaliser la calibration d'une mangeoire, il vous faudra un ordinateur, connecté au même réseau que celui de la mangeoire, une balance précise (à 0.1g c'est idéal)

il est nécessaire d'abord d'obtenir une invite de commande en s'y connectant en ssh (voir étape technique ci-dessus). Une fois ceci-fait, il vous fait passer en mode 'administrateur' sur la mangeoire, en tapant la commande:

sudo -s 

Vous devriez alors avoir une invite de commande qui commence par le symbole dièse (#). Un petit utilitaire est alors présent sur toutes les mangeoires, qui permet leur calibration. Le but de la manip est de donner à ce petit utilitaire le poids réel sur le perchoir - celui-ci va calibrer la relation pour obtenir le poids réel à partir des données brutes issues du capteur. Tapez la commande suivante:

feederctl weight_calib

L'utilitaire s'ouvre, et vous demande une masse. Le mieux est de commencer par le zéro. Indiquez-donc '0', puis appuyez sur la touche Entrée. Quelques valeurs brutes de masse apparaissent alors à l'écran. A l'aide de la balance de cuisine, pesez un petit objet dont de masse est inférieur à 100/200g, puis posez-le sur le perchoir. Donnez la masse mesurée à l'utilitaire sur la console, puis appuyez sur la touche Entrée. De nouvelles valeurs de masse brutes apparaissent alors sur la console. Faites ce cycle trois/quatre fois à l'aide de petits objets de masses différentes (par ex. 2g, 10g, 20g, 50g).

Une fois toutes les masses pesées, appuyez sur Ctrl+C pour interrompre le programme. La mangeoire va alors prendre quelques secondes pour calculer les paramètres de calibration, puis vous afficher les résultats. Si ceux-ci sont corrects, alors vous pouvez valider leur enregistrement. Sinon, n'hésitez-pas à refaire la manip précédente. S'il apparaît impossible de calibrer le capteur de masse, peut être parce que les valeurs qui en sortent sont aberrantes, contactez le bureau (bureau@poids-plume.fr). Dans ce cas, n'hésitez pas à prendre des captures d'écrans ou sauvegarder la sortie de vos manips et l'envoyer au bureau pour mieux cerner le problème.

Suite à la calibration, il est parfois pertinent de redémarrer la lecture des capteurs et l'enregistrement des données:

feederctl restart 

On peut ensuite s'assurer que la lecture de la masse est correcte en utilisant la commande suivante:

feederctl monitor

Le poids réél lu par la mangeoire est à la ligne 'weight', on peut s'assurer que la lecture est bonne en réutilisant un petit objet de masse connue.

Mettre à jour le logiciel de la mangeoire

Il vous est fortement recommandé de ne mettre à jour le logiciel que lorsque cela vous a été indiqué. Si vous avez le moindre doute sur la procédure à suivre, n'hésitez-pas à vous mettre en contact avec quelqu'un du bureau. *Les mises à jour sont des opérations délicates, qui peuvent rendre votre mangeoire inutilisable et nécessiter une intervention manuelle ou un renvoi de la mangeoire.*

Le logiciel de la mangeoire est un ensemble de scripts assez divers qui permet l'acquisition, l'enregistrement et la transmission des données. Sur la plupart des mangeoires, un petit utilitaire en ligne de commande, 'feederctl' permet de contrôler le fonctionnement de la mangeoire. Vous pouvez appeler la commande feederctl simplement en ligne de commande en tapant dans un terminal (une fois connecté en ssh sur la mangeoire, voir ci-dessus):

feederctl 

Il vous est retourné alors une liste des sous-commandes disponibles, de la forme "feederctl <sous-commande>". Parmis elle, la commande "feederctl upgrade" permet de mettre à jour le logiciel de la mangeoire. Il est nécessaire de la lancer en tant qu'administrateur, donc avec le préfixe "sudo":

sudo feederctl upgrade 

Le logiciel de la mangeoire est alors téléchargé depuis le dépot gitlab, puis installé.

NOTE IMPORTANTE 1

Pour la plupart des mangeoires (au 01/01/2022), il est nécessaire de réaliser cette opération deux fois, car le système de mise à jour à changé. Normalement, une mangeoire complètement mise à jour est à la version 0.3 (la commande "feederctl version" ne doit pas vous renvoyer d'erreur et doit vous donner la version sur laquelle vous êtes).

NOTE IMPORTANTE 2

Pour certaines mangeoires (les plus anciennes), l'option "feederctl upgrade" n'est pas disponible. Il faut alors réaliser une mise à jour manuelle. Si c'est votre cas, prenez RDV avec le bureau pour réaliser la manip.

NOTE IMPORTANTE 3

Il peut parfois arriver que vous ayez l'erreur suivante qui apparaisse sur votre écran en fin d'installation:

line 4: WEIGHTCOEF1: unbound variable

Utilisez alors les commandes suivante pour définir la variable WEIGHTCOEF1 dans le bon fichier, puis redémarrer l'enregistrement des données

echo "WEIGHTCOEF1=0" >> /etc/feeder/local.conf 
sudo feederctl restart