FAQ - Questions fréquentes

Pour activer votre balise OTRAC :

1. Chargez la batterie : Connectez le câble magnétique noir fourni et attendez que la LED passe au vert fixe
2. Allumez la balise : Maintenez le bouton ON/OFF enfoncé jusqu'à ce que toutes les LED s'allument en bleu, puis passent au vert
3. Vérifiez la connexion : Une LED verte clignotante indique que la balise recherche le réseau cellulaire
4. Envoyez un premier message : Appuyez sur le bouton carré pendant 3 secondes

Pour plus de détails, consultez le guide Première activation.

Vérifications à effectuer :

• La batterie est-elle chargée ? Branchez le câble magnétique et vérifiez qu'une LED s'allume
• Maintenez-vous le bouton ON/OFF suffisamment longtemps ? (environ 3-5 secondes)
• Le câble de recharge est-il bien orienté ? Le logo Neyos doit être face à vous
• La balise est-elle neuve et jamais activée ? Elle peut nécessiter une charge initiale de 30 minutes

Si le problème persiste après une charge complète, contactez le support technique.

La durée de charge dépend de l'état initial de la batterie :

• Première charge : Environ 2-3 heures
• Charge standard : 1,5 à 2 heures
• Charge rapide partielle : 30 minutes suffisent pour environ 40% de capacité

La LED d'état indique la progression : 🔴 rouge (< 20%), 🟠 orange (20-60%), 🟢 vert clignotant (> 60%), 🟢 vert fixe (100%).

Diagnostics possibles :

1. Vérifiez la couverture réseau : Consultez la carte de couverture pour vérifier la disponibilité cellulaire ou satellite dans votre zone
2. LED de connexion :
   • 🟢 Clignotement rapide = Recherche réseau cellulaire en cours
   • 🔵 Clignotement rapide = Recherche réseau satellite en cours
   • Pas de LED = Balise éteinte ou batterie déchargée
3. Position GNSS : La balise doit avoir un fix GPS pour envoyer sa première position. Placez-la en extérieur avec une vue dégagée du ciel
4. Délai de connexion : La première connexion satellite peut prendre 5 à 15 minutes en zone isolée

Par défaut, la balise privilégie le réseau cellulaire pour optimiser la consommation et les coûts. Pour forcer le mode satellite :

1. Accédez au Mode Développeur
2. Utilisez la commande : network_force satellite
3. Redémarrez la balise

Causes fréquentes de surconsommation :

• Fréquence d'envoi trop élevée : Vérifiez le paramètre CATM_SEND_INTERVAL (valeur recommandée : 30s minimum)
• Logs de debug activés : Les logs système augmentent la taille des messages
• Trop d'événements : Chaque appui bouton, alerte batterie ou mouvement génère un message
• Heartbeat trop fréquent : Réglez HEARTBEAT_INTERVAL selon vos besoins réels

Consultez la page Consommation réseau pour optimiser votre usage.

La méthode de configuration dépend de votre version firmware :

Firmware OTRAC V4.8 :

• Configuration disponible directement depuis la plateforme Neyos

NEXUS OS Développeur (early birds) :

• Configuration disponible via le Mode Développeur :
  1. Connectez le câble de programmation blanc (USB)
  2. Accédez au terminal série (115200 bauds)
  3. Activez le mode développeur avec la commande dev_mode enable
  4. Modifiez les paramètres souhaités (ex: set ACQUISITION_INTERVAL 60)

Pour plus de détails, consultez la documentation Paramètres.

Les paramètres d'usine sont optimisés pour un usage standard :

Consultez la liste complète dans Paramètres.

Oui, via le Mode Développeur avec la commande :

factory_reset

Checklist de dépannage webhook :

1. URL configurée ? Vérifiez que votre endpoint webhook est bien enregistré sur la plateforme Neyos
2. Serveur accessible ? Votre endpoint doit être accessible depuis Internet (pas de localhost, pas de VPN privé)
3. HTTPS obligatoire : Neyos n'envoie des webhooks que vers des URLs sécurisées (https://)
4. Code de réponse HTTP : Votre serveur doit répondre 200 OK dans les 10 secondes
5. Pare-feu : Autorisez les IP de Neyos dans votre firewall
6. Format JSON : Vérifiez que vous parsez correctement le payload JSON

Test rapide : Utilisez un service comme webhook.site pour vérifier que Neyos envoie bien les données.

Pour plus de détails, consultez Configurer un webhook.

Les webhooks Neyos envoient un payload JSON structuré :

