archives:netmf43:8_netmfclassbrainpad

Sommaire .NETMF v4.3

[Mise à jour le 18/1/2019]

La carte BrainPad v1

Sources : documentation sur le site de GHI Electronics [lien]


Classes

Nom Description
Accelerometer Accès à l'accéléromètre MMA8453Q de la carte. Lecture de l'accélération sur les axes X, Y et Z.
Button Accès aux 4 touches de la carte par scrutation ou par événements.
Buzzer Accès au buzzer (déclenchement, arrêt, génération d'une notes ou d'une fréquences, réglage du volume)
Color Représente une couleur en rouge, vert et bleu.
DcMotor Accès à la sortie dédiée à la commande d'un moteur à courant continu 5V 200mA.
Display Contrôle de l'afficheur couleur 1.8“ (128 px par 160 px) à ST7735R (Bus SPI) Adafruit. Texte, tracé de forme géométrique etc. Ressource documentaire : Les afficheurs graphiques
Expansion Définition des entrées / sorties du connecteur d'extension.
Image Représente une image.
Legacy Permet d'accèder aux anciennes version de la carte.
LightBulb Accès à la Led RVB haute luminosité.
LightSensor Accès au capteur de luminosité (LDR).
Peripherals Définitions des périphériques de la carte BrainPad.
ServoMotor Accès à la sortie dédiée à la commande d'un servomoteur.
TemperatureSensor Accès au capteur analogique de température MCP9701.
TrafficLight Accès aux 3 Leds de la carte BrainPad.
Wait Offre des méthodes de temporisation (en secondes ou millisecondes).

Champs

Syntaxe Description
Loopingbooléen toujours vrai

Exemple

exemple.cs
while(BrainPad.Looping){
 // Code
}

Méthodes

Syntaxe Description
void WriteDebugMessage(string message) Affiche un message dans la fenêtre de sortie de l'éditeur Visual Studio (Community).
void WriteDebugMessage(int message)
void WriteDebugMessage(double message)

Exemple

exemple.cs
WriteDebugMessage("Température=" + temp.ToString());

Méthodes

Syntaxe Description
double ReadX() Lit l'accélération sur l'axe X. (-1 à 1)
double ReadY() Lit l'accélération sur l'axe y. (-1 à 1)
double ReadZ() Lit l'accélération sur l'axe z. (-1 à 1)

Exemple

exemple.cs
using System.Threading;
 
class Program
{
    public void BrainPadSetup()
    {
    }
 
    public void BrainPadLoop()
    {
        BrainPad.Display.DrawText(0, 0, "X : " + BrainPad.Accelerometer.ReadX().ToString("F3"), BrainPad.Color.White);
        BrainPad.Display.DrawText(0, 10, "Y : " + BrainPad.Accelerometer.ReadY().ToString("F3"), BrainPad.Color.White);
        BrainPad.Display.DrawText(0, 20, "Z : " + BrainPad.Accelerometer.ReadZ().ToString("F3"), BrainPad.Color.White);
        Thread.Sleep(100);
    }
}
}

Méthodes

Syntaxe Description
bool IsDownPressed() Renvoie la valeur vrai si le bouton Down a été pressé.
bool IsLeftPressed() Renvoie la valeur vrai si le bouton Left a été pressé.
bool IsPressed() Renvoie la valeur vrai si un des quatre boutons a été pressé.
bool IsRightPressed() Renvoie la valeur vrai si le bouton Right a été pressé.
bool IsUpPressed() Renvoie la valeur vrai si le bouton Up a été pressé.

Exemple 1 : scrutation du clavier

clavier.cs
class Program
{
    int increment;
 
    public void BrainPadSetup()
    {
        increment = 0;
    }
 
    public void BrainPadLoop()
    {
        if (BrainPad.Button.IsUpPressed())
        {
            increment = 100;
        }
        if (BrainPad.Button.IsDownPressed())
        {
            increment = -100;
        }
       ....
    }
}

Evènements

Syntaxe Description
ButtonChanged Un événement est déclenché quand l'état d'un bouton change.
ButtonPressed Un événement est déclenché quand l'état d'un bouton est appuyé.
ButtonReleased Un événement est déclenché quand l'état d'un bouton est relâché.

