Mon-Reveil-Hack

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

Introduction

Il est possible de changer le code facilement de manière à optimiser le réveil à vos besoin.

Je vais vous expliquer comment modifier la mélodie et ajouter un autre hack (un GONG).

Mélodies

Changer de mélodie

Il est possible de changer simplement de mélodie en changant le nom de celle-ci dant la variable MELODIE.

L'ensemble des mélodies se trouvent dans le fichier melodie.h.

// --- Exemple ---
// Changer MARIO
const int MELODIE[][ 2 ] = MARIO;
// Par AXEL_F
const int MELODIE[][ 2 ] = AXEL_F;

Créer une mélodie

Il est possible d'ajouter facilement une mélodie à la bibliothèque melodie.h.

Je vous invite à lire la bibliothèque de manière à comprendre son fonctionnement et si vous ne comprenez pas tout, je vous invite à lire le contenu suivant.

A quoi sert l'antislash ?

Comme vous pouvez voir dans la bibliothèque, chacune des mélodies contiennent un antislash à la fin de chaques lignes de code (excepté la dernière) :

#define ALARM1{  \
  {NOTE_A4,  20},\
  {NOTE_C4,  20}}

L'antislash (\) sert de remise à la ligne pour le define et son contenu. Si cet antislash n'est pas mit, il sera impossible de compiler le code.

Si vous ne désirez pas mettre d'antislash, il vous sera obligatoire d'écrire tout le contenu du define en une ligne de code.

Pour des raisons de mise en page, nous avons préféré mettre l'antislash à fin de chaques lignes de façon à rendre le code plus lisible.

Que contiennent les define ?

Le define est un tableau 2 dimensions contenant des nombres entiers (int).

#define ALARM1{  \
  {NOTE_A4,  20},\
  {NOTE_C4,  20}}
  • La première colonne contient les notes a jouer
    • La note (exemple: NOTE_A4) fait référence à un nombre entier se trouvant dans la bibliothèque pitches.h. Cette bibliothèque provient du GitHub de nseidle.
  • La deuxièmre colonne contient la durée de chaques notes en milisecondes

Comment convertir une musique en mélodie ?

Malheureusement, nous avons pas trouvé un outil capable de convertir une musique (en entière) en mélodie polyphonique.


Les 3 phases des alarmes

Premièrement, il est nécessaire de comprendre les 3 fonctions principale. Chacune de ses fonctions sont appelées à chacune des phases des alarmes.

Chaque fois qu'une alarme change de phase, elle envoie comme argument la position de l'alarme (dans notre cas 0 à 3). Il est donc facile de personnaliser chacunes des alarmes.

Voici les 3 fonctions:

/*
 * Alarme qui commence à sonner
 */
void alarmeStart( int alarmePos ){
  activerMelodie();
}

/*
 * Pendant que l'alarme sonne, répéter une étape
 */
void alarmePulse( int alarmePos ){
  jouerMelodie();
}

/*
 * Alarme qui cesse de sonner
 */
void alarmeStop( int alarmePos ){
  arreterMelodie();
}
  • alarmeStart est appelée quand une alarme se met en route.
  • alarmePulse est appelée durant le moment où l'alarme est active.
  • alarmeStop est appelée quand une alarme s'arrête.

Faire sonner un GONG

Je vais vous montrer comment ajouter une fonctionnalité facilement à vos alarmes.

Par exemple, je voudrais faire sonner un gong toutes les 10 secondes sur la première alarme uniquement.

Pour réaliser ce gong, il sera nécessaire d'utiliser un servo moteur.

Premièrement, il sera nécessaire d'ajouter dans l'entête :

... 

// ### HACK ###
// Ajouter vos variables hack
// Exemple : GONG

// Ajouter la bibliothèque
#include <Servo.h>

// Définit la broche du servo moteur du gong
#define SERVO_MOTEUR   6 

// Initialisation du servo
Servo monServo; 
unsigned long moteurTempsAvant = 0 ;

...

Dans la fonction setup :

void setup() {
  ... 

  // Exemple SERVO
  monServo.attach(  SERVO_MOTEUR ); 

  // Le mettre à l'angle zéro
  monServo.write( 0 );

  ...
}

Dans les différentes phases, on va définir que uniquement l'alarme 1 possède un gong et les autres possèdent la mélodie.

/*
 * Alarme qui commence à sonner
 */
void alarmeStart( int alarmePos ){
  // Hack moteur
  if( alarmePos == 0)
    activerMoteur();
  // Sonnerie
  else 
    activerMelodie();
}

/*
 * Pendant que l'alarme sonne, répéter une étape
 */
void alarmePulse( int alarmePos ){
  // Hack moteur
  if( alarmePos == 0)
    jouerMoteur();
  // Sonnerie
  else 
    jouerMelodie();
}

/*
 * Alarme qui cesse de sonner
 */
void alarmeStop( int alarmePos ){
  // Hack moteur
  if( alarmePos == 0)
    stopMoteur();
  // Sonnerie
  else 
    arreterMelodie();
}
  • activerMoteur(); dans cette fonction, il faudrait remettre le servo à l'angle zéro, au cas ou il n'est pas encore définit à cette position.
  • jouerMoteur(); dans cette fonction, il faudrait changer la position du servo moteur de façon à faire sonner le gong.
  • stopMoteur(); dans cette fonction, il faudrait remettre le servo à l'angle zéro.
/*
 * Exemple servo moteur
 */
void activerMoteur(){
    // Remise à zéro du moteur
    moteurTempsAvant = 0;
    monServo.write( 0 );
}
void jouerMoteur(){
  unsigned estIlTemps = effectuerAction( moteurTempsAvant, 10000 );
  
  // Est-il temps de faire sonner le GONG ???
  if( estIlTemps != 0 ){
    moteurTempsAvant = estIlTemps;
    
    // Bouger le servo de 90°
    monServo.write( 90 );
  }
  else
    monServo.write( 0 );
}
void stopMoteur(){
  monServo.write( 0 );
}

La fonction effectuerAction, ci dessous, permet de répèter une tâche tous les x temps.

Cette fonction peut être réutiliser dans d'autres cas.

/*
 * Vérifier si c'est le moment d'effectuer l'action
 * 
 * ARGUMENTS
 * tempsAvant est temps précédent en milisecondes
 * dureeAttente est le temps avant de relancer l'exécution
 * 
 * RETURN
 * 0 Signifie pas maintenant
 * x valeur (unsigned long) : effectuer l'action + changer le tempsAvant (définie dans l'entête du code)
 */
unsigned long effectuerAction( unsigned long tempsAvant, int dureeAttente ){
  unsigned long maintenant = millis();

  if( maintenant - tempsAvant >= dureeAttente )
    return maintenant;
    
  return 0;
}

Idées de hacks possibles

  • Couper l'écran après un certains temps et le rallumer avec le bouton snooze
  • Faire sonner un GONG
  • Faire sonner un audio FX
  • Faire tourner une main en mousse de façon à se giffler

Créé par Stefan pour MCHobby.be

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.