{
  "header": {
    "serial_number": "SN12345",
    "imei": "123456789012345",
    "timestamp": "2025-01-15T14:30:00Z",
    "message_id": "msg_abc123"
  },
  "elements": [
    {
      "type": "point",
      "latitude": 48.8566,
      "longitude": 2.3522,
      "altitude": 35,
      "accuracy": 5,
      "timestamp": "2025-01-15T14:29:58Z"
    },
    {
      "type": "event",
      "event_name": "button_press",
      "button_id": "square",
      "timestamp": "2025-01-15T14:29:58Z"
    }
  ]
}

Consultez la documentation complète sur Configurer un webhook.

Actuellement, la plateforme Neyos permet de configurer un seul endpoint webhook par compte.

Solutions de contournement :

• Créez un serveur relais qui reçoit les données et les redistribue
• Utilisez un service comme Zapier ou n8n pour dupliquer les webhooks
• Contactez le support pour discuter de vos besoins multi-destinations

La précision dépend de plusieurs facteurs :

La balise indique le type de fix obtenu : 2D (latitude/longitude) ou 3D (latitude/longitude/altitude).

Causes possibles de décharge rapide :

1. Fréquence d'envoi élevée : Chaque transmission consomme de l'énergie
2. Utilisation satellite : Le mode NTN consomme 3 à 5 fois plus que le cellulaire
3. GPS toujours actif : Vérifiez que GNSS_CONTINUOUS_MODE est désactivé
4. Températures extrêmes : Le froid (< 0°C) réduit les performances de la batterie
5. Batterie vieillissante : Après 2-3 ans, la capacité diminue naturellement

Optimisations recommandées :

• Augmentez ACQUISITION_INTERVAL et CATM_SEND_INTERVAL
• Activez POWER_SAVING_MODE
• Désactivez les événements non essentiels

Depuis la balise :

• LED lors de la recharge : 🔴 rouge (< 20%), 🟠 orange (20-60%), 🟢 vert (> 60%)

Depuis la plateforme :

• Chaque message webhook contient le champ battery_percentage

Via le Mode Développeur :

• Commande : battery_status

Méthode 1 : Via le Mode Développeur

version

Affiche : Hardware: OTRAC-v3.2, Firmware: NEXUS OS V0.1 (2025-11-12)

Méthode 2 : Via la plateforme Neyos

• Accédez à la fiche de votre balise
• La version firmware est affichée dans les informations système

Recommandations :

• Les mises à jour corrigent des bugs et ajoutent des fonctionnalités
• Neyos ne force jamais une mise à jour automatique
• Consultez les notes de version avant de mettre à jour
• Effectuez les mises à jour lors de périodes de maintenance pour éviter toute interruption

Mises à jour critiques (sécurité, bugs majeurs) sont notifiées par email.

Si une mise à jour échoue :

1. Vérifiez la batterie : Elle doit être chargée à plus de 50%
2. Vérifiez la connexion : Le câble de programmation USB doit être bien connecté
3. Redémarrez la balise : Éteignez/rallumez et réessayez
4. Mode recovery : En cas de blocage, le bootloader permet une réinitialisation

Si le problème persiste, contactez le support avec le numéro de série (S/N) de votre balise.

Causes possibles de perte de messages :

1. Pas de couverture réseau : Ni cellulaire ni satellite disponible
2. Balise en mouvement rapide : Difficile d'acquérir un fix GPS stable
3. Webhook défaillant : Votre serveur ne répond pas (timeout, erreur 5xx)
4. Limite de débit atteinte : Rate limiting activé pour protéger le réseau
5. Batterie critique : La balise peut se mettre en veille profonde

Solutions :

• Vérifiez les logs sur la plateforme Neyos
• Testez votre webhook avec un outil comme Postman
• Vérifiez que votre serveur répond dans les 10 secondes

Cause : Votre serveur met plus de 10 secondes à répondre.

Solutions :

• Optimisez le temps de traitement de votre endpoint
• Retournez immédiatement 200 OK puis traitez les données en asynchrone (queue, background job)
• Vérifiez que votre serveur n'est pas surchargé

Cause : La balise n'a pas réussi à obtenir une position valide.

Solutions :

• Placez la balise en extérieur avec une vue dégagée du ciel
• Attendez quelques minutes pour permettre un "cold start" GPS
• Vérifiez que l'antenne GPS n'est pas endommagée

Cause : La carte SIM ne parvient pas à s'enregistrer sur un réseau.

Solutions :

• Vérifiez que votre balise est activée sur la plateforme Neyos
• Vérifiez la couverture réseau dans votre zone
• Redémarrez la balise
• Contactez le support si le problème persiste au-delà de 24h