Modifications

== Question - Réponse ==

== Question - Réponse ==

===  Mo code servo sur Arduino arrête de fonctionner lorsqu'il est combiné avec NeoPixels! ===

 

 

===  Mon code servo sur Arduino arrête de fonctionner lorsqu'il est combiné avec NeoPixels! ===

{{bloc-etroit|text=Malheureusement, les bibliothèques NéoPixel et servo ne fonctionne pas très bien ensemble; La première ayant besoin de désactiver les interruptions de façon périodique et la deuxième en a absolument besoin pour fonctionner. Vous avez néanmoins quelques alternative:

{{bloc-etroit|text=Malheureusement, les bibliothèques NéoPixel et servo ne fonctionne pas très bien ensemble; La première ayant besoin de désactiver les interruptions de façon périodique et la deuxième en a absolument besoin pour fonctionner. Vous avez néanmoins quelques alternative:

AdaFruit offre uniquement une bibliothèque Arduino. Voyez les liens (plus loin) pour d'autres périphériques. Pour toutes les autres plateformes, et si vous considérez l'option d'écrire votre propre bibliothèque, vous devez comprendre qu'il y a des périphériques plus aptes que d'autres à cette tâche. Lisez le point concernant les exigences de gestion du temps (ci-dessous) pour savoir si le processeur ou le périphérique en question, est capable de générer le signal en concordance avec les spécifications. Un AVR à 8 MHz peut à  peine suivre... tout ce qui sera plus lent sera source de problèmes, bien que quelques ''hackings hardware spécifiques'' (comme une utilisation intelligente du SPI) pourrait rendre cela possible. Dans de nombreux cas, l'utilisation de l'assembleur sera nécessaire.

AdaFruit offre uniquement une bibliothèque Arduino. Voyez les liens (plus loin) pour d'autres périphériques. Pour toutes les autres plateformes, et si vous considérez l'option d'écrire votre propre bibliothèque, vous devez comprendre qu'il y a des périphériques plus aptes que d'autres à cette tâche. Lisez le point concernant les exigences de gestion du temps (ci-dessous) pour savoir si le processeur ou le périphérique en question, est capable de générer le signal en concordance avec les spécifications. Un AVR à 8 MHz peut à  peine suivre... tout ce qui sera plus lent sera source de problèmes, bien que quelques ''hackings hardware spécifiques'' (comme une utilisation intelligente du SPI) pourrait rendre cela possible. Dans de nombreux cas, l'utilisation de l'assembleur sera nécessaire.

=== Why not Raspberry Pi? ===

=== Pourquoi pas un Raspberry Pi? ===

The Raspberry Pi running Linux is a multitasking system, and control may switch among multiple running programs at any time. As such, it’s impossible to guarantee the strict 800 KHz signal required by NeoPixels. You may be able to fudge it for short intervals, but it’s not something that can be counted upon. This is why we use LPD8806 pixels for the [http://learn.adafruit.com/light-painting-with-raspberry-pi Raspberry Pi light painting] demonstration.

Un Raspberry Pi exécute un système d'exploitation multi-tâche, et le contrôle peut passer d'un programme à l'autre à n'importe quel moment. Par conséquent, il est impossible de garantir strictement le signal à 800 KHz requis par NéoPixels. Vous devriez être capable de produire un tel signal pendant un court interval, mais ce n'est pas quelque-chose qui peut être tenu en compte. C'est c'est raison pour laquelle Adafruit utilise des pixels LPD8806 [http://learn.adafruit.com/light-painting-with-raspberry-pi pour son projet de light painting avec Raspberry Pi].

=== Third-Party Libraries ===

=== Bibliothèques tierces ===

NeoPixel-compatible libraries have been developed for devices beyond Arduino. Please keep in mind that Adafruit did not develop any of this code, does not know it inside and out, and can’t fix bugs or offer technical help. This is Wild West stuff.

Des bibliothèques compatible NéoPixel ont été développé pour d'autres périphériques qu'Arduino. Ces librairies n'ont pas été développées par Adafruit, seul les auteurs respectifs savent comment fonctionne leur code et seront les seul à pouvoir offrir aide, support technique et correction de bug.

* [http://www.pjrc.com/teensy/td_libs_OctoWS2811.html OctoWS2811]: specifically for the PJRC Teensy 3.0 microcontroller board. Uses DMA to drive up to 8 NeoPixel strips concurrently with minimal processor load. Multiple boards can be cascaded for still larger displays.

* [http://www.pjrc.com/teensy/td_libs_OctoWS2811.html OctoWS2811]: conçu spécialement pour les cartes microcontrôleurs PJRC Teensy 3.0. Utilise DMA pour piloter jusqu'à 8 rubans NéoPixels concurrent avec une charge processeur minimale. De multiples cartes peuvent être assemblée en cascade pour réaliser de grands afficheurs.

* [https://github.com/scanlime/fadecandy FadeCandy]: also for Teensy 3.0. Doesn’t support as many pixels as OctoWS2811, but adds smooth interpolation and other features for the color-persnickety.

* [https://github.com/scanlime/fadecandy FadeCandy]: aussi pour Teensy 3.0. Mais ne supporte pas autant de pixels que OctoWS2811, mais ajoute de chouette interpolation et autres caractéristiques autour des couleurs.

* [http://www.nycresistor.com/2013/07/27/ledscape/ LEDscape]: specifically for BeagleBone Black. Although the BeagleBone is a multitasking Linux system like the not-NeoPixel-compatible Raspberry Pi, this code exploits hardware features specific to the BeagleBone Black to drive hundreds of meters of NeoPixel strip with virtually no processor load.

* [http://www.nycresistor.com/2013/07/27/ledscape/ LEDscape]: spécialement pour BeagleBone Black. Même si BeagleBone est un système Linux multitâche tel que Raspberry Pi (donc non compatible avec NéoPixel), ce code exploite des caractéristiques matérielles spécifiques du BeagleBone Black pour piloter des centaines de mètres de ruban NeoPixel sans aucune charge processeur (ou presque).

* [http://obex.parallax.com/object/703 WS2812 LED Driver] for Parallax Propeller.

* [http://obex.parallax.com/object/703 Pilote pour LED WS2812] pour la plateforme Parallax Propeller.

* [https://github.com/teachop/xcore_neopixel_leds xCORE NeoPixel test code] for the XMOS xCORE startKIT.

* [https://github.com/teachop/xcore_neopixel_leds xCORE NeoPixel test code] pour le startKIT XMOS xCORE.

{{ambox-stop|text=Some of these are 3.3V devices. See the “Powering NeoPixel” page for notes on controlling 5V NeoPixels from 3.3V microcontrollers.}}

{{ambox-stop|text=Certaines de ces plateformes fonctionne sous 3.3V. Voyez la page "[[NeoPixel-UserGuide-Alimenter|Alimenter des NéoPixel]]" qui contient des notes pour contrôler des NéoPixels 5V depuis un microcontrôleur 3.3V.}}

=== WS2811? WS2812? Why do I see two different names mentioned? ===

=== WS2811? WS2812? Pourquoi y a t'il différents nom?!?! ===

The WS2811 is an earlier driver chip separate from the RGB LED. The data signal is similar, but runs at half the speed. By the time the WS2812 (with integrated LED) was released, a lot of code and projects had already built up around the WS2811 name. Sometimes code “for the WS2811” might actually be for the newer chip, or for either type. The Adafruit_NeoPixel library supports both.

Le WS2811 est une puce de pilotage séparé de la LED RGB. Le signal de donnée est similaire mais fonctionne à la moitié de la vitesse. Entre temps, le WS2812 (avec LED RGB intégrée) a été mis en vente, il n'empêche qu'il existe beaucoup de code et de projet autour du nom WS2811. C'est parfois "pour le WS2811" mais qui est en fait destiné au contrôleur plus récent, ou pour les deux types. La bibliothèque Adafruit_NeoPixel supporte les deux modèles.

== Writing Your Own Library ==

== Ecrire votre propre bibliothèque ==

The [http://www.adafruit.com/datasheets/WS2812.pdf WS2812 datasheet] explains the data transmission protocol. This is a self-clocking signal — there’s only one wire, not separate data and clock lines. “1” and “0” bits are indicated by varying the duty cycle of a fixed-frequency square wave.

La [http://www.adafruit.com/datasheets/WS2812.pdf fiche technique du WS2812] explique le protocole de transmission des données. C'est un signal portant aussi le signal d'horloge — il n'y a qu'un seul fil, par de fils séparés pour le signal d'horloge et transport de données. Les bits "1" et "0" sont mentionnés en faisant varier le cycle utile d'une onde carrée à fréquence fixe.

[[Fichier:NeoPixel-UserGuide-YourLib-01.jpg]]

[[Fichier:NeoPixel-UserGuide-YourLib-01.png]]

There’s a math goof in the datasheet’s timing values. Use these figures instead:  

Il y a une gaffe mathématique dans les valeurs temporelles de la fiche technique. Il faut utiliser le graphique suivant à la place:  

[[Fichier:NeoPixel-UserGuide-YourLib-02.jpg]]

[[Fichier:NeoPixel-UserGuide-YourLib-02.png]]

Note that there’s nearly 25% “wiggle room” in the timing. So if your code can’t match the recommended times exactly, it’s usually okay.

Notez qu'il y a "une marge de manoeuvre" de presque 25% dans la gestion du temps. Cela reste généralement correct si vous ne pouvez pas strictement respecter la base de temps.

There are three bytes of data for each pixel. These should be issued in green, red, blue order, with the most-significant bit first.

Il y a 3 octets/bytes de données pour chaque pixel. Qui doivent être envoyés dans l'ordre vert, rouge, bleu (''green, red, blue'') avec le bit le plus significatif en premier.

[[Fichier:NeoPixel-UserGuide-YourLib-03.jpg]]

[[Fichier:NeoPixel-UserGuide-YourLib-03.png]]

The data for pixel #0 (nearest the microcontroller) is issued first, then pixel #1, and so forth to the furthest pixel. This does not operate like a traditional shift register!

Les données pour le pixel #0 (proche du microcontroleur) sont émises en premier, ensuite le pixel #1 et ainsi de suite pour les pixels suivants. Cela ne fonctionne pas comme un registre à décalage traditionnel!

After all the color data is sent, the data line must be held low for a minimum of 50 microseconds for the new colors to “latch.”

Après l'envoi de toutes les données de couleur, la ligne de donnée doit être maintenue au niveau bas (''low'') pendant un minimum de 50 microsecondes pour indiqué l'envoi d'un nouveau flux de donnée (à partir du pixel #0).

You may want to dig through our [https://github.com/adafruit/Adafruit_NeoPixel Arduino library] for insights. The timing-critial parts are written in AVR assembly language, but it’s extensively commented with C-like pseudocode.  

Vous pourriez avoir besoin de consulter les sources de la [https://github.com/adafruit/Adafruit_NeoPixel bibliothèque Arduino] pour vous faire une idée. Les parties critiques (celles où la gestion du temps est critique) sont écrit en langage d'assemblage AVR mais très largement documentté en pseudo-code C.  

=== My Microcontroller Isn’t Fast Enough to Do That ===

=== Mon microcontroleur n'est pas assez rapide pour cela ===

The WS2812 appears to be backwardly-compatible with the 400 KHz WS2811 signal. If you can precisely match the latter chip’s timing, either type will respond. '''The WS2811 protocol is not simply a half-speed WS2812'''. The duty cycle for the “0” and “1” bits is slightly different. From the [http://www.adafruit.com/datasheets/WS2811.pdf WS2811 datasheet]:

Apparemment, le WS2812 est rétro-compatble avec le signal 400 KHz du WS2811. Si vous pouvez atteindre le signal 400 Khz avec précision, les deux types devraient répondre. '''Le protocole WS2811 n'est pas simplement la moitié de la vitesse du WS2812'''. Le cycle utile des bits "0" et "1" diffèrent aussi légèrement. Voyez ce graphique extrait [http://www.adafruit.com/datasheets/WS2811.pdf de la fiche technique du WS2811]:

[[Fichier:NeoPixel-UserGuide-YourLib-10.jpg]]

[[Fichier:NeoPixel-UserGuide-YourLib-10.png]]

{{NeoPixel-UserGuide-TRAILER}}

{{NeoPixel-UserGuide-TRAILER}}