Adafruit Motor Shield V2-Librairie - Historique des versions

Admin : /* onestep( dir, style) */

2014-01-06T13:56:31Z

onestep( dir, style)

Admin : /* Classe Adafruit_DCMotor */

2014-01-06T13:38:54Z

Classe Adafruit_DCMotor

Admin : /* Classe Adafruit_DCMotor */

2014-01-06T13:08:58Z

Classe Adafruit_DCMotor

Admin : /* Classe Adafruit_MotorShield */

2014-01-06T12:42:54Z

Classe Adafruit_MotorShield

Admin le 6 janvier 2014 à 12:24

2014-01-06T12:24:03Z

Admin : Page créée avec « {{Adafruit Motor Shield V2-NAV}} == Classe Adafruit_MotorShield == {{ADFImage|Adafruit Motor Shield V2-Lib-01.jpg|480px}} The Adafruit_MotorShield class represents a motor... »

2014-01-06T12:22:17Z

Page créée avec « {{Adafruit Motor Shield V2-NAV}} == Classe Adafruit_MotorShield == {{ADFImage|Adafruit Motor Shield V2-Lib-01.jpg|480px}} The Adafruit_MotorShield class represents a motor... »

Nouvelle page

{{Adafruit Motor Shield V2-NAV}}

== Classe Adafruit_MotorShield ==

{{ADFImage|Adafruit Motor Shield V2-Lib-01.jpg|480px}}

The Adafruit_MotorShield class represents a motor shield and must be instantiated before any DCMotors or StepperMotors can be used. You will need to declare one Adafruit_MotorShield for each shield in your system.

=== Adafruit_MotorShield(addr) ===

Adafruit_MotorShield(uint8_t addr = 0x60);

The constructor takes one optional parameter to specify the i2c address of the shield. The default address of the constructor (0x60) matches the default address of the boards as shipped. If you have more than one shield in your system, each shield must have a unique address.

=== begin( freq=1600 ) ===
void begin(uint16_t freq = 1600);

begin() must be called in setup() to initialize the shield. An optional frequency parameter can be used to specify something other than the default maximum: 1.6KHz PWM frequency.

=== getMotor(n) ===
Adafruit_DCMotor *getMotor(uint8_t n);

This function returns one of 4 pre-defined DC motor objects controlled by the shield. The parameter specifies the associated motor channel: 1-4.

=== getStepper(steps, n) ===
Adafruit_StepperMotor *getStepper(uint16_t steps, uint8_t n);

This function returns one of 2 pre-defined stepper motor objects controlled by the shield.
The first parameter specifies the number of steps per revolution.
The second parameter specifies the associated stepper channel: 1-2.

=== setPWM( pin, val) ===
void setPWM(uint8_t pin, uint16_t val);

These are low-level functions to control pins on the on-board PWM driver chip. These functions are intended for internal use only.

=== setPin(pin, val) ===
void setPin(uint8_t pin, boolean val);

These are low-level functions to control pins on the on-board PWM driver chip. These functions are intended for internal use only.

== Classe Adafruit_DCMotor ==

{{ADFImage|Adafruit Motor Shield V2-Lib-02.jpg|480px}}

The Adafruit_DCMotor class represents a DC motor attached to the shield. You must declare an Adafruit_DCMotor for each motor in your system.

=== Adafruit_DCMotor() ===
The constructor takes no arguments. The motor object is typically initialized by assigning a motor object retrieved from the shield class as below:

<nowiki>// Create the motor shield object with the default I2C address
Adafruit_MotorShield AFMS = Adafruit_MotorShield();

// Select which 'port' M1, M2, M3 or M4. In this case, M1
Adafruit_DCMotor *myMotor = AFMS.getMotor(1);
// You can also make another motor on port M2
Adafruit_DCMotor *myOtherMotor = AFMS.getMotor(2);</nowiki>

=== run( direction ) ===
void run(uint8_t direction);

The run() function controls the motor state. The parameter can have one of 3 values:

* '''FORWARD''' - Rotate in a forward direction
* '''REVERSE''' - Rotate in the reverse direction
* '''RELEASE''' - Stop rotation

Note that the "FORWARD" and "REVERSE" directions are arbitrary. If they do not match the actual direction of your vehicle or robot, simple swap the motor leads.

Also note that "RELEASE" simply cuts power to the motor. It does not apply any braking.

=== setSpeed(speed) ===
void setSpeed(uint8_t speed);

The setSpeed() function controls the power level delivered to the motor. The speed parameter is a value between 0 and 255.

Note that setSpeed just controls the power delivered to the motor. The actual speed of the motor will depend on several factors, including: The motor, the power supply and the load.

== Classe Adafruit_DCMotor ==

