format_list_bulleted

Autres fonctions

Accéder à toutes les fonctionnalités de votre robot

voltageBattRead()

Syntaxe

Robby.voltageBattRead();

Description

voltageBattRead() permet de récupérer la tension de la batterie (en V). La fonction renvoie un float et ne prend aucun argument .

warningPour utiliser cette fonction, checkBattProcess() doit être présente dans la loop(). Il est recommandé de ne pas utiliser de fonctions bloquantes.

Exemple

#include <BRAINZY.h>

float voltage = 0;

void setup(){
  //votre code...
}

void loop(){
  Robby.checkBattProcess();
  voltage = Robby.voltageBattRead();
  //votre code...
}

voltageCell1Read()

Syntaxe

Robby.voltageCell1Read();

Description

voltageCell1Read() permet de récupérer la tension de la cellule 1 de la batterie (en V). La fonction renvoie un float et ne prend aucun argument .

warningPour utiliser cette fonction, checkBattProcess() doit être présente dans la loop(). Il est recommandé de ne pas utiliser de fonctions bloquantes.

Exemple

#include <BRAINZY.h>

float voltage = 0;

void setup(){
  //votre code...
}

void loop(){
  Robby.checkBattProcess();
  voltage = Robby.voltageCell1Read();
  //votre code...
}

voltageCell2Read()

Syntaxe

Robby.voltageCell2Read();

Description

voltageCell2Read() permet de récupérer la tension de la cellule 2 de la batterie (en V). La fonction renvoie un float et ne prend aucun argument .

warningPour utiliser cette fonction, checkBattProcess() doit être présente dans la loop(). Il est recommandé de ne pas utiliser de fonctions bloquantes.

Exemple

#include <BRAINZY.h>

float voltage = 0;

void setup(){
  //votre code...
}

void loop(){
  Robby.checkBattProcess();
  voltage = Robby.voltageCell2Read();
  //votre code...
}

voltageCell3Read()

Syntaxe

Robby.voltageCell3Read();

Description

voltageCell3Read() permet de récupérer la tension de la cellule 3 de la batterie (en V). La fonction renvoie un float et ne prend aucun argument .

warningPour utiliser cette fonction, checkBattProcess() doit être présente dans la loop(). Il est recommandé de ne pas utiliser de fonctions bloquantes.

Exemple

#include <BRAINZY.h>

float voltage = 0;

void setup(){
  //votre code...
}

void loop(){
  Robby.checkBattProcess();
  voltage = Robby.voltageCell3Read();
  //votre code...
}

checkBattProcess()

TODO

alarmBattOn()

TODO

alarmBattOff()

TODO

isButtonPressed()

Syntaxe

Robby.isButtonPressed();

Description

isButtonPressed() permet de savoir lorsque le bouton central de la BRAINZY Board est pressé. La fonction renvoie true si le bouton est passé de l'état de repos à l'état actif, false sinon et ne prend aucun argument.

infoÀ chaque fois que le bouton est pressé, une interruption est appelée pour mémoriser le changement d'état.

Exemple

#include <BRAINZY.h>

void setup(){
  //votre code...
}

void loop(){
  if (Robby.isButtonPressed()==true) {
    //placer ici les actions à réaliser lorsque le bouton est pressé
  }
  //votre code...
}

isButtonReleased()

Syntaxe

Robby.isButtonReleased();

Description

isButtonReleased() permet de savoir lorsque le bouton central de la BRAINZY Board est relâché. La fonction renvoie true si le bouton est passé de l'état actif à l'état de repos, false sinon et ne prend aucun argument.

infoÀ chaque fois que le bouton est relâché, une interruption est appelée pour mémoriser le changement d'état.

Exemple

#include <BRAINZY.h>

void setup(){
  //votre code...
}

void loop(){
  if (Robby.isButtonReleased()==true) {
    //placer ici les actions à réaliser lorsque le bouton est relâché
  }
  //votre code...
}

ledButtonOn()

Syntaxe

Robby.ledButtonOn();

Description

ledButtonOn() permet d'allumer la led présente sur le bouton central de la BRAINZY Board. La fonction ne renvoie aucune variable et ne prend aucun argument.

Exemple

#include <BRAINZY.h>

void setup(){
  Robby.ledButtonOn();
  //votre code...
}

void loop(){
  //votre code...
}

ledButtonOff()

Syntaxe

Robby.ledButtonOff();

Description

ledButtonOff() permet d'éteindre la led présente sur le bouton central de la BRAINZY Board. La fonction ne renvoie aucune variable et ne prend aucun argument.

Exemple

#include <BRAINZY.h>

void setup(){
  Robby.ledButtonOff();
  //votre code...
}

void loop(){
  //votre code...
}

isLedButtonOn()

Syntaxe

Robby.isLedButtonOn();

Description

isLedButtonOn() permet de connaître l'état de la led présente sur le bouton central de la BRAINZY Board. La fonction renvoie un bool (true si la led est allumée, false sinon) et ne prend aucun argument.