Enumérations

Syntaxe Description
DPad Prend les valeurs : Up, Down, Left, Right
State Prend les valeurs : Pressed, NotPressed

Exemple 2 : les boutons génèrent des interruptions

BPINT.cs
class Program
{
    public void BrainPadSetup()
    {
        BrainPad.Button.ButtonChanged += Button_ButtonChanged;
    }
 
    void Button_ButtonChanged(BrainPad.Button.DPad button, BrainPad.Button.State state)
    {
        if (button == BrainPad.Button.DPad.Down)
        {
            if (state == BrainPad.Button.State.Pressed)
            {
                BrainPad.TrafficLight.TurnGreenLightOn();
            }
            else
            {
                BrainPad.TrafficLight.TurnGreenLightOff();
            }
        }
    }
 
    public void BrainPadLoop()
    {
        // Declared but not used
    }
 
}

Délégué

Syntaxe Description
void ButtonEventHandler(DPad button, State state)

Méthodes

Syntaxe Description
void PlayFrequency(int Frequency) Joue une fréquence.
void PlayNote(Note note) Joue une note.
void SetVolume(Volume volume) Règle le volume.
void Stop() Coupe le son.

Enumérations

Syntaxe Description
Note A = 880 Hz, ASharp = 932 Hz, B = 988 Hz, C = 1047 Hz, CSharp = 1109 Hz, D = 1175 Hz, DSharp = 1244 Hz, E = 1319 Hz, F = 1397 Hz, FSharp = 1480 Hz, G = 1568 Hz, GSharp = 1661 Hz
Volume Loud : volume par défaut, Quiet : plus faible

Exemple 1

frequence1.cs
class Program
{
    int frequency, increment;
 
    public void BrainPadSetup()
    {
        frequency = 0; increment = 0;
    }
 
    public void BrainPadLoop()
    {
        if (BrainPad.Button.IsUpPressed())
        {
            increment = 100;
        }
        if (BrainPad.Button.IsDownPressed())
        {
            increment = -100;
        }
        if (increment != 0)
        {
            frequency = frequency + increment;
            increment = 0;
            BrainPad.Buzzer.PlayFrequency(frequency);
            BrainPad.WriteDebugMessage(frequency);
            BrainPad.Wait.Seconds(0.2);
            BrainPad.Buzzer.Stop();
        }
    }
}

Exemple 2

frequence2.cs
using System.Threading;
 
class Program
{
    const int NoteC = 261;
    const int NoteD = 294;
    const int NoteE = 330;
    const int NoteF = 349;
    const int NoteG = 391;
 
    const int Whole = 1000;
    const int Half = Whole / 2;
    const int QuarterDot = Whole / 3;
    const int Quarter = Whole / 4;
    const int Eighth = Whole / 8;
 
    int[] note = {
                    NoteE, NoteE, NoteF, NoteG, NoteG, NoteF, NoteE,
                    NoteD, NoteC, NoteC, NoteD, NoteE, NoteE, NoteD,
                    NoteE, NoteD, NoteC, NoteC, NoteD, NoteE, NoteD,
                    NoteC, NoteC
                  };
 
    int[] duration = {
                    Quarter,  Quarter,  Quarter, Quarter, Quarter, Quarter,
                    Quarter,  Quarter,  Quarter, Quarter, Quarter, Quarter, QuarterDot,
                    Eighth, Half, Quarter,  Quarter,  Quarter, Quarter, Quarter, Quarter,
                    Quarter,  Quarter,  Quarter, Quarter, Quarter, Quarter, QuarterDot,
                    Eighth,Whole
                  };
 
 
    public void BrainPadSetup()
    {
    }
 
    public void BrainPadLoop()
    {
        for (int i = 0; i < note.Length; i++)
        {
            BrainPad.Buzzer.Stop();
            BrainPad.Buzzer.PlayFrequency(note[i]);
            Thread.Sleep(duration[i]);
        }
 
        Thread.Sleep(100);
    }
}