{{ADFImage|Adafruit Motor Shield V2-Lib-03.jpg|480px}}

The Adafruit_StepperMotor class represents a stepper motor attached to the shield. You must declare an Adafruit_StepperMotor for each stepper motor in your system.

== Adafruit_StepperMotor() ==
Adafruit_StepperMotor(void);

The constructor takes no arguments. The stepper motor is typically initialized by assigning a stepper object retrieved from the shield as below:

<nowiki>// Create the motor shield object with the default I2C address
Adafruit_MotorShield AFMS = Adafruit_MotorShield();

// Connect a stepper motor with 200 steps per revolution (1.8 degree)
// to motor port #2 (M3 and M4)
Adafruit_StepperMotor *myMotor = AFMS.getStepper(200, 2);</nowiki>

== step( steps, dir, style = SINGLE ) ==
void step(uint16_t steps, uint8_t dir, uint8_t style = SINGLE);

The step() function controls stepper motion.

* The first parameter specifies how many steps to move.
* The second parameter specifies the direction: FORWARD or BACKWARD
* The last parameter specifies the stepping style: SINGLE, DOUBLE, INTERLEAVED or MICROSTEP

The ste() function is synchronous and does not return until all steps are complete. When complete the motor remains powered to apply "holding torque" to maintain position.

== setSpeed(speed) ==
void setSpeed(uint16_t);

The setSpeed() function controls the speed of the stepper motor rotation. Speed is specified in RPM.

== onestep( dir, style) ==
uint8_t onestep(uint8_t dir, uint8_t style);

The oneStep() function is a low-level internal function called by step(). But it can be useful to call on its own to implement more advanced functions such as acceleration or coordinating simultaneous movement of multiple stepper motors. The direction and style parameters are the same as for step(), but onestep() steps exactly once.

Note: Calling step() with a step count of 1 is not the same as calling onestep(). The step function has a delay based on the speed set in setSpeed(). onestep() has no delay.

== release() ==
void release(void);

The release() function removes all power from the motor. Call this function to reduce power requirements if holding torque is not required to maintain position.

{{Adafruit Motor Shield V2-TRAILER}}

