Skip to content

Docs: update for RGBW neopixel #694

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Dec 18, 2020
Merged

Docs: update for RGBW neopixel #694

Changes from 3 commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
ee5abe4
Docs: update for RGBW neopixel
microbit-mark Dec 15, 2020
92887de
Docs: RGBW neopixels
microbit-mark Dec 15, 2020
1b927ef
Update docs/neopixel.rst
microbit-mark Dec 16, 2020
4e68ce5
Update docs/neopixel.rst
microbit-mark Dec 16, 2020
40a0c50
change to bpp
microbit-mark Dec 16, 2020
474f3cc
change to bpp
microbit-mark Dec 16, 2020
7599420
add image attribution
microbit-mark Dec 16, 2020
f90d5e2
Update docs/neopixel.rst
microbit-mark Dec 17, 2020
9641853
Add V2 methods
microbit-mark Dec 18, 2020
ba87af8
Merge branch 'neopixel-updates' of https://github.com/microbit-mark/m…
microbit-mark Dec 18, 2020
a8750bd
Docs: Update neopixel
microbit-mark Dec 18, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 9 additions & 6 deletions docs/neopixel.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,10 @@ need to import it separately with::

.. note::

From our tests, the micro:bit NeoPixel module can drive up to around 256
From our tests, the Microbit NeoPixel module can drive up to around 256
NeoPixels. Anything above that and you may experience weird bugs and
issues. The micro:bit can only supply 90mA **V1** or 190mA **V2** to
external devices, larger numbers of NeoPixels require an external power
external devices,larger numbers of NeoPixels require an external power
supply with common ground.

NeoPixels are designed to work at 5V, but luckily they still function using
Expand All @@ -27,6 +27,8 @@ contains everything to plug them into a micro:bit and create funky displays,
art and games such as the demo shown below.

.. image:: neopixel.gif
:alt: Neopixel flexible tile
Image attribution: `adafruit flexible Neopixel matrix <https://www.adafruit.com/product/2547>`_

To connect a strip of neopixels you'll need to attach the micro:bit as shown
below (assuming you want to drive the pixels from pin 0 - you can connect
Expand All @@ -51,12 +53,13 @@ Classes

.. py:class::
NeoPixel(pin, n)
NeoPixel(pin, n, 4)
NeoPixel(pin, n, bpp)

Initialise a new strip of ``n`` number of neopixel LEDs controlled via pin
``pin``. For **V2** micro:bit boards that support RGBW neopixels, a third
value can be passed to ``NeoPixel`` to indicate the number of bytes per
pixel is 4 rather than the default of 3.
``pin``. The **V2** micro:bit can also support RGBW neopixels, so a third
argument can be passed to ``NeoPixel`` to indicate the number of bytes per
pixel (bpp). For RGBW, this is is ``4`` rather than the default of 3 for
RGB and GRB.

Each pixel is addressed by a position (starting from 0). Neopixels
are given RGB (red, green, blue) / RGBW (red, green, blue, white) **V2**
Expand Down