Constructeur

Syntaxe Description
Color() Construit une nouvelle instance de la classe couleur.
Color(byte red, byte green, byte blue) Construit une nouvelle instance de la classe couleur en précisant le niveau de rouge, de vert et de bleu.

Propriétés

Syntaxe Description
As565 Précise la couleur au format 565.
BNiveau de bleu sur un octet.
GNiveau de vert sur un octet.
RNiveau de rouge sur un octet.

Champs

Syntaxe Description
BlackCouleur prédéfinie. (Color)
BlueCouleur prédéfinie. (Color)
CyanCouleur prédéfinie. (Color)
GreenCouleur prédéfinie. (Color)
MagentaCouleur prédéfinie. (Color)
RedCouleur prédéfinie. (Color)
White Couleur prédéfinie. (Color)
YellowCouleur prédéfinie. (Color)

Méthodes

Syntaxe Description
void SetSpeed(double speed) Règle la fréquence de rotation du moteur (0 à 1)
void Stop() Arrête le moteur.

Ressource documentaire : Les afficheurs graphiques

Méthodes

Syntaxe Description
void Clear() Efface l'écran.
void DrawCircle(int x, int y, int r, Color color) Dessine un cercle de rayon r à la position (x,y) dans la couleur color.
void DrawExtraLargeLetter(int x, int y, char letter, Color color) Ecrit une lettre letter de très grande taille à la position (x,y) dans la couleur color.
void DrawExtraLargeNumber(int x, int y, double nb, Color color) Ecrit un nombre nb de très grande taille à la position (x,y) dans la couleur color. Surchargée : long nb
void DrawExtraLargeText(int x, int y, string text, Color color) Ecrit un texte text de très grande taille à la position (x,y) dans la couleur color.
void DrawFilledRectangle(int x, int y, int width, int height, Color color) Dessine un rectangle plein (width par height) à la position (x,y) dans la couleur color.
void DrawImage(byte[] data) Dessine une image décrite par un tableau d'octets data. Surchargée : int x, int y, Image image
void DrawLargeLetter(int x, int y, char letter, Color color) Ecrit une lettre de grande taille à la position (x,y) dans la couleur color.
void DrawLargeNumber(int x, int y, double nb, Color color) Ecrit un nombre de grande taille à la position (x,y) dans la couleur color. Surchargée : long nb
void DrawLargeText(int x, int y, string text, Color color) Ecrit un texte de grande taille à la position (x,y) dans la couleur color.
void DrawLetter(int x, int y, char letter, Color color) Ecrit une lettre à la position (x,y) dans la couleur color.
void DrawLine(int x0, int y0, int x1, int y1, Color color) Dessine une ligne entre les points de coordonnées (x0,y0) et (x1,y1) dans la couleur color.
void DrawNumber(int x, int y, double nb, Color color) Ecrit un nombre à la position (x,y) dans la couleur color. Surchargée : long nb
void DrawRectangle(int x, int y, int width, int height, Color color) Dessine un rectangle (width par height) à la position (x,y) dans la couleur color.
void DrawText(int x, int y, string text, Color color) Ecrit un texte à la position (x,y) dans la couleur color.
void SetPixel(int x, int y, Color color) Dessine un point à la position (x,y) dans la couleur color.
void TurnOff() Eteint le rétroéclairage.
void TurnOn() Active le rétroéclairage.

Classes imbriquées

Nom Champs
AnalogInput PA2, PA3, PA6, PA7, PC3
Gpio PA10,PA2, PA3, PA6, PA7, PA9, PB3, PB4, PB5, PC3
PwmOutput PA10,PA2, PA3, PA9

Propriétés

Syntaxe Description
Height Hauteur de l'image (int)
Pixels Tableau de pixels (byte[])
Width argeur de l'image (int)

Constructeur

Syntaxe Description
Image(int width, int height) Construit une image width par height.

Méthodes

Syntaxe Description
void SetPixel(int x, int y, Color color) Fixe le pixel en (x,y) à la couleur color.

Classes imbriquées

