pimoroni-pico/libraries/pico_unicorn
Philip Howard 2a7f8f4781
Documentation (#5)
* Add Pico Display README
* Add PicoGraphics README
* Add Pico Explorer README
* Pico Display Python README
* Add Pico Unicorn demo.py
* Add Pico Unicorn MicroPython docs
* Add Pico Unicorn C++ README
* Add Pico RGB Keypad README
2021-01-27 09:36:08 +00:00
..
CMakeLists.txt
README.md Documentation (#5) 2021-01-27 09:36:08 +00:00
pico_unicorn.cmake
pico_unicorn.cpp
pico_unicorn.hpp
pico_unicorn.pio

README.md

Pico Unicorn Pack - MicroPython

Our Pico Unicorn Pack offers 7x17 bright RGB LEDs driven by Pico's PIO.

Pico Unicorn uses SM0 of PIO0.

We've included helper functions to handle every aspect of drawing to the display and interfacing with the buttons. See the function reference for details.

Example Program

The following example sets up Pico Unicorn, displays some basic demo text and graphics and will illuminate the RGB LED green if the A button is presse


Reference

Constants

Buttons

The four buttons, A, B, X and Y have correponding constants set to their respective GPIO pins. For example:

bool a_is_pressed = pico_unicorn.is_pressed(pico_unicorn.A);

WIDTH / HEIGHT

The width and height of Pico Unicorn are available in constants WIDTH and HEIGHT.

For example:

int num_pixels = pico_unicorn.WIDTH * pico_unicorn.HEIGHT;

Functions

init

Sets up Pico Unicorn. init must be called before any other functions since it configures the PIO and require GPIO inputs. Just call init() like so:

PicoUnicorn pico_unicorn;
pico_unicorn.init();

set_pixel

void set_pixel(uint8_t x, uint8_t y, uint8_t r, uint8_t g, uint8_t b);
void set_pixel(uint8_t x, uint8_t y, uint8_t v);

Sets an RGB LED on Pico Unicorn with an RGB triplet:

pico_unicorn.set_pixel(x, y, r, g, b);

Uses hardware PWM to drive the LED. Values are automatically gamma-corrected to provide smooth brightness transitions and low values may map as "off."

Alternatively you can use:

pico_unicorn.set_pixel(x, y, v);

Which sets the R, G and B elements of the pixel to the same value- lighting it up white at your chosen intensity.

is_pressed

bool is_pressed(uint8_t button);

Reads the GPIO pin connected to one of Pico Unicorn's buttons, returning a bool - true if it's pressed and false if it is released.

pico_unicorn.is_pressed(button);

The button vaule should be a uint8_t denoting a pin, and constants A, B, X and Y are supplied to make it easier. e:

bool is_a_button_pressed = pico_unicorn.is_pressed(PicoUnicorn::A)