Exemple

#include <BRAINZY.h>

bool state = false;

void setup(){
  //votre code...
}

void loop(){
  state = Robby.isLedButtonOn();
  //votre code...
}

ledOn()

Syntaxe

Robby.ledOn();

Description

ledOn() permet d'allumer la led bleue présente sur la BRAINZY Board. La fonction ne renvoie aucune variable et ne prend aucun argument.

Exemple

#include <BRAINZY.h>

void setup(){
  Robby.ledOn();
  //votre code...
}

void loop(){
  //votre code...
}

ledOff()

Syntaxe

Robby.ledOff();

Description

ledOff() permet d'éteindre la led bleue présente sur la BRAINZY Board. La fonction ne renvoie aucune variable et ne prend aucun argument.

Exemple

#include <BRAINZY.h>

void setup(){
  Robby.ledOff();
  //votre code...
}

void loop(){
  //votre code...
}

isLedOn()

Syntaxe

Robby.isLedOn();

Description

isLedOn() permet de connaître l'état de la led bleue présente sur la BRAINZY Board. La fonction renvoie un bool (true si la led est allumée, false sinon) et ne prend aucun argument.

Exemple

#include <BRAINZY.h>

bool state false;

void setup(){
  //votre code...
}

void loop(){
  state = Robby.isLedOn();
  //votre code...
}

playNote()

Syntaxe

Robby.playNote(noteid);
Robby.playNote(noteid, octaveid, duration);

Description

playNote() permet de jouer une note de musique. La fonction ne renvoit aucune variable et prend comme argument l'ID de la note à jouer (cf. table ci-dessous). L'octave (int - par défault 4) et la durée de la note (unsigned long en ms - par défault 500ms) sont deux autres arguments facultatifs.

ID Octave 4 Octave 5 Octave 6 Octave 7
Do NOTE_c 262 Hz 523 Hz 1046 Hz 2093 Hz
Do-# / Ré-b NOTE_cS 277 Hz 554 Hz 1109 Hz 2217 Hz
NOTE_d 294 Hz 587 Hz 1175 Hz 2349 Hz
Ré-# / Mi-b NOTE_dS 311 Hz 622 Hz 1245 Hz 2489 Hz
Mi NOTE_e 330 Hz 659 Hz 1319 Hz 2637 Hz
Fa NOTE_f 349 Hz 698 Hz 1397 Hz 2794 Hz
Fa-# / Sol-b NOTE_fS 370 Hz 740 Hz 1480 Hz 2960 Hz
Sol NOTE_g 392 Hz 784 Hz 1568 Hz 3136 Hz
Sol-# / La-b NOTE_gS 415 Hz 831 Hz 1661 Hz 3322 Hz
La NOTE_a 440 Hz 880 Hz 1760 Hz 3520 Hz
La-# / Si-b NOTE_aS 466 Hz 932 Hz 1865 Hz 3729 Hz
Si NOTE_b 494 Hz 988 Hz 1976 Hz 3951 Hz

infoCette fonction réutilise la fonction tone() d'Arduino.

Exemple

#include <BRAINZY.h>

void setup(){
  //votre code...
  Robby.playNote(NOTE_a,6,1000);
}

void loop(){
  //votre code...
}

playMelody()

Syntaxe

Robby.playMelody(music);

Description

playMelody() permet de jouer une partition de musique. La fonction ne renvoie aucune variable et prend comme argument une liste de char dont le premier élément est #. Chaque note (séparée par ,) utilise son nom anglais et s'accompagne d'une octave et d'une durée (en ms). Par exemple si nous souhaitons jouer un La 400Hz pendant 500ms suivit d'une pause de 100ms et d'un Do 523Hz pendant 300ms, nous noterons #500a4,100-,300c5.

Nom Français Do Mi Fa Sol La Si
Nom Anglais c d e f g a b

warningPour utiliser cette fonction, playMelodyProcess() doit être présente dans la loop(). Il est recommandé de ne pas utiliser de fonctions bloquantes.

Exemple

#include <BRAINZY.h>

char music[] = "#500a4,500a4,500a4,350f4,150c5,500a4,350f4,150c5,650a4,500-,500e5,500e5,500e5,350f5,150c5,500gS4,350f4,150c5,650a4";

void setup() {
  delay(1000); // petit pause avant de commencer
  Robby.playMelody(music);
  //votre code
}

void loop() {
  Robby.playMelodyProcess();
  //votre code
}

playFile()

TODO

playMelodyProcess()

TODO

beginSD()

Syntaxe

Robby.beginSD();

Description

beginSD() permet d'initialiser la bibliothèque SD d'Arduino et le lecteur microSD de la BRAINZY Board. La fonction renvoie true si l'initialisation est un succés, false sinon et ne prend aucun argument.

infoConsultez le site d'Arduino pour connaître les fonctions de la bibliothèque SD.

Exemple

#include <BRAINZY.h>

void setup(){
  Robby.beginSD();
  //votre code...
}

void loop(){
  //votre code...
}