Débogage de CodeCell

CodeCell est conçu pour être facile à configurer et à utiliser, mais comme tout microcontrôleur, des problèmes peuvent survenir. Ce guide vous aidera à dépanner et à déboguer efficacement CodeCell.

Assurez-vous d'avoir les dernières versions de la bibliothèque

Avant de procéder au dépannage, assurez-vous que vous utilisez les dernières versions de :

• Bibliothèque CodeCell → Mettez toujours à jour vers la dernière version pour les corrections de bogues et les améliorations.
• Pack de support de la carte ESP32C3 → Assurez-vous que les dernières définitions de la carte ESP32-C3 sont installées dans l'IDE Arduino.

Pour mettre à jour :

1. Ouvrez l'IDE Arduino et accédez à Sketch > Inclure la bibliothèque > Gérer les bibliothèques .
2. Recherchez CodeCell et installez la dernière version.
3. Accédez à Outils > Carte > Gestionnaire de cartes , recherchez ESP32 et mettez à jour vers la dernière version.

Configuration et utilisation de CodeCell

Pour faciliter la programmation, la bibliothèque CodeCell propose diverses fonctions d'initialisation, de lecture et de gestion des capteurs et de l'alimentation. Voici tout ce que vous devez savoir pour configurer votre appareil et sa bibliothèque.

Déballage de votre CodeCell

À l'intérieur de la boîte, vous trouverez :

• CodeCell : une carte minuscule mais puissante basée sur ESP32-C3 avec des GPIO et des capteurs programmables.
• Vis : Quatre vis M1,2 x 6 mm pour le montage.
• Embases : Trois jeux d'embases femelles (soudées ou non soudées, selon votre sélection).
• Batterie/Câble : Si acheté, une batterie LiPo 170mAh 20C avec un câble pré-soudé ou un câble de connecteur de batterie.

Mise sous tension de CodeCell pour la première fois

Branchez un câble USB-C et CodeCell va :

• Initialisez ses périphériques et capteurs internes. L'état est affiché sur le moniteur série et vous indique tout problème détecté.
• Vérifier l'état de l'alimentation :
  • Si aucune batterie n'est connectée, une animation LED respiratoire se produit.
  • Si alimenté par USB, la LED clignote en bleu .
  • Si l'appareil fonctionne sur batterie, la LED clignote en vert .
  • En cas de charge, la LED reste bleue statique jusqu'à ce que la charge soit complète.

Problèmes d'alimentation courants et solutions :

• Le numéro de série ne fonctionne pas ?
  • Vérifiez si votre câble USB-C prend en charge à la fois l’alimentation et les données .
  • Assurez-vous que Tools/USB_CDC_On_Boot est activé
  • Essayez un autre port USB ou un autre adaptateur secteur.
• Batterie non détectée ?
  • Assurez-vous que la batterie est correctement connectée et chargée.

Connexion de CodeCell à l'IDE Arduino

Étape 1 : installer l'IDE Arduino

Téléchargez la dernière version depuis le site officiel d'Arduino .

Étape 2 : ajouter la prise en charge de la carte ESP32

1. Ouvrez Arduino IDE et allez dans Fichier > Préférences .
2. Dans le champ « URL supplémentaires du gestionnaire de cartes », saisissez :

    https://dl.espressif.com/dl/package_esp32_index.json
   

3. Cliquez sur OK et redémarrez Arduino IDE.

Étape 3 : sélectionnez la carte et le port appropriés

1. Accédez à Outils > Carte > Module de développement ESP32C3 .
2. Sélectionnez le port COM correct sous Outils > Port .
3. Activez USB_CDC_On_Boot dans Outils > USB_CDC_On_Boot .
4. Réglez la vitesse d'horloge du processeur sur 160 MHz .

Étape 4 : Installer la bibliothèque CodeCell

1. Accédez à Sketch > Inclure la bibliothèque > Gérer les bibliothèques .
2. Recherchez CodeCell et installez la dernière version.
3. Ouvrez Fichier > Exemples > CodeCell et essayez l’exemple GettingStarted .

Étape 5 : Téléchargez et exécutez votre premier croquis

1. Cliquez sur le bouton Télécharger .
2. Ouvrez Outils > Moniteur série pour voir la sortie de votre CodeCell.

Bibliothèque et fonctions CodeCell

Initialisation de CodeCell

La première étape consiste à initialiser le CodeCell en utilisant :

 myCodeCell.Init(SENSOR_MACRO);

Macros disponibles :

• LUMIÈRE → Active la détection de lumière.
• MOTION_ACCELEROMETER → Active la détection par accéléromètre.
• MOTION_GYRO → Active la détection du gyroscope.
• MOTION_MAGNETOMETER → Active la détection du magnétomètre.
• MOTION_STEP_COUNTER → Active le comptage des pas.
• MOTION_ACTIVITY → Détecte la marche, la course ou la conduite.

Vous pouvez combiner plusieurs macros à l'aide de l'opérateur + :

 myCodeCell.Init(LIGHT + MOTION_ACCELEROMETER + MOTION_GYRO);

Débogage plus détaillé

• CodeCell non détecté dans l'IDE Arduino
  • Assurez-vous que le câble USB-C prend en charge le transfert de données , pas seulement l'alimentation.
  • Redémarrez l'IDE Arduino et essayez de sélectionner le bon port COM .
  • Vérifiez le Gestionnaire de périphériques (Windows) / Rapport système (Mac) pour vérifier si CodeCell apparaît comme un périphérique USB .
• 
  Le téléchargement du code échoue
  • Assurez-vous que USB_CDC_On_Boot est activé.
  • Si CodeCell est bloqué dans une boucle de réinitialisation :
    • Court-circuiter SCL (GPIO9) vers GND .
    • Débranchez l'USB et éteignez la batterie.
    • Rebranchez la clé USB et téléchargez à nouveau le croquis.
    • Retirez le court-circuit une fois reprogrammé.
• Le moniteur série n'affiche pas les données
  • Assurez-vous que le débit en bauds est défini sur 115 200 .
  • Allez dans Outils > USB_CDC_On_Boot et activez-le.
  • Assurez-vous que le câble USB-C prend en charge le transfert de données , pas seulement l'alimentation.
  • Essayez de redémarrer le moniteur série.
• Comportement inattendu des LED
  • 🔴 Rouge clignotant → Batterie faible (<3,3 V), entrée en mode veille.
  • 🔵 Bleu statique → Chargement de la batterie.
  • 🟢 Respirer vert → Fonctionne sur batterie.
  • 🔵 Respiration bleue → Complètement chargée.
• Les capteurs ne répondent pas
  • Assurez-vous d'avoir initialisé le bon capteur à l'aide de myCodeCell.Init(SENSOR_MACRO);
  • Vérifiez le moniteur série, cela devrait vous aider à identifier pourquoi le capteur ne répond pas
  • Si vous utilisez des capteurs externes, évitez d'utiliser les adresses I2C 0x60 (VCNL4040) et 0x4A (BNO085) car il y aura des conflits

Réflexions finales

Nous espérons que cela vous a aidé à identifier la cause du problème. Si le problème persiste, n'hésitez pas à nous contacter ; nous serons ravis de vous aider !