@@ Ligne 133 : / Ligne 133 : @@
 [http://forums.adafruit.com/viewtopic.php?f=31&t=42477 Ce fil de discussion AdaFruit] mentionne une vitesse Max de 75 RPM dès le début. Il mentionne également la modification de TWI_FREQ pour autorisant des vitesses supérieurs.
-=== onestep( dir, style) ===
+=== onestep(dir, style) ===
   uint8_t onestep(uint8_t dir, uint8_t style);
@@ Ligne 140 : / Ligne 140 : @@
 Elle peut être utilise si vous désirez implémenter vos propres fonctions évoluées tel que l’accélération ou coordination de mouvement de plusieurs moteurs.
-Les paramètres ''dir'' et ''style'' sont identisque à la fonction step()... mais onestep() ne fait qu'un seul pas à la fois.
+Les paramètres ''dir'' et ''style'' sont identique à la fonction step()... mais onestep() ne fait qu'un seul pas à la fois.
-Note: Calling step() with a step count of 1 is not the same as calling onestep(). The step function has a delay based on the speed set in setSpeed(). onestep() has no delay.
+Note: faire un appel à step() avec un nombre de pas égale à 1 '''n'est pas équivalent à''' l'appel de onestep(). La fonction step() introduit un délai entre les pas... ce délai dépendant de la vitesse (RPM) mentionnée dans la fonction setSpeed(). onestep() n'a pas de délai/pause.
 === release() ===

@@ Ligne 95 : / Ligne 95 : @@
 Note MCHobby: vous pouvez asservir la vitesse en utilisant un senseur à effet hall et un aimant (pour compter le nbre de tour par minute).
-== Classe Adafruit_DCMotor ==
+== Classe Adafruit_StepperMotor  ==
 {{ADFImage|Adafruit Motor Shield V2-Lib-03.jpg|480px}}
-The Adafruit_StepperMotor class represents a stepper motor attached to the shield. You must declare an Adafruit_StepperMotor for each stepper motor in your system.
+La classe Adafruit_StepperMotor représente un moteur pas-à-pas branché sur le shield moteur. Vous devez déclarer une instance de Adafruit_StepperMotor pour chaque moteur pas-à-pas branché sur le projet.
-=== Classe Adafruit_StepperMotor ===
+=== Adafruit_StepperMotor() ===
   Adafruit_StepperMotor(void);
-The constructor takes no arguments. The stepper motor is typically initialized by assigning a stepper object retrieved from the shield as below:
+Le constructeur n'a pas besoin de paramètre. L'objet est correctement initialisé par la classe Adafruit_MotorShield lorsqu'elle retourne l'objet sur demande. Voyez le code ci-dessous:
-  <nowiki>// Create the motor shield object with the default I2C address
+  <nowiki>// Créer un object motor shield avec l'adresse I2C par défaut
 Adafruit_MotorShield AFMS = Adafruit_MotorShield();
-// Connect a stepper motor with 200 steps per revolution (1.8 degree)
+// Connecter un moteur pas-à-pas (stepper) avec 200 pas/tour (soit 1.8 degré/pas)
-// to motor port #2 (M3 and M4)
+// sur le port #2 (soit les bornier M3 et M4)
 Adafruit_StepperMotor *myMotor = AFMS.getStepper(200, 2);</nowiki>
-=== step( steps, dir, style = SINGLE ) ===
+=== step( steps, dir, style ) ===
   void step(uint16_t steps, uint8_t dir, uint8_t style = SINGLE);
-The step() function controls stepper motion.
+La fonction step() contrôle le déplacement en pas.
-* The first parameter specifies how many steps to move.
+* '''step''': signifiant littéralement "pas", indique le nombre de pas dont il faut se déplacer.
-* The second parameter specifies the direction: FORWARD or BACKWARD
+* '''dir''': Indique la direction de déplacement. FORWARD pour avant ou BACKWARD pour arrière.
-* The last parameter specifies the stepping style: SINGLE, DOUBLE, INTERLEAVED or MICROSTEP
+* ''style'': Paramètre optionnel. Fixé à SINGLE par défaut. Ce paramètre spécifie le mode de stepping à l'aide des valeur SINGLE, DOUBLE, INTERLEAVED ou MICROSTEP
-The ste() function is synchronous and does not return until all steps are complete. When complete the motor remains powered to apply "holding torque" to maintain position.
+La fonction step() son synchrone. Cela signifie que le programme reste bloqué durant l'envoi des pas au moteur pas-à-pas. Lorsque le déplacement est complet, l'axe est maintenu en position (dit "holding torque" pour couple de maintient) et votre programme continue sont exécution.
 ===  setSpeed(speed) ===
   void setSpeed(uint16_t);
-The setSpeed() function controls the speed of the stepper motor rotation. Speed is specified in RPM.
+La fonction setSpeed() contrôle la vitesse du moteur durant la rotation.
 === onestep( dir, style) ===
   uint8_t onestep(uint8_t dir, uint8_t style);
-The oneStep() function is a low-level internal function called by step(). But it can be useful to call on its own to implement more advanced functions such as acceleration or coordinating simultaneous movement of multiple stepper motors. The direction and style parameters are the same as for step(), but onestep() steps exactly once.
+Cette fonction de bas niveau (fonction interne) fait avancer le moteur d'un pas. onestep() est appelé par la fonction step().
 Note: Calling step() with a step count of 1 is not the same as calling onestep(). The step function has a delay based on the speed set in setSpeed(). onestep() has no delay.

@@ Ligne 56 : / Ligne 56 : @@
 {{ADFImage|Adafruit Motor Shield V2-Lib-02.jpg|480px}}
-The Adafruit_DCMotor class represents a DC motor attached to the shield. You must declare an Adafruit_DCMotor for each motor in your system.
+La calsse Adafruit_DCMotor représente un moteur continu (dit "''DC Motor''" en anglais) branché sur le shield. Vous devez déclarer une objet Adafruit_DCMotor pour chaque moteur continu branché sur le motor shield.
 === Adafruit_DCMotor() ===
-The constructor takes no arguments. The motor object is typically initialized by assigning a motor object retrieved from the shield class as below:
+Le constructeur de Adafruit_DCMotor n'as pas besoin de paramètres.
-  <nowiki>// Create the motor shield object with the default I2C address
+L'objet Adafruit_DCMotor est initialisé lors de l'obtention de cet objet par l'intermédiaire l'objet Adafruit_MotorShield contrôlant le shield (voir exemple ci-dessous)
 Adafruit_MotorShield AFMS = Adafruit_MotorShield();
-// Select which 'port' M1, M2, M3 or M4. In this case, M1
+// Sélectionner le canal (bornier/port) M1, M2, M3 or M4.
 Adafruit_DCMotor *myMotor = AFMS.getMotor(1);
-// You can also make another motor on port M2
+// Vous pouvez également créer un autre objet
 Adafruit_DCMotor *myOtherMotor = AFMS.getMotor(2);</nowiki>
@@ Ligne 72 : / Ligne 76 : @@
   void run(uint8_t direction);
-The run() function controls the motor state. The parameter can have one of 3 values:
+La fonction run() contrôle l'état du moteur. Le paramètre peut avoir 3 valeurs:
-* '''FORWARD''' - Rotate in a forward direction
+* '''FORWARD''': Rotation dans le sens AVANT
-* '''REVERSE''' - Rotate in the reverse direction
+* '''REVERSE''': Rotation dans le sens ARRIERE
-* '''RELEASE''' - Stop rotation
+* '''RELEASE''': Arrêt
-Note that the "FORWARD" and "REVERSE" directions are arbitrary. If they do not match the actual direction of your vehicle or robot, simple swap the motor leads.
+Notez que les directions "FORWARD" (avant) et "REVERSE" (arrière) sont arbitraires. Si elle ne correspond pas au sens de rotation réel de votre moteur, il suffit d'inversion le branchement du moteur sur le bornier.
-Also note that "RELEASE" simply cuts power to the motor. It does not apply any braking.
+L'option "RELEASE" (arrêt) met simplement le moteur hors tension. Le moteur n'est pas "freiné" ni bloqué.
 === setSpeed(speed) ===
   void setSpeed(uint8_t speed);
-The setSpeed() function controls the power level delivered to the motor. The speed parameter is a value between 0 and 255.
+La fonction setSpeed() contrôle le niveau de puissance délivré au moteur. Le parametre ''speed'' (signifiant "vitesse") est une valeur comprise entre 0 et 255.
-Note that setSpeed just controls the power delivered to the motor. The actual speed of the motor will depend on several factors, including: The motor, the power supply and the load.
+Note MCHobby: vous pouvez asservir la vitesse en utilisant un senseur à effet hall et un aimant (pour compter le nbre de tour par minute).
 == Classe Adafruit_DCMotor ==

@@ Ligne 5 : / Ligne 5 : @@
 {{ADFImage|Adafruit Motor Shield V2-Lib-01.jpg|480px}}
-The Adafruit_MotorShield class represents a motor shield and must be instantiated before any DCMotors or StepperMotors can be used. You will need to declare one Adafruit_MotorShield for each shield in your system.
+La classe Adafruit_MotorShield représente l'équivalent physique d'un "motor shield" et doit être instancier avant une quelconque utilisation de classes ''DCMotors'' ou ''StepperMotors''. Vous aurez besoin de déclarer un Adafruit_MotorShield pour chaque shield de votre système.
 === Adafruit_MotorShield(addr) ===
@@ Ligne 11 : / Ligne 11 : @@
   Adafruit_MotorShield(uint8_t addr = 0x60);
-The constructor takes one optional parameter to specify the i2c address of the shield. The default address of the constructor (0x60) matches the default address of the boards as shipped. If you have more than one shield in your system, each shield must have a unique address.
+Construteur de la classe Adafruit_MotorShield qui accepte l'adresse I2C du shield en paramètre optionnel. L'adresse par défaut du construction est (0x60) et correspond à l'adresse par défaut des cartes. Si vous voulez utiliser plusieurs "Motor Shield" sur votre projet, ils doivent chacun avoir une adresse unique.
-=== begin( freq=1600 ) ===
+=== begin(freq) ===
   void begin(uint16_t freq = 1600);
-begin() must be called in setup() to initialize the shield. An optional frequency parameter can be used to specify something other than the default maximum: 1.6KHz PWM frequency.
+La fonction begin() doit être appelée dans setup() afin d'initialiser les shield.
 === getMotor(n) ===
   Adafruit_DCMotor *getMotor(uint8_t n);
-This function returns one of 4 pre-defined DC motor objects controlled by the shield. The parameter specifies the associated motor channel: 1-4.
+Cette fonction retourne l'un des 4 objets moteurs pré-définit contrôlé par le shield.
 === getStepper(steps, n) ===
   Adafruit_StepperMotor *getStepper(uint16_t steps, uint8_t n);
-This function returns one of 2 pre-defined stepper motor objects controlled by the shield.
+Cette fonction retourne l'un des deux objets moteur pas-à-pas prédéfini sur le shield.
-The first parameter specifies the number of steps per revolution.
-The second parameter specifies the associated stepper channel: 1-2.
+Le premier paramètre ''step'' indique le nombre de pas par révolution (souvent 200).
 === setPWM( pin, val) ===
   void setPWM(uint8_t pin, uint16_t val);
-These are low-level functions to control pins on the on-board PWM driver chip. These functions are intended for internal use only.
+Fonction de bas niveau permettant de contrôler les broches sur le controleur PWM du motor shield.
 === setPin(pin, val) ===
   void setPin(uint8_t pin, boolean val);
-These are low-level functions to control pins on the on-board PWM driver chip. These functions are intended for internal use only.
+Fonction de bas niveau permettant de contrôler les broches sur le controleur PWM du motor shield.
 == Classe Adafruit_DCMotor ==