Nom Champs
AnalogInput E1, E10, E, E2, E3, E9
Gpio E1, E10, E11, E12, E2, E3, E4, E5, E6, E9
PwmOutput E10, E11, E12, E9

Méthodes

Syntaxe Description
void SetColor(Color color) Fixe la couleur color de la led haute luminosité. Surchargée : double R, double G, double B
void TurnOff() Désactive la Led.
void TurnOn() Active la Led.

Méthodes

Syntaxe Description
double ReadLightLevel() Lit la luminosité ambiante (0 à 1).

Exemple

LightSensor.cs
class Program
{
    double level;
 
    public void BrainPadSetup()
    {
      level = 0;
    }
 
    public void BrainPadLoop()
    {
        level = BrainPad.LightSensor.ReadLightLevel();
        BrainPad.WriteDebugMessage(level);
        if (level<0.5)
        {
            BrainPad.LightBulb.TurnOn();
        }
        else
        {
           BrainPad.LightBulb.TurnOff();
        }
    }
}

Champs

Syntaxe Description
BuzzerSortie PWM pour la commande du buzzer.
BuzzerVolumeControllerSortie PWM pour la commande du volume du buzzer.
DcMotorSortie PWM pour la commande d'un moteur à CC (5V - 200mA max).
LightSensorLecture du capteur de luminosité (Entrée analogique).
ServoMotorGrasSortie PWM pour la commande d'un servomoteur.
TemperatureSensorLecture du capteur de température (entrée analogique).

Classes imbriquées

Nom Champs
Button Down, Left, Right, Up
DisplayGras BackLight, ChipSelect, Control, Reset, SpiModule
LightBulb Blue, Red
TouchPad Left, Middle, Right
TrafficLight Green, Red, Yellow

Méthodes

Syntaxe Description
void SetPosition(int position) Règle la position angulaire d'un servomoteur.
void Start() Active le signal de commande du servomoteur.
void Stop() Désactive le signal de commande du servomoteur.

Méthodes

Syntaxe Description
double ReadTemperature() Lit la valeur de température.

Exemple

TemperatureSensor.cs
using System.Threading;
 
class Program
{
    public void BrainPadSetup()
    {
    }
 
    public void BrainPadLoop()
    {
        double tempC = BrainPad.TemperatureSensor.ReadTemperature();
        BrainPad.Display.DrawText(0, 10, "Temperature : " + tempC.ToString("F2"), BrainPad.Color.White);
        Thread.Sleep(200);
    }
}

Méthodes

Syntaxe Description
void TurnColorOff(Color color) Désactive la led color.
void TurnColorOn(Color color) Active la led color.
void TurnGreenLightOff() Désactive la led verte.
void TurnGreenLightOn() Active la led verte.
void TurnOffAllLight() Désactive toutes les leds.
void TurnRedLightOff() Désactive la led rouge.
void TurnRedLightOn() Active la led rouge.
void TurnYellowLightOff() Désactive la led jaune.
void TurnYellowLightOn() Active la led jaune.

Exemple

TrafficLight.cs
while (true)
        {
            BrainPad.TrafficLight.TurnGreenLightOn();
            BrainPad.Wait.Seconds(0.4);
            BrainPad.TrafficLight.TurnGreenLightOff();
            BrainPad.Wait.Seconds(0.4);
        }

Méthodes

Syntaxe Description
void Milliseconds(double milliseconds) Déclenche une temporisation exprimée en millisecondes.
void Seconds(double seconds) Déclenche une temporisation exprimée en secondes.

Exemple

TrafficLight.cs
while (true)
        {
            BrainPad.TrafficLight.TurnGreenLightOn();
            BrainPad.Wait.Seconds(0.4);
            BrainPad.TrafficLight.TurnGreenLightOff();
            BrainPad.Wait.Seconds(0.4);
        }

Le connecteur mikroBUS permet d'étendre les fonctionnalités de la carte BrainPad (GPIO, I2C, SPI, UART).
Voir la page CH5c. Exemples codés en C# pour la carte BrainPad v1.

  • archives/netmf43/8_netmfclassbrainpad.txt
  • Dernière modification: 2021/08/11 09:19
  • (